feat(jd): 列表列对齐+主图投影+SKU 矩阵+删除链收口(B101/B102 服务端与后管)

This commit is contained in:
2026-11-15 00:01:24 +08:00
parent 8d8c88a5f3
commit 402447af70
36 changed files with 2184 additions and 81 deletions
@@ -1,6 +1,7 @@
<script setup lang="ts">
/** 京东数据库页(v1.4 Phase 5):公司隔离的京东商品库,筛选行(店铺/商品编码/标题关键字/商品状态/
* 分组/同步起止 date 对)+查询/导出/重置/管理分组 + 自绘明细表(点行开详情抽屉)+ OldPagination。
* 分组/同步起止 date 对)+查询/导出/重置/管理分组 + 自绘明细表(勾选列+点行开详情抽屉)
* + 删除(单行/批量,先删桶对象、全成功才删库行,确认弹窗点名数量)+ OldPagination。
* 骨架像素复刻「外观专利数据库」页(panel-box + LoadFailureBar + 自绘 table + 旧式分页);
* 公司 tab 切换=清筛选重取(watch 体照外观专利页逐字形状);日期对护栏:起侧 max=止侧、
* 止侧 min=起侧、两侧 @change 用 orderedPair 把倒挂交换回来(clampJdSyncedRange 照 clampDatePair)。
@@ -8,6 +9,7 @@
* (date-filter-default-today 护栏 EXEMPT 口径,外观专利页同款)。 */
import { computed, onMounted, reactive, ref, watch } from 'vue'
import {
deleteJdProducts,
exportJdProductList,
fetchJdProductGroups,
fetchJdProductList,
@@ -21,6 +23,7 @@ import JdProductGroupDialog from './JdProductGroupDialog.vue'
import OldPagination from '@/components/OldPagination.vue'
import { useCompanyTabStore } from '@/stores/company-tab'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { openAdminConfirm } from '@/components/admin-confirm'
import { loadFailureMessage } from '@/components/load-failure-model'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
import { formatDateTime, orderedPair } from '@/utils/datetime'
@@ -87,6 +90,8 @@ async function load(): Promise<void> {
rows.value = result.items
total.value = result.total
if (result.page >= 1) page.value = result.page
// 重取后上一批勾选可能已不在本页(翻页/筛选变化):清空,防"看不见的勾选被一起删"。
selectedIds.value = new Set()
} catch (error) {
loadFailure.value = loadFailureMessage(error, '京东商品列表加载失败')
showAdminFeedback(loadFailure.value, 'error')
@@ -161,6 +166,59 @@ function closeDetail(): void {
detailItem.value = null
}
// ---------------- 删除(先删桶、全成功才删库行,语义在后端 JdProductDeleteService) ----------------
/** 本页勾选集(按行 id)。切页/切公司/重取后勾选清空——上一页勾的行不自动带到下一页。 */
const selectedIds = ref<Set<number>>(new Set())
const deleting = ref(false)
const selectedCount = computed(() => selectedIds.value.size)
function toggleSelect(row: JdProductItem, checked: boolean): void {
const next = new Set(selectedIds.value)
if (checked) next.add(row.id)
else next.delete(row.id)
selectedIds.value = next
}
const allSelected = computed(() => rows.value.length > 0 && rows.value.every((row) => selectedIds.value.has(row.id)))
function toggleSelectAll(checked: boolean): void {
selectedIds.value = checked ? new Set(rows.value.map((row) => row.id)) : new Set()
}
/** 单行删除入口(行内按钮):确认弹窗点名商品编码与「桶内图片一并删除」。 */
async function removeOne(row: JdProductItem): Promise<void> {
await removeMany([row], `确定删除商品「${row.productCode || row.title}」吗?`)
}
/** 批量删除入口(勾选后点工具栏按钮):确认弹窗点名行数。 */
async function removeSelected(): Promise<void> {
const picked = rows.value.filter((row) => selectedIds.value.has(row.id))
await removeMany(picked, `确定删除勾选的 ${picked.length} 个商品吗?`)
}
/** 删除主流程:二次确认 → 先删桶、全成功才删库行(后端保证)→ 刷新列表并清勾选。 */
async function removeMany(picked: JdProductItem[], message: string): Promise<void> {
if (!picked.length || deleting.value) return
const ok = await openAdminConfirm({ title: '删除京东商品', message: `${message}删除后该商品的 SKU、图片登记与 jd-products 桶内图片文件一并删除(被其他商品共用的图片会保留);此操作不可恢复。`, confirmText: '确认删除', danger: true })
if (!ok) return
deleting.value = true
try {
const receipt = await deleteJdProducts(picked.map((row) => row.id), companyTab.requestCompanyId)
showAdminFeedback(`已删除 ${receipt.deleted} 个商品,清理 ${receipt.objectsDeleted} 个图片文件` +
(receipt.objectsKept ? `(${receipt.objectsKept} 个共用图片保留)` : ''), 'success')
selectedIds.value = new Set()
if (picked.length >= rows.value.length && page.value > 1) page.value -= 1
await load()
} catch (error) {
const text = error instanceof Error && error.message ? error.message : '删除失败,请稍后重试'
showAdminFeedback(text, 'error')
} finally {
deleting.value = false
}
}
// 切公司 = 重新取数:店铺/编码/关键字/状态/分组是上一家选中的值,在新一家的行集里筛不出东西,
// 必须一起清,分组选项也按新公司重取(选项集是公司隔离的)。
watch(() => companyTab.activeId, () => { filter.shopName = ''; filter.productCode = ''; filter.titleKeyword = ''; filter.saleStatus = ''; filter.groupId = ''; filter.syncedFrom = ''; filter.syncedTo = ''; page.value = 1; void loadGroupOptions(); void load() })
@@ -224,48 +282,71 @@ onMounted(() => {
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<div class="jd-toolbar">
<span class="jd-summary">共 {{ total }} 条京东商品</span>
<button
v-if="selectedCount"
class="btn btn-danger jd-delete-btn"
type="button"
:disabled="deleting"
@click="removeSelected"
>
{{ deleting ? '删除中...' : `删除勾选(${selectedCount})` }}
</button>
</div>
<div class="table-scroll jd-table-scroll">
<table>
<thead>
<tr>
<th style="width: 42px"><input type="checkbox" :checked="allSelected" @change="toggleSelectAll(($event.target as HTMLInputElement).checked)" /></th>
<th style="width: 76px">主图</th>
<th>商品信息</th>
<th style="width: 118px">商品编码</th>
<th style="width: 118px">货号</th>
<th style="width: 110px">类目</th>
<th style="width: 86px">品牌</th>
<th style="width: 76px">信息分</th>
<th style="width: 70px">SKU</th>
<th style="width: 120px">店铺</th>
<th style="width: 110px">商品编码</th>
<th>标题</th>
<th style="width: 90px">品牌</th>
<th style="width: 110px">价格区间</th>
<th style="width: 64px">库存</th>
<th style="width: 80px">状态</th>
<th style="width: 76px">总库存</th>
<th style="width: 112px">价格区间</th>
<th style="width: 170px">上架时间</th>
<th style="width: 86px">商品状态</th>
<th style="width: 170px">创建时间</th>
<th style="width: 170px">修改时间</th>
<th style="width: 100px">分组</th>
<th style="width: 170px">京东更新时间</th>
<th style="width: 170px">同步时间</th>
</tr>
</thead>
<tbody>
<template v-if="rows.length">
<tr v-for="row in rows" :key="row.id" class="jd-row" @click="openDetail(row)">
<td @click.stop><input type="checkbox" :checked="selectedIds.has(row.id)" @change="toggleSelect(row, ($event.target as HTMLInputElement).checked)" /></td>
<td>
<img v-if="row.mainImageUrl" class="jd-thumb" :src="row.mainImageUrl" alt="" loading="lazy" />
<span v-else class="empty-mini">无图</span>
</td>
<td :title="row.shopName || ''">{{ row.shopName || '-' }}</td>
<td class="mono-cell">{{ row.productCode || '-' }}</td>
<td class="title-cell" :title="row.title">{{ row.title || '-' }}</td>
<td class="mono-cell">{{ row.productCode || '-' }}</td>
<td class="mono-cell">{{ row.itemNum || '-' }}</td>
<td :title="row.categoryPath || ''">{{ row.categoryPath || '-' }}</td>
<td>{{ row.brand || '-' }}</td>
<td>{{ jdPriceRange(row) || '-' }}</td>
<td>{{ row.healthScore ?? '-' }}</td>
<td>{{ row.skuCount ?? '-' }}</td>
<td :title="row.shopName || ''">{{ row.shopName || '-' }}</td>
<td>{{ row.stockTotal ?? '-' }}</td>
<td>{{ jdPriceRange(row) || '-' }}</td>
<td>{{ row.jdOnlineAt ? formatDateTime(row.jdOnlineAt) : '-' }}</td>
<td>{{ row.saleStatus || '-' }}</td>
<td :title="row.groupName || ''">{{ row.groupName || '未分组' }}</td>
<td>{{ row.jdCreatedAt ? formatDateTime(row.jdCreatedAt) : '-' }}</td>
<td>{{ formatDateTime(row.jdUpdatedAt || '') }}</td>
<td :title="row.groupName || ''">{{ row.groupName || '未分组' }}</td>
<td>{{ formatDateTime(row.syncedAt || '') }}</td>
</tr>
</template>
<tr v-else-if="loading">
<td colspan="11" class="empty-tip">加载中...</td>
<td colspan="18" class="empty-tip">加载中...</td>
</tr>
<tr v-else>
<td colspan="11" class="empty-tip">暂无京东商品数据</td>
<td colspan="18" class="empty-tip">暂无京东商品数据</td>
</tr>
</tbody>
</table>
@@ -416,8 +497,22 @@ h3 {
.jd-toolbar {
display: flex;
align-items: center;
gap: 14px;
margin-bottom: 10px;
}
/* 删除按钮挂到工具栏右侧(scoped:分组弹窗那份 .btn-danger 借不过来)。 */
.jd-delete-btn {
margin-left: auto;
}
.btn-danger {
background: #ffffff;
color: #a04432;
border-color: #e4b3a8;
}
.btn-danger:hover:not(:disabled) {
background: #fdf1ef;
border-color: #d08a7b;
}
.jd-summary {
color: #5b6f83;
font-size: 13px;
@@ -437,7 +532,7 @@ h3 {
table-layout: fixed;
}
.jd-table-scroll > table {
min-width: 1260px;
min-width: 1860px;
}
.table-scroll th,
.table-scroll td {
@@ -5,8 +5,13 @@
* 原图新标签;不用 element-plus)。数据由本组件按 (id, companyId) 自取,失败条内提示可重试。 */
import { computed, ref, watch } from 'vue'
import { fetchJdProductDetail } from './jd-product-api.ts'
import type { JdProductImage, JdProductItem, JdProductAttrGroup } from './jd-product-model.ts'
import { jdPriceRange } from './jd-product-model.ts'
import type {
JdProductImage,
JdProductItem,
JdProductAttrGroup,
JdProductSku,
} from './jd-product-model.ts'
import { jdPriceRange, jdSkuDimensions, jdSkuSummary } from './jd-product-model.ts'
import { formatDateTime } from '@/utils/datetime'
import { requestErrorMessage } from '../../api/envelope.ts'
@@ -22,8 +27,17 @@ const loading = ref(false)
const loadFailure = ref('')
const attrGroups = ref<JdProductAttrGroup[]>([])
const images = ref<JdProductImage[]>([])
const skus = ref<JdProductSku[]>([])
const attrJsonRaw = ref('')
/** SKU 矩阵维度(京麦「颜色 / 尺码」两列)与表头汇总。 */
const skuDimensions = computed(() => jdSkuDimensions(skus.value))
const skuSummary = computed(() => jdSkuSummary(skus.value))
function skuAttrValue(sku: JdProductSku, dimension: string): string {
return sku.saleAttrs.find((attr) => attr.name === dimension)?.value || '-'
}
/** 图片三区:MAIN / ATTR / DETAIL;未知类型归 DETAIL 之外的「其他」,不丢。 */
const mainImages = computed(() => images.value.filter((image) => image.imageType === 'MAIN'))
const attrImageGroups = computed(() => {
@@ -63,11 +77,13 @@ async function loadDetail(): Promise<void> {
loadFailure.value = ''
attrGroups.value = []
images.value = []
skus.value = []
attrJsonRaw.value = ''
try {
const detail = await fetchJdProductDetail(item.id, props.companyId)
attrGroups.value = detail.attrGroups
images.value = detail.images
skus.value = detail.skus
attrJsonRaw.value = detail.attrJsonRaw
if (!detail.attrGroups.length && detail.attrJsonRaw) {
// 结构化解析失败但原文在:兜底展示原文,不静默吞
@@ -120,17 +136,23 @@ function dash(value: string | number | null | undefined): string {
</div>
<div class="info-item"><dt>品牌</dt><dd>{{ dash(item?.brand) }}</dd></div>
<div class="info-item"><dt>类目</dt><dd :title="item?.categoryPath || ''">{{ dash(item?.categoryPath) }}</dd></div>
<div class="info-item"><dt>货号</dt><dd>{{ dash(item?.productCode) }}</dd></div>
<div class="info-item"><dt>商品编码</dt><dd>{{ dash(item?.productCode) }}</dd></div>
<div class="info-item"><dt>货号</dt><dd>{{ dash(item?.itemNum) }}</dd></div>
<div class="info-item"><dt>SKU</dt><dd>{{ dash(item?.skuId) }}</dd></div>
<div class="info-item"><dt>SKU 数</dt><dd>{{ dash(item?.skuCount) }}</dd></div>
<div class="info-item"><dt>信息分</dt><dd>{{ dash(item?.healthScore) }}</dd></div>
<div class="info-item"><dt>价格区间</dt><dd>{{ dash(jdPriceRange(item ?? { priceMin: '', priceMax: '' })) }}</dd></div>
<div class="info-item"><dt>库存</dt><dd>{{ dash(item?.stockTotal) }}</dd></div>
<div class="info-item"><dt>总库存</dt><dd>{{ dash(item?.stockTotal) }}</dd></div>
<div class="info-item"><dt>状态</dt><dd>{{ dash(item?.saleStatus) }}</dd></div>
<div class="info-item"><dt>京东创建时间</dt><dd>{{ formatDateTime(item?.jdUpdatedAt || '') }}</dd></div>
<div class="info-item"><dt>上架时间</dt><dd>{{ item?.jdOnlineAt ? formatDateTime(item.jdOnlineAt) : '-' }}</dd></div>
<div class="info-item"><dt>京东创建时间</dt><dd>{{ item?.jdCreatedAt ? formatDateTime(item.jdCreatedAt) : '-' }}</dd></div>
<div class="info-item"><dt>京东修改时间</dt><dd>{{ item?.jdUpdatedAt ? formatDateTime(item.jdUpdatedAt) : '-' }}</dd></div>
<div class="info-item"><dt>同步时间</dt><dd>{{ formatDateTime(item?.syncedAt || '') }}</dd></div>
</dl>
</section>
<section v-if="attrGroups.length" class="detail-block">
<h4>属性</h4>
<h4>属性与设置(按京麦 Tab 分组)</h4>
<div v-for="group in attrGroups" :key="group.groupName" class="attr-group">
<h5>{{ group.groupName }}</h5>
<table>
@@ -148,6 +170,38 @@ function dash(value: string | number | null | undefined): string {
<pre class="attr-raw">{{ attrJsonRaw }}</pre>
</section>
<section class="detail-block">
<h4>销售属性 / SKU 矩阵</h4>
<template v-if="skus.length">
<p class="sku-summary">{{ skuSummary }}</p>
<div class="sku-table-wrap">
<table class="sku-table">
<thead>
<tr>
<th>序号</th>
<th v-for="dimension in skuDimensions" :key="dimension">{{ dimension }}</th>
<th>京东价</th>
<th>库存</th>
<th>SKU ID</th>
<th>SKU 名称</th>
</tr>
</thead>
<tbody>
<tr v-for="(sku, index) in skus" :key="sku.skuId">
<td>{{ sku.skuSeq || index + 1 }}</td>
<td v-for="dimension in skuDimensions" :key="dimension">{{ skuAttrValue(sku, dimension) }}</td>
<td>{{ sku.price ? `¥${sku.price}` : '-' }}</td>
<td>{{ dash(sku.stock) }}</td>
<td class="sku-id">{{ sku.skuId }}</td>
<td :title="sku.skuName">{{ dash(sku.skuName) }}</td>
</tr>
</tbody>
</table>
</div>
</template>
<p v-else class="drawer-tip">暂无 SKU 矩阵(V198 之前采集的旧行需重新采集)</p>
</section>
<section class="detail-block">
<h4>主图</h4>
<div v-if="mainImages.length" class="image-grid">
@@ -238,7 +292,7 @@ function dash(value: string | number | null | undefined): string {
.drawer {
display: flex;
flex-direction: column;
width: min(760px, 100%);
width: min(920px, 100%);
height: 100%;
background: #ffffff;
box-shadow: -18px 0 40px rgba(39, 67, 94, 0.18);
@@ -374,6 +428,42 @@ function dash(value: string | number | null | undefined): string {
max-height: 240px;
overflow-y: auto;
}
.sku-summary {
margin: 0 0 8px;
color: #5b6f83;
font-size: 12.5px;
}
.sku-table-wrap {
overflow-x: auto;
border: 1px solid #dbe5ee;
border-radius: 8px;
}
.sku-table {
width: 100%;
border-collapse: collapse;
font-size: 12.5px;
white-space: nowrap;
}
.sku-table th,
.sku-table td {
padding: 7px 10px;
border-bottom: 1px solid #e7eef5;
text-align: left;
color: #24384d;
}
.sku-table th {
background: #f2f7fb;
color: #4e6479;
font-weight: 600;
}
.sku-table tbody tr:last-child td {
border-bottom: 0;
}
.sku-table .sku-id {
font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
font-size: 12px;
color: #4e6479;
}
.image-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(110px, 1fr));
@@ -1,5 +1,6 @@
/** 京东数据库查询适配(v1.4 Phase 5):GET /api/admin/jd-products + 分组端点 /api/admin/jd-product-groups。
* 只读列表+导出+分组管理:公司 tab 的值由本发送口从原始入参自己下传
/** 京东数据库查询适配(v1.4 Phase 5):GET /api/admin/jd-products + 删除(DELETE /{id} +
* POST /batch-delete)+ 分组端点 /api/admin/jd-product-groups。
* 只读列表+导出+删除+分组管理:公司 tab 的值由本发送口从原始入参自己下传
* (白名单构造不认识 company_id),取值口形状由 company-tab-wiring 护栏钉住。 */
import { http } from '@/api/http'
import { errorTextOf, unwrap } from '../../api/envelope.ts'
@@ -108,6 +109,30 @@ export async function exportJdProductList(
return { blob: response.data, filename: exportFilenameOf(disposition) }
}
/** 删除回执(后端 JdProductDeleteVo):三个对象计数分开报——真删的、共用的、前缀外不敢动的。 */
export interface JdProductDeleteResult {
deleted: number
imagesDeleted: number
objectsDeleted: number
objectsKept: number
objectsSkipped: number
}
/** 删除是先删桶、全成功才删库行(后端 JdProductDeleteService);失败文案原样抛给页面。 */
export async function deleteJdProducts(
ids: number[],
companyId: number | null,
): Promise<JdProductDeleteResult> {
const query: Record<string, number> = {}
if (companyId != null) query.company_id = companyId
if (ids.length === 1) {
const { data } = await http.delete<unknown>(`${JD_PRODUCT_ENDPOINT}/${ids[0]}`, { params: query })
return unwrap<JdProductDeleteResult>(data)
}
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/batch-delete`, { ids }, { params: query })
return unwrap<JdProductDeleteResult>(data)
}
/** 分组行(GET 列表返回:[{id,name,sortOrder,productCount}])。 */
export interface JdProductGroup {
id: number
@@ -10,6 +10,12 @@ export interface JdProductItem {
shopName: string
productCode: string
skuId: string
/** 货号(京麦后台「货号」列,与 SKU 不是同一个值)。 */
itemNum: string
/** SKU 数(京麦后台「12个SKU」列)。 */
skuCount: number | null
/** 信息分(京麦后台「信息分」列)。 */
healthScore: number | null
title: string
brand: string
categoryPath: string
@@ -19,6 +25,9 @@ export interface JdProductItem {
/** 上架中/已下架/审核中/草稿。 */
saleStatus: string
listTab: string
jdCreatedAt: string
/** 上架时间(京麦后台「上架时间」列,与创建时间不是同一个值)。 */
jdOnlineAt: string
jdUpdatedAt: string
mainImageUrl: string
attrCount: number | null
@@ -70,6 +79,9 @@ export function toJdProductItem(raw: unknown): JdProductItem | null {
shopName: text(record.shopName ?? record.shop_name),
productCode: text(record.productCode ?? record.product_code),
skuId: text(record.skuId ?? record.sku_id),
itemNum: text(record.itemNum ?? record.item_num),
skuCount: numberOrNull(record.skuCount ?? record.sku_count),
healthScore: numberOrNull(record.healthScore ?? record.health_score),
title: text(record.title),
brand: text(record.brand),
categoryPath: text(record.categoryPath ?? record.category_path),
@@ -78,6 +90,8 @@ export function toJdProductItem(raw: unknown): JdProductItem | null {
stockTotal: numberOrNull(record.stockTotal ?? record.stock_total),
saleStatus: text(record.saleStatus ?? record.sale_status),
listTab: text(record.listTab ?? record.list_tab),
jdCreatedAt: text(record.jdCreatedAt ?? record.jd_created_at),
jdOnlineAt: text(record.jdOnlineAt ?? record.jd_online_at),
jdUpdatedAt: text(record.jdUpdatedAt ?? record.jd_updated_at),
mainImageUrl: text(record.mainImageUrl ?? record.main_image_url),
attrCount: numberOrNull(record.attrCount ?? record.attr_count),
@@ -129,10 +143,31 @@ export interface JdProductImage {
height: number | null
}
/** 销售属性组合的一项(颜色=上衣 / 尺码=S,京麦详情页「销售属性」)。 */
export interface JdProductSkuAttr {
name: string
value: string
}
/** 详情 SKU 行(后端 JdProductDetailVo.SkuVo,V198;京麦 12 行矩阵的一行)。 */
export interface JdProductSku {
skuId: string
skuName: string
/** 商家自定义序号(京麦 skuSeq)。 */
skuSeq: string
/** 京东价(后端 BigDecimal,前端按文本展示,不做金额运算)。 */
price: string
stock: number | null
saleAttrs: JdProductSkuAttr[]
sortNo: number
}
export interface JdProductDetail {
item: JdProductItem
attrGroups: JdProductAttrGroup[]
images: JdProductImage[]
/** SKU 矩阵(京麦详情页「销售属性」区,V198;旧数据为空数组)。 */
skus: JdProductSku[]
/** attrGroups 解析失败时的原始 JSON 兜底(界面原样展示,不静默吞)。 */
attrJsonRaw: string
}
@@ -184,6 +219,77 @@ function toImages(raw: unknown): JdProductImage[] {
return out
}
/** 数值/字符串都收(后端 BigDecimal 序列化成 JSON number),去尾零后展示:
* 京麦详情页写 `162`,不给 `162.00`;数字形状之外的原文照原样回(不吞异常值)。 */
function decimalText(value: unknown): string {
if (typeof value === 'number' && Number.isFinite(value)) {
return String(Math.round(value * 100) / 100)
}
const raw = text(value)
if (!/^\d+(?:\.\d+)?$/.test(raw)) return raw
return String(Math.round(Number(raw) * 100) / 100)
}
/** 归一化 SKU 矩阵(camel/snake 容错);缺 skuId 弃行(京麦每一行都以 skuId 为身份)。 */
function toSkus(raw: unknown): JdProductSku[] {
if (!Array.isArray(raw)) return []
const out: JdProductSku[] = []
for (const skuRaw of raw) {
if (!skuRaw || typeof skuRaw !== 'object') continue
const sku = skuRaw as Record<string, unknown>
const skuId = text(sku.skuId ?? sku.sku_id)
if (!skuId) continue
const saleAttrs: JdProductSkuAttr[] = []
const attrsRaw = sku.saleAttrs ?? sku.sale_attrs
if (Array.isArray(attrsRaw)) {
for (const attrRaw of attrsRaw) {
if (!attrRaw || typeof attrRaw !== 'object') continue
const attr = attrRaw as Record<string, unknown>
const value = text(attr.value)
if (!value) continue
saleAttrs.push({ name: text(attr.name) || '属性', value })
}
}
out.push({
skuId,
skuName: text(sku.skuName ?? sku.sku_name),
skuSeq: text(sku.skuSeq ?? sku.sku_seq),
price: decimalText(sku.price),
stock: numberOrNull(sku.stock),
saleAttrs,
sortNo: numberOrNull(sku.sortNo ?? sku.sort_no) ?? 0,
})
}
return out
}
/** 销售属性维度名(按首次出现顺序):京麦详情页「颜色 / 尺码」两列。 */
export function jdSkuDimensions(skus: JdProductSku[]): string[] {
const order: string[] = []
for (const sku of skus) {
for (const attr of sku.saleAttrs) {
if (!order.includes(attr.name)) order.push(attr.name)
}
}
return order
}
/** SKU 矩阵汇总:`12 个 SKU · ¥162 ~ ¥168 · 库存 2400`(缺项不硬凑)。 */
export function jdSkuSummary(skus: JdProductSku[]): string {
if (!skus.length) return ''
const prices = skus
.map((sku) => Number(sku.price))
.filter((value) => Number.isFinite(value) && value > 0)
const priceText = prices.length
? Math.min(...prices) === Math.max(...prices)
? `¥${Math.min(...prices)}`
: `¥${Math.min(...prices)} ~ ¥${Math.max(...prices)}`
: ''
const stocks = skus.map((sku) => sku.stock).filter((value): value is number => typeof value === 'number')
const stockText = stocks.length ? `库存 ${stocks.reduce((sum, value) => sum + value, 0)}` : ''
return [`${skus.length} 个 SKU`, priceText, stockText].filter(Boolean).join(' · ')
}
/** 解析详情负载(信封或已解包 VO);attrGroups 解析不出时回 attrJsonRaw 原文兜底。 */
export function parseJdProductDetail(payload: unknown): JdProductDetail {
const core = unwrap<unknown>(payload)
@@ -194,6 +300,9 @@ export function parseJdProductDetail(payload: unknown): JdProductDetail {
shopName: '',
productCode: '',
skuId: '',
itemNum: '',
skuCount: null,
healthScore: null,
title: '',
brand: '',
categoryPath: '',
@@ -202,6 +311,8 @@ export function parseJdProductDetail(payload: unknown): JdProductDetail {
stockTotal: null,
saleStatus: '',
listTab: '',
jdCreatedAt: '',
jdOnlineAt: '',
jdUpdatedAt: '',
mainImageUrl: '',
attrCount: null,
@@ -217,6 +328,7 @@ export function parseJdProductDetail(payload: unknown): JdProductDetail {
item,
attrGroups,
images: toImages(record.images),
skus: toSkus(record.skus),
attrJsonRaw,
}
}