| AC-EL-LST-001 | 页框架·AppShell | 框架 | title=Listing,crumb=「型号上架 · 建任务 → 规格书 → 生成 → 审核 → 批准 → 上传(全部 SKU 一次走完)」 | AppShell 共享组件(AC-EL-SHELL 系列);page.tsx:477 逐字;品牌上下文来自顶栏 BrandContext(page.tsx:83) | e2e 路由可达 + title/crumb 逐字比对 | 生效 |
| AC-EL-LST-002 | 页级 tab 条(7 键) | 页签 | 顺序固定:任务 / 导出回流 / 资源(模板 / 文件 / A+) / 体检 / 📋 noon SKU 清单 / 🚀 noon 建品向导 / 🗂 noon 任务与 QC;点击切换,选中加 on 态 | Tab 类型 7 值数组 page.tsx:85,481;B2(2026-10-14) 新旧并轨——原 NoonListingTab 自带第二套 tab 栏提升进本页(page.tsx:84 注释);tab 不写 URL | 渲染数 tab 数=7 与顺序逐字;点击切换内容区 | 生效 |
| AC-EL-LST-003 | ?edit= 深链初始 tab | 路由 | URL 带 edit 参数时初始落在「🚀 noon 建品向导」tab,否则「任务」 | page.tsx:86-87 useState 惰性初始化读 location.search;配合 NoonListingTab 编辑态(LST-130) | 带/不带 ?edit= 各访问一次断言初始 tab | 生效 |
| AC-EL-LST-004 | 目录加载·/api/listing/meta | 数据源 | 页面挂载即取目录:platforms/marketplaces/categories/brands/model_numbers/templates 六段 | GET /api/listing/meta(page.tsx:115-117;listing.py:422-459);platforms/marketplaces/categories 来自全局库表,brands=tenant_brands is_active 且按员工品牌范围收敛(listing.py:440-443);model_numbers=sku_mapping 按品牌 DISTINCT coalesce(model_number,model_name,product_name)(listing.py:448-451);templates=listing_library 表按租户品牌过滤(listing.py:454-457) | 响应六键齐备;brands ⊆ tenant_brands;model_numbers 键=brands | 生效 |
| AC-EL-LST-005 | 任务列表加载·逐页取满 | 数据源 | 任务 tab 数据:page_size=100 起取,不足 min(total,1000) 则逐页 concat 至取满 | GET /api/listing/tasks(page.tsx:118-133;listing.py:667-698);型号分组视图依赖全量行(page.tsx:120 注释);失败保持旧值不toast(page.tsx:132);tasksTotal=接口 total | 构造 >100 行任务断言一次取满;total 与表头计数一致 | 生效 |
| AC-EL-LST-006 | 型号上架卡头 | 标题 | h2「型号上架」+ sub「第 0 步建任务 → 规格书 → 生成 → 审核 → 批准 → 上传 · 全部 SKU 一次走完(title/五点/描述共用)」 | page.tsx:489 逐字 | 文案逐字比对 | 生效 |
| AC-EL-LST-007 | 品牌徽标 | 徽标 | 已选品牌=绿色 badge 显示品牌名;未选=红 badge「先在顶栏选品牌」 | 顶栏 BrandContext brand(page.tsx:83,491-492);2026-09-21 品牌继承顶栏——新建任务少一个下拉且不可能串品牌(page.tsx:83 注释);铁律:品牌绝对独立 | 切换顶栏品牌断言徽标随动;未选时创建按钮 disabled | 生效 |
| AC-EL-LST-008 | 型号下拉 | 下拉 | 占位「型号 model_number…」,选项=当前品牌的型号列表 | meta.model_numbers[brand](page.tsx:493-499);onChange 清空已选 SKU(page.tsx:495);SKU 列表随 selModel 自动加载(page.tsx:152-161,原写在 onChange 不触发「进入流程」的修复) | 选项与 meta 响应一致;改型号后 SKU 下拉复位 | 生效 |
| AC-EL-LST-009 | SKU 下拉 | 下拉 | 占位「SKU…」,选项文案=「{sku} · {color} · {size} · {country}」(空段省略);单 SKU 自动选中 | GET /api/listing/skus-by-model?brand=&model=(page.tsx:500-506,152-161;listing.py:462-480,sku_mapping 按 model_number/model_name/product_name 三匹配);恰 1 行时自动填 sku 与 market(page.tsx:157-158);onChange 选行带出 country→market(page.tsx:502) | 选项数=接口 items;单 SKU 型号断言自动选中 | 生效 |
| AC-EL-LST-010 | 平台下拉 | 下拉 | 占位「平台…」,选项=meta.platforms(platform+name) | page.tsx:507-510;onChange 清空 market;服务端二次校验平台开放与平台×站点组合(listing.py:623-626) | 选项与 platforms 表 active 行一致 | 生效 |
| AC-EL-LST-011 | 创建任务按钮 | 按钮 | 「创建任务」;必填缺失 toast「型号/SKU/平台必填」,未选品牌 toast「请先在顶栏选择品牌」;成功 toast「任务已创建」 | POST /api/listing/tasks(page.tsx:277-287;listing.py:608-664);服务端:品牌登记+产品存在+类目存在校验,产品×平台×站点唯一键冲突 409「该产品×平台×站点已有任务」(listing.py:646-647);Amazon 自动带出 listing_pt_suggest 建议 PT(listing.py:651-660);audit listing.task.create;事件 create | 重复提交同产品×平台×站点断言 409;audit_log 与 listing_events 各落一条 | 生效 |
| AC-EL-LST-012 | ⚡ 批量建任务按钮 | 按钮 | 「⚡ 批量建任务({modelSkus.length 或 …})」;confirm「为 {型号} 的 {N} 个 SKU 批量创建 {平台} 任务?」;完成 toast「批量创建完成:新增 X · 跳过已存在 Y · 失败 Z」 | 前端循环逐个 POST /api/listing/tasks(page.tsx:290-310);错误串含 409 或「已有任务」计 skip(page.tsx:303);title 提示「为该型号带出的全部 SKU 各建一个任务(已存在的自动跳过)」(page.tsx:513);disabled=busy 或未选品牌或 SKU 列表空 | 对含已存在 SKU 的型号执行,断言 skip 计数与 409 数一致 | 生效 |
| AC-EL-LST-013 | 高级选项折叠 | 折叠 | summary「高级选项(站点 / 类目 / 关键词,一般不用改)」 | <details> 原生折叠 page.tsx:515-529 | 默认收起;点击展开三控件 | 生效 |
| AC-EL-LST-014 | 站点下拉(高级) | 下拉 | 占位「默认(SKU 国家)」,选项=所选平台的 marketplaces.countries | mks=meta.marketplaces.filter(platform=nu.platform)(page.tsx:461,518-521) | 换平台断言站点选项集随动 | 生效 |
| AC-EL-LST-015 | 类目下拉(高级) | 下拉 | 占位「默认类目」,选项=meta.categories(显示 name) | page.tsx:522-525;不选时后端取产品当前类目否则 general(listing.py:635) | 选项与 product_categories 全集一致 | 生效 |
| AC-EL-LST-016 | 关键词输入(高级) | 输入 | placeholder「关键词(逗号分隔, 标题用)」,宽度 240 | nu.keywords page.tsx:526-527;TaskIn.keywords max_length=200(listing.py:605);生成时取前 4 个非空词作 K1/K2 等模板词(listing.py:316,339) | 超 200 字提交断言 422 | 生效 |
| AC-EL-LST-017 | 未选型号引导提示 | 提示 | 「选好型号并建任务后,下面 6 步走完整个型号的上架(不用一个 SKU 一个 SKU 弄)。」 | 显示条件 !selModel 或 modelSkus 空(page.tsx:530-531);选中后替换为流程区 | 两种前置态各断言互斥渲染 | 生效 |
| AC-EL-LST-018 | 型号摘要条 | 状态行 | badge 型号 + 「{N} 个 SKU · 任务 {M} 条(已生成 {X} · 就绪 {Y} · 已上传 {Z})」;执行中显示 badge warn「执行中…」 | flowTasks=GET /api/listing/tasks?page_size=100&q={型号}&brand={品牌}[&platform=](page.tsx:145-149;q 匹配 sku/title/product_title/model_number ILIKE,listing.py:674-675);已生成=title 非空数;就绪=status=ready 数;已上传∈{submitted,imported,exported}(page.tsx:537-540) | 四计数与接口行逐项复算一致 | 生效 |
| AC-EL-LST-019 | 流程①·规格书上传(型号级) | 按钮+隐文件 | 文案「上传规格书(一次,自动同步全部 SKU):」+ 按钮「选择文件上传」;hidden input accept=.docx,.pdf,.xlsx,.txt,.csv | POST /api/listing/models/spec FormData(brand,model,file)(page.tsx:543-547,237-252;listing.py:555-581):同一 parsed_kv 落到该型号全部 SKU 的 listing_specs 行;成功 toast「规格书已同步到 {N} 个 SKU(解析 {M} 条键值)」;文件≤10MB(listing.py:135,487);支持类型 docx/pdf/xlsx/txt,.doc 400「旧版 .doc 请先另存为 .docx 再上传」(listing.py:179-192);kv 行级解析冒号/竖线/tab 二段式+单位尾缀(listing.py:210-228) | xlsx 上传后断言该型号每 SKU 均落 listing_specs 行且 parsed_kv 相同 | 生效 |
| AC-EL-LST-020 | AI 抽取兜底(规格书) | 口径 | 规则命中 <8 条且原文 >200 字时 LLM 补键值对(每条带 ai:true 标记,最多 20 条) | LISTING_AI 开关(env,默认开,listing.py:42);_ai_kv_extract(listing.py:74-86);AI 用量计数 rds aiusage:{date} slug 维 hincrby(listing.py:104-108);任一失败静默回退纯规则 | 短规则文本样例断言 ai_added>0 或正常回退;aiusage 键递增 | 生效 |
| AC-EL-LST-021 | 流程②·生成全部按钮 | 按钮 | 「生成全部」;toast「模板任务已生成(LLM 约10~60s), 正在同步到其余 SKU…」;全部 ready 时先 toast「任务全部为就绪态,已自动撤回模板任务以便重新生成」 | page.tsx:220-235,548-550:POST /api/listing/tasks/{id}/generate?ai=1(模板任务=首条有 title 否则首条);生成接口仅收 draft/failed,全 ready 自动先 revert 首条(page.tsx:225-230);随后 batch generate_sync | 全 ready 型号点生成断言先产生 revert 事件再 generate 事件 | 生效 |
| AC-EL-LST-022 | 生成端点·规则+AI 双引擎 | 口径 | 规则引擎确定性打底(同义词映射+模板渲染);AI 增强做属性映射与标题/五点,失败回退规则结果 | POST generate ai=1(listing.py:732-837):规则 _generate_content(312-361,同义词表 _SYN 234-262,模板 _pick_template 精确优先通配 287-298);AI 属性映射防幻觉三重校验=映射数>2×kv 整批丢弃/值引用字段名单条拒绝/含竖线「|」的多段拼接拒绝(listing.py:779-794);AI 标题 20~200 字才采纳、五点 3~6 条取前 5(listing.py:804-813);gen_meta.engine=rules-v1 或 rules-v1+ai-v1;attrs 统一过 _clean_attrs 防幻觉清洗(listing.py:116-132,817);version+1 | gen_meta.ai 三标记与实际 LLM 采纳一致;脏 attrs(含字段名清单值)写入被拒 | 生效 |
| AC-EL-LST-023 | 流程③·审核编辑器加载 | 数据源 | 编辑器摊开模板任务全部字段(用户要求不收起);version 变化即刷新 | GET /api/listing/tasks/{id}(page.tsx:170-179;listing.py:701-729:task+product+schema+spec+events LIMIT 10);bullets 补空串至 5 条 slice(0,5)(page.tsx:174);flowSnap 记 attrs 快照供保存前比对;useEffect 依赖 [flowTplId, flowTplVer]——生成/同步/他处保存后自动刷新(page.tsx:179) | 他处保存同任务后本编辑器字段自动更新 | 生效 |
| AC-EL-LST-024 | 流程③·标题编辑 | 文本域 | label「标题 {n}/200」;textarea rows=2 maxLength=200 | page.tsx:554-558;TITLE_MAX=200(listing.py:136) | 计数=n/200 实时;粘贴超长截断 | 生效 |
| AC-EL-LST-025 | 流程③·五点编辑 | 输入组 | label「五点描述(≥3 条)」;5 行编号输入 maxLength=500 | page.tsx:559-568;BULLET_MAX=500/BULLET_MIN=3(listing.py:137-138);保存时空行被滤除(page.tsx:195) | 5 行恒渲染;空行不入库 | 生效 |
| AC-EL-LST-026 | 流程③·长描述与关键词 | 文本域+输入 | 「长描述」textarea rows=4 maxLength=5000;「关键词」input | page.tsx:569-579;description 上限 5000(listing.py:843) | 超长截断与计数一致 | 生效 |
| AC-EL-LST-027 | 流程③·必填参数网格 | 表单 | 「必填参数({N} 个,有未填|已填齐)」;未填项 label 变红 | flowSchema 过滤 required 且排除 DEDICATED 7 专用键 item_name/product_description/brand_name/bullet_point1-5(page.tsx:582-584,607-612);「有未填/已填齐」由任一必填空判定(page.tsx:610) | schema required 集与网格行集一致(扣除 7 键) | 生效 |
| AC-EL-LST-028 | 流程③·可选参数网格 | 表单 | 「可选参数({N} 个,按需补充)」 | 非 required 且非 DEDICATED(page.tsx:613-614) | 计数=总属性-必填-7 | 生效 |
| AC-EL-LST-029 | 参数单元格控件 | 控件 | label={label}{必填*}{(unit)};type=select 或有 enum→下拉(空选项+枚举/选项),否则文本 input | page.tsx:587-606;enum 优先 options(page.tsx:598) | 枚举字段渲染下拉且取值∈枚举 | 生效 |
| AC-EL-LST-030 | 💾 保存并注入全部 SKU 按钮 | 按钮 | 「💾 保存并注入全部 SKU」;防过期覆盖:服务器 attrs 与快照不一致时拒绝保存并 toast「服务器上的参数已更新,编辑器已刷新为最新内容,请确认后再保存」 | flowSave(page.tsx:181-200):先 GET 比对 flowSnap→PUT /api/listing/tasks/{id}→batch generate_sync;PUT 端点 draft/failed/ready 可编、已推送四态 409(listing.py:848-887);attrs key 必须在类目 schema 内否则 400(listing.py:874-876);bullets 截 5 条、各值截 500;version 随变更递增;audit listing.edit;事件 edit | 并发他处保存后本侧保存断言被拦且编辑器刷新;schema 外 key 断言 400 | 生效 |
| AC-EL-LST-031 | 流程③加载中占位 | 占位 | 编辑器未就绪且模板存在时显示「加载中…」 | !flowForm && flowTpl(page.tsx:623) | 慢网断言占位出现后替换 | 生效 |
| AC-EL-LST-032 | 流程④·批量批准按钮 | 按钮 | 文案「全部批准就绪(质量门逐条校验):」+「批量批准」 | batch("approve")(page.tsx:624-626)→ POST /api/listing/tasks/batch action=approve(listing.py:1372-1514,1439-1466 段):逐条质量门同单批口径(标题/五点≥3/必填缺失,derived 豁免 item_name/product_description,listing.py:1453);非 draft 记 skip;audit listing.batch.approve | 混合状态批次断言 ok+skip 分桶正确 | 生效 |
| AC-EL-LST-033 | 流程⑤·类目绑定行 | 控件组 | 仅当首任务未绑 PT 时内联显示:站点下拉(占位「站点」)+ 品名输入(占位「品名(英文)」)+「搜类目」按钮 | 显示条件 flowTasks[0] 无 product_type(page.tsx:628-651);ptMarkets=GET /api/listing/pt-markets?brand=(page.tsx:162-165;listing.py:1137-1143,品牌校验 _brand_ok);搜类目 disabled=未选站点或词<3 字符 | 已绑 PT 型号断言整组不渲染 | 生效 |
| AC-EL-LST-034 | 搜类目·pt-search 回退 | 口径 | toast「搜到 {N} 个类目」或「搜到 0 个类目(换个品名试试,如 bras / shirt)」 | GET /api/listing/pt-search?brand=&market=&q=(page.tsx:357-379;listing.py:1146-1165);词<3 服务端 400;前端复数回退 bra→bras、去尾 s 回退(page.tsx:365-374);SP-API Product Type Definitions,redis 缓存 24h(listing.py:1155-1164) | 单数词命中复数回退路径断言二次请求发起 | 生效 |
| AC-EL-LST-035 | 类目选择+绑定到全部 | 下拉+按钮 | 命中后追加:类目下拉(占位「选类目…」,文案 display_name (name))+「绑定到全部({N})」按钮 | batch("bind_pt")(page.tsx:641-647)→ POST batch action=bind_pt(listing.py:1491-1503):需 product_type+market,逐任务 UPDATE product_type/market(market 归一大写);事件 bind_pt batch=true;audit listing.batch.bind_pt;元数据缓存按 brand+market+PT 共用(listing.py:1492 注释) | 绑定后全部任务 product_type/market 落库且事件齐 | 生效 |
| AC-EL-LST-036 | 批量预检按钮 | 按钮 | 「批量预检」;首任务未绑 PT 时 disabled | batch("submit", true)(page.tsx:653-654)→ batch action=submit dry_run(listing.py:1467-1490):noon 走 _submit_noon(dry)、amazon 走 _submit_amazon(dry);不真推平台 | dry 结果 ok[].note 含「预检载荷N字段」 | 生效 |
| AC-EL-LST-037 | 🚀 批量提交推送按钮 | 按钮 | confirm「确认把 {N} 个任务批量推送到平台?」;真推间隔 0.2s 防限速 | batch("submit", false)(page.tsx:206,655-656);listing.py:1489-1490 time.sleep(0.2);单任务异常入 fail 桶不中断批次(listing.py:1485-1488) | 批次推送事件时间间隔≥0.2s;单失败不断批 | 生效 |
| AC-EL-LST-038 | 批量结果 toast | 反馈 | 「{预检|操作}完成: 成功 {ok} · 跳过 {skip} · 未通过 {fail}(如: {首条失败原因})」;有失败为 err 态 | page.tsx:209-215;fail 首条 note 透出 | 构造一缺必填批次断言三桶计数 | 生效 |
| AC-EL-LST-039 | 批量端点护栏 | 护栏 | 批量操作统一 owner/admin 门 + ids 1~200 上限 + 结果三桶 {ok,skip,fail} | _require_admin(listing.py:1378);ids 校验(listing.py:1380-1381);action 白名单 generate_sync/approve/submit/revert/bind_pt(listing.py:1382-1383);任务不存在入 fail「不存在」;audit 各分支;铁律:tenant_conn+brand_scope 全程租户隔离(listing.py:1385) | 非 admin 调用断言 403;201 ids 断言 400 | 生效 |
| AC-EL-LST-040 | generate_sync 智能覆盖口径 | 口径 | 模板 title/五点/描述/关键词整体下发;attrs 分两种:各 SKU 值一致=共用参数随模板覆盖(支持人工修正下发),值各异=SKU 差异参数只补空保留自身 | listing.py:1408-1437;sibling_vals 判定(1413-1418):其余任务该 key 非空值集合 ≤1 视共用;gen_meta.copied_from=模板 id;version+1;已推送四态 skip「已推送」;无任何已生成任务 400「所选任务中无已生成内容…」;事件 generate copy_from;audit listing.batch.sync | 尺码各异型号同步后断言尺码保留、共用字段被覆盖 | 生效 |
| AC-EL-LST-041 | 上传流程条 | 步骤条 | amazon 4 步「生成内容/绑定亚马逊类目/批准就绪/预检提交」,noon 3 步「生成内容/批准就绪/提交 Noon」;完成步 ✓ 绿、当前步黄加粗、未到灰 | 状态机 page.tsx:669-675:cur 由 title/product_type/status 推导;done∈{submitting,submitted,imported,exported} 全步 ✓ | draft/ready/imported 三任务断言步骤着色 | 生效 |
| AC-EL-LST-042 | 下一步主按钮 | 按钮 | 随状态机切换:draft 未生成=「⚙ 规则生成 →」→ amazon 未绑 PT=「🔍 按品名自动搜类目 →」→「✓ 批准就绪 →」→「🔍 预检(不推送) →」;done 后不渲染 | page.tsx:681-685,705;autoBind 取 product_name(空则 product.title)首词、兜底 SKU 填 ptQ 并搜索(page.tsx:676-680) | 四状态各断言按钮文案与动作 | 生效 |
| AC-EL-LST-043 | 流程完成徽标 | 徽标 | done 后显示绿 badge「流程完成[ · ASIN {asin}]」 | page.tsx:703 | imported 任务断言徽标与 ASIN | 生效 |
| AC-EL-LST-044 | 任务详情头卡 | 卡头 | 「{brand} · {sku}」+ 灰字「{platform} · {market} · {category} · v{version}」+ 状态 badge | openTask 经「编辑内容 →」触发(page.tsx:254-274):GET 详情→setTab(tasks)→150ms 后滚动至详情锚点;2026-09-21 tab 收纳 6→3 详情内联任务 tab(page.tsx:269 注释) | 点列表「编辑内容」断言滚动定位与字段渲染 | 生效 |
| AC-EL-LST-045 | 任务状态中文/色调单源 | 口径 | 7 状态:draft 草稿(无色) / ready 待提交(ok) / exported 已导出(ok) / submitted 已提交(warn) / submitting 提交中(warn) / imported 已建品(ok) / failed 失败(bad) | lib/listingStatus.ts LISTING_STATUS_LABEL/LISTING_TONE(page.tsx:37-39 引入;UI-05 2026-10-14 单源化,此前 page.tsx 与 NoonListingTab 两套各自为政);语义按 listing.py 状态机 | 两 tab 同 status 显示同中文同色 | 生效 |
| AC-EL-LST-046 | ⚙ 规则生成按钮(详情头) | 按钮 | toast「已生成: {title 前 40}…」;ready 态点击被服务端 409 拒 | POST /api/listing/tasks/{id}/generate(默认 ai=1)(page.tsx:312-321;listing.py:732-837);409 文案「状态 {status} 不可生成(ready 请先撤回)」(listing.py:739-740) | ready 任务直点断言 409 toast | 生效 |
| AC-EL-LST-047 | ✓ 批准(ready) 按钮 | 按钮 | 仅 draft 显示;toast「已批准 → ready」 | POST approve(page.tsx:718,343-348;listing.py:890-923):_require_admin;质量门=标题非空且≤200+五点≥3+必填属性齐(derived 豁免 item_name/product_description,listing.py:911);不合格 400 分号拼接问题清单;落 approved_by/approved_at;audit listing.approve | 缺必填断言 400 且列出缺失 label;通过断言 status=ready | 生效 |
| AC-EL-LST-048 | ↩ 撤回按钮 | 按钮 | 仅 ready 显示;toast「已撤回 → draft」 | POST revert(page.tsx:719,349-354;listing.py:926-938):_require_admin;仅 ready 409 其它;清 approved_by/approved_at;audit listing.revert | 撤回后编辑器可改、批准按钮重现 | 生效 |
| AC-EL-LST-049 | 保存修改按钮(详情头) | 按钮 | toast「已保存 · 已自动注入同型号 {N} 个任务」;同步失败不阻塞保存(静默) | PUT 后自动 batch generate_sync 以本任务为模板(page.tsx:323-341,注释「编辑一次直接注入就好了」);det 任务的型号组=flowTasks | 保存后同型号任务 title 一致、version+1 | 生效 |
| AC-EL-LST-050 | 编辑锁提示 | 提示 | 非 draft/failed 状态显示「当前状态 {label},编辑需先撤回(ready)或等待回流处理」 | page.tsx:722-723;服务端锁=已推送四态 409(listing.py:855-856) | exported 任务保存断言 409 | 生效 |
| AC-EL-LST-051 | 详情·标题卡 | 卡 | h2「标题」sub「{n}/200」;textarea + 关键词 input(placeholder「关键词(逗号分隔)」) | page.tsx:729-735 | 编辑即时计数;关键词随保存提交 | 生效 |
| AC-EL-LST-052 | 生成引擎说明行 | 口径行 | 「生成引擎: {engine|rules-v1} · {纯规则|AI映射 {n} 项 + AI标题 + AI五点} · 已填属性: {keys 逗号|无}」 | gen_meta.engine/ai/filled_attrs(page.tsx:736-748;listing.py:358-361,818-822) | 纯规则任务断言「纯规则」;AI 任务断言标记组合 | 生效 |
| AC-EL-LST-053 | 详情·五点描述卡 | 卡 | h2「五点描述」sub「≥3 条 · 批准门校验」;5 行编号输入 | page.tsx:751-759;与 LST-025 同限值(BULLET_MIN=3) | 文案与批准门一致 | 生效 |
| AC-EL-LST-054 | 详情·长描述卡 | 卡 | h2「长描述」;textarea rows=8 maxLength=5000 | page.tsx:761-765 | 计数与截断一致 | 生效 |
| AC-EL-LST-055 | 详情·PT 绑定卡(amazon) | 卡 | 仅 amazon 任务渲染;已绑定=badge PT + 「@ {market} · 官方字段 {schema 数} 个(必填 {required 数})」;未绑定=「未绑定 — 用本地静态类目;绑定后可直推亚马逊」 | page.tsx:769-779;任务生效 schema=绑 PT→listing_category_meta 官方元数据,否则本地 product_categories(listing.py:1118-1128 _task_schema 期2b 全链统一) | 绑/未绑两任务断言文案与字段数 | 生效 |
| AC-EL-LST-056 | 详情·PT 绑定控件行 | 控件组 | 仅 draft/failed 显示:站点下拉/品名输入(placeholder「品名搜官方类目(英文)」,Enter 触发搜索)/「搜索类目」按钮/类目下拉/「绑定」按钮 | bindPt→POST /api/listing/tasks/{id}/bind-pt {product_type,market}(page.tsx:380-389,780-802;listing.py:1210-1243):仅 draft/failed 可绑;market 必填(缺=400);拉官方 schema 落 listing_category_meta 缓存 7 天;畸形 schema 422 不绑定(listing.py:1228-1229);toast「已绑定 {pt} · 官方字段 {N} 个」;audit listing.bind-pt | 绑定后属性编辑器切换官方字段集 | 生效 |
| AC-EL-LST-057 | 提交到亚马逊卡 | 卡 | 仅 amazon+ready 显示;h2 sub「步骤⑨⑩⑪ SP-API putListingsItem · PT {pt}@{market} 或 未绑PT(不可提交)」;「🔍 预检(不推送)」「🚀 提交推送」未绑 PT 均 disabled | doSubmit→POST /api/listing/tasks/{id}/submit?dry_run=(page.tsx:390-409,805-811;listing.py:1272-1284→_submit_amazon 1287-1358):需 ready+PT+类目元数据缓存;dry 返回 payload_keys/missing_required;真推缺必填 422 | 未绑 PT 断言双按钮 disabled;dry 后预览面板出现 | 生效 |
| AC-EL-LST-058 | 预检结果面板(amazon) | 面板 | 「缺失必填属性 {N} 项: {清单}」缺失红/「 ✅ 可提交」绿;「载荷字段 {N} 个: {前 14}…」 | submitPreview 状态(page.tsx:113,812-822);toast「预检完成: 载荷 {N} 字段, 缺必填 {M} 项」(page.tsx:401) | 缺项数与 missing_required 数组一致 | 生效 |
| AC-EL-LST-059 | ASIN 行与提交结果 JSON | 展示 | 「ASIN: {asin}」加粗;submit_result 以 pre 呈现 JSON.stringify 缩进 1,截 900 字 | page.tsx:824-829;submit_result 服务端存 result/issues 前 20/submission_id(listing.py:1331-1335)或错误 hint(listing.py:1354-1355) | 面板字符数≤900;结构与库内 submit_result 一致 | 生效 |
| AC-EL-LST-060 | Amazon 推送结果与 403 指引 | 口径 | 成功 toast「✅ 推送成功 · ASIN {asin}」;失败「推送返回 {status} · {N} 个错误」;403 时错误文案为中文 Seller Central 重新授权指引 | doSubmit(page.tsx:403-405);listing.py:1316-1344:put_listing→issues 取 ERROR 级→get_listing 回读 ASIN→status imported/failed;403/Unauthorized 中文指引(listing.py:1346-1351);ASIN 回写 _cascade_asin_to_mapping:sku_mapping 补空 asin + keepa_watch ON CONFLICT 入池(listing.py:45-72,1336-1339);提交前置 status=submitting | 成功推后 sku_mapping.asin 与 keepa_watch 各落一行;403 mock 断言指引全文 | 生效 |
| AC-EL-LST-061 | 提交确认弹窗(单任务) | 护栏 | confirm「确认推送 {brand}/{sku} 到{Noon|亚马逊} {market}?」;取消不请求 | doSubmit 非 dry 分支(page.tsx:392-393);平台名按 platform 映射 | 取消断言无网络请求 | 生效 |
| AC-EL-LST-062 | 提交到 Noon 卡 | 卡 | 仅 noon+ready 显示;h2 sub「Content API /content/v1/product/upsert · 同步建品 · 预检为 dry 校验」;「🔍 预检(不推送)」「🚀 提交推送」(无 PT 要求) | page.tsx:832-838,396-408→_submit_noon(listing.py:1659-1725):实际通道=Content API /content/v1/product/upsert 同步建品(listing.py:1692),旧 impex 通道已废弃(listing.py:1517-1521 注释)——sub 文案与实现不符的待修缺陷已修:2026-10-22 用户令全修,sub 改标实际通道 Content API upsert(现 page.tsx:834),web 重建上线(编译产物 Impex 引用清零,noon 页 Impex=官方报表族名合法保留),frontend_e2e 门禁 ALL PASS | 代码走查 sub 文案 vs listing.py:1692 upsert;e2e 断言实际请求域名/路径为 content/v1/product/upsert | 生效 |
| AC-EL-LST-063 | Noon 预检 csv_preview | 面板 | submitPreview 呈现 csv_preview pre(muted 11px 滚动) | 原 page.tsx:839-844 死分支已删(2026-10-22 用户令全修):submitPreview 的 csv_preview pre 连同类型字段整体移除,dry 结果本就经 toast「预检完成: 载荷 N 字段, 缺必填 M 项」与缺失必填面板(page.tsx:812-821)透出,无信息损失;编译产物 csv_preview 零残留,frontend_e2e 门禁 ALL PASS | dry 响应键集断言无 csv_preview(已删分支,编译产物零残留) | 生效 |
| AC-EL-LST-064 | NSKU 行(Noon 详情) | 展示 | 「NSKU: {值}」;值取 det.task.asin 字段 | page.tsx:846;noon 通道服务端把 variants[0].sku 写入 listing_tasks.asin 列(listing.py:1703-1705 UPDATE asin=nsku)——字段名 asin 承载 NSKU,展示标签正确 | noon imported 任务断言 asin 列=NSKU 且展示为 NSKU | 生效 |
| AC-EL-LST-065 | 详情·类目属性卡 | 卡 | h2 sub:绑 PT=「官方 PT 字段 · {pt}」,未绑=「{类目显示名} · * 必填」;逐属性行 label{*=必填}{(unit)}+select/input | page.tsx:849-871;schema=详情接口 schema 段(PT 官方或本地,LST-055 口径);required 未填 label 变红(page.tsx:853-856) | 绑 PT 前后字段集切换比对 | 生效 |
| AC-EL-LST-066 | 类目属性空态 | 空态 | schema 为空显示「该类目无属性定义」 | page.tsx:851 | 空 schema 类目断言文案 | 生效 |
| AC-EL-LST-067 | ① 规格书卡(单 SKU) | 卡 | h2「① 规格书」sub「docx / pdf / xlsx / txt」;file input(无 accept 限制)+「上传解析」按钮;toast「规格书已解析: {N} 条键值」 | POST /api/listing/specs FormData(file,brand,sku)(page.tsx:411-425,873-877;listing.py:509-552):产品须存在否则 404「先在 品牌接入 导入 SKU」;解析同 LST-019 口径;audit listing.spec | 上传 docx 断言 listing_specs 落行+kv_count toast | 生效 |
| AC-EL-LST-068 | 规格书已上传块 | 展示 | 「{filename} {file_type} · {N} 条键值」+ 键值表(项/值 两列,前 40 行,值带单位) | det.spec=该产品最新一条 listing_specs(listing.py:716-721);parsed 截 40 行渲染(page.tsx:879-893) | 行数=min(40, parsed 长度) | 生效 |
| AC-EL-LST-069 | 展开/收起原文 | 按钮 | toggle 文案「展开原文/收起原文」;raw_preview pre 展示 | raw_preview=raw_text 前 2000 字(listing.py:721;page.tsx:894-900) | pre 字符数≤2000 | 生效 |
| AC-EL-LST-070 | 规格书未上传提示 | 空态 | 「未上传。规格书键值会在「规则生成」时自动匹配到类目属性(同义词表 + 包含匹配)。」 | page.tsx:902-905;匹配=_match_attr 同义词精确→双向包含(listing.py:269-284) | 文案逐字;生成后必填命中可复算 | 生效 |
| AC-EL-LST-071 | 操作轨迹卡 | 审计 | 每条=时间(截 16 字 T→空格)+action 加粗+detail JSON 省略;空态「暂无」;sub「只追加审计」 | 详情接口 events=listing_events 该任务最近 10 条倒序(listing.py:722-723 LIMIT 10);listing_events 只追加——触发器拦截 UPDATE/DELETE(listing.py:7 模块 docstring);detail 截 4000 字(listing.py:402) | UPDATE listing_events 断言被触发器拒;页面至多 10 条 | 生效 |
| AC-EL-LST-072 | 任务列表卡头计数 | 标题 | 「任务列表」sub「{N} 条」+ 超出时「 · 共 {M} 条(首 1000)」 | page.tsx:925-926;N=已取回行数,M=tasksTotal;上限 1000(LST-005) | >1000 任务断言两数同显 | 生效 |
| AC-EL-LST-073 | 任务筛选·状态 | 下拉 | 占位「全部状态」,选项=7 状态中文(LISTING_STATUS_LABEL) | page.tsx:928-931;筛选变化即触发 loadTasks(useEffect 依赖 f) | 选项与状态单源一致 | 生效 |
| AC-EL-LST-074 | 任务筛选·平台/品牌 | 下拉 | 平台=全部平台/amazon/noon;品牌=全部品牌+meta.brands | page.tsx:932-939 | 选项集与 meta 一致 | 生效 |
| AC-EL-LST-075 | 任务筛选·搜索框 | 输入 | placeholder「搜索 型号/SKU/标题」 | f.q → 服务端 ILIKE 四字段:sku/title/product_title/model_number(page.tsx:940;listing.py:674-675) | 型号词命中该型号全部行 | 生效 |
| AC-EL-LST-076 | 任务表头 | 表头 | 7 列:型号 / 平台/站点 / SKU 数 / 内容进度 / 上传进度 / 最近更新 / 空 | page.tsx:944 | 列序逐字 | 生效 |
| AC-EL-LST-077 | 型号分组口径 | 口径 | 行=型号×平台×站点分组;model=model_number 空则回退 sku;组内行=各 SKU 任务 | 分组键 brand|model|platform|market(page.tsx:463-472);显示=「{model} {brand}」 | 分组数=四元组去重数 | 生效 |
| AC-EL-LST-078 | 内容进度条 | 进度 | 条宽=已生成/总数百分比(品牌色填充)+ 文案「内容 {gen}/{total}」 | page.tsx:1055-1061;gen=title 非空数(page.tsx:1045) | 宽度%与比值一致 | 生效 |
| AC-EL-LST-079 | 上传进度条+待推送徽标 | 进度 | 条宽=已上传/总数(ok 色)+「已上传 {done}/{total}」;ready>0 加 badge warn「待推送 {ready}」 | done∈{submitting,submitted,imported,exported}(page.tsx:1044,1063-1071);ready=status=ready 计数 | 三计数复算一致 | 生效 |
| AC-EL-LST-080 | 最近更新列 | 列 | 组内最新 updated_at(截 16 字) | page.tsx:1048,1072 | =组内 max(updated_at) | 生效 |
| AC-EL-LST-081 | 进入流程 ↑ 按钮 | 按钮 | stopPropagation;带入品牌/型号/平台至顶部流程(顶栏未选品牌时 SKU 加载被空值守卫拦——先 setBrand)并平滑滚顶 | onOpenFlow(page.tsx:947-951,1074-1075);market 清空;60ms 后 scrollTo top | 点击后顶栏品牌=组品牌、型号下拉=组型号 | 生效 |
| AC-EL-LST-082 | SKU 明细/收起按钮与行展开 | 交互 | 分组行点击或按钮切换展开;展开行背景 bg,行首缩进显示「{model} / {sku}」 | page.tsx:1051,1076-1077,1080-1081 | 行点击与按钮均触发开合 | 生效 |
| AC-EL-LST-083 | 明细行内容 | 行 | SKU+ASIN/NSKU 绿 badge(有则);状态 badge+「v{version}」;title 空显示灰「未生成」;「编辑内容 →」按钮 | page.tsx:1082-1086;asin 有显 ASIN 否则 nsku 显 NSKU | 两平台任务各断言 badge 形态 | 生效 |
| AC-EL-LST-084 | 任务列表空态 | 空态 | 「暂无任务,先在上方选型号并建任务」colSpan=7 居中 | page.tsx:953 | 无任务断言文案与跨列 | 生效 |
| AC-EL-LST-085 | ④ 导出 CSV 卡头 | 标题 | 「④ 导出 CSV」sub「仅 ready 任务 · UTF-8 BOM · Excel 直开」 | page.tsx:963-964;BOM=EF BB BF 前缀(listing.py:1026);行尾 CRLF(listing.py:1013) | 下载文件头三字节 BOM 断言 | 生效 |
| AC-EL-LST-086 | 导出平台下拉 | 下拉 | 占位「按平台导出全部 ready」+ amazon/noon;切换清空勾选 | page.tsx:966-969 | 切换后勾选数=0 | 生效 |
| AC-EL-LST-087 | 下载 CSV 按钮 | 按钮 | 勾选与平台二选一(都空 toast「勾选任务或选平台」);成功 toast「CSV 已下载」并清勾选刷新 | GET /api/listing/export?ids= 或 platform=(page.tsx:427-444;listing.py:959-1029 _require_admin):ids 模式状态须 ready/exported 否则 409;跨平台混导 400;文件名 listing_{平台}_{YYYY-MM-DD}.csv(content-disposition,前端 fallback listing.csv,page.tsx:437);导出行置 exported+事件 export;列集=平台基础列+各任务类目 schema attr 列并集保序(listing.py:366-374,1004-1011);noon 基础列 sku/item_number/name_en/brand/bullet_points/description/item_type,amazon 含 bullet_point1-5 | 表头与列集口径一致;导出后任务状态=exported | 生效 |
| AC-EL-LST-088 | 导出范围提示 | 提示 | 三态文案:选平台=「将导出该平台全部 ready」;有勾选=「已勾选 {N} 条」;否则「或在下方勾选」 | page.tsx:971-973 | 三前置态文案断言 | 生效 |
| AC-EL-LST-089 | 导出勾选表 | 表 | 5 列:勾选框 / 品牌+SKU / 平台·站点 / 标题(省略)/ 状态 badge;行集=ready ∪ exported | readyTasks.concat(tasks.filter(exported))(page.tsx:979-990)——exported 行可再次勾选导出(重复导出允许) | 行集与任务集差集为空 | 生效 |
| AC-EL-LST-090 | 导出表空态 | 空态 | 「暂无 ready/exported 任务」colSpan=5 | 显示条件=tasks.length===0(page.tsx:991)——任务全空才显;有任务但无 ready 时表格仅无行(边界如实记录) | 两前置态分别断言 | 生效 |
| AC-EL-LST-091 | ⑤ 结果回流卡 | 卡 | sub「平台回执 CSV: sku[,status][,asin][,message]」;平台下拉(「不限平台」+两平台,此处切换不清勾选)+ .csv 文件选择 +「上传回流」按钮 | POST /api/listing/import-results FormData(file[,platform])(page.tsx:446-459,996-1005;listing.py:1032-1090 _require_admin):文件≤10MB;sku 列名兼容 sku/item_sku/item_number;成功 toast「回流完成: 更新 {u}/{total} 行,跳过 {k}」 | 兼容列名三态各测一文件 | 生效 |
| AC-EL-LST-092 | 回流判定口径 | 口径 | 提示文案「成功行(status 空/success/ok/active) → 已回流;失败行 → 回流失败(点任务「编辑内容」可见原因,修复后可重新导出)。」 | 服务端成功值全集=空/success/ok/active/done/成功 六值(listing.py:1063)——页面提示列 4 值为子集(done/成功 未列,如实记录不判缺陷);任务定位=同 sku 最新 exported 优先(listing.py:1064-1067);前置状态须 exported/failed/imported 否则 skip「状态X」;成功→imported 失败→failed;ASIN 列回流写 asin 并触发 _cascade_asin_to_mapping(listing.py:1075-1084);事件 import_result 含 message 截 500 | done/成功 两值行断言仍 imported;skip 原因落 skipped 前 10 | 生效 |
| AC-EL-LST-093 | 体检 tab 加载态 | 状态 | 错误=「加载失败: {err}」;加载中=「加载中…」 | page.tsx:1100,1105-1106;GET /api/listing/health?brand={顶栏品牌}&limit=200(listing.py:1765-1893) | 断网/慢网两态呈现 | 生效 |
| AC-EL-LST-094 | 体检卡头 | 标题 | 「🩺 Listing 运营健康度体检」sub「9 维 · 零 LLM 规则评分 · nodata 不计分({note 动态})」 | page.tsx:1103-1104;note=接口原样(listing.py:1893) | sub 括号内=响应 note 逐字 | 生效 |
| AC-EL-LST-095 | 体检说明段 | 口径行 | 「共 {total} 个在架 SKU×ASIN(跟随顶栏品牌筛选)。评分=有数据维的均值(ok 100 / warn 60 / bad 20)。评分从低到高优先处理;灰点=无该维数据(不显示误导性 0)。悬停色点看明细,点击行展开。」 | page.tsx:1109-1112;总分=有数据维均值四舍五入,全 nodata=null(listing.py:1883-1886);排序低分在前、null 垫底(listing.py:1888) | 行序与分值复算一致 | 生效 |
| AC-EL-LST-096 | 体检表头 | 表头 | 「SKU / 名称」「总分」+9 维动态列(dims_meta 顺序):销量活跃/销量趋势/评分/评论规模/BSR 排名/库存风险/退货信号/价格稳定/内容覆盖 | page.tsx:1114-1121;dims_meta 逐字(listing.py:1890-1892);minWidth 760 横向滚动 | 列名 9+2 与 dims_meta 逐字 | 生效 |
| AC-EL-LST-097 | 体检 SKU 单元格 | 单元格 | SKU 加粗+名称灰小字+ASIN sku 小字两行 | page.tsx:1125-1126;行集=sku_mapping asin 非空行按品牌过滤 LIMIT 200(listing.py:1771-1773) | 行集与口径一致 | 生效 |
| AC-EL-LST-098 | 体检总分单元格 | 单元格 | null=灰「—」;≥80 绿 / ≥60 黄 / <60 红 加粗数字 | page.tsx:1127-1128 | 阈值三段着色断言 | 生效 |
| AC-EL-LST-099 | 体检维度色点 | 单元格 | 每维 badge:ok=✓ / warn=! / bad=✗ / nodata=—(dim 灰);title=「{status} · {note}」 | page.tsx:1129-1138;TONE 映射(page.tsx:1101) | 悬停 title 与接口 note 一致 | 生效 |
| AC-EL-LST-100 | 体检行展开明细 | 交互 | 点击行展开 colSpan=11 明细:每维「badge 中文名 + note 灰字」逐行列出;再点收起 | page.tsx:1124,1141-1154;colSpan=11 硬编码=9 维+2 固定列 | 展开行维数=9 | 生效 |
| AC-EL-LST-101 | 体检九维规则·销量类 | 口径 | ①销量活跃:无数据=nodata;0 件=bad;<10=warn;≥10=ok。②销量趋势:环比窗口不足=nodata;周环比≤-50%=bad、≤-20%=warn、其余 ok(近 7 天 vs 前 7 天) | listing.py:1776-1781(sales_daily 近 30 天聚合)、1813-1829;趋势分母 uprev7=0 视为不足(listing.py:1823) | 构造已知销量序列复算两维判定 | 生效 |
| AC-EL-LST-102 | 体检九维规则·排名类 | 口径 | ③评分:<3.5=bad、<4.0=warn、≥4.0=ok,无快照=nodata。④评论规模:<15=warn(冷启动)、≥15=ok。⑤BSR:>50000=warn、其余 ok | listing.py:1783-1786(rankings_daily ASIN 级最新快照 DISTINCT ON)、1830-1849 | 三阈值边界值各复算一例 | 生效 |
| AC-EL-LST-103 | 体检九维规则·库存/退货 | 口径 | ⑥库存风险(最差市场口径):断货=bad、低库存=warn、其余 ok,note=「{worst}(最短可售 {天数|?} 天)」。⑦退货信号:上月退货率>12%=bad、>8%=warn、≤8%=ok,分母=近 30 天销量,无数据=nodata | listing.py:1788-1795(inventory_health min(stock_days) 最差口径;amazon_refund_monthly 上月)、1850-1870 | 断货 SKU 断言 bad;退货率边界复算 | 生效 |
| AC-EL-LST-104 | 体检九维规则·价格/内容 | 口径 | ⑧价格稳定:仅 Keepa 关注池 ASIN,30 天 buybox 波动=(max-min)/avg>25%=warn 否则 ok,非关注池=nodata。⑨内容覆盖:aplus_docs 计数=0=nodata「未接入(扩展位)」,>0=ok「A+ 文档 {N} 份」 | listing.py:1797-1802(keepa_daily 近 30 天极差/均值;aplus_docs 全表计数)、1871-1882 | 非关注池断言 nodata 不计分 | 生效 |
| AC-EL-LST-105 | 资源 tab·区块标题 | 标题 | 三区:「📄 A+ 内容」「📁 文件」「模板库」+ 模板库尾注「静态 A+ 模板库(目录动态按本租户品牌生成,HTML 由 Caddy 直出)。生成文案请用上方「工作台 → 规则生成」。」 | page.tsx:1015-1027 | 三标题顺序与尾注逐字 | 生效 |
| AC-EL-LST-106 | 模板库分组卡 | 卡 | 每组一卡:h2={grp}+sub「{N} 套模板」;组=templates 按 brand::grp 归并;仅显示本租户已选品牌集合内的组 | TemplateLib(page.tsx:47-79):brands 取自子组件内 useBrand(BrandProvider 在 AppShell 内,根组件外读到空默认值——page.tsx:45-46 注释);目录源=meta.templates←listing_library 按租户品牌过滤(listing.py:454-457,D 类注册即级联 79 号种子) | brands.includes 过滤后组集与 listing_library 行集一致 | 生效 |
| AC-EL-LST-107 | 模板卡链接 | 链接 | 每模板一卡:标题+slug 灰字+badge「预览 ↗」;整卡链接 /listings/{slug}.html 新窗口打开 | page.tsx:62-73;target=_blank rel=noreferrer;tone 徽标色随库 tone 字段 | 链接可达(Caddy 直出 HTML 200) | 生效 |
| AC-EL-LST-108 | NoonListingTab 承载 | 组件挂载 | 页级 noon 三 tab(LST-002 后三键)渲染 NoonListingTab,sub=tab 去前缀,setSub 回写页级 tab | page.tsx:1029-1032;NoonListingTab.tsx:39-42;受控挂载(原常驻底部自带第二套 tab 栏已并轨,page.tsx:1029 注释) | 三 tab 切换页级高亮同步 | 生效 |
| AC-EL-LST-109 | noon 内层 sub-tab 条 | 页签 | 三键:「📋 SKU 清单」「🚀 建品向导」「🗂 任务与 QC」 | NoonListingTab.tsx:65-69 | 三键顺序逐字 | 生效 |
| AC-EL-LST-110 | noon SKU 清单卡 | 卡 | h2「noon SKU 清单」sub「在线状态 · Buy Box · 广告问题 · API key 自动拉取」;加载中/无数据两占位 | NoonListingTab.tsx:71-79;GET /api/noon/offers?limit=200(NoonListingTab.tsx:46-48;noon_data.py:119);失败静默置空 | 文案逐字;两占位互斥 | 生效 |
| AC-EL-LST-111 | noon 清单表 8 列 | 表 | Partner SKU / noon SKU(截 12 灰)/ 标题(截 45,悬停全文,空显 —)/ 价格(右对齐 2 位小数)/ 前台状态(在线 ok·不可见 bad badge)/ Buy Box(✓/✗)/ FBN(整数千分位)/ 问题(N 个 warn badge 或 —) | cols 定义 NoonListingTab.tsx:50-61;Partner SKU 列文本筛选;价格/FBN 可排序;exportCsv=noon_listings(NoonListingTab.tsx:75-77);DataTable 通用能力见 AC-EL-CMP | 8 列表头与渲染规则逐项;CSV 导出文件名 noon_listings | 生效 |
| AC-EL-LST-112 | noon 清单口径注 | 口径行 | 表脚 caliber:「数据源=noon-catalog offer/list · 前台状态=live_status · Buy Box=is_winning_buybox · 问题=offer_issues(blocking 原因)。」 | NoonListingTab.tsx:76-77 | 文案逐字 | 生效 |
| AC-EL-LST-113 | 向导①·基础信息卡 | 卡 | h2「① 基础信息」sub「SKU 须已存在于商品库(四维隔离同轴) · 保存为 noon 建品任务」;6 字段栅格 | NoonListingTab.tsx:241-271 | 文案逐字;6 字段齐 | 生效 |
| AC-EL-LST-114 | 向导·品牌/SKU/noon品牌/尺码/阿语标题/任务号 | 字段组 | 品牌下拉(默认第一个品牌);「SKU (partner_sku)」*(自动大写,编辑态锁死,placeholder「如 ZFT03WHX000ME」);「noon 品牌(展示名)」(默认品牌大写);「尺码/规格(可选)」(placeholder「如 Large / 42 / S」);「阿拉伯语标题(暂存, 单语言通道)」(rtl);「任务号」=#N 或「未保存」 | NoonListingTab.tsx:244-269;品牌源 /api/listing/meta brands(113-117);SKU 服务端校验产品存在(listing.py:1611-1615) | 小写输入断言自动大写;编辑态 SKU disabled | 生效 |
| AC-EL-LST-115 | 向导②·类目搜索框 | 输入 | placeholder「搜索类目, 如 headphone / kitchen / cable…」;输入防抖 350ms 后搜索 | NoonListingTab.tsx:123-133,276-278;GET /api/listing/noon/categories?q=&limit=12&brand=(listing.py:1567-1574:网关全量类目缓存 24h 服务端子串过滤,limit 夹 1~200);q 等于已选类目时不搜 | 连续输入仅 350ms 后一次请求 | 生效 |
| AC-EL-LST-116 | 向导②·类目下拉浮层 | 浮层 | 至多 12 条候选;悬停高亮;点击选中;点击页面任意处关闭;已选类目与词相同时不弹 | NoonListingTab.tsx:118-121,279-293;document click 关闭监听;sub 文案「网关真实类目 {N} 个 · 三段式 family-type-subtype」(274) | 外点关闭与 12 条上限 | 生效 |
| AC-EL-LST-117 | 向导②·已选类目行 | 状态行 | 「已选: {类目} · {N} 个属性(必填 {M})」或「 · 属性表单加载中…」 | NoonListingTab.tsx:295-301;属性源 GET /api/listing/noon/category-attrs?category=&brand=(141-148;listing.py:1577-1584:ListCategoryAttributes 按类目缓存 7 天);选新类目重置 attributes/dry/submit/qc 状态(135-139) | 换类目断言表单与三结果区复位 | 生效 |
| AC-EL-LST-118 | 向导③·动态属性表单 | 表单 | h2 sub「按网关 schema 动态生成 · 红*=必填 · 多值=每行一条 · 双语属性填英语」;必填项红 * 前缀;缺必填时底部红字「缺必填: {codes 顿号连接}」 | NoonListingTab.tsx:304-319;AttrDef=网关 schema(is_mandatory/attribute_type/options/min-max) | 必填标记与 schema is_mandatory 一致 | 生效 |
| AC-EL-LST-119 | 向导·属性控件五型 | 控件 | SELECT 单值=下拉(—空项+options);SELECT 多值=textarea「每行一条, 可选: 前 6 项」;NUMERIC/METRIC=number 输入(placeholder ≥min ≤max);BOOL=true/false 下拉;多值或 >200 字=textarea;默认 input(maxLength=max_characters) | AttrField(NoonListingTab.tsx:397-440);类型标注「单选/数字/布尔/文件URL/文本 · 多值 · 双语位 · ≤N字」(399-408) | 各类型字段各断言一控件形态 | 生效 |
| AC-EL-LST-120 | 向导④·图片卡 | 表单 | sub「至少 1 张 · sort 为展示顺序(0 起)」;每行=URL 输入(placeholder https://…/image.jpg)+sort 数字+44px 预览缩略(加载失败隐藏)+✕ 删除;「+ 加图片」追加(sort=当前行数) | NoonListingTab.tsx:321-335;保存过滤空 URL(195) | 坏 URL 缩略隐藏不断行 | 生效 |
| AC-EL-LST-121 | 向导⑤·提交工具条 | 按钮组 | 「💾 保存任务/💾 保存修改/保存中…」(必填品牌/SKU/类目,缺则 toast「品牌/SKU/类目必填」)→「🔍 Dry-run 预检」(需已保存)→「确认真实提交」checkbox(需预检结果才可用)→「⚠️ 提交建品」(需勾选确认)→「🗂 看任务列表」 | NoonListingTab.tsx:337-354;busy 互斥禁用;保存类型归一:多值→数组(按行拆)、NUMERIC/METRIC→Number(179-187);title_en 取 product_title 属性截 500(190-194) | 未预检勾选框 disabled;数字属性入参为 number 型 | 生效 |
| AC-EL-LST-122 | noon 任务保存端点 | 口径 | 保存=upsert:无 task_id 插入、有则归属校验后更新;标题+noon品牌+≥1 图齐备→ready,否则 draft;重复建 409「该产品已有 noon 任务(打开任务列表编辑)」 | POST /api/listing/noon/task(listing.py:1600-1656);noon 专有字段存 gen_meta(noon_category/noon_brand/title_ar/size/images);空值属性剔除;status 仅 draft/ready 可变其余保持;audit listing.noon.task.save | 已 imported 任务保存断言状态不变 | 生效 |
| AC-EL-LST-123 | 向导·Dry-run 结果面板 | 面板 | 「预检: 类目 {c} · 属性 {N} 个 · 必填 {M} 项 · 缺 {K} 项: {清单}(红) 或 · 必填齐备 ✓(绿)」;折叠「载荷 JSON 预览」pre 全量 payload | NoonListingTab.tsx:356-370;dry 端点=LST-062 同端点 dry_run=1,noon 返回 category/attribute_total/mandatory_total/missing_required/payload(listing.py:1681-1686);缺项 toast「缺必填 {N} 项」/「预检通过, 可提交」 | 面板计数与响应三数一致 | 生效 |
| AC-EL-LST-124 | 向导·建品成功面板 | 面板 | 绿框「✅ 建品成功 · sku_parent {x} · NSKU {y} · 已回写 sku_mapping」+variants 表 4 列(NSKU/partner_sku/psku_code/size);toast「建品成功 · NSKU {n}」 | NoonListingTab.tsx:372-388,217-227;成功=HTTP 200 且 variants 非空(listing.py:1699-1702);NSKU 回写 sku_mapping.nsku(_cascade_asin_to_mapping,noon 无 keepa,listing.py:52-65,1709-1711);失败 502「Noon 建品失败: {status.message 截 300}」 | 成功后 sku_mapping.nsku 落值;失败断言任务置 failed+submit_result.error | 生效 |
| AC-EL-LST-125 | 向导⑥·QC 审核状态卡 | 卡 | h2 sub「GetContent · EN/AR 独立审核 · PENDING→APPROVED/REJECTED · 驳回原因逐条列示」;「🔄 查询 QC 状态」需提交成功后可用(否则灰字「提交成功后可查询」) | QcPanel(NoonListingTab.tsx:455-464);GET /api/listing/noon/content/{tid}(listing.py:1728-1757):须 noon 任务+有 sku_parent;快照合并回 submit_result.qc,任务状态保持 imported(QC 终态只呈现不改任务机,listing.py:1730-1731);audit listing.noon.qc | QC 后任务状态仍 imported;submit_result.qc 更新 | 生效 |
| AC-EL-LST-126 | QC 语言卡内容 | 展示 | 每语言卡:{语言}+状态 badge(APPROVED ok/PENDING warn/REJECTED bad/其余无色,去 QC_STATUS_ 前缀)+「完整度 {n|—}」;缺属性=warn badge 列表;无效属性=bad badge 列表;驳回原因红字(;连接);评语灰字;errors「[code] message」红字 | NoonListingTab.tsx:466-495;QC_COLOR 映射(31-34) | 四状态色映射与文案格式 | 生效 |
| AC-EL-LST-127 | QC 图片审核块 | 展示 | 「图片审核 ({N})」前 6 张:review_status badge(VALID ok/INVALID bad/其余 warn,去前缀)+URL 省略灰字 | NoonListingTab.tsx:496-508 | 超 6 图仅显前 6 | 生效 |
| AC-EL-LST-128 | QC 失败呈现 | 错误态 | HTTP 非 200=红 pre「查询失败 HTTP {n}: {raw 截 200}」 | NoonListingTab.tsx:510-514 | mock 非 200 断言格式 | 生效 |
| AC-EL-LST-129 | 向导编辑深链 | 路由 | ?edit={id} 打开即载入该 noon 任务回填全部字段+submit_result/qc,并按其类目拉属性表单 | NoonListingTab.tsx:151-170;配合 LST-003 初始 tab | 带参访问断言回填与 tab 落位 | 生效 |
| AC-EL-LST-130 | noon 任务与 QC 卡 | 卡 | h2「noon 建品任务」sub「B1 通道任务流 · 编辑跳转向导 · imported 后可查 QC」;空态「暂无 noon 任务 — 去「建品向导」创建第一个」;caliber「通道=Content API product/upsert(2026-10-08 B1);状态机 draft→ready→imported/failed;QC 终态经 GetContent 呈现不改任务状态。」 | NoonTasks(NoonListingTab.tsx:523-589);GET /api/listing/tasks?platform=noon&page_size=100;exportCsv=noon_tasks | 文案逐字;仅 noon 行 | 生效 |
| AC-EL-LST-131 | noon 任务表列 | 表 | 7 列:# 灰 / SKU(文本筛选)/ 品牌 / 标题(截 40 悬停全文,空 —)/ 状态 badge(单源 LST-045,文本筛选)/ 更新(截 16)/ 操作 | NoonListingTab.tsx:559-576 | 列序与渲染逐项 | 生效 |
| AC-EL-LST-132 | noon 任务行操作 | 按钮组 | 「编辑」=写 ?edit= 后整页 reload 进向导;「预检」=dry toast(缺 N 项: 清单 或 预检通过 ✓);「提交」仅 ready 显示,confirm「真实提交任务 #{id} 到 noon 建品?」;「QC」仅 imported 显示,toast 逐语言「{lang}:{状态}({完整度})」或「无状态」 | NoonListingTab.tsx:532-557,568-575 | 四按钮状态门各断言 | 生效 |
| AC-EL-LST-133 | A+ tab 条 | 页签 | 三键:「📄 A+ 创建」「🖼️ 媒体库」「📋 文档 & 历史」 | AplusTab.tsx:85-89 | 三键顺序逐字 | 生效 |
| AC-EL-LST-134 | A+ ①·基本信息卡 | 卡 | h2「① 基本信息」sub「ASIN 多个逗号分隔 · 站点多选」;「文档名称(后台识别用)」(placeholder「如 T11 A+ 2026-09」)与「ASIN(多个逗号分隔)」两输入 | AplusTab.tsx:93-101;保存前必填校验:名称空 toast「文档名称必填」、ASIN 空「至少一个 ASIN」(66-68) | 两必填 toast 各断言 | 生效 |
| AC-EL-LST-135 | A+ ①·站点多选 toggle | 按钮组 | 站点 pill 点击切换选中(on 态);来源 /api/aplus/meta markets | AplusTab.tsx:103-111,51;GET /api/aplus/meta(aplus.py:14) | 点击切换与 markets 集一致 | 生效 |
| AC-EL-LST-136 | A+ ①·语言缺失警告 | 提示 | 选了站点且媒体库全为 none 语言时黄字「⚠ 媒体库暂无非英文图 → 将用英文图打底(UVPVP 同语义警告)」 | AplusTab.tsx:56-58,113-117;判定=所选站点 locale 无对应语言图(UVPVP 同语义) | 媒体库仅 none 语言断言警告出现 | 生效 |
| AC-EL-LST-137 | A+ ②·模板布局 | 单选 | 三 radio pill:「经典版(推荐)」「简洁版」「自定义」+ 说明「经典版=Header大图+3图文+4宫格+对比表 · 简洁版=无对比表 · 自定义=按需填模块」 | AplusTab.tsx:120-134;TEMPLATES:classic=header+three+quad+compare / simple=无 compare / custom=全四模块(28-32) | 选简洁版断言 compare 模块不渲染 | 生效 |
| AC-EL-LST-138 | A+ ③·模块内容与图片槽 | 表单 | 按模板渲染模块:① Header 大图+标题(1 图 1 文)/ ② 3 图文并排 / ③ 4 宫格 / ④ 对比表(0 图);图片槽 input 带 datalist 联想(媒体库引用);文本槽 textarea;compare 另有「对比的 ASIN(逗号分隔,不含本 ASIN)」输入 | AplusTab.tsx:136-172;MODULES 定义(22-27);datalist id=aplus-media-refs 选项=media.media_ref(138-140) | 模块槽位数=MODULES imgs/texts 定义 | 生效 |
| AC-EL-LST-139 | A+ ④·保存卡 | 按钮 | 「💾 保存草稿」toast「草稿已保存(#{id})」;下方预览行「预览:{N|—} 站点 · {N|—} ASIN · 模板 {key} · 模块 {a+b}」;已保存显示「当前草稿 #{id}(再次保存=更新)」 | AplusTab.tsx:66-79,175-185;POST /api/aplus/draft {name,asins[],market 逗号,template,content,doc_id}(aplus.py:81);ASIN 按逗号/空白拆分 | 二次保存同 doc_id 更新不新建 | 生效 |
| AC-EL-LST-140 | A+ ④·提交审核(禁用) | 按钮 | 「🚀 提交审核(未接凭证)」恒 disabled,title「SP-API 凭证未接入(需求单)」 | AplusTab.tsx:179;本期闭环=草稿+媒体库+登记+历史(AplusTab.tsx:3-4 注释) | 按钮恒禁用;无网络请求 | 未上线保留 |
| AC-EL-LST-141 | A+ 媒体库·登记卡 | 表单 | h2「登记媒体库图片」sub「引用=Amazon 媒体库路径或本站上传 URL · 语言标记手动(OCR 校验未接入)」;字段=媒体引用路径(placeholder aplus-media-library-service-media/xxx.jpg 或 https://…)/语言下拉 9 项/标签(placeholder 如 T11-主卖点-1)/「登记」按钮;空引用 toast「媒体引用路径必填」 | AplusTab.tsx:221-238,205-213;LANGS=en/ar/de/fr/es/it/nl/ja/none(20);POST /api/aplus/media(aplus.py:42);成功 toast「已登记」 | 语言选项 9 项逐字 | 生效 |
| AC-EL-LST-142 | A+ 媒体库·已登记表 | 表 | h2「已登记图片({N})」;5 列:媒体引用(省略)/语言 chip/标签(空 —)/登记时间/「删」按钮(confirm「删除媒体登记」) | AplusTab.tsx:239-258,214-218;DELETE /api/aplus/media/{id}(aplus.py:61);空态 EmptyState「暂无登记」提示「上方登记第一条媒体引用」 | 删除后行消失并 toast | 生效 |
| AC-EL-LST-143 | A+ 文档表 | 表 | h2「A+ 文档」sub「草稿闭环 · 提交审核未接凭证」;站点过滤 input(placeholder「按站点过滤 如 US」);7 列:名称/站点(空 —)/ASIN(逗号连接省略)/模板/状态(恒 badge warn draft)/更新/操作(编辑·删) | AplusTab.tsx:282-310,268-272;GET /api/aplus/documents[?market=](aplus.py:127);「编辑」回填创建 tab 全字段(192);「删」confirm「删除草稿」「{name}」?(仅草稿可删)」DELETE /api/aplus/docs/{id}(aplus.py:115),失败 toast「删除失败(仅草稿可删)」;空态「暂无文档/在「A+ 创建」保存第一份草稿」 | 过滤参数透传;编辑回填各字段 | 生效 |
| AC-EL-LST-144 | A+ 操作历史表 | 表 | h2「操作历史」sub「只追加」;6 列:时间/操作/ASIN(空 —)/站点(空 —)/状态(成功 ok·失败 bad badge)/明细(省略,空 —);空态「暂无历史」 | AplusTab.tsx:311-331;GET /api/aplus/history(aplus.py:140) | 列序与空态文案 | 生效 |
| AC-EL-LST-145 | 文件 tab·错误横幅 | 错误态 | err 非空时红条 role=alert 呈现错误文本 | FilesTab.tsx:58 | 断言 role=alert | 生效 |
| AC-EL-LST-146 | 文件 tab·三 KPI 卡 | 指标卡 | 「文件总数」(foot「租户内共享(RLS 隔离)」)/「占用空间」(fmtSize:>1MB 一位小数 MB、>1KB 取整 KB、否则 B;foot「宿主卷存储 · P2 换 S3」)/「支持类型」(静态文案「图片 / PDF / Office」,foot「xlsx·docx·pptx·csv·mp4·zip·txt·json」) | FilesTab.tsx:12-16,59-75;数据 GET /api/upload/files(26-29;collab.py:177):total/total_size/items | 换算阈值三段各验一值 | 生效 |
| AC-EL-LST-147 | 文件 tab·拖拽上传区 | 上传 | 卡头 h2「上传文件」sub「拖拽或选择 · 上传后复制外链用于 Listing / 文档」(FilesTab.tsx:78);虚线框 📤+「拖拽文件到此处,或点击选择」(busy 显「上传中…」)+「单文件 ≤ 50MB · 存储路径按 租户/月份 归档」;支持拖拽与点击(隐 multiple input);成功行内绿字「已上传 {N} 个文件 ·」 | FilesTab.tsx:77-92,31-48;逐文件 POST /api/upload FormData(collab.py:149);单文件失败仅该文件红条不停批 | 多文件混合成败断言计数与红条 | 生效 |
| AC-EL-LST-148 | 文件 tab·文件列表表 | 表 | h2「文件列表」sub「{N} 个文件」;6 列:文件名(加粗)/大小(右对齐 fmtSize)/类型(空 —)/上传时间/外链(a 新窗口,url 文本)/「删除」按钮;空态「还没有文件」colSpan=6 | FilesTab.tsx:94-116;外链=鉴权 raw 接口地址(UI-08 2026-10-14:Caddy /uploads 公开直出已永久关闭 404,统一走 /api/collab/files/{id}/raw 会话鉴权+RLS,FilesTab.tsx:118-121 注释与正文);表脚说明「外链仅登录会话可读…上传统一走 /api/upload 鉴权接口。存储为宿主卷(对象存储迁移列入 P2)。」 | 外链未登录访问断言 401/404;登录可读 | 生效 |
| AC-EL-LST-149 | 文件 tab·删除护栏 | 护栏 | 「删除」confirm「删除文件?/ 关联外链将立即失效。」danger 红字按钮 | FilesTab.tsx:50-54,109;DELETE /api/upload/files/{fid}(collab.py:192);确认后才请求 | 取消断言无请求 | 生效 |
| AC-EL-LST-150 | 规格书/任务/事件三端点(清单类) | 数据源 | 配套只读端点:GET /api/listing/specs(规格书列表最新在前 limit≤50)、GET /api/listing/tasks、GET /api/listing/events?task_id=(审计轨迹 limit≤200) | listing.py:584-596(specs)、667-698(tasks)、1093-1109(events);页面当前仅消费 tasks,specs/events 为 API 层完备性登记(页面出现即须有标准) | 三端点鉴权+租户隔离各验一发 | 生效 |
| AC-EL-LST-151 | PT 元数据端点(pt-schema) | 数据源 | GET /api/listing/pt-schema?brand=&market=&pt=&refresh=:官方属性元数据,listing_category_meta 缓存 7 天,畸形 schema 422 不缓存空元数据 | listing.py:1168-1202;bind_pt 内部同源拉取(LST-056);本页未直接调用(绑定经 bind-pt 端点),API 层完备性登记 | 7 天内二次调用 cached=true | 生效 |
| AC-EL-LST-152 | 任务删除端点(未上界面) | 护栏 | DELETE /api/listing/tasks/{tid}:仅 draft/failed/imported 可删(建错清理/归档);事件保留为审计残迹(无 FK);_require_admin | listing.py:941-956;本页无删除按钮(页面未暴露)——API 存在而 UI 无入口,如实登记防误删边界(铁律:不可误删) | ready 任务 DELETE 断言 409;删除后 listing_events 仍在 | 生效 |
| AC-EL-LST-153 | 租户隔离与模块门控 | 护栏 | 全端点 require_module('listing');approve/revert/export/import-results/submit/batch 另需 owner/admin;全部数据访问走 tenant_conn(tenant_id, brand_scope) | listing.py:9(模块 docstring)、111、各端点 Depends(_mod)+_require_admin(893,927,962,1037,1276,1378);meta 品牌按员工范围收敛(442-443);铁律:租户/品牌绝对独立 | 无 listing 模块租户访问断言 403;跨租户 task id 断言 404 | 生效 |
| AC-EL-LST-154 | 审计与事件全覆盖 | 护栏 | 写操作全部双落:audit()(租户审计日志)+listing_events(任务轨迹);事件动作集=create/edit/generate/approve/revert/delete/export/import_result/submit/bind_pt/qc | audit 调用 listing.py:549,578,663,835,886,922,937,955,1025,1089,1305,1342,1357,1242,1384-1513 各分支,1655,1682,1714,1756;_event 写入 399-402 detail 截 4000 | 每写操作后两日志各断言一条 | 生效 |
| AC-EL-LST-155 | 常量与限值集中定义 | 口径 | MAX_UPLOAD=10MB / TITLE_MAX=200 / BULLET_MAX=500 / BULLET_MIN=3 / MAX_RAW=100000(规格书文本截断)/ 前端同步限值(maxLength 200/500/5000) | listing.py:134-138;前端 page.tsx:556,564,571,730,756,763 一致;同口径跨层必相等 | 前后端限值逐项比对相等 | 生效 |
| AC-EL-LST-156 | 级联回写口径(ASIN/NSKU) | 口径 | 推送/回流取得 ASIN 或 NSKU 后回写 sku_mapping(仅补空值不覆盖已有)+Amazon 进 keepa_watch 关注池(auto_cascade 源,ON CONFLICT 跳过);noon 无 keepa | _cascade_asin_to_mapping(listing.py:45-72);market 精确匹配 country 行优先,未匹配则补该 SKU 全部空行(56-65);触发点=import 回流(1079-1084)/amazon 提交(1336-1339)/noon 提交(1709-1711);GB→UK 域映射(68);铁律:宇宙事实源=sku_mapping 不另造清单 | 已有非空 asin 的行不被覆盖;keepa_watch 无重复行 | 生效 |
| AC-EL-LST-157 | 型号分组行首列 | 单元格 | 「{model} {brand 灰}」;平台/站点列「{platform}[ · {market}]」(market 空省略段);SKU 数列右对齐整数 | page.tsx:1052-1054 | 三单元格格式断言 | 生效 |
| AC-EL-LST-158 | 批量生成链路口径 | 口径 | 型号流程「生成全部」=模板任务 generate(AI)→ 其余任务 batch generate_sync(拷贝,非逐任务再生成);单任务「规则生成」按钮同端点 | page.tsx:220-235(flowGenerate 先 generate 再 batch);模板选择=首条有 title 任务(page.tsx:166-168,204);batch 内模板任务自身记 ok note=模板(listing.py:1403) | 63 SKU 型号断言仅 1 次 LLM generate+62 次同步拷贝 | 生效 |
| AC-EL-LST-159 | 三子组件归属边界 | 边界 | NoonListingTab(listings/NoonListingTab.tsx 591 行)、FilesTab 与 AplusTab(upload/ 两文件)为本页专属子组件,随本节全量登记;/upload 路由本身=308 重定向本页(AC-EL-REDIR-003);DataTable 通用能力归 AC-EL-CMP 不逐列展开 | page.tsx:7-9 import 实证;upload/page.tsx:5 redirect("/listings") | import 走查无第三处挂载点 | 生效 |