feat(jd-collect): 建单页按京麦店内分类多选采集

客户口径「类目不需要只要分类」「做成多选的」:采集建单页下线类目级联与平台分组,
换京麦「店内分类」快照多选(getShopCategoryList 2026-11-16 取证 9 个,见
ops docs/jd-collect-api-contract.md §2.6)。建单请求体/页面推送/兜底拉取三处同键
shopCategoryNames+shopCategoryIds(label+id 双键,行级填充形状未取证,客户端任一
命中即命中);categoryPaths 标 @Deprecated 仅历史行兼容。超长归一化文案泛化为
normalizeStringSelection;历史行 VO 带回双键供重试/继续同源。
删除建单页唯一消费方的死件:JdCategoryCascader.vue/jd-category-tree.ts/其测试
(后管另有在用副本,不受影响)。

判据:JdCollectTaskServiceTest 三例(双键归一化/空白归 null/51 个拒)+
JdTaskPullSpiImplTest 七键载荷透传;前端 jd-collect-tab/jd-shop-category/mount
三支(快照消费、双键同链、绊线:级联组件与分组接口不得回流建单页)。
可读棘轮:JdCollectTab.vue 804→786 行(同款返回按钮 CSS 合并、死 .download 类删除)。
客户端侧(app_client jd_base 行级过滤)同窗另一仓提交。
This commit is contained in:
2026-11-16 20:14:40 +08:00
parent 61c361222d
commit e621deea58
16 changed files with 435 additions and 855 deletions
@@ -70,6 +70,10 @@ export interface JdCollectCategoryVo {
/**
* 类目选项集(建单页多选面板第三栏)。公共库口径:从未采集过的店铺/新类目不在集内
* (先全店采集一次即有),拉取失败不阻塞建单——不选类目=全店采集。
*
* @deprecated 2026-11-16 建单页类目级联下线(客户口径「类目不需要只要分类」,换京麦
* 店内分类多选,见 pages/jd/jd-shop-category.ts);本函数与 /api/jd-collect/categories
* 端点保留给数据面(endpoints 冻结快照仍登记),建单页不再消费。
*/
export function fetchJdCollectCategories() {
return unwrapJavaResponse(
@@ -90,7 +94,12 @@ export interface JdCollectGroupVo {
productCount: number;
}
/** 店铺分类只读列表(「获取店铺数据」页展示;「商品上架」落地后消费同一端点)。 */
/**
* 店铺分类只读列表(「获取店铺数据」页展示;「商品上架」落地后消费同一端点)。
*
* @deprecated 2026-11-16 建单页的平台分组只读 chips 下线(同上:采集范围换京麦店内分类,
* 平台分组与采集范围是两套概念);分组数据面归后管京东数据库与商品上架,本函数保留。
*/
export function fetchJdCollectGroups() {
return unwrapJavaResponse(
get<JavaApiResponse<JdCollectGroupVo[]>>(
@@ -105,6 +114,8 @@ export function createJdCollectTask(
listTabs: JdListTab[],
maxProducts = 0,
categoryPaths: string[] = [],
shopCategoryNames: string[] = [],
shopCategoryIds: string[] = [],
) {
return unwrapJavaResponse(post<JavaApiResponse<JdCollectTaskVo>, Record<string, unknown>>(
buildJavaUrl(API_ENDPOINTS.jdCollect.create),
@@ -118,9 +129,13 @@ export function createJdCollectTask(
shopName,
listTabs,
maxProducts,
// 京麦末级类目名多选;空数组=全店采集(后端归一化后进 request_json,客户端按
// categoryPath 等值过滤——三处同键契约见 JdTaskPullSpiImplTest / jd_base.process_task)。
// 京麦末级类目名多选(2026-11-16 起建单页不再产生值,字段仅兼容保留);空数组=全店采集。
categoryPaths,
// 京麦「店内分类」多选(2026-11-16 取证后新增,getShopCategoryList 的 label/value 对):
// label 与 id 双键同发——行级 shopCategorys 填充形状未取证,客户端任一键命中即命中。
// 空数组=全店采集;三处同键契约见 JdTaskPullSpiImplTest / jd_base._read_shop_category_filter。
shopCategoryNames,
shopCategoryIds,
},
))
}
@@ -153,8 +168,12 @@ export interface JdCollectHistoryItemVo {
errorMessage?: string;
shopName?: string;
listTabs?: string[];
/** 建单时选的采集类目(京麦末级类目名多选;空=全店采集)。重试/继续重建推送载荷时同源带回 */
/** 建单时选的采集类目(京麦末级类目名多选;空=全店采集)。2026-11-16 起 UI 不再产生值,仅历史行兼容。重试/继续重建推送载荷时同源带回 */
categoryPaths?: string[];
/** 建单时选的京麦店内分类名(多选;空=全店采集)。重试/继续重建推送载荷时同源带回 */
shopCategoryNames?: string[];
/** 建单时选的京麦店内分类 id(与 shopCategoryNames 同一多选的 value 集) */
shopCategoryIds?: string[];
/** 已落京东数据库的商品行数 */
rowCount?: number;
itemsReceived?: number;