From 23e326df193b19f22b7700e20911da2e8c46b50a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Thu, 19 Nov 2026 12:50:53 +0800 Subject: [PATCH] =?UTF-8?q?feat(jd):=20=E9=87=87=E9=9B=86=E5=88=86?= =?UTF-8?q?=E7=B1=BB=E6=94=B9=E3=80=8C=E5=90=8C=E6=AD=A5=E5=88=86=E7=B1=BB?= =?UTF-8?q?=E3=80=8D=E6=8C=89=E5=BA=97=E5=AE=9E=E6=97=B6=E6=8B=89=E5=8F=96?= =?UTF-8?q?=EF=BC=8B=E5=9B=9E=E8=A1=A5=204.0.78=20=E7=AA=97=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E7=AB=AF=20amber=20notice=20=E6=BA=90=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- frontend-vue/src/pages/jd/JdCollectTab.vue | 189 +++++++++++++++--- frontend-vue/src/pages/jd/jd-shop-category.ts | 41 ---- .../shared/api/types/modules/jd-collect.ts | 2 +- frontend-vue/src/shared/bridges/pywebview.ts | 15 ++ frontend-vue/tests/jd-collect-tab.test.ts | 70 ++++++- frontend-vue/tests/jd-shop-category.test.ts | 54 ----- .../mount/jd-collect-progress.mount.test.ts | 174 ++++++++++++++-- 7 files changed, 393 insertions(+), 152 deletions(-) delete mode 100644 frontend-vue/src/pages/jd/jd-shop-category.ts delete mode 100644 frontend-vue/tests/jd-shop-category.test.ts diff --git a/frontend-vue/src/pages/jd/JdCollectTab.vue b/frontend-vue/src/pages/jd/JdCollectTab.vue index 54db790f2..0ea13aa36 100644 --- a/frontend-vue/src/pages/jd/JdCollectTab.vue +++ b/frontend-vue/src/pages/jd/JdCollectTab.vue @@ -21,13 +21,12 @@ import { userNotice } from '@/shared/utils/user-notice' import { formatDateTime } from '@/shared/utils/datetime' import { useLiveTaskBoard } from '@/shared/composables/useLiveTaskBoard' import NotificationBell from '@/shared/components/NotificationBell.vue' -import { JD_SHOP_CATEGORY_SNAPSHOT } from './jd-shop-category.ts' /** 京东「获取店铺数据」(v1.5):一键建单 → 推送本机客户端 → 右侧任务面板实时进度。 * * 四个真源与四条边界(照 v1.4 已落地的采集契约与外观专利任务面板骨架,不另造流程): * 1. 建单走后端 `/api/jd-collect/tasks`(通道恒 LOCAL,服务端落 PENDING);可选多选采集 - * 分类(京麦「店内分类」快照,`shopCategoryNames`/`shopCategoryIds` 双键)——空=全店 + * 分类(京麦「店内分类」,`shopCategoryNames`/`shopCategoryIds` 双键)——空=全店 * 采集,选中值随建单进 request_json、随推送/兜底拉取进客户端,客户端按行 * shopCategorys/shopCategoryPath/groupId 等值过滤、任一键命中即命中(三处同键契约; * 2026-11-16 类目级联按客户口径「类目不需要只要分类」下线,categoryPaths 仅历史行兼容); @@ -38,9 +37,12 @@ import { JD_SHOP_CATEGORY_SNAPSHOT } from './jd-shop-category.ts' * 4. 失败/中断任务「重试/继续」走通用原位复位(铁律 26,保留已收分片与断点游标), * 复位后页面重新激活并推队列——同一份输入不再多出好几行结果。 * - * 2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」落点改为本多选块: - * 客户的参照系是京麦后台的「店内分类」(getShopCategoryList 快照),不再是后管平台分组 - * (平台分组接口从本页下线,分组数据面归京东数据库与商品上架)。 + * 2026-11-19 客户口径「每一家店铺的分类都会不一样」:选项集正本从冻结快照 + * (2026-11-16 对花屿巷一家店的抓包,对第二家店必错)改为**按店实时拉取**—— + * 「同步分类」按钮 → 桥 `get_jd_shop_categories` → 客户端用本机已登录京麦的 + * profile 现拉 getShopCategoryList(执行体 amazon/jd/shop_categories.py)。 + * 店内分类是商家在京麦后台自维护的,选项集永远等于「本机已登录那家店」的现值; + * 老客户端没有该桥方法 ⇒ 按钮置灰并提示升级。 */ /** 页面不再让用户填店铺名:店铺名称由客户端从京麦后台读,建单先按此占位记录。 */ @@ -54,22 +56,96 @@ const username = ref('admin') const submitting = ref(false) const errorMessage = ref('') const successMessage = ref('') +/** 推送失败等「设计内慢路径」提示:amber 展示,不占红色 error(2026-11-19 用户反馈红条吓人)。 */ +const noticeMessage = ref('') // ---- 采集分类(可选,下拉多选;空=全店采集)---- -/** 选项集=京麦「店内分类」快照(getShopCategoryList,2026-11-16 真机取证 9 个; - * 京麦侧改分类后按取证路重抓,见 jd-shop-category.ts 头注释——快照不会自动过期告警)。 - * 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」:复选列表换 el-select 多选 - * (collapse-tags 折叠成「+N」徽标),选择模型改存分类 id 数组,label/id 双键从快照反查。 */ -const shopCategoryOptions = JD_SHOP_CATEGORY_SNAPSHOT +/** 京麦「店内分类」项:label=分类名(行级等值词),value=分类 id。形状与旧快照同形。 */ +interface ShopCategoryOption { + label: string + value: string +} + +/** 选项集=「同步分类」从本机已登录京麦店铺现拉的实时结果(2026-11-19 起; + * 旧冻结快照已退役——每家店的店内分类名字与 id 都不同,写死必错)。 */ +const shopCategoryOptions = ref([]) const selectedShopCategoryValues = ref([]) +/** 同步中/可用态:可用性按桥上有没有 get_jd_shop_categories 方法判(老客户端置灰)。 */ +const syncingCategories = ref(false) +const canSyncCategories = ref(false) +/** 最近一次同步到的店铺名(空=尚未同步或京麦页面没返回店铺名)。 */ +const syncedShopName = ref('') + +/** 无桥(浏览器打开)或老客户端(桥没有该方法)时点同步的提示。 */ +const SYNC_UNAVAILABLE_NOTE = + '当前在浏览器中打开或客户端版本较旧,无法同步店内分类。请在本机客户端中打开本页;仍不可用请把客户端升级到最新版' + +function refreshSyncAvailability() { + canSyncCategories.value = typeof getPywebviewApi()?.get_jd_shop_categories === 'function' +} + +/** 分类块底部说明:同步状态 + 选中口径 + 「先挂分类才有命中」的边界,一行讲完。 */ +const categoryHint = computed(() => { + const parts: string[] = [] + if (syncedShopName.value) { + parts.push(`已同步店铺「${syncedShopName.value}」:${shopCategoryOptions.value.length} 个分类`) + } else { + parts.push('分类来自本机客户端已登录的京麦店铺,点「同步分类」拉取;未同步或空选=全店采集') + } + if (selectedShopCategoryValues.value.length) { + parts.push(`只采选中 ${selectedShopCategoryValues.value.length} 个分类的商品`) + } + parts.push('商品要先在京麦挂上分类才会被选中') + return `${parts.join(';')}。` +}) + +/** 点「同步分类」:桥 → 客户端现拉 getShopCategoryList。成功刷新选项集并清理 + * 不属于当前店铺的已选 id(id 是店铺自有,跨店必错);失败按 code 分档—— + * jd_busy(京东任务在跑)走 amber notice,jd_login/jd_page/未知走红色 error。 */ +async function syncShopCategories() { + if (syncingCategories.value) return + errorMessage.value = '' + noticeMessage.value = '' + const api = getPywebviewApi() + const bridge = api?.get_jd_shop_categories + if (typeof bridge !== 'function') { + errorMessage.value = SYNC_UNAVAILABLE_NOTE + return + } + syncingCategories.value = true + try { + const result = await bridge() + if (result?.success && Array.isArray(result.categories)) { + const options = result.categories.filter((item) => item && item.label && item.value) + const optionIds = new Set(options.map((item) => item.value)) + const staleCount = + selectedShopCategoryValues.value.filter((value) => !optionIds.has(value)).length + selectedShopCategoryValues.value = + selectedShopCategoryValues.value.filter((value) => optionIds.has(value)) + shopCategoryOptions.value = options + syncedShopName.value = result.shopName || '' + if (staleCount > 0) { + noticeMessage.value = `已按当前店铺刷新分类,清除了 ${staleCount} 个不属于当前店铺的已选项` + } + } else if (result?.code === 'jd_busy') { + noticeMessage.value = result.error || '京东任务正在运行,请等任务结束后再同步分类' + } else { + errorMessage.value = result?.error || '同步分类未返回结果,请稍后重试' + } + } catch (error) { + errorMessage.value = error instanceof Error ? `同步分类失败:${error.message}` : '同步分类失败,请稍后重试' + } finally { + syncingCategories.value = false + } +} function clearShopCategories() { selectedShopCategoryValues.value = [] } -/** 选中项按快照原序反查回对象(下拉里点选的先后不进请求体——双键顺序恒等于快照序)。 */ +/** 选中项按选项集原序反查回对象(下拉里点选的先后不进请求体——双键顺序恒等于同步序)。 */ const selectedShopCategories = computed(() => - shopCategoryOptions.filter((item) => selectedShopCategoryValues.value.includes(item.value)), + shopCategoryOptions.value.filter((item) => selectedShopCategoryValues.value.includes(item.value)), ) /** 建单/推送载荷的选中值:label 与 id 双键同发(行级填充形状未取证,任一键命中即命中)。 */ @@ -289,7 +365,14 @@ async function activateTask(id: number): Promise { } } -/** 建单成功后推送本机队列;返回 null 表示环境无队列能力(浏览器预览),返回 string 表示失败原因。 +/** 推送失败 ≠ 建单失败:任务已在服务端落库,客户端兜底拉取线程(60 秒一轮)会自动认领。 + * 2026-11-19 用户反馈红色「推送失败」横幅吓人(实为设计内慢路径,最多晚约 1 分钟)—— + * 文案改中性动作句,展示走 amber notice 通道,红色 error 只留给真失败(建单/激活失败)。 */ +const PUSH_FALLBACK_NOTE = + '任务已创建,但未能即时推送到本机队列。请保持本机客户端在线,客户端会在约 1 分钟内自动领取并执行' + +/** 建单成功后推送本机队列;返回 null 表示已推送成功,返回 string 表示要展示的提示文案 + * (含浏览器无桥环境——任务仍会由在线客户端兜底认领,不是失败)。 * shopCategoryNames/Ids 是建单时选的京麦店内分类(重试/继续从历史行同源带回)——推送载荷 * 与建单请求体、客户端兜底拉取(request_json)三处同键,缺一处客户端就按全店采集跑。 */ async function pushToClientQueue( @@ -301,7 +384,7 @@ async function pushToClientQueue( ): Promise { const api = getPywebviewApi() if (!api?.enqueue_json) { - return '当前环境未启用任务队列能力(浏览器预览环境不会启动),请在本机客户端中打开本页' + return '当前在浏览器中打开,无法直接推送本机队列。任务已创建,将由在线的本机客户端自动领取;如需本机立即执行,请在本机客户端中打开本页' } const payload = { type: 'jd-shop-collect-run', @@ -316,7 +399,7 @@ async function pushToClientQueue( if (pushResult?.error) { console.error('[jd-collect] enqueue_json 被拒', pushResult.error) } - return '推送本机队列失败,任务将由客户端兜底拉取认领' + return PUSH_FALLBACK_NOTE } const isRunning = computed(() => Boolean(board.dashboard.value.pendingTaskCount) || submitting.value) @@ -325,6 +408,7 @@ async function startCollect() { if (submitting.value) return errorMessage.value = '' successMessage.value = '' + noticeMessage.value = '' submitting.value = true const shop = DEFAULT_SHOP_NAME const tabs = DEFAULT_TABS @@ -333,25 +417,24 @@ async function startCollect() { try { const vo = await createJdCollectTask(shop, tabs, 0, [], shopNames, shopIds) board.addPollingTask(vo.taskId) - let pushNote = '' const activateError = await activateTask(vo.taskId) if (activateError) { // 没激活成功就不推队列:推了也是白跑一轮(分片全被拒)。任务留在 PENDING, - // 由服务端兜底拉取认领后照样会跑,所以这里只提示、不回滚建单。 - pushNote = activateError + // 由客户端兜底拉取认领后照样会跑,所以这里只提示、不回滚建单。 + // 激活失败是服务端原因,留在红色 error 档提醒用户可重试。 + errorMessage.value = activateError } else { try { const pushError = await pushToClientQueue(vo.taskId, shop, tabs, shopNames, shopIds) - if (pushError) pushNote = pushError + // 推送失败只是慢路径(兜底拉取约 1 分钟内认领),走 amber notice,不占红色 error。 + if (pushError) noticeMessage.value = pushError } catch (pushErr) { - // 推送自身异常不回滚建单:任务可由服务端兜底拉取认领。 - pushNote = '推送本机队列失败,任务将由服务端兜底派发给本机客户端执行' + // 推送自身异常不回滚建单:任务可由客户端兜底拉取认领。 + noticeMessage.value = PUSH_FALLBACK_NOTE console.error('[jd-collect] 推送本机队列失败', pushErr) } } - if (pushNote) { - errorMessage.value = pushNote - } else { + if (!errorMessage.value && !noticeMessage.value) { successMessage.value = shopNames.length ? `任务已创建(只采 ${shopNames.length} 个分类)并推送给本机客户端,进度显示在右侧任务区` : '任务已创建并推送给本机客户端,进度显示在右侧任务区' @@ -368,6 +451,9 @@ onMounted(async () => { const localName = (window.localStorage.getItem('username') || '').trim() if (localName) username.value = localName board.loadPollingIds() + // 同步按钮可用性:桥晚到(pywebviewready 在挂载之后)也要能翻成可用。 + refreshSyncAvailability() + window.addEventListener('pywebviewready', refreshSyncAvailability) await Promise.all([ board.loadDashboard().catch(() => undefined), board.loadHistory().catch(() => undefined), @@ -378,6 +464,7 @@ onMounted(async () => { }) onUnmounted(() => { + window.removeEventListener('pywebviewready', refreshSyncAvailability) board.dispose() }) @@ -412,17 +499,19 @@ onUnmounted(() => {
@@ -647,14 +737,45 @@ onUnmounted(() => { margin-bottom: 16px; } +/* label 与「同步分类」按钮同一行(2026-11-19 用户口径:店内分类旁边加个同步按钮)。 */ +.category-head { + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + margin-bottom: 8px; +} + .category-label { display: block; - margin-bottom: 8px; color: #c8d2e2; font-size: 13px; font-weight: 600; } +.shop-cat-sync { + flex-shrink: 0; + padding: 4px 12px; + border: 1px solid #3e4a62; + border-radius: 6px; + background: #232b3d; + color: #6ea8ff; + font-size: 12px; + font-family: inherit; + cursor: pointer; + transition: all 0.2s; +} + +.shop-cat-sync:hover:not(:disabled) { + background: #2b3447; + border-color: #6ea8ff; +} + +.shop-cat-sync:disabled { + opacity: 0.5; + cursor: not-allowed; +} + .category-hint { margin: 8px 0 0; color: #7f8ca3; @@ -729,6 +850,12 @@ onUnmounted(() => { color: #fca5a5; } +/* amber notice:设计内慢路径(推送失败走兜底拉取)专用,不是错误——与 success/error 同族配色 */ +.feedback.notice { + background: rgba(245, 158, 11, 0.14); + color: #fcd34d; +} + /* 行内动作按钮:与外观专利 Tab 同色系(中断琥珀/重试绿/删除红),钉死 12px 字号 */ .btn-delete, .btn-retry, .btn-interrupt { border: none; cursor: pointer; border-radius: 6px; font-size: 12px; } .btn-delete { padding: 6px 10px; color: #ff8f8f; background: rgba(231, 76, 60, .12); } diff --git a/frontend-vue/src/pages/jd/jd-shop-category.ts b/frontend-vue/src/pages/jd/jd-shop-category.ts deleted file mode 100644 index 730268da6..000000000 --- a/frontend-vue/src/pages/jd/jd-shop-category.ts +++ /dev/null @@ -1,41 +0,0 @@ -/** 京麦「店内分类」快照——建单页采集分类多选的选项集(2026-11-16 真机取证)。 - * - * 数据来源(唯一正本):京麦商品列表页首屏自发的 - * `dsm.product.manage.ShopCategoryReadViewService.getShopCategoryList` - * (响应 `data.shopCategoryList[]` = `{parent:"0", orderNo, children:[], label, value}`; - * 2026-11-16 本机 Chrome 19899/chrome_data_jd profile 真机抓包,原始响应与取证脚本存 - * D:/tmp/jd_group_probe/)。label=店内分类名,value=分类 id;扁平单层(parent 恒 0、 - * children 恒空),本店 9 个,按 orderNo 排序。 - * - * 口径与边界(先说清,防止后人当它错改): - * - 这是**京麦侧**的店内分类(商家在京麦后台维护),不是后管「京东数据库」的平台分组 - * (那是 biz_jd_product_group,两套概念,2026-11-16 客户口径「选京麦的内部分类去采集」 - * 指的是这一套); - * - 行级过滤键:列表行 `shopCategorys/shopCategoryPath/groupId`(取证见客户端 - * `app_client/amazon/jd/jd_base.py::_filter_by_shop_category`);**填充形状未取证** - * (450 行采样全空——采样店铺还没给商品挂分类),所以建单把 label 与 value 双键同发 - * (shopCategoryNames + shopCategoryIds),客户端任一键命中即命中; - * - ⚠ 采样店铺(花屿巷)当前 0/450 商品挂了店内分类:选任何分类采集都是 0 行命中 - * (客户端零命中时打 WARNING 校准点),商家在京麦把商品挂上分类后本功能才真正生效; - * - 京麦侧改分类(增删改名)后按原取证路重抓替换本数据(快照不会自动过期告警)。 - * - * 纯数据,node --test 直测。后管若要用,复制同形文件(两前端没有共享包)。 */ - -/** 店内分类项:label=分类名(行级等值词),value=分类 id(取证留档 + id 形状对冲)。 */ -export interface JdShopCategory { - label: string - value: string -} - -/** 京麦店内分类快照(2026-11-16 取证,getShopCategoryList 按 orderNo 原序)。 */ -export const JD_SHOP_CATEGORY_SNAPSHOT: JdShopCategory[] = [ - { label: '工作制服', value: '1024347567' }, - { label: '礼服/演出服', value: '1024347568' }, - { label: '女士演出服/民族服装', value: '1024347569' }, - { label: '特殊服装', value: '1024347570' }, - { label: '睡衣/家居服', value: '1024347571' }, - { label: '拉丁舞服', value: '1024347572' }, - { label: '服饰配件', value: '1024347573' }, - { label: '男士卫衣', value: '1024347574' }, - { label: '其他', value: '1024347575' }, -] diff --git a/frontend-vue/src/shared/api/types/modules/jd-collect.ts b/frontend-vue/src/shared/api/types/modules/jd-collect.ts index 9b32fcd90..c39f35d2a 100644 --- a/frontend-vue/src/shared/api/types/modules/jd-collect.ts +++ b/frontend-vue/src/shared/api/types/modules/jd-collect.ts @@ -72,7 +72,7 @@ export interface JdCollectCategoryVo { * (先全店采集一次即有),拉取失败不阻塞建单——不选类目=全店采集。 * * @deprecated 2026-11-16 建单页类目级联下线(客户口径「类目不需要只要分类」,换京麦 - * 店内分类多选,见 pages/jd/jd-shop-category.ts);本函数与 /api/jd-collect/categories + * 店内分类多选);本函数与 /api/jd-collect/categories * 端点保留给数据面(endpoints 冻结快照仍登记),建单页不再消费。 */ export function fetchJdCollectCategories() { diff --git a/frontend-vue/src/shared/bridges/pywebview.ts b/frontend-vue/src/shared/bridges/pywebview.ts index d8484b4a5..e05bc9472 100644 --- a/frontend-vue/src/shared/bridges/pywebview.ts +++ b/frontend-vue/src/shared/bridges/pywebview.ts @@ -204,6 +204,21 @@ export interface PywebviewApi { enqueue_json?: ( data: unknown, ) => Promise<{ success: boolean; queue_size?: number; error?: string; code?: string }>; + /** + * 京东建单页「同步分类」:现拉本机已登录京麦店铺的「店内分类」(2026-11-19 起 + * 选项集正本,替代冻结快照——每家店的店内分类名字与 id 都不同)。执行体在客户端 + * amazon/jd/shop_categories.py,全程返回 dict;code 分档 jd_busy(京东任务在跑, + * amber notice)/ jd_login(京麦未登录)/ jd_page(页面结构变更,红色 error)。 + * 老客户端没有这个方法 ⇒ 页面把「同步分类」按钮置灰并提示升级。 + */ + get_jd_shop_categories?: () => Promise<{ + success: boolean; + shopName?: string; + shopId?: string; + categories?: Array<{ label: string; value: string }>; + code?: string; + error?: string; + }>; // —— ASIN 变体采集(VariantCollectionAPI,vc_* 前缀)—— vc_select_input_files?: () => Promise; vc_start_collect?: (params: { diff --git a/frontend-vue/tests/jd-collect-tab.test.ts b/frontend-vue/tests/jd-collect-tab.test.ts index 9181db472..5f520d17e 100644 --- a/frontend-vue/tests/jd-collect-tab.test.ts +++ b/frontend-vue/tests/jd-collect-tab.test.ts @@ -50,8 +50,11 @@ test('endpoints 注册采集类目 categories 端点(数据面保留)', () = }) /** 2026-11-16 口径修订:客户参照系是京麦后台的「店内分类」,平台分组 chips 从本页下线 - * (分组数据面归后管京东数据库与商品上架,端点与 fetch 函数保留)。 */ -test('分类多选来自京麦店内分类快照,平台分组从本页下线', () => { + * (分组数据面归后管京东数据库与商品上架,端点与 fetch 函数保留)。 + * 2026-11-19 客户口径「每一家店铺的分类都会不一样」:选项集正本从冻结快照改为按店 + * 实时拉取——「同步分类」按钮 → 桥 get_jd_shop_categories → 客户端用本机已登录京麦 + * profile 现拉 getShopCategoryList(执行体 amazon/jd/shop_categories.py)。 */ +test('分类多选改桥实时拉取,快照与平台分组从本页退役', () => { const endpoints = readIfExists(ENDPOINTS, 'endpoints.ts') assert.ok(endpoints.includes("groups: '/api/jd-collect/groups'"), 'endpoints.ts jdCollect 组仍须登记 groups(冻结快照口径;建单页 UI 已下线,仅数据面保留)') @@ -67,8 +70,12 @@ test('分类多选来自京麦店内分类快照,平台分组从本页下线', join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'), 'JdCollectTab.vue', ) - assert.ok(page.includes('JD_SHOP_CATEGORY_SNAPSHOT'), - 'JdCollectTab.vue 必须消费京麦店内分类快照(jd-shop-category.ts)作采集分类多选选项') + assert.ok(page.includes('get_jd_shop_categories'), + 'JdCollectTab.vue 必须经桥 get_jd_shop_categories 拉店内分类(冻结快照已退役:每家店的分类不同)') + assert.ok(page.includes('同步分类'), + 'JdCollectTab.vue 必须有「同步分类」按钮(2026-11-19 用户口径:店内分类旁边加个同步按钮)') + assert.ok(!page.includes('JD_SHOP_CATEGORY_SNAPSHOT') && !page.includes('jd-shop-category'), + 'JdCollectTab.vue 不得再消费冻结快照(jd-shop-category.ts 已删除:快照只对取证那一家店正确)') assert.ok(page.includes('采集分类(可选,多选)'), 'JdCollectTab.vue 必须以「采集分类(可选,多选)」展示分类块') assert.ok(page.includes(' { + const page = readIfExists( + join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'), + 'JdCollectTab.vue', + ) + const startAt = page.indexOf('async function syncShopCategories') + assert.ok(startAt > 0, 'JdCollectTab.vue 缺 syncShopCategories') + const body = page.slice(startAt, page.indexOf('function clearShopCategories')) + assert.ok(body.includes("code === 'jd_busy'") && body.includes('noticeMessage.value'), + '同步返回 jd_busy 必须走 amber notice(京东任务在跑是设计内等待,不是错误)') + assert.ok(body.includes('errorMessage.value = result?.error'), + 'jd_login/jd_page/未知失败必须走红色 error(京麦未登录要用户去登录)') + assert.ok(page.includes('SYNC_UNAVAILABLE_NOTE') && page.includes('升级到最新版'), + '无桥/老客户端点同步必须给出升级指引(按钮置灰是第一道,提示文案是兜底)') + assert.ok(!page.includes('jd-shop-category'), + '同步失败路径不得再回落到冻结快照(快照已删除,回落即编译错)') +}) + +/** 快照正本退役:选项集不再有仓库内的静态正本文件(每家店不同,写死必错)。 */ +test('店内分类快照文件已删除,无残留引用', () => { + assert.ok(!existsSync(join(process.cwd(), 'src', 'pages', 'jd', 'jd-shop-category.ts')), + 'jd-shop-category.ts 必须删除(快照只对 2026-11-16 取证那一家店正确)') + const bridge = readIfExists( + join(process.cwd(), 'src', 'shared', 'bridges', 'pywebview.ts'), + 'pywebview.ts', + ) + assert.ok(bridge.includes('get_jd_shop_categories'), + 'pywebview.ts 必须登记 get_jd_shop_categories 桥类型(老客户端无此方法 ⇒ 按钮置灰提示升级)') +}) + test('建单请求体与推送载荷都带店内分类双键', () => { const api = readIfExists( join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'), @@ -155,3 +194,26 @@ test('建单后先激活再推客户端队列', () => { assert.ok(activateAt < pushAt, '激活必须排在推送之前(PENDING 状态下推给客户端=分片全被拒)') }) + +/** 2026-11-19 用户实录:建单撞上客户端升级重启窗口,推送失败被渲染成红色「推送失败」 + * 横幅(兜底拉取 2 分钟后照常认领,任务没坏)。推送失败是设计内慢路径不是错误——文案 + * 改中性动作句、展示走 amber notice 通道,红色 error 只留给真失败(建单/激活失败)。 + * 把提示改回塞进 errorMessage 即红。 */ +test('推送失败的兜底提示走 notice 通道,不占红色 error', () => { + const page = readIfExists( + join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'), + 'JdCollectTab.vue', + ) + assert.ok(page.includes('PUSH_FALLBACK_NOTE'), + '推送失败提示必须收敛到单一常量 PUSH_FALLBACK_NOTE(两分支各写一份会漂)') + assert.ok(page.includes('noticeMessage.value = pushError') && page.includes('noticeMessage.value = PUSH_FALLBACK_NOTE'), + '推送失败提示必须写进 noticeMessage(amber notice 通道)') + const startAt = page.indexOf('async function startCollect') + assert.ok(startAt > 0, 'JdCollectTab.vue 缺 startCollect') + assert.ok(!page.slice(startAt).includes('errorMessage.value = pushNote'), + 'startCollect 不得再把推送失败提示塞进红色 error 横幅(errorMessage 只留激活/建单真失败)') + assert.ok(page.includes('class="feedback notice"'), + '模板必须有 feedback notice 档(amber),红色 error 不得再兜住推送失败') + assert.ok(!page.includes('推送本机队列失败,任务将由'), '旧「推送失败」横幅文案必须下线') + assert.ok(page.includes('约 1 分钟内自动领取'), '兜底提示必须给出预期时长(约 1 分钟内自动领取)') +}) diff --git a/frontend-vue/tests/jd-shop-category.test.ts b/frontend-vue/tests/jd-shop-category.test.ts deleted file mode 100644 index 9c7b6f35b..000000000 --- a/frontend-vue/tests/jd-shop-category.test.ts +++ /dev/null @@ -1,54 +0,0 @@ -import { test } from 'node:test' -import assert from 'node:assert/strict' -import { existsSync, readFileSync } from 'node:fs' -import { join } from 'node:path' - -/** 京麦「店内分类」快照契约(2026-11-16 真机取证,建单页采集分类多选的选项集)。 - * - * 快照是纯前端静态数据(getShopCategoryList 的 label/value 对,扁平单层)。判据钉四件: - * ① 快照非空且形状齐(label/value 都非空字符串);② label 不重复(多选以 label 下发, - * 重名会让客户端过滤语义歧义);③ 取证出处注释在位(后人按原路重抓,防止当它错改); - * ④ 建单页消费快照(对手面 jd-collect-tab.test.ts 的发送口断言)。 */ - -const SNAPSHOT = join(process.cwd(), 'src', 'pages', 'jd', 'jd-shop-category.ts') - -function readIfExists(path: string, what: string): string { - assert.ok(existsSync(path), `${what} 尚未落地:${path}`) - return readFileSync(path, 'utf8') -} - -test('店内分类快照非空且每项 label/value 齐全', async () => { - const mod = await import('../src/pages/jd/jd-shop-category.ts') - const { JD_SHOP_CATEGORY_SNAPSHOT } = mod as { - JD_SHOP_CATEGORY_SNAPSHOT: { label: string; value: string }[] - } - assert.ok(Array.isArray(JD_SHOP_CATEGORY_SNAPSHOT) && JD_SHOP_CATEGORY_SNAPSHOT.length > 0, - '快照不得为空(2026-11-16 取证 9 个)') - for (const item of JD_SHOP_CATEGORY_SNAPSHOT) { - assert.ok(typeof item.label === 'string' && item.label.trim().length > 0, - `label 必须是非空字符串: ${JSON.stringify(item)}`) - assert.ok(typeof item.value === 'string' && item.value.trim().length > 0, - `value(京麦分类 id)必须是非空字符串: ${JSON.stringify(item)}`) - } -}) - -test('快照 label 不重复(多选按 label 下发,重名会让过滤语义歧义)', async () => { - const mod = await import('../src/pages/jd/jd-shop-category.ts') - const { JD_SHOP_CATEGORY_SNAPSHOT } = mod as { - JD_SHOP_CATEGORY_SNAPSHOT: { label: string }[] - } - const labels = JD_SHOP_CATEGORY_SNAPSHOT.map((item) => item.label) - assert.equal(new Set(labels).size, labels.length, - `label 有重复: ${labels.join(', ')}`) -}) - -test('取证出处与边界注释在位(防后人当它错改)', () => { - const body = readIfExists(SNAPSHOT, 'jd-shop-category.ts') - assert.ok(body.includes('getShopCategoryList'), - '快照文件必须写明数据来源接口(ShopCategoryReadViewService.getShopCategoryList)') - assert.ok(body.includes('2026-11-16'), '快照文件必须带取证日期') - assert.ok(body.includes('shopCategorys') || body.includes('shopCategoryPath'), - '快照文件必须写明行级过滤键(shopCategorys/shopCategoryPath/groupId)') - assert.ok(body.includes('0/450') || body.includes('没给商品挂分类'), - '快照文件必须写明「采样店铺 0 商品挂分类」的现状边界(选分类=0 行命中是已知形状)') -}) diff --git a/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts b/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts index 2eb66882d..1e8e5ce42 100644 --- a/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts +++ b/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts @@ -32,6 +32,8 @@ const api = vi.hoisted(() => ({ interruptJdCollectTask: vi.fn(), retryClientTask: vi.fn(), enqueue: vi.fn(), + // 2026-11-19「同步分类」:选项集正本从冻结快照改为桥实时拉取(每家店的店内分类不同)。 + syncCategories: vi.fn(), })) vi.mock('@/shared/api/types/modules/jd-collect', () => ({ @@ -50,7 +52,7 @@ vi.mock('@/shared/api/task-retry', () => ({ retryClientTask: api.retryClientTask, })) vi.mock('@/shared/bridges/pywebview', () => ({ - getPywebviewApi: () => ({ enqueue_json: api.enqueue }), + getPywebviewApi: () => ({ enqueue_json: api.enqueue, get_jd_shop_categories: api.syncCategories }), })) const EMPTY_DASHBOARD = { @@ -141,10 +143,29 @@ async function startCollect(w: VueWrapper) { await flushPromises() } +/** 「同步分类」拉回的当前店铺分类样本(label/value 与旧快照同形;顺序=同步序/orderNo)。 */ +const SYNCED_CATEGORIES = [ + { label: '工作制服', value: '1024347567' }, + { label: '礼服/演出服', value: '1024347568' }, + { label: '拉丁舞服', value: '1024347572' }, +] + +function syncedResult(over: Record = {}) { + return { success: true, shopName: '花屿巷旗舰店', shopId: '165515933', categories: SYNCED_CATEGORIES, ...over } +} + +async function syncCategories(w: VueWrapper) { + await w.find('.shop-cat-sync').trigger('click') + await flushPromises() +} + beforeEach(() => { vi.useFakeTimers() localStorage.setItem('username', 'admin') - for (const mock of Object.values(api)) mock.mockReset() + for (const mock of Object.values(api)) { + // 无桥用例会把 syncCategories 覆写成 undefined,这里按可重置性防御(保持全量 reset 语义)。 + if (typeof (mock as { mockReset?: unknown })?.mockReset === 'function') mock.mockReset() + } api.createJdCollectTask.mockResolvedValue({ taskId: 88, taskNo: 'JD-1', collectChannel: 'LOCAL' }) api.activateJdCollectTask.mockResolvedValue(null) api.fetchJdCollectCategories.mockResolvedValue([]) @@ -305,13 +326,47 @@ describe('获取店铺数据:一键采集 + 任务面板', () => { expect(w.find('.feedback.error').exists()).toBe(false) }) + it('推送本机队列失败:走 amber notice 提示(不占红色 error),建单与轮询照常', async () => { + // 2026-11-19 用户实录:建单撞上客户端升级重启窗口,推送失败被渲染成红色「推送失败」 + // 横幅;实为设计内兜底慢路径(客户端 60 秒一轮 pull-pending 自动认领,最多晚约 1 + // 分钟)。桥返回失败必须按提示展示,红色 error 只留给真失败(建单/激活失败)。 + api.enqueue.mockResolvedValue({ success: false, error: 'queue is closing' }) + const w = await mountPage() + await startCollect(w) + + expect(api.createJdCollectTask).toHaveBeenCalledTimes(1) + const notice = w.find('.feedback.notice') + expect(notice.exists()).toBe(true) + expect(notice.text()).toContain('任务已创建') + expect(notice.text()).toContain('自动领取') + expect(notice.text()).not.toContain('失败') + expect(w.find('.feedback.error').exists()).toBe(false) + // 建单成功即进轮询:兜底拉取认领后进度照常上屏 + expect(api.fetchJdCollectTaskProgressBatch).toHaveBeenCalled() + }) + + it('推送抛异常:同样走 notice 提示、不回滚建单', async () => { + api.enqueue.mockRejectedValue(new Error('bridge gone')) + const w = await mountPage() + await startCollect(w) + + const notice = w.find('.feedback.notice') + expect(notice.exists()).toBe(true) + expect(notice.text()).toContain('自动领取') + expect(notice.text()).not.toContain('失败') + expect(w.find('.feedback.error').exists()).toBe(false) + expect(api.fetchJdCollectTaskProgressBatch).toHaveBeenCalled() + }) + it('下拉选分类后建单:店内分类双键随建单请求体与推送载荷同链下发', async () => { // 2026-11-16 客户口径「类目不需要只要分类」「选京麦的内部分类去采集」; - // 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」:checkbox 列表换 el-select - // 多选(collapse-tags)。选项集=京麦「店内分类」快照(jd-shop-category.ts,取证 9 个), - // 选择模型是 id 数组;建单请求体与推送载荷带 label+id 双键、按快照原序反查(行级填充 - // 形状未取证,客户端任一键命中即命中)——选中项用快照真实行,贴合下发形状。 + // 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」;2026-11-19 选项集改 + // 「同步分类」桥实时拉取(每家店的店内分类名字与 id 都不同,冻结快照已退役)。 + // 建单请求体与推送载荷带 label+id 双键、按选项集原序反查(行级填充形状未取证, + // 客户端任一键命中即命中)——选中项用同步样本真实行,贴合下发形状。 + api.syncCategories.mockResolvedValue(syncedResult()) const w = await mountPage(true) + await syncCategories(w) const select = w.findComponent(ElSelect) expect(select.exists(), '采集分类必须是下拉多选(el-select),不再是逐条复选框').toBe(true) @@ -320,7 +375,7 @@ describe('获取店铺数据:一键采集 + 任务面板', () => { await startCollect(w) - // 双键顺序恒等于快照序(工作制服在前),与点选先后无关——同源反查,不随 UI 顺序漂。 + // 双键顺序恒等于选项集序(工作制服在前),与点选先后无关——同源反查,不随 UI 顺序漂。 expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [], ['工作制服', '拉丁舞服'], ['1024347567', '1024347572']) const payload = api.enqueue.mock.calls[0][0] @@ -334,26 +389,103 @@ describe('获取店铺数据:一键采集 + 任务面板', () => { }) }) - it('采集分类块:下拉渲染快照全量选项并可清空(恢复全店采集)', async () => { + it('同步分类成功:选项集换成当前店铺实时分类并显示店铺名(不再是 9 个冻结快照)', async () => { const w = await mountPage(true) const block = w.findAll('.category-block').find((el) => el.text().includes('采集分类')) expect(block, '必须有「采集分类(可选,多选)」块').toBeTruthy() - expect(block!.text()).toContain('采集分类(可选,多选)') - // 快照 9 项全进下拉选项(客户端「能看见管理员/商家建的分类」口径落点就在这; - // 弹层 teleport 到 body,选项组件仍挂在页面组件树里,按组件计数不按 DOM) - expect(w.findAllComponents(ElOption).length).toBe(9) - expect(block!.find('.shop-cat-select').exists(), '分类块必须是 el-select 下拉').toBe(true) - expect(block!.text()).toContain('默认全店采集') + // 未同步:选项集为空(不预置任何快照),提示指向「同步分类」;空选=全店采集。 + expect(w.findAllComponents(ElOption).length).toBe(0) + expect(block!.text()).toContain('未同步或空选=全店采集') + expect(block!.text()).not.toContain('2026-11-16 快照') expect(block!.findComponent(ElSelect).props('placeholder')).toBe('全店采集(点击选择分类)') - const select = block!.findComponent(ElSelect) - await select.vm.$emit('update:modelValue', ['1024347567']) + api.syncCategories.mockResolvedValue(syncedResult()) + await syncCategories(w) + + expect(w.findAllComponents(ElOption).length).toBe(SYNCED_CATEGORIES.length, + '选项集必须等于桥拉回的当前店铺分类,不是冻结快照的 9 个') + expect(block!.text()).toContain('已同步店铺「花屿巷旗舰店」:3 个分类') + expect(block!.text()).not.toContain('未同步') + // 按钮回到可再同步态(店铺侧改了分类可随时重拉) + const syncBtn = w.find('.shop-cat-sync') + expect(syncBtn.text()).toBe('同步分类') + expect(syncBtn.attributes('disabled')).toBeUndefined() + }) + + it('同步失败 jd_busy:京东任务在跑是设计内等待,走 amber notice 不占红色 error', async () => { + api.syncCategories.mockResolvedValue( + syncedResult({ success: false, code: 'jd_busy', error: '京东采集/发布任务正在运行,请等任务结束后再同步分类' })) + const w = await mountPage(true) + await syncCategories(w) + + const notice = w.find('.feedback.notice') + expect(notice.exists()).toBe(true) + expect(notice.text()).toContain('任务正在运行') + expect(w.find('.feedback.error').exists()).toBe(false) + // 分类照常未同步:选项集仍空(busy 后不得回落假数据) + expect(w.findAllComponents(ElOption).length).toBe(0) + }) + + it('同步失败 jd_login:京麦未登录要用户去登录,走红色 error', async () => { + api.syncCategories.mockResolvedValue( + syncedResult({ success: false, code: 'jd_login', error: '京麦未登录(登录态失效),请先在客户端登录京麦' })) + const w = await mountPage(true) + await syncCategories(w) + + const error = w.find('.feedback.error') + expect(error.exists()).toBe(true) + expect(error.text()).toContain('京麦未登录') + expect(w.find('.feedback.notice').exists()).toBe(false) + expect(w.findAllComponents(ElOption).length).toBe(0) + }) + + it('老客户端无同步桥:按钮置灰,全店采集不受影响', async () => { + const originalSync = api.syncCategories + api.syncCategories = undefined as unknown as typeof api.syncCategories + try { + const w = await mountPage(true) + await flushPromises() + + const syncBtn = w.find('.shop-cat-sync') + expect(syncBtn.exists()).toBe(true) + // 桥上没有 get_jd_shop_categories(老客户端/浏览器打开)⇒ 按钮置灰, + // 用户根本点不到(无桥提示 SYNC_UNAVAILABLE_NOTE 的形状由 jd-collect-tab 纯测试钉住) + expect(syncBtn.attributes('disabled')).toBeDefined() + expect(w.findAllComponents(ElOption).length).toBe(0) + // 全店采集主链路不依赖分类:建单双键空数组照常 + await startCollect(w) + expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [], [], []) + } finally { + // 覆写必须还原:hoisted 对象的 undefined 会穿过 beforeEach 的 mockReset 泄漏到后续用例 + api.syncCategories = originalSync + } + }) + + it('重同步换店:清掉不属于当前店铺的已选分类,防止跨店 id 误过滤', async () => { + api.syncCategories.mockResolvedValue(syncedResult()) + const w = await mountPage(true) + await syncCategories(w) + const select = w.findComponent(ElSelect) + await select.vm.$emit('update:modelValue', ['1024347567', '1024347572']) await flushPromises() - expect(block!.text()).toContain('只采选中 1 个分类的商品') - expect(block!.find('.shop-cat-clear').exists(), '选中后出「清空」').toBe(true) - await block!.find('.shop-cat-clear').trigger('click') - await flushPromises() - expect(block!.text()).toContain('默认全店采集') + + // 换了一家店:新分类集与旧店 id 无交集 ⇒ 旧已选项必须被清掉并告知 + api.syncCategories.mockResolvedValue(syncedResult({ + shopName: '另一家旗舰店', + categories: [ + { label: '男士上衣', value: '9900000001' }, + { label: '其他', value: '9900000002' }, + ], + })) + await syncCategories(w) + + expect(w.text()).toContain('清除了 2 个不属于当前店铺的已选项') + expect(w.findAllComponents(ElOption).length).toBe(2) + await startCollect(w) + const payload = api.enqueue.mock.calls[0][0] + // 跨店残留 id 不得进建单请求体(否则按另一家店的分类过滤,0 行命中) + expect(payload.data.shopCategoryIds).toEqual([]) + expect(payload.data.shopCategoryNames).toEqual([]) }) })