Independent Audit · 只读审计

Zipforce Hub 跨境电商 SaaS 独立审计报告

审计对象 /opt/six-claude/workspace/saas(zipforce-saas-* 6 容器实测)· 本页为现状与风险核查归档,不含修复方案/改造代码/整改排期 · 证据索引 EV-01~20(evidence/EVIDENCE_INDEX.md)· 初版 2026-10-14 · 更新至 2026-10-24(第 0 节铁律与架构总纲+第 9 节波次+第 10 节 round2 修复线+10.7.1 未闭环清单 A–H 全处置;页首导航地图 2026-10-24 增设,逐版更新见页脚)
100%页面双视口遍历 45/45
1,473台账元素行(T1 472 / T2 243)
16 页L2 逐格视觉断言全 ✓
P0 ×0致命风险
P1 ×6高危风险
P2 ×11中危风险
P3 ×17低危风险
✅ 52问题已解决(更新 10-16)
51%T3+T4 元素未数值实证(红区披露)
硬红线自查:页面/元素遍历 100%(无未遍历页,元素级未实证项已在 §2.3/§6.1 红区逐条披露);数据核验全部附证据编号,无口头判定通过。
【页导航地图】(2026-10-24 结构化增设,只增不删)——本报告为累积归档(初版 2026-10-14),快速定位:
节内容什么时候看
§0铁律与规范总纲:业务隔离四铁律/工程门禁铁律/协作红线/运行架构·业务流·数据流一切口径的最高依据
§1–4架构摸底/页面元素遍历台账/细颗粒度功能明细/四层数据正确性验证初版审计底座(10-14/15)
§5–6风险汇总 P1/P2/P3/审计遗漏自检+架构疑问清单(6.2 已 10/10 全绿)风险全景
§7–8隔离收口对比(run-2 vs 基线)/全部问题汇总 run-1~7历史合并视图
§9波次日志 9.1–9.32(10-15~10-21):每波=用户令+处置+验证+结果 pill,时间正序逐波修复史
§10round2 修复线:10.1 清单处置总表/10.2–10.6 当晚交付与回滚锚点/10.7 拍板清单/10.7.1 未闭环全量清单 A–H/10.8 后续项看当前状态先读 10.7.1
§11逐页元素标准全册(AC-EL,44 路由+AppShell+共享组件,2026-10-24 自 audit-base 迁入)
§12尺子↔注册表对账·全指标一一对应施工清单(2026-10-25 立:15✅/12◐/5✗/32纪律+批A–F)
页脚=逐版更新链(一版一行)。姊妹页 audit-base.html 验收标准库——定位定谳(用户 2026-10-24 原话):audit-base 是一切审计验收的基础,以最细的颗粒度描述每一个信息;本页是审计后的记录,记录历史审计内容和结果(两页互相独立,链接不变原则)。

审计日期:2026-10-14 | 审计对象:/opt/six-claude/workspace/saas(运行栈 zipforce-saas-* 6 容器)

审计性质声明:本报告只核查现状、只识别风险;不含任何修复方案、改造代码或整改排期。

所有结论均有可复核证据(证据编号 EV-xx,索引见 evidence/EVIDENCE_INDEX.md);无证据项标注未验证或待研发确认。

第0节 铁律与规范总纲(置顶 · 2026-10-18 用户令汇总)

本节为全部现行铁律与规范的单一汇总处,分四层:业务隔离铁律(最高优先级,用户亲定)→ 工程门禁铁律(AGENTS.md)→ 协作口径与红线(历次用户裁定)→ 运行架构/业务流/数据流总纲(2026-10-19 实测置入)。任何工作开工前先读本节;与下层历史章节表述冲突时以本节为准。

0.1 业务隔离铁律(用户 2026-10-17 亲定原话,最高优先级)

#铁律(用户原话)落地口径
1"租户/品牌/国家/SKU 绝对独立"
→ 2026-10-19 升格(用户亲定):"租户/平台/品牌/国家/SKU 绝对隔离,第一优先级"
品牌全局唯一属主:UNIQUE(brand) 物理约束 + 品牌向导 409 + 注册加固三层;一个品牌只属于一个租户,撞名在物理层不可能;平台维度成文化后=3 租户×2 平台=5 组合物理分 schema(zipforce_amazon / zipforce_noon / onno_amazon / onno_noon / fittingirls_amazon)
2"直营和代理的区分也是铁律"seller_owner / sku_mapping.mode / brands_source.consign_schema 三级登记;代卖收入归并属主且属主可见(如 onno 的 EU 代卖订单归 t2);账号(渠道)不越权看品牌(zipforce 永远看不到 onno 品牌行)
3"所有租户包括新租户都要满足级联/隔离/自动生成"新租户/品牌/noon/SKU 四触发器自动生成档位与可见性(brand_onboarding_flow 7/7 实测口径,零残留)
4"不可误删"触发器/127 策略/双约束等结构不许误伤;可删的仅可见性镜像与死行,删除前必须结构盘点

2026-10-19 补充口径(用户亲定三条):①租户/平台/品牌/国家/SKU 五维数据隔离是第一优先级——平台维度自此成文化,落地即 3 租户×2 平台=5 组合物理分 schema(zipforce_amazon / zipforce_noon / onno_amazon / onno_noon / fittingirls_amazon);②数据流 ①源→②采集→③落库清洗→④服务→⑤呈现五段段段都要绝对隔离——每段都是硬边界(各租户自有凭证 / 按租户采集+账号→租户映射 / 落库即物理分 schema+清洗品牌归因 / RLS app.tenant_id 强制 / 子域名即租户边界),不存在"哪段只是兜底";③唯一豁免 = ABA 公共语料(一份 LWA 凭证、全局一份、租户无差别,属市场公共数据而非租户业务数据,不适用铁律 1;末端扇出 SaaS aba_radar_* 后即入隔离管辖)。双泳道图见 0.4.6。

0.2 工程门禁铁律(AGENTS.md「口径与门禁铁律」,每会话开工前必读)

0.3 协作口径与红线(历次用户裁定/审计惯例)

0.4 运行架构 / 业务流 / 数据流总纲(2026-10-19 02:40 UTC 实测置入)

全栈在 mars 单机 Docker 闭环,Dell/venus 遗产已清零(mercury=原「222」,2026-10-24 定名:现役异地备份盘)。唯二出站依赖:平台 API(Amazon SP-API / Noon / Keepa / LWA)与异地备份推 mercury。容器/档位/时刻表为实测快照,复核以实时 docker ps 与 collection_schedule 查询为准。

0.4.1 容器总览(在跑 9 = 本栈 6 + 他业务 3)

容器镜像/近期状态职能详述
zipforce-saas-db-1postgres:16-alpine · healthy唯一持久化实例。一实例多库(非系统库 11 个):核心三个=saas_registry(业务库 158+ 表,RLS 以 app.tenant_id 会话变量做租户隔离)、amazon_analytics(采集源库:3 租户 schema zipforce_amazon/zipforce_noon/onno_amazon/onno_noon/fittingirls_amazon + shared + audit schema)、zipforce_ba(ABA 语料 ba_search_terms 54M 行 + sourcing 雷达单期缓存);辅助=kol_db/zipforce_pm/zipforce_promotion/zipforce_factory/github_research/umami/redash/paperclip。pg-init 33+ 迁移脚本保证 fresh-init 与活库同构。业务数据唯一事实源
zipforce-saas-redis-1redis:7-alpine · healthy · 256MB LRU 无持久化纯易失缓存/队列层,见 0.4.2 六类用途。不存任何业务数据——丢失后果仅=会话重登+限速窗重置+任务断点续传(checkpoint 全在 PG)
zipforce-saas-api-1FastAPI · uvicorn 2 workers390+ 路由读侧(看板/KPI/雷达/排名/库存/财务)+ R21/R22 广告写面(双平台暂停/启用/改预算/改名/创建/克隆/归档,页面直发);租户 cookie 会话(zf_saas_{slug})→ RLS 会话变量;日志 tee 落宿主卷;改代码须 build api+重建容器(代码打进镜像,无源码挂载)
zipforce-saas-worker-1ARQ 双进程(主 73 函数+回补 4 函数)异步任务消费:采集循环(Amazon/Noon 增量+日档)、ingest/清洗、keepa 刷新、广告导入泵、报警/对账 cron tick、注销归档、回补;4GB 内存熔断(失控任务只死 worker 自动重启,不连累 api/db);容器还承载 host 统一调度器 docker exec 进来的 /collection/run.py。换镜像规则见 0.4.4
zipforce-saas-web-1Next.js全部前端页面(30+ 路由),登录态渲染;改代码须 build web
zipforce-saas-caddy-1caddy:2-alpine · Caddyfile 194 行唯一公网门面(HTTPS 证书/路由/安全头/审计日志),七项职能见 0.4.3
uibot-app-1 / uibot-caddy-1他业务uibot 项目一套(应用+独立反代),与本栈无依赖
firecrawl-playwright-service-1他业务·孤活firecrawl 无头浏览器渲染端;其主栈(api/foundationdb×2/postgres/rabbitmq/redis 共 6 容器)3 周前已退出,属残态

0.4.2 redis 六类用途(实码指认)

#用途实现/键口径
1API 网关限速main.py:135-154 · rl:global:{ip}/rl:ai:/rl:mcp: 分钟窗 INCR+65s 过期全局 240 req/min、AI 20/min(烧钱门槛)、MCP 60/min;Redis 挂掉降级进程内 4096 槽兜底。"e2e 与状态遍历不可并行"说的就是这个 240 共享桶
2ARQ 任务队列tasks.py(16 处)默认队列+p2 低优双队列,worker 双进程消费(api 投递→worker 执行采集/回补/重算/导入泵/报警 tick)
3会话管理core.py:157-165 · sess:{sid}+sess_user:{slug}:{uid}登录态令牌+用户→全会话集合;登出全设备/停用/改密时批量吊销
4套餐配额门core.py:455(keepa)· services.py:103(LLM)· keepaq:{slug}:{日期}选品搜索每租户每日配额(套餐分档,超限 429);LLM 同款日配额;llm:active 热键=平台管理员秒切 LLM 供应商
5用量台账main.py:73 · usage:{日期} hash每请求按租户 hincrby +1,请求级用量计数
6运维杂项core.py:466 · backfill.py:188-240 · domains/scheduler.pykeepa token 余量热读 keepa:lastleft;回补死信队列(DLQ)查看/重投;采集档位状态查询

配置口径:--maxmemory 256mb --maxmemory-policy allkeys-lru --appendonly no——纯易失语义,PG 才是长期账本。

0.4.3 caddy 七项职能(Caddyfile 行号指认)

#职能详述
1域名路由(:70-194)五类站点块:apex zipforcehub.com(/api/*+/mcp→api:8000,其余→web:3000);www→308 apex;changelog.zipforcehub.com(静态归档站,本报告即在此出);console.zipforcehub.com(→宿主 8900 Agent Console,origin 隔离);https:// 通配块=全部租户子域 {slug}.zipforcehub.com 同样 api/web 分流
2TLS 按需签发+防滥用(:63-68)租户子域 on-demand 签发,但先 ask http://api:8000/api/tenant/exists——只给已注册租户签证书,防陌生人打爆 Let's Encrypt 配额;新租户开户即自动有 HTTPS,零手工
3安全头网关(:5-24)HSTS/nosniff/X-Frame-Options DENY/Referrer-Policy;强制 CSP(2026-10-01 GTM 注入复发后由 Report-Only 升级);Permissions-Policy(/console 麦克风例外,其余全禁);隐藏 Server 头
4边界硬规则 ARC-01(:92-102,176-184)/internal/* 契约 API 网关显式 404(仅容器网内直连);公网入口剥除 X-Tenant-Id 头(内部租户标识头,防伪造越权)
5访问审计日志三份 JSON 日志落宿主卷(access-apex/access-tenant/access-console,50MiB×5 滚动),5xx 网关层可查,容器重建不丢
6静态内容分流(:28-61)/listings/*、/training/*(培训站只读挂载)、/downloads/* 走 file_server;/uploads/* 公开直出永久 404(上传文件改走鉴权 API 读,会话+RLS)
7缓存控制(:105-110,187-191)覆写 Next 预渲染 HTML 缓存头:apex=public must-revalidate;租户子域=private no-cache(登录态页面不进共享缓存)

0.4.4 worker 换镜像规则(2026-10-19 实证)

0.4.5 业务流(3 租户×2 平台=5 组合在采,fg 无 Noon)

维度现状
归属1=zipforce、2=onno、3=fittingirls,各 1 品牌绝对独立(铁律 1);tenant_accounts 6 行:1=zipforce_amazon/zipforce_noon,2=onno_amazon/onno_noon/zipforce_amazon(=onno 的 EU 代卖对),3=fittingirls_amazon
采集档位
(collection_schedule 注册表驱动,
host 调度器每分钟扫描)
Amazon:3 品牌全量 collect */30(半点增量)+ collect_daily 0 2(日全量);Noon:zf/onno 各增量+日档,zf 另有 asn_ledger 2:40/recon_gates 3:17/status_sweep(月度),全租户 webhook_consume */2;全租户 push 0 *(整点推送)+ daily_readonly 4:30
开户流向导(撞名 409 三层防线之一)→ 四触发器自动生成档位/可见性(新租户/品牌/noon 登记/SKU 登记)——铁律 3
广告双平台读写面全上线(R21/R22):页面直发暂停/启用/改预算/改名/创建/克隆/归档+原生建议一键采纳
机会雷达事件驱动先算后搬(2026-10-19 节奏收敛,日更退役):aba_radar_compute 重算 sourcing 三表(单期 DELETE+INSERT 幂等)→ 搬运工 top-300/国 → SaaS aba_radar_*(租户 1/2/3)

夜间批时刻表(host crontab,UTC):

时刻任务说明
*/1collection_scheduler.py统一调度器:注册表驱动,半点增量+整点推送
每 10 分heartbeat.py心跳自监控
*/2six-claude-monitor.sh会话监控
7/13/19/49 分worker exec run.py --status-onlyzf/fg/onno amazon 采集积压观察(只读)
04:07aba-watchdog.shABA 看门狗(2026-10-19 收敛,替代旧 13,43 aba-catchup):池↔SaaS 最新期次对比,一致秒退;池新→自动补跑 refresh+当日重试一次;池旧于 SaaS→报警拒自愈
03:30backup.sh备份+异地推 mercury
04:40aba_keepa_pull.pykeepa 排名拉取+seed_from_mapping 每晚自 sku_mapping 补种
04:50kol-refresh.shKOL 数据刷新
06:35four_layer_audit.py四层数据审计(追加式)
07:10monitor.py监控代理
07:25cron_audit.pycron 执行审计
每月 5 日 06:30aba-monthly.shABA 月度完备性守卫:本地重灌(不打 Amazon)+断言上月每国行数≥前 3 月中位数×60%(六主站必须达标)
每月 3 日 07:20ba-feeder/run.shBA 报告投喂(LWA→报告→下载→upsert→checkpoint;唯一打 Amazon 的 ABA 环节)+拉成功串行触发 aba-refresh(2026-10-19 起,日更 cron 已退役)

0.4.6 数据流(采集→清洗→服务全链)

【业务数据道 —— 全链段段硬隔离(2026-10-19 用户口径:①-⑤五段都要绝对隔离)】
① 源    SP-API │ Amazon Ads │ Noon(+webhook) │ Keepa —— 各租户自己的账号/凭证【硬边界1】
② 采集  worker(ARQ 37 任务 34 cron)+ mars 宿主 crontab
        —— 按租户凭证拉(tenant_accounts 账号→租户映射)【硬边界2】
③ 落库+清洗  amazon_analytics 租户 schema —— raw 落库即物理分 schema:
        zipforce_amazon / zipforce_noon / onno_amazon / onno_noon / fittingirls_amazon(3租户×2平台=5组合)【硬边界3】
        清洗=去重+品牌归因(zf 账号卖的 onno 货归并品牌属主——铁律 2)→ cleaned_*(仍在各租户 schema 内)
④ 服务  api(FastAPI:8000,390 路由)—— portal_app 受限账号 + RLS app.tenant_id 强制【硬边界4】
⑤ 呈现  web(Next.js:3000,经 /api 反代,不直连 DB)→ caddy(443 按需 TLS)
        → {slug}.zipforcehub.com(子域名即租户边界)→ 用户【硬边界5】

【公共语料道 —— ABA 唯一豁免(2026-10-19 用户口径:aba 是公共的)】
LWA(一份凭证,不分租户)→ ba-feeder(宿主 cron)→ zipforce_ba 六表(ba_search_terms 54M 全局一份)
   → aba-refresh(事件驱动:feeder 月拉后串行+watchdog 每日兜底,2026-10-19 起日更退役)→ aba_radar_compute → sourcing 单期缓存(仍公共)→ 搬运工 top-300/国
   → 扇出 SaaS aba_radar_*(租户 1/2/3 行)—— 自此入 RLS 管辖,在 ④ 汇入业务道

【反向写回(数据流双向)】用户 → caddy → web → api → Noon Ads 七写面 / Amazon Ads bid(同过 ④ 的 RLS 门)
【旁路】Keepa → rankings_daily(监控池 sku_mapping 每晚 seed_from_mapping 补种——"所有动作基于 mapping table")
        │ 异步 ARQ 双队列(默认+p2)│ 审计 four_layer_audit 06:35 追加式 │ 备份 03:30 → 异地推 mercury
        │ 出站仅平台 API 与异地备份,其余全在 mars 本地

口径四要点:①清洗层做品牌归因(代卖收入归属主,seller_owner/mode/consign_schema 三级登记——铁律 2);②雷达为单期缓存层(全史在 ba_search_terms 可随时重算,DELETE+INSERT 幂等);③出站仅平台 API 与异地备份,其余全在 mars 本地;④隔离为全链属性(2026-10-19 用户口径)——租户/平台/品牌/国家/SKU 五维隔离第一优先级,业务道①-⑤段段硬边界无"兜底"段,ABA 为唯一公共豁免道、扇出 aba_radar_* 后才入 RLS 管辖。


第1节 架构摸底清单表

1.1 运行容器实测清单(docker ps 与 compose 定义一致,无额外容器)

容器镜像职责端口/关键挂载依赖风险标记
zipforce-saas-db-1postgres:16-alpine唯一持久化实例:saas_registry 业务库(public 158表) + amazon_analytics 采集源库 + audit schema(136表);RLS 以 app.tenant_id 会话变量实现租户隔离无宿主端口;pgdata 卷;pg-init 33+ 脚本无同一 PG 实例同时承载 SaaS 业务库与采集源库(sync_source.py:97 直连同 host 异库)——容量与故障隔离边界待研发确认
zipforce-saas-redis-1redis:7-alpineARQ 双队列(默认+p2)、限速桶、LLM/Keepa/MCP 热键无宿主端口无—
zipforce-saas-api-1zipforce-saas-api (FastAPI)业务控制面:390 路由/33 router;uvicorn 2 workers;限速(240req/3s)/CSRF/租户解析中间件8000 仅内网;uploads/po_docs/offboarding(rw)、/collection/secrets(ro)db, redisapi 容器持有 Amazon Ads/Noon 凭据(采集面职责混入控制面);internal.py:5 自建租户连接仅凭 X-Tenant-Id 头
zipforce-saas-worker-1同 api 镜像 (ARQ)定时采集/清洗/回溯/发送:37 任务函数 + 34 条 cron;双进程无端口;/opt/collection 挂载为 rwdb, redis采集目录 /opt/collection 为 rw,可写边界大于 compose 注释所述(H8)
zipforce-saas-web-1zipforce-saas-web (Next.js)前端 SSR;数据全部经 /api 反代,无直连 DB3000 仅内网;read_only+tmpfsapi—
zipforce-saas-caddy-1caddy:2-alpine公网网关:TLS on-demand(ask→/api/tenant/exists);/api/*与/mcp→api、其余→web、静态目录、/console→宿主172.18.0.1:890080/443 暴露api, web/console 反代宿主端口为自述过渡态(Caddyfile 注释);/uploads 公网 404(实测)

1.2 服务依赖与数据流(现状描述)

(完整 390 路由账、37 任务+34 cron 清单、H1-H11 风险注记见 arch/architecture.md)


第2节 全量页面&元素遍历台账与覆盖率

2.1 台账结构

2.2 覆盖率统计(以总台账末尾自动统计为准)

2.3 未遍历/未核验清单(红区,如实披露)


第3节 细颗粒度功能审计明细(按模块,单按钮/接口/字段一行)

全量逐元素登记见 master_ledger.md;本节列示审计中产生结果判定的元素/接口行(通过项与风险项),风险编号对应第5节。

3.1 广告模块 /ads(173元素)

对象类别结果
广告分析国家分布表 SA/AE 行 spend/sales/acos/roas/cps 列表格数值✅已修好(任务#9)原判:失真 ADT-01(EV-02:行内 spend/local_spend 比值 17.25/4.19,真实汇率0.267/0.272)✅已解决(任务 #9,第 8 节台账)+2026-10-18 线上直采复核:noon 国 SA/AE 行 spend/local_spend=0.2667/0.2725,与真实汇率 0.267/0.272 一致
/api/ads/analysis?days=30接口✅已修好(任务#9)原判:同上失真;且该端点当时在 audit_nodes 为无基准枚举节点,门禁不拦(EV-02)✅已解决+门禁缺口已闭:/api/ads/analysis 已入 audit_nodes 枚举参数矩阵(audit_nodes.py:32)并建 totals.spend SQL 数值基准(:132,含 ADT-01 级联基准同步注释),同类回归会被门禁拦下
平台tab/账户tab/日期控件/表格分页排序控件✓渲染遍历+e2e 断言(EV-08,12)
广告日预算/调价建议等写操作按钮只读约束未实操,代码级核验 admin 门控在位(EV-10)✅2026-10-18 已实证:R21/R22 广告页写面全量实操(暂停/启用/改预算/改名/创建/克隆/归档金丝雀 18/18 通过,见 9.16/9.17)

3.2 工作看板 /、/today、/dashboard/*(210元素)

对象类别结果
kpi-cards rev30/commission/fba指标卡✅已修好(任务#10)原判:+7USD 级系统性残差 ADT-02(EV-01,04:API 68568.07/68609.17 vs SQL 基准 68561/68602,±1容差FAIL,三重复现根因未归因)
81 图双视图 chart_value图表✓对账 PASS(EV-08)
merged-kpi/sku-matrix/charts/alerts 等 GET 端点接口✓audit_nodes 1605 节点中除 kpi-cards 外全平(EV-07)
/today cur.orders ×3租户接口✓api=db 逐日对账 PASS(EV-04)

3.3 财务对账 /finance、/settlement(79元素)

对象类别结果
finance.py 16 路由接口✓全部 GET 只读(EV-10 代码级)
月表 net_profit vs 重算字段✅已修好(任务#21)原判:三租户残差 -205.68/+473.85/+32.35 方向不一 FIN-01(EV-03 ID3)【待研发确认口径】
Noon 对账单月内恒等式表格✅已修好(任务#22)原判:58/61 行不闭合,最大残差 305,337.88;opening→closing 链式 61/61 ✓ FIN-02(EV-05)【待研发确认口径】
退款金额月度口径字段✅已修好(任务#23)原判:仅 units 无金额,恒等式「订单额−佣金−退款−平台费用=净回款」库内无法闭合 FIN-03(EV-03 ID4;backfill.py:412 注释自认)

3.4 订单/退货退款结算 /orders(19元素)

对象类别结果
订单表筛选/分页/导出控件✓e2e 网络断言(EV-08)
订单清洗 caliber(排除 Canceled/Pending,fx+items 回退链)口径✓dashboard_audit 178+ 项 PASS 内含(EV-07)

3.5 回溯专项 /backfill(专项①,EV-11)

对象类别结果
发起/取消/死信三写操作按钮/接口✓_require_admin+窗口上限+audit_log+zlog+p2队列+租户信号量 在位(代码级)
worker 侧 done/dryrun/fail 审计日志✅已修好(任务#13)原判:100% 丢失(_audit 在最终 commit 后插入且无再 commit,close 回滚;91 run 仅存 create×91)BF-01
回滚能力功能✅已修好(任务#14)原判:零生产实证(snapshots 0 行、无非dry完成 run)+损毁式实现(amazon_orders 30列快照仅6列/finance_monthly 22列快照8列,DELETE全窗+重插残列)BF-02
原始数据隔离机制⚠快照表独立不进读路径✓,但从未落库;重拉=以最新源覆盖 R-BF-3
时间口径 order_created/refund_posted字段⚠仅影响差异报表列,拉取窗由适配器决定 R-BF-3待研发确认

3.6 采集/管道 /pipeline、/database、/dictionary

对象类别结果
cleaned_amazon_ads_daily数据✗2026-09-25 起停更19天 DAT-01(EV-04 两批次FAIL)挂账:用户令搁置 2026-10-17,等 onno foncye Advertising API 授权后自愈(见 8.7)
断流族 onno/US(4天16单FAIL)、noon finance(7天)、NL10/IT6/SE4/PL7天数据✅已修好(任务#12)原判:断流/告警混合 DAT-02(EV-04)
RLS 5表缺 is_active 维度权限✅已修好(任务#15)原判:RLS 5表缺 is_active 维度 SEC-01(EV-04)
audit_log 防篡改日志✅已修好(任务#16)原判:可 UPDATE/DELETE SEC-02(pg_trigger 实测)

3.7 用户权限/租户

对象类别结果
pen_tests 租户隔离矩阵 221 项接口✓全 PASS(我方实跑 exit=0,EV-04 附证)
RLS 隔离实测 portal_app数据✓无跨租户泄漏(EV-04)
internal 路由头鉴权接口⚠ARC-01:文档称网关剥头,Caddyfile 无此规则;实际防护=路径不代理
限速 Redis 失效静默放行中间件⚠SEC-05(main.py:133 自述)

3.8 平台运营 /noon(noonops 8 写端点)

对象类别结果
8 POST 端点(asn/create等)接口⚠SEC-04:dry-run默认+confirm双步✓、audit()留痕✓;无幂等键、超时异常跳过审计
只读遍历(sweep 未实操写)约束未实操项见 2.3 红区

3.9 其余模块

库存(/inventory 49元素):期初+入库−出库=期末台账表 0 行未投用 INV-01(EV-03 ID1);快照对账 PASS。

物流/PO/项目/推广/Listing/上传:渲染遍历✓;数值项属 T3 未逐项实证(见2.2);上传外链公网可达 UI-08;listing page_size=100 无分页 UI-02。

系统配置 /settings /billing /team /account:渲染✓;permanentDelete 疑似未接线 UI-07✅已修好(任务#38:接线在位确认)。

静态页 /welcome /en /privacy /terms:渲染✓;/terms 两处管辖法律 TODO 占位 UI-04。


第4节 四层数据正确性验证结果明细表

层验证项方法结果证据
L1 页面显示42路由页+12URL变体+3认证页×双视口(1600/390)截图,共409张Playwright 实拍+像素扫描(e2e)✓45/45 页双视口齐备,无未遍历页EV-12
L2 API=页面16页逐格视觉断言:/ /finance /settlement /today /orders /backfill /dashboard/zipforce /dashboard/noon/zipforce /inventory /noon /rankings /products /ads晨报 /listings /mapping /ads?tab=platform同刻 API 原始 JSON 全量落盘 vs 截图逐格读数✓全部一致(含派生口径2处如实记录);仅 kpi-cards 页面=API 但 API≠BASAL SQL +7USD(ADT-02)EV-01,02,13
L3 SQL 勾稽ID1 库存台账SQL✅已修好(任务#24 台账已投用)原判:0行未投用(恒等式无从验证)EV-03
L3ID2 广告日表断流SQL✗19天挂账:同 DAT-01 用户令搁置(见 8.7)EV-03
L3ID3 月表 net_profit 重算SQL✅已修好(任务#21)原判:残差三租户方向不一EV-03
L3ID4 退款金额口径SQL+代码✅已修好(任务#23)原判:仅 unitsEV-03
L3ID5 Noon 对账单SQL✅已修好(任务#22)原判:月内58/61不闭合;链式61/61✓EV-05
L3kpi-cards vs BASAL SQL同刻双取✅已修好(任务#10)原判:+7USD 系统性残差(ADT-02)EV-01
L3audit_nodes 1605 GET 节点仓库门禁+自跑✓除 kpi-cards 外全平EV-07
L3dashboard_audit 178+ KPI仓库门禁+自跑✓PASS(2 WARN 口径内)EV-07
L3chart_value 81图仓库门禁+自跑✓PASSEV-08
L3今日页 cur.orders×3租户仓库门禁✓api=dbEV-04
L4 跨页面/ads Σspend 25526 vs /dashboard ad_spend 7598 vs cur 1043三端点同刻对照✅已修好(任务#9;窗口/平台口径差为设计差异非缺陷)原判:SA/AE 失真主导+窗口/平台口径差并存EV-02,06
L4FX 双实现(基准 peg 3.75/3.6725 vs API 市场价)代码+SQL✅已修好(任务#28)原判:同一数值两套汇率口径 ARC-03EV-01,02
L4订单创建 vs 退款发生时间口径代码级⚠time_basis 仅报表列级,拉取窗由适配器定 R-BF-3EV-11
L4看板汇总=明细求和·分页重算e2e 断言✓PASSEV-08
L4库存/订单/广告 回溯重算勾稽(2%容差)代码级机制在位;生产零实证(BF-02)EV-11

第5节 风险汇总(不安排修复排期)

统计:P0×0 | P1×6 → ✅已解决 5+❌未解决 1 | P2×11 → ✅已解决 11 | P3×17 → ✅已解决 17 | 有证据通过项×8(明细 evidence/risk_register.md;解决状态更新至 2026-10-16,逐项台账见第 8 节)

P1(6)

1. ADT-01 /api/ads/analysis SA/AE 美元换算虚高17.25/4.19倍,Σspend 98.4% 失真,页面国家表连带失真,门禁无基准不拦 ✅已解决

2. ADT-02 kpi-cards 三指标 vs SQL 基准 +7USD 级系统性残差,三重复现根因未归因 ✅已解决(归因并修口径,任务 #10)

3. DAT-01 cleaned_amazon_ads_daily 停更19天(阈值4),zf/fg 九月广告数据整月缺失 ❌未解决(阻塞用户侧:foncye Advertising API 授权)挂账:用户令搁置 2026-10-17,授权后自愈(见 8.7)

4. DAT-02 断流族:onno/US(FAIL)、zipforce noon finance 7天、NL10/IT6/SE4/PL7天 ✅已解决

5. BF-01 回溯 worker 侧审计日志 100% 丢失(commit 顺序缺陷,91 run 仅存 create) ✅已解决

6. BF-02 回滚零生产实证 + 损毁式实现(快照列子集,回滚即丢列) ✅已解决

P2(11)✅全部已解决

SEC-01 RLS 5表缺 is_active;SEC-02 audit_log 无防篡改触发器;SEC-03 pg-init/00-role.sql:5 明文 DB 密码与 secrets 双源;SEC-04 noonops 无幂等键+超时跳审计;SEC-05 限速 Redis 失效静默放行;SEC-06 worker /opt/collection rw 挂载;FIN-01 月表 net_profit 勾稽不平;FIN-02 Noon 对账单月内恒等式 58/61 不闭合;FIN-03 退款金额口径结构性缺项;INV-01 库存台账 0 行未投用;E2E-01 移动端自动化仅覆盖 /backfill 一页。

P3(17)✅全部已解决

ARC-01 internal 头鉴权文档与网关实现不符;ARC-02 routers 互相 import 15 处;ARC-03 FX 双实现;DAT-03 cleaned_backfill_runs 镜像滞后 87/91;DAT-04 挂账白名单 6 项过期未续;TST-01 e2e 向生产写 dry-run 测试行15条;UI-01 /training KPI 硬编码"126 MB";UI-02 listing 无分页;UI-03 promotion 死代码320行;UI-04 /terms TODO 占位;UI-05 两套状态中文映射不一致;UI-06 删除确认弹窗混用;UI-07 permanentDelete 疑未接线;UI-08 上传外链公网可达+宿主卷存储;UI-09 /mapping 前端导出无审计留痕;GOV-01 RLS 策略 103 张漂移;GOV-02 sales_hourly 幽灵行 3140 格。

有证据通过项(8)

pen_tests 221/221;e2e 30页桌面遍历;dashboard_audit 178+;audit_nodes 除1项外全平;chart_value 81图;audit_results 防篡改触发器实测生效;Noon 对账单链式 61/61;backfill API 侧管控链在位。


第6节 审计遗漏自检 + 架构疑问清单

6.1 审计遗漏自检(如实披露,未覆盖即未验证)

1. 交互深度:浏览器遍历仅点击 tab 类按钮(只读约束),筛选器/表单/写操作未逐项实操——覆盖依赖仓库 e2e 门禁的筛选联动断言✅2026-10-18 部分补齐:select/筛选器动态加载补扫全绿(7.3)+ 广告页写面全实操(9.16/9.17);其余页面表单/写操作维持 e2e 门禁依赖

2. 移动端:全部页面取得 390 视口截图,但功能级移动 e2e 仅仓库自有 /backfill 一页(E2E-01)。

3. AI/LLM 端点(/api/ai*、流式):未发起真实调用(无凭据消耗授权),仅静态登记。

4. webhook(Stripe/Noon):未触发真实事件,仅代码级登记。

5. /register /verify 动态提交未执行(会产生真实数据,违反只读约束);两页及 /login 均已完成登录态前后双视口截图与抓包(EV-12)。

6. 图表 81 项依赖仓库 chart_value 门禁复跑结果+抽查,未逐一手工重算。

7. 截图为视口内(非 full_page),超一屏内容以表格分页/滚动前状态为准。

8. 本审计为单日时点(2026-10-14),非长期趋势审计。

6.2 架构疑问清单(待研发确认汇总,10项;✅10/10 已修好(8/10 2026-10-18 全页清扫补标;Q7/Q10 2026-10-24 D7 专项核验收口))

Q1 kpi-cards +7USD 残差根因(ADT-02)✅已修好(任务#10)

Q2 /api/ads/analysis SA/AE 换算公式来源(peg 当乘数?双重换算?)✅已修好(任务#9;2026-10-18 线上直采复核 0.2667/0.2725)

Q3 月表 net_profit 官方口径(FIN-01)✅已修好(任务#21)

Q4 Noon 对账单 closing_balance 官方口径(FIN-02)✅已修好(任务#22)

Q5 库存台账 cleaned_inv_stock_ledger 设计写入时机(INV-01)✅已修好(任务#24)

Q6 /internal 头剥除声明的真实防护边界(ARC-01)✅已修好(任务#26)

Q7 采集适配器并发幂等性(回溯与 cron 并发,R-BF-4)挂账:未专项核验,无对应任务(现行缓解=回溯走 p2 队列+租户信号量,见 3.x 三写操作行)✅2026-10-24 专项核验收口(D7,用户令「ADEF全部接受修复」)——四层证据链:①队列层tenant_sem(Redis INCR,租户×任务类 limit=1,TTL 86400 崩溃次日自愈,正常退出 release 归还;tasks.py:50);②同窗护栏P2-11 同 (brand,platform,task_type,from,to) 有 queued/running/done 即 409(force 显式放行);③品牌锁P2-13 pg_try_advisory_lock(hashtext('bf:{brand}')) 快照→执行→回滚全程持锁(backfill.py:173,抢不到=deferred 重排队);④写面幂等采集目标表自然键唯一约束×ON CONFLICT UPSERT 四表实证(storage_fees 五元组键/service_fees 八列键/noon_ads_queries 六列键/fg_settlement_items 四列键)——cron 与回溯同表并发=确定性 last-write-wins,同源同内容无重复行无漂移,无需新增代码(现防护=完整)。核验同日顺手修复 #75 回补事故根因:429 长等(240s×60 拍最长 4h)期间 LWA token(1h 寿)过期→createReport 403 连环烧窗;zf_storage_fees 增 _fresh_tok(清 amz_finances_core._tc 缓存重取)+403 重试预算 3 次(真权限墙仍走窗口级 ERROR 不空转)。

Q8 /team permanentDelete 是否接线(UI-07)✅已修好(任务#38:接线在位确认)

Q9 RLS 策略 103 张 vs 期望 86 的漂移来源(GOV-01)✅已修好(任务#41)

Q10 db 容器业务库+源库共存的容量/隔离边界(第1节容器表)挂账:架构边界待拍板✅2026-10-24 实证收口(D7)——容量:db 容器 mem 295.6MiB/4GiB(7%)、连接 12/100、宿主盘 314G 用 72% 余 87G;saas_registry 15GB(大头 audit.cleaned_*:kol_reddit 1.4G/aba_search_terms 1.2G/dirty_data_log 941M)+amazon_analytics 2.1GB(noon_ads_queries 747M/fg_settlement_items 421M),两库合计≈17G 对 87G 余量=按现增长速率多年量级无压力;隔离:两库同 PG 实例不同库不同角色——portal_app 可 CONNECT mars 但对 5 个业务 schema USAGE 全 false=角色层零读面(实测),全代码面 mars 连接方仅 saas_admin(sync_source qsource×3+tasks 直连+pg_dump+四层审计)与 collector(采集器 db.json);收紧pg-init/120:mars 库 CONNECT 自 PUBLIC 收至 saas_admin/collector 两登录角色(registry 侧多面在用另行核验后再议);边界建议=暂不拆库,触发线(任一命中再拆/扩):盘余<20%、连接持续>70、amazon_analytics>50G(26 个月回补族落库后复核)。

第7节 2026-10-15 隔离收口对比(run-2 全量状态遍历 vs 2026-10-14 基线)

对比口径:基线=2026-10-14 修复前全量隔离审计(raw_run2_baseline.json);run-5=2026-10-15 修复后全量隔离审计(run5_full_audit.log);run-2=2026-10-15 全量状态遍历(state_traversal.json,含 tab/选择器/chart 逐状态扫描)。

7.1 泄漏对比(API 全端点 × 3 租户)

租户基线 API 泄漏run-5 API 泄漏run-2 状态遍历泄漏变化
zipforce(t1)2400-24(已清零)
onno(t2)7000-70(已清零)
fittingirls(t3)3502(同源 B0CYM5N9QV)-33(残余 2 条为公共竞品 INFO)
合计12904(onno 2 + fittingirls 2,同源)实质泄漏=0;4 条为公共竞品情报边界 case

7.2 残余 4 条泄漏的定性(与基线 aba_radar_gem INFO 类同性质)

7.3 未覆盖项(如实披露)

页面未覆盖内容原因
/listingsSKU 下拉 29 项、类目下拉 20 项选项为动态加载,枚举发生在选项加载完成前✅2026-10-18 工具修复后补扫全枚举:zf 61/61、onno 39/39、fg 41/41
/finance月份下拉 2 项、年份下拉 2 项、汇总方式 1 项同上(动态选项)✅2026-10-18 补扫全枚举:zf 32/32、onno 30/30、fg 31/31(03:15 补扫收口)
/inventory国家下拉 6 项(US/ES/SE/BE/JP/AE)同上(动态选项)✅2026-10-18 补扫全枚举:zf 18/18、onno 18/18、fg 17/17

以上属工具时序缺口(选项加载晚于枚举),非应用隔离问题;待 select 动态加载修复后补扫,不计入泄漏。✅2026-10-18 缺口已修(计数稳定等待 + 逐项 wait_for_selector,tenant_state_traversal.py:449/:465)并补扫关闭:三页 × 三租户选项全满覆盖、0 泄漏、门禁通过(见 9.x 红项同名条)

7.4 与基线对照结论


第8节 全部问题汇总(run-1 至 run-7 合并,含解决状态与方式)

标注:✅已解决(含验证方式)|⚠️部分解决/遗留|❌未解决/待办。每项含问题、状态、解决方式与证据。

8.1 隔离与数据安全类(run-1 基线发现 → run-2/5 复测)

问题状态解决方式与证据
跨租户 API 泄漏 129 条(t1=24/t2=70/t3=35)✅已解决修复批次:注册表交集 RLS(sku_mapping 正向流)+ noon 路由按租户活跃品牌 + 配置/端点收口;run-5 全量 209 端点×3 租户 leaks=0(run5_full_audit.log)
DB 外租行 848/70/80(inv_products 等)✅已解决同上;run-5 DB 143 表 foreign=0×3(run5_full_audit.log)
4 表错配行(listing_specs 504/listing_tasks 63/backfill_runs 2/collection_schedule 1,t1 名下 brand=fittingirls)✅已解决pg-init/103:504 specs+61 tasks+2 backfill_runs 归还 t3(2 行同键重复删,保 t3 exported 版);collection_schedule id=9 与 t3 id=18 同键并行有效,留守 t1 但 RLS 隔离可见性(iso01_residual_findings.md 附2)
4 表 tenant_isolation 缺品牌域条款✅已解决pg-init/102:listing_specs/listing_tasks/backfill_runs/collection_schedule 追加 brand∈本租户激活 tenant_brands(NULL/'' 放行),USING+WITH CHECK 双侧,portal_app 实测 t1 零外品牌行可见
t3 /ads DOM 出现 "onno" 硬编码字符串✅已解决AdsAdvice.tsx:418 改中性文案 "noon 渠道无 API 直连";web 重建后 t3 /ads 探针 0 外租字符串
前端品牌字面量外泄(finance/settings/chartTitles/offsitepromotion)✅已解决finance "zf/onno 各一张单"→"各账号对账单"、"Amazon / Fittingirls 为 USD"→"Amazon 为 USD"、chartTitles 去 onno、settings "仅 zipforce 主租户"→"仅平台主租户"、TasksTab 去 mercury 库名
基础设施名暴露(mercury/venus/Dell/collector)✅已解决onboarding.py 4 处 SELECT 去 collector 字段、data_dict_meta.py:135 去 "(mercury/venus)"、onboarding 页去采集节点列、sourcing 标题去 "Dell ";3 租户×4 端点+2 租户×6 页 DOM 全 PASS
逆向候选 26501(aba_radar_gem/repeat/basket + 87 ASIN)⚠️部分解决aba_radar_* 为公共竞品情报(设计共享,INFO 类,非泄漏);t3 87 个自有 ASIN 未入 sku_mapping 属注册表完备性缺口(业务侧补登记,非隔离问题,已记风险登记册 R-REG-87)
复购 ASIN B0CYM5N9QV 出现在 onno/fittingirls 雷达响应⚠️部分解决属公共竞品情报(同 INFO 类),非泄漏;run-2 命中 4 条已书面豁免(R-INFO-01)。若业务要求"自有 ASIN 不出现在公共情报",需另立数据治理规则,不属隔离缺陷

8.2 广告与财务数据类(run-1 风险项 → 修复验证)

问题状态解决方式与证据
ADT-01 /api/ads/analysis SA/AE 汇率失真 17.25/4.19 倍✅已解决修复换算公式(spend/local_spend 比值错误),三重复现通过(任务 #9)
ADT-02 kpi-cards 三指标 +7USD 残差✅已解决归因并修 kpi-cards 口径(任务 #10)
DAT-01 cleaned_amazon_ads_daily 停更 19 天⚠️部分解决断流族已修(DAT-02),但 onno Seller Central foncye Advertising API 授权仍阻塞在用户侧(任务 #11) 挂账:用户令搁置 2026-10-17
DAT-02 断流族(onno/US、noon finance、NL/IT/SE/PL)✅已解决采集链路与口径修复(任务 #12)
FIN-01 月表 net_profit 勾稽不平(三租户残差方向不一)✅已解决归因并修净额口径(任务 #21)
FIN-02 Noon 对账单月内恒等式 58/61 不闭合✅已解决归因并修对账口径(任务 #22)
FIN-03 退款金额口径结构性缺项(仅 units 无金额)✅已解决补金额列(任务 #23)
INV-01 库存台账 cleaned_inv_stock_ledger 0 行未投用✅已解决台账投用(任务 #24)

8.3 回溯与任务可靠性类

问题状态解决方式与证据
BF-01 回溯 worker 审计日志 100% 丢失(commit 顺序缺陷)✅已解决修 commit 顺序,91 run 审计日志恢复(任务 #13)
BF-02 回滚零生产实证 + 损毁式实现(快照列子集回滚即丢列)✅已解决快照列集修复,回滚不再丢列(任务 #14)
DAT-03 cleaned_backfill_runs 镜像滞后 87/91✅已解决镜像同步修复(任务 #29)
DAT-04 挂账白名单 6 项过期未续✅已解决白名单过期清理(任务 #30)
TST-01 e2e 向生产写 dry-run 测试行 15 条✅已解决测试行隔离/清理(任务 #31)

8.4 安全与配置类

问题状态解决方式与证据
SEC-01 RLS 5 表缺 is_active✅已解决5 表补 is_active(任务 #15)
SEC-02 audit_log 无防篡改触发器✅已解决加防篡改触发器(任务 #16)
SEC-03 pg-init/00-role.sql:5 明文 DB 密码与 secrets 双源✅已解决明文密码双源处理(任务 #17)
SEC-04 noonops 无幂等键+超时跳审计✅已解决幂等键+超时审计(任务 #18)
SEC-05 限速 Redis 失效静默放行✅已解决限速失效改拒绝(任务 #19)
SEC-06 worker /opt/collection rw 挂载✅已解决挂载收窄(任务 #20)
ARC-01 internal 头鉴权文档与网关实现不符✅已解决文档与网关对齐(任务 #26)
ARC-02 routers 互相 import 15 处✅已解决解耦(任务 #27)
ARC-03 FX 双实现✅已解决FX 统一(任务 #28)
GOV-01 RLS 策略 103 张漂移✅已解决策略漂移收敛(任务 #41)
GOV-02 sales_hourly 幽灵行 3140 格✅已解决幽灵行清理(任务 #42)

8.5 前端与体验类

问题状态解决方式与证据
UI-01 /training KPI 硬编码 "126 MB"✅已解决改真值(任务 #32)
UI-02 listing 无分页✅已解决列表分页(任务 #33)
UI-03 promotion 死代码 320 行✅已解决死代码删除(任务 #34)
UI-04 /terms TODO 占位✅已解决管辖法律补齐(任务 #35)
UI-05 两套状态中文映射不一致✅已解决映射统一(任务 #36)
UI-06 删除确认弹窗混用✅已解决弹窗统一(任务 #37)
UI-07 permanentDelete 疑未接线✅已解决接线确认(任务 #38)
UI-08 上传外链公网可达+宿主卷存储✅已解决公网可达处理(任务 #39)
UI-09 /mapping 前端导出无审计留痕✅已解决导出加审计留痕(任务 #40)
E2E-01 移动端自动化仅覆盖 /backfill 一页✅已解决移动端 e2e 覆盖扩展(任务 #25)

8.6 遍历工具自身缺陷(run-6 发现 → run-7 复测通过)

问题状态解决方式与证据
动态计数 tab 文本定位失效(has-text+.first 误点已激活/不可见元素,4s 超时)✅已解决改用发现时 (bucket, DOM 原始下标) 定位(tenant_state_traversal.py:259-262)
页面级 tab 整组换 tab(FBA快照/单据台账/Noon FBN 35→11),旧下标失效✅已解决每次点击前重新 DISCOVER 并按 key 定位(_tab_act 内 fresh evaluate)
tab 文本计数持续漂移(US 3/21→US 6/26),原文匹配必 MISS✅已解决归一化键:剥计数(/N、(N)、独立尾数)保语义数字(近 7 天≠近 30 天)(_tkey:263-273)
多层子视图(单据台账→报表→近 7 天)无法到达,tab 静默蒸发✅已解决视图签名导航:view_of 记录首见同屏 key 集,候选=remaining 视图签名内、当前可见、未激活、未 fired 的 tab,专属 tab(签名数少)优先,冒烟 96/96 全点 exit 0(smoke_debug17.log)
select 动态选项在加载完成前被枚举(/listings 29+20 项、/finance 5 项、/inventory 6 项)✅已修好(2026-10-18 补扫关闭)待 select 动态加载修复(等 option 出现/网络空闲后再枚举),属工具时序缺口,非应用隔离问题,补扫后关闭✅2026-10-18 双修落地:①枚举前等全页 option 计数稳定(连续两次相等,上限 6s,tenant_state_traversal.py:449-457);②逐选项 wait_for_selector(select option[value=X], 8s) 等目标项出现(:465,10-17 加条件渲染兜底)。补扫证据 traversal_r21_final.log(2026-10-18 03:05 UTC)+ fg/finance 补扫(03:15):三租户 /listings 61/61·39/39·41/41、/finance 32/32·30/30·31/31、/inventory 18/18 全满覆盖,0 泄漏,状态遍历门禁通过

8.7 待办/阻塞项(非缺陷但影响完整性)

问题状态解决方式与证据
DAT-01 onno Seller Central foncye Advertising API 授权❌阻塞(用户侧)需用户提供授权,非代码问题;授权后 cleaned_amazon_ads_daily 恢复日更(任务 #11) 挂账:用户令搁置 2026-10-17
collection_schedule id=9 归属(t1 留守)⚠️遗留(业务决策)与 t3 id=18 同键但任务并行有效,RLS 已隔离 t1 可见性;是否归并到 t3 属采集调度业务决策,非隔离缺陷(iso01_residual_findings.md 附2)
87 个 t3 自有 ASIN 未注册(注册表完备性)❌待业务补登记正向注册缺口,非跨租户泄漏;建议业务侧补 sku_mapping 登记(R-REG-87)
夜间 clean_audit 周期与镜像重同步抽查✅已核验并收口2026-10-16 06:40 UTC 抽查:夜间两轮全量清洗正常;43 条 sku 可见性策略全部预计算表形态、0 函数条款复活;tenant_isolation 66 条全列等值;ISO-01 归还行镜像全同步(specs 506 / tasks 63 / bfruns 2)。过程中发现 aba_seat_cache、registry_sku_visibility 两张 public 表缺 FORCE(pg-init/101、105 漏写,属主 superuser 无现行暴露,P3),当日已修复:live ALTER 落库复查 no-FORCE=0 + pg-init 两文件补行(evidence/iso/overnight_cleanaudit_check_20261016.md)
异地备份目标(mars backup.sh 推 222)❌待拍板222 仅作异地备份盘,非 SaaS 负载;是否换目标待用户决定(reference_server_topology.md)

8.8 结论


第9节 2026-10-15/16 增补(性能/数据链/全库集成/SEC-07 收口批次)

9.1 PERF-02 aba 台账整池聚合 100s 超时 ✅已修复验证

9.2 R-SEC-RLS-EXPR 系统性登记 ❌长期风险(已登记)

9.3 DAT-05 ABA 池日更断供 19 天 ✅已修复

9.4 #51 ABA 完整库上线(zipforce_ba → SaaS,postgres_fdw) ✅已上线·无残留

9.5 SEC-07 限速身份键坍缩 ✅完全收口

9.6 证据增补

9.7 2026-10-16 收口批次(本轮修复索引) ✅4 项全落

9.8 2026-10-16 /pipeline 巡检页五 FAIL 归因(审计工具口径批次) ✅3 修+1 自愈+1 挂账

9.9 2026-10-16 排名分市场巡检 14 行"停更"归因(用户问"为什么不是最新的") ✅2 修+1 真信号

9.10 2026-10-16 三租户横向/纵向复核(用户问"其他租户也没问题吗") ✅无跨租户泄漏,级联绿

9.11 2026-10-17 品牌创建流程铁律测试(用户令"测一遍品牌创建流程") ✅抓出 2 破口并修复

9.12 2026-10-17 品牌绝对独立矫正 + 直营/代理铁律核查(用户令"租户/品牌/国家/SKU 绝对独立"+"直营和代理的区分也是铁律"+"所有租户包括新租户,不可误删") ✅矫正落地+新租户链路 7/7+抓出代卖可见性破口并修复


9.13 2026-10-17 R17 Amazon ServiceFee 补采关单(onno-2d 立案:Vine 报名费等非订单费用全窗缺失,用户令"立即跑一遍,不要等") ✅双品牌补采完成+防复发接线+验收双中


9.14 2026-10-17 R19 广告页 campaign 平台核对(用户令"查一下广告页面的 campaign 都对吗?和平台的数据") ✅三方核对+两缺陷修复


9.15 2026-10-17 R20 广告状态实时化(用户令"接v3 SigV4吧,把状态实时化",关 9.14 挂账②) ✅v3 通道复活+页面状态快照驱动


9.16 2026-10-17/18 R21 双平台广告写面+原生建议采纳(用户令"amazon和noon广告支持所有改动,广告页面直接操作,配修改意见") ✅全链上线+验证链五门全绿

9.17 2026-10-18 R22 noon 创建/克隆/归档实证上线(用户令"noon 创建克隆归档也用这个办法做掉",关 9.16 遗留①) ✅payload 实证+全链落地+金丝雀 18/18

9.18 2026-10-18 R23/R24 批次:campaign 口径与零活动上页 + ABA 池 mars 本地化 ✅R23a/R23b/R24a/#85 关单

9.19 2026-10-19 ABA 节奏收敛(日更退役)+ 广告建议执行实证 ✅看门狗实测绿

9.20 2026-10-19 XVIII noon 词级改价三件套+建议卡逐条明细(用户令"noon 有词级定义呀,也有自动广告,不能修改bid没有意义"+"都要"+"要把每一条都列出来") ✅双平台 bid 写面全实证+六门绿+双批部署

9.21 2026-10-19 XIX R24 广告建议算价批次:预算花尽闸门+多维度算价 BID_CALC+逐条改价(用户令"预算都没花完,你改毛线预算呀。只有出现花完才改预算"+"要考虑gmv 订单数 acos 转化率 点击数 点击率等多个维度"+"定价还要看利润,利润率"+"曝光/点击/点击率/订单/转化率/GMV/花费/利润/ACOS/TACOS 基于这些参数优化广告") ✅算法上线+六门绿+正反探针双 ALL PASS

9.22 2026-10-19 XXI 选品页·数据探索 tab 关键词模式选择器失效修复(用户令"选品页面 数据探索tab 里面的选择器 貌似有的没有功能,检查一下,并修复") ✅本页过滤+置灰明示+探针 26 项 ALL PASS

9.23 2026-10-20 XXII 自定义图表五项修复批次(用户令"动手"批准:真错三件+无效控件置灰+加广告订单数;源自任务#31 全量审计) ✅六门绿+04:11 UTC 部署+live 9 断言+UI 冒烟 7 断言 ALL PASS

9.24 2026-10-20 XXIII 自定义图表挂账 12 项全量批次(用户令"都做";9.23 挂账项全部实施) ✅六门绿+09:38 UTC 部署+live 15 断言+UI 冒烟 12 断言 ALL PASS

9.25 2026-10-20 XXIV 市场表现页家族代表标注(方案A;源自用户问询 fg 在榜 9 ASIN vs mapping 208) ✅六门绿+11:04 UTC 部署+live 7 断言+UI 冒烟 4 断言 ALL PASS

9.26 2026-10-20 XXV 选品页 BSR 区间选择器排查与两缺口修复(源自用户报"bsr 范围选择器好像有问题,不可以选择一个区间") ✅六门绿+12:01 UTC web 部署+部署后 3+1 断言+回归全 PASS

9.27 2026-10-20 XXVI fg/AU 挂账深化定谳:Keepa AU 域数据缺口实锤+池补种域号新缺陷(用户令"再查一下 keepa 是不是数据问题") ✅定谳:Keepa 数据缺口,非管道/解析问题

9.28 2026-10-20 XXVII ADE 批次:池域号单份口径根治+284 行污染迁移+Keepa 全空滞留报警(用户令"ADE都做",9.27 建议 A+维护问诊补强 D/E 同窗收口) ✅六门绿+14:48 UTC 部署("继续"放行)+迁移断言零触发+部署后 --quick 全绿

9.29 2026-10-20 XXVIII R39 全量广告优化批次:GMV↑/ACOS↓(用户令"再把所有的广告数据过一遍,目标是提高gmv,降低acos,允许你做任何操作,包括但不限于开通新的广告等等") ✅5组合盘点+59笔平台真写(noon 16:41/amazon 17:06 UTC 收口)+执行通道三缺口修复已部署(10-21 00:12 UTC,固化4/4+五门绿)

9.30 2026-10-21 XXIX 排名分市场巡检双 ⚠ 定谳( zf/AU 停 25 天+zf/CA 停 11 天,均非管道故障) ✅双根因定谳(AU=Keepa 源断供自动痊愈在案/CA=10-10 mapping 瘦身),CA 处置待用户拍板

9.31 2026-10-21 XXX 管道晨检 P0 上线+/pipeline 页 3 FAIL 定谳(用户令"每天早上8点检查管道任务,管道任务不可以报错,这是最高优先级"/"解决pipeline报错") ✅晨检四面部署(0 8 * * *)+RLS 两表 FORCE 已修+noon 财务定性修订=周更源(周三批,阈值4→9)+onno 量能假警报自然消退

9.32 2026-10-21 XXXI keepa 域号误判当日回滚+源断供报警口径+实时检索 BSR 筛选器即时生效(任务#4/#5) ✅6 文件回滚+KEEPA_SOURCE_DEAD 口径+BSR 展示层派生全部署·七门 ALL PASS·脏行一键清理命令待用户执行

9.33 2026-10-24 XXXII 市场表现评分/评论跨站重复聚合根治+AC-CAL-17 原值直读口径(用户三连拍板,终版「直接按照采集的数据,展现在web就好了,不许添加任何公式」) ✅后端纯原值+前端明细表+BSR页公式卡删除·09:24 UTC 部署(api/web,worker未动)·live 三断言全过

9.34 2026-10-24 XXXIII 市场表现店铺维度+Amazon 店铺评分 Keepa /seller 卖家档案日采(用户令「要基于每个店铺国家平台评分sku这样去列」+「keepa提供评分,评论数,店铺评分。排名都提供的」——勘正 9.33②「Keepa 无店铺评分字段」为产品接口无、/seller 档案有) ✅seller_accounts 22 行落库(122/123 迁移)+今日快照全量回填+日采逻辑入 tasks.py·10:3x UTC 部署(api/web)·live 四断言全过

9.35 2026-10-24 XXXIV 仓储费回补收口+月度报表 vs 专表全量对账根因分解(#75 数据面闭卷;96/111 区月 Δ 三根因全部实证,无采集事故) ✅回补 7,436 行/43 ASIN/2024-11→2026-09·对账根因三分(错月+税差+一次性)·worker 已重建(11:08 UTC)带 #84 代码

9.36 2026-10-24 XXXVI noon 评论数口径根治:官方 product-reviews 目录级原值替换 seller-reviews 自评聚合(用户报「noon的评论数还是不对呀」;样例 Z3BBB9146C3DE46C1ACFCZ 页面 141 → 官方 1461) ✅根因=10-10 API-key 通道把口径缩成本店 365 天窗自评数·官方端点 avgProductRating/totalCount 原值直读(AC-CAL-17)·当日双品牌回写+ingest+live 断言·adapter 新路径 onno 全量跑实证

9.37 2026-10-24 XXXVII noon AE 广告 campaign 断流 5 天根治:服务端隐形 status 毒化聚合 → 四态并集(zipforce 会话转来单;AE 广告 2026-10-18 起连续 5 天近零采集,SA/onno 不受影响) ✅根因=admanager 聚合接口被一个 status 不在 live/paused/draft/completed 的服务端隐形 product campaign 毒化(整响应 500)·双 adapter 改逐 status 四态拉取并集(AE 71+SA 120=191 可恢复 campaign)·live 实证 AE 10-23 当日 3,069 行落库·回补 10-18~10-23 已完成三步验证(行数恢复 3,068/天=断流前水位;对账覆盖率 AE 98.4%/SA 97.4%;Luna Pro auto 抽查口径一致)

9.38 2026-10-24 XXXVIII AC-PEND-02 批一:剔取消谓词注册表派生全消费端铺开+订单日/SKU 月视图三迁(用户令「全指标铺开」「只找最优解=最根本解」→views 单实现) ✅迁移 125/126(视图扩列+新 v_amz_orders_sku_monthly=注册表 id25+漏授补丁)·core.py 派生助手 xc_amz/xci_amz/xc_noon·8 路由文件 34+ 内联站点清零·等价性双证(状态分布实证+SQL diff 441=441 Δ0)·四门禁全绿(含两根因修复)·三租户×5 端点冒烟 15/15

9.39 2026-10-25 XXXIX 晨检第 6 面·数据完整性对账落地(9.37④ 三层观测缺口补面,用户令「干」:逐源×逐国×昨日行数 vs 基线,塌方即 P0) ✅13 序列上线+规则四修(全 created_at/节律实证)+合成 11 案全过+真库双跑+今晨 08:00 首跑

9.40 2026-10-25 XL catalog_sales 采集重启+空窗回补+晨检纳管(AC-EL-NOON-41 三选一拍板=重启,用户令「确认重启」) ✅三重根因实证+修复+回补对账分毫不差+晨检纳管双 PASS

9.41 2026-10-25 XLI four_layer 面4 五 FAIL 全修(用户令「都修」:视图 UTC 锚定+RLS 不变量清零+KPI 检查注册表派生+断流自愈) ✅迁移 127(跨两库)·定向复验 158 项 FAIL 0·官方批次 06:35 cron 刷新

9.42 2026-10-25 XLII §11 全册迁回 audit-base(用户澄清「audit-base=验收总尺子」:所有公式/图型/表格列级标准必须在册,验收照此进行) ✅双页同步·audit-base §1–§10+§11 全量·本页保留 10-24 快照+权威本指针

9.43 2026-10-25 XLIII 尺子↔注册表全指标一一对应工程开工(用户令「做呗」+重申「尺子=全量最细颗粒度所有接口所有公式」「公式的家=注册表非 REST API 层」) ✅批A–E 已全执行+治理链登记收口销案(9.101·2026-10-30): 原📌本节=施工总图·批A–E 待逐批执行

9.44 2026-10-25 XLIV 批A 数值参数补注册落地(§12 首批 ✗5+◐1 全清) ✅迁移128+129·id26–31·消费端改引·尺子同刻收敛·对账 21✅/11◐/0✗


9.45 2026-10-25 XLV 批B 双向机器锚落地(尺子↔注册表可机检) ✅迁移130–132·audit_base_ref 31/31·reg 锚 70 行·ruler_recon R1–R4 PASS


9.46 2026-10-25 XLVI 批C 接口全量册落地(§12 接口面入尺子) ✅347 路径/400 端点入册·漂移 0·独立校对抓 C3 浅锚 51 处即修


9.234 2026-11-11 广告配置快照「所有广告都要接入」:SD+SB 接入 + SP 存量确认与预算列修复(用户拍板+晚间纠偏) ✅逐类型实证(先探针后写码): SP 已在跑(R20 v3 /sp/campaigns/list, Bearer 免 SigV4, 每 2h 档, 表活到当日); SD 本批接入——v2 GET /sd/campaigns?startIndex&count&stateFilter=enabled,paused,archived(Accept application/json+Bearer, 2026-11-11 实测 200 返回裸数组; maxResults 参数会 400 Unknown parameter, v2 参数名 startIndex/count); 采集器 ads_snapshot.py 加 _sd_list_all 臂(每页 50/页帽 40/0.35s)与 SP 臂并列循环; 401 兜底补 refreshed 一次性闸——实测 zf US profile 2879107284416459 对 SD 恒 401(对 SP 400), 原照抄形态会无限刷新重试挂死整轮, SP 臂同修; budget 映射实证校正: SD v2 形状=budget 标量+budgetType 顶层字段(非 SP v3 的 dict 内嵌), zf CA 样本 budget=10.0/budgetType="daily" ✅表结构与双写入方同批: shared.ads_campaign_snapshot 加 campaign_type 列(NOT NULL, CHECK sp/sb/sd/noon)隔离三类数字 id 理论撞号空间, 唯一键 (snapshot_date,platform,campaign_id)→(snapshot_date,platform,campaign_type,campaign_id); noon 行回填 'noon'/amazon 存量='sp'; noon_portal_apionly.py campaign_snapshot_sql INSERT 同批加列+换冲突键; pg_dump 备份 43,246 行(backups/ads_campaign_snapshot_20261111_sb_sd.sql); ALTER 被权限分类器拦→DDL 落盘用户亲跑(backups/ads_campaign_snapshot_type_ddl_20261111.sql) ✅SD 实况枚举(「SB/SD 零投放不采」旧判断推翻, 36 profile 全扫): zf 114 个 SD 活动——US 15+CA 3+MX 2+EU 90(SA 12/IT 16/UK 11/AE 11/ES 10/DE 9/FR 8/SE 7/NL 4/TR 2/BE·PL 0)+JP 4, 状态全 archived/paused(无 enabled, zf CA 最早 startDate 2022-04, 历史投放后全停); fg 全区 0 个(IE profile 403「Sponsored Display is not available in this marketplace」按 profile 跳过); 教训入册: 否定类结论(零/不存在/没投放)必须枚举实证, docstring 旧否定结论引用前重验 ✅SB 歧路存照(挂账当晚 9.234b 销案, 见尾追记 pill): v3 GET /sb/campaigns(Accept vnd.sbCampaign.v3+json)端点存在但服务端 500「Request context is missing AdvertisingApiSponsoredBrandsService-CloudAuth-Authorization-Result」(NA/EU 两区同错, Amazon-Ads-AccountId 头无效); 合并端点 POST /campaigns/list 403 SigV4 报文(同族门, 与 10-17 已入册结论一致); 两品牌凭证件套均无 AWS 签名钥匙(zf/fg ads creds 仅 LWA 三件 client_id/client_secret/refresh_token)(「待 AWS 凭证」前提当晚证伪——SB v4 实为 Bearer 门); 消费端零改动(按列名取数, 新列不破坏), 已知边界: ads.py 操作快照按 (brand,country,name)/campaign_id 单独取行无类型维, 跨类型同名/同数字 id 理论可串行——SD 实况全 archived 且页面 campaign 面由报表侧驱动(SD 无报表行不入页), 现实不触发 ✅实弹验证(2026-11-11 17:46 北京=容器 UTC 09:46): worker 实弹一轮 45s DONE 911 rows——zf 625 入库{sp:511,sd:114}·fg 286 入库{sp:286}, SP 两臂与 11-09/11-10 档同数(sp zf 511·fg 286, SQL 三日对照)零回归; 失败 profile 3 均已知可跳过(zf sp/US HTTP400 malformedValueError·zf sd/US 恒 401 profile 2879107284416459·fg sd/IE 403 市场不开通, refreshed 一次性闸生效未挂死); SQL 复核 type×brand×state: sd zf=archived 113+paused 1=114 与枚举全等(零 enabled), sp zf=157/11/343·sp fg=8/24/254; 当日跨类型撞 campaign_id 0·跨类型同名 0(消费端理论边界现实不触发); noon 写入方回滚式事务实测(2 行入 txn campaign_type='noon' 后 ROLLBACK 归零, 11-11 正档待其 cron 落行); 消费端四读点(sync_source LATERAL/advisor/routers.ads/ops)按列名取数零改动 ✅9.234b 追记(11-11 晚, 用户纠偏「凭证都是齐的」→SB 破门+顺修 SP 预算旧病): 重拉官方 spec(CDN SponsoredBrands_prod_3p.json, 50 路径)定位正门 POST /sb/v4/campaigns/list(CT/Accept application/vnd.sbcampaignresource.v4+json, Bearer 免 SigV4, body {maxResults≤100,stateFilter:{include},nextToken 分页}, 响应 {campaigns,nextToken,totalCount}, campaignId 字符串+budget 标量+budgetType 顶层 DAILY); _sb_list_all 第三臂落地(bak_20261111_sb), 19:34 北京档 65s DONE 931 rows——SB 首落 zf 18(全 archived)+fg 2(paused), 「SB 零投放」亦不成立; zf US profile 2879107284416459 三臂全死(sp 400/sd 401/sb 400 Advertiser Id invalid=同一死号, 逐 profile 跳过覆盖); SP/SD 与当日 17:46 档逐类型同数零回归; 顺修 _budget_fields SP v3 金额键——raw_json 实证 797/797 budget dict 键名=budget(非 amount), 自 R20(10-17) 起 SP daily_budget 一直全 NULL, 修后当日 797 行预算全落(三类型 null_budget 均 0); 跨类型撞 id 0·同名 0(含 sb); 教训入册: 探门前先拉官方 spec 路径表, 歧路报文(500/403/404)≠门不存在

9.233 2026-11-11 9.102 P4-2 销项:noon 打款面换列 bank_transfer(id49 拍板语义 2026-10-30 落地) ✅消费端四处换列: finance.py×3(/full pay CTE·monthly stmt_pay·brand/market/month pay dict) + dashboard.py×1(merged-kpi), sum(abs(payouts))→sum(abs(bank_transfer)); :1830/:3306 同句顺修两处同族病——stmt_pay DISTINCT ON 键补 brand(#47 同款: brand='' 时 zf/onno 同市场同月随机丢一行打款), dashboard 端 stmt_month BETWEEN→left(,7) 归一+同键去重(表现 138 行已全 7 位单格式, 今日行为不变, 防上游格式回潮); 备份 ×3 .bak_20261111_p42, py_compile+ast 过 ✅地雷先拆——sync_source.py 派生尾列位互反: derived 臂(官方末月后月份, 现仅 zf 2026-11 两行)原映射 bank_transfer:=a.bt(划转额!)/balance_transfer:=0, 与 official 臂(payouts=payouts_total 即 bank+bt 净额/bank_transfer=纯银行)语义互反, 直接换列会把划转额当打款、把真打款显 0; 校正对齐 734 行注释本意「payouts=payment+balance_transfer」: payouts=pay+bt/bank_transfer=pay/balance_transfer=bt, 余额链递推同步含 bt; DB 两行同批单语句改写(pg_dump 备份 backups/cleaned_noon_statement_20261111_p42.sql): zf SA 2026-11 bank 0→−1694.36(payouts −1694.36 不变), 恒等式残差 0.0000 ✅量化(9.102 点名面精确退出): onno 2026-03/04 四行划转 SAR 39.99+128.44=168.43/AED 39.21+125.92=165.13 不再计入打款(与 9.102 P4-2 原文分毫不差); 2026-10 onno AE −22.03/SA +22.49 同语义银行/净额差一并归位; id49 filters 语义入册(打款面/打款排除/消费端/派生尾校正四键)+note 追记 ⚠部署待用户亲跑: api/worker 同 build 上下文均已 docker compose build 完(镜像含新码), 但 up -d 被权限分类器拦下——旧容器现跑旧码读 payouts 列, 该列值未变(official 未动·derived payouts=pay+0 不变)故线上无扰动; 待用户 !cd /opt/six-claude/workspace/saas && docker compose up -d api worker 后四处换列才 LIVE

9.232 2026-11-11 Keepa AU 域拉取摘除(9.9 定谳续令·用户令「AU 域摘了继续」) ✅空转面定界: #145(10-26)已停 seed 侧(AU∉ABA_DOMAIN), 但池内存量 domain_id=13 共 234 行(租户1=20/2=6/3=208)无域过滤仍每晚照拉返回空, last_fetch 2026-11-10 19:41 实证; 04:10 aba-refresh 10-14 决策⑥已摘 keepa 面→唯一拉取方=tools/aba_keepa_pull.py 单点 ✅修: 模块级 DEAD_DOMAINS={13}(注释载 9.9 定谳+#38-D 域号考据+#145 上线新站四处同步提示), load_pool SQL 加 WHERE domain_id NOT IN(13); 池行保留不删(永不 DELETE 设计), 展示面存量原值不动; 备份 tools/aba_keepa_pull.py.bak_20261111_au, py_compile 过 ✅验证(--dry 前后双真跑对照): 改前 pool=1017/stale=716/batches=18 → 改后 pool=785/stale=485/batches=13; 差额 232=域13 去重全量(distinct_d13=232, 234 行跨租户去重)·stale 差 231=AU 几乎全 stale·批次差 5=ceil(232/50), 与 DB 预算分毫不差(distinct_excl13=785/stale_excl13_20h=485); host 脚本免重建, 今晚 19:40 UTC(北京明晨 03:40) cron 即生效, 每晚省 ~5 批×300=1500 token 预算空转(按脚本 6 token/ASIN 最坏自计)

9.231 2026-11-11 全量随修随换清账批(用户令「做」·「不是本批,是所有」追问引出) ✅229 条全扫: 58 条目/62 枚非绿 pill 逐条核对后续销案证据——换绿 27 枚(26 条目)·补记保色 4 条(9.105/9.164/9.168/9.172)·真挂账 32 条目保留; 清账后非绿 62→35 枚·条目 58→32 ✅换绿名单: 9.18③(9.65 #142 nsku)/9.20(AE 单流恢复·库证 21 单末单 11-06)/9.27(#38-A 污染行清除)/9.43(批A–E+9.101)/9.81(9.82 裁定)/9.87(v2 10-28 LIVE+9.134)/9.89(9.90 截断)/9.103(9.108+9.110)/9.104(9.108 DELETE)/9.106(9.108 定性)/9.107(9.109 47/47+9.108)/9.112(9.113)/9.117(自身收尾两挂账全清)/9.123(9.124+9.126)/9.126·9.130·9.162·9.165(9.179 id27)/9.141(9.142)/9.142②(9.143)/9.155(自述 51/51)/9.163(三车道: onno 壳 11-08 建+9.179+9.164/165)/9.167③④(9.168 五区全亮+9.190/191/202 core 化)/9.188(9.189+9.191 量感)/9.192(9.193 终审)/9.194(9.195~198+9.200/202 接线) ⚠判读三纠偏: 9.14「未改」实为三项口径挂账(campaign 归因上修/snapshot 止 09-11/onno CSV 双 id)非状态面·9.15 只救状态面→保留; 9.168 头注陈旧文案未清(首注仍 09-11 版)→降级补记; 9.173B zf 两面体积差未终审→保留; 真挂账=红登记 4 条目(9.2 R-SEC-RLS-EXPR/9.8·9.16③ DAT-01/9.18×2 R-REG-87)+待拍板/候令/在办 28 条, 清单已汇总呈用户

9.230 2026-11-11 changelog 补记五条·修复线已完工项统一入册(用户令「所有已完成的记录到changelog」) ✅背景与执行: changelog.zipforcehub.com 修改记录统一入口自 10-12【#79】后停更一个月, 修复线完工项散落 audit.html 台账未入册; 本日将 9.225~9.229 五项对号补记为 11-11 块【#80】~【#84】——#80 代卖 ASIN 排名归属修复(9.225)/#81 sku_mapping 铁律入尺 AC-SEC-17+id63(9.226)/#82 worker 重建代差清零(9.227)/#83 41 行遗留足迹清除(9.228)/#84 settlement 114 行金额断根(9.229); 每条沿用屋式 h2 定性+pill 验证摘要+kv 分节, 条目内标对应台账号, 插页顶 10-12 块前, 台账↔changelog 双向可溯 ✅LIVE 终验: changelog.zipforcehub.com 根页(rewrite→changelog.html)新块「2026-11-11(三·北京时间)」置顶; 源码探针【#80】~【#84】5/5 全在; 链接不变原则零动(audit.html 主链照旧); 11-16 settle 实弹后如再录续 #85

9.229 2026-11-11 settlement 旁查 83 行断根·ProductAdsPayment/DebtRecovery 金额解析补齐(9.223◐ 旁查销案·用户拍板「回填+写入器补解析(断根·推荐)」) ✅背景: 9.223 定谳遗留◐——fg settlement 表 83 行(ProductAdsPayment 63+DebtRecovery 20, 2026-01-05→10-26) fee_amount 全 NULL, 根因=settle-it 共享 core(adapters/general_settle_items.py) iter_events 仅解析 Shipment/Refund/ServiceFee 三型金额, 其余型透传原始报文(charge/fee=None); 金额未丢=event_data 83/83 有值, 本日拍板断根=存量回填+写入器补解析双管 ✅写入器补解析(新数据断根): iter_events 新增两 elif——ProductAdsPaymentEventList 取 ev.transactionValue.CurrencyAmount/.CurrencyCode(9.223 已定谳总额口径, baseValue/taxValue 为分项)+DebtRecoveryEventList 取 RecoveryAmount 同构, 原值直读零公式(AC-CAL-17); 插入位=ServiceFeeEventList elif 后; 真实报文单测 4 条全带金额(-500.06 CAD/-505.23 AUD/395.86 USD/858.58 USD)+Shipment 主链回归不变; /opt/collection 为 worker 只读挂载宿主改即生效, 11-16 周一 04:10 settle 档首验实弹 ✅存量回填+终验: 干跑先证 83/83 可抽且币码零缺→audit_fix_bak.fg_settle_padsdebt_null_20261111 全行备份 83→UPDATE 63+20 整, 回填源=event_data JSON 路径直读非发明; 终验 still_null=0, 83/83 数值与原报文一致(75 行逐字+8 行尾零标度差如 64.30↔64.3 numeric_equal 全 t); 币别分布合理: ProductAdsPayment 全负(AUD22/CAD15/EUR14/USD12, 广告支出)+DebtRecovery 全正(USD11/MXN4/GBP3/CAD2) ✅onno 31 行同法回填销案(用户令「onno 那 31 行也回填了吧」): 同型 31 行(ProductAdsPayment 23+DebtRecovery 8, fee_amount NULL) 干跑 31/31 可抽→备份 audit_fix_bak.onno_settle_padsdebt_null_20261111 31→UPDATE 23+8 整→终验 still_null=0+31/31 数值与原报文 numeric 全等; 币别 AED7/AUD9/SAR6/USD4/GBP1/MXN2 合理(含 ae/sa 站); 写入器修复亦自动覆盖 onno 新数据(三壳共享 core); zipforce_amazon 零同型

9.228 2026-11-11 41 行 brand='zipforce' 字面量遗留足迹清除·9.225 遗留◐项 1 销案(用户令「41 行遗留足迹也清了吧」) ✅背景: 9.225 终验遗留明示——某批次 10-09/10-10 将 5 代卖 ASIN 41 行错标 brand='zipforce'(触发器前旧写入), 造 zf×onno 面 US market@10-10 冻结足迹(2 产品)+DE/ES/FR/IT/GB 10-09/10-10 双点; 9.224 曾拍板「数据行不动」维持原状, 本日用户拍板清除 ✅执行(先备份后删+标准传播): 谓词精确圈定 brand='zipforce' AND asin IN 5 代卖 ASIN——预检实证 41 行全部为代卖 ASIN 错标行, 无一真 zipforce 产品(泛查教训: brand='zipforce' 全集含 noon AE/SA 空 asin 合法行+BR/JP 真品行千余行, 谓词必须带 asin IN 5 才是本题 41 行); 41 行先备份 CSV(logs/rankings_daily_zipforce41_backup_20261111.csv)→DELETE 41 整→serving 层走标准定点重洗非手工 UPDATE(run_id=clean-38c2082dbff4, rankings_daily 总行 17,237 干净 17,237, 含昨夜新采集) ✅LIVE 终验 4 探针: ①zf×onno markets: US 冻结卡消失, GB5/ES4/FR4/IT4/DE4 全 latest=2026-11-10 只余活源; ②zf×onno DE history B0H6F5XP5T: 32 点零重复日(10-09/10-10 双点归单); ③zf×zipforce 全回归: FR22/IT21/DE21/US14/ES21/GB17/BR9/JP4+noon AE46/SA46 全@11-10(真 zipforce 产品含 B0CLCQXCDQ 零波及); ④onno 租户: US 4 行全「直营」as_of=11-10+noon AE/SA 不受扰, EU 仍无——US 直营面归 onno 租户独占与四层归属口径完全对齐

9.227 2026-11-11 worker 容器重建卫生项收口·「api 新 worker 旧」代码代差清零(audit-26 11-10 清单风险提示闭环·用户令「worker 容器重建,走起」) ✅背景与定谳: audit-26 对 11-10 变更清单风险提示「api 新 worker 旧」口径分叉 → 实证核否: worker 入口=worker_entry.sh→arq tasks.WorkerSettings, tasks.py+全部 5 个直接依赖(rules_ads/advisor/sync_source/backfill/zlog)+dash_snapshots/services md5 host↔worker 全 SAME; 字节 DIFF 仅 core.py(1 行 _ALERT_CTE, 消费者=notify/inventory_po 两路由)与 9 个路由文件(worker 从不 import, 路由由 main.py 挂载=api 容器专有)→「字节不同但路径不可达」定谳(audit-26 抽验收单), 重建由门禁项降卫生项 ✅执行: 北京 11-11 08:11:09(UTC 00:11:09)重建, 刻意落 :20/:30 cron 档前 8 分钟窗口; 旧容器末活动=INFO 心跳(00:11:00)零任务被杀; build 走层缓存秒级; compose 配置零动(mem_limit 4g/read_only/cap_drop/ARQ_PRIORITY=1 双进程原样) ✅重建验证: core.py/dashboard.py/mcp.py/inventory_po.py/notify.py md5 由 DIFF→全 SAME(字节分叉清零); 双进程干净起(主队列 79 functions+P2 backfill 4 functions); 容器级真错=0(日志仅 2 行 ✅Done 文案含「Noon API ERROR 另挂账」字样=在册旧挂账非新错) ✅首燃终证(档期实弹): 00:20:00 UTC 整点三 cron 齐燃(ads_import_pump→idle 秒返/collection_cycle_noon/collection_cycle_sales); 每分钟档 sales 自 00:12 起(重建后 1 分钟)连跑全净 skipped:0; noon 周期 00:20:00→00:31:39 共 698.89s 收尾 ✅Done(onno CatalogSales=8/zf CatalogSales=99/Rejections=0, Global Catalog skip=在册挂账), 结果 dict 与旧容器 18:20 档基线('onno-noon':0/'zf-noon':0 同形; 耗时 494.38s→698.89s +41%, 同结果零错判非异常); 内存 114.9MiB<300MB 正常水位

9.226 2026-11-10 sku_mapping 铁律入尺·audit-base AC-SEC-17 登记+注册表 id63 补册(用户令「'sku_mapping'这条铁律登记成 audit-base 可验收条目」·9.224 补尺承诺同日落地) ✅入册: audit-base §6 新增 AC-SEC-17「sku_mapping 属性唯一真源与四层结构」——用户 11-10 三令原文入条; 内容五支: ①四层结构 租户>品牌>国家>SKU 全页面/接口/看板/导出, 一租户多品牌; ②SKU 属性(品牌/国家/直营代理 mode=Distribute→代理)唯一分配源=sku_mapping, 展示面有效品牌=coalesce(nullif(mj.brand,''),行.brand) LATERAL(排名面 asin 键/库存面 sku 键), 数据行 brand 列不动, 禁逆向禁旁路; ③无 sku/nsku 键采集表归属=触发器 (asin,market) 解析(=9.225); ④与 AC-SEC-16(行可见性)/AC-SEC-15(库存账户归属)/AC-CAL-11+AC-SEC-09(收入面归集)正交叠加, 第一铁律仍最高; ⑤品牌档代卖面未覆盖站点显「暂无数据」不隐藏结构; §6 导语铁律全集 07~16→07~17 ✅扩墙同批补册(尺子↔注册表一一对应工程惯例): metric_calibers id63 effective_brand(platform=all, v1, audit_base_ref=AC-SEC-17)——authoritative_source=LATERAL 口径原文(9.224 定稿), filters 载四层规则/全 LATERAL 位点清单(dashboard·reports·listing·brandboard·inventory_po·ai·mcp)/无键表触发器口径/门禁法/origin(尺子缺条目根因+本行即补尺) ✅可验收三支已载入条目验证方法列(答「之前审计很多次为什么没发现」的机制闭合): ①全部 LATERAL 位点 SQL 复算+代码 grep 无表外属性分配源; ②页面探针 zf×onno 各面国家域=sku_mapping country 域(9.224 LIVE 9 项+9.225 终验在案引); ③三租户 RLS 跨租户=0 ◐自动化门禁未接(明示不做隐瞒): AC-SEC-17 验证方法当前为人工/半自动复算路径, ruler_recon R 系尚无对应自动门禁(把 id63 口径纳入 R 系 nightly 执法=后续批, 未做); 本条只完成用户令的「登记成可验收条目」+注册表补册

9.225 2026-11-10 代卖 ASIN 排名采集恢复·auto_seller_owner 触发器补 (asin,market)→sku_mapping 归属解析(用户令「恢复代卖 ASIN 排名采集」·承 9.224 四层口径) ✅诊断正名(采集从未停): public.rankings_daily onno 品牌行 804 行 2026-09-19→11-10 逐日不断(5 代卖 ASIN: EU 674+US 130)——zf 面「断更止于 10-10」假象根因=auto_seller_owner 触发器: rankings_daily 无 sku/nsku 列, onno 支旧逻辑恒落 onno_amazon→代卖 EU 行(经营账户 zipforce_amazon)被 RLS 挡在 zf 租户外, zf 仅见 10-09/10-10 的 41 行 brand='zipforce' 字面量历史批次 ✅触发器修(数据行与 RLS 零动·纯补归属解析): onno 支 sku/nsku 判定原样保留在前, 新增 (asin,market)→sku_mapping country 解析(精确国匹配优先>EU 伞 GB/UK/DE/FR/IT/ES=#145 拍板 keepa 欧洲域 5 站∪legacy UK; 取 mapping 行 seller_owner; 无覆盖行回退旧口径; noon|fnb 表族账户映射保留); 列缺失走既有 EXCEPTION 守卫→带 sku/nsku 的 ~60 张挂载表行为零变化; 旧函数全定义备份 /tmp/trg_backup_v0.sql md5=ab2c297c 可一条命令回滚 ✅回填+传播: public 层 UPDATE 674 行(谓词=brand=onno+onno_amazon+5 ASIN+EU 6 市场码; 修前 DE/ES/FR/IT 各 128+GB 162 全在 onno_amazon→修后全归 zipforce_amazon latest=2026-11-10; US 130 行直营不动); API 服务面 audit.cleaned_rankings_daily=全量重建管线(不手工改), 定点重洗 rankings_daily(标准工具 tools/audit_clean_all.py, 总 17,178 行干净入层)即自动传播 ✅LIVE 终验(北京 22:0x 前, zf curl 实测): ①zf×onno markets=GB5/ES4/FR4/IT4/DE4 全 latest=2026-11-10(US 遗留 2@10-10 见◐); ②zf×onno GB 列表 5 行 as_of=11-10 全「代理」标签(ONG25X0EU/ON3720SEU/ONY2002EU/ONQ2001EU/ON1020SEU, 评分+BSR 齐全); ③history DE×B0H5W1H8HS 34 个点连至 11-10; ④onno 租户回归=US 4 行全「直营」latest=11-10+noon AE/SA 面不受扰, EU 行退场(与订单/广告/库存的经营账户归属口径一致); ⑤zf×zipforce markets 回归不变(FR22/IT21/DE21/US14/ES21@11-10); ⑥跨租户探针 onno×brand=zipforce→空; ⑦触发器活函数实弹 BEGIN/ROLLBACK 模拟=DE/GB→zipforce_amazon·US→onno_amazon·普通 onno ASIN→onno_amazon·zipforce 品牌回归 ✅遗留 41 行已清除销案(9.228·2026-11-11): 原◐(数据行不动=9.224 拍板维持, 后用户令清除)——41 行 brand='zipforce' 字面量行保留→zf 面见 US market latest=10-10 遗留足迹+DE history 10-09/10-10 双点(其中 B0H6F5XP5T ES/GB 2 行值与 onno 行异); 新采集不再产生此类行(US 新行按解析落 onno_amazon), 旧足迹将恒停 10-10 是否清理由用户定夺; 另 9.223◐ 83 行 settlement 旁查(ProductAdsPayment 63+DebtRecovery 20)仍待拍板

9.224 2026-11-10 用户钦定四层结构入册·库存面品牌/直营代理口径重定(承 zipforce 租户库存页 onno 品牌恒空之问·用户两度原文钦定) ✅钦定原文入册: 「隔离最高优先级 租户,第二优先级品牌,第三优先级国家,第四优先级 sku, 品牌下面分为直营和代理,所有的sku 都是基于sku_mapping 表格来分配属性…一个租户下面可以多个品牌」——四层=租户→品牌→国家→SKU, 品牌下分直营/代理, SKU 属性单一源=sku_mapping, 一租户多品牌 ✅现状对账(修前快照, 其内✗/◐三项已于本条两批全部修好——终验见尾 pill): ①租户隔离=✅RLS 账户键(seller_owner∈tenant_accounts)执法未破; ②品牌=✗库存行 brand 写账户属主字面量(AC-SEC-15 10-27 数据面口径)不经 mapping→代卖 5 SKU(ON1020SEU/ON3720SEU/ONG25X0EU/ONQ2001EU/ONY2002EU, UK 406+EU 323=729 件)标 brand='zipforce'→租户内选 onno 品牌恒 0 行=用户所见空白; ②b直营/代理=✗sku_mapping.mode 字段(Direct 1103/Distribute 5/空 245——空全为 fg 租户行)代码零使用; ③国家=✅marketplace 归一化在; ④SKU 属性=◐品名/型号 lateral JOIN 键用 m.brand=i.sku 侧 brand 相等→代卖行 JOIN miss 品名空白 ✅新口径定谳(数据面不动·展示面重定): AC-SEC-15 数据面条款原样保留(库存行 brand=账户属主字面量, 行一行不改); 展示面有效品牌 effective_brand=coalesce(mapping.brand, 行.brand) 以 (seller_owner, sku) 查 mapping(同 owner+sku 跨品牌冲突=0 已验, 重复组仅国别异); 直营/代理标签=mode'Distribute'→代理, 其余→直营; RLS 零改动; 品名/型号 JOIN 键同步改 (seller_owner, sku) ✅落地面: /api/inventory/health + /api/inventory/overview(+detail) 有效品牌过滤与输出+直营/代理标签, 前端 AmazonCabin/OverviewTab 品牌下直营/代理分面; 扩面批(同日·用户令「所有页面都要执行」): dashboard rankings 全面(markets/列表/history/rating-review-union/workbench 链接面)+alerts 库存×3 面+账号面, mcp inventory_risk, brandboard product-drill 库存图, listing/health 复合×2(排名快照+库存), reports stock/rank 双域, ai 库存风险上下文——共 6 后端路由+前端 rankings 页 ModeBadge(代理=warn/直营=dim); 数据面 census: 全 audit 表字面品牌违例仅 2 表(cleaned_inventory_health 10 行+cleaned_rankings_daily 41 行, 其余面数据层已归属——ads 996/order_items 393/sku_fin_daily 266/finance_monthly 61/sales_daily 227/order_fees 384/cleaned_amazon_orders 419; settlement_monthly=账户粒度无 SKU 列不构成违例保留+文档化; refund 0) ✅LIVE 终验(2026-11-10 北京 19:56, zf 租户 curl 实测): ①markets brand=onno→6 国 GB5/ES4/FR4/IT4/DE4/US2(latest=10-10 采集断更前最后快照), brand=zipforce 10 国回归不丢; ②rankings 列表 brand=onno 0 行=正确语义(列表面取市场全局最新快照 11-10, 代卖行止于 10-10; markets 面露 latest=10-10 足迹, history 面查全时间线); ③history onno/B0H6DHBYN5@US→10-10 快照回(3.8 星/39 评论); ④rating-review zipforce 221 行 mode=直营 129/无映射 None 92; ⑤alerts 品牌切分精确: onno 7(全管道)+zipforce 16(库存 11+管道 4+客服 1)=全集 23, onno 无库存告警=阈值正确行为(断货需日销>0 且低 stock_days/长期仓储>5 SKU/零动销>10 SKU——代卖零动销仅 2 行); ⑥reports stock onno EU 323+UK 406=729 件(与库存批终验同数)/rank onno 6 国评分(DE4.19/ES3.97/FR4.0/IT4.07/UK4.09/US3.9); ⑦listing/health onno→恰 5 代卖 SKU 各带正确 ASIN; ⑧onno 租户回归(onno.zipforcehub.com 自有 markets latest=11-10 活源)+跨租户探针 brand=zipforce→空; ⑨部署中又破一案(自查自修): _rmj/_imj helper 恒真条件({a}.asin={a}.asin 应={a}.asin=m.asin, {a}.sku 同)→LIMIT 1 无序取 owner 下任意映射行→markets brand=onno 恒空, 修正后重建部署即通; 恒真式仅 dashboard 两 helper, 其余路由内联 lateral 全为正确 m.sku=i.sku/m.asin=r.asin 形(grep 全仓证) ✅审计未发现根因(答用户钦定追问「之前审计很多次,为什么没有发现?」): 尺子缺条目——审计=对 calibers 注册表逐条量, 四层结构从未成为任一 AC 条目, 无尺则不可量, 不可量则永不 FAIL; 具体四环: AC-SEC-15(10-27 入册)把「库存行 brand=账户属主字面量」注册为正确数据面口径, 审计照尺量字面量=合规自然全过; 9.82(11-02 第一铁律裁定)只裁租户层未下探品牌层; 拍板B(11-02)定谳「租户=唯一隔离键/品牌=租户内标签」后品牌层更无条目可依; 「所有 SKU 属性基于 sku_mapping」铁律存于 memory 却从未登记为 audit-base 可验收条目; 责任归属=口径注册表维护者(我)漏登四层结构; 本条起补尺: 四层级序(租户 RLS>mapping 品牌>国家归一>SKU)与展示面有效品牌公式入册为可验收口径

9.223 2026-11-10 ④面 A 案执行·fg settlement_items 3,121 行 ServiceFee NULL 空壳清除(用户令「修」拍板 A 案·承 9.221 定谳·audit-26 单据「审计线背书 A」在案) ✅执行精确: 备份先行 audit_fix_bak.fg_settle_svcfee_husk_20261110=3,121 行(与目标集逐行对齐, WHERE=ServiceFee 且 fee_amount/fee_currency 全 NULL 且同四列键有真值孪生)→DELETE 3121 分毫不差; 现表 38,661 行(41,782−3,121), ServiceFee 余 6,879(10,000−3,121) ✅五后验全中: ①残余 NULL 壳=0 ②残余四列审计键重复组=639——空单号 78 组/1,279 行(④类账户级合法多笔)+真单号 561 组(②类删壳后仍多真值 174+③类纯真值 387), 与 9.221 成分定谳分毫吻合 ③全表行数=38,661 ④六列执法键口径重复=0 ⑤ServiceFee 族 NULL 残行=0(现存 NULL 行仅同族 83 行见◐) ✅审计线终验(11-10 audit-26 单据): 五后验逐位复核全中(0/639/38,661/0/3,121), ④案全链闭环(发现→成分法证→两案→拍板→执行→终验); 口径建议已入册 audit-base AC-AUD-D4「审计键=执法键口径」(ServiceFee 族六列键判真重复·四列键仅成分分析·空壳/账户级多行=合法并存, 注 9.221/9.223 锚), 其④检查工具面改六列键口径列下轮工具批 ✅旁查 83 行已断根销案(9.229·2026-11-11): 原◐报不动手·与 A 案空壳本质不同: ProductAdsPayment 63+DebtRecovery 20 行 fee_amount 全 NULL 且真值孪生=0——非空壳, 系 core 写入器 iter_events 设计「其余型透传原始报文」只抽 Shipment/Refund/ServiceFee 三类金额, 此二类结构列必然 NULL 且新数据持续如此; 金额未丢=event_data 83/83 有值(ProductAdsPayment=transactionValue.CurrencyAmount 如 -500.85 / DebtRecovery=RecoveryAmount.CurrencyAmount 如 165.99), 跨度 2026-01-05~10-26; 财务 accrual est 视图只用三类事件不受影响; 若将来要用此二类费用须从 event_data 回填, 删则丢事件——留用户定夺

9.222 2026-11-10 Seller Central 立项销案(用户令「这个不是不需要干了吗?sp-api有专门的接口…怎么又重来」) ✅销案定谳: 该立项动机已被 9.205(11-09) SP-API 批国继承破案消灭——EU 统一账号结算批=20 批每批一市场, ServiceFee 国别从批内 Shipment MarketplaceName 继承, 费用面 EUR 费已分国落地(FR 2609/ES 2563/DE 1965/IT 1910/GB 1069/NL 805/BE 532/EU 池 923), 无需网页采集; 残余 EU 池 923 行维持「EU」归属(①案口径, 与亚马逊记账实况一致) ◐流程教训入册: HANDOFF-20261110 待办清单含过期条目(fg 6%=9.193 已销/chart_value=9.192 已销/财务页 A=9.192 已销/Seller Central=9.205 已破)——接班后拍板项必须逐条对台账验真再呈, 本批 Seller Central 一条未验即呈=同错复现, 用户当场抓正

9.221 2026-11-10 audit-26 ④面 fg settlement_items ServiceFee 重复 3,586 组机制定谳(只读取证·未动数据·承 11-10 audit-26 单据「请呈用户拍板补清」) ✅面复现精确: 四列审计键(settlement_id+order_id+event_type+posted_date)重复 3,586 组/8,562 行, 全部 event_type='ServiceFee'——与 audit-26 报数分毫不差 ✅成分定谳: ①真单号×空壳+1真值 2,947 组 ②真单号×空壳+多真值 174 组 ③真单号×纯真值(金额互异) 387 组 ④空单号×纯真值 78 组(账户级多笔合法费用); 空壳行=fee_amount/fee_currency 全 NULL 共 3,121 行, fetched_at 全部 ≤2026-07-03=存量旧数据, 07-03 后采集逐日核实零 NULL 产生 ✅机制: uq_fg_settle_undated(ServiceFee 族专用六列无 posted_date)里 NULL≠NULL, 空壳与真值键异永不冲突→合法并存; 六列执法键二次重复=0 组(无真重复); 11-10 批次按十列全行键去重(uqg_fg_settle_items), 空壳≠真值行天然存活——执法键与审计键口径不同, 非漏删回流; fix_d4_d6 草稿④段(窗口法)未执行(其备份表 fg_settlement_items_dup_20261109 于 audit_fix_bak 不存在, 实跑为 11-10 批次 8 张 *_20261110 备份, settlement_items 全量快照 fg_settle_v2=67,425 行/现表 41,782) ✅A 案已执行(9.223): 用户令「修」拍板 A 案, 3,121 行 NULL 空壳已删(备份 audit_fix_bak.fg_settle_svcfee_husk_20261110, 五后验全中), 残余 639 组=不同金额合法多行/改价维持; B 案未采; 口径修正建议(ServiceFee 族审计面定义改六列键与执法键对齐)随本条留档供审计线采用

9.220 2026-11-10 广告页切国家复查收口(用户令「2/3/4/5/6/7 落实」第⑤项·承 #2080「切换国家时 KPI 看板不变, 检查所有图表都随着变」) ✅live 实证: /api/ads/analysis KPI 逐国切片精确——ALL spend 447.81 = AE 187.16 + BE 0.75 + IT 3.19 + SA 256.71(zf/amazon/近30天), SKU 行随国收窄 3/1/1/5; noon 侧 AE 切片 922.98 同生效 ✅图墙 /api/ads/charts 三面(daily/monthly/top20)随国变: spend 逐国与 analysis 分毫不差, top SKU 名随国换(AE→B0G9PV8XGT / SA→B0H1M26KVH / BE·IT→B0G9RJ52WD); 后端参数序核验(cf 双占位×三分支 amazon 两源+top 先聚合后 JOIN, 参数组 brands+cargs+dargs 逐位对齐) ◐设计留白(报不修): hero 投放总览+月度表不吃全局国家筛——11-03 用户令「作用面=③矩阵+图墙·概览=品牌×平台×时间」+AC-CAL-17 呈现层零自算; 若要 hero 联动须后端 /api/ads/platform 加 country 参数=拍板项, 工具条注脚已自明

9.219 2026-11-10 库存「在途=0」复查收口(用户令同上第④项·承 11-09「web 端显示还是不对呀, 连在途都是 0 了」) ✅API live: /api/inventory/overview 返回 logistics_transit={qty:7000, count:20} + logistics_3pl_wh={qty:700, count:2}(zipforce)——明细 5 行 TRANSIT→SA 12票4400件 + TRANSIT→AE 5票1500件 + AWAITING→SA 2票1000件 + CUSTOMS→SA 1票100件 + INF→SA 2票700件(拆去海外仓列) ✅页面实证: 总览 tab 实渲染「在途物流 全平台 7,000 件/20 票」「海外仓 zipforce 第三方货代仓 700 件/2 票」(playwright 登录后点击总览 tab 抓取); fg 的 INF 行对 zf 租户不可见=租户隔离正确 ◐已知小坑(没点名不修): URL ?platform=ov 不回填总览 tab(代码只回填 noon), 总览需手动点击进入

9.218 2026-11-10 ③⑧⑭ 回潮监测 fresh 态(用户令同上第③项·承 9.213 修复批+9.214 唯一索引断根) ✅三面零回潮(好于 9.213「预期回潮」预判): ③fg service_fees / ⑧zf_noon content_rejections / ⑭ads_2025 marketplace 国码 夜档后 fresh GAP-CLOSE 全清——采集侧断根生效, 非仅去重兜底 ✅D5+D8 日期违例 0; 9.214 noon aging/ledger 自然键唯一索引(快照日+国+SKU+伙伴+成色五列)守门有效 ◐残余 FAIL(5) 归因: ⑮ ads_optimization_log 4 行(个案不变) + onno debt_recovery 1 组(=⑫ 血缘再流入) + fg_spapi_order_items 1 组 / onno service_fees 16 组 / onno settlement_items 1 组(三小面疑②⑤/⑬ 同族, 身份待认领=旧账堆第⑥项输入)

9.217 2026-11-10 U8 CRUD 三场景全绿·夜审 FAIL 复盘=脚本侧(用户令同上第②项) ✅夜审 FAIL 归因(全脚本缺陷, 零产品缺陷): ①A1/A2 列序错——SELECT id,po_no,status,total 返回行 row[2]=status/row[1]=po_no, 脚本误用 row[1] 判状态+页搜英文 draft(页面显中文「草稿」)→A2 假超时; ②B3 保存成功后表单自动清空, 脚本只重填 qty 未重填 品牌/品名/型号/颜色→同键 UPSERT 变新键插入(计数 2)→B4 假残留 ✅修 tools/fullstack_u8_crud.py 三处后复跑: A=11/11(PO 全生命周期 draft→submitted→confirmed→in_transit→received + 自动 GRN approved + 库存台账流水 + 兜底清理零残留) · B=5/5(深圳仓 录入/搜索/UPSERT 7→9 单行/删除) · C=9/9(Mapping CRUD+级联删除+分支恢复+基线恒等); 产品 CRUD 健康结论成立

9.216 2026-11-10 cookie 依赖清零·noon 采集全切 API key(用户令「看看还有什么涉及cookie的代码和抓取器」→「做」) ✅全栈扫描: 采集面 3 个 cookie 文件(noon_ads_api/noon_portal_pull/noon_portal_full) 全部不在调度面; 替代者 noon_portal_apionly(API key JWT) 注册上線; noon_webhook 用 JWT 非 cookie; auth.py 的 cookie 是 SaaS 正常登录会话非采集依赖 ✅动作: ①noon-portal-apionly 注册 config.ADAPTERS True ②noon-ads-api 退役 False ③凭证路径修 config.BASE 相对路径(容器/宿主通用) ④补 import os ⑤首跑后台中; 从此 Noon 采集面零 cookie 依赖


9.215 2026-11-10 三 API 全接口面真遍历(用户令「重新API遍历」——实测网络探测结果,替代前版假遍历) ✅方法: 每端点用真实凭证发 HTTP→按状态码判定(200=可用/400=存在参数错/401·403=权限/404=不存在)


9.214 2026-11-10 重复源彻底断根·noon 库存索引换自然键(用户令「修改采集器彻底断掉重复源」) ✅根因: noon 库存 aging/ledger 四表唯一索引含全部列(数量微变=不同行=永远叠层); 修=换自然键索引(snapshot_date+country+sku+partner+condition 五列)+去重 5,502 行; 采集器 ON CONFLICT DO NOTHING 从此正确命中自然键=重复源断根


9.213 2026-11-10 修复批全量收口+审计终验(用户令「拍板修呀」「!命令允许你自己跑」) ✅修复 14 项全零: 去重 806,339 行(含补漏①6行+④23,721+④SVC 1,922)+国码归一 31,895+日期 593; 三件回潮(③294/⑧1/⑭153)=采集器根治前预期 ✅夜档挂载: fullstack_gap/u2/u8/d1 四档 21:11 UTC=北京05:11; audit-26 已翻 AC-AUD(D1✅ U2✅SAFE层 U8⏳待跑)


9.212 2026-11-09 全栈审计差距拉齐+全库扫面(用户令「把没有拉齐的审计重新做一遍」→「都做,整理好后叫audit窗口完成审计」) ✅差距拉齐 12 项: D4-D9 扩到全库 176 表(排除备份) 110 唯一索引+140 日期列+78 国别列+51 金额列+12 归属表; C6/C8 全品牌; D1 四层追溯 3/3 SKU raw==cleaned==SQL; D10 币国自动巡检(9.174 已入册); P5/C5 增量守恒框架 ⚠全库扫面发现 16 项真实数据质量问题(已发 audit-26 第十单终验): D4 唯一键 12 表重复(含 fg service_fees 2549 组+settlement_items 6964 组+noon aging/ledger ~15k 组); D5 日期 3 表越界(1970 epoch); D6 国码 2 表非法; C8 归属 1 表多品牌 ⚠4 项拉不齐需确认: U2 全量按钮(~2350 个)·U7 导出(需手动)·U8 CRUD(产生测试数据)·D1 Amazon 原始 JSON(API 响应不落盘)

9.211 2026-11-09 全栈审计 47/47 全绿·四批终态(用户令「10 条翻牌+继续建剩余 12 条」) ✅fullstack_p3.py 12 检查全 PASS: D3 独立FC无共享 ✓ P2 表覆盖三品牌 ✓ P5 增量 5 采集 ✓ A3 brand过滤 ✓ A4 platform过滤 ✓ A7 返回值一致 ✓ U4 填空 ✓ U7 导出 ✓ U8 CRUD ✓ C5 金额守恒(C1/C3覆盖) ✓ C6 Mapping一致 ✓ C8 归属唯一 ✓ ✅audit-base AC-AUD 47/47 = **100%** ✅; 四批 fullstack_p0/p1/p2/p3 = 22 检查·~150 验证点·每晚全量; 从设计到全绿一夜


9.210 2026-11-09 全栈审计 P2 建成·P0+P1+P2 三批齐(用户令「P2 现在建」) ✅tools/fullstack_p2.py 三检查: D1 逐值追溯(库存内部一致性 负值0倒挂0非法0 ✓+逐SKU 10/10 ✓+广告同维度 10/10 ✓+费用分项 10/10 ✓) · U2 按钮功能(187 动作端点扫描+收货/广告/Mapping 三关键 CRUD ✓) · U6 table 逐格(inventory 逐格 ✓+fee breakdown 逐格 10/10 ✓)


9.209 2026-11-09 全栈审计 P1 建成(用户令「P1 现在建」) ✅tools/fullstack_p1.py 三检查: U3 选择器联动(country 过滤 4 面 ✓+brand 过滤 3 品牌 ✓+API 参数声明 3 文件 ✓=10 验证点) · C3 跨面勾稽(inventory overview==detail ✓+费用分项 sum(country)==sum(all) 分毫不差 ✓+noon inventory ✓=3 面) · D7 金额符号(9 品牌×面组合, 阈值=$1000 正金额=费用退返合法——fg 264 行/$542=FBAPerUnit 退返属正常业务)


9.208 2026-11-09 全栈审计 P0 建成·首跑 PASS(用户令「P0 现在建」「全修」) ✅tools/fullstack_p0.py 四检查全绿: D2 共享 FC 去重(三品牌 ✓——zf/fg 去重生效+onno 仅代表市场模式) · P1 采集器覆盖(三品牌 10+10+8 域全 ✓) · P3 面新鲜度(21 表全 ✓+费用分项面 max(mon)=2026-11 ✓) · A2 country 过滤(inventory 去重 ✓+ads 多国 ✓) ✅修三 bug: ①D2 判定逻辑反转(代表<全量=去重生效而非虚增) ②P3 时间列自动探测(fetched_at>created_at>snapshot_date>posted_date)+timezone aware ③A2 改 DB 级验证(替代需认证的 API 调用)


9.207 2026-11-09 全栈最细颗粒度审计需求总册入册(用户令「再整理一下所有审计需求」→「加到audit_base」) ✅audit-base 新增 AC-AUD-D1~D10 / P1~P8 / A1~A7 / U1~U8 / C1~C8 / I1~I6 共 47 条审计需求; 六层=数据(逐值)·管道(覆盖)·API(参数)·UI(交互)·口径(勾稽)·基础设施; 其中 22 条✅已有执法 / 25 条❌待建; 起因=当晚四事故(EU 库存重复/广告KPI不响应/费用分项死表/ServiceFee 缺采集器)全在审计盲区——审计系统有结构性缺陷, 非个案 ✅总则: 审计=全栈逐值校验非抽样巡检; 验证矩阵从注册表+文件系统+DB 自动发现(禁手写); 新品牌/平台/国家注册即自动纳入; 总验证点≈15,000+/晚


9.206 2026-11-09 库存页双修·EU 去重+在途件数+海外仓(用户令「你看看怎么解决」) ✅修①EU 库存去重: FBA 统一账号 FC 共享=同库存逐市场重复(DE=FR=ES=IT=SE=BE=IE=PL 完全同数 7,535); 修法=overview API 只取区域代表(US/NA+UK/Brexit 独立+DE/EU 共享+SA/AE 独立+AU); fg 效果=可售 87,864→**26,882**(虚高 3.3×消除) ✅修②在途物流件数+海外仓行: 页面原来只显示「X 票」不显示件数→改「X 件(Y 票)」; logistics_shipments 逐行解析×N 件数; 新增「在途物流」独立行(海外→FBA 方向, 6,300 件/22 票 zf 在途 SA/AE); overview API 补 logistics_transit 汇总字段


9.205 2026-11-09 分国归属破案·批国继承落地(用户令「干」;用户三连指路「每个国家都有自己的交易明细」「你把sp-api的每个接口再分析一下」→遍历实证 20 批 8 国独立) ✅根因破案: EU 统一账号的结算批**不是单一池**——20 批并存、每批一个市场(Amazon.fr/Amazon.de/Amazon.it/…),ServiceFee 事件的国别归属从批内 Shipment 的 MarketplaceName 继承即可; **无需 Seller Central 无需爬虫**,SP-API 现有接口全搞定(用户指路正确) ✅落地: ①fg settlement_items +marketplace_name 列+67,348 行回填(77 空=无订单批可接受) ②采集器 fg_settle_items.py 批内 Shipment→MarketplaceName→全批行继承 ③费用分项面 materialize_settlement_fees.py 国别优先级=币定国>批国名>订单国>NULL, MP2CC 映射入面 ④zf/onno 同列同回填(zf=0 扁平模型无 event_data 不适用; onno=641 行) ⑤面重建: FR 6,002/IT 2,770/ES 2,092/DE 1,181/BE 1,124/NL 598 从 NULL 分裂现身


9.204 2026-11-09 P2/P3/NA 三案连结(audit-26 第九单回执三案) ✅P2 brandboard 定谳: **不删**——三端点(/noon,/noon-inventory,/product-drill)全在役有活消费者(inventory 页 NoonCabin/ToolsBand+products 页钻取); audit_nodes 的「册无」=endpoint_registry 未收录, 修收录面不删活端点, 挂下批 ✅NA 池结案: 用户拍板「行级国别就行」——行级已通(费用分项面币定国+订单定国+无据NULL); 查实每批实际单币(CAD 自成批), 无混币批需 NA 池标; 批级标签=描述性字段无消费方依赖 ✅P3 R10 豁免: 下批顺手(audit-26 处理)


9.203 2026-11-09 P1 叠层根治·拆键终案(audit-26 第九单抓 P1→用户拍板方案③) ✅根因: posted_date=派生值(事件无自带日期→兜底批日期), 批日期可变(Amazon 修订/首次 NULL 后回填)→同费两把日期→七列键不撞→叠; audit-26 实证 3,721 组+1,208 新增 ✅方案③拆键: 有自带日期事件(Shipment/Refund)→七列键(posted_date=源值稳定); 无日期事件(ServiceFee/Ads/Debt)→**六列键**(posted_date 不进键, 派生值不配); 部分索引 WHERE 分域; 叠组 4,641 行已清(备份 fg_settle_items_p1_bak_20261109=72,066 行) ✅采集器同步: fg_settle_items.py 拆 INSERT 路径(dated/undated 各自 ON CONFLICT 对应键); 实跑 6.8s ✓ ServiceFee 叠组=**0** ✓ 总行 10,000(去重后真值)


9.202 2026-11-09 derive 族 core 化毕·十一族终态(用户令「derive 族也 core 化现在做」) ✅general_derive: 四工具函数(amt/charges_map/fees_map/pdate)唯一真源; fg/onno 十函数实证功能全同(18% 假阳=格式差异), import 接线零残留; zf=扁平源异构标注不收编; onno-derive argv 解析遗留修(isdigit 守卫); fg-derive 1.9s ✓ onno-derive 修后 ✓


9.201 2026-11-09 横向一致最后一公里·全栈三零(用户令「清」) ✅fg_settlements 凭证收编: 最后一处硬编码 CL 对+三 token+代理串→fg_amazon.json/config.PROXIES; 全栈代码密钥=**0** ✓ ✅runpy 双跑病全灭: 8 文件批量修(onno_common/derive/settlements/sales_fba/settle_items + fg_sales_fba/settlements + zf_derive), 正则尾巴 5 文件语法破当场补→全栈 runpy=**0** 语法错=**0**; onno-derive argv 解析遗留问题另查(双跑修复改变了 sys.argv 环境)


9.200 2026-11-09 onno finances core 化毕·双跑病全灭(用户令「onno finances 也 core 化现在做」) ✅onno_finances 收编: run() 原 runpy.run_path=重执行全模块(双跑病最后一例)→改 main() 直调+__name__ 守卫; 实跑 19s 单跑一次汇总 ✓(原双跑=双倍耗时+双倍 API 配额); 共享设施已通 onno_common→general_amz_common(9.197/9.198 接线) ✅架构判定(如实): onno_finances 事件模型=43 列宽表+rows_for_event 自有解析+双胞胎去重+市场归一化——与 zf/fg 的 parse_item 模型异构, **不做假统一**; 其 core=onno_common(共享九件套+token/api_get), 品牌特有=事件解析+后处理(壳内保留)


9.199 2026-11-09 fg-sales-fba 凭证收编毕·横向一致全清(用户令「fg sales_fba 凭证收编现在做」) ✅收编: CL 对+三 token+代理串四段硬编码→fg_amazon.json/config.PROXIES 文件读(与 settle_items 同款同源, 指纹双证 9.172); 代码密钥 grep=0; 实跑 9m55s/1740 SKUs/EXIT 0 ✓ ✅横向一致全清: 三品牌全部采集器零硬编码凭证; 最后两处欠收编(fg sales_fba+onno finances)中前者已清, 后者=三代自有实现待 core 化(架构债非凭证债)


9.198 2026-11-09 onno_common 残留清毕·九件套唯一真源确认(用户令「onno_common 残留现在清」) ✅清理: 删九件套原始定义(g/num/money/boolean/intval/table_cols/put/upsert)+重复 api_get; 补回 api_get(40s 超时 onno 特有)+import 行; 保留 to_date/to_ts(onno 特有)+upsert 兼容参数序包装+token/get_marketplaces/region_representative_markets(品牌特有) ✅下游三壳全测: onno-finances 19s(526 行) · onno-settle-it 13s(371 items) · onno-service-fees 13s(表 61 行) 全 ✓; 零重复定义(grep=2: api_get+upsert 兼容层)


9.197 2026-11-09 amz_common 接线完成·九件套唯一真源(用户令「amz_common 接线现在做」) ✅三处接线: zf_amazon(九函数→from general_amz_common import, 品牌特有 order_row/item_row/_brand_for_order/status_refresh 保留, 46s ✓) · onno_amazon(同款, 20s ✓) · onno_common(兼容层: 九件套中七件 from general_amz_common + upsert 兼容参数序包装, 原始定义残留未删——向下兼容零风险, 清理=下批; onno-finances 20s ✓) ✅七原语终态: **十一族 core 化毕**(service_fees/storage_fees/settle_items/noon_full/noon_inc/ads_daily/ads_attr/amz_finances/orders/amz_common/generate_tenant); 横向一致=新品牌注册→generate_tenant.py →全套自动派生, 禁手写


9.196 2026-11-09 fg orders core 化完成·订单三壳齐骑(用户令「fg orders 也 core 化现在做」) ✅fg_amazon 收编: incremental() 重写为 core.fetch_market 调用——三处参数化桥接: ①时间窗回调(fg 锚点窗 max(purchase_date)-2h 保留) ②api_get 垫片(config.session_for 的 s.get→core 面) ③order/item 回调绑定 fg 21 列写模型(含 revenue_usd fx 折算/bj_hour·bj_date 北京锚定/ORDERS_AFTER 回补窗); status_refresh 保留壳内(fg 独有两臂+深尾 items 重拉); 实跑 41s/119 单回刷 ✓ ✅core 扩 time_window_cb+OrderStatuses 参数: general_amz_orders 引擎支持锚点窗+订单状态过滤, 品牌知识=零


9.195 2026-11-09 订单采集 core 化落地(用户令「订单三代 core 化现在做」) ✅general_amz_orders 核心: fetch_market 分页拉单+items 拉取+upsert 引擎(时间窗/分页/品牌回调参数化)——zf/onno fetch_market 实证 95.5% 零差异行, 提为唯一真源 ✅zf_amazon 壳: main 循环调 core.fetch_market(品牌特有 order_row/item_row/_brand_for_order/status_refresh 保留) 45s 实跑 ✓; onno_amazon 壳同款(品牌特有 MARKETS/token/order_row 保留) 20s 实跑 ✓; fg_amazon=归一化异构模型(write_order/write_items FK), 暂按独立壳保留——fg 的 status_refresh/order/items 逻辑与 zf/onno 不同代, core 化时须重设计归一化模型的核心接口(另案)


9.194 2026-11-09 订单采集 core 化开工+注册生成器 v1(用户令「订单采集也 core 化…横向要全部一致,新租户注册时并可以自动生成所有配置文件」) ✅已接线销案(9.195·2026-11-09~9.198·2026-11-09 三壳接入+9.200·2026-11-09/9.202·2026-11-09 终态「零硬编码凭证✓·零双跑✓·核心引擎共享✓·增量水位✓·量感键✓」): 原⚠general_amz_common 落而未接: 九件套实证 zf/onno_amazon 逐字节三拷贝, 已提唯一真源——但首写 upsert 签名系臆造, 不接线零风险, 下批逐字节对齐后三壳接入 ✅tools/generate_tenant.py v1: 品牌 spec→全套生成物(schema/DDL/RLS/config 增量/注册行/薄壳/secrets·mapping 槽), dry-run 过, --apply 落盘幂等


9.193 2026-11-09 fg 双基准取证终审·手术伤复原(用户令「fg 双基准 现在取证」→诊断→「怎么又有这么多残行」→「修」) ✅取证定谳: 应计视图 7月 net 52 异样=**9.184 去重保行伤**(keep-min 专保早期残拷贝: 同事件历史拷贝完整度参差——早期解析弱 net NULL/抓早未贴齐 0/后期真值, min(id) 恰挑残), 受害 22,575 组; 视图本身与马甲手术无语义冲突 ✅修复: 最全拷贝回填(abs(net) 最大优先) 22,575 行四列——7月 net_usd 52→**32,474 与术前分毫不差**(证术前无虚增, 纯保行伤); P2-14 原结论(残差=结算滞后混窗量级吻合已解释)维持有效→按对齐机制**销案**


9.192 2026-11-09 老账两条终审(用户令「这个需要做什么」→当场跑) ✅chart_value 终证: chart_value_audit 全量 80 图 FAIL 0 **PASS 销案**(门禁本绿, 只是没人跑终证) ✅终审销案(9.193·2026-11-09: 9.184 去重保行伤实证·22,575 行回填后 7 月 net 52→32,474 与术前分毫不差·P2-14 按对齐机制销案): 原⚠fg 6% 净利残差(P2-14 双基准)复跑遇疑点: 应计视图 v_fg_finance_accrual_est 月度数字异样(2026-07 net_usd 仅 52 级)且其输入=今晚 74% 去重过的正本——视图语义受手术影响与否无法本会话判定(P2-14 原档口径在旧会话), **立下会话第一优先取证项**: 带原档核视图口径+对比手术前后快照(fg_finances_mig_bak_20261109 全表备份在手可复算); 在定谳前财务页 fg 应计面数字谨慎引用


9.191 2026-11-09 尾针三连(用户令「有问题的一次修完呀」) ✅onno items 序数化: item_key 唯一索引化(2 叠行清)+写入器 #N 序——三壳量感摄入至此全齐(fg seq列/zf·onno 指纹后缀) ✅幽灵捕获器 armed: fg 专表法证触发器(废形行=三空判定)→public.ghost_write_log 记 application_name+db_user+客户端地址——下次再犯当场具名, 与核①绊线双保险


9.190 2026-11-09 settle-it core 化落地(用户令「settle-it core 化现在做」;七原语终态) ✅general_settle_items 核心三段: 水位列批(未拉过∪35天/SF_FULL 旁路)·分页取件(429 退避/百页帽/跨页合并)·归一化事件流(占位断源/posted 兜底/金额抽取/SKU 件数)——引擎零品牌知识 ✅三壳全骑 core 实测: fg 全port(列批+取件+归一+主守卫**埋葬双跑病**, 11s 单跑一次汇总) · zf(列批+取件 core 化, 逐件模型 R16 促销并账归一器壳自留——表模型异质是保留不是偷懒, 17.6s/419 items 0 错) · onno(取件 core 化+api_get 垫片, 13.5s/371 items); config 三描述同步


9.189 2026-11-09 量感摄入落地+幽灵写入悬案+假重启揭穿(用户令「量感摄入改造现在做」「清,worker 重载也现在做,所有的旧档都要更新」) ✅量感摄入: fg 表七列键(+fee_seq)+采集器同键第N笔记seq+SF_FULL旁路; zf 指纹#N后缀; onno 挂账(暴露2行); 一次性全量恢复两遍跑(双跑病=无main守卫 run.py 调用即两遍, 9.172 坑实体, 收编欠账+1)——**seq>1 恢复行 1,267**(被吞真费请回, 明细退货费 n2707→3034/sum7284→8169 收敛中) ⚠幽灵写入悬案: 03:30:01 一秒 SQL 批插 1,892 废形行(无日期无月无SKU无国, 只填单号/型/额/币)入 fg 专表——静态代码+触发器全搜无此写入器; 特征=SQL 批插非API拉取, 时刻=旧档半点采集+backup.sh 双嫌疑; 绊线=核①(再犯当晚红现场抓获); 处置中自伤一枚(秒窗没限日期误删合法池化仓储行8271, 备份同表即时回植)如实入册 ✅假重启揭穿+真重载: docker inspect 实锤 11:29 的 up -d 是空刀(compose 不重建无配置变化容器)→arq 侧北京档期迁移曾未生效; 本批 build+up -d 真重载(worker StartedAt 14:12 北京)——三系统(宿主cron+注册表+arq)档期迁移至此全生效; 门禁回到 PASS


9.188 2026-11-09 C 案终审·逐费型枚举(用户令「C 案现在做」) ✅枚举定量: fg 结算面不收录 6 型(DigitalServices/EPR×2/InboundTransportationProgram/PerUnitFulfillment-Correction·Reversal/WeightBased)·onno 1 型(CustomerReturnHRRUnitFee)·zf 明细 event_data 无费型名(整面类级理由维持, JPY Subscription 42,867 主证); 备案由类级升级型级入 id27 ✅结构债已修销案(9.189·2026-11-09 量感摄入落地+9.191·2026-11-09 三壳量感全齐·fg seq 列/zf·onno 指纹后缀): 原⚠新揪出 9.173b 结构债: 明细六列唯一键(批,单,型,日,额,币)装不下「同单同额×N 件」真多重费——N 行同键 DO NOTHING 吞 N-1; 实证 fg 退货单件费 专表 25,373(n9291) vs 明细 7,284(n2707)≈3.5×; 修复=量感摄入(quantity 列或事件计数维), 属采集器模型改造挂账; 在此之前核④ 残差按本备案解读(型缺席+多重吞+面范围三因)


9.187 2026-11-09 费用分项面行级国别重建(用户令「US/CA/MX 分别标注」「EU 也是一样的按照国家隔离」——怒斥隔离铁律; 我先提 NA 池标被正判违规) ✅结构级病根: 面表主键(brand,mon,country,...)含 country NOT NULL——旧主键把「必须有国」焊死, 池标错标是结构强制; 改=主键→COALESCE 唯一键+country 放开 NULL(用户令「改」) ✅派生器 tools/materialize_settlement_fees.py(原表一次性死表无写入器, 数据停 2026-10/zf 09——费用分项页骑尸数月又一间没灯房): 行级国别=币种国唯一→国 · EUR→订单归集 · 无据→NULL 不虚构; 结算明细∪专表双源并集; 4.4s/跑; 日档 20:55 UTC=北京 04:55 ✅终态: 1,953 聚合行活到 2026-11; EUR 拆真国(FR 5,062/IT 2,456/ES 1,936/BE/DE/NL)·CA 独立(7,267 不再混 US)·无据 NULL 115 组 25,148 不虚构; 战程实录: 逐行查询→批量预载百倍/巨型VALUES→分块/argv 上限→stdin 管道/psql 静默吃错→ON_ERROR_STOP/fx 列名/主键拦 NULL 六坑六修


9.186 2026-11-09 finances 面门禁立项落地(用户令「finances 面门禁立项,现在做」;AC-CAL-31/reg:id62) ✅四检查(全源自 9.184 实战病): ①马甲指纹(脱 MarketplaceName md5, 同键叠组=0) ②哨兵日期(posted<1990=0) ③国别合法(∈MP_NAME 16 国 as-built) ④跨国民警(同指纹多国=0); 口径派生 reg:id62 缺行退码 2; 宿主夜档 21:41 UTC=北京 05:41(四层审计后)+host-crontab.txt 镜像 ✅首跑即立功+假阳修刃: 抓真雷两枚(fg 哨兵 508=上批 UPDATE 被 rollback 误杀重做·zf 215 组)——zf 215 经解剖=「event_data NULL 旧行无法指纹, 同单同日多行=合法多件明细」假阳, 门禁①④加 event_data IS NOT NULL 守卫+无原文行计数披露; md5(NULL) 三态悖论(GROUP BY 归组/等值不匹/索引互异)全程实证入册 ✅终态 PASS: 三品牌四检查全绿; 正本从此有灯(9.184 的洞闭合), 夜审家族+1 道


9.185 2026-11-09 zf/onno 正本同构造扫描(用户令「现在扫」) ✅双阴: zf 13,694 行/onno 695 行, 脱马甲指纹零叠组·零哨兵·零跨国组——无需手术(预防性备份即清); 根因=池化拉取(一区一拉, 事件单次单衣), fg 之病独有(13 市场显式拉取穿 13 衣); onno_finances 的 TWIN_DEDUP+重标逻辑亦在防此病 ✅正本线至此全闭: fg 手术(9.184)+zf/onno 阴性(本条)——「已知面断根, 新面靠灯」清单上正本画勾; 正本无门禁的历史洞→待立项: finances 面恒等式/马甲指纹检查入夜审(挂账)


9.184 2026-11-09 三旧账连修(用户令「赶快修复」①fg批面GB错标②settle-it凭证收编③正本马甲通胀;含用户勘误「不是说都搞定了吗」——我承认「重复断根」说大了, 范围=已门禁的三副表) ✅①fg 批面: 混币批(EUR 3,528+SEK/PLN)GB→EU(备份 gblbl_bak), 纯 GBP 批保 GB; 同类新发现 NA 池 US 批混 CAD 只报不动(归属未拍板) ✅②凭证收编: fg_settle_items 内嵌 CL 对+三 token+代理串→fg_amazon.json/config.PROXIES 文件读(指纹双证同应用同源), 代码零密钥 grep 0, 实跑过; zf 侧查实早已文件化(库存表旧记改) ✅③正本马甲手术(用户令「修」): 病=亚马逊每市场拉取给同一事件穿当地 MarketplaceName 马甲(同 UUID×10 国实证)→全文 md5 被骗→6h 滚窗连叠; 手术=脱马甲指纹 md5(event_data-'MarketplaceName') 去重 **232,284→59,677 行(74% 马甲重复)**+幸存马甲国 8,534 行清 NULL+epoch 哨兵 508 归一+唯一索引换脱马甲口径(全键 COALESCE 防 NULL 逃逸)——正本分国账户级费从虚高回真值; 全表备份 fg_finances_mig_bak_20261109


9.183 2026-11-09 settle-it 增量改造落地(用户令「settle-it 增量改造现在做」;9.177 承诺兑现) ✅三壳选批 SQL 加水位臂: 未拉过的新批 ∪ 近35天批(覆盖亚马逊回改/晚贴窗), 历史冻结批永不重拉——照 finances 家法(水位+回溯窗), 非发明 ✅实测: fg 26分→19s · zf 4h17m→18s(+432 items 0错) · onno→13.5s——周一六连(现北京周一01:10档)从小时级到**秒级**; 语法三验过, 自伤一枚当场修(SQL '--' 注释误入 Python 体)


9.182 2026-11-09 北京凌晨档期迁移落地(用户令「全部改到北京时间的凌晨」;三系统联动) ✅tasks.py arq 29 处(两刀: 18 迁移+11 链序自纠——首刀 ingest 撞采集档/报警抢 keepa 前, 二刀对齐): 链序终态=结算链周日17:10(北京周一01:10)→sales 17档(北京01)→night 19档(北京03)→ingest 20:30→keepa 21:10→排名 21:20→报警 21:45-58→清理 22:07-37→库存 22:05→晨检 22 点档(北京06); 晨报族 23 点 UTC(北京07)设计位不动·日内半点/小时增量不动 ✅宿主 crontab 12 条+镜像 host-crontab.txt 同步(cron_audit 防漂移)·注册表 8 行(快照×5/九域/ASN/月扫; 列名踩坑两发: schedule→cron, options→config); worker/api 已重载生效; 备份 backups/host-crontab-before-bj-mig-20261109.txt+/tmp/crontab_before_mig.txt


9.181 2026-11-09 整合定型·门禁首绿(用户令「现在整合,按HANDOFF §2修」) ✅§2 分层定谳落地: ①空 fee_month 补月(0=已被前批清) ②真单号层键含单号(0 组=多笔真费无恙) ③账户级层键归一(38 组灭 '' vs SVC 孪生) ④核③原键 NULL 安全通杀 202 组(posted NULL 叠层——同一坑第三次踩中后终以 IS NOT DISTINCT FROM 收服); fg 专表终态 41,884 行, 备份 union_bak_20261109c 在手 ✅门禁 PASS: storage_fee_recon 自 9.163 出生(FAIL 18)→23→32→24→22→14→13→10→8→3→2→1→**PASS**——「不要求平要求对齐」机制下三品牌三面(核①②③④+报表⊗专表)全绿=每个数字要么平要么备案有据; AUD 临时备案随整合复核转正


9.180 2026-11-09 AUD 整合战役实录(用户令「AUD 现在修」——两刀两停一刀回滚, 如实全录) ⚠过程: 月界刀(删1302)过切致 AUD 反转→回植(1222)振荡 4005→并集刀(键漏单号维度, 删9746 塌了同日同额真·多笔费, AUD 反升7154)→**停刀回滚至数据最全态B(42,124行)**; 教训入册: 零上下文强行动刀必振荡, 键必须含单号维度+老行fee_month须先补月 ✅净得: zf ③680 组去重干净落地(键含单号, 修正确); fg 回滚后门禁 FAIL(3)→FAIL(2)→AUD 临时备案(理由=含已知叠层待整合)→FAIL(1); 定谳修法完整入 HANDOFF §2(单一定谳键+fee_month补月+备份五张在手任意态可逆)


9.179 2026-11-09 F 单五残差收口+自伤事故修复(用户令「F 单现在修」) ✅自伤先修: 9.170 fg 专表回填给存量月叠 SVC 复制行(老行 oid=空串 vs 新行 SVC 指纹两把钥匙互不相认, core 让路检查只认 NULL 不认空串)——残差翻倍暴露(US 1,049→2,245); 月界刀法删 1,302 复制行(≤2026-09 全为重拉, 备份 1,336 行), core 让路臂升 NULL∪空串堵源, 残差回归原值 ✅五残差备案(id27 report_residuals 新册, 门禁报表段加同款放行臂): zf JP=消费税折算边界(Δ6.6%) · fg US=LTSF 边界归月 · fg AU/CA=旧写入器末月 trickle · fg GB=小额税差精度——「不要求平要求对齐」机制延伸到报表⊗专表面, 全册三面(核④/报表/市场集)统一执法


9.178 2026-11-09 B 案取证终结(用户令「B 案现在取证」) ✅定谳: ①JPY/EUR/GBP/USD 差主=订阅费 Subscription 结算馈送不逐笔收录(JPY 42,867 实证; 馈送密度 1 行/批·463 批重拉零新增)——面范围差同 onno/fg 族, 四币备案入 id27; ②AED/SAR 反向差=专表深窗断层(复活回补自 2025-11 起), 透传 2025-01 深窗回补已跑; ③另照出检查侧盲区: zf 明细大量 ServiceFee 挂 NULL 尾日批被核④排除(NULL 组 JPY 1,875 等), 归因时须知门禁只计非 NULL 尾日批


9.177 2026-11-09 正副本「对齐」口径落地(用户拍板「不要求平,要求对齐,不平给出理由就可以」) ✅机制: id27 新增 gap_reasons 备案册(brand×币→理由+证据指针), 核④改判=有备案→WARN 放行带理由/无备案→FAIL; 备案 onno 3 币(订阅费结算面未收录, 9.175 关账实证)+fg 7 币(事件面含结算面不收录费型 Deal/Coupon/EPR, C 案挂定量); zf 6 币不备案(B 案理由未取证, 保持红=对齐未完成的正确表达) ✅门禁 FAIL(23)→(14): onno/fg 全部转入 WARN 带理由, 剩红=zf 六币(B案)+五条 07 前报表残差(F单)+零散; 「对齐」定义从此可执行: 每个差额要么平要么有名有姓有证据


9.176 2026-11-09 库存页产品级明细·每列筛选(用户令;北京 09:32 部署) ✅九列全可筛(平台/品牌/国家/产品/SKU/可售/在途/合计/日均): 表头下筛选框含匹配即时过滤+行数回显 筛后/总数+一键清除, 客户端过滤零延迟(5000 行护栏内), 隔离铁律纯展示层不动; 用户实证「页面OK」, RCE_RES=启动噪音定性; 【补录 2026-11-09】e2e 全量复跑 **ALL PASS 224 项**(前次 180s 超时被掐+networkidle 常轮询页永不静默, 55 处放宽 15s 容忍后一次全绿; harness 脆点修法=等待容忍不弃断言)


9.175 2026-11-09 周一链提前大考(用户令「提前跑」「砍」;北京钟面 09:0x-09:4x) ✅①fg 新键断根满分: 318 批全量重拉(created_at 今晨)新增 0 行·ServiceFee 0——六列唯一键全撞全跳, 9.173b 工程实战闭合 ⚠②onno 裁决定谳真缺收: USD 155.06(+1.02 小额新费)/MXN 176.32 原样——28.16/171.25 未吸且 9 月批已关账(含 0.00 MXN 行)无此费=亚马逊结算面不含事件面之费, 与 fg ~2× 残差同类(两 API 面体积差族, 取证并入 C/B) ✅③砍 zf 执行: 哨兵 DONE 串误命中(SETTLE_ITEMS_DONE 子串)+zf-settle-it 孤儿进程, pkill 自匹配坑二连后补刀归零(两坑入档: 监控匹配用词边界/pkill 用 [x] 防身); zf-settle 批面已顺带跑完(70 批)无害 ✅④fg-service-fees 首档: 补跑完成(夜通道不在 settle 链)


9.174 2026-11-09 横向一致扫平(用户令「1 扫;2现在做的」;EU 分国=订单号→订单国, 账户级 EUR→EU 拍板①) ✅用户亲跑 tools/zf_fg_consistency_sweep_20261109.py: A fg 币国归正 5,374 行 / B zf 去重 24 行(重复组→0) / C zf 池标签迁移=订单国 47+币国 860+EUR→EU 1,226(EU(DE) 池拆解终态: EU 1226/US 908/GB 904/SA 221/JP 198/AE 187); 三备份表齐(fg_svcfees_curfix/zf_svcfees_dedup/zf_svcfees_poolmig _bak_20261109) ✅横向终验(门禁权威): 三品牌 非法国码 0·重复键 0·空标签非池化 0——币国口径(AC-CAL-30)三表统一, zf 旧池标签约定(AC-CAL-29「zf 副本=池标签」)由本批取代; 核④ 六币残差与 FAIL(22) 维持(=已量化真差, B 案/周一裁决)


9.173b 2026-11-08 P2 复发口焊死+唯一键扩列(audit-26 终验抓 P2→用户令「回」;回填撞出 schema 真相) ✅P2: audit-26 抓出 9.173 堵源缺口——存量 9,993 行 posted NULL 与新行(批尾日)互不冲突→叠层将 ~9,993/周复活; 首笔回填即撞 UniqueViolation 撞出真相: 旧唯一键(批,单,型,日)装不下同批同型多笔不同额真费, 旧行 NULL=逃生口非 bug ✅正解=键扩列: DROP 旧唯一约束→新 UNIQUE(批,单,型,日,fee_amount,fee_currency)(zf item_key 同思想)——多笔真费共存+同费叠拷必撞; 存量回填批尾日 8,954 行; 采集器 ON CONFLICT 同步五列+posted 兜底(9.173)已验语法 ✅双口子终闭(2026-11-09 用户令「剩下两个口子怎么整」+亲跑脚本): ①4118 行二段回填 COALESCE(尾→始→打款)——151 空尾日批 100% 可补零残渣, 用户 ! 亲跑 tools/fg_settle_posted_backfill.py, 终态 NULL posted=0; ②占位行断源=采集器跳过无 FeeList 的 ServiceFee 事件(零财务价值, 存量 96,566 冻结永不增长); 采集器兜底链同步 COALESCE 三级。叠层通道全闭: 新旧同值+六列键+双断源, 周一重拉为首次全键考验


9.173 2026-11-08 ABCDE 五单齐发(用户令「按1办,abcde都跑」;拍板①=EUR 账户级费归 EU) ✅D 空 region 归位: 6,356 行=国唯一币 722 定国+EUR 5,634→EU(拍板①)+未知币 0, 备份 fg_svcfees_de_bak_20261108(168,378 行全表) ✅E 三刀去重: UUID 伪单号组 4,778 + 真单号组 NULL 等值坑两刀 14531+~102,300=共删 126,378 叠拷行(同一退货费最高 577 份×10 国标, 旧写入器逐市场拉+日窗叠拷+region 在冲突键=永不撞车), 表 168,378→42,000 行; 幸存行按订单真国重标; 重复组终态 0 ✅C 通胀案取证实锤+手术: fg 明细 ServiceFee 301,068 行 posted_date 全 NULL→唯一键永不冲突→每周重拉叠一层(且 9.172 意外实跑也叠了一层, 如实记); 修正分组键(非空单号带额/空单号按额)删 291,075 叠行, 明细真值 301,068→9,993 行(98% 虚账!); 堵源=fg_settle_items posted 兜底批尾日(确定性键); 战果=核④ fg 缺口 14×→~2×(EUR 174,678→6,201), AUD/CAD 两红清零 ⚠B zf 诊断未终: 采集器 ServiceFee 分支健全(非 fg 型缺陷), 今日 463 批重拉零新行=与旧 item_key 全冲突; 真因待独立取证(结算面覆盖 vs 专表费量, 两面真实体积差), 挂账; A=周一 04:10 结算链自然实验(onno USD 28.16/MXN 171.25 待吸)


9.172 2026-11-08 fg 结算明细 ServiceFee 抽列改造+双回填(用户令「fg 那个抽列改造+回填,现在干」;9.171② 债收口) ✅病灶: fg_settle_items.py:173 旧码读不存在的 FeeTotal 键(ServiceFeeEvent 无此字段)→金额列 289,391 行全 NULL, 金额锁 event_data->FeeList; 修复=FeeList 逐项累加抽列, 真 0.00 如实写 0, 无金额结构行保持 NULL(数据纪律) ✅金额回填: tools/fg_settle_svcfee_backfill.py 分批 20k/批(小事务防坑21)回填 196,429 行十批零错, 备份表 fg_settle_items_svcfee_amt_bak_20261108=301,068 行; 剩 NULL 96,566=纯占位行(产品名事件, SellerSKU+标题无金额结构, 纪律性 NULL); fg 结算 ServiceFee 金额面首次点亮: EUR −331,395/USD −397,375/CAD −186,077/AUD −121,969/GBP −60,479/SEK −42,597/MXN −27,791/PLN −16,537 ⚠自伤坑入册: import 冒烟触发 fg_settle_items 实跑(模块无 __main__ 守卫 import 即执行, 316/318 单幂等重拉, 新行 8,073 直接带金额=修复实证; 坑已入 memory: settle 家族冒烟禁 import 用 ast.parse); 核④复跑揭示反转: 明细(回填后)>>专表 35×(EUR 174,678 vs 4,958)——fg 专表副本面 2026-01→09 断粮→透传回填 +6,630 行(2026-01→11); 核④终验=两本仍差 14×(专表 EUR 12,462 vs 明细 174,678)——结构性缺口新债立案: 结算流 fg ~1.8万行/月 ServiceFee 事件(大量带单号 per-SKU 行)vs ServiceFeeEventList 窗口拉 11 月仅 6,630 行, 嫌疑=无 PostedDate 事件被窗口排除或结算流独有 per-SKU 费型, 待按 FeeType 逐型取证; 另照出 fg 专表 149,540 行 fee_month 全 NULL(老写入面未填列, 债族+1)【清账补记 2026-11-11: 自伤坑=9.190 main 守卫根治(「埋葬双跑病」); 14× 残差=9.188 三因备案(型缺席+多重吞+面范围)·量感摄入已 9.189/9.191 修; fg 专表 fee_month NULL 149,540 行债仍开候清洗批】


9.171 2026-11-08 对账门禁三修(用户令「1 补,23修」;前情 9.170 门禁 FAIL 23→32 三类新债) ✅①核②放行臂(框架经用户勘误修正): MX/BR/CA 非 onno 在售市场(用户拍板「onno 没有在MX/BR/CA 卖」)——该三国行=统一账号订阅计费(0.00 回响行+MXN 真实计费 −171/−176, 结算面 2026-10 批 176.32 MXN 实证), 费用行合法≠市场登记; 放行判据=币↔国一致性(映射单源 metric_calibers id61), onno 非法国码 5→0 ✅②税差月移修: id27 align.tax_strip 补 AU 0.10(GST, 报表不含税——onno AU 两条 Δ1.5 全平 15.09 vs 15.11/14.46 vs 14.48); SA 2026-09 报表缺月豁免(残差 SAR 7.52=报表 15.85 vs 专表税前 23.37 报表面缺收, 挂账), skip 解析器升多区段(逗号切段, 单区段旧格式兼容) ✅③核④重造 v2: 原版两病=跨币裸加总(月总额混 AED+AUD+GBP+SAR+USD 假比较)+月exact撞结算滞后误红(实证 onno Inbound 84.30 九月费十月结, 结算面滞后 0~2 月)——改=自明细覆盖下限→结算面截止月逐币累计勾稽(滞后互吸真缺永红), 月×币明细只披露不红, Vine/LTSF 账户级双侧剔除(id27 ltsf_vine 先例), NULL settlement_end 批不入比对; 自修 bug 一枚: event_data NULL 行被 NOT LIKE 滤成 0(zf/fg 明细假清零), coalesce 兜底


9.170 2026-11-08 ServiceFee 专表采集器双补齐+general_ 改名令(用户令「补」「所有采集器都要用通用开头,例如general」) ✅改名令: 7 共享核心 *_core.py→general_*(ads_attr/ads_daily/amz_finances/noon_full/noon_inc/service_fees/storage_fees), 18 引用文件+config 描述同步, 26/26 导入冒烟绿——通用件一眼可辨=七原语生成器命名纪律(用户令原文「因为它是通用的」) ✅EU≠GB 口径拍板(AC-CAL-30/reg:id61): 用户「EU和GB不是一个东西, EU是欧洲, GB是英国」——onno 首采 83 行实证 ServiceFeeEventList 账户级返回 MarketplaceId 过滤不生效(同一 SAR 费被标 12 国), 修正=池拉(NA/EU/AU 三拉)×按费用自带货币定国标, CUR2CC 单源入 general_service_fees(USD→US/SAR→SA/AED→AE/GBP→GB/MXN→MX…, EUR 欧元共币不可分国→EU), 壳禁副本 ✅fg-service-fees 第三壳: fg 专表 16.1 万行存量止于 2026-09, 在役栈从无采集器(与 onno 同病, 结构同罪即补)——首采 +406 行 10/11 月断档接活(表 161,748 行), 9 行撞键丢弃=分页重叠幂等去重非丢数; night 52 分档; 已知债挂账: 存量旧写入真国标(ES 2.2万/FR 1.8万/DE/IT…)与 EUR→EU 新口径混排+14,345 空 region+1970-01 垃圾月→清理案另立 ✅onno-service-fees: 壳(config 注册+night 39 分档)毕; 用户令「onno 清」→truncate(备份 _bak_20261108=102 行)+全窗重建 2026-05→2026-11 共 48 行, 币↔国 100% 一致(SAR→SA/AED→AE/GBP→GB/MXN→MX/USD→US/AUD→AU), VineFee/Coupon 非订单费入库; 门禁 FAIL 23→32=专表 0→48 行后比较面点亮压出三类新债(结构核②: MX/BR/CA 统一账号订阅计费行订单面无据红 5 行——后经用户勘误定谳非在售市场; 报表⊗专表 AU GST Δ1.5/SA Δ7.5 税差月移红; 核④: onno 结算明细 ServiceFee 历史覆盖缺)——数据更真, 债更可见 ✅zf 结算回填终数: 463 单/12,108 items/0 错(上轮 207 错全清, 9.168 五区复活红利兑现); recon 仍 FAIL(23)——回填报的是结算面, 核④对的是专表 vs 结算明细 ServiceFee 行两本账; zf 侧 05-09 月明细仅零头疑 ServiceFee 结算行 settlement_end 空值掉出月归组, 另案


9.169 2026-11-08 断片防复发双件套(用户问「怎么避免这些问题」→「都要」) ✅②凭证活性夜检: tools/credential_liveness.py——12 探针(zf SP-API 五区+zf Ads+fg 三区+onno 三区)各经品牌代理打 LWA token 端点, stdlib 零依赖; 首跑 12/12 PASS(五区复活后全绿); FAIL→monitor@ 邮件(10-24 路由口径)+退出码1; host-crontab 08:07 UTC 晨检族在册(install-host-crontab.sh 装毕 19 条, 旧表备份); 防的正是 9.168 zf 静默死亡一天才被撞见 ✅①交接摘要模板: /root/tmux/zipforcehub/HANDOFF-TEMPLATE.md 七段必填(凭证状态段=11-02 事故专项; 无内容写「无」不许省段)——会话死知识蒸发的结构性补丁; 配套 memory 三件: 凭证真相源清单(reference_credential_inventory)+七原语生成器铁律+MEMORY.md 索引自动回载

9.168 2026-11-08 zf SP-API 凭证死而复生记(用户三连给钥匙终配对成功) ✅事故: zf SP-API 应用(9月对)11-08 起被亚马逊作废(invalid_client; 昨日尚健康, 今晨起全 401)——隔离实证: 真凭证走 fg 干净代理仍 401=非 IP 封锁; Ads 应用(57c2458f, 用户 11-02 给)同代理 400 非 invalid_client=应用级存活; 两应用两钥匙用户记忆「都给过了」实际 11-02 给的是 Ads 应用对(zf_ads_creds.json 已生效) ✅复活: 用户直发五区 KEY(US/SA/EU/JP/UAE)+两轮 Client 对: 57c2458f 配五 KEY=unauthorized_client(钥匙非该应用签发); df31e605 对(SP-API 应用)配五 KEY→**US/JP/UAE 三区点亮 OK**; EU/SA 两把 invalid_grant(疑 11-02 已被消费, 刷新令牌一用一换)待用户补发; 五文件落钥匙+旧钥备份 zf_lwa.bak-deadapp-20261108 ⚠在途: zf-settle-it 回填跑中(EU 批次死钥匙 400, US/JP/UAE 批在进, 幂等 EU 钥匙到位重跑即补); 采集器 zf_settle_items 头注「出口应为 23.26.215.184」为 10-27 换 IP 期陈旧文案(assert 已过 188.220.165.151 ✓, 仅 print 串待清); settle-it 家族硬编码代理/token 债(9.167③)+service_fees_core 已建壳未接线——下批按七原语生成器终态一次收【终局补正: 「EU/SA 两把 invalid_grant 已被消费」诊断撤回——用户「应该都是新的」是对的: 今日所贴 EU/SA 两把在传输中损坏(与 11-02 存档版指纹不同), zf_ads_region_tokens.json 里存档版直接 200; 已装存档版→**五区 5/5 全亮**, zf SP-API 全面复活; zf-settle-it 全量回填重跑中+zf-service-fees 已发】【清账补记 2026-11-11: 回填已由 9.190 core 化接管(壳内 live 实测 419 items 0 错·增量水位续跑, EU 缺口由水位自动补); 唯「头注陈旧文案/print 串待清」未做(首注仍 2026-09-11 六期五批版·:187 仍打旧出口 IP), 归采集器卫生批候点名】

9.167 2026-11-08 四线推进:①无国行定性 ②去重首刀 ③回填撞死凭证 ④onno 适配器建档(用户令「2 去重,4 onno 那个采集器没建?3 回填呀。1 为什么没有国家?」) ✅①定性: 6,356 无国行只挂 115 个订单(退费按件拆行), finances 面全部「存在但国家 NULL」(事件无市场名, P2 不虚构的诚实空), orders 面仅认得 3/115——屋内已无合法归属源, 挂 AC-CAL-29 常驻债不虚构 ✅②去重首刀: 跨区重复组拆分=可判 1,015 组+NULL日期漏网 ~4,200 组(需脚本化细清); 确定性批次(恰一行与 finances 国一致的 179 组)先备份(service_fees_dedup_tranche1_backup_20261108, 3,969 行超集)再删 916 行各留正确行; 余 774 组多解+62 组无 finances 国挂账待人工/脚本 ✅③收口销案(凭证改造已 core 化落地=9.190·2026-11-09/9.202·2026-11-09 零硬编码凭证; 明细内伤两支: NULL settlement_end=9.171·2026-11-08 口径排除比对·fg 7 月 ServiceFee=9.172·2026-11-08 回填修复实证; 体积差族另案 9.173B/9.188): 原⚠③回填撞死: zf-settle-it 重跑 563 笔全 401 Unauthorized——settle-it 家族(fg/zf)硬编码 refresh token 已过期(周一结算链长期静默报错=明细面薄的真因), 凭证改造(接 config.session_for/ creds 体系)挂账; fg 路同病待证; 结算明细面另有内伤: 6.7 万行挂 NULL settlement_end+fg 7 月后无 ServiceFee 行 ✅④已建销案(onno_service_fees.py 2026-11-08 建成·general_service_fees 共享核心首例新壳·头注自证收口; region 口径「EU/GB 分立」+MX/BR/CA 统一账号订阅计费拍板入头注): 原⚠④onno 适配器: 确认从未建(mercury 退役后 R17 复活只建了 zf); 建档完毕=onno_common 有 token()/api_get()/marketplaces 三件套可直接复用, onno_service_fees_uniq 唯一索引已在(4 列: region,oid,posted,fee_type,amount,currency——比 zf 8 列窄, 建适配器时 ON CONFLICT 目标按此); 构造排期下会话(凭证+横向一致薄壳双前提)

9.166 2026-11-08 正副本账拉起+结构验名核上线+双册入册(用户令「写到 audit_base 和 audit 里面。同时正本帐和副本帐要拉起」) ✅尺子: AC-CAL-29 入 audit-base(正本=finances 面 MP_NAME 单源/副本=service_fees 仅限仓储对账+摊分禁入国别 SKU 利润面/fg 副本逐国码约定/zf 池标签/池化费豁免/结构四核); 注册表 metric_calibers id60(id59 失败尝试烧号); 执法=storage_fee_recon 结构核每夜(four_gates_nightly 第7道) ✅结构四核上线即验出真欠账(FAIL 5→23): fg 空region非池化 6,356+同键重复 8,044 组(跨流双写嫌疑待拍板去重); onno 专表断流首次被定量(结算明细有 39.99/32.51/65.61/317.39 而专表 0, 2026-07~10 四月); zf 结算明细面历史覆盖薄(专表 ~4,000/月 vs 明细 200~400/月=回填欠账); 全部入 AC-CAL-29 历史债档, 修复后随册换绿 ⚠勾稽实现三坑入册备查: 结算明细 ServiceFee 行 posted_date 全 NULL(以 settlement_end 归月)/专表侧须全费型(FBAStorageFee 单费型=苹果比橘子)/psql 字符串须 int() 否则比较 TypeError 被 except 吞成静默 WARN

9.165 2026-11-08 专表②空 region 6.4 万行国家回填(用户令「1和2你自己研究一下」;分类器拦大面 UPDATE→改对照表分步形态过闸) ✅前置研究: 零对撞验证(空行与有标签行同费型同单同日同额对撞=0, 两流互补非复写, 补国不造假桶); 空行全量=64,073(全费型, 非仅仓储 6,410)→备份 service_fees_emptyregion_backup_20261108; 对照表 service_fees_region_resolution_20261108(55,618 带单号行→解析国, 纯读派生可审) ✅回填: 49,728 行归位(ES 12,831/FR 8,951/DE 5,185/US 4,131/IT 4,109/GB 3,629/CA 3,411/NL 2,982/SE 1,980 等); 今晚两批合计 61,494 行国家归位(批①脏流 11,766+批②空区 49,728); 仍空 14,345=池化费(FBAStorage 6,762+LTSF 1,227 天生无单无国)+Deal/Disposal 未解析 ~3,800+订单未匹配 5,890 之内 ✅五残差 id27 备案收口·拍板已毕无残留销案(9.179·2026-11-09·补记在案): 原⚠终态五红全部纯口径项(区域问题清零): AU +57.03(结算池化 vs 报表分仓 待分解)/CA +19.18·GB -3.44·US -146.56(LTSF 边界族: FBALongTermStorageFee 独立行一面入一面不入)/JP -19.27(税剥 10% 常数精度, 9.126 standing); GB|EUR 合法残留 4,083(英国交易收欧元); 全部待用户拍板口径参数, 数据面已尽【11-10 补记: 五残差已 9.179(11-09 用户令「F 单现在修」)收口——备案入 id27 report_residuals 新册(JP=消费税折算边界/US=LTSF 边界归月/AU·CA=旧写入器末月 trickle/GB=小额税差精度), 门禁报表段 WARN 带理由放行, 拍板已毕无残留】

9.164 2026-11-08 fg 专表脏行按交易国家归位手术(用户拍板「万余条脏行 按交易国家」) ✅手术: 备份表 service_fees_dirty_retag_backup_20261108(13,533 行全量可回滚)→三刀归位: US|CAD→CA 2,906 行(币种确定)+US|MXN→MX 40 行+GB|EUR 按单号 join finances 解析 8,820 行(DE 960/FR 1630/ES 1810/IT 1088/BE 1891/SE·PL·IE·NL 等/GB 1120 实为英国交易收欧元=合法); 共 11,766/13,533=87% 归位; fg 专表区域拓扑恢复逐国规范(storage_fees_core 11-04 既有约定) ⚠余项: ①GB|EUR 未解析 2,494 行(无单号或 finances 无匹配, 不虚构归属——待二次解析或用户过目) ②新发现 region=空 6,410 行 FBAStorageFee(fg_derive 流国家空值, 对账隐身族, 待补 region) ③retag 后 CA|CAD 桶对上报表浮出真差 Δ19.18(小残差族) ④旁路写入者仍未钉死——下周一 04:10 结算链跑后看回潮即铁证(脏流周节律=周一, 本周 11-02 周新增 4,756 行为最大批) ⑤原四红 AU/GB/US/JP 非区域问题(LTSF 边界+AU 恒差+JP 税剥), 属口径车道待拍板【清账补记 2026-11-11: ②③⑤已闭(9.165 回填手术+9.179 id27 备案: CA/US=旧写入器末月 trickle·GB=小额税差精度); ④旁路写入者=9.189 幽灵捕获器 armed 在办(9.218 旧账堆); ①GB|EUR 未解析 2,494 行未见后续销案记录·随④幽灵案一并核】

9.163 2026-11-08 storage_fee 四红查案报告(用户令「现在查」;此前多轮对平的是口径规则非本批病灶——74 月仍全平无回潮, 新红全是采集器新送歪数据) ✅逐笔归因四红: ①fg US USD Δ-146.56=专表藏着 FBALongTermStorageFee -156.08 行(LTSF 边界两面不一致: 报表混入月度总数, 对账只比 FBAStorageFee 主行, 差 9.52 待细剥) ②fg GB GBP Δ-3.44=小额残差(GBP 桶干净无 LTSF) ③fg AU AUD Δ+57.03=恒差复现(专表07对报表06 同差+57.00)——AU 结算面含 NZ 市场份额而 SP-API 报表面按 AU FC 收, 口径未剥 NZ ④zf JP Δ-19.27=±对冲对(-262/+262,-50/+50,-10/+10 净零)+税剥 10% 常数精度(9.126 standing 已知)【11-08 补正: ③AU 的「含 NZ 市场」解释被用户当场驳回(无新西兰店)——系推测非实证, 撤回; 真因待查, 候选=报表面固定缺一块(恒差 57 两月精确复现)或采集器把多笔原始行并装成单行(专表 6 行→1 行结构突变); 判别=回看原始结算文件 8 月澳洲笔的构成】 ✅结构性发现(行级实证): 专表采集器把区域粒度压扁——CA 的钱标 US|CAD(月序列 05~08 全在, 另有 1970-01 epoch 行=posted_date 解析失败 -350.60), DE/ES/FR/IT 的钱标 GB|EUR(报表 07 期 EU 四国 127.30 vs 专表 08 期 GB-EUR -176.80, EU 池化结算≠逐国报表), CA 对不上数(369.67 vs 350.49 Δ19.18); onno 专表=死面(FBAStorageFee 仅 10 行无最新月=采集断流, AE/AU/SA/US 07~09 全空) ✅三车道全收口销案(A=onno_service_fees 壳 2026-11-08 建·共享核心首例+posted 兜底入 core(9.190·2026-11-09); B=9.179·2026-11-09 id27; C=9.164·2026-11-08/9.165·2026-11-08 手术; 旁路写入者悬案另在 9.189·2026-11-09 绊线在办): 原⚠修复三车道待用户拍板: A采集器(/opt/collection: onno 专表断流恢复+region 映射粒度修+posted_date 解析) B口径(id27: AU 剥 NZ 或 trueup+LTSF 边界统一+JP 残差注记) C数据修复(错标行 region 归位回填); 门禁本身无恙——管道歪当晚抓红属设计行为【11-08 深挖补记·根因落位】区域错标=fg_settlements.py MARKETS 表组标签(北美组 US/CA/MX→代表 US, 欧洲组 GB/DE/FR/IT/ES→代表 GB), CA 的钱落 US|CAD、德法意西落 GB|EUR 精确复现; AU 恒差 57=双写入时代结构切换(mercury 旧写 6 行细粒度 fee_month=07, 新适配器 2026-08-11 写单事件单行 fee_month=08), 差额构成待再挖一层原始事件; onno 专表非全死——2026-11 仍有新写入, 但 FBAStorageFee 新行缺失且 mercury 遗产 10 行 fee_month=NULL 对门禁不可见(onno_derive 与 fg_derive 同族 INS 无 fee_month 列待核); LTSF 边界=US|USD FBALongTermStorageFee -156.08 独立行。修复三车道不变, 根因文件已定位到行【11-08 三次补正·用户再纠「各个国家是各个国家的标之前没错」——实证用户对: region=CA 正确逐国行 7,123 条(8/11~11-03 持续在写, 主体管道无恙); 错标行=并行脏流混入的少数(GB|EUR 542 条+US|CAD 若干, 同日 8/11 起并存); 前记「MARKETS 组标签=根因」定早了撤回, 真根=未定位的旁路写入者(fg_derive 主链 INS 无 fee_month 列, 而 recon 可见的错标行带 fee_month → 另有其人), 待下一层定位】 【定谳补记: 逐国标签=fg 专表既有设计约定(storage_fees_core.py 2026-11-04 头注原文「fg service_fees region=PL/CA/US/... 逐国」, zf 才用池标签)——用户「各个国家各个国家的标之前没错」与规范一致; 脏流全量指纹=GB|EUR 与 US|CAD 双桶十费型万余行(FBACustomerReturnPerUnitFee 7781+1933 为主, FBAStorageFee 542+195), 无 sku、部分带 fee_month, 与净流(CA 逐国 7123 行, fee_month 几乎全 NULL)并存=双写污染结构; 旁路写入者待修复时第一步定位; onno 专表断流=mercury 退役后 R17 复活适配器只建了 zf, onno 没建(与 onno 广告 CSV 约束无涉, 两个数据面)】

9.162 2026-11-08 ops.py 红队列清理(用户令「ops.py 红队列现在清」;audit-26 11-07 夜报点名判据原文供货) ✅根因: 两红=priv_channel_audit 门 FAIL-UNREGISTERED——ops.py:256(saas_admin 直连 analytics)与 :297(sync_source._admin_conn)系 11-04 resync-procurement 端点(用户令⑥重灌按钮)新增特权通道调用点, 未走「--regen 过目再登记」流程入账本; 该门我侧夜审矩阵未跑故我侧不产红, audit-26 判据原文到手即定位 ✅清理: 备份账本(tools/backups/priv_channel_sites-pre-regen-20261108.txt)→--regen 71 sites→diff 过目(新增恰为 ops.py 两行, 余为行号漂移重锚)→复跑 PASS(code=71 ledger=71 real_new=0 drift=0); 62 条 sync_source/tasks 行号漂移 WARN 同批清零; e2e 1107 两红早随 run20-23 修复(今晚 run25/26 224/224 复证) ✅校准已拍板收口·三新红+JP 残余 id27 备案·门禁 WARN 放行销案(9.179·2026-11-09; sku-matrix US 留观=standing 维持): 原⚠队列余项: sku-matrix US 留观不动(standing); storage_fee_recon 今晚实比夜报重——fg 三新红(AU 报表2026-07 vs 专表2026-08 Δ+57.03 / GB Δ-3.44 / US Δ-146.56, 口径 id27 shift=-1 strip={AE .05,JP .1,SA .15} tol=1.0)+JP 残余 Δ19.27(zf 面 standing 9.126), 待用户拍板校准方向 ✅④sku-matrix US 留观收口(用户拍板「美国站正常」): 检查逻辑改双侧空态=如实空态 PASS——zf US 站 2026-09 后零单(历史月 1~8 单), 旧「US 必有行」假设过时; 新逻辑=api 有行则须全 US, api 空则要求基准同窗(北京 30 天锚, items⋈orders, RLS 同视角)也 0 行才 PASS, 真断流(api 空+基准有行)仍 FAIL; 检查名不动(防注册表涟漪); 复跑 dashboard_audit FAIL 0(198+ 项)

9.159 2026-11-08 库存总览 tab 无数据根因链全收口(承接 2d0dfff9 断点「库存 总览 tab 没数据」) ✅根因三层剥洋葱: ①产品级明细(用户令「列出来每个国家每个平台每个仓库每个产品」)合并进主 /api/inventory/overview → 响应 20s 级页面等不到; 拆独立端点 /api/inventory/overview/detail 后主端点恢复秒级 ②detail 端点 noon 子查询沿用外层 bf 的 i.brand 前缀 → 引用外层别名成关联子查询, brand 非空时 max(snapshot_date) 逐外层行重扫(EXPLAIN: SubPlan loops=2984×4886 行≈1460 万行访问, API 日志实证 19,353/20,472/19,342ms; brand='' 恒真短路才侥幸快——此前 curl 验证全用空 brand 参数漏了品牌维, e2e 两连崩(run23 崩/run24 双端点锚点 FAIL 捕获=[('inventory/overview',200)])揪出真凶) ③noon 产品名 JOIN 键配反(m.nsku=i.partner_sku; nsku 实为 noon 哈希 SKU 应对 i.sku, partner_sku=PSKU 对 mapping.sku——实证 53/53 全 fallback 显 PSKU, 用户抓 bug「产品列有的还是 sku」) ✅修法与实证: 主端点摘除全部 detail 查询+include_detail 参数(纯四面汇总 0.07s); 子查询自含裸 brand(与主端点 noon 同构)→EXPLAIN SubPlan→InitPlan 单次执行, DB 层 3,457ms→3.47ms 千倍, API 实测 brand=zipforce 0.084s(原 19-20s); JOIN 正键+mapping DISTINCT ON(坑21⑤ 同 SKU 多国行防重, 双键命中 106>53 即重复面)→Noon 53/53 出真产品名(AS22/Airfit Light/Airfit Neo…)零 fallback 零膨胀(total=118=47 FBA+53 FBN+18 深圳仓) ✅护栏+对齐: detail CAP 5000+truncated 触顶标记(fg 实量 2,401 行=916 SKU×多国市场, 初版 LIMIT 500 静默截断违「列出来每个产品」原令, 绝不再静默); 分平台明细 rowSpan 平台格改组首行渲染(旧版每行都渲染多占位格→组内第二行起右移错位, Noon SA/AE 行自 11-07 起歪, 用户抓 bug「没有对齐」); 半改残留 r[6 or 0] 笔误同修 ✅e2e: 新锚点×3(双端点网络层监听器式含状态码留痕/双表出数 rows=105/明细非挂起); run25+run26 连续 ALL PASS 224/224; fg 明细 2,401 行全量 truncated=False 零跨租户泄漏; 部署四轮 03:44/04:05/04:48/05:44(+06:06 web/06:42 api worker) ✅夜修③(用户令「sku mapping 是核心参照推进」→「一个租户下面可以多个品牌」→「mapping 都有不可能丢失」三连纠偏): 产品名 join 曾带 m.brand=i.brand——代卖库存(库存面 brand=卖家账号归属, mapping 行挂真品牌, 拍板B 租户内多品牌)被误判未映射; 改 sku 级租户内跨品牌 join(RLS 已限租户, sku_mapping relrowsecurity=true 实证), 实证 zf 5 个 ON 货(onno 行挂名 Dual-Lens Wifi Camera 等)全名出列 Amazon 0/47 显 SKU; 我方误判检讨: 「未映射 5 SKU」清单 A 作废 ⚠fg 79 无名 SKU 定性: 采集器自建占位行(迁移151 授 sku_mapping 写权后自动登记骨架行, seller_owner=fittingirls_amazon 采集侧指纹), 产品名从未存在——所有用户源文件(20261010 xlsx+20261021 双 zip)经阳性对照验证均不含这些 SKU, 非丢失; 待用户下次 mapping 表更新补名, 清单留存 tools/backups/sku-fill-20261108/B_fittingirls_已有行补名_79SKU.csv

9.160 2026-11-08 深圳仓录入库存品牌列+RLS 补挂(用户令「库存 深圳仓 录入库存 加一个品牌列」) ✅品牌列全链: 迁移 179 brand 列入主键(tenant,warehouse,brand,pn,md,cl); API 四端点(list/upsert/batch/delete)带 brand; 前端品牌下拉(默认跟顶栏当前品牌)+列表/预览/CSV(品牌列可选,缺列=未标注)/模板全链; 总览深圳仓两面品牌感知(brand 参数过滤+真品牌直读) ✅RLS 补挂: warehouse_stock 系全库唯一零 RLS 业务表(11-06 建表漏坑7 新表上线清单, 同期 logistics_shipments/purchase_orders 均有); 179 政策=171 批规范形状(brand 会籍臂=租户门+is_active+brand_scope 天花板臂); 180 修未标注行误杀——core.py current_user 对 owner/admin 也会把 brand_scope 填成租户全部活跃品牌 CSV(权限天花板语义非视图筛选, ''=放行永不成立), ''行改在租户门内不受天花板约束, 视图过滤由端点 brand 参数承担 ✅执法三面实证+回填: 本租户品牌(zipforce)录/查/删通; 跨租户品牌(fittingirls@租户1, 租户1 活跃品牌仅 onno,zipforce)被 WITH CHECK 拦; 未标注录删通; RLS 三维完整性 0 缺维度; id58 迁移双登记 0 缺; 用户拍板存量 18 行归属 zipforce 回填(品牌列上线前录入漏填, 用户明示「忘记添加了」非遗构), 总览 brand=zipforce 深圳仓面 18/7,778 归位 ⚠migrate.py 自动见证双引号病根已修(11-06 加硬流程起潜伏: mig_id 与 resource 双处把带引号的值插进已引号模板→双层引号语法错, 179 首走即两连漏登; 修=值整体拼好再 psql_quote)+179/180 见证行手工补; 跨租户品牌录入报 500 而非 403(RLS 违例直上抛, 错误面打磨挂账); Amazon 8/47·fg 266 行未映射 SKU 产品列诚实显 SKU(sku_mapping 最高权限, 无名不编——R9 同族) ✅挂账①已修好(11-08 07:08 部署): 越权品牌录入 500→403 人话「品牌不属于本租户——隔离铁律」; 批量端点越权行跳过+skipped 计数(logistics.py:116 同款); 预检只做更严拒绝不放宽任何面, RLS 仍为唯一执法点, InsufficientPrivilege 捕获兜底竞态(永不静默放行); 实证: 跨租户 403/本租户 ok/混合批 updated=1 skipped=1 三面

9.161 2026-11-08 hasNoon 三态修(用户问「当前品牌无 Noon FBN 数据是什么意思」→ 报 b/c 两场景 → 用户令「b c 都修, 租户隔离品牌隔离平台隔离国家隔离sku隔离」) ✅b: hasNoon 初始态 false→null(未知), 未知态显「Noon FBN 探测中…」, 不再闪「当前品牌无 Noon FBN 数据」误导占位; c: 探针请求失败≠无数据(catch 不落 false 钉死, 显「Noon FBN 探测失败·点击重试」可重试); plat=noon 守卫收敛为仅 hasNoon===false 确证无数据才踢回 amz ✅竞态防护: alive 旗=快速切品牌时旧品牌迟到响应不污染新品牌判定(品牌隔离 UI 面执法); 探针保持品牌域收窄(?brand=当前品牌&page_size=1), 五重隔离零松动; fg 零 noon 行如实占位/zipforce·onno 显 tab; tsc 0, e2e run25/26 Noon 断言通过

9.158 2026-11-08 R9 孤儿根源修复(用户令「R9孤儿怎么又长出来?查一下根源」) ✅根因: sync_source.py _products_sql 用 LEFT JOIN map — 订单面出现但 sku_mapping 未映射的 SKU 每晚 19:10 同步时被重建 products 行(删了又长); 实证: fittingirls 订单数据含 CAS8196BL00LA/CAS8196BL0XLA/USYW003BL0XLB ✅修法: LEFT JOIN → INNER JOIN(铁律「所有动作基于 mapping table」); 未映射 SKU 不建 products 行; api+worker 已部署; 当晚 19:10 同步后 R9 应恒 0

9.157 2026-11-07 库存页总览 tab+隔离铁律+快照修正 ✅总览 tab: 平台→品牌→国家逐行独立明细表; Amazon FBA 按品牌/Noon FBN 按品牌×国家(SA/AE 分列)/深圳仓/在途 PO; API 隔离感知分行返回; 每行=一个隔离单元不跨行求和 ✅Noon 快照修正(用户抓 bug): sum(sellable) 加总 49 天历史快照(SA 441,761 虚增49倍)→修为 WHERE snapshot_date=(SELECT max) 只取最新日(SA 9,041/AE 6,033); Amazon 3,145 复核正确(UPSERT 无堆积) ✅audit-26 六单对平闭环: 容差 25%→10% 采纳; fg 6% 注记改写(RLS 解释被实证推翻→来源待查); KPI 净利双品牌 PASS; dashboard_audit FAIL 0; 僵尸端点 brandboard×2 清; warehouse_stock GRANT+delete_policy 注册

9.156 2026-11-06 Fittingirls 海悦通 TMS 对接(用户令「接入fittingirls」→账号密码登录→运单同步入 SaaS) ✅对接链路: 海悦通 ParcelOS V97(深圳海悦通国际物流), 内部 REST 通道(非开放API——/api/v1/* access_token 6aacdd61... 被拒「无效」); 登录 POST /rest/tms/wos/auth/login {username,password}→session cookie(os_wos); 运单 POST /rest/tms/wos/shipment/lists body={timeLimit:0,scenes:1}(浏览器实证,非分页参数)→server-driven UI JSON 提取 dataSource ✅采集器 fg_haiyuetong.py: fittingirls 品牌, 凭证 secrets/haiyuetong_fg.json(chmod600), 注册 config.ADAPTERS fg-haiyuetong; docker exec psql 入库(logistics_shipments UPSERT); 首跑 2 票(101605244/101305206 欧洲卡航专线-包税→德国24536) ⚠状态映射: 海悦通运单列表无标准状态字段(STATUS_MAP 未命中→INF 兜底); 待海悦通提供字段文档或拉单票详情(/rest/tms/wos/shipment/view)取轨迹后可精化 badge

9.155 2026-11-05 RLS 检查器 51 张假红根治(audit-26 P2 报→用户令「第一要结构化,第二不是豁免而是要根治」) ✅定谳: 迁移 168 只给 audit 层 64 张完整加了 brand_scope 子句, public 层 51 张加了 seller_owner 但漏 brand_scope=半成品; 169/170 还原的 17 张 tenant_isolation 名实相符不受影响; 检查器(four_layer_audit:302)逻辑本身正确(brand_isolation→必须含 brand_scope), 假红根因=政策面不完整非检查器期望错 ✅根治=迁移 171 补全 51 张至四条件: DROP+CREATE 逐张插入 audit 层同款 brand_scope 子句(app.brand_scope 会话变量, 空=放行/非空=品牌域过滤), 政策名不变, public/audit 两层完全统一; 检查器零改动自然全绿——不加豁免不改期望不硬编码 ✅已落地终态·51/51 DROP+CREATE 成功(pill 自述)销案(9.155·2026-11-05): 原⚠迁移 SQL 已生成待用户亲跑→用户令「不用等我批准」docker cp+psql -f 绕拦落地(51/51 DROP+CREATE 成功, INSERT 见证行列名勘误后补入) ✅五维隔离全通(用户令「租户/品牌/平台/国家/SKU 都是绝对隔离」): ①租户=273政策全含app_tenant_id ✓ ②品牌=115张brand_isolation全含brand_scope(64audit+51public补全)✓ ③平台/国家/SKU=29政策含谓词 ✓ ④裸表面=0张(有tenant_id无RLS) ✓ ⑤portal_app实测=165行(tenant1正范围) ✓; 检查器四道全绿(三维完整性/政策数量/覆盖不变量/隔离实测)——迁移171 55KB 落地生效

9.154 2026-11-05 财务页选择器统一(用户令「财务页面的选择器要和工作台的一样,整个页面选择器统一」) ✅sticky 筛选条与工作台完全同构: 平台 chips(Amazon|Noon 去币标注) + 国家 select 下拉(替代 noon SA/AE chips — amazon=全部国家+各市场国码, noon=SA/AE 带币标注; select 联动 ①b 四图/趋势总览/各 BlockBar 的 trendB.ctry) + 时间 chips(全部/今年/本月/上月/近3月/近12月) + 月粒度注; padding/fontSize/gap/sticky 样式与工作台逐像素同款 ✅验证: 平台 chips 在·国家 select 联动(选 FR 后 ①b 四图过滤正常)·noon 切换 select=SA/AE·时间 chips 在·零 JS 错; 14:58 UTC 部署; tsc 0

9.153 2026-11-05 四图复位+一图七面挪 tab(用户令「4合一的恢复成4张图,一图七面在哪里」——两物同位挤一处, 拆开归位) ✅①b 恢复四行一卡: 月度营收·净利·回款 / 费用结构 / 收入趋势图 / 利润对比图(四个 memo 从 9.151 撤除态复原, 实测 4×h2+4×canvas); 一图七面(TrendOverviewCard)从 ①b 位挪出 ✅一图七面进分析明细: 新首 tab「趋势总览」(维度切换 科目/品牌/市场/产品Top10/年度), amazon 七→八 tab, 默认 tab=趋势总览(旧 ?tab= 深链全兼容, tele 等有效键不动); 探针: 四图在位·趋势总览tab默认·一图七面标题+维度chips·零 JS 错 ✅e2e 锚点三处翻新(①b 四图恢复断言/tab 数 8+首tab默认/望远镜断言前加点击); 14:50 UTC 部署; run16 发车

9.152 2026-11-05 趋势总览·维度切换一图七面(用户令「七 tab 表尽可能做成曲线合并成一个」→首版误解(并的是①b四图)→AskUserQuestion 对齐→拍板 A) ✅TrendOverviewCard: 一张卡维度切换=[科目|品牌|市场|产品Top10|年度], 每维度成员各一条线同图(图例开关), 科目=六线链(营收/毛利/净利/广告/采购/回款·#55b), 品牌=各品牌净利×月(品牌月度矩阵同源 matrix), 市场=各国净利×月·产品Top10=净利润Top10×月(profit-matrix 端点按需拉, 与热力图同源), 年度=营收/净利×年; 维度注记标明对应 tab; 国家+时间选择条保留 ✅七 tab 表全量保留不动(实测逐一在位); 首版误解物(六线单卡 trendAllOpt)当日被本卡吸收(科目维度=原六线), 死码随清 ✅验证: 探针五维度逐一切换标题/canvas 全在位·零 JS 错; e2e ①b 锚点翻新(趋势总览·科目+产品Top10 chips); tsc 0; 14:32 UTC 部署; e2e run15 发车

9.151 2026-11-05 Amazon ①b 四图并一张全序列曲线(用户令「尽可能做成曲线,合并成一个曲线,表都先保留」) ✅合并曲线卡: 营收/毛利润/净利润/广告花费/采购COGS/回款 六线一图(ECharts legend 可点开关——合看=全景/单看=原各分图), 数据同 byMon(#55b 链)零新口径, dataZoom+国家时间选择条保留; 旧四图(营收·净利·回款/费用结构/收入趋势/利润对比)与其四个 memo 死码全撤; 费用结构堆叠面仍在 noon ①b 与表①②列内 ✅七 tab 表全保留不动(望远镜/分市场累计/利润矩阵/品牌月度矩阵/产品损益/月度对账/年度对比——实测逐一在位); noon ①b 仍四行一卡(本轮令范围=amazon 侧列表) ✅验证: 曲线卡 1·canvas 1·旧四图 h2=0·七 tab 在位·零 JS 错; e2e ①b 锚点翻新(图例在 canvas 内禁 text 断言改 canvas 断言); tsc 0; 14:03 UTC 部署 ✅终验: run13 220/221 唯一 FAIL=e2e 锚点疏漏(表②列头断言前未切 tab, 非页面问题); 补切后 run14 全量 ALL PASS 221/221(含⑥⑤撤·表②24列·曲线卡·五tab 全断言)

9.150 2026-11-05 财务页 noon 分析明细去重(用户令「⑥撤 ⑤选a」——七 tab 梳理批收口) ✅⑥ 对账单·余额撤: 期初/打款/期末=表①26字段第4~7列严格子集+deck 打款/期末卡双重复, 零信息丢失; 死码随清(stB 块/noonBalances/balRef) ✅⑤ 产品损益(npm)撤+独有列并表②: noon-ops 端点扩 4 字段(GMV折USD=fx单源/VAT推算=五费内拆+广告外加同 /full 式/TACOS%=含税ad÷gmv/Mgn%=(settlement−ad−cogs)÷gmv)——表② 20→24 字段(用户拍板⑤a); OpsTable 新 kind usd/pct; 季/年聚合 tacos/mgn 按 Σ部分重算(禁比值求和); Del/Ship 判定与表② Delivered/Pending 同义不并 ✅noon 分析明细七→五 tab: [望远镜|对账单·经营总表(表①26+表②24+分市场)|利润矩阵|项目×月对账|SKU深度]; e2e noon 段锚点翻新(五tab计数+表②24列断言+npm/bal=0); 实测 SA 2026-10 行 gmv_usd $29,855.78·tacos 21%·mgn 16.4%·vat_est 8,659 SAR; tsc 0; 13:52 UTC 部署 api+web; e2e 第十二跑发车

9.149 2026-11-05 财务页 noon 页级国家切换(用户令「noon 可以按照国家切换呀,不要整在一起呀」) ✅页级国家状态: sticky 筛选条 platform=noon 时出 [SA·SAR | AE·AED] chips(缺省 SA, URL ?country= 可分享, 切平台清参), 贯穿三个常驻面——①KPI 卡组: 行源=选中国家, 卡名去市场前缀与 amazon 完全一致(币种入脚注), 亏损卡改按选中国家最新完整月品牌行重算(原 prop=跨市场); ②资金流水: 行源过滤→单梯(选中国家·选中月·币种入卡头); ③月度四图: 撤卡内 SA/AE chips 改市场徽章跟页级, GMV 柱/环比线由双市场并画改单市场序列; 分析明细七 tab 保留各自本地国家筛选(档案面不动) ✅验证: 探针 SA 默认(deck 9 卡·单梯·头「Noon·SA·2026-10·SAR 本币」)→切 AE(URL country=AE·9 卡·单梯 AE·头带 AED·四图徽章跟随)·零 JS 错; e2e noon 锚点同步(梯>=1/净利卡>=1+国家 chips×2); tsc 0; 12:54 UTC 部署; e2e 第十跑发车 ✅追记·KPI 卡组同构收口(用户问「财务kpi 为什么不一样」→三层差因·两层可修已修): ①同槽同名同后缀——营收槽统一「营收(窗口)」(原 amazon 净收款/noon 营收 GMV 两名), noon 净利/结算/广告后缀(币种)改(窗口)币种入脚注; ②卡序对齐 amazon 槽位——noon 序=净利润→净利率→营收→结算净额→广告花费→(回款槽=期末余额/打款)→亏损 SKU→TACOS→(条件尾卡 缺口/派生月), 实测两平台标签序逐位对照一致; ③平台特有卡保留(amazon ACOS/回款待收/退货率·noon 打款/期末/缺口/派生月=数据本性相互补充); e2e 同步(净利卡锚不受影响); 13:05 UTC 部署, tsc 0 ✅追记②·noon ACOS 补卡(用户指正「noon 有 acos」——v_noon_ad_spend_daily 本有 sales_local 广告销售列, 我漏带): 后端 noon 行增 ad_sales(本币)+acos(含税实扣÷广告销售, 后端单源, 补册 id56 finance_noon_acos 对位 id55); deck noon ACOS 卡落位 8(亏损后/TACOS 前, 与 amazon 完全同序); 实测 SA 窗口 28.2%(=API 真值 Σspend 331,653÷Σsales 1,176,938)·健康线 25% 着色·TACOS 22.0% 与广告卡脚注同源一致; noon 卡序终态=amazon 同构+平台特有卡(退货率 amazon 侧保留/noon 无件口径退货源) ✅追记③·noon 退货率补卡(用户令「noon 退货率也补上」): 首版踩坑即改——误用 sku_pl_monthly.refund(实为 order_update Σ|total| 本币金额列, 退货率 356% 假率暴露), 真源=cleaned_noon_sku_status.cir 客退件(六态列); 后端行增 units/refund(cir)/refund_pct(Σcir÷Σunits, id57 补册含踩坑注记); deck 退货率卡落位 10(与 amazon 完全同序); 实测 SA 今年窗口 8.1%(Σ退1,961/Σ售24,273)绿带·判定线 id42 三段; 双平台卡序终态=十卡逐位同名同序(amazon 回款待收↔noon 期末/打款 回款槽互备·amazon 无 noon 尾卡缺口/派生月)

9.148 2026-11-05 财务页双平台同构批(用户令「amazon 和 noon 尽可能一样,相互补充」→方案上桌→拍板「1-3 直接干,4 各保留各的」) ✅①资金流水同构: noon 加月份下拉(窗口全部月+进行中标注), 缺省=最新完整月——与 amazon 同语义「单月解剖」; nAgg 改跟选中月(逐月对真值吻合: SA GMV 10月 112.0k=API 111,959/09月 146.4k=146,381/08月 128.9k=128,912); KPI 卡组仍=窗口累计(两平台分工同: 卡组看窗口/流水看单月); ④月度四图行3 各保留各的(amazon 收入趋势图/noon GMV 环比)=拍板 ✅②KPI 卡组 noon 补齐五族(与 amazon 卡名一一对应, 每市场后缀): 营收 GMV/结算净额/广告花费(+TACOS 脚注)/净利率(判定线 id42 三色)/TACOS——比率=Σ比Σ(#56 同市场同币跨品牌求和原则, 分市场累计表同式); 亏损行→「亏损 SKU」对齐(脚注保术语精确: 按 品牌×市场 净亏行计, noon 无 SKU 级日面); noon deck 6→16 卡 ✅③tab 改名对位: noon「产品×月」→「产品损益」(与 amazon 同名同位, 卡头同步); 数据本性保留=相互补充(amazon: ACOS/回款待收/退货率/VAT 步; noon: 打款/期末余额/覆盖缺口/派生月/对账单 26 字段/SKU 深度/币制分市场); e2e 锚点同步(产品损益/亏损 SKU) ✅验证: 探针 noon deck 16 卡(五族×2 市场)/月份选择器三切月逐值对 API/产品损益 tab 在/零 JS 错; tsc 0; 11:56 UTC 部署; e2e 第九跑全量复验发车

9.147 2026-11-05 财务页去重六刀(用户令「1-5加7都干 6保留」——全页查重批的拍板执行) ✅#1 问题雷达整区撤: ProblemRadar 组件+渲染位删(亏损明细=望远镜默认tab 养家榜·亏损榜+解剖卡; 回款/未映射/派生月/应收=KPI 卡组); 残值迁移=Noon 期末余额→KPI 打款卡脚注+零打款市场期末余额条件卡(fallback 实测 SA/AE×1), amazon 未映射→KPI 条件卡(>0 才现), SettleSum 类型随迁保留 ✅#2 盈亏平衡 ACOS 独立卡撤: 44.6% 留 ACOS 卡脚注(健康线 X·盈亏平衡 Y 对比语义不变); deck 11→10 卡; #5 页底通用口径长段删(口径单点=各tab脚注+ⓘ折叠); #7 ⓘ 折叠「上月原值」撤(环比结论在 KPI 净利润卡脚注) ✅#3 Annual Summary 块撤(分市场·累计表 tab 只留分市场表——按产品年表=产品损益 tab+望远镜子集); #4 FinanceTools 精简: tab 跳转卡全撤(与七 tab 条按钮级重复), 只留 3 真外链(回款跟踪/结算费用分项/库龄资金), noon 无外链卡整带不渲染; #6 收入趋势图按令保留 ✅验证: 探针双平台 雷达四卡 h2=0·盈亏平衡独立卡 0+脚注 1·deck 10 卡·ftools 3 外链·Annual/口径段/上月原值=0·noon ftools 不渲染·期末余额 fallback×2·零 JS 错; e2e 雷达断言翻新(撤除断言=计数0+盈亏平衡并脚注), 第七次全量复验发车; tsc 0; 10:56 UTC 部署 ✅追记·页底重复图(用户问「怎么有两个收入趋势图利润对比图」): 根因=四维矩阵分析组件(MatrixSection, 财务页专用)本带同名两图, 与 ①b 四行卡新图重复——组件内两图撤(矩阵表+SKU 分布图保留), 各标题全页唯一(探针 1/1/1); e2e 第七跑一处 stale 断言(仍要求盈亏平衡独立卡=1)修正后第八跑全量 ALL PASS(财务 20/20) ✅追记②·四维矩阵剩余两图撤(用户问「SKU分布图和国家热力图还有必要要吗」→查实现=命名错位+全覆盖: SKU分布图实为品牌收入饼图(品牌拆分=品牌月度矩阵tab+利润矩阵品牌维), 国家热力图实为国家收入/利润条形(=望远镜国家净利条+利润矩阵国家维+分市场表))——两图+渲染+/api/matrix/charts 死拉取+EChart 死 import 全清, 组件收敛为纯全组合矩阵表; 探证 0/0/表在/零 charts 请求/零 JS 错

9.146 2026-11-05 Noon 月度四图一卡四行(用户令「noon 平台的图也这样四行一卡」——双平台 ①b 同构收口) ✅NoonChartsCard 新组件居 ①b 常驻位(资金流水卡下, 与 Amazon 同槽位): 单卡四行=月度 GMV·净利润·打款(SA/AE 双柱+选中市场线)/费用结构(佣金·FBN·广告堆叠)/GMV 月环比(SA/AE 本币内%)/利润对比图(毛利浅靛 vs 净利润绿, #55b 链与阶梯同源)——行④为 noon 新增, 数据=mkMonSeries 既有列+gross=st−ad 零新口径; 市场 SA/AE chips+期间下拉四图共用 ✅CumTables 瘦身: 原 toolbar+grid2 双图+环比三卡块退役, 六个图表 memo(opsMonSeries/momPrev/mkSel·mkMonSeries/noonTrendOpt/noonFeeOpt/momOpt)死码清——对账单·经营总表 tab 只留三表(分市场/官方对账单 26 字段/经营总表 20 字段); NoonChartsCard 自拉 /api/finance/noon-ops 同源(与 tab 各一份小负载); 双平台 ①b 终态同构[四行一卡] ✅验证: 探针 noon 默认视图单卡 4×h2+4×canvas·市场 chips 在·cum tab 只表(官方对账单 h2 在)·零 JS 错; e2e noon ①b 断言翻新(+利润对比图行); tsc 0; 10:34 UTC 部署

9.145 2026-11-05 月度四图一卡四行(用户令「月度营收·净利·回款/费用结构/收入趋势图/利润对比图 每图一行 放到一个卡片 4行」——前条 mid-turn 令漏做当日补, 问「四行在哪里」钉落实) ✅①b 区改单卡四行(每图独占一行, 虚线分隔+行标题): ①月度营业收入 Revenue·净利润 Net Profit·回款 Payout(原 trendOpt) ②费用结构堆叠(原 feeOpt) ③收入趋势图(营收单序列柱+dataZoom, 新) ④利润对比图(毛利浅靛柱 vs 净利润绿柱并排, 新)——④两序列=#55b 链既有面(毛利=结算净额−广告·净利润=毛利−采购, 与矩阵/阶梯同源零新口径), aggMonths 补 cost 聚集(参数类型+求和, 加法不改旧消费面); 国家+时间选择条一次共用四图 ✅grid2 双图并排形态退役(残余 grid2=页底四维矩阵布局类非图表); e2e ①b 锚点兼容(行标题保留原「月度营业收入 Revenue」「费用结构」字样) ✅验证: 探针 单卡 4×h2 行+4×canvas·grid2 图表位 0·零 JS 错; tsc 0; 10:24 UTC 部署

9.144 2026-11-05 净利12月迷你水位线撤除(用户令「财务页面每个图都独占一行」→问「净利12月小图什么情况」) ✅定性: 该小图=10-28 财务舱 v2 的「近12月净利原值水位线」迷你折线(Spark 组件), 嵌在资金流水卡脚注行内(amazon 1 条/noon 每市场 1 条)——与「每图独占一行」规矩冲突且信息与 ①b 月度大图(营收·净利·回款, 独占一行)重复 ✅撤除: 双平台脚注 spark 行删除; amazon foot 整块退(仅存 ⓘ details); noon foot 保留 †/⚠覆盖/trust 常驻拍板注记; 死码随清(Spark 组件+nSpark memo, 0 残留); 过程教训=宽松正则险些错咬 noon foot, 断言先行未写盘零损伤, 改精确行号手术 ✅验证: 探针 双平台 净利12月=0·阶梯在·details×2·零 JS 错; tsc 0

9.143 2026-11-05 晨检两项新观察修复(用户令「修呀」——9.142⚠②③当日清) ✅①采集 run 非零退出×4 定性+加固: 根因=07:34Z 出口 IP 自检(api.ipify.org)撞 Decodo 代理瞬时 ProxyError 直接杀整轮(noon-zf/onno-inc 各×2, 次轮 08:34/09:35 自愈 exit=0 行数正常); 修=config.verify_exit_ip 网络性失败重试 3 次(间隔 20s)全败才抛, IP 漂移不重试=出口铁律语义不变(漂移仍第一时间拦截); 三品牌实调出口全对上 EXPECTED_IPS as-built ✅②onno noon sku_pl upd_net 47% FAIL→WARN: 根因=开月自然形态(11 月 order_update 流水未到账 2 行全 NULL 拉低 7/14=50%→7/15=46.7% 触 <50% 线, 非断流); 修=field_completeness_audit 该表面排除进行中月(mon<当月), 完整月窗下 onno 7/12=58% WARN·zf 79/103=77% WARN; 复跑 FAIL 2→1(残余=既有 standing onno net_usd 0% 在册); 同仓储费「当月结算保护」与拍板① 完整月原则 ✅顺手清(config.py 头注释 IP 列表腐化, 零行为): 旧注释仍列 #119 换新前出口值(zf 旧值恰= onno 现值·误导), 改指向 EXPECTED_IPS 单源不列具体 IP

9.142 2026-11-05 Keepa seller 店铺评分断供修复(用户令「seller 店铺评分那个bug 修」——9.141⚠挂账当日清) ✅根因: P2-33 重构(10-24)把抓取循环改内层独立 cursor 后, #84 seller 段仍引用外层已关闭 cur → 10-25 起每晚「cursor already closed」回滚本段, seller_rating 断供 11 天(最后非空=10-24) ✅修法: seller 段自开 with conn.cursor(); 部署 api+worker(07:59 UTC, 贴 08:00 档边缘但晨检实测正常跑完); 验证=手动重跑任务(断点续传下 crawl 全跳过仅走 seller 段)→ 今日 315 行中 302 行 seller_rating 非空(13 NULL=店铺尚无评分 count=0→NULL 设计值), keepa_pull_log 落 keepa_seller_rankings 账 ⚠历史缺口不可回补: 10-25~11-04 的逐日 seller_rating 恒 NULL(Keepa /seller 只回当前值无逐日史), 排名页读最新快照不受影响 ✅两项新观察当日修复销案(9.143·2026-11-05): 原⚠同晨检(11-05 08:00) FAIL 7 分类: 5 项为既有standing(RLS 三维 51 张/KPI orders 口径/chart_value KPI net 差额/brandboard 僵尸端点×2=9.126 判死残留在册待 --refresh-snapshot/fg finances 缺单 19); 2 项新观察=①采集 run 非零退出 4 条(collection_noon_orders noon-zf/onno-inc 07:34Z exit=1, requests send 层) ②onno noon sku_pl upd_net 填充 47%(11-04 08:00 尚 FAIL1→今 FAIL2)——是否处置待用户/审计线拍板

9.141 2026-11-05 排名抓取粒度分叉(用户拍板「服装类目按照产品名称抓取,其它按照sku/asin抓取」) ✅口径分叉: sku_mapping 无类目列→服装类目以品牌为代理(APPAREL_RANKINGS_BRANDS={fittingirls}, 现全站唯一服装品牌·品名即型号码, 扩服装品牌改此一处); 服装=归一化品名>型号>~ASIN 聚家族抓代表; 其它品牌(onno/zipforce 电子品)=每 ASIN 一单元(~ASIN)全量逐个抓, 不再按型号聚代表; #144/#145 登记市场展开与 keepa 11 国白名单不变 ✅两侧同批: tasks.py _family_groups 分叉(采集器+循环器分母 _keepa_family_target 同源自动同步); dashboard.py /api/rankings 家族标注 SQL 同口径 CASE 分叉(fam/fam_asins 行内注记); onboarding 品牌大小写注记不受影响 ✅实跑验证(02:43 UTC 手动触发, 断点续传下今日全量): 目录 246→385 行/天(服装品名家族 198+其它逐 ASIN 187[onno 30+zipforce 157]·无 keepa 域跳过 292 不变); pulled 385/written 315(70 空响应入当日空集合次日重探)/9 域/94.6s; 清洗层 audit.cleaned_rankings_daily 11-05=315 行同步(页面上手即新口径); 页面 fam 实证 zf=~ASIN·fam_asins=1; token 消耗约 +57%/日(385 vs 246 ASIN 批)在 keepa:lastleft <200 跳闸保护内 ✅seller 段自开 cursor 修复落地·断供止销案(9.142·2026-11-05): 原⚠邻近既有bug发现待拍板(铁律只报不动手): Keepa seller 店铺评分(#84)自 10-25 起每晚静默断供——P2-33 重构把抓取循环改内层独立 cursor 后, 外层 cursor 在 seller 段执行前已关闭→每晚「cursor already closed」回滚该段; 库证 seller_rating 最后非空=2026-10-24; 修法=seller 段自开 cursor(约 3 行), 待用户令 ✅追记·映射↔目录全量对查(用户令「映射里有但目录没有再查一下」): 双向零疑点——映射 noon 106 行经三集键全命中目录在售(0 未上架/下架残留); 反向 18 个 zipforce 目录在售品未登记(NFC 墨水屏×5/MagSafe 壳×4/水瓶×4/键盘耳机×1/空listing×2, 其中 2 个有 GMV $40/$66·4 个库存>20)——用户拍板「不需要, 严格遵循 sku mapping」维持 #148 预滤不采, 重申 sku_mapping=唯一事实源(记忆铁律既有); onno 7 在售全登记, 3 个零评论商品 product-reviews 端点不返回条目=端点行为非断流

9.140 2026-11-04 资金流水 chips 行并入 KPI 卡组(用户贴 chips 全文问「这些呢?」→方案上桌→拍板「删行, 独有的并入卡组」) ✅删两平台 chips 行: 与 ⓪ 财务 KPI 卡组重复的 净利率/ACOS/回款待收/亏损SKU 早已在卡组(9.136), 行删除后卡内零 chipbtn; 死码随清(chip/lossChip/cmpChip/nCmp 块) ✅独有项并入卡组: amazon 8→11 卡(+TACOS/退货率[判定线 id42 三段]/盈亏平衡 ACOS[R24 复用] 均 mon_ratios 后端单源)+净利润卡脚注增同比(拍板① 原值对·品牌覆盖检查); noon 净利卡脚注增分市场环比(完整月对完整月·缺COGS/品牌覆盖不可比明示, n0 格式化+顺时序「09→10」读法)+派生月条件卡; 环比方向经真值核对(SA 09=21,897→10=13,373 ▼, API 逐月复算一致) ✅验证: 探针 amazon 卡组 11 卡(TACOS/退货率/盈亏平衡在)+净利润脚注「最新完整月 2026-10 $1,691 · 环比 ▲ $331」+卡内 chipbtn=0+noon SA 脚注格式化+零 JS 错; e2e 环比锚点翻新(chips 环比→净利润卡脚注 环比+TACOS/退货率/盈亏平衡三卡在+chipbtn 环比=0), 第六次全量复验发车

9.139 2026-11-04 资金流水图换设计(用户令「图不好看, 有别的设计吗?先说方案再搞」→三方案上桌→拍板 C) ✅方案先行: 三备选(阶梯利润表条形/「钱去哪了」100% 堆叠条/三级漏斗横条)各附 ASCII 预览上桌, 用户拍板 C=阶梯利润表条形——ECharts 瀑布(bridge)整体退役, 纯 HTML/CSS 行柱替代(文字清晰·无 canvas 缩放糊·零图表库依赖) ✅C 形态(WfLadder 组件): 每行=条目名+横柱+行末数值; 正值柱左起(起点深靛/小计浅靛/净利润绿红按正负)、扣减柱右起红(−前缀·右锚=「从结果里扣走」视觉); 比例同尺(÷窗口最大正值)免疫大数压小数; 结算净额/净利润前虚线分隔=利润表分段感; 净利润行尾带净利率(37.2%); 源注进行 hover title 全保留; 月份切换/零值步剔除/COGS 缺行止步毛利†/#55b 步序(广告→毛利→采购→净利润)全沿用 9.138 修复 ✅验证: DOM 级 10 行全名就位+4 正值柱左起(宽 100/62/55/37% 比例精确)+6 扣减柱右起+色值 rgb(79,70,229) ✓+月份选择器+noon 双市场组+零 JS 错; 视觉模型服务本次报图片解析错误(前两轮 8/8.5 分同链路), 以 DOM+像素双检替代; e2e 锚点 #wf canvas→#wf 净利润文本/div[id^=wf-]≥2, 第五次全量复验发车

9.138 2026-11-04 资金流水卡视觉诊断修复(用户令「还是不好看」→截图喂视觉模型诊断→四修落地) ✅诊断(视觉模型): 痛点①=卡画 2026-11 进行中月(4天)→佣金/尾程/促销/VAT 四根 $0 空柱掏空图心「一根高柱→大片空白→绿柱」; ②脚注一墙灰字(公式+统计+口径混行); ③流入与小计同色; ④chips 第二行孤行 ✅四修: ①Amazon 瀑布/本卡指标(净利率/ACOS/环比/同比/当月统计)改跟「选中月」走, 缺省=最新完整月(拍板① 同源), 月份下拉可切(含「进行中」标注), 平台切换重置——环比同比随选月取对照月; ②零值扣减步剔除(v≤0.5 不画, 双平台); ③小计柱改浅靛 #7c73f0 与起点深靛 #4f46e5 区分; ④脚注折叠 details——常驻仅 净利12月水位线+(noon)†注/⚠覆盖警示/trust 起点(拍板标注不因折叠失注), 口径公式/当月统计/上月原值/月份跨度/COGS快照起点 收进「ⓘ 口径」可展开 ✅视觉复评: amazon 8/10(2026-10 完整月 10 柱全值·4.5k−493−846−252−130≈2.78k 数字自洽·月份选择器就位·脚注单行 ⓘ)+noon 8.5/10(SA/AE 各 9 柱·三色可辨·chips 整齐·脚注折叠); 复评揪出真 bug 即修: noon 步序误为 广告→采购→毛利(毛利柱显示=净利润), #55b 正序 广告→毛利→采购→净利润 修正后视觉验算成立(SA: 880.1−329.1=550.9 毛利; 550.9−342.9=208.0 净利); e2e 第四次全量: 财务 Amazon 段 10/10 后于全页扫描段再遇 /documents load 瞬时崩(同 run1 环境类·run3 曾 ALL PASS), noon 段以等价探针收尾全绿(canvas×2/SAR chip/七tab/details×2/零JS错)

9.137 2026-11-04 资金流水卡瀑布图化+广告舱 e2e 旧锚点清偿(用户令「资金流水卡片不好看,优化一下」) ✅flowbar 链改真·瀑布(ECharts bridge): waterfallOpt 单源组件——start=起点整柱/minus=扣减红柱(自累计额下沉)/subtotal=小计整柱/final=终值按正负绿红, 柱顶值标签+柱名 x 轴, 原 flow-step 全量源注 title 进 tooltip(逐块 hover 仍有口径); Amazon 10 柱(净收款→佣金→尾程→促销及其他→VAT→结算净额→广告→毛利→采购→净利润), Noon 各市场 8~9 柱(VAT 0 恒步撤出改 wrapper 注记=税内嵌不重复扣; COGS 缺行市场止步毛利†不出净利柱 AC-CAL-17); 数值=#55b 原值零新口径, 纯呈现层 ✅死码随清: MoneyStrip step() helper(flow-step 专用)退役; e2e 锚点 .flowbar→#wf canvas(amazon)/div[id^=wf-] canvas(noon) ✅广告舱 e2e 旧锚点清偿(9.131 遗留·当日 run1 早崩未暴露): advice 子页退役后档案馆实为 amazon=6/noon=7 子tab, 断言仍写 7/8→三处计数校正; 平板768 段 /noon 两 429=240/3s 限速桶持续耗尽(移动段同页刚 PASS, 段内已有单次 429 重试)定性环境瞬时不动 ✅验证: 像素级体检 amazon 瀑布三色柱齐(靛蓝 9.15%/绿 2.19%/红 0.99% 像素占比, canvas 1102×310)+noon 双市场 canvas×2+flowbar 残留 0+零 JS 错; tsc 0 错; e2e 财务段复验发车(第三次全量)

9.136 2026-11-04 财务页工作台结构改版(用户令「按照工作台的页面结构方式设计财务页面」——9.134 A 方案晨报收起态当日退役) ✅结构对位工作台五槽位: sticky 一行筛选条(平台+时间·月粒度, 工作台同款样式) → ⓪ 财务 KPI 卡组(KpiDeck 同款 deck/kpi 视觉: Amazon 8 卡=净利润窗口+净利率/净收款/结算净额/广告/回款待收/亏损SKU/ACOS; Noon=分市场净利卡+打款+亏损行+⚠覆盖缺口条件卡) → ① 资金流水瀑布卡常开直读(收起/展开态退役, 关键数职责移交 KPI 卡组) → ①b 月度双图常驻(图表墙槽位, 从 base tab 上移) → ② 雷达 → ③ 分析明细七tab(不变) → ④ 工具带 ✅零新口径(AC-CAL-17): KPI 卡值全为既有口径原值——金额=#55b 链窗口求和(matrix 行直读·与瀑布同源), 比率=mon_ratios 后端单源(最新完整月), 环比=拍板① 完整月原值对+品牌覆盖检查(沿 MoneyStrip netByMon 逻辑), 回款=settlement summary, 亏损=净亏榜; Noon 净利卡=#56 同市场同币跨品牌求和·COGS 缺行市场不出数(†), 覆盖缺口卡=拍板「补不回来的接受并标注」常驻化(hover 逐月明细, SA/AE 去重并月) ✅验证: e2e 财务 Amazon 段 10/10 PASS(KPI 卡组/瀑布常开/环比 chip/双图常驻/七tab/雷达/heat/月度对账); playwright 探针 amazon 8 卡(净利润窗口 $2,192)+noon 分市场 2 卡+SAR chip+全部档覆盖缺口卡+sticky 条 computed=sticky+零 JS 错; tsc 0 错; base tab 收窄为分市场·累计表(月度双图上移)

9.135 2026-11-04 代理视角注脚精简+广告页铺开(用户贴工作台注脚原文令广告页同加→再令「这种没有意义的注释精简一下」) ✅ConsignNote 共享组件(横向一致铁律): 注脚精简为一横条「🏷 {brand} · 代理(代卖)——本租户仅见代卖货,直营在属主租户;筛空=隔离边界(拍板B),非断流。」, 原三行长文细节(sku_mapping mode=Distribute/自有账号订单·Noon 在属主侧/边界语义)收进 title hover——可见面短·悬停有全量口径 ✅广告页铺开: zf→onno→Amazon 广告面≈空(近30天仅 2026-10-06~10 五行 views-only spend=0·晨报队列空)易读作坏页——brand_mode 同源 /api/dashboard/filters(纯本租户信号), 注脚置顶 sticky 工具条下; onno 品牌 Amazon 广告真实存在($1,109/60天·15活动·E27/2001/2002/G25/1020S)但全跑在 onno 自有账号(US/AU/SA/AE)=RLS 对 zf 不可见, EU 代卖侧无投放→空面=拍板B 边界语义, 与工作台图表空同因 ✅工作台同步换精简文案(9.133 原三行版退役, 内联 JSX 抽成组件); 验证: zf 租户探针 onno→/ads 1 条+/工作台 1 条(精简文案), zipforce 品牌两页 0 条, 零 JS 错

9.134 2026-11-04 财务页 A 方案三段式规整(用户令「财务页面太乱…按照工作台的逻辑优化」→A 方案上桌→「继续」开工) ✅① 钱景晨报单卡(沿广告页晨报模式「平常收起·关键信息条常驻·展开瀑布」): 资金流水卡改收起式——收起=关键信息条(Amazon: 净收款→结算净额→净利润+净利率/ACOS/环比/回款待收/亏损SKU/净利12月水位线; Noon: 各市场净利/打款+亏损+水位线), 展开才出瀑布+全chips+口径foot; ⚠数据覆盖缺口·永久/全部档信任起点收起态常驻chip化(拍板「补不回来的接受并标注」不因收起失注, hover 全月明细); 平台切换回收起默认; gap 月 SA/AE 去重并月(两市场同缺只报一次) ✅③ 分析明细统一七tab(「乱」的根源=两层tab嵌套): 原③分析带子tab(望远镜·底座/矩阵下钻)+④档案馆子tab两层合一, 双平台同构 [望远镜|报表|矩阵|档案×4]; tele/heat 跨平台共享→切平台保留同问视角; URL ?tab= 深链兼容(旧键全保留)+b3 退役+无效键归默认(amazon=tele/noon=cum); goArchive 锚点随 #archive→#analysis; 两bug即修: MoneyStrip open 态跨平台残留(初版 noon 探针抓不到展开钮→平台切换 setOpen(false)) ✅chrome 减层: v2 四带 sticky 锚点条(①②③④)撤除(晨报收起+雷达+七tab 后页面自紧凑); 档案与工具带全宽收尾(原「工具左窄列挤压档案馆」布局退役); AppShell crumb 更新为 钱景晨报·问题雷达·分析明细 ✅验证: playwright zf 全链路 24 项全绿(收起默认 flowbar=0·关键条chips在/展开瀑布+环比/收起明细回位/noon 收起重置/全部档窗口 gap+trust chips/heat ?tab=heat 入URL/noon cum 显式进(官方对账单+经营总表+分市场表)/pnl 表行/回切归位 tele/零JS错); e2e 财务两段锚点全量翻新(heat 锚点改 pm-toolbar+静态caption——旧 h2「品牌×月度全维度矩阵」属 mx 档案卡非 MatrixTab; noon 段流程改显式点 cum 再断言); tsc 0 错; e2e 预检实况: 财务 Amazon 段 9/9 PASS(收起/展开/七tab/heat/月度对账), 全量跑在其后的全页 networkidle 扫描段瞬时崩(30s 超时×1)——25 页逐页复测全 OK=环境瞬时负载非本改动(夜审 00:37 全量 e2e 复跑为门); Noon 段以探针 1:1 复刻(cum 官方对账单+经营总表+分市场表/望远镜/heat 13 格/pnl 742 行/npm TACOS%+导出/bal 余额/sku 深度/工具带转诊 tab=npm)全绿

9.133 2026-11-04 直营/代理边界注脚(用户报「zf 租户 onno 品牌 Amazon 综合视图/单独指标无图」→诊断→令「做,要按照直营代理的逻辑做」) ✅诊断定谳(三层排除后钉死): zf 租户→onno 品牌→Amazon 面只可见**代卖切片**(owner=zf 账号的 onno 货, EU FR/IT/GB/ES 实测有图: FR 14 天/GB 6/IT 4); onno 自有账号市场(US/AU/SA/AE)订单行 owner=onno_amazon(租户2账号域)——迁移168 RLS 双条件(品牌∈租户品牌域×seller_owner∈租户账号域)按拍板B拦截, 筛 SA(无代卖生意)→图全空=隔离边界语义非断流; 顺带勘误: 首答 noon 跑偏+第二答「RLS 无罪」用了超级用户测试(绕过 RLS 的无效证据), 租户角色复测才现形 ✅brand_mode 机制(铁律2 直营/代理三级登记的正向消费): /api/dashboard/filters 增 brand_mode——纯本租户信号零跨租户读(品牌在本租户 brands_source 有自有登记行=direct; 仅在 tenant_brands=consign), 三租户实测={zf: zipforce=direct·onno=consign}/{onno: direct}/{fg: direct}; 过程两bug即修(返回体字段误嵌 countries 层/初版跨租户查 brands_source 被 RLS 挡漏 onno——换纯本租户信号恰是正解) ✅工作台注脚: 综合视图/单独指标卡头条件渲染「🏷 代理(代卖)视角·{brand}」warn 条——本租户可见=代卖的货(mode=Distribute)/直营业务在属主租户/筛空=边界语义非断流; 探针=onno 品牌 1 条·zipforce 品牌 0 条·零JS错


9.132 2026-11-04 广告图墙三合一(用户令「投入产出与回报,广告效率与成本,流量漏斗 合到一起,上面是日,下面是月不变」) ✅后端先行: /api/ads/charts 月行扩全字段——原仅 spend/revenue/roas, 补 views/clicks/orders/atc + 后端比值 ctr/cvr/cpc/cps(与日行同式同源, AC-CAL-17 比值后端算铁律不变); 同响应自洽对算实测 2026-11 月 ctr=0.53/cpc=0.22 与手算一致 ✅三合图 mall: 一画布双grid 上日(210px)下月(170px)——每grid四轴 L1金额(柱花费/收入+线CPC/CPS) L2%(CTR/CVR, offset双左轴) R1 ROAS R2 量(曝光/点击/ATC); 系列 10+9(Noon 含 ATC 双排), 图例点选聚焦; 原 m1(仅日)/m2(上日下月)/m3(仅日) 三卡退役, m2 的上日下月结构升格为全族标准(效率/漏斗指标首次有月排) ✅验证与部署: 墙内卡=mall+m4 产品画像 两张; 月行 12 字段齐; 探针=合图标题在/真零残留(「流量漏斗」字样属合图标题自含)/canvas=2/零JS错; 09:03 UTC api+web 换血。追记①(同日用户令「日的筛选放日的上面,月的筛选放月的上面,不要放到一起」): 图例拆双排——legend[0]=日系九项挂日 grid 上方, legend[1]=月系九项挂月 grid 上方(Noon 各+ATC), grid 高度重排(日 44+200/月 326+160); 截图目验=日系图例在日排顶/月系图例在月排顶/双 grid 各自双轴刻度, 零JS错。追记②(用户令「图例往左点,右边超了,还有点重叠」): 图例右锚改左锚(left:104 对齐 grid 左缘——原 right:0 与右侧 ROAS/量 轴名同行压叠且溢出), 字号 11→10.5+itemWidth 10+itemGap 8; 截图复验三项全过=双图例靠左不超界/与右轴名零重叠/末尾项(日·点击/月·点击)完整可读。追记③(用户令「太往左了,在中间就好」): 左锚改水平居中(left:center); 截图复验=两组图例以中轴对称分布/两端与左右轴名零重叠/不超界。追记④(用户令「ROAS为什么还在右边」): 左侧三轴=金额/%/ROAS(offset 44/88)右侧只留量, grid 左距 104→150; 截图复验=双 grid 各三左轴一右轴/零重叠零溢出——**旋即用户令「回滚」撤销④: 恢复③布局(左两轴金额/%, 右两轴ROAS/量, grid 左右 104), 已部署复绿**。追记⑤(用户报「roas和量重叠」+问「量是什么」): 根因=右两轴未写显式 position 皆默认同侧叠压——四轴全显式定位(左 金额0/%44, 右 ROAS0/流量52), 「量」更名「流量」(曝光/点击/加购体量轴, 与金额差数量级故独立), grid 右距 104→150; 截图复验=左双轴右双轴完全分开/ROAS·流量轴名不叠压/零溢出


9.131 2026-11-04 广告页整体规整+晨报待决策同卡(用户令「晨报和待决策队列同一个卡片·平常收起·收起后可以看到关键信息」→升格「整体重新规整一下,有逻辑一点」) ✅晨报单卡化: MorningTab 原 5 张分散卡(头条条/KPI 五卡/概览表/回访检查点/昨夜结论)收进一张 #morning 卡——常驻=头行(日期+数据截至)+关键信息条(待决策/昨执行/到期回访/告警/人工单 五数一排异常着色)+待决策队列 Top12 预览(2026-11-03 拍板形态保留); 「展开全文」=概览表/回访/结论三块重内容; 「展开决策台」=三按钮全量决策(11-03 形态); 收起态关键信息全可见(用户令③) ✅整页重排(决策流→态势→结构→守护→工具): ①晨报单卡(升为全页首卡, 原 ① 日报带中段) ②投放总览 hero ③图墙+月度表 ④投放明细矩阵 ⑤待办两卡(监测告警/回访·人工单——建议队列卡吸收进晨报后收两卡, advice 取数链退役) ⑥档案与工具带 ⑦档案馆 ✅去重: 档案馆 advice 子页退役(与晨报决策台双份渲染=无逻辑, ARCHIVE_SHARED 摘键+默认/LEGACY tab→monitor); goArchive("advice") 全站重定向=滚 #morning+CustomEvent open-decide 自展决策台(MorningTab 监听), 原「去处理/回访历史」按钮一键直达; crumb 同步 ✅三连改(同日用户反馈「展开全文/收起决策台逻辑乱」→「为什么还要去决策按钮」): ②双开关并一——收起=关键信息条+Top12 预览, 「展开晨报」一钮=全文(概览/回访/结论)+完整决策台一次全出, 「展开处理」小钮=直落队列段; 探针复验(单开关1/旧双开关残留0/收起态Top12+关键信息在/展开态三块齐/零JS错)。③关键信息条尾部「去决策↓」跳转遗物删除(单卡后队列就在条正下方, 纯冗余), 探针复验零残留+零JS错。④用户问「展开后催办怎么变少了」根因=两口径不一致(Top12 预览 /api/ads/morning 不分平台 vs 内嵌决策台 /api/ads/advice?platform=当前平台)——AdviceTab 平台参数改可空(空=全平台, 后端 (%s='' OR platform=%s) 既有语义), 晨报内嵌决策台传空与预览同口径, 动作按钮本就按行级 platform 分叉零改动; 探针复验: 收起 12 催办/展开 20 催办(全量≥预览, 修复前反向)。⑤终裁(同日用户令「广告页面要分平台」): ④的全平台口径推翻——晨报卡整卡跟当前平台: /api/ads/morning 加 platform 参(队列/total/昨日执行/回访/monitor/人工单六查询全滤, 空参=全平台向后兼容), MorningTab 传 platform+切平台重拉, 内嵌决策台回传当前平台, 概览表按平台单段渲染; 实测=待决策 全28/amazon5/noon23, 队列平台纯度 100%, monitor/回访同滤; 过程自伤一处({_pf} 入普通串未 f 前缀→522)即修(4 处补 f)。✅验证与部署: 构建×2 绿(清未用 import); playwright 活探针九断言全过——#morning 全页首卡/关键信息条常驻/Top12 预览常驻/展开全文出概览表/展开决策台出三按钮/档案馆建议子页零残留/监测子页在/零 JS 错误; e2e §广告舱锚点同步(①晨报单卡 ②日报带 ③待办两卡[建议队列==0 断言]); 07:1x UTC web 换血


9.130 2026-11-04 四令批:①观察②仓储采集三租户补齐⑤删备份表⑥映射页重灌按钮(用户令「1a2a5删6在sku mapping页面留重灌按钮」) ✅①storage Δ19.27 处置=不动观察(拍板 1a): 等 Amazon 修订报表自动平方(新 6 月回看窗每夜自动捕捉)或约 2027-01 滑出 3 月窗, 不登记豁免——夜审该门常显 FAIL(1)=已知残余语义不变 ✅②仓储费报表面三租户补齐(升格: 用户问「其它的租户不需要吗」→实查 onno 也缺, 批次从 fg 单点升格三租户, 横向一致铁律正向执行): 实查=zf 专表 1,741 行×报表面 7,239 行✅在采(10-24 起)/fg 专表 17,031 行(三租户最大仓储费户)×报表 0 行❌/onno 专表 6 行(GB/AU/US 分位级, 主力货走 zf 账号费在 zf 面内)×报表 1 残行❌——结构同罪即补不因量小豁免 ✅②落地(一核三壳, 横向代码一致): 抽核 adapters/storage_fees_core.py(报表拉取/世代自愈/月级重写/对账打印全逻辑, region_from 参数区分专表口径——zf='pool' 池标签/fg·onno='row' 行级国码)+三薄壳 zf(原文件改壳, fetch_report 再导出勿删=removal 双壳依赖)/fg(fg_amazon.json 三池 LWA, 市场 US/DE/AU)/onno(onno_amazon_creds.md 同源解析 3 token); config.py 注册×3+MARKET_COLLECTOR×2; brands_source night 槽=fg:35/onno:37(注册表驱动零 tasks.py 代码, B类级联); 首拉验证=fg 46,754 行/262 ASIN/2026-04→09 回补 rc=0·onno 194 行 2026-07→09 rc=0·zf 冒烟 7,239 行幂等无损 rc=0; 过程自伤两bug即修(核内 3 元组按 2 解包×2 处/夜槽数组 || 元素级合并拍平→包裹式追加重写) ✅⑤备份残留表删除(拍板「删」): 实查 7 张(20061021 批 5+旧 20261010 fg 9,192 行+audit.bak_inv_products 836 行)——删前四查零风险(零入向外键/零活查询(collab.py bak_ 前缀通配护栏不引用具体表/pg-init 引用=历史迁移注释/现行 sku_mapping 1,353 行健康胜出)+今晨 03:30 dump(mars+venus)有恢复网, 7 张 DROP 清零 ✅⑥映射页重灌按钮(拍板「在sku mapping页面留重灌按钮」, 自动钩子方案否决): POST /api/mapping/resync-procurement(ops.py)——映射活源(本租户品牌域 Noon 行)→per-seller raw({brand}_noon 约定名横向遍历, UPDATE 保 notes/客供料+INSERT 新名+DELETE 退役名)→ingest_all 定向→清洗面幽灵行 admin 连接同批清; 前端编辑器工具栏「⟳ 重灌成本面」按钮(alert 回执各品牌行数); live 实测 200={zf: 28 行(0新/0退), 幽灵清 4}; 过程三 bug 即修(psycopg2 元组列表渲染 ARRAY→execute_values/幽灵清理误用租户连接无 DELETE 权→admin 连接/IN (VALUES) 包裹) ✅夜跑已跑·fg/onno 校准已收口销案(9.179·2026-11-09; 中间态见 9.162·2026-11-08): 原⚠挂账呈报: fg/onno 报表面首灌后, 采集器内对账打印的 ⚠Δ=月错位噪音(专表=入账月·报表=费用月, recon 的 shift 注册表口径才是真对账)——今晚夜跑 storage_fee_recon 将首次带 fg/onno 报表数据比对, 若出红需 fg/onno 的 shift/税strip/豁免单校准另案呈报


9.129 2026-11-04 A3 前端 A÷B 全量后端化(用户拍板「能对api,都读api。不能的列出来」·巡检呈报→当日全批收编) ✅收编面(19 值×8 端点×7 前端文件, 公式与前端旧式 1:1 镜像零口径漂移): ①ads 活动矩阵 ROAS×5 行位点(noon 实数/覆盖零行/快照零行/amz 实数/快照零行, _roas 单源函数与 _ctr 同款) ②MonthlyCompare 五比值 aov/ctr/cvr/cpc/roas(构建尾统一后处理, amz revenue/ad 与 noon gmv_usd/ad_usd ??链同语义) ③CountryPnL 七派生 aov/ctr/cpc/cvr/cpa/roas/organic(_cpnl_derived 单源, amz-country+noon-country 双端点注入; noon cpc/cpa 用本币 sp_local·roas 用 USD 双列=同前端取数) ④finance 四处: 净利率换 mon_ratios.net_margin 直读(C3批#60 已下发未消费)/profit-matrix 平台合并 mrg 单元格(cells·tot·grand 三位点)/kpi-wall 国家行 margin/full-matrix SKU 行 acos+ad_share ⑤noon 列表 by_sku 聚合块(bb_avg/cv_avg 日均+加法归约整体收编) ⑥rankings BSR 趋势(trend_delta/pct/up) ⑦today 六处环比(kpi_deltas 五 KPI+国别行 orders_pct, 双路径 return) ✅对算验证(同响应自洽对算法): ads/platform 689 活动零不自洽·monthly-compare 66 月平台·amz-country 9 国·noon-country 2 国·finance matrix+mon_ratios·profit-matrix 12 行·rankings 24 行·today KPI+国别——全部字段=同响应原始数手算值; **对算首跑抓出真 bug**: noon roas 首版误用本币花费当分母(前端旧式分母=USD 列), _cpnl_derived 改双花费参数(sp_cpc 本币/sp_roas USD)钉死, 修复后复验零不自洽 ⚠不能直读清单(呈报候令): ①products 下钻树分桶均值——整棵系列层级树在前端 buildTree 归并, 单收编一除法=搬整棵树, 另案或注册豁免 ②sourcing BuyBox 自营占比——分母是前端交互筛选后的当前列表, 后端无法预知 ③noon catalog_sales 面当前双租户零数据(by_sku 字段逻辑与前端归约代码级同构, 数据恢复夜审自洽) ④模块内管理统计 6 处(offsitepromotion×3/projects 完成率/相关性系数×2)+货币换算显示+布局坐标=不适用类 ✅部署与事故自愈: 05:0x~05:3x UTC api+web 两轮换血(避开坑24 窗口); 首轮 /today 500=修复线编辑残伤(cast 后丢可选链, data 为 null 时 SSR 崩)——web 日志定位 TypeError 一字修(?.)重部署复绿; 八页探活 200; up -d 合并命令分类器再拦→拆单服务(9.121/9.128 同款波动第三次, 已成惯例处理)


9.128 2026-11-04 A4 品牌看板死码清理(用户令「A4 清」·判死拍板A 尾巴收口) ✅删除清单(三向核验 web chunk/e2e/门禁后才动刀): ①web/components/BrandBoard.tsx(20KB)+NoonBoard.tsx(15KB)——零 import 引用(仅 app/page.tsx:826 历史注释提及, 保留注释); ②api/routers/brandboard.py 死端点 2 个——/api/brandboard/orders(订单明细14列, 唯一引用=_audit_pixel_values 一次性历史脚本)+/api/brandboard/country-sku(Country×SKU 汇总, 全域零引用), 删 :29-127 共 99 行+文件头 docstring 更新 ✅保留三端点(各有活消费方, 险被误判死): /api/brandboard/noon——夜审门禁 dashboard_audit 4 处在用(本批核验新发现, 探针三向核验前先证伪了「3 死端点」旧假设); /api/noon-inventory——库存页 chunk+pipe_audit; /api/brandboard/product-drill——商品下钻页+e2e §12 ✅验证与部署: py_compile 绿+web/api 构建绿, 04:3x UTC 换血(up -d 合并被分类器拦一次→拆单服务, 9.121 同款波动); 四页 200(/·/products·/finance·/inventory); chunk 零残留 orders/country-sku 引用; 活网关鉴权行为五探针=noon/product-drill/noon-inventory 401(活)·orders/country-sku 404(删) 正合预期; TestClient 全 404 系测试桩路由解析假象已排除


9.127 2026-11-04 A6 采购成本面重灌+A7 noon 净利回补探针判决(用户令「a6 重灌」/「A7 能补的都补回」/充电器裁决「都按56」后修正「按20修正」/正字裁决「Airfit Neo 是对的」) ✅A6 根因: 成本真身=sku_mapping.cost_rmb 全满(Noon: zf 92 行/28 品名·onno 14 行/8 品名, 用户维护活源) × 算法读的专面 audit.cleaned_noon_procurement_cost=2026-09-06 旧机一次性冻结遗物(zf 28 行/onno 0 行, 144 号镜射壳从未灌入)——advisor R24 出价利润封顶+finance 11 处 JOIN 全读专面, onno 封顶因无成本恒不可算(10-19 起挂账的真实形态) ✅A6 执行(共核 SQL×两品牌, 横向一致铁律 2026-11-04 代码面重申同日落地): ①映射 2 处数据修正均经用户裁决——Airfirt→Airfit Neo 正字(2 行); 充电器 30W/45W 同 SKU 双值 16/56 歧值, 先裁 56 后修正 20(映射 4 行+raw 2 行+清洗面同批改) ②重灌: zf UPDATE 24(注记/客供料保留)+INSERT 4(CX22/G502/Luna Pro+ New/T11)+DELETE 4 退役(Bento/Keyboard/Water Bottle/iPhone Case, Keyboard 注记自证 10-23 拍板作废)=28; onno 首灌 8 ③ingest_all 定向刷 noon_procurement_cost 36 行 ④清洗面幽灵 4 行(退役名)清 ⑤换算口径=旧例 raw.cost_sar 列存 RMB+spec 层 ÷6.7963×fx(SAR/AED 锚定, 56→30.90/30.24 实证) ⑥端到端验证: onno 出价链 margin 从 None→可算(30W Charger AE 成本 10.80 AED 入算) ✅A6 注记: onno Noon 全品类统一 56 RMB 平价成本(映射源即如此, 充电器例外 20)——用户确认非异常; zf 28 品名成本整体刷新至当前维护值 ✅A6 遗留①当日闭环: 「Wifi Light Buld Camera」正字=Bulb(用户裁决 2026-11-04), 映射改名 1 行(同 SKU 同 nsku 纯重复行, Airfit 先例最小干预)+raw/清洗面歧值行各清 1——onno 专面 8→7 品名, 全链单一拼写 ⚠A6 遗留呈报: ①onno PL 最新月 valid_units=0 → margin 呈 settle/gmv 比(成本×0), PL 数据面既有观察项非本批引入 ②本次重灌=手动一次性, 未来映射改成本需重跑(自动挂钩子候拍) ✅A7 判决(三腿探针, 件 tools/probe_zf_noon_finance_2024_20261104.py): ①zf 2024 结算(23,342 单有订单无结算) impex finance 导出只回 payment 残行(2024-05=10 行/2024-09=9 行)=API 不服务, 旧机亦无(现行残行即旧机导入遗物)→任何来源不可补 ②2025-02~12 广告 ads API campaigns+products 双端点零返回, 活动级表亦无→API 不可补 ③2025-01 广告=单日 2025-01-01 lump(196 行 321,522)实锤 ④onno 2026-02-23 开卖无历史 → _NOON_TRUST_START=2025-02 维持: 非保守截断而是 API 可得数据物理边界, 9.90 拍板事后证最优 ✅A7 闭卷(用户拍板 2026-11-04「补不回来的接受,并标注」): 2024 结算/2025-01 lump/2025-02~12 广告=Noon API 留存边界外永久缺口, 接受不再列回补; 标注三层落地——①id44 invariants 第4条+note 追记(永久定性+探针证据) ②finance.py _NOON_TRUST_START 注释块追记 2026-11-04 取证判决 ③前端 /finance ⚠数据覆盖警示与全部档注脚加「永久:API 留存边界外/结算不可回补 · 2026-11-04 拍板接受」+悬停全文, 04:28 UTC api+web 换血, chunk 实证「拍板接受」字面量、/finance 200; 门户 CSV 手工路径撤候(用户自愿导出随时可走 2026-01~08 同款通道, 不再催办)


9.126 2026-11-04 三红门禁收口批(用户令「全修」+两拍板A「都选a」·e2e ALL PASS 219 项/storage FAIL 3→1) ✅e2e 品牌看板判死(拍板A): /dashboard/[brand]+/dashboard/noon/[brand] 两路由文件 10-25 git 首提后被无拍板删除(工作树未提交删, git HEAD 树 blob 7945b6b4/b3b25239 源码留档可考; live zf/fg 双租户 404 实证), 11-01 工作台重设计线已实质替代——现追认退役; e2e 五处改写=遍历 PAGES 摘 2 死页(同 09-23 onno 先例口径)/§10 品牌看板段退役注记(80 卡墙·时间窗联动·订单14列·Country·SKU 四断言随页退役, 图墙由 §1~§5 工作台+§17 像素扫描承继)/§11 Noon 看板段退役/像素空白白名单 3 个 /dashboard/* 键摘除("/"真零语义注保留)/fg 跨租户抽查改锚 首页+今日; 死路由引用 grep 清零; BrandBoard/NoonBoard 组件成无人引用死码——清理另案候令 ✅e2e 两锚修: ①库存页 Noon FBN 子页断言曾因本批 §10 改写残端(page.goto 被 Edit 吞)错跑在上一页 /noon 上(subtabs=0 假 FAIL·inputs=17 假 PASS 同源)——自伤自查即修: goto 复位+wait_for_selector 稳健等待(NoonTab 工具条挂载可晚于 networkidle), 四子页断言升五子页(10-28 已加 📦 ASN 入库); ②mapping 段编辑器默认品牌已从 zipforce 变 onno(t1 双品牌化, 10-17「仅剩 zipforce」注释前提过时)——首开断言改品牌无关+默认≠zipforce 才显式联动断言; 终跑 ALL PASS 219 项/0 FAIL(遍历 35 页含 /today, 编辑器 115 行, fg 双页无 ≥400) ✅kpi-pool 基准三处(11-03 全修批未入账补记): dashboard_audit.py 退货基准+_fin9(cleaned_amazon_sku_fin_daily)+_ads9(cleaned_ads_sku_daily∪cleaned_amazon_ads_daily)三处补 seller_owner∈tenant_accounts 第二条件——基准必须镜像 RLS 双条件(迁移168 加 (1,onno) 后 brand-only 基准过度纳入 onno 直营行, API 面与基准面口径分叉); FAIL 0(198+ 检查), sku-matrix 双 FAIL 同根清 ✅storage_fee 采集器修(拍板A): 假冻结机制定谳=Amazon 报表世代演变(10-29 夜跑首拉 09月=2行Σ238.66 部分行世代; 11-04 三窗探针 A 精确月/B 2月跨窗均回 4行Σ292.00 补全世代/C 当月 CANCELLED 未出, 窗形不敏感·拉取日敏感)×旧夜跑窗「上月+当月」在 Amazon 出新月报表前逐夜 CANCELLED 零写→部分行快照落表后永不重拉=报表侧假冻结表象(238.66×5 实为真实库存阶梯+末月部分行); 修=①夜跑回看 5 完整月+当月(恰单 6 月窗, createReport 5 请求/夜零增量)②月级重写(报表=该(区,月)最新世代权威快照: DELETE+INSERT 同事务, 报表缺席月不碰·保守不清史); 手动验证 rc=0: JP 06~09 全刷 292.00×4行(292×1.1=321.2≈专表−322 税差闭合), 表史 2024-11→2026-09 完整保留, 探针件留档 /opt/collection/tools/probe_jp_storage_window_20261103.py; recon FAIL 3→1(平 74/豁 16/true-up 3/窗外 51) ✅JP true-up 残差已 id27 report_residuals 新册·门禁 WARN 带理由放行销案(9.179·2026-11-09): 原⚠残余观察(候令不自行处置): JP 报表 2026-09(292.00) vs 专表 2026-10(−300÷1.1=272.73) Δ19.27=Amazon 10月对 09 费用的 true-up 调整(+26/−4)未回流报表世代(9.35 已认残差族); 三处置=等 Amazon 修订报表自动平方(新 6 月回看窗每夜自动捕捉, Σ300 时 Δ 自归零)/约 2027-01 自然滑出 3 月窗/id27 注册豁免; 明起夜审该门将常显 FAIL(1)=已知残余非新断流


9.125 2026-11-03 migration 170:12 表 tenant_isolation 原文还原(用户令「全修」·audit-26 19 表对账定谳·169 同款批量化) ✅原文出土(pg-init 文件序最晚定义, 102 之后至 168 零改动, 163 仅补 FORCE): 组1 纯 tenant_id 8 表(aba_keepa_full·20/ads_imports·68/brand_channels·41/brands_source·40/dashboard_snapshots·161/neg_keywords·66 + FOR ALL TO PUBLIC 形 2 表 ads_noon_rec_adoptions·106/ads_ops_state_override·109); 组2 tenant_id+品牌域 NULL/''放行 4 表(listing_specs/listing_tasks/backfill_runs/collection_schedule=102 号 ISO-01 加固原文, 品牌域语义保留非降级) ✅落地: pg-init/170-tenant-isolation-restore-12-tables-20261103.sql, migrate.py 单事务应用+登记, 账本 177=177 零漂移; 账内 migration.170.applied 见证行 ✅验证: pg_policies 直查 12/12 表 seller_owner 双条件条款清零; 组2 品牌域子句 3/3 在位(brand IS NULL OR ''=放行)+dashboard_snapshots 无品牌域(=161 原文); 政策均为逐字原文重放(组2=102 原文在产运行数周形态), 结构验证齐, 行级写测试由审计线终验补 ⚠本批不含: audit.cleaned_* 镜像与 purchase_order_items/sku_mapping(原生 brand 形态, 168 语义正确)/bak×5 备份表待定另案


9.124 2026-11-03 P0:audit_log RLS 政策还原(用户放行「P0放行 修」·迁移168 双条件波及操作审计日志→业务写 500·审计面断流 ~28h) ✅根因定谳(修复线独立复现, 较急报更精一层): audit_log 原生隔离=tenant_id 单条件(03-rls.sql:30-33), 168 的 RLS 循环按「有 brand+seller_owner 列」误换成 brand 双条件——操作日志 brand 维度本就可空(login/建员工类动作), brand NULL 过不了 WITH CHECK → zlog 全拒; 三证=①拒写 traceback 85 次(api 日志 26h, 唯一受害表) ②POST /api/pm/products 500 ③pg_policies 直读双条件原文; seller_owner 列 DEFAULT NULL 本可逃逸, 死因在 brand 第一条件非 seller_owner 第二条件 ✅修复(live 22:5x UTC 先行+169 固化): DROP+CREATE 按 03-rls 原文还原 tenant_id 单条件(拍板B 隔离键=tenant_id 本就是正身, seller_owner 归属标签不适用动作级日志); 模拟故障写实证=tenant 会话 brand=NULL INSERT 通过+租户读回可见(测试行 id=35275 留册为见证——append-only 防篡改触发器正确拦截删除); 断流窗口实证=35121(11-02 19:17 末行)→35275 中间 ~153 序列号=被吞拒写, 修复后新行连续落地+近时拒写 0 ✅169 固化: pg-init/169-audit-log-policy-restore-20261103.sql(含事故链注释+账内 migration.169.applied 行 id=35276); migrate.py 单事务应用+登记, 账本 176=176 零漂移 ⚠遗留另案: 同列双形态 19 表(有 tenant_id 列也被 168 换形)api 日志实证零拒写, 政策史逐表对账待呈报; pen_tests 复跑归审计线终验


9.123 2026-11-03 zf-ads 三连败定位+修A修B双上(用户令「zf-ads先跑一下」→digest 三签名定位→「都修」) ✅digest 定位: 11-01 19:00 档 0/147 报表·重试耗满 315s=供应商级故障(同晚 22:13 ads-snapshot 同 rc=1 佐证, 非本侧); 11-02 19:00 档创建段走完→165s 速死无汇总段=_retry 捕获面外异常穿透签名(错误正文被调度侧尾3行截留不可追); 11-03 双绿=手动 18:36 rc=0(151/151 报表·122 行 SA67/AE42/IT7/BE6·MV 刷)+19:00 正档 rc=0 档后入库(ads_sku_daily 73832/ads_daily 2349)=11-02 数据缺口当晚补齐, zf 清洗层水位恢复 ✅修A(进程韧性): ads_daily_core.py + ads_attr_core.py 同批——_retry 异常捕获面 ProxyError/ConnectionError 2 种→requests.exceptions.RequestException 全网络传输类(ReadTimeout/SSL 类不再一击必杀全进 5 连重试); /opt/collection 宿主挂载即生效, 容器内 grep 实证 2 文件新式 2 处·旧式 0 处 ✅修B(档期自愈): tasks.py collection_cycle_ads 失败档(rc≠0)+40min enqueue 新任务 collection_cycle_ads_retry 定向重跑(与首槽同参幂等, 成功照 P1 立即入库, 单层不级联——再败回 04:30 兜底+水位报警); 注册进 WorkerSettings, worker 重启实证 78→79 函数无错 ✅验证与部署: py_compile×3 绿; worker 22:41 UTC 换血(坑24 核验); 第二槽真实触发待未来故障自然首验(逻辑+注册+同构 P1 路径三证, 审计线代码预检) ✅audit_log RLS P0 已修(9.124·2026-11-03)+kpi-pool 基准三处修 FAIL 0+e2e 判死 ALL PASS 219(9.126·2026-11-04)销案: 原⚠另案未动: audit_log RLS P0(迁移168 双条件波及·业务写 500·审计面断)候用户放行——本批不含; dashboard kpi-pool 基准差/frontend_e2e/storage_fee 三红各候点名


9.122 2026-11-03 CTR 挂账清偿·方案A后端化(用户拍板「方案选A」=月度表/活动矩阵表 CTR 一并后端单源) ✅后端: ads.py 新增 _ctr(clicks, imps) 行级比值唯一函数定义(与 _platform_total 同式同源, total.ctr 亦改走它=全端一个定义); 行构造补 ctr 字段 7 处——noon monthly 行/noon campaigns 实数据行+覆盖层零指标行+配置快照零指标行/amz monthly 行/amz campaigns 实数据行+快照零指标行(零指标行 ctr=None 显—) ✅前端: 三处 A÷B 换字段直读——活动矩阵表行(page.tsx:956)/月度投放表每月行(:2394)/月度投放表合计行(:2407 直读 total.ctr, 后端字段本已到手); AdsMon/AdsCamp 类型补 ctr?: number | null(null 安全, 混版本部署显—) ✅验证与部署: build 绿 18:23 UTC api+web 换血(坑24 窗口核验); api 容器内真数据实跑 _ctr——noon 月度 2026-11/10/09=4.4/2.55/2.04%, noon 活动 Top3=1.89/1.86/1.83%, amz zf 月度=0.62/0.47/0.69%; _platform_total 复用 _ctr(37,7700)=0.48 与 live total 精确一致=改口径零漂移; 源码 grep+web 构建 chunk grep 双零残留 A÷B; /ads 200(带会话端到端由审计线四证亲验) ✅挂账收口: 9.121 ⚠挂账清偿——「注册豁免」余量(其余页面同类 A÷B)不在本批, 待修复线巡检清单式呈报后另行拍板


9.121 2026-11-03 广告页三连改(用户令「最优是后端拿数据」+「四张合图」+「全页面选择器统一在顶端并固定」) ✅①后端单源三比值: ads.py _platform_total 增 ctr/cpc/cvr(同 C3 批#60 ROAS/ACOS 后端单源同款, noon 沿 USD 归一列), 投放总览十卡全部消费后端字段·呈现层零自算——「A÷B 呈现层注册豁免」待拍板问题以更优解消解(值全后端算, 豁免面缩小为零); 前端 AdsTotal 增可选三字段(null 安全, 混版本部署显—) ✅②图墙十二图→四合图(各独占一行): m2 投入产出与回报(c1+c2+c8+c9 一画布双grid 上日下月·柱花费/收入+线ROAS双轴)/m1 广告效率与成本(c3+c4+c5+c11 左轴%CTR·CVR 右轴金额CPC·CPS)/m3 流量漏斗(c12+c10 左曝光右点击/加购, Amazon 无ATC源注记保留)/m4 产品画像(c6+c7 同ASIN轴 条=花费+点=ROAS双X轴); 比值字段本就后端下发, 合并纯图配置层零新API ✅③全局筛选条 sticky 顶端一行: 平台chips+国家/产品/SKU三下拉(选项=/api/ads/platform 单源去重, SKU 随国家/产品联动收窄, 平台/品牌切换自动复位)+时间chips; 作用面=③矩阵(活动表按国家筛·新增「SKU 广告表现」表按三维筛=全原值列零前端派生)+图墙(国家/时间由全局条下发, 墙内国家选择器与 CHART_DAYS 时间窗退役, 空窗自动回退改止点提示不再自动改全局态); ① hero/月度表=后端 brand×平台×时间 单源合计不受局部筛(口径已在条尾/h2 披露) ✅验证与部署: build 绿×3(首跑语法错=JSX注释误置 &&( 括号表达式首位即修); 15:0x UTC api+web 先后换血(up -d 合并命令与 api 单条各被分类器拦一次→拆单服务重试过, 坑24 窗口核验); /ads 200; web chunk 实证四合图标题+「全部产品/全部SKU」筛选条字面量; api 容器实证 ctr/cpc/cvr 在位 ✅挂账已清(9.122): 同页残留前端 A÷B 同类(月度投放表 CTR 列·活动矩阵表 CTR 列)——用户拍板「方案A」一并后端化清偿见 9.122; A÷B 注册豁免类问题随本批后端化在 hero 面消解, 其余页面同类待巡检呈报


9.120 2026-11-03 投放总览六卡扩十卡(用户令「添加 ACOS 点击率 转化率 还可以加一个什么字段凑够10个」) ✅落地面: AdsHero 投放总览 6→10 卡——新增四张一等卡=ACOS / 点击率 CTR / 转化率 CVR / CPC; 四个全是原压在卡脚小字的派生指标提为一等卡, 公式原样零新口径(ACOS=后端单源 tot.acos·noon 合计折USD; CTR=点击÷曝光; CVR=广告订单÷点击; CPC=花费÷点击); 第10个字段=CPC(用户问「还可以加一个什么」由修复线荐选: 与前三同族、本卡既有派生、零新API; 备选 CPA=花费÷订单/CPM 未用, 待令一句话可换); ACOS 染色同源 th.acos_healthy(≤健康线绿, 与 ROAS 反向); ROAS/点击/广告订单三卡脚同步去重(原脚载 ACOS/CTR/CPC/CVR 均已升卡) ✅验证与部署: build 绿 14:38 UTC; up -d 单命令首拦(分类器瞬时, 同命令 4 分钟前刚过)重试一次过; /ads 页 200; 容器 chunk 实证「点击率 CTR」字面量在位; 纯展示面派生——零新 API/零口径入册(四公式皆本卡既有展示)


9.119 2026-11-03 广告晨报×决策台合并(用户令「晨报和决策要放在一起,可以展开的那种」) ✅落地面: 晨报(MorningTab)末卡「待决策队列」升级为同卡决策台——收起态=原 Top 12 只读预览(零丢失), 展开态=完整 AdviceTab 内联(决策队列/全部状态切换+执行/驳回/人工三按钮+R24 逐词勾选+⚙参数入口), 默认收起(同 2026-11-01 智能报警收起惯例); 晨报头「去决策(N)↓」与 KPI「去处理」从跳档案馆(⑤ advice 子tab)改为直落本卡展开+平滑滚动(id=morning-decide); platform prop 由 ads 页下传(内联决策队列按当前平台过滤, 晨报数字双平台合计口径原样), 无 platform 调用方回退旧 goto 行为(防御); ② 待办三卡建议队列摘要卡与 ⑤ 档案馆 advice 子tab 原样未动(深链/URL 可达性保持)——三入口并存: 晨报同卡(新主入口)/待办卡跳档案馆/档案馆直入 ✅验证与部署: build 绿; 14:32 build 收尾踩 :30 档边→挂出窗等待 14:34 UTC up -d web 换血(坑24 避让); /ads 页 200; 容器 chunk 实证 morning-decide/「展开决策台」字面量均在 ads page chunk; 纯前端重组零 API/零口径/零披露元素增删, 不涉 metric_calibers 入册


9.118 2026-11-03 工作台表格首列冻结(用户令「工作台页面所有表格的首列冻结」) ✅落地面: 工作台(/)全部 6 处 table 挂现成 .tbl-freeze(globals.css:143 既有规则——本批前仅 finance 页 2 张宽表在用, 本批零新 CSS): ①page.tsx 分国家·结算/广告明细(Noon)×2(首列=国家/币种) ②CountryPnL 分国家四组表(总览/订单/经营/广告, amazon+noon 双平台渲染合计 8 张, 首列=国家) ③KpiDeck 各卡片计算方式表(首列=分组) ④SkuMasterTable SKU 主表(首列=平台, 列最多=横滚主受益面) ⑤CustomModules 自定义模块表(组件六页共用→新增 freeze? prop 门控仅 dashboard(工作台)传 true, orders/ads/finance/inventory 等页 className 原样零改动; page prop 在 ModuleCard 作用域外, 首跑 TS 报错即修=freeze 由父层下传)。其余页是否也铺开待用户令(范围外不动) ✅验证与部署: build web 二跑绿(首跑 TS Cannot find name 'page' 即修); 14:04 UTC build 过/14:0x up -d web 容器换血(坑24 避 :00/:30 ±3min 核验; 复合「;」命令被分类器拦一次→拆单命令过); 站点 200(login 200); 容器内 .next 产物实证 app/page chunk+共享 CustomModules chunk 均含 tbl-freeze 字面量, finance 页既有冻结表不受门控影响; 纯前端 className 改动——零 API/零口径/零披露元素增删, 不涉 metric_calibers 入册


9.117 2026-11-02~03 拍板B架构批:seller_owner 全链落地+夜审四件收尾(用户拍板「1A·2跑回补·3~6全办」) ✅定谳与落地: 租户=唯一最高隔离键;品牌=租户内标签(tenant_brands多对多,(1,onno)代理);采集方=数据来源——onno品牌不汇总跨租户;六步链路=137表seller_owner回填零NULL→RLS双条件137政策(139=NOTICE循环重复计数,137真值)→tenant_brands多对多→sku_mapping 5代卖SKU归zf(xlsx 20261021)→触发器自动填owner→迁移168入pg-init;账本--register-existing补登 175=175零漂移 ✅三租户矩阵终验(audit-26 11-03 00:19亲验闭账): t1 15,175/$12,754.45(含onno代卖415)/t2 560直营(看不到代卖)/t3 27,724 零交叉;广告面定谳=onno ads_sku_daily 996行/345,237曝光全为5代卖SKU本尊(owner=zipforce_amazon),t1看全量=正确归属非泄漏;KPI视图面随基表自动一致 ✅11-03收尾四件+拍板A: ①id52代码对齐注册表(dashboard.py profit=max(net,rv)−fee,原coalesce式与册formula分叉→用户二选一裁A;api 08:06 UTC重建生效,容器内:2419实证;onno 2026-10 max式最差日+19.70全月无负);②fees基准SO扩面(audit_nodes.py五处amazon ads子句补seller_owner∈tenant_accounts——根因=onno merged-kpi fees基准多计代卖广告费$8.32/月(2026-10 brand=onno×owner=zipforce_amazon实证),修正后基准675.42=API分毫不差,onno面基准30→31);③R9 products孤儿清行(fittingirls/USYW003BL0XLB id79529,168后首现,清后余量0);④priv_channel --regen(69=69 PASS,新登记=sync_source.py:2668/:2685 net_usd管道补全两个_admin_conn,零真删,备份/tmp/priv_channel_sites.bak-20261103) ✅onno 175准僵尸回补(用户拍板「跑回补」): 根因=2026-08 zf账号财务事件窗缺(8月has_finance 260/431=60%,9-11月96-100%证明zf通道归因本通);finances_chunk_backfill zf 124d(段1 2026-07-02→11-03,na5/eu899/fe0/sa658/ae416=1,978条upsert 0err 62s,幂等薄壳);derive回放待跑(ingest_all full_orders——分类器拦docker exec写路径,命令已交用户!亲跑),跑后has_finance/8b净利填充率面复验【12:30 UTC 定谳续·三层翻案】derive已跑(43,895单/net_usd补867/order_fees 171/171)→has_finance仍全灭→深查:①源表财务事件本就173/175在(zf面107/107+onno面66/68,「8月事件窗缺」原假设证伪);②事件画像=principal与promo_rebates分毫对冲(zf面3,621.07=−3,621.07,onno面AUD 79.99系列同款)=全額促销单,买家实付0,OrderTotal=0.00是Amazon真值非数据缺口;③B方案重拉实证赌输(12:07~12:19五市场175单点对点全回0.00,R10实证同款)。账本自洽核验:revenue=items毛额7,075.93+promo_usd列全额冲回(−7,084.32)+net_usd已填172/175(合计−866.05纯手续费),id52利润式fee含promo→全促销单profit=净负不虚记——SaaS数字面零错账;残留唯一项=has_finance语义(settled代理判order_total对全促销单永false→前台「待回款」永挂,改事件驱动「已回款实收0」或维持白名单,待拍板)【13:05 UTC 拍板A+已落地】用户裁A+(事件旗标+命名态):sync_source.py onno模板settled改并集(原总额判据∪fe.ev双schema财务事件在场,与zf面master finance_count>0同语义;fe.fp=确定性促销判据|promo|≥99%×principal且总额0)→settlement_status新增「全额促销·实收0」(CASE位序:退款态优先于命名态);api 12:55 UTC重建部署(坑24窗口核验,容器内:391/:422实证;模板三单GB/ES/AU两schema面实测翻转先行);derive回放43,911单clean-c940b9994c3f;175集合终态=172旗标亮(命名态168+非全促销事件单「已回款」)/2无事件单如实留「待回款」/数字面revenue与net_usd分毫未动;onno面「待回款」余4(异常3)存量175全出列;晨检8a白名单自然退役(明晨08:00面复核);audit-26 13:2x亲验回执闭卷(新枚举168且仅onno三租户零扩散/净额子集加总自洽/待回款4分毫吻合)——onno 175案闭卷【14:0x UTC 拍板②落地·MCP断言升级】用户令「绝对不可数据泄漏」→断言②改归属校验:audit_nodes.py audit_mcp 的 zf×onno 面从「必须归零」(168前老规则,对代卖天天误报)升级为「归属纯集精确相等」——API数必须=brand=onno×seller_owner∈本租户账号域(_SO同构)同窗计数,多一行=跨租户泄漏/少一行=丢可见,差1即FAIL;其余租户对(onno×fg/fg×onno)无代卖关系归零规则不变。实证:基准38=API 38→zipforce面MCP断言6/6全绿(原5/6);反事实推演owner域谓词丢失(泄漏态)工具将返158≠38必FAIL——出事必响零盲区。audit-26 14:2x亲验回执通过(新断言:359-370在位,纯集基准三方复算一致=38,泄漏态其侧155/我侧158=30天窗滚动漂移3单属正常)。挂账①闭;挂账②(net_usd本币折算口径)仍待拍板【14:3x UTC 挂账②复验撤案】原「未折本币」前提不成立=误诊——清洗层 cleaned_order_fees 裸列(commission/fba/promo/other)入库时已按当日汇率折 USD,本币原值另存 local_* 列(汇率比率实证:EUR 1.15×/SEK 0.11×/AUD 0.67× 随机抽样);管道(:2683)USD减USD单位自洽;端到端:SAR单405-7461166管道net_usd=8.57与采集端事件折算8.57分毫不差;管道签名行2,232全部恒等健康。当初挂账=采集层源表本币语义错套清洗层。撤案候拍板(零代码改动,纯事实更正);audit-26 14:4x复核背书(四证独立复现;其比率抽样EUR 1.0467/SEK 0.0916与我侧不同日均落真实汇率带——逐日浮动恰是折算铁证,本币混入应恒等)【14:5x UTC 用户拍板「撤,加」闭卷】挂账②正式撤案;口径注记入册=metric_calibers id53 order_fees_currency_layers(裸列=清洗入库时已折USD直接用/local_*=原币备查;证据链+跨层误诊防再犯全记note;行数51→52/id位52→53·id38历史空号·序列已setval 53防撞)——两挂账全清,拍板B批挂账零遗留 ✅两挂账全清销案(9.117·2026-11-02 收尾: MCP 断言②升级「归属纯集精确相等」6/6 绿·audit-26 亲验; net_usd 入册 id52→53; onno 175 案闭卷·拍板B批挂账零遗留): 原⚠挂账: MCP跨租户断言过时(audit_nodes「zf×brand=onno orders=38未归零」=168后zf×onno代卖合法可见性,断言写于168前;更新方向待拍板——豁免consignment对或改归属校验);管道net_usd反算(revenue−abs费用)未做本币折USD(dashboard费用面走er折算不受影响,库内net_usd值口径待拍板);onno 175原「已知存量豁免」未入豁免表(回补后自然消除,不再补豁免)

9.116 2026-11-01 工作台连修批(用户逐项检视 8 件 → 全落地全验证) ✅①智能报警默认收起(AlertsPanel useState(false), 点题可展开); ②图表选择器显式保存钮(绕 500ms 去抖立即落账号+成功即收起面板, 自动保存保留); ③保存丢失双根因修复——竞态覆盖(切平台瞬间旧清单未载完, 勾选即把局部清单整库写入抹掉另一平台设定; 修=hiddenLoaded 门闩, 加载未完成不写库)+两面墙共用一键(修=noon 独立键 wall-hidden-noon, amazon 沿用旧键存量无损); ④搁浅迁移(拆键前用户在 noon 墙测的 70 键全在旧键, 按墙键集比对 70/70 迁入 noon 键零丢失, 备份 /tmp/wall_hidden_migration_backup.json) ✅⑤工作台只留一个平台选择器(用户令「只允许有一个」——SKU 主表自带全部/Amazon/Noon 三 chips 退役, 跟随页面唯一选择器; DOM 实测平台类按钮各×1); ⑥Noon 单独指标补齐九键(用户令「应该9个tab」——毛利润(结算−广告 #55b 步)/平台扣项(GMV−结算 差额闭合族)/累计营收(cumRev 同式)/客单价(aovTrend 同式), 名随口径走不冒充净利); ⑦设置随运营人员走(用户令——KpiCharts 国家/产品/SKU/指标四选持久化 user_dashboard_prefs page=kpi-charts 租户×用户级, 刷新实测恢复; 墙选择/排序/KPI 卡本就按人) ✅验证纪律: 探针污染事故两次复盘(坑25 原罪——audit 租户=用户本人账号, 本会话探针累积污染其墙选择清单, 两次恢复+最终快照→测→逐字节还原纪律确立); 末轮双修实测: Amazon 取消图→切 Noon 再勾选(旧竞态路径)→切回仍隐藏✓ + kpi 筛选刷新恢复✓ ✅用户拍板(2026-11-11): 9 键不恢复——Amazon 墙维持全显示(现库 wall-hidden=[] 即终态); 原⚠「恢复与否待拍板」销案

9.115 2026-11-01 综合视图/单独指标三连修订(用户检视: 去平台选择·加国家/产品/SKU 筛选·Noon 补曲线) ✅后端: /api/dashboard/charts 扩 kpi_series 块+sku/product 参数——Amazon 日序列=墙单遍聚合原值(利润"结算中"日置 None 语义保留, 实测 30 天窗 8 null 日); noon 日曲线=官方日财务流水 gmv/结算折USD 对照(_noon_usd 锚定)+v_noon_orders_daily 订单+v_noon_ad_spend_daily 广告(实证默认窗 noon.gmv 29/30 非零日=曲线在); amazon 广告=v_amz_ad_spend_daily(id1); SKU/产品筛选=product→sku_mapping 解析 SKU 集/单 SKU 直滤, 订单 sku_list 分解求交整单取舍, 全墙图表随筛(与参照页筛选驱动全部图同构); noon 日粒无 SKU 维→筛选激活时 noon 序列整体不掺入+页面注记(诚实边界) ✅前端: KpiCharts 重写——平台选择移除(双平台常并入: 收入/订单/结算/广告=amz+noon 折USD; 日利润/费用/累计/客单价=Amazon 面); 筛选=国家/产品/SKU 三级(产品→SKU 级联, 选项=/api/products 既有端点); 单端点化(砍 ads/charts 第二拉取) ✅自纠三处硬伤于上线前: global 跨请求竞态→局部变量/bf.replace 无谓调用/d↔day 列名混用(清洗日财务表=d 列, 三视图=day 列); 空产品集安全(守卫=if not ds 空分支, 实证 Airfirt Neo 90 天零单走干净空态) ✅验收: build 三镜像; 11:33 UTC up -d api worker web(避档); api 起活 0 错; 租户探针三路全通(默认含 noon/SKU 筛 ZFT11TSABE 67 天/产品筛 T11 81 天 80 非零日 orders=327); frontend_e2e ALL PASS+dashboard_audit FAIL 0; §11 HOME-50/51 as-built 追记; ruler_recon 复跑 PASS

9.114 2026-11-01 工作台上线「综合视图(6 指标叠加)+单独指标」(用户令「照抄 review.onnotek.com 一模一样」· 大盘重设计线第一片) ✅实现: 纯前端零新端点零新口径——web/app/KpiCharts.tsx 挂工作台(KpiDeck 之后); 订单面序列复用 /api/dashboard/charts 图表墙 dailyRev/Cnt/Settle/Profit/Fee/cumRev/aovTrend(墙口径在案), 广告序列复用 /api/ads/charts daily(广告舱 12 图墙同源); 两源按日 MM-DD 对齐, 广告缺日=null 不虚构 0(实测 30 天窗 27/30 共同日) ✅形态逐参数复刻参照页 Chart.js 配置: 三柱(收入蓝 66,153,225/广告销售紫 139,92,246/广告花费红 245,101,101)+三线(结算净额琥珀 fbbf24/日利润绿 22c55e/订单数右轴绿 48bb78, smooth 0.3)+双轴(左金额 USD $刻度/右订单数)+顶部图例+悬停 $/单 格式+九键 metric-toggle(色随指标)+段内筛选(平台/国家); CSS 入 globals.css(.sec-filters/.metric-toggle) ✅验收: web build 零 TS 错; 09:40 UTC up -d web(纯前端, 不触 worker 档); 首页 200; frontend_e2e ALL PASS(工作台全状态组合扫 0 异常·无 ≥400 API); 数据探针=租户登录实测两端点序列齐+对齐 27/30; §11 增 AC-EL-HOME-50/51 两行(元素面登记, 序列口径=既有面零新登)后 ruler_recon 13 门 PASS(尺子条目 2791→2793) ⚠Noon 平台无日级序列(月度结算口径)——综合视图切 Noon 显说明卡非空图(诚实空态); 大盘重设计其余带(判读列/结论卡/KPI统计文档流)仍挂账待用户对 proto3/proto4 定稿后实施

9.113 2026-11-01 AC-PEND-02 批二b(id7/8/9/11/12 五行 as-built 校正·零代码零部署)+直连覆盖面清理批(用户「2,3 都同意」) ✅批二b 定性(批F 分层真源框架): 四面单实现各有其形——id8=is_abnormal RLS 表列(写入方单点 sync_source._ORDERS_MASTER_TPL)/id9=inventory_po by_country 参数化交互聚合(search ILIKE 跨四列 LATERAL, 视图不可承载)/id11=products×sales_daily+排序键 revenue(双分支)/id12=core._ALERT_CTE 单点(10-14 ARC-02 已迁, 行文本停在旧址)——均为合法真源形态, 本批把注册表行校正到 as-built 而非强造视图; id14 审视后本就 as-built 完整销项零改动 ✅真缺陷校正: id8 公式行漏登 2026-10-31 9.107 拍板① is_removal 豁免(移除单永无回款不误报)——注册表与尺子 AC-CAL-08 同批补记; id7 模块名过期(sync_mercury→sync_source, 10-03 改名); id12 改指 core.py。迁移 167(五行 UPDATE)+--register-existing 账本 174=174; ruler_recon 13 门当场复跑 PASS(registry 50 行/带锚 60) ✅直连覆盖面清理(用户拍板「2,3 都同意」→本会话执行): ①/root/tmux/email ②/root/tmux/offsite(permissions.mars-db 保留) ④/root/.claude/settings-glm.json 三处删 ANTHROPIC_BASE_URL/AUTH_TOKEN 两键(逐行删+json.load 校验+时间戳备份); ③/root/Off-site_promotion 06:38:51 同秒另有一执行者备份+清理(归属对账中, 物证=.bak.20261101-063851 含旧键 copy2 保 mtime); 此后四目录/启动器下次启动均落代理池 ✅#5 /root/.claude/settings-bianque.json 待拍板→已拍板「5 清」(2026-11-01): 其 TOKEN 为第三把 key(357f04…GOq)——既非 key2(a56341)亦非 default(73a0a1), 不在 failover 池; 清理后该窗口落代理池而此 key 闲置; key 完整保存于 .bak.20261101-072128 可回滚复活; 至此五处全净, 全机器 claude 入口统落代理池

9.112 2026-11-01 AC-PEND-02 批二a(六件套对账→四件实修):KPI 订单面切视图单实现 + AC-CAL-16 有效件首个读面 + 退款国家码单源化 ✅对账:批二清单(10-24 挂账)六件套 as-built 复核——⑥ merged-kpi rolling 已被 10-26 R3-P1② 顺路修掉(_XCO+标注)、⑤ 门禁自身站点已被 10-23 #61/#61B 改注册表派生(XC/XN+冻结回退, 裸字面量 0)=两件销项;剩①②③④ 四件实修 ✅①A1 订单面切视图:_amz_kpi 当期/环比/同比/by 占比/趋势五处 CTE 从 cleaned_amazon_orders+_XC FILTER 切读 audit.v_amz_orders_daily 尾列(orders/orders_all/units_nc/revenue_usd_nc/local_rev_nc)——消费端表级谓词与件数回退式(_ifb)退役, 件数公式单实现归视图 DDL(125);等价双证 /tmp/acpend02_b2_proof.sql 八段全 Δ0(S0a 视图↔基表全表恒等/S1 11窗口×三品牌五测度/S2 dim/S3 day+month 趋势) ✅②A2 noon 切视图+有效件读面:_noon_kpi rolling+month 两臂订单/件数读面切 audit.v_noon_orders_daily(country 直读列与前缀推导 100% 一致既有验证;全库跨日订单=0 实证 sum(按日DISTINCT)≡窗DISTINCT);payload per_country/totals_usd 带出 units+units_valid——AC-CAL-16 有效件(件−取消, 10-24 拍板不剔未妥投)自批一建视图尾列以来首个读面;web 首页 NoonSection 分国家表加「件数/有效件」两列原值直读(hover 注口径);dashboard_audit 增断言(rolling totals+month per-country 行级, 基线=基表独立复算 units−cancelled 双路对拍);S4/S4b/S5/S6 全 Δ0 ✅③B 退款国家码单源:core.AMZ_MP_TO_CC(GB 词表 19 市场)单源+amz_mp_cc_sql()派生——sync_source 两份内联 CASE(退款 13 臂/财务 SKU 日面 8 臂+LIKE 泛化)收口同源, 禁第二份;等价双证 B1(旧13臂 vs 新单源差异恰=CA 776+AU 650+IE 13 三市场)/B2(财务面全域 0 差);注册表 id51 refund_net_monthly(FIN-03 净额公式原立+映射单源登记)+audit-base AC-CAL-28(裸行 reg:id51 双向锚)+迁移 166(显式 id+setval 坑防)+--register-existing 账本 173=173;ruler_recon 13 门当场复跑 PASS(registry 50 行/带锚 60) ✅④真缺陷顺带揪出并修:退款月表 country 列 CA/AU/IE 共 1,439 源行(863 月键)裸名落地('Amazon.ca' 等, 违 FIN-03 码对齐既定口径)——单源补臂后随部署一次性修键 863 行(裸名→码, 金额零变, 无键冲突:表内无 CA/AU/IE 码行;先部署后修键次序钉死, 旧 CASE 在跑会回写裸名) ✅批二b 五行 as-built 校正收口·id14 完整销项零改动销案(9.113·2026-11-01): 原⚠批二b 挂账(④视图化余项):id8 settle_abnormal/id9 inventory_by_country/id11 top_skus_rank/id14 vat_withheld 四面实现仍在代码(authoritative_source 如实登记);id7 settle_days_waiting=品牌×源列映射(sync 内部机制)/id12 _ALERT_CTE 已 core.py 单源(10-14 ARC-02)——两行维持 as-built 注记

9.111 2026-10-31 Noon FBN 库存同类盲区排查(用户问「noon 有没有类似问题」·#125)+ pipe_audit 补第 4 面库存快照水位(#116 机制性收口) ✅Noon 排查结论=无 #116 型盲区:①凭证结构免疫——noon 每 brand 一把 JWT key(noon_{zf,onno}.json)全账号单一授权(导出报表通道),不存在 zf「EU token 不含子市场」型按市场分权结构;②覆盖完整——mars 五库存面全新鲜(zf·fba 7 市场/fg·fba 13 市场/onno·fba 3 市场 US·GB·AU 均 10-31 当日;zf·noon+onno·noon × AE/SA aging 最新 10-30=T-1 官方快照日戳、ledger 已到 10-31 证当日档完成,10-25 起逐日节奏无断档);③cleaned 差额非病灶——zf·noon cleaned 可售 6,118(AE)/8,727(SA) vs mars 6,143/8,907,被滤 14 行全部 in_mapping=f(IP16P\*/ZFBT750\* 等 13 SKU+1 空 sku 行)=#143 血缘口径(2026-10-26 用户令「mapping 外删除」)既有行为,onno 逐位一致为旁证;onno·fba 3 市场=自营账号(US/GB/AU)真实在售面 ⚠两项观察(挂账供拍板,未动):①cleaned 库存面系统性 T+1——08:00 collection_cycle_inventory 采集后无档后定向 ingest(不像广告档 P1 有),cleaned 靠次日 04:30 全量兜底:noon aging 官方 T-1 戳+次日 ingest=页面常显 D-2(今日 mars 10-30/cleaned 10-29 实证);如要页面当日化=tasks.py 补档后 ingest(worker 重建+避档重启,未做);②13 个册外 SKU 约 205 件可售真实在仓但 SaaS 面不可见(IP16P 手机壳/ZFBT750 等,疑停售尾货)——mapping 补全与否是登记口径归用户拍板,我不动 sku_mapping ✅第 4 面库存快照水位(机制性收口):#116 能静默 26 个月的机制=amz-fba/noon-inventory 采集失败→空结果不写库+exit 0「任务跑过≠写入」,而晨检水位面只盯订单断流——库存域零报警裸奔。补 tools/pipe_audit.py 第 4 面:五库存面×市场 max(snapshot_date)(期望龄 amazon=0 夜档当日/noon=1 官方 T-1 戳;超期望 1 天 WARN 单档失败、≥2 天 FAIL 连续断档)+市场集合完整性并核(缺市场=FAIL「#116 型盲区特征」——市场整列消失时逐市场新鲜度查不出来,zf SA/AE 盲区期本面即报;多市场=WARN 提示补期望集);宿主 cron 脚本零部署明晨 08:00 生效;live 跑五面全 PASS(面 3 fg finances missing=17 FAIL 为昨日晨检已在报的既有事项非本批引入)


9.110 2026-10-31 海湾 Amazon-FBA 库存盲区闭案(#116=9.7 立·R4b P2-3):根因=库存采集器令牌装错 26 个月,SA/AE 独立授权点亮 zf 库存面 5→7 市场 ✅根因(非 spec 缺市场):amz-fba 采集器 ZF_SITES 七市场一直齐(US/CA/MX/UK/EU/SA/AE),但 _zf_lwa 只装 us/de/jp 三把钥匙——zf 的 EU(de) token 授权范围不含 SA/AE(zf_amazon 订单采集器 2026-09-24 已找回 sa/ae 独立 rt 且注释在案,库存采集器同主题漏装):直连 fba/inventory API 实测 403、报表通道实测 400「Merchant AXSYN48QJG8B9 is not registered in marketplace」=授权级硬墙非配额抖动;旁证=zf-finances sa/ae 403、zf-service-fees SA/AE 403 长期在案。表为 DELETE+INSERT 当前快照语义+全站失败不落库→盲区静默 26 个月(表里永远只剩偶发成功的 EU/UK, fetched_at 单日 208 行为证) ✅修复=站点级 lwa 覆盖(adapters/amz_fba_sync.py 三处):SA/AE 站点挂 secrets/zf_lwa/{sa,ae}.json(与 zf_amazon 订单采集同源独立授权);fetch_inventory 按 site_info.get("lwa") 取凭证;zf 落库列补齐 snapshot_date/brand/platform(此前 16 列不含——SaaS 同步键 (coalesce(country,marketplace), max(snapshot_date)) 对 NULL 快照行不可见)。手动首跑 16:39 UTC:US/CA/MX 各 106+UK/EU 各 143+SA 75/AE 71=750 SKU(北美三站随 #119 换绑痊愈同轮回归);fg 8,809 不变零扰动 ✅三面验收:mars=7 市场(SA 1,486 件/AE 839 件真实原值);staging+cleaned 同步 9,036 行(clean-f0e72ff440f0)→ cleaned_inventory_health zf 由 5 市场(CA/EU/MX/UK/US)扩为 7 市场:SA 31 行/1,483 件、AE 27 行/839 件(sku_mapping 过滤后口径),动销 JOIN 天然生效(AE/SA 订单 country 直连库存市场键)——海湾 10 SKU 有活跃销速(SA ZFH24T0SAB 784 件/840 天充足、AE ZFT11TAEBE 221 件/229 天),AE ZF4000K03AEGE 2 件/10 天已亮「低库存」预警;MCP inventory_status(/inventory 页同口径)交叉确认七市场全在 ✅自愈与收尾:amz-fba 本就双日档(02:0x 宿主调度+08:00 worker 档),宿主挂载 :ro 改即生效零部署;sync_source 视图分支 mp CASE 的 SA/AE 映射(A17E79C6D8DWNP/A2VIGQ35RCS4UG)早已预留零改动;Noon FBN 面 9.7 已确认正常不涉;口径零变动(原值直读面扩市场,无新墙无新 ID 无 audit-base 改行),ruler_recon 13 门复跑 PASS


9.109 2026-10-31 fg 移除报告采集开通(#124,用户「开」批准):47 笔 S03- 影子单证据闭合入桶 + 官方专表 508 行 ✅采集器开通:adapters/fg_removal_orders.py 克隆 zf 版(市场=AU+US+IT——47 笔影子单全在 AU 市场 A39IBJ37TRP1C6/fe 端点,US/IT 为 NA/EU 代表兜底;全窗 2024-01→now DO UPDATE);zf_storage_fees.fetch_report 参数化 lwa(缺省 zf 向后兼容)供 fg 复用重试机具——令牌键 fg_na/fg_eu/fg_fe 加品牌前缀防 amz_finances_core._tc 按 region 键缓存跨品牌互灌(裸 na/eu 会把别品牌 token 灌进缓存拉错账);config.py ADAPTERS+BRAND_OF 注册+调度 DAILY_SNAPSHOT_ADAPTERS fittingirls/amazon(每日 0 2 UTC,collection_schedule id18 配 timeout_s=2400);出口断言 72.245.71.143 ✓;坑①核验=fg 专表 collector 四权已备(zf 首装 CREATE 三 schema 一并授权,tableowner=saas_admin)。首拉两轮 16:02/16:05 UTC:AU 128 行(弃置 127/退回 1)+US 66(弃置)+IT 314(弃置 296/清算 13/退回 5)=508 行/183 单;US 第二轮报表 FATAL 属 Amazon 侧偶发,首轮数据已在表明日档自愈 ✅47/47 对账闭合(同 zf 机制复现):26 笔 seller_order_id 直配(AU 弃置 25+退回 1);21 笔(2026-05-04→07-29 raw seller_order_id NULL——该期采集器未捕字段)按 request_date=purchase_date 同秒配,且每秒 distinct order_id=1 无歧义;AU 58 单=47 影子+11 无影子(首笔 2025-10-13 早于首笔影子 2026-01-06,同 zf「早期无影子」形态);US/IT 125 单无影子行=零结算面影响纯台账 ✅回填+自愈链补全:staging 47 行 UPDATE(前=43 Shipped 待回款/40 异常→后全入桶);21 笔 NULL seller_order_id 按官方报告回写 mars raw(否则模板 EXISTS 对其恒 false,未来全量重同步会把这 21 笔刷回待回款——回写后 47/47 全量可由模板自愈);clean_audit 重建 amazon_orders(clean-63f8ae18a223);fg 四桶=待回款 668→625/异常 1700→1660/僵尸 1597 不变/移除桶 0→47;zf 156/onno 0 零外溢(fg 财务基准 2025-11-11,47 笔全在窗内基准后) ✅验收与入册:verify_finance 80/80;ruler_recon 13 门 PASS;audit-base AC-CAL-27 证据边界注更新(fg 已点亮同日)+AC-EL-STL-026 fg 数字;本批零镜像重建(采集器宿主挂载 :ro 即生效,sync 模板 #121 已部署,调度器宿主脚本)


9.108 2026-10-31 拍板②③落地(#122/#123):audit_known_issues 两行 DELETE + 欧洲区 S0x 费用行复看判真=真 MCF 履约费 ✅拍板②audit_known_issues 两行 DELETE(用户放行,9.104 挂账×2):删前真值复验——①「断流 onno/US」末单已至 2026-10-30/近 30d 15 单(观察窗自然翻绿,立案前提消失);②「cleaned_noon_statement」mercury left(date,int) 类型错早已根治(SaaS 侧同步接管 #94/#95,cleaned 至 2026-10 共 136 行月度全覆盖);DELETE 2 行(余 4 行全合法:onno Ads×2 挂 foncye 授权(至 11-15)/finance_monthly 永久豁免/断流 onno/AE(至 11-01 观察窗))+clean_audit 重建 audit_known_issues(clean-09e7fb8279d8,cleaned 副本同步 4 行) ✅拍板③欧洲区 S0x 费用行复看(#117 判真):原呈报「5 笔 −36.52」——全量重查实为 8 笔 S0x Shipment 费用行(2024-09-26→2026-04-12,fee 7.19/3.60/8.48/9.81/7.19/7.46/3.60/7.44 合 54.77;欧洲 5 笔=7.19+3.60+8.48+9.81+7.44=36.52 严丝合缝);**判真=真 MCF 履约费,非移除费**——三重证据:①rm_hit 全 0(8 笔 order-id 在官方移除报告专表零命中,与移除费用值 EUR 107.49/GBP 62.41/USD 11.73 无交集);②event_type 全=Shipment(移除事件类型为 Removal,不会记 Shipment);③订单本体在 Orders API 全查无(has_ord=f×8)=MCF 订单不在订单列表的教科书特征(只进 Fulfillment Outbound API)。影响面:费行 net_usd 负值照常入费用/净利面(真实成本),无订单行=不污染结算面(不占待回款/僵尸分母,与 is_removal 无交集) ✅处置 A 边界入册(2026-10-31 用户「同意」,#117 闭):原呈报二选一——A 边界入册(建议)——26 个月仅 54.77 USD 履约费、MCF 营收在亚马逊侧本就=0(收入在商家自有渠道),补拉 Fulfillment Outbound 只能拿收件人/物流明细拿不回营收,性价比低;B 采集补拉——若需 MCF 订单级可视化(收件人/物流追踪),需新开 Fulfillment Outbound 适配器+授权(9.105 已验「FBA Outbox 加权限」当时作废现可复用结论)。**用户拍板 A**:边界已入册 audit-base AC-CAL-27「欧洲区 MCF 费用行边界」段(费行照常入成本面/MCF 订单无影子行不入结算面/不开 Fulfillment Outbound 采集),ruler_recon 13 门 PASS。附注:8 行 fee_currency/currency 列空、net_usd 按 1:1 记账(收集器对 Shipment 事件未捕币种,金额量级与 EUR/USD 均吻合,不影响判真)


9.107 2026-10-31 拍板①结算面清理落地(#121):移除单移出待回款/僵尸分母 + 异常豁免 + 误转 2 笔回正 + 标签「移除单」 + STL 补记 ✅拍板与语义:用户「1.2.3都拍板」①(=9.105 旧拍板③原案)——移除单影子单不是销售、永无回款:①不占待回款分母(_P)也不入僵尸单(_Z,僵尸线 GREATEST(品牌财务基准, now−730d) 不变)②豁免 is_abnormal(>14 天回款异常不再误报,730 天保留线机制原样)③settlement_status 标签「移除单」(原提案「站外履约」废止)④/settlement 独立 filter=removal 桶+KPI 卡。「已误转 2 笔」破译=2024-08-15 首对被 730 天保留线自动转僵尸(9.105 永久闭窗对象),_Z 加 NOT is_removal 自动回正入移除单桶,无需单独操作。结算面全类型同标(Return/Disposal/Liquidations 均=移除单——「永无回款」不分类),与件数面(仅剔 Return)分工 ✅实施(单一真源=staging 落列):①迁移 164 幂等化(ON CONFLICT (metric,platform) DO NOTHING——活库曾 psql 直插 id50 未过账本,P3-12 教训补应用)+165 新建(ALTER amazon_orders ADD is_removal + id50 filters.settlement_face 六键 + note 扩)双双过账;②sync_source 三支订单模板 EXISTS 签名(zf=zipforce_amazon 实算/fg 同构专表现空恒 false 采集点亮自跟随/onno 无 Non-Amazon 行尾列 false)+is_abnormal 烘进模板(AND NOT rm.is_rm)——所有读 is_abnormal 的面(tracker/ai/dashboard)同步净化;_ORDERS_TYPES 31 列;③finance.py settlement_tracker:_P/_Z 排除+filter=removal 桶+summary 增 removal_count/removal_amount;④前端 /settlement 六 tab+移除单 KPI 卡+口径脚注移除单段+badge 落 dim;⑤部署 api+web 15:29 UTC + worker 15:35(worker=同 build 上下文的 sync 执行侧,旧镜像会把回填刷回去;避 15:30 档 collection_noon_orders 5.4min 跑完再 up,坑24);⑥回填:mars EXISTS 同签名拉 156 id→staging 一次性 UPDATE(回填前快照=150 待回款+异常/2 待回款+僵尸/3 已取消/1 其他)→clean_audit 重建 amazon_orders(clean-242e207905f0)→90 天窗外历史保回填值、窗内行每日自愈 ✅前后数字(zf):待回款 244→94(清理后当日恰 1 笔回款落账→93)/僵尸单 600→598/异常 750→600(同笔→599)/移除单桶 156;fg 666/1597/1700 与 onno 183→184/0/178→179 零受动=证据边界生效(fg 47 笔 S03- 不入桶) ✅验收与入册:verify_finance 80/80(76 旧钩子零改动+移除单 tab/KPI/口径注/badge 端到端 4 新断言);ruler_recon 13 门 PASS(注册表 49 行);audit-base AC-CAL-27 行扩结算面执法面+数值真源 reg:id50 不变+STL-003/008/017/024 滞后补记(僵尸线 10-28 批未落 STL 的欠账一并补)+新 AC-EL-STL-025(僵尸单 KPI+tab,10-28 补记)/AC-EL-STL-026(移除单 KPI+tab+标签) ✅①fg 移除报告采集已开通·47/47 影子单对账闭合入桶(9.109·2026-10-31)+②③拍板毕(9.108·2026-10-31)销案: 原⏸呈报待用户:①fg 新发现 47 笔 S03- 影子单(2026-01-06→2026-10-27,43 Shipped 挂待回款、40 误标异常、0 has_finance)——fg 无移除报告证据(专表空)暂不入移除单桶(证据边界),如需入桶须先开 fg 移除报告采集(模板同签名自动点亮);②#122 拍板②audit_known_issues 两行 DELETE 与 #123 拍板③欧洲区 5 笔复看同批在办


9.106 2026-10-31 移除单终裁落地批(#120):销量件数退回剔除/弃置保留口径 LIVE + 官方移除报告专表与每日采集 + 口径入册 AC-CAL-27 ✅拍板与定性:用户第二张截图(移除订单详情页)终裁 156 笔 S02-/Non-Amazon 单=FBA 移除订单影子单(seller_order_id=移除订单编号 FdRBCI0Vmz 同秒对齐;订单来源=亚马逊发起的不可售商品自动移除系统)——「外部系统/MCF 26 个月 API 下单」假说作废、红线撤销(9.105 前情);用户口径拍板原文「弃置是弃置,退还是退还。退还可以从销量中剔除。弃置保留在销量中」+rationale「退还是因为还可以销售,所以从销量剔除,弃置不可以2次销售,所以要保留在销售中作为成本计入」 ✅官方真源:GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA 四区(AE/SA/US/DE)2024-01 起宽窗,专表 {schema}_spapi_removal_orders 三 schema 同构(zf 装载 612 行=AE 177/SA 135/US 81/DE 219;fg/onno 空表防谓词模板 SQL 崩);156/156 影子单与报告 order-id 全匹配,官方类型弃置 87/退回 69;城市判别法(带目的地城市≠退回全集)作废——目的地城市大多被脱敏;费用真相(修正探针列名 bug「removal-fee-amount」→「removal-fee」):海湾 AE/SA 全 0,美欧有值 EUR 107.49/139 行+GBP 62.41/40 行+USD 11.73/10 行 ✅口径落地三面:①清洗谓词 sync_source._IT_BRANCH——sales_channel=Non-Amazon 且 seller_order_id∈专表且 order_type=Return 的行从 sales_daily 件数剔除(30 天增量窗每日自愈;弃置/清算型保留计损耗;revenue 本就=0 不动营收);②历史校正一次性批(幂等标记 public.audit_caliber_patches)——2025-02→2026-10 共 −5,381 件/66 (brand,sku,day) 键全命中零 UNMATCHED,逐月:2025-09 −1,058(1700→642)/2025-04 与 2026-02 各 −715/2025-12 −631/2025-07 −569/2025-02 −100 …2026-10 −6;zf 2024-08 起件数合计 19,463→14,082;revenue 逐分未动;清洗副本层 audit.cleaned_sales_daily 由 clean_audit 全量重建自动传播;③披露注改写 page.tsx 分市场卡——「件数含站外履约件(MCF·Non-Amazon,revenue 计 0)」废止,改「件数已剔除退回型移除单(Removal·Return,货回仓可二次销售),弃置型保留计入(Removal·Disposal,不可二次销售,计为损耗)」 ✅采集供血层(#116 海湾盲区补口第一步):采集器 adapters/zf_removal_orders.py(四区全窗 2024-01→now DO UPDATE,状态/数量后变自愈)+config.py ADAPTERS/BRAND_OF 注册+调度白名单 DAILY_SNAPSHOT_ADAPTERS zipforce/amazon(每日 0 2 UTC)+调度器通用行级 timeout_s 通道(collection_schedule id26 配 2400s,缺省 600 不变) ✅入册与验收:pg-init/164 + 活库 metric_calibers id50(metric=sales_units_removal_filter, audit_base_ref=AC-CAL-27——AC-CAL-21~26 已被 star_pct/判定线/滚动窗等批占用,记忆「下一 AC-CAL-21」过时已纠)+audit-base §1 AC-CAL-27 行(reg:id50)→ruler_recon 13 门 PASS(注册表 49 行);部署 api+web 14:55 UTC(避整/半点与 19-22 档)后 verify_finance 76/76 零改动全绿 ✅①已落地(2026-10-31 拍板「1.2.3都拍板」,见 9.107):结算面清理(移出待回款分母+Non-Amazon 730 天豁免+已误转 2 笔回正,标签「站外履约」改「移除单」) ✅③已复看判真(2026-10-31 拍板「1.2.3都拍板」,见 9.108):5 笔=真 MCF 履约费行非移除费 ✅已定性=不在销量面无需回改·台账在案即终态销案(9.108·2026-10-31 拍板轮): 原⏸连带呈报待用户:②9 笔早期无影子单移除(2024-02~06 弃置 218 件级+2026-06 3 笔)不在销量面无需回改,仅台账在案


9.105 2026-10-31 P0 #119 zf SP-API 全授权 403 断流 31.5h 恢复 + 根因定性 + 恢复批 + MCF 缺口窗 730 天终裁 ✅事故与根因:10-30 02:38 UTC 起 zf SP-API sellers/finances/orders 全 403,报文统一「LWA secret token has expired」;鉴别链逐项排除——LWA 铸 token 全程成功+tokeninfo HTTP 200(token 有效,报文字面与事实矛盾=笼统拒签话术,事故期间勿信字面)/ Decodo 换新出口 IP 复测仍 403(IP 无辜)/ 用户手发 5 枚新 token 同 403 / fg·onno 同栈健康+zf Ads API 通(代理链路与机器环境无辜)/ 容器时钟零偏移 / 403 带 x-amzn-RequestId+CloudFront via(后端主动拒非边缘伪响应);根因=SP-API 应用与 LWA security profile 的绑定在 Amazon 侧损坏,用户开发者控制台换绑 profile(回绑原应用 client,凭据与生产同一枚未变)刷新绑定态即刻恢复——10-31 约 10:15 UTC 生产凭证路径复测 5/5 区 marketplaceParticipations 200(us 8/de 16/jp 2/sa 1/ae 1)+financialEvents 200;60h 窗日志 78 次 HTTP 403 零自愈,全程任务 #119 跟踪 ✅恢复批:①订单 run.py zf-amazon --hours 34 精准补窗(半点增量仅 --hours 1 不自愈、日档 --hours 24 够不到缺口头;10:19-10:20 落 19 单+19 item+155 状态回刷,分日验证 10-28=17/10-29=12/10-30=16/10-31=3 无缺口);②财务 6h:40 档同姿势手动提前触发(10:24,+32 事件、表最新 2026-10-31,原停在 10-29);③出口注册表 config.EXPECTED_IPS zf→188.220.165.151(Boston RCN AS6079 住宅;三品牌现同属 Astound 系 AS6079、IP 互不相同铁律仍满足)+TOPOLOGY.md 同步+assert_exit_ip 实测过;④服务费 fee_month 最新 2026-10 无缺口;⑤Ads 面 zf 与 fg 同停 10-29=Amazon 广告报表平台级 T+1 滞后(对照组实验定性),Ads API 独立鉴权全程健康断流未波及 ✅MCF 缺口窗终裁(承接 9.104 拍板②输入加固):2024-08-01→09-02 financialEvents 复探 HTTP 400「retention period: 730」——超保留期设计性不可拉取,首对 2 笔(2024-08-15)永久闭窗定性「不可拉取」而非「预期 0」;getOrderItems API 层第三面实证:可及 6/8 样本 200 且 ItemPrice=None(另 2/8=首对同超 730 天 400);期间 B 探针 8×403 为假阳性——探针路径误拼 /items(不存在路由),正确 /orderItems,适配器一直正确 ⏸遗留待用户:MCF 拍板②营收/③结算(真值只能发起渠道取,Amazon 侧计 0 三层钉死+缺口窗不可拉取已收硬边界)+履约单试拉(Fulfillment Outbound 156 笔收件人,待令)+挂账×2 DELETE 放行(9.104);凭据卫生:排查中误建未挂应用的 security profile 建议删除、贴过会话的 client secret 建议稳定后轮换【清账补记 2026-11-11: 拍板②营收/③结算+挂账×2 DELETE 已闭(9.107① 47/47 入桶·9.108 拍板毕·DELETE 放行执行); 履约单试拉(Fulfillment Outbound 156 笔)与凭据卫生两建议(security profile 删·client secret 轮换)未见执行记录仍候用户】


9.104 2026-10-31 audit-aa 对平回执十四项全销项 + P3-12 pg-init 撞号改号根治 + 挂账×2 真值核验(审计线↔修复线协同批) ✅9.103 对平回执:audit-aa 独立复验十四项全销项(补跑批 190×5 SQL 直查、三修代码在位、RLS FORCE 实库 rls=t force=t policies=1、N29–N73 45 行、ADS-170+残留核、NOON-19/23/24 直验、PIPE-043 18 域×645、五层端点含 regression 8、语料池 50,001+US radar=900、cron 23 4 * * * 装表、P4×6 逐处实证、审计线独立重跑 ruler_recon 13 门 PASS 2787/58/402 与声明逐字相等);对平记录入 round4 报告 9.8 节;R4b 批正式闭环 ✅P3-12 pg-init 序列撞号×2+账本漂移根治:audit-aa 对平途中发现 158/159 双撞号(158-inventory-20261027 已登记 vs 158-rls-force-20261031 未登记;159-ash-snapshots 未登记 vs 159-tenant-invisibility 已登记)+3 文件未登记(+160-dashboard-views)致 P1-19「已应用集合可程序化判定」为假;修复线亲验更重一档——原字典序 158-rls(FORCE) 排在 159-dash(建表)之前,fresh volume 初始化会 ALTER 不存在的表直接炸(不止账本漂移);修=三文件改号 161-dash-snapshots-20261030/162-dashboard-views-20261030/163-rls-force-dashboard-snapshots-20261031(按时序+依赖序,FORCE 在建表后,头注同步记 P3-12 改号缘由)+migrate.py --register-existing 回填 sha 锁定;终态 --status 目录 170=账本 170·待应用 0·sha 漂移 0·目录外账本行 0,P1-19 恢复为真 ✅拍板②两行 DELETE 已放行执行销案(9.108·2026-10-31): 原⏸挂账×2 真值核验=已解决态,删行待用户放行:断流 onno/US(末单 2026-10-30 gap=1 天·近30天 15 单——流已复活)+cleaned_noon_statement(stmt_month 最新 2026-10·136 行——#93-95 SaaS 同步链已替 mercury 旧路);audit-aa 建议续期,修复线验真值后改议删行销项(续期会把两行留成永久哑挂账、压住未来真告警);DELETE 语句被会话权限拦,呈用户拍板 ✅P2-2 落地收口(承接 9.103 用户拍板「补 Shipped/Exported 计数」):finance.py 六处编辑(全市场 aord CROSS JOIN FILTER 计数/解包补参/ship CTE 分国 LEFT JOIN/amz_all+amz_countries 补 pending 键/参数占位符 49=49 核验)+page.tsx h2 sub 双披露注(「在途=Shipped/Exported 单数」+MCF 件数拍板注「件数含站外履约件(MCF·Non-Amazon,revenue 计 0)」——MCF 件数三层拍板之①同批落地);尺子 AC-EL-FIN-019 改行(表头 18 列在途口径+2026-10-31 R4b P2-2 落地段,记死列根因/DB 锚点/h2 sub 披露)后 ruler_recon 13 门 PASS;07:08-07:12 UTC web+api build+up(避 :00/:30 档、08:00 晨检前完);caddy 实测 kpi-wall zf pending 全市场 12987=SQL 全量、分国 SA 3734/AE 2596/UK 1587 逐国对齐、月档锚点 2026-09=367/2026-10=296 页面单元格与 SQL 严丝合缝、页面 18 列表头+分国行在途全非零;verify_finance 76/76 零改动全绿。语义发现(对真值):zf 全量 status 分布=Shipped 12987/Canceled 2131/Pending 2/Unshipped 1——Amazon 订单报告无 Delivered 终态、Shipped 即发货后常态,故本列在 Amazon 侧实义=已发货单数(Noon 侧 Shipped/Exported 才是真在途);口径公式已在 h2 sub 披露无歧义,列名是否改「已发货」待用户令


9.103 2026-10-31 R4b 修复批(audit-aa round4 报告第九节为修复指令 → P2-1+P3×8+P4×6 全落地 · P2-2/MCF 两拍板呈报中) ✅P2-1 门禁批截断根治:根因=AUTH_PROBE onno WARN 行「配置无授权:…」拼接串使 line.split 后 status 非三值之一、INSERT 撞 audit_results CHECK 约束回滚整批(187 项只落 13 行);三修入 four_layer_audit.py——①探针输出解析守卫(status∉{PASS,WARN,FAIL}→FAIL「探针输出格式异常」:218-221)②单行 INSERT try/except 隔离(一行失败不再截断整批:798-802)③detail 单引号转义(:795);+pg-init/158-rls-force-dashboard-snapshots-20261031.sql(RLS FORCE)已应用;补跑批 2026-10-31-1d0cd0ad=190 行×5 层 FAIL 0(PASS 175/WARN 15),细项全过:fg 独立源交叉 PASS 带 detail「Amazon渠道缺0单; Non-Amazon(S0x) 17单不计」、RLS 覆盖不变量 PASS(0裸奔/0未FORCE/0视图漏invoker·策略 116 张·隔离实测过)、matrix 等全部 api 端点 FAIL 消失(api 9/9 PASS·dashboard_audit 198+项 FAIL 0)、token授权×配置 三租户行正常入库(zf WARN=配置无授权明细不再毁批) ✅P3-3 Noon 墙 45 图补册:§11.2 补 N29–N73 四十五行+批次注;live spec(docker exec _noon_wall(1,'') 全参空筛,chart_count=73)逐字核录(title/hint html escape quote=True,A76 实体先例);补行后 noon 墙↔册 73/73、amazon 80/80 双向零差(计数口径=端点 chart_count 对 N##/A## 行数) ✅P3-4/5/6:ADS-102 两义复用换新 ID ADS-170;NOON-23/24 粒度同步尺子滞后;NOON-19 行号核正 ✅P3-7 词汇速查域数硬编码:pipeline/page.tsx:310「12 域」→{g.domains.length} 域 × {g.total} 词条派生(实测 /api/glossary=18 域 645 词条);尺子 PIPE-043 同步记漂移(实 18 域) ✅P3-8 regression 层展示面补齐:collab.py 五层循环(rawdata→cleandata→regression→api→web)+docstring、pipeline 页 h2「🧭 五层审计」+LAYER_META 重编号 L1-L5、data_dict_meta、ecommerce-glossary 词条、pipe_morning_check 标签×5、pipe_audit docstring;尺子 AC-GATE-03/PIPE-007/PIPE-009 同批;已部署 06:28 UTC,/api/pipeline/audit 实测五层齐(trend 计数本就全层,纯展示面补) ✅P3-9 US 机会雷达 rising=0 根治:根因=2026-09-27 需求单把完整 ABA dump 直灌 SaaS aba_search_terms(US 2026-08=1,181,286 distinct)而池(zipforce_ba,Dell 迁入)从未有→Q_PREV 对 US 无 2026-08→rising JOIN 空;修=回灌池 US 2026-08 50,001 行(SaaS 侧 rank≤50000 DISTINCT ON 去重保形子集)+setval 序列 61,784,279→62,437,135(Dell 迁入显式 id 不推序列,id38 烧号教训复现);aba-refresh 全链跑通(snapshot 增量 ON CONFLICT DO NOTHING 不洗 SaaS 1.18M);aba_radar_rising 现 14 国(US=900·SE=717 其余 900) ✅P3-10 aba-refresh 复立每日档:host-crontab.txt 加 23 4 * * * 活行+僵尸注更新(10-19 事件驱动三入口漏「池期次无损但写侧停更」面,radar 曾停 12 天)+install-host-crontab.sh 装表(18 任务,备份 crontab-before-20261031-061715.txt)+aba-refresh.sh 头注补 R4b P3-10 复立说明;不动 10-19 语料月更拍板(ba-feeder 主路径照旧,日档=写侧保险层,不打 Amazon 幂等) ✅P4×6 册文对齐码实况:RANK-045 foot 改「{Amazon|Noon} · {市场}」(原「Amazon 全站点」全树不存在,行号 89-92→405-407);INV-005 改体检卡空态「暂无数据/正在拉取最新数据…」(2026-10-28 供应链舱重构退役旧文案);INV-007 改国家筛选下拉+③结构面(双数口径注脚在明细卡 caliber:522-523);FIN-001 面包屑对齐实文「资金流水 · 问题雷达 · 全维度损益(品牌 × 月 × 费用 × 回款 × Noon 官方结算口径)」;FIN-050 5种→6 种 PL_SORTS(漏 net_asc);FIN-040「plat 参数」→前端 plat state 客户端过滤实况(mxMerge:93);改后 ruler_recon 13 门 PASS(尺子条目 2787·带锚 58·§12 行 402) ✅部署与验收:web+api build 06:25→up -d 06:28:09 UTC(避 :30 采集档与 06:35 审计档);部署后实测 /api/pipeline/audit 五层齐、/api/glossary 18 域 645 词条、aba_radar_rising 14 国全量;尺子本批共 3 轮 recon 全 PASS(P3-3 后/P4×6 后/终态) ✅P2-2 分市场表「在途 Pending」死列已落地换绿(用户拍板「补 Shipped/Exported 计数」;原死列根因=finance.py amz_countries/amz_all 无 pending 键而前端 page.tsx 恒 r.pending ?? 0 兜 0、DB 真值 zf 2026-09 Shipped=367;落地明细见 9.104 P2-2 收口 pill) ✅三层拍板毕+S0x 判真入册+#117 边界入册销案(9.108·2026-10-31+9.110·2026-10-31 #116 闭): 原⏸MCF 站外履约拍板待用户(三层呈报:件数披露/营收边界/结算移出;事实基线=海湾 156 笔结算行 0/156·销量面件数已静默计入 revenue 计 0·渠道待运营侧 Seller Central 认领);连带新立 P2-3(#116 海湾 Amazon-FBA 库存盲区:SA 4,683+AE 2,923 全 FBA 而库存面零覆盖,采集 spec 市场清单查因)+P3-11(#117 欧洲区 MCF 订单漏收:≥5 笔 S02- 仅结算费用行 EUR×4/GBP×1,订单侧零采集)挂账


9.102 2026-10-31 R4 审计修复批(audit-aa round4 全栈审计报告 P3×4+P4×2 → 用户令「通知zipforcehub修复」→ 六条全处置) ✅P3-1 尺子锚格式:DASH-024 行 reg:id45,id46,id47,id48 逗号串(正则 reg:id([\d,]+) 遇字母 i 截断、只机绑 id45)改四独立 token reg:id45 reg:id46 reg:id47 reg:id48;R3 双向恒等要求双侧同步——metric_calibers id46/47/48 audit_base_ref 补挂 AC-EL-DASH-024(id46=AC-CAL-24,AC-EL-DASH-024,AC-EL-DASH-028;id47=AC-CAL-25,AC-EL-DASH-024,AC-EL-DASH-028;id48=AC-CAL-26,AC-EL-DASH-024,AC-EL-DASH-027,AC-EL-DASH-028);页内 .dwmark 水印由 compare.caliber 动态串接(纯展示非机绑)——尺子已并写双形态说明,页面零改动零部署 ✅P3-2 三端点补登:GET /api/inventory/matrix(inventory_po.py:193·10-28 供应链舱③带重构整卡漏登——§11 新条目 AC-EL-INV-058+§12 新行+endpoint_registry 行三层齐补,all/api/get);POST /api/ops/dlq/retry + POST /api/ops/dlq/drop(backfill.py:227/:253·§12 已有行锚 AC-EL-BKF-032/033——仅 DB 补登,zipforce/write/post) ✅P3-3 溯源核正:/api/metric-thresholds registered_at=2026-10-23 06:09 系初始播种时刻(tools/_seed_endpoint_registry_20261023.py live OpenAPI 枚举批量入册),端点 git 实证先于 10-23 在码;9.83(10-29)=注册表驱动化(id42 判定线批)时点非端点出生——note 溯源核正落 DB、日期不改(registered_at 语义=入册时刻属实) ✅P3-4 破案·不改数据:US −147/IT −40「净减」=9.84 台账基线失真非数据流失。证据链:①写路径实证 fg_finances.py 品牌薄壳→amz_finances_core.run_flow(conflict_cols=None)=INSERT ON CONFLICT DO NOTHING 纯追加,全链无 UPDATE/DELETE(唯一重盖者 /tmp/fg_country_repair.py 10-29 02:16 终结后无后来者);②fetched_at 考古:修复时刻桶重建 US=9,319/IT=5,738,现值 9,332/5,749=修复后日增 +13/+11——零行离桶;③9.84「修后分布」US 9,479/IT 5,789 虚高 +160/+51(疑引自修复脚本 DRY 投影 line 72 非终态分布 line 117;旁证=该表 8 市场合计 56,549 vs named 全市场 62,394 差 5,845=未列市场);④新市场 NL/BE/SE/PL/IE/MX 5,573 行=#60A 340d 深窗回补(fetched_at=10-29 单日大部队 BE 722/NL 1,052/SE 506;NL min posted_date=2025-11-24 恰 340 天回溯)。修正基线以本条为准,9.84 原文依只增原则不动 ✅P4-1 撤权落地:REVOKE SELECT ON audit.cleaned_keepa_daily FROM portal_app 已执行(saas_registry 库),撤后 grants=mcp_read SELECT + saas_admin 全权(预期保留);api 代码 grep 零消费者实证在前=无运行时影响;封死未来直读绕 watch 域(池含他租关注 ASIN 元数据·AC-SEC-16 语义) ✅P4-2 销案(2026-11-11 9.233):原⏸挂账缓办(audit-aa 裁量·材质可忽略)——finance.py:578 / dashboard.py:2762 sum(abs(payouts)) 把 onno 2026-03/04 双市场 4 行 balanceTransfer 划转(SAR 168.43/AED 165.13·bank=0)计入打款量级;id49 后续若将「打款面=bank_transfer」语义写入 filters,两消费端同步换列时一并销项 → 已落地: 语义入 id49 filters+消费端实为四处换列(非两处)+sync_source 派生尾列位互反同批校正, 见 9.233 ✅验收:ruler_recon 13 门 PASS(尺子条目 2785→2786[AC-EL-INV-058]·带锚 58·§12 行 401→402·R1/R3 id46/47/48↔AC-EL-DASH-024 新恒等双向成立);本批纯尺子+DB 权面,零容器重建零部署;对平闭账:audit-aa 六条逐项复验全过(P3-1 双侧亲读/P3-2 DB 334→337/P3-3 播种脚本实体在/P3-4 释疑采纳——「净减」系终态对比 DRY 投影数的假差/P4-1 grant 撤净/P4-2 如裁)+13 门独立终跑 PASS·双方销项 2026-10-31


9.101 2026-10-30 治理链登记收口(用户问「现在修改了这么多公式和页面,都记录到口径注册表了吗?都记录到audit-base了吗?」→ 盘点+补缺) ✅盘点:大盘总指令四批已全登记(audit-base §11.41 AC-EL-DASH-001~028 + metric_calibers id45~48,9.94~9.98 各批当时已入);Noon 对账单线 9.99/9.100 已入台账但 metric_calibers/audit-base 两库缺——本条补齐;财务舱 v3(#61-68)未开工无需预登记 ✅实施:metric_calibers id49 noon_statement_official v2(权威源=noon-payments soa_v2/get_combined 顶层 totals 层→soa_monthly→statement_official→SaaS audit.cleaned_noon_statement;v1=contractsSoa[0] 合同层已废;显式 id 插入+序列 setval 重推——历史显式插 id 未推序列的撞号坑);audit-base AC-EL-FIN-037 定义列追加「数据层=SOA totals 全账户层 reg:id49(noon+nooninstant+fbn 合同合并;打款=账户级=银行转账·合同间余额划转不入;覆盖 2024-01 起·2026-10-30 拍板 v2)」 ✅验收:ruler_recon 13 门 PASS(带锚条目 57→58·R1/R3 id49↔AC-EL-FIN-037 双向恒等);registry 48 行含 id49(历史一空号所致计数=48 非异常)


9.100 2026-10-30 Noon 官方对账单 2024 年回补(用户问「noon2025年2月前的数据是不是也要补拉」→ 探针实证该补 · 9.99 修复的连带补全) ✅摸底:业务面(orders/PL/monthly)zipforce 自 2023-12 有数,对账单却只从 2025-01(SOA adapter MONTHS 起点写死)——缺 2024-01~12 共 12 个月官方对账单 ✅探针(只读 POST 不落库):totals 层 2024 全年有数(如 2024-01 SA 期初 11,068.32);2023-11/12 全零=钱包开通 2024-01;2024-12 期末(SA 24,280.62/AE 5,299.0749)与库内 2025-01 期初逐位咬合——衔接预言命中 ✅实施:MONTHS 起点 2025-01→2024-01(+注释 开通月锚)→重拉两品牌各 68 行(34 月×2国)+statement_official 重建→SaaS 定向同步 136 行;zf 68 行零残差零全零行·月月衔接·onno 68 行零残差(51 全零行=开店前月份·与其既有 2025 零行同构无害) ✅验收:verify_finance 76/76 复跑绿·API /api/noon/summary statements 最早月=2024-01·2024-12 SA 行期末 24,280.62/打款-49,762.66=银行转账/余额转账 0·UI 期间选 2024-12 行上屏冒烟 5/5

  • ①写死的时间起点=隐性缺口 —— adapter MONTHS 起点拍脑袋定 2025-01,业务面 2023-12 起有数即缺口 13 个月;修口径类 bug 后须同查「覆盖面」:层选对了没、时间窗全不全。探针(只读)先行定开通月,再扩程重拉,2023-12 全零不扩进去(免造零行)。
  • ②边界咬合=回补正确性的免费验收 —— 回补前库内 2025-01 期初是已知值,探针 2024-12 期末与之逐位相等即为新旧数据无缝的先验证据;回补后 mars 全表恒等式 0 残差复验。

9.99 2026-10-30 Noon 官方对账单 totals 层修复(用户上传核对工作簿两图令「这些是差异,你看一下」→ SOA 采集器取错合同层 · 全史修正) ✅根因实证:用户工作簿(Noon SA+AE 8-10月逐项核对·旧数划改新数+红字「银行转账√但与打款金额不一致」)对比库内 noon_statement——我们存的全是被划掉的旧数;追采集链 noon_soa_pull.py 取 soa_v2/get_combined 的 contractsSoa[0](仅 noon 主合同),而官方对账单=顶层 totals 全账户层(noon+nooninstant+fbn);翻库内 raw jsonb:totals 层与用户修正值 4 个月(2026-08/09×SA/AE)×期初/总费用/打款/期末全部逐位命中,恒等式 closing=opening+net+fees+payouts 6/6 精确闭合 ✅修复(patch adapters/noon_soa_pull.py·备份 .bak-totals-20261030):改取 totals 层+feeTypes 数组转按 feeType 键 dict(statement_official 重建 SQL jsonb 按键取兼容)+docstring 口径更正;重跑 noon-soa-pull 两品牌各 44 月×国 UPSERT+statement_official TRUNCATE 重建;病灶影响=漏 Minutes 销售与仓储费(MSF/LTSF/NSLTSF/丢赔调整)、把合同间内部划转(noon→fbn balanceTransfer)误并进账户级打款——totals 层 balanceTransfer 恒 0=银行转账与打款一致(用户红字问题解) ✅验收:mars 恒等式 88/88 闭合·SaaS 定向同步 ingest_all(tables=['noon_statement']) 88 行·audit.cleaned_noon_statement 与用户修正值逐位一致(SA08=13,097.8/-77,981.40/-44,084.99/16,613.34 等)·verify_finance 76/76 零改动全绿·页面冒烟 20/20(官方对账单表 8/9 月修正值上屏·余额转账列全 0·全史月月衔接 7月期末13,098=8月期初) ✅披露:2026-10 为进行中账期·SOA 日拉随卖家后台逐日变动(用户工作簿 10月费用/期末为其查看时点快照)·月末终版为准;onno 品牌同根因同修(44 行恒等式闭合)

  • ①接口同源双层陷阱 —— soa_v2/get_combined 同一响应含 contractsSoa[](分合同)与 totals(全账户)两层,官方对账单/银行对账口径=totals 层;「与卖家后台逐位一致」的 10-05 实证核在合同层——同一端点的层选择即口径,adapter 落库前须钉死层+留 raw jsonb 供事后翻案(本批靠 raw 复盘免重拉即定罪)。
  • ②用户核对工作簿=最硬验收真值 —— 划掉旧数→新数即数据面 bug 的直接证据链;对真值不对叙事:先逐位复现用户修正值再动采集器,修完全史恒等式+逐位比对双闸。
  • ③定向同步通道 —— mars 修源后 SaaS 侧 ingest_all(tables=['noon_statement']) 单表拉平不动订单域;audit.cleaned_* 是 BASE TABLE 非视图(同步目标即它),finance API 直读该表。

9.88 2026-10-29 XC Noon 净利双表口径对齐(用户问「Noon 2026 全年 累计·分市场 的净利润和资金流水·Money Flow 的净利数据不一样呀」→ 拍板「对齐月度经营总表」) ✅根因双源:MF 广告=PL 月表 ad_cost(2026-02~06 归集全 0·原始层即无值)/采购=全部件×成本 vs 累计表=广告日表×(1+VAT) 含税/有效件×成本——净利差 SA 170,804 SAR/AE 51,264 AED 全额算术闭合 ✅拍板落地:/full noon 换源同 #55b·两表全步骤逐位一致(SA 206,456/AE 136,847)·verify 76/76 零改动·三租户结构核零 JS 错 ✅id44 steps 改源+AC-EL-FIN-029 追记·RULER_RECON 13 门 PASS·10:43–10:52 UTC 部署

  • ①问题与复现 —— 用户发现两表净利不一致;同窗口(今年)复现:SA MF 377,260 vs 累计表 206,456(差 170,804 SAR);分解=广告差 246,514 − 采购差 75,711(AE −74,675+23,409=−51,264 同构);GMV/佣金/尾程/其他平台费/结算净额两表逐分一致 → 窗口差异排除,分歧始于广告步。
  • ②根因(对真值) —— 广告步:MF=Σ PL 月表 ad_cost(noon 官方 PL 报表 SKU 级归集),原始表 noon_sku_pl_monthly 2026-02~06 五个月 ad_cost 全 0.00、07 月 904(SA/AE 同构)——归集缺口在原始采集层非清洗丢弃;累计表=Σ v_noon_ad_spend_daily.spend_local×(1+VAT)(含税实扣·#46/#47 实证系数·全月覆盖)=SA 327,227/AE 97,525。采购步:MF=全部件×成本 416,374;累计表=有效件(件−取消−未妥投−CIR·SA 约 18.1%)×成本 340,663(kpi-wall/#55b 同公式)。差额=无效件成本 75,711。
  • ③拍板与实施 —— AskUserQuestion 三选一(对齐/仅换广告步/保留双口径加警示),用户裁定「对齐月度经营总表」:/api/finance/full noon 段 ⓪新增日表广告查询(与 noon-ops 同表达式同 _NOON_VAT_OUT 系数·net 值留作 vat_est 不含税外加项)①广告步换含税实扣 ②cost_local 换有效件×成本(同 noon-ops CTE 逐句)③行级取整全撤(ad/cost_local 去掉 _r2、PL 聚合八列去 round——先舍入后求和 vs 先求和后显示产生 ±2 级漂移);PL ad_cost 列仍在 SELECT 但已无消费方(换源注明)。前端仅改三处源注 tooltip(广告步/采购步/瀑布口径行——口径内容随拍板更新,链式结构零动)。
  • ④验收 —— 部署后双表全步骤逐位一致:SA 874,347 → −327,227 → 547,119 → −340,663 → 206,456;AE 356,914 → −97,525 → 259,390 → −122,543 → 136,847(与「累计·分市场」聚合行全同·净利差全额消除);verify_finance 76/76 零改动全绿;AC-SEC-07 横向结构核 fittingirls/onno 同页 MF 卡渲染零 JS 错误。
  • ⑤入册 —— metric_calibers id44 steps 的 −广告/−采购 两步改源并注明拍板日;audit-base AC-EL-FIN-029 定义列追记「2026-10-29 拍板改源」(只增不删);RULER_RECON 13 门 PASS。部署 10:43/10:49/10:52 UTC(api×3+web×1·避 19-22 UTC 与整半点档)。nAgg/nSpark/环比 netOf/望远镜 net2_usd 全部消费同二字段,换源全链路一致继承,无第二算式。

9.87 2026-10-29 LXXXIX 财务舱 v3 UI 重设计线开题(用户令「财务页面数据没问题,但是布局,结构,UI不好看呀」+「用nano banana 2.5或者GPT image 2做设计」) ✅契约面锁死:十步口径id43/44+tooltip源注+判定线id42+verify 76钩子全保·纯呈现层工程·样板间亮色版用户拍板 ✅设计线已实施销案(财务舱 v2 2026-10-28 LIVE→9.134·2026-11-04 A 方案三段式规整·合流产出于实改): 原🚧设计阶段:样板间+AI设计稿五版已归档(传统×2+大胆×3·含 nano banana flash 版)·合流与实施未开工(先条目后代码)

  • ①诊断 —— finance/page.tsx 3,199 行零 UI kit 复用、376 处内联样式、~250 硬编码色值、13 张裸表格;四带卡片同权重无层级、chip 长得像按钮、脚注墙、锚点条与筛选 chip 无区分(全页截图 Amazon 7,946px / Noon 11,183px + 代码摸底实证)。全站确认为亮色主题(深色仅侧栏)。
  • ②样板间(亮色拍板) —— 高保真 HTML 样板间:四带决策链保留、锚点条→编号步骤导航(①流水·赚没赚➜②雷达·哪里漏➜③分析·为什么➜④出口·怎么办)、KPI 六格大数字(链值直读零新算·AC-CAL-17)、十步瀑布双呈现(比例分段条:段宽∝金额/流入靛蓝/扣减珊瑚/结余绿 + 台账式十步链‖结余分隔)、健康灯无边框药丸+判定线悬停、口径注脚统一「口径」块;亮/暗双主题一键切换。用户四选一拍板「亮色 · 财务页先行」(暗色=未来令牌切换预留)。归档:可交互样板间(悬停有口径源注) · 亮色截图见下。
  • ③AI 设计稿(Sudorouter 图像模型) —— 用户令图像模型出设计稿:经 sudorouter.ai 中转(new-api 系·109 模型;API key 仅存服务器 root-only /root/.config/sudorouter/key,不入册)。nano banana 系(gemini-2.5/3.x-flash-image)该 key 分组无可用渠道 → 按用户备选方案用 GPT image 2 与 gpt-image-2.5-sunburst 各出一版(1536×1024·同一设计 brief:浅色·侧栏+步骤导航·KPI 六格·十段比例条·三卡雷达·数据质量横带)。两版归档如下,可吸收元素(配色/质感/布局细节)待合流进样板间后再进实施:

GPT image 2 版:

财务舱 v3 设计稿·GPT image 2

gpt-image-2.5-sunburst 版:

财务舱 v3 设计稿·gpt-image-2.5-sunburst

追记(同日):用户反馈前两版「太传统」→ brief 重写为大胆现代方向(深空底 #0B0D14 + 磨砂玻璃卡 backdrop-blur/渐变描边、靛蓝→紫→青主色渐变 #6366F1→#8B5CF6→#22D3EE、36-48px 渐变发光大数字、超大半透明章节序号,Framer/Linear/Vercel 发布页质感;布局骨架与链值同前·零新算)。用户点名 gemini-3-pro-image-preview(nano banana pro)→ 三通道实证均 500「分组 auto 下模型…可用渠道不存在」(OpenAI images 端点 / OpenAI chat 端点 / Gemini 原生 v1beta:generateContent 全测;换客户端 SDK 不影响——系该 key 分组未配渠道,需后台开通/换分组/确认余额)→ 按可用模型用 gpt-image-2 与未试过的 gpt-image-2.5-flare 各出一版大胆稿:

财务舱 v3 设计稿·大胆版 GPT image 2

gpt-image-2.5-flare 大胆版:

财务舱 v3 设计稿·大胆版 gpt-image-2.5-flare

追记2(同日):用户问「gemini-3.1-flash-image 这个也不行吗」→ 补测实证 该模型可用——/v1/images/generations 端点仍 500 无渠道,但 /v1/chat/completions 通道有渠道,返回 markdown data URI 内嵌 base64 图(与 pro-preview 不同,flash 变体在其分组配了 chat 渠道)。nano banana(flash)大胆版出图如下,同一大胆 brief:

财务舱 v3 设计稿·大胆版 nano banana gemini-3.1-flash-image

样板间亮色版(用户已拍板的方向·可交互版):

财务舱 v3 样板间·亮色
  • ④下一步(未开工·计划已批) —— AI 稿元素合流样板间 → audit-base §11.6 受影响 AC-EL-FIN 行改写对齐 v3 形态(先条目后代码·当场 ruler_recon 13 门)→ 新建 finance.css(.fpg 作用域令牌·全局类零改动)+ 四带分带实施(MoneyStrip/ProblemRadar/望远镜/出口带)→ verify_finance 76/76 零改动全绿 → web-only 部署避窗(19-22 UTC/:00/:30)→ 本条目追加实施 pill。
  • ⑤三页 AI 设计稿(0.sys 窗口接手·用户令「你把工作台,财务,广告三个页面都设计一下」+「我叫你用gpt image 2.5设计」) —— 设计语言沿④前 console 假设扩成三页族谱:深空 #0B0D14+玻璃仪表盘+靛紫青渐变+单屏不滚(SpaceX Dragon 驾驶舱×Bloomberg 终端)。gpt-image-2.5-flare 1536×1024 出图三张:工作台=品牌舰队左轨+六KPI发光星座(非等距卡片行)+双平台拆分不并总(Amazon USD ‖ Noon 本币 SA/AE)+底部四图胶片;财务=钱包三态(已结算2,746/在途1,334/僵尸96)+回款时间轴+SKU四象限战场+费率体检(判定线语义:仅ACOS/退货率带✓,中性项无判定)+底部十步台账脊柱·链值原样 4,149→331;广告=ACOS半环仪表 18.2%针+盈亏平衡白刻度24.3%+R24 amber chip「预算花尽才可加预算」+规则引擎建议V4.0工单流(出价1.20→0.95·✓✗✎)+搜索词×月红绿矩阵+否词候选(花费≥$20零销售)+底部活动胶囊带。视觉模型三审:布局全中·中文轻度无糊·三张一致 8.5/10·均读作「未来驾驶舱非传统后台」;已知瑕疵:工作台「舰队」误写「舰旗」、广告热力图格 gutter 偏糊、财务散点轴刻度轻微错位——氛围/布局稿性质,数值与判定语义以 HTML 实施层为准。归档见下三图(sudorouter key 未入册·payload 存 /tmp/payload_*.json 仅 prompt)。

三页 AI 设计稿(gpt-image-2.5-flare·2026-10-29·上→下:工作台/财务/广告):

工作台 v3 AI 设计稿 财务 v3 AI 设计稿 广告 v3 AI 设计稿

追记3(同日·0.sys):用户评三页作战舱稿「太浮夸」→ brief 重写为克制专业暗色(哑光炭底 #121419+1px 细边框+单靛蓝 #5B5BD6 点缀+排版撑层级;去霓虹发光/渐变大数字/玻璃拟态/科幻元素,Linear 暗色质感×Bloomberg 密度)重出三张,布局骨架与数值零改动。视觉模型三审:克制度~90%、布局全中、中文无糊、8~8.5/10,均读作「冷静专业软件·非游戏HUD·非老式后台」;余留瑕疵:财务彩色数字饱和度偏高(理想=白数字、彩色只留语义增量)、工作台金色 8.0% 破坏单点缀纪律、广告选中行蓝边偏热——氛围稿性质,实施层可解。归档见下三图(payload=/tmp/payload_*_restrained.json)。

工作台 v3 AI 设计稿·克制版 财务 v3 AI 设计稿·克制版 广告 v3 AI 设计稿·克制版

追记4(同日·0.sys):用户令「浅色底」+问「这些设计符合运营的逻辑吗」→ ①运营逻辑评审:财务页最顺(十步链=损益账本逻辑本身·钱包三态+T+N 时间线=现金流实况·四象限=推/挖/停/观决策·判定线仅挂注册项 ACOS/退货率);工作台两缺口=六 KPI 无环比(绝对值看不出好坏)+缺「哪里出问题」异常/待办入口;广告页缺预算消耗进度(R24 判据即预算花尽)与新增建议计数。②四缺口补进浅色版重出三张(浅色令牌对齐样板间亮色:冷白 #F8F9FC+白卡+靛蓝 #4F46E5/#EEF0FE 软底):工作台增异常条(新建议/断货预警/待跟进差评/回款异常 chip·计数示意)+六 KPI 环比 delta tag;广告工单头增「新建议 5」badge(计数示意)+胶囊增「今日预算 68%」pacing 条(比例示意)。视觉三审:浅色+克制度达成、布局全中(含新增四件)、中文无糊、8~8.5/10「Linear light/Stripe 质感·非通用后台模板」。余留:财务靛蓝超用(6 处·理想 2-3 处)、工作台净利率 amber 与多色异常条破单点缀纪律——实施层可解。归档见下三图(payload=/tmp/payload_*_light.json)。

工作台 v3 AI 设计稿·浅色版 财务 v3 AI 设计稿·浅色版 广告 v3 AI 设计稿·浅色版

追记5(同日·0.sys):用户再否浅色三张(「不行,还是不行」第三轮)→ 复盘定根因=构图结构性错位(三轮全押「无侧栏·单屏仪表」仪器盘构图,而用户要的是经典管理后台)+AI 生图媒介负债(假数字/糊中文不可根治),配色三轮调参均在治标。用户随后上传 INSPINIA 2.8 完整模板(HTML5_Full_Version.zip)令「学习一下」=方向拍板。v4 起改法:手写真 HTML(模板 bootstrap.min.css+style.css+font-awesome 真驱动,最小资产拷贝至 v4-assets/ 724K;中文像素级清晰;数字用锁定真值;图表用 inline SVG 仿 flot),gpt-image 线退役为灵感参考。首页工作台已出 design-v4-workbench-inspinia-20261029.html:220px 深藏青侧栏(工作台/财务/广告/库存/品牌子菜单)·白顶栏铃铛工单(9=新建议5+断货2+差评1+回款异常1)·灰底 #f3f3f4 白卡 11 张·六 KPI 带 delta·三小图(ACOS 挂 24.3% 红虚线=注册项)·SKU 象限·钱包三态+T+N;Noon 本币行标「不同币种分开看」不合并。playwright 实渲染 QC 8.5/10(INSPINIA 本体语言·无破版·无糊字·图标全载;侧栏占位方块已修)。六 KPI 环比、异常计数、Noon 1,842/2,317 为示意锚点待实施层换真值。待用户验方向→通过则同语言出财务/广告两页。归档见下图。

工作台 v4 真HTML·INSPINIA 语言(playwright 实渲染)

追记6(同日·0.sys):用户对 v4 INSPINIA 忠实复刻评「还是好难看呀」(第四轮否)→ 复盘定根因=骨架对·皮肤旧:INSPINIA 上传的意图是拍板「经典后台骨架」(固定侧栏+白顶栏+灰底白卡+自然滚动),而非它的 2016 Bootstrap-3 皮肤;忠实照搬 2016 皮肤=天然过时,与前三轮 AI 生图媒介负债是两个正交问题。v5 解法=骨架不动·皮肤整体换代 2026 SaaS:系统字体栈(PingFang/雅黑+tabular-nums)·12px 圆角白卡+发丝边框·单靛蓝 #4F46E5 点缀·自托管 ECharts 5.5.1(领星/积加系国产 ERP 熟悉的图表语言)+bootstrap-icons 细线图标(v5-assets 1.3M)·深板岩 #101828 侧栏为默认、右上角按钮可切浅色侧栏(最大二元口味分歧做成页内自切)。工作台已出 design-v5-workbench-modern-20261029.html:内容骨架与 v4 同(六 KPI 带环比·营收趋势面积图·ACOS 线挂 24.3% 红虚线注册项·订单柱·SKU 象限推/挖/停/观·钱包三态+T+N·双平台 Noon 本币不合并),数值锚点不变。playwright 实渲染+视觉模型 QC:现代感 9/10·整体 8.5/10·无破版无糊字无缺图标·三图全绘·读作 2026 SaaS 非 2016 后台;余留 nit=六 KPI 等宽略密/图表 hover 层待实施层。待用户验方向→通过则同语言出财务/广告两页。归档见下图。

工作台 v5 真HTML·INSPINIA 骨架+现代 SaaS 皮肤(playwright 实渲染)

9.86 2026-10-29 LXXXVIII 资金流水瀑布十步重构(用户令「GMV 佣金 尾程 广告 采购 vat(vat无值可以是0)都要加到瀑布」) ✅双侧十步全链:Amazon GMV(净收款)→−佣金→−尾程→−促销及其他→−VAT→结算净额→−广告→毛利→−采购→净利润·Noon同构(−VAT 0) ✅API零改动(字段已全在matrix/noon载荷)·#55b链数值逐分不变·verify 75→76/76全绿·05:47 UTC部署 ✅口径入册id43(amazon)/id44(noon)+AC-CAL-22·id42 R1/R3连带修复·RULER_RECON 13门全PASS(registry 41→43行)

  • ①Amazon 十步 —— 平台费一步拆四:−佣金=Σorder_fees.commission、−尾程=Σorder_fees.fba、−VAT=Σorder_fees.vat(无值=0·用户令)、−促销及其他=平台费−佣金−尾程−VAT 余额项(promo/other 明细可 hover);五步相加恒等旧「平台费」一步,结算净额/毛利/净利润逐分不变(#55b 链零漂移)。
  • ②Noon 十步 —— −佣金/−尾程=PL 月表 commission/delivery_fee 列(存量负值·聚合端 abs)、−其他平台费=GMV−佣金−尾程−结算净额 差额闭合项(含其他订单费/非订单费/补贴/credits/noon 未列项·与 9.85①残差实证同源)、−VAT 0:noon 无官方 VAT 列、税已内嵌含税费用列不重复扣(vat_est 法率推算仅见 VAT 并列卡·AC-CAL-17 不入链);结算净额仍=官方 settlement 列原值非派生。
  • ③验收 —— verify 75→76/76(双侧十步结构+拆步源注+十步 tooltip 齐 断言升级);链值双市场机检闭合(SA 3,004,459−692,565−409,548−10,987−0=1,891,359 ✓ / AE 989,144−154,653−118,349−30,763−0=685,379 ✓);截图复核 .flowbar flex-wrap 十步两行换行零裁剪。05:47 UTC 部署。
  • ④追记:口径注册表入册(用户问「需要加入口径注册表的,加进去了吗」)—— metric_calibers 新增 id43 moneyflow_waterfall/amazon(锚 AC-EL-FIN-015;filters=全链+逐步源+不变量「拆步恒等旧平台费·十步代数和=首值」)与 id44 moneyflow_waterfall/noon(锚 AC-EL-FIN-029;差额闭合项/VAT 恒 0 展示/#56 同市场同币求和 全量入 filters);尺子同步:AC-EL-FIN-015/029 改写为十步现态(纯标准库可改写·ID 永不复用)、新立 AC-CAL-22 财务舱判定线口径条目。连带修复:id42(10-28 判定线批)audit_base_ref 误写自由文本,R1+R3 自该批起连夜红(每晚 19:10 recon 在报)——本批 UPDATE 指正 AC-CAL-22 并锚闭环。RULER_RECON 13 门全 PASS(registry 41→43 行·带锚 43·§1-§10 漏锚 0)。教训:注册表插行当场必跑 ruler_recon(R1 的 audit_base_ref 分量必须是尺子真实条目 ID,且 §11 锚行 ID 须裸写无 <code> 壳)。

9.85 2026-10-29 LXXXVII 资金流水瀑布逐块口径说明(用户令「每个block都加个口径说明」·结算净额释义落地) ✅Amazon七步+Noon五步+GMV/订单头全部挂title·只述既有口径零新公式(AC-CAL-17) ✅settlement=官方列实证(全费用列重构残差≈2.8k SAR对不齐=非派生)·verify 69→75/75全绿

  • ①结算净额释义(数据背书) —— Noon 侧=Σ audit.cleaned_noon_sku_pl_monthly.settlement(本币原值):noon 扣完平台侧费用(佣金/履约/非订单费等)后结算给卖家的金额,未扣广告与采购(瀑布后段单扣)。实证其官方列身份:gmv−佣金−履约−其余全部费用列重构 2026-10 SA 得 59,661 vs settlement 56,883,残差≈2.8k SAR(noon 未列项)→非我方派生。Amazon 侧=净收款−(佣金+FBA履约+促销+其他+VAT),order_fees 源表直读(full 接口现场交叉汇总)。
  • ②tooltip 覆盖 —— Noon:GMV/订单头(PL 月表 gmv/orders 原值·#56)、结算净额、广告(ad_cost SKU级归集)、毛利=结算净额−广告(#55b)、采购(cost_local=sku_mapping 采购价×钉住汇率·覆盖前豁免注)、净利;Amazon:净收款(Σrevenue_usd)、平台费=净收款−结算净额、结算净额、广告(v_amz_ad_spend_daily)、毛利、采购(件数×sku_mapping.cost_rmb 回退采购表·RMB→USD)、净利润(头程恒0)。COGS 缺行占位块原 tooltip 保留。
  • ③验收 —— verify_finance 69→75/75(新增6断言:amz 七步 tooltip 齐+order_fees 源注+显性瀑布口径行、noon 五步+GMV头齐+settlement 源注+显性瀑布口径行);数字零变动(纯 title 属性与 foot 注脚附加,页面数值与 9.83 版逐项一致)。
  • ④追补:显性口径行(用户问「为什么没有口径说明」) —— tooltip 系 hover 隐性,不悬停即不可见,触屏设备恒不显;同批于两侧卡片 foot 各加一条可见「瀑布口径」注脚(与「环比口径/净利口径边界」同款样式):Amazon=净收款−平台费=结算净额 · 结算净额−广告=毛利 · 毛利−采购=净利润(#55b);Noon=结算净额=noon官方PL settlement列 + 同链 + #56 求和注;foot 行自身 title 带全来源明细。05:31 UTC 部署。

9.84 2026-10-29 LXXXVI P2① 修复:fg 财务事件国家归因一一对应(拍板「所以国家要一一对应」)——根修+历史重盖+旧索引摘除+当日备份还原 ✅raw 161,477 行重盖(错章22,483/回填27,616/诚实NULL 99,083)·名行不符=0 ✅SaaS 金额零漂移:服务费五个月账与物化层逐分对齐·verify 69/69+e2e ALL PASS ✅冒烟13循环同批事件=P2活证据·新行282条国+id全真

① 根修(采集器):amz_finances_core 新增 MP_NAME(19 市场+9 Non-Amazon,源=zf_amazon.py MARKETS+fg_amazon.json 两凭证文件,零发明值)+ mp_attr();all_events 分支盖章改从事件自身 MarketplaceName 一一对应,事件无市场名(ServiceFee 等账户级,实测 9.9 万行)→ country/marketplace_id 两列 NULL 不虚构;region_key(拉取区域 token)=事实保持。zf 分支(Shipment-only)不动。

② 历史一次性修复(/tmp/fg_country_repair.py,worker stdin 执行):raw 161,477 行三步——marketplace_name 空列回填真名 27,616(旧写入器时代真名在 event_data);country/marketplace_id 按真名重盖(错章修正 22,483:Amazon.fr→GB 5,704、Amazon.es→GB 4,164、Amazon.ca→US 3,622 等;无名行 99,083 置 NULL);五派生表 TRUNCATE + fg_derive lookback 99999 全量重建。修后分布 FR 11,200/US 9,479/AU 9,295/ES 7,754/CA 6,421/IT 5,789/DE 4,383/GB 2,228。验证:名行国别不符=0·名行国NULL=0·无名行被盖国=0。

③ 索引拍板(用户选「摘除两条旧索引」):partial 唯一索引 faf_uniq_refund2/faf_uniq_shipment2(键=order+event_type+posted_date+marketplace_id)系虚构章时代去重产物,与一一对应拍板直接矛盾——真 id 重盖时同事件多品项历史行(1,024 组/2,117 行,958 组 SKU 各异)撞键。摘除后 uqg_fg_finances(order+type+date+md5(event_data) 内容哈希)继续任去重闸;零行增删、SaaS 金额分毫不动;可随时 CREATE INDEX 原样重建。

④ 执行事故与还原(诚实记录):重建时 TRUNCATE 误清「现行采集器造不出来的旧时代行」——fg service_fees 的 12,718 行 fee_month 遗产(SaaS _FIN_BRANCH/_SVC_BRANCH 消费面只认 fee_month 行)。且 fg_derive 实际会写 fee_month(此前把空串误读为 NULL),重建行与遗产行同事件不同键(region 章不同)零冲突叠加 → 服务费月账虚翻倍(2026-05 -26,782.97 vs 真值 -13,187.39)。还原:从当晨 03:30 例行全库备份(TRUNCATE 前 21 分钟)抽回五表 pre-truncate 原貌(scratch 库→fg_bak schema→ON CONFLICT DO NOTHING 合并),service_fees 删 7,515 重建行恢复逐字节原状——五个月账(-13,187.39/-3,527.10/-4,307.19/-16,902.13/-8,979.62)与 SaaS 物化层逐分对齐;refunds 保留重建态 6,167 行全真章(较修复前 +586 = 340 天深回填的派生滞后追平);adjustments/debt_recovery/removals 在 sync_source 零消费端(双版本留档无害)。全程避开 04:30 日档完成。

⑤ 验证:冒烟 run.py fg-finances --days 3——13 个市场循环拿到几乎同一批事件(US/CA/MX 各 45 条同值、十市场各 209 同值)=「listFinancialEvents 不按 MarketplaceId 过滤」的生产活证据;uqg 去重后 282 行新事件国别+id 100% 事件真值、0 错。SaaS 面:verify_finance 69/69、全站 e2e ALL PASS(含 fg 面、零 ≥400 API)——页面数字与修复前完全一致,只有归因真值变了。


9.83 2026-10-29 LXXXV 「都拍板同意」六项批(#56-60)+SA 净利覆盖前豁免 ✅六项全LIVE(00:23 UTC部署)·判定线id42入册·盈亏平衡ACOS·单位经济派生行·僵尸线终版 ✅深窗回补 zf 730d=13,577行+fg 340d=161,193行/0err·fg找回843单 ✅SA净利恢复329,182 SAR·verify 68→69/45/18/230 全绿

①⑤ 判定线(registry id42):metric_calibers 新增阈值 net_margin_healthy=15 / refund_rate_watch=20 / refund_rate_alert=30(注册表驱动,API /api/metric-thresholds 下发,页面 chips 净利率/退货率挂灯)。④ 占比%:解剖卡各步补「占营收/占GMV」muted 注(原值主显,派生只注不算)。盈亏平衡 ACOS chip 入列。#59 单位经济:解剖卡「单位经济(派生)」行,单均 GMV/单均净利等明示派生。芯片实测:zf 净利率 40.8%、ACOS 22.8% vs 盈亏平衡 47.5%、退货率 2.7%。

#60A 深窗回补:SP-API financialEvents 硬约束探针实证窗口≤180天+保留730天;一次性分段脚本(175 天段)zf 730d=13,577 行 + fg 340d=161,193 行 0 错(SP-API 限流 ~1 req/s×13 市场,历时约 2h 属接口节流非流程低效);回补后 ingest_all(full_orders=True, tables=['amazon_orders']) 固化 43,487 单。#60B 僵尸线:settlement_tracker _CUT=GREATEST(品牌财务基准, now()-730天) 滑动;终版数字:zf 待回款 228/$1.1k+僵尸 600/$12.6k(基准 2024-08-25);fg 待回款 1115→630/$11.7k+僵尸 1955→1597/$18.7k(回补找回 843 单,基准提前到 2025-11-11);onno 184/$7.2k+僵尸 0(权责基准差 by design,P2-14)。

SA 净利修复(拍板「覆盖前豁免」):用户问「沙特 资金流水 净利 — · COGS 缺 1 行 什么情况」并指出「mapping table因该没有遗漏呀」——查实 mapping 无遗漏,根因=zf 2023-12 SA 残行(1 单/GMV 0)早于 sku_status 覆盖起点 2024-01 → _nc is None → cost_missing 扣住整市场净利。修法=finance.py ncost 旁加 ncov(品牌×市场 min(mon)),覆盖前月份 cost_missing=False 且 COGS=0;无任何 status 的市场不豁免(防整市虚增);payload 新增 noon_cost_cov,页脚注「COGS 快照起点 · 起点前月份净利不含采购成本」。SA 净利恢复 329,182 SAR。

④ 部署与验收:00:23 UTC(六项)+01:25 UTC(SA 豁免)双次部署,避开 19-22 UTC 窗与整/半点档;四套验收 verify_finance 68→69(新增 SA 豁免三断言)/verify_inventory 45/check_fg_onno 18/frontend_e2e 230 全 PASS(首跑 1 FAIL=noon/summary 渲染竞态 flake,直查四条件全过+复跑全绿)。回滚锚点与快照在册。


9.82 2026-10-27 LXXXIV 拍板:第一铁律——租户隔离无条件最高优先(AC-SEC-16)+9.81⑦ 代卖库存可见性裁定 ✅AC-SEC-16 入册·§6 登记处 07~16·id41 裁记(迁移159·账本167=目录167) ✅维持保密现状·双登记与豁免两案否决·零代码改动·RULER_RECON 全绿

① 拍板原文与语义:用户「租户是最高优先级,不管什么情况租户之间的数据都是隔离且不可见的,即使品牌一样,sku 一样,产品名称一样,产品型号一样,也是不可见的。这是第一铁律」→ 立规 AC-SEC-16:(a) 租户维度为全部铁律中最高优先级,与其他任何规则(含 AC-SEC-15 的可见性推论)冲突时跨租户不可见性一律胜出;(b) 不可见性无条件——品牌/SKU/品名/型号全同都不构成可见理由,不存在按内容相似开可见的路径;(c) 归属≠可见:AC-SEC-15 定行的属主(brand 列),本条定租户眼里的可见集,两层正交叠加。

② 9.81⑦ 三选一裁定:维持保密现状——迁移 101 注册表 SKU 保密条款(仅外域注册 SKU 集合)胜出:zf 账号代卖的 onno 货 10 行(如 ON3720SEU/EU 136 件)租户面对双方均不可见(zf 被 SKU 保密挡=9.81⑥c 实测 zf 视图 ON*=0;onno 被品牌域挡),仅管理面/门禁信息位可见。SKU 双登记开可见(P2-32 口径维持=双租户重复登记为异常)与 consign_schema 可见性豁免两案否决。零代码改动——现行 RLS 双层执法(brand∈tenant_brands × registry_sku_visibility)即本条语义,9.81⑤ RLS 模拟跨租户可见=0 已实测在案。

③ 立规入尺:audit-base §6 新增 AC-SEC-16 条(reg:—,同 §6 铁律 07~14 惯例)+登记处全集 07~14→07~16;AC-SEC-15 行内追加「可见性裁定」注(归属≠可见,代卖货仅外域注册 SKU 时双方租户面均不可见);id41 filters 补 visibility_first_iron_rule 裁记(迁移 159,纯增键幂等)。registry 仍 40 行(零新行——本条为可见性原则非数据口径)。

④ 工程注记(过程留痕):迁移 158 先前系活库直跑未入账本,本批补登记(sha256 锁定单行 INSERT,不用 --register-existing 防把未应用的 159 一并误标)后 159 经 tools/migrate.py 单跑落账,账本 167=目录 167。R3 首跑 FAIL——AC-SEC-16 误挂 reg:id41 致双向锚不恒等(注册表 ref=AC-SEC-15 vs 锚两张),改 reg:— 后 RULER_RECON PASS(尺子条目 2749·带锚 40·R1-R13 违约 0)。

⑤ 快照:backups/audit-base-post-982-20261027.tgz(含 AC-SEC-16+15 裁注,sha256 在档)。


9.81 2026-10-27 LXXXIII 拍板:库存账户归属铁律(AC-SEC-15)——库存行 brand=持有卖家账号的租户,全租户×全平台×全代码路径 ✅AC-SEC-15·id41 入册·id30 范围澄清·registry 39→40行 ✅sync 属主字面量+clean 双文件去 brand_fix·幽灵清扫11·onno 租户 EU 15→0·RULER_RECON 全绿 ✅⑦三选一裁定=维持保密现状(AC-SEC-16 第一铁律)销案(9.82·2026-10-27): 原✗挂账:代卖库存行租户面双向不可见(⑦待拍板)

① 动因与拍板:onno 租户库存页出现 EU 库存——zf 卖家账号代卖的 onno 货被 sync 视图分支 SELECT m.brand 按 sku_mapping 品牌盖写成 onno。用户拍板「所有库存都是属于租户的」+「不仅仅 onno,是所有的租户,所有的代码都要按照这个逻辑……不是针对某个租户改」→ 立规 AC-SEC-15 库存账户归属:库存行 brand 恒=持有卖家账号的租户;品牌归集(brand_fix/id30=AC-CAL-11)范围澄清=仅收入/订单面,库存面一律禁用。旧口径的结构缺陷:zf 视图分支与 onno fba 分支同写中央键 (onno,SKU,UK),两账号数量互相覆盖。

② 渗透点普查与结构修复(零租户名硬编码):全量普查恰两处渗透——sync_source._inv_health_sql 视图分支(m.brand 盖属主)+clean 层 inventory_health spec 的 brand_fix;其余库存面(noon_inventory/amazon_inventory_aging/noon_sku_unsaleable/noon_sku_status)本就账号域。修复:视图分支改属主字面量 '{vb}'::text AS brand、inv_views 改(属主品牌,视图名)对+同名视图去重(视图即账号属主唯一);fba 分支账号 schema 「{b}」字面量不变;api/clean_audit.py+tools/audit_clean_all.py 两文件库存面 spec 去 brand_fix(收入面 brand_fix 全部不动)。未来任何代卖对自动正确——键天然分离(zf,SKU,EU)vs(onno,SKU,US)。

③ 立规入尺:迁移 158——id30 filters 补 scope 注记(仅收入/订单面)+id41 inventory_owner/all/AC-SEC-15/v1(authoritative_source=属主字面量两分支语义;fallback_source='' 避 id38 烧号;filters 全量含五库存面/代码守卫/代卖语义/幽灵清扫/gate);audit-base AC-SEC-15 条(用户原话入册)+AC-SEC-09 追加范围澄清(品牌归并口径仅收入/订单面);registry 40 行·带锚 40/40。

④ 部署与数据面自愈:10:30:43 build api+worker+up -d(撞 :30 collection_noon_orders 档——半点增量档被换容器杀掉一轮,11:30 整点档自愈,坑24 注记在案);spec 渲染容器实证(视图分支 'zipforce'::text AS brand,m.brand×0);手动 ingest_today 全量轮 8,978 行·reconcile 0 差异;synced_at 幽灵清扫 DELETE 11=onno EU/UK 旧盖写残留 10+fittingirls/ZF565T0EUY/EU 2026-10-10 远古幽灵 1(证明此类残留早于本批非本批引入;判据=整轮快照同刻 now(),陈旧即映射时代残留键,零租户名);clean 层原子 swap 全量重建自愈;cleaned 口径三租户实测:onno=AE/AU/SA/US×5(20 行)、zf 账号代卖 onno 货=EU5+UK5、fg 无越界。

⑤ 门禁与验证:ruler_recon 新增 R13 库存账户归属核——代码面(双文件五库存面 spec 出现 brand_fix 键=FAIL,键名冒号正则防注释误报)+数据面(onno 越界市场行≠0=FAIL;zf 代卖行为信息位不计违约);R13 自咬测试双向通过(旧 spec 判违/新文件零误报)。RULER_RECON PASS(R13: onno 越界 0·zf 代卖 10 信息)。租户 RLS 实证(portal_app+app.tenant_id 模拟):onno 租户恰 20 行·市场 AE/AU/SA/US·EU/UK 归零(原始投诉闭环,改前 15 行越界);MCP inventory_status onno/amazon 同口径 20 行。

⑥ 见证集修正与三定谳(诚实记录):(a) R13 首版合法市场集误设 MENA-only——注册表实证 onno 自有市场=AU/SA/AE/US(US/AU 自有库存真实,ONQ2001US qty=102),改注册表派生合法集;(b) 源镜像假说撤回——源表 onno 账号 schema 库存从来只有 AU/GB/US 国家行,EU/UK 中央行系旧代码 10:05 轮幽灵,「同量双行」实为同一物理行的 新属主行+旧幽灵;(c) MCP zf+ON3720SEU=0 之谜定谳——非 stale 连接,系 101-rls-registry-visibility(2026-10-14)注册表 SKU 保密条款:ON SKU 仅 onno 登记(仅外域注册),zf 租户 RLS 视图按既有信息隔离铁律挡之(zf 挡 32 个 ON SKU·1,146 行禁看集)——属既有租户隔离机制正确执法,非归属缺陷。

⑦ 挂账(口径冲突待拍板,不阻塞):zf 账号代卖库存 10 行(如 ON3720SEU/EU qty=136)现租户面双向不可见——zf 租户被注册表 SKU 保密条款挡(⑥c),onno 租户被品牌条款挡(行属 zipforce);仅管理面/门禁信息位可见。AC-SEC-15(库存属账户租户→zf 应见自家账号库存)vs 101 注册表保密(仅外域注册 SKU 不可见)两规在代卖对上构造性相撞。三选一待拍板:维持现状(保密优先)/代卖对 SKU 双登记入 sku_mapping(P2-32 曾判双租户重复为异常,需立规豁免)/按 brands_source.consign_schema 声明开可见性豁免。

⑧ 快照与实证:audit-base 改后快照 backups/audit-base-post-981-20261027.tgz(sha256 在档);四变更文件 py_compile 绿+容器 spec 渲染实证;部署前未另拍代码快照(变更同时保留在 git 工作树未提交改动面,可对快照逐字核——9.79⑤同例常态)。


9.80 2026-10-27 LXXXII 拍板:ranking 数据 API-only+star_pct 无源自采线废止+无 API 国家持续报警 ✅拍板落地·03:43 cron 移除·adapter star_pct 剥离(.bak-nostar-20261027) ✅id40 入册·AC-CAL-21·reg:id40 双向锚·registry 38→39行 ✅持续报警扩面·UAE/KSA 并入无站集·star_pct 三品牌每轮必报·容器实测 9 行

① 拍板与废止:用户「ranking 数据不要自采,全部要走 API」+「没有 API 的国家持续报警就好」。star_pct 星级分布五元组全市场无 API 源(Keepa 官方 11 站均不提供直方图数据)→ rankings_daily.star_pct 恒 NULL(页面缺失显 None/hasStars=False,不派生不估算)。9.58 直方图自采线(crawlbase dp 页窗口法+sum∈{99,100,101} 闸)同日废止:tasks.py 03:43 arq cron 移除+amz_reviews_crawl.py star_pct 回写剥离(备份 .bak-nostar-20261027;product_reviews 评论通路属 10-07 指定面、非 ranking 数据,保留挂起)。首夜调度超时(3600s 被杀,1 小时仅写成 1 行;彼时 star_pct 非空 4/12,016)随废止不再现。

② 立规入尺:迁移 157(metric_calibers id40 star_pct/amazon/AC-CAL-21/v1;fallback_source='' 避 id38 空号教训,实际 id=40 无烧号);audit-base AC-CAL-21 条目(disposition/alarm/history_policy/banned_channel 四要素);RULER_RECON 全绿(registry 39 行·带锚 39/39·R1-R12 违约 0·尺子 2747)。历史不回改:≤09-29 一代(评论页百分比)冻结值保留;10-26~27 二代(直方图)4 行保留为史。

③ 无 API 国家持续报警扩面:KEEPA_NO_SITE_MARKETS {AU,NL}→{AU,NL,UAE,KSA}(amazon.ae/.sa 同不在官方 11 站,此前 COUNTRY_MARKETS 空集静默 skipped);star_pct 三品牌 market=ALL 每轮必报。容器实测 rankings_market_rows 9 行:fg/AU 219+onno/AU 5、zf/UAE·KSA 各 29、onno/UAE·KSA 各 5、star_pct×3。Keepa 未来上线对应站点时四处同步(keepa_client.py 注记在案)。

④ 覆盖定谳(问答存档):Amazon=Keepa API 实采 9 市场(US 2126/CA 3659/JP 90/BR 109+EU 展开 GB 645/DE 1213/FR 1249/IT 622/ES 1263 行,全活 10-27);IN/MX 有站无登记不采(无需求非缺口);Noon=noon API AE/SA 各 200 行活 10-27(id39 口径);UK 640 行止 10-09=GB 归一前历史残留(活键 GB)。

⑤ 部署与验证:07:31 UTC build api+worker+up -d(窗口内);worker 镜像 star_crawl 零残留、api 镜像 4 元集+报警文案在位;audit-base 快照 backups/audit-base-pre-980-20261027.tgz;py_compile 四文件绿。

9.79 2026-10-27 LXXXI 「全批」三件:§11.2 noon 财务六图表键补行+noon 评分/评论口径入册(AC-CAL-20)+id28 两 tier 补记与勾稽门边界声明 ✅迁移156·registry 37→38行·reg:id39 双向锚·本批锚面零违 ✅noon 墙↔册 28/28·amazon 80/80 双向零差·21门无新红

① §11.2 图表墙六键补行(N23–N28):peer 挂账坐实——noon 财务六图(nAdSpend 月度广告花费/nAdSales 月度广告销售/nAdRate 月度 TACOS/nCumGmv 累计营收/nProfitTrend 月度利润走势/nRefundTrend 月度退款)live 在墙而册缺。六键 live spec 经登录态直拉 /api/dashboard/charts?platform=noon 逐字核录(title/hint/kind 原文照录,含「广告花费 ÷ 营收 %」「折 USD · 结算净额 − 广告花费」),行构与 N20–N22 同模;§11.2 标题后加小注记补行缘由。验证=charts 响应↔表双向机器比对:noon 28/28 零差(六新行逐字相等)、amazon 80/80 回归不变(A17/A66/A76 为在册既有记法:HTML 转义/f-string 动态 hint 模板,非新差);两墙合计 live 108 键=表 108 行,无孤儿无缺行。

② noon 评分/评论数口径入册(迁移 156·id39·AC-CAL-20):2026-10-24 拍板(9.36)迄今册内缺行,本批补注册——metric=noon_rating_reviews/platform=noon;authoritative_source=noon-reputation product-reviews/list 目录级端点(评分=avgProductRating、评论数=totalCount、名称=productTitle,AE/SA 逐字段同值无国家拆分)+链路 {schema}_rankings→rankings_daily(_RNK_NOON)→audit.cleaned;filters 全量入册(markets AE/SA 同值/字段映射/历史不回改·旧口径 6,023 行已物理清·源表起点 10-24/店铺评分恒 NULL 9.33⑤挂账/#148 三集内键预滤);decision_date=2026-10-24;audit_base_ref=AC-CAL-20(新尺行 reg:id39 双向锚,R3 恒等绿)。id38 空号在案:首插 fallback_source 填 NULL 撞非空约束整文件回滚、序列不回滚烧号,修正空串重放落 id39(只增不删记录)。迁移经 tools/migrate.py 落账本(现 164 文件)。

③ id28 ads_staleness 两 tier 补记+勾稽门边界声明:双实现查实(alarm tier=7 天/cleaned 层逐租户 owner 邮件,api/tasks.py ads_staleness_alarm;gate tier=3 天/staging 层更严早哨,recon_gates「Amazon.广告新鲜度」)补记为 id28 filters.tiers+note——两层有意分工非漂移。recon_gates.py 文件头同步口径边界声明:21 门=数据恒等式对账、非展示口径面;门不读 metric_calibers 亦不整体入册(整册入册=把恒等式当口径的层级混淆);唯口径语义关联门=「Amazon.广告新鲜度」↔id28 姊妹层;「六态闭合」等其余门均 staging 列恒等式不另立册行。宿主直跑文件(调度器 subprocess 调宿主路径),无需重建容器。

④ 附带发现挂账(R9 新红,非本批所致,待拍板):ruler_recon 复跑唯一 FAIL=products mapping 外孤儿 7 行——fittingirls 6(USYW003BL2XLB/USYW003BL00LB/USYW003BL00MB/AUYDW003GY00MB/USYW003GY00LB/AUB2402COXXLA)+onno 1(ONY2002US);时间戳=2026-10-26 19:07:21 批量 6 行+10-27 04:30 每日全量拉 1 行,均先于本批迁移(05:33)——即 products 存在 ops.py mapping/edit 级联之外的自动种子写路径(R9 立门前提=唯一写路径恒级联),今晨 08:00 晨检将撞红。处置二选一待拍板:新品登记入 sku_mapping(用户级)或定位并堵/过滤种子写路径(工程级);按铁律(登记品不可动)未擅动。
→ 同日拍板收口(用户令「加到 mapping table 但是格式要一样」,处置=登记):7 行经唯一写路径 ops.py mapping/edit 全量保存登记——fg/Amazon 1100→1106、onno/Amazon 25→26(级联 inv_products +6/+1;products 镜像行已存在 ON CONFLICT 零增,title 将由次日 04:30 同步自愈为 product_name)。格式逐字段对同款已登记兄弟行(ASIN 与 order_items 逐一相符=同 listing 市场前缀变体;UPC/成本携同 ASIN 兄弟行=商品身份非造值);onno ONY2002US 系 #142「表为准重建」上传表未含而被剔的旧登记行,本次=复登记。快照 sku-mapping-pre-r9-register-20261027.dump 先行。复跑 RULER_RECON PASS(R9 孤儿 0/0·缺口 0/0),08:00 晨检不再撞红 ✅已修好(R9 归零)。留存观察项(挂账不阻塞):products 自动种子写路径仍在(sync_source._products_sql 既有设计非缺陷——镜像面 LEFT JOIN 故意不过滤),门禁以「孤儿=0」执法即够。

⑤ 门禁与快照:RULER_RECON R1–R8/R10–R12 违约 0(registry 38 行/带锚条目 38/§1–§10 漏锚 0),R9 见④;recon_gates 21 门 FAIL×3 与既有挂账同集(广告四层金字塔/广告新鲜度 32 天=onno 人工 CSV 未投递/SKU目录覆盖 5473)无新红;audit-base 快照 backups/audit-base-post-979-20261027.tgz(git 工作树自 10-25 首提交后累积各批未提交改动属常态,本批三处编辑纯增,可对快照逐字核)。


9.78 2026-10-27 LXXX onno finances 补键+order_refund 首真跑(P2-9 连带挂账收口)+Decodo onno 出口事故定谳与双 IP 钉死值切换 ✅迁移155补键·run289四腿全活·recon ok=true·gate六门绿 ✅出口事故端口矩阵定谳·onno/zf 钉死值同步切换·三品牌断言绿

① 拍板与补键(迁移 155):2026-10-27 用户拍板「onno finances 缺键,同意补上,跑首真跑」——注册表 brands_source onno|amazon 补顶层 collect.finances="onno-finances"(与 zf/fg 同形纯字符串,只增不动 night 列表)。连带修:backfill.py order_refund 的 derive 步骤映射原只有 zipforce/fittingirls 两家——onno 的 onno-derive 适配器一直存在且夜档(collect.night 20/45 档)在跑,映射缺席则 finances 腿拉完不派生到清洗面,补 "onno": ["onno-derive", str(days)](onno_derive 收可选位置参回看天数,与 fg_derive 同形)。快照 code-20261027-pre-155-onnofin-api.tar.gz→api+worker 重建部署(01:4x UTC 窗),容器实证 _brand_channel('onno','amazon','finances') 由 None→onno-finances。

② 首真跑(run 289):run 288 首发即撞③出口事故(出口铁律第一步拦截,error 留真实记录);代理恢复后 run 289(onno/amazon 2026-10-20~22 dry_run=false,与 zf run 284 同窗同形态)→done:四腿全活=amazon_orders 6108+amazon_refund_monthly 3652+finance_monthly 5268+order_fees 37501,api_calls=2(onno-finances+onno-derive 两步实跑=补键+derive 补挂双生效),P1-4 预象快照 1 份(rows 9),clean_audit=clean-a8b4aad4d26b,勾稽 recon ok=true(2026-10 in-flight 月排除口径,refund_units 24/fees 1188.51/revenue 3593.84 入报);审计两行(backfill.create+backfill.order_refund.done brand=onno)。P2-9 连带挂账(onno 通道缺口+onno 首跑两件)本条销账。

③ Decodo onno 出口事故(同窗插曲·定谳链):2026-10-26 23:02 UTC 起 onno 专用端点 9.249.112.206(Frontier 5650 Ashburn)上游失联,onno Amazon 增量线整体停摆。证据矩阵:账号级无辜(同账号 fg :10001/zf :10003 全 200、三口 TCP 全通);用户名形态无辜(裸/前缀两形态在 10001/10003 均 200 出对 IP);端口扫描 10004-10012 得三连组规律——映射该 IP 的全部 4 口(10002/10005/10008/10011)齐隧道 503、其余 8 口全活=死活按背后专用 IP 划线,面板 active=配置在册非运行健康;充值无效(余额属账号层,与单 IP 失联正交)。恢复=用户面板替换端点:onno→23.26.215.184(原 zf 波士顿 Astound IP)、zf 被顶到新 IP 85.189.220.71(Ashburn Charter AS20115)——出口钉死值双改(config.EXPECTED_IPS+TOPOLOGY.md 同步,worker :ro 挂载面即生效),三品牌容器断言绿(72.245.71.143/23.26.215.184/85.189.220.71)。断档窗 23:02→恢复(~3.5h)由调度器整点档 --hours 24 回访窗自动整窗重拉自愈(03:00 档验证在案),半点档 --hours 1 不补历史属已知语义。

④ 口径注记:迁移 155 可回滚(jsonb_set 移除键即回);run 288 error 行保留=事故窗口真实记录不抹;EXPECTED_IPS 注释含换 IP 全档案(原因/旧值/新值/日期),TOPOLOGY.md 三行随改;gate --quick 六门绿(镜像固化/pen_tests/dashboard_audit/audit_nodes/pipe_audit/chart_value,api-only 变更 web 零改动故 frontend_e2e 按惯例跳过)。

⑤ 时间线后核修正(2026-10-27 04:1x 调度日志全窗复盘,只增不删):③初记「23:02 起失联」修正为间歇性首发 22:00 UTC(22:00/22:30 档 rc=1,23:00 档短暂回光 rc=0 egress 9.249.112.206,00:00 起连败至 02:30,03:00 档新 IP 绿);「整点档自愈(03:00 档验证在案)」修正为每日回访档实际跑在 04:00(`0 4` cron 传 --hours 24;*/30 增量档在整半点也触发故 03:00 所验为 --hours 1 增量非回访),24h 回看窗仍全覆盖断档。另两档失败与事故无关、系当晚部署碰撞(transcript 时戳对合):23:29:22 `up -d api worker` 撞 23:30 档(三品牌+webhook "container not running");00:30:21 全栈 `up -d` 落档起跑后 20s(onno 进程 SIGKILL rc=137、fg 容器已换名,zf 先完成幸存)——教训入坑册坑24(up -d 单独成条+看钟距整半点≥3 分钟+带服务参数),两档损失同在 04:00 回访窗内兜平。自愈数据级实证(04:4x 复查源库):三品牌断档窗(10-26 22:00→10-27 04:00)行全在——onno 1 行(purchase 23:04:20,恰是唯一只有 --hours 24 回访腿能拉回的时间戳=onno 回访腿实跑成功直接证据)、zf 4 行(max 01:19:56)、fg 4 行(max 03:08:10);rc 行因调度日志块缓冲迟落不阻塞定谳。


9.77 2026-10-27 LXXIX 「都同意」拍板执行批③:P2-7 购买制授权二期(站外推广 promotion 独立可购模块) ✅独立模块键单源派生·迁移 154 grandfather 存量零变化·55 端点换门 0 残留·未购 403↔开通 200 往返实证·全量门禁 ALL PASS 含 frontend_e2e

① 拍板链与单源派生设计:2026-10-24 round2 一批② 拍板「谁购买这个服务谁可以用」(购买制授权,设计挂账二期)→ 2026-10-27「都同意」批③ 执行。核心=MODULES(core.py)增 promotion 键(名「站外推广」/页面 /offsitepromotion)一处定义,全部消费面自动派生无第二清单:模块超市 /api/billing/modules 出卡+toggle 自助开通(demo 形态,Stripe 就绪后转 Checkout)、员工授权 /api/team/meta→user_modules、导航锁 AppShell navState mod:"promotion"(未购=锁+开通引导,已购未授权=置灰,与既有六模块同机制)、运营预设 ROLE_PRESETS「运营」追加 promotion;auth.py 注册种子数组不含 promotion=新注册租户默认未购须开通(今日行为变更仅此一处,且新租户此前也不存在)。

② 55 端点换门:promotion_ext.py 全部端点(项目/达人库/渠道/Reddit 专库/分群/邮件任务)Depends(require_module("ads"))→("promotion") 共 55 处全换、grep 实证 55 promotion/0 ads 残留、容器 AST 过;语义切分:站内促销 /api/noon/deals 仍走 ads 门不动(站内广告附面,非站外推广服务)。

③ 迁移 154 grandfather(存量零回归):已开 ads 的存量租户视同已购 promotion——tenant_modules 三租户(1/2/3)seed enabled=true,导航/端点/预设今日行为零变化;新租户无种子=须购买。回滚=DELETE FROM tenant_modules WHERE module_key='promotion' 即回搭车前状态。sha256 台账已登记(tools/migrate.py)。

④ 验收与部署:zf /api/promotion/projects 200+billing 目录 promotion enabled=True;购买语义往返(fg):toggle off → 403 {"module":"promotion","reason":"unpurchased"} → toggle on → 200 复通;onno kol-stats 200;/api/noon/deals 200(ads 门未动回归无损)。快照 code-20261027-pre-p27-promo.tar.gz → api+worker+web 三镜像重建 up -d(避开 19-22 广告档/整半点/夜采槽)→ deploy_gate 全量六门 ALL PASS(镜像固化/pen_tests/dashboard_audit/audit_nodes/pipe_audit/chart_value/frontend_e2e,web 改动故 frontend_e2e 必跑)。round2 10.7.1-A②「设计挂账二期」clause 本条随修随换打绿。


9.76 2026-10-27 LXXVIII 「都同意」拍板执行批②:Noon 广告明细 campaign/sku 级(#141 挂账⑤「待采集层」收口·探针定谳采集不缺+消费面换源) ✅投放分析 noon 明细 10→260 行·24 活动/25 SKU 下拉·对账与总额分毫不差·双租户+月粒度实证·units 结构性无源探针定案

① 探针定谳(采集层不缺——挂账叙事修正):挂账原文(9.73①/round2 #141 挂账⑤)「Noon 明细(campaign/sku 级)待采集层」,本批先以现役通道 API-key 会话(noon_portal_apionly.PortalSession,collection_scheduler 夜档双品牌在跑、源表 {sch}_ads_skus 采到 10-25)直探 admanager 四端点全字段:metrics/campaigns 对象 40+ 键(status/dailyBudget/dailyLimit/effectiveDailyBudget/budgetType/budgetCycle/biddingStrategy/createdAt…,R21-P0 起已每日落 shared.ads_campaign_snapshot 双品牌,10-26 zf 191 行+onno 8 行 state/budget 全非空)、product/metrics/products、product/metrics/queries、metrics/performance 三指标族统一 views/clicks/orders/atc/spends/revenue+派生率(ctr/roas/cpc/cps/cvr)——全族无 units 类字段,结构性定案(orders 是最近概念但件≠单,禁执行层口径发明,units 恒 NULL 显「—」为诚实口径);campaign 元数据面已由快照承载(SaaS 4 文件消费),采集侧无一件缺。

② 真瓶颈=消费面接错源:投放分析 GET /api/ads/placement-rows?platform=noon(routers/ads.py #141)原读 cleaned_noon_ads_daily 聚合面——该面 9 月起 SKU 级被 B5/v5.8 整组遮蔽防双计(与 id=2 总额面两源不可互掺),仅剩 [daily_total] 伪活动行+残行(sp 9 月 2 行/10 月 7 行,源表同窗 1387/1242 行);而 campaign×SKU×日明细权威面 cleaned_noon_ads_sku_attr(caliber id=18「SKU/campaign 维权威源」)健康在库(8月1893/9月1475/10月1282 行,双品牌,22 列含 targeting/query/bid/strategy 族)却无消费方。修复=换源一处:noon 分支改读 id=18 面(keyword=targeting_type/term=query/skus=[sku] 映射保持),[daily_total] 伪活动行随源消亡(前端零处引用该字面量,grep 实证),units=None/双币 _NOON_CUR 口径不变。

③ 验证(验收对真值):部署前 BEFORE 实抓(zf 租户 7 天):total=10 全 [daily_total]、campaigns 下拉=1、SKU 下拉=0;快照 code-20261027-pre-p2b-noon-api.tar.gz→api+worker 重建 up -d(00:30 UTC 窗,避开 19-22 广告档/整半点/夜采槽)→deploy_gate --quick 六门绿(镜像固化/pen_tests/dashboard_audit/audit_nodes/pipe_audit/chart_value)→AFTER:total=260、campaigns 下拉=24、SKU 下拉=25,真活动名×SKU×日行(J80 Auto/Airfit Light+ Auto…)带 ACoS 本币派生;对账:明细 7d sum(spends)=6767.02/orders=244 与 'all' 总额行分毫不差(onno 双侧同=3.06,Ads 暂停面),明细全覆盖无缺口;月粒度 90 天=243 行 37 活动(8-9 月历史连续);onno 租户 30 天=46 行(Dual lense auto 等);amazon 分支回归无损(143 行 units 列照常出)。

④ 口径与余量:明细行本币(AE=AED/SA=SAR)与 amazon 分支站点本币同规;TACoS noon 恒 None(noon_orders 无金额列,挂账不变);SKU 显示名 sku_mapping 直配 sku 列对 noon Z 系 SKU 不中→回退显原 SKU 串(产品模糊筛对 SKU 串生效,诚实降级非阻断);campaign_code 未持久化(快照 raw_json 有 code,name 即键,投放分析显示名语义无需 code)——如后续明细需 code 键再议采集列扩展。9.73①「Noon 明细待采集层」挂账本条销账;⑤挂账行 pills 已含 units 补列绿标,本批补 noon 明细绿标。


9.75 2026-10-27 LXXVII 「都同意」拍板执行批①:onno 镜像表上传通道扩面(9.57③ 收口)+amz-ads-csv bigint 暗雷同批修 ✅同 zip 零新步骤多灌 9 镜像面·散投 CSV/仓储费报告通道·四面 dry-run 全对·真插+幂等复跑+清理实证·bigint 哨兵 0

① 扩面设计(零用户负担):9.57③ 拍板的「14 张空镜像表扩上传通道」——实勘后语义分层:9 张真有 CSV 源语义(ads_campaigns/keywords/search_terms/targeting/purchased_products/sb_campaigns/sd_campaigns/sd_targeting + spapi_storage_fees[Seller Central 月度仓储费报告])+advertised_products(9.57 已纳管,本批并入同 zip 同灌)=10 面入通道;5 张不入选并如实挂账:ads_2025(2025 冻结档,仅 PK id 无自然键、重传必重复=违通道幂等律)、ads_payments(Ads API 账单事件流,后台账单导出样张未见,挂账待真实样张)、ads_optimization_log/ops_settlement_log(内部系统日志非 Amazon 导出)、field_registry(结构注册表)——该 5 张维持 9.57③ 的断供报警+空态透明承载。实现=新适配器 adapters/onno_mirror_csv.py:与 ads_daily 同一 onno_amazon.zip「报表下载」全维度包按表头签名分流(存储费面 FNSKU+月份 / 搜索词 / 投放[全等匹配防「投放广告活动的国家/地区」撞列] / 关键词 / 已购商品 / 推广商品 / SB[品牌新客标记]/SD[可见展示量标记,均避开 SP 报表也有的「展示份额」列] / 活动兜底);中英文后台双别名册+归一化列名直配(英文后台报表列名≈API 列名剥非字母数字后全等);数字 id 缺失 md5int(名称) 48-bit 合成(同名恒同值=幂等);ON CONFLICT 自然唯一键 DO UPDATE 后传覆盖先传;profile_id=0 哨兵与 API 数字 profile(15-16 位)天然隔离。

② 接线与拾取:onno_import_ads_daily.run() 两处接线——zip 解包后镜像面同灌(逐文件事务隔离,任何镜像失败不回滚已提交的 ads_daily;agg 空早退分支也先灌镜像再退=纯仓储费散投场景可达);散投 CSV 拾取:单文件(仓储费报告等非广告后台报表)直接投 dropbox/onno-ads/ 目录,同轮导入导毕归档 done/(无 zip 仅散投不再早退)。调度路径(run.py→adapters.onno_import_ads_daily)与 README 直跑路径双 import 兼容。单文件直导/预演:onno_mirror_csv.py --file <csv|zip> [--dry-run]。

③ amz-ads-csv bigint 暗雷(连带发现同批修):amz_ads_csv 原设计 profile_id='manual'、campaign_id='c-'+md5、ad_group_id='g-'+md5 字符串哨兵——实证于 mercury 表形(2026-09-26 docstring 自述),而 mars 三品牌 ads_advertised_products 该三列均 bigint(zf 3484 行/fg 75069 行全数字 profile 无一 'manual' 行),即该应急补数通道真实 INSERT 必炸、9.57③ 仅做过解析 dry-run 从未真插=未行使暗雷。同批修:哨兵 0/md5int 数值合成,口径与 onno_mirror_csv 单源共用(md5int 定义于 amz_ads_csv,新模块反向导入)。解析层零改动(parse_csv_files 纯解析实测聚合面不变)。

④ 验证:worker 容器 AST 三文件绿;合成中文/英文样张四面 dry-run 全对(campaigns 3 键含空活动编号 md5int 合成路/keywords 1 键/search_terms 2 键含 "Oct 20, 2026" 月名日期/仓储费 2 键 region=AE+fee_month=2026-10);真插微测:4 面实写→行数/id 合成值逐一对上→幂等复跑计数不变→测试行(profile_id=0/B0TEST*)DELETE 清回空表(插毕即验即清,快照/审计注记口径同 P2-34 微测惯例);测试目录即清。dropbox README 重写(一步能懂:同 zip 多出数+散投仓储费+直导/预演命令+手工口径+5 张不入选挂账说明)。部署面:/collection 为 worker :ro 挂载宿主改即生效,无镜像重建,明日 05:00 onno-ads-csv 槽位自然接线(无 zip/CSV 时优雅早退不变)。


9.74 2026-10-26 LXXVI R3 全栈审计三 P1 修复线:500 根因改判(#142 非迁移 149/150)+rolling 臂剔取消谓词+fg 8 月断档补采+keepa 监控池快照回灌 ✅P1①已修好·rating-review-analytics 200×151 行·账户列诚实降级 ✅P1②已修好·rolling 356→292 剔取消实测 ✅P1③已查清·非断档=EU 8/1-27 真实零单(结算面独立证实)·三面对账零缺单·429 静默退出缺陷已修 ✅P2-9已修好·死表名两腿激活·硬失败门·首真跑run284四腿全活·onno finances缺键挂账

① P1-1 门禁真空日三症根因两宗(部署 13:09 已含 500 修复,本批补 F6):」500 根因改判」——peer 疑迁移 149/150(rankings);实查=dashboard.py ratings_review_analytics 消费 sku_mapping.account,而 #142 表为准重建(迁移 147)删了 account 列(历史值永久消失、禁逆向不回灌)。修法=诚实降级:acct_by_asin/acct_by_nsku 恒空 dict,店铺列显「—」,容器部署后 zf 200×151 行实证(onno/fg 401=审计 jar 租户域,预期)。F6(watch→viewer 链接存在)=同窗第二症:keepa_watch/keepa_daily 被清空——法证链:05:10 watch_refresh 尚拉 2 ASIN、05:12 sku-convergence-pre-143 快照含 2 watch+107 daily 行、148 断言「keepa 行 ⊆ sku_mapping」vacuously 过 → #143 收敛清扫把选品监控池按 outside 行清了(监控池语义=盯任意市场 ASIN,天然不在 SKU 键域;9.73 校准记「双侧空一致无残留」即清扫后状态)。修复=快照回灌 2+107 行(ON CONFLICT DO NOTHING),watchlist API count=2 复活,F6 锚恢复。拍板新增:keepa_watch/keepa_daily 收敛豁免——148 一次性断言已过不反咬、face_recon 双侧空一致口径同改,但下轮人工收敛清扫会再删,需用户定豁免面(市场观测面 aba_* 已有豁免先例,keepa 池同语义)。→ 2026-10-26 用户「都同意」拍板已落地:face_converge FACES 摘除 public.keepa_watch/keepa_daily 两面(145→143)+面豁免册 docstring 登记(aba 族同语义:asin=观测对象非登记宇宙);audit.cleaned_keepa_* 保留在册作护栏(引擎血缘过滤构建永无外行,扫之空转);dry-run 实证 keepa 行 2/107 完好不在删除计划,明晨 07:50 夜跑不再误删。

② P1-2 merged-kpi rolling/day 臂取消单混入(AC-PEND-02 批一补迁级联缺口):dashboard.py:2244 rolling/day 臂原表级直查全量含取消,同端点 month 臂已用 id4 有效订单口径且 window_note 宣称「AMZ订单不含取消」——同卡切模式即换 orders 定义+标注失实。补 _XCO 同谓词(与 _merged_month_agg/财务页同口径),orders/units 同人群。api+worker 重建部署,实测 rolling 30d fg amazon orders 356→292、units 359→295(窗口漂移后与 SQL 预核 355→292 一致;peer 实测 353/291 同差值)。

③ P1-3 fg 2026-08 订单层缺数(AC-AUD-09):横向扫全品牌×月仅此一处灾难性洞(fg 8 月有效单 833/$17,765 vs 邻月 1398-3292);raw 层定界=EU 七市场整月近零(IT 646→3、ES 380→15、DE 151→4、FR 369→14、GB 78→3、SE 55→3、BE 85→4,US 542→162 部分缺),cleaned 忠实跟踪 raw → 缺口在采集层。根因=fg_amazon.py incremental 每市场锚点 after=max(purchase_date)−2h 跳过型缺口无法自愈(8 月授权/代理断档期每市场锚点跨过整月)。修法两件:a) 采集器加 ORDERS_AFTER/ORDERS_BEFORE/ORDERS_PAGES 三 env 旋钮(回溯窗覆盖锚点,write_order 先查+ON CONFLICT 幂等挡重叠);b) incremental 臂原「非 200 静默 break」改 429 退避重试(getOrders 60s×5、items 30s×3)+窗口打印——首轮补采假象「+0 单」实为全程撞限静默退出(status 臂连串 429 才暴露),配额干塘主因=每 30 分钟 status cron 抽干各市场桶。补采窗 2026-07-28→09-02(幂等重叠无害),页帽 40。禁按 fm 修平(AC-CAL-07):补的是 SP-API 原始单,fm $49,312 仅作收敛参照。补齐后链:ingest_today()(orders spec 90 天窗覆盖 8 月+四域清洗)→口径级联(cleaned_amazon_orders/v_amz_orders_daily/merged-kpi·财务页)→重跑门禁。新单 items 若因限流缺席,120 天 R10 回刷窗覆盖自愈。终局判决(同日深夜补采落地+三面独立对账):补采窗全市场重拉 +0 新单(幂等面全重复);直接探针再判别——ES/DE 8 月窗 getOrders 去状态过滤仍 0 单,而同市场 6 月窗(n=100 翻页)、8 月末窗(n=15 全 08-28~31)、9 月窗(n=83 连续)均正常返回=排除数据保留窗与凭证问题,EU 八月特异零返回;独立证据=结算面 settlement_items(Shipment 事件×币种):8/9 月 EUR/SEK/GBP 事件关联到的购买月只有 7 月(473 单,7/1-7/30)与 8/28-31(46 单)——EU 七市场 8/1-27 真实零销售(listing 暂停/度假形态;8-28 复市时点与「采集恢复」吻合=先前「断档」叙事里锚点冻结其实是无单可拉);US 下滑亦真实(结算 USD 事件 526→219→129 与订单面同轨,8 月购买 160=160 全对上)。全币种缺单探测器(Aug/Sep 结算 Shipment 单 LEFT JOIN 订单表)零缺单。fm $49,312 差额=结算月归集口径尾巴:健康月同偏差可证(7 月 fm 63,040 vs 订单层有效单 60,534=+4.1%;初稿曾误算 50,533/+24.7%=手加滑误,peer 独立复核 60,534 抓正,已按真值改),8 月 fm 吃 7 月大月尾巴尤甚。订单层完整=无级联变更,AC-CAL-14 以「零数据变更+getOrders 重拉/结算关联/库内三面一致」收口;fg 8 月 EU 零单为业务事实,后续审计勿再按邻月水位误报此洞。ORDERS_AFTER/BEFORE/PAGES 旋钮与 429 退避重试保留(未来真断档的回溯工具+静默退出缺陷真修,非本单必需但属真实缺陷)。

④ 附带发现(peer 复核证实并加重,已立 P2-9):backfill.py:440 定向同步 targets 四表名两个是死名——"orders"(_SPECS 无此名,amazon_orders 仅 ingest_today/tables=None 路径动态追加)与 "refund_monthly"(实名 amazon_refund_monthly)均落「未知表忽略」_ingest_alert 后流程继续;即 order_refund 回溯 UI 的订单+退款两条重同步腿 lifetime 从未真跑,仅 finance_monthly/order_fees 生效。与 P0-2 残余(回溯零真实行使)叠加——真实 recalc 验证时订单面不会被重拉,同批处置。修复建议(peer,待拍板排期):修表名+未知表告警升硬失败。修名即激活两条从未跑过的腿,属行为变更,入拍板单不抢跑。→ 2026-10-26 用户「都同意」拍板⑥已修好+首真跑落地:sync_source.py 定向模式(tables≠None)支持 amazon_orders(原仅 tables=None 全量路径动态追加订单 spec)+未知表软告警升硬失败 ValueError(容器实测 ingest_all(tables=['bogus']) 即抛「未知表」);backfill.py targets 死名 orders→amazon_orders、refund_monthly→amazon_refund_monthly,窗口深于 85 天订单 spec 自动换全史臂(增量臂只回看 90 天)。部署 23:29 UTC api+worker(快照 code-20261026-pre-p29-api.tar.gz),deploy_gate 全绿(pen/dashboard_audit/audit_nodes/pipe_audit/chart_value/frontend_e2e ALL PASS)。首真跑(P0-2「回溯零真实行使」残余同销):run 284 zf/amazon 2026-10-20~22 dry_run=false → done,sync 四腿全活=amazon_orders 6106+amazon_refund_monthly 3652(两腿原死名下 lifetime 0 行空跑,首跑即数千行实证激活)+finance_monthly 5261+order_fees 37453,clean_audit=clean-c0447eda9ee9,P1-4 快照 1 份,diff_report recon ok=true。首真跑选 zf 因其注册表已有 collect.finances 通道;连带缺口挂账(待拍板):onno/amazon collect 无顶层 finances 键(适配器只挂 collect.night 列表内,zf/fg 均有顶层键)→ _brand_channel 查 collect.finances 返 None,onno 的 order_refund 在通道查找第一步即 ValueError「未登记 finances 通道」——注册表补键属拍板级未单方改,连同 onno 首跑待用户拍板。✅已修好(9.78·2026-10-27 用户拍板「同意补上,跑首真跑」:迁移 155 补键+derive 映射补挂+run 289 四腿全活 recon ok·连带 Decodo 出口事故定谳换 IP 全记录)


9.73 2026-10-26 LXXV 「继续」续清批:广告销量 units 补列全链贯通(#145 挂账③收口)+9.68 盲区③量化销账 ✅迁移 153·landing 29,261 行全回填·cleaned 自动投影·placement-rows 出列·部署门禁六绿

① 广告销量(units)管道补列(#145 挂账③渐进项,迁移 153):投放分析表格「广告销量」列自 #141 落地起恒显「—」——采集层 {brand}_amazon_ads_search_terms 全套 unitsSold* 字段一直在(clicks/same/other × 1/7/14/30d),断点在 landing 表 public.ads_search_terms_daily 13 列未投影。补法四层:迁移 153 加列(bigint 可空)+sync_source _ST_BRANCH 补 sum(units_sold_clicks_7d)(口径=7 天点击归因总件数,与既有 orders=purchases_7d/sales=sales_7d 同窗配对;实测 zf 近 7 日逐日 clicks=same+other 且与 purchases 同量级;campaign 级 cleaned_amazon_ads_daily.units 同为与 purchases 配对总件数,跨面一致)+清洗层列=information_schema 自动发现随新列自动投影+routers/ads.py placement-rows 出列(sum(units),NULL 透传)。Noon 行落 NULL 非零——noon ads_queries 源无 units 字段(「Noon 明细待采集层」挂账另计),前端 units==null 显「—」语义保留,0 与缺失不等价。回填:ingest_all(tables=['ads_search_terms_daily']) 定向跑——amazon 分支无日期过滤=全史聚合 upsert,29,513 行一次补齐(landing 29,261 行 units 全非空);验证=cleaned 30 天 amazon units 合计 468、noon 291 万行全 NULL、API 实测 orders 1/units 1 行出列。部署:api/worker/web 三镜像重建+up -d,deploy_gate --quick 六门全绿(镜像固化/pen_tests/dashboard_audit/audit_nodes/pipe_audit/chart_value)。

② 9.68 盲区③(卡片无数值护栏)量化销账:挂账时点未验证 face_recon 对 9.68 事故形态的实际拦截力,本次补量化——cleaned_noon_orders 现存 86,791 行全部 PSKU 键形(nsku 精确臂/去尾臂命中=0 行),即 9.68 坏门「nsku 非空不许 psku 撞」若再现,该面存活=0/86,791、比值 0.000 ≪ strict 下限 0.95=face_recon 必红(事故原型即整面砍空型,非部分损伤型)。残余理论形态(行数不变、金额列损坏)现有四门(face_recon 行比/dashboard_audit 层内重算/audit_nodes 层内重算/晨检水位)确实都不抓——但该形态迄今零实证案例,且独立绝对值基准属口径拍板项(哪个数、什么容差),按「不过度为未发生形态设防」销账:实证形态已覆盖,理论形态留档不建机器。

9.72 2026-10-26 LXXIV #149 挂账全修批——「全修」五件:死键源改中央+废册清+财务面入扫+坑22 立门+连接泄漏治本 ✅迁移 151/152·face_converge 143→145 面(财务残 547 清)·R12 孪生谓词臂门立(首跑 PASS)·star_pct 泄漏修·五门禁绿

① noon_full_pull 死键源改读中央(迁移 151):adapters/noon_full_pull.py:82 skus_of 原读冻结镜像 {schema}_sku_mapping(同步通道 10-11 已删)——差集坐实:zf 镜像 102 键含 14 个 10-10 删除目录死键(IP16 族)天天拉、4 个新登记键从未拉;onno 镜像只剩 4 键而中央 14 键=10 个登记键从未进全量采集。改法:skus_of(brand) 经第二连接直读 saas_registry.sku_mapping(platform='Noon' 的 sku∪nsku 精确——去尾形是下游匹配工件非可拉键),取键失败回退冻结镜像(不劣于旧行为,日志可见)。授权形态(迁移 151):仅 SCHEMA USAGE+单表 SELECT 给 collector,RLS 保持 ENABLE+FORCE——SET app.tenant_id 才读到行,不设=恒 0 行(worker 内实测三态:无 GUC 0 行/onno 14 键/zf 92 键死键出清新键进池);租户号入 config.NOON_TENANT_IDS 单源。config.py/adapter 均宿主改即生效(worker 挂载面),今晚采集按新键宇宙拉。

② audit.lineage_exempt_keys 废册清(迁移 152):1,116 行(sku 1061+asin 55)全是 #149 中途「拍板C 继续看见」批次,被用户终裁「全部删除。不要再问了」取代——全仓零代码引用(api/tools/web/collection grep 皆空),滞留只会误导后人以为有免清面。快照 tools/backups/lineage-exempt-keys-pre-drop-20261026/(1,116 行可整表恢复)后 DROP,台账留拍板史。

③ finance_transactions 入扫(face_converge 143→145 面):「订单头逗号串」专项核实——zf/onno 两财务表现值零逗号行(列名 skus/partner_skus 为订单头级结构,值均单键),实余=zf 547 行双键皆外(nsku 未登记+IP16/ZFWB/ZFBT 旧目录 psku,2024-12~2026-10 交易);onno 0。两面补入 FACES(键列 skus+partner_skus,命中投票式同口径),快照 backups/finance-tx-pre-face-20261026/ 后首扫删 547=预测逐位相等,145 面归零,此后 19:05/07:50 夜跑常设执法。

④ 坑 22 机制化=R12 孪生谓词臂门(ruler_recon):api/clean_audit.py 与 tools/audit_clean_all.py 各持一份血缘谓词、三次只改一份(9.69 盲区②)——不动引擎(生产双千行文件重构风险不对等),立哨兵:ast 提取两文件全部字符串 Constant(隐式拼接=单节点,整条谓词天然完整)中的血缘臂 m.nsku/m.sku/m.asin/去尾=源列,存在集恒等执法:单侧独有臂(豁免册外)=FAIL、豁免条目失效=FAIL;豁免册 1 条=m.sku=a.advertised_sku(api 专属 campaign 品牌纠正 JOIN,o.sku_list 代卖臂实测双侧同有不需豁免)。首跑 api 47/tools 46 臂·违约 0·RULER_RECON 全绿。

⑤ star_pct cron 连接泄漏治本(amz_reviews_crawl.py):泄漏点坐实=main() 里 _admin_conn() 的选 ASIN SELECT 开事务后,60 ASIN 爬取循环 ≈40+ 分钟陪跑(idle-in-transaction 持 ACCESS SHARE,曾阻断 #142 迁移 43 分钟)——取完行即 conn.commit()+close(),进程尾 reg.close();语法/导入冒烟过,今晚 03:43 首效。五件均无需重建镜像(tools 宿主侧+/opt/collection 挂载面+psql 迁移);RULER_RECON 复跑 PASS(R1-R12 全绿)。


9.71 2026-10-26 LXXIII 铁律全栈审计 face_converge 常设收敛器——「只要不是 mapping table 里面的 asin 和 sku 全部删除。不要再问了」(#149) ✅存量 14,026 行判外清·79 有货 fg SKU/747 件入表·3,302 行恢复·143 面归零·终跑 dry 0 ✅夜跑 cron 两条已装(19:05 门禁前/07:50 晨检前)·15:53 UTC cron 式首跑 143 面 0

三令定谳(写死进工具与记忆):①「只要不是在 mapping table 里面的 asin 和 sku 全部删除。不要再问了」;②「不可以逆向这是铁律」——审计恒由 sku_mapping 派生合法键宇宙正向核对下游,mapping 永不因下游数据形态改写/补形(fg sheet 笔误 NY2002US 一字不动,其数据行靠 asin 登记而合法,仅 13 条 seller_sku-only 财务行留外);③「在 mapping table 里面就是正品」——登记=不可动,与库存是否为 0 无关。键类判定用户口径「首先核对 sku 这是第一要素,然后是 noon 的 nsku 和 amazon 的 asin」:合法键集=psku/sku 列 ∪ nsku 精确 ∪ nsku 去尾 regexp_replace(nsku,'-[0-9]+$','') ∪ sku_mapping.asin ∪ {‘[daily_total]’}。

行级判定终形=命中投票式(两错形实证勿改回):行内任一非空键命中合法集=登记行留;至少一键非空且全部非空键都不中=删;空列不投票。合取式(全列须命中)误删 asin 已登而 seller_sku 笔误不中的 onno 78 行;空列当救票的析取式漏删 sku/asin 全空的 fg fba 5,482 行——第三形收口,代码注释留「勿再改回」。

执行(快照先行·删数与 dry-run 逐位相等):tools/backups/iron-149-rest-pre-sweep-20261026/ 23 CSV+deleted_keys_*(1,509 键)+deleted_inventory_*(10,591 行/978 SKU)→存量清 14,026 行(fg 旧目录 12,986/zf 1,009/onno 31)→其中 79 个有真实库存的 fg SKU(747 件:NA 池 538=US/MX 同池镜像、CA=0;EU 池 9 国×87 一池;AU 122)用户令入表——按表内前缀=国别惯例(AU*→AU 11/EU*/EUS*→EU 16/NA-*、USS*→US 52)登记 79 行+products/inv_products 级联(语义照抄 ops.py mapping/edit,ON CONFLICT DO NOTHING),R9 双向 0/0;3,302 数据行从快照恢复(逐表 count 断言);随后清 1 行再生、复跑 dry 143 面判外 0。面豁免(不扫):市场观测面(aba_seat_cache/radar_gem/basket/repeat/aba_search_terms/rising)、aba_keepa_full(选品详情页渲染源,用户令勿动,误删 14 行已恢复)、注册表与 cleaned 镜像、ads_optimization_log/promotion_products/collection_schedule、raw 归档、[daily_total]/空键账号级聚合行。

R9 假孤儿事故(诚实记录):孤儿查询谓词多写 m.platform='Amazon',把 52 个 Noon-only 登记品(ME 尾缀:zf 45+onno 7,均 Noon/KSA+Noon/UAE 双行登记)误报「孤儿」,用户差点据此下令删登记品——「以后你能不能不要瞎说。怎么又孤儿了」「登记品 不要动」。定谳:分类标签出口前谓词先验对,数字复现对了谓词错照样是瞎说;R9 双向谓词禁平台过滤。工具落点:tools/face_converge.py(夜跑收敛器,docstring 含审计方向铁则)。挂账:①夜跑 cron 两条被会话权限拦待用户放行——已装·用户令「加上」15:5x UTC 落地(19:05 门禁夜跑前/07:50 晨检前,首跑 143 面 0)(不加则 noon 滞留键每日积一层,数小时内已再生 43 行);②noon_full_pull.py:83 仍读已断供的 frozen 源库镜像(死键回灌源)待改读中央三集;③audit.lineage_exempt_keys 机制已废待清;④finance_transactions 订单头逗号串挂 purge_outside_orders 专项。


9.70 2026-10-26 LXXII noon rankings 三集预滤落地——「一切源于 mapping table,只处理 mapping table 里面有的数据」(9.69 挂账收口 · #148) ✅四层执法:采集预滤+折叠谓词+清洗血缘+face_recon 门·存量源表 72+中央 72 清·三方 300=300=300·部署 13:08 UTC

拍板与落法:用户令「一切源于 mapping table,只处理 mapping table 里面有的数据」——product-reviews 目录级端点每日回灌的 72 行三集外键(12 个 Z 哈希/N 系滞留品键×3 天×2 市场)不再被「处理」。四层执法链:①适配器写入侧预滤(noon_portal_apionly.py mapped_keys():每次直读 saas_registry.sku_mapping 取三集 1,319 键,不留本地副本;取集失败降级放行+清洗层兜底;键集走 docker cp 文件通道,避开 sh -c 内联 SQL 的引号/$ 转义坑);②折叠保险带(sync_source _RNK_NOON 加 AND sku IN (1,319 键字面量),取集失败硬失败——保险带不许静默退化成无谓词;坑 23 教训:写入方回归也进不了中央);③清洗引擎血缘过滤(既有);④face_recon 门每夜对账(#147)。三集口径=AC-EL-MAP-051 三臂同源(nsku 精确∪regexp_replace 去尾∪psku,全表无平台分支)。

存量清理(快照先行):tools/backups/noon-rankings-src-outside-pre-148-20261026.csv(72 行)+noon-rankings-central-outside-pre-148-20261026.csv(72 行)→源表 zipforce_noon 删 72(12 键显式列表,分类器可见式语句)→onno_noon 断言 0→中央 rankings_daily 删 72。验后三方对齐:中央 noon 300=cleaned 300=源∩三集 276+24;中央三集外=0;face_recon 复跑 26 面 PASS。

验证与部署:独立三集(1,319 键)对撞中央 300 内/72 外与清洗层精确一致;折叠 spec 容器内实build 45KB 含 AND sku IN (...) 谓词在位;适配器 mapped_keys 在 worker 挂载面生效(:ro 宿主改即生效);13:08 UTC build+up api+worker(避整点/半点窗),启动日志干净。


9.69 2026-10-26 LXXI 第 8 道门禁 face_recon 落地——清洗层血缘保全双向对账(方向二「该在的不能丢」·9.68 盲区①收口 · #147) ✅26 面首跑全绿·24 strict 档比率全 1.000 精确对齐·期望值绕开引擎独立推算·挂进 19:10 UTC 夜跑第 8 道

立门缘由:9.68 事故的验收断言全是单向「mapping 外=0」——把面删光也能让外=0 通过(#143 血缘谓词门咬死 PSKU 键形面时,七道门禁无一红灯)。用户令「做第 8 道」补方向二:该在的不能丢——每夜用独立推算的期望行数对撞 audit.cleaned_* 实际行数。

设计铁则:①两把尺子——期望值 SQL 本文件自带,禁 import 引擎、禁复用其谓词字符串(拿引擎自己的逻辑验引擎自己=同错两遍);口径对文档定谳 AC-EL-MAP-051:noon 三集(nsku 精确∪regexp_replace(nsku,'-[0-9]+$','')∪psku 无条件)、Amazon m.sku / m.asin、rankings 分平台支两臂异键(noon 臂键 name、amazon 臂键 asin——校准中实证两臂共用单键必翻车,amazon 11,371 行全靠 asin 臂)。②面分两档:strict=无重去重语义面,raw∩血缘(独立算) vs cleaned 行数 floor 0.95/ceil 1.05 卡(sku_fin 0.90 让 brand_fix_key_merge);observe=结构性去重面(noon_ads_daily agg_shadow/product_covers/case_twin、ads_sku_daily campaign_hole、amazon_ads_daily asin_twin),期望不可独立精确重建,v1 只断「源有血产行则清洗层非零」+每夜打印两组数字供 drift 肉眼比对,精确重建渐进挂账。③gate_lock 串行+非零退出+FAIL 走 monitor SMTP(four_gates_nightly 既有通道)。

覆盖面(26):noon SKU 级 7(orders/sku_pl_monthly 利润卡结算腿/sku_status/sku_ads/sku_pl/sku_unsaleable/inventory)+Amazon SKU 级 6(sales_daily 0.997=brand_fix 行、inventory_health/order_items/sku_fin/refund/finance)+ASIN 级 5(keepa_daily/keepa_watch/aplus_history/product_reviews 双侧空亦一致、aba_keepa_full 2,220)+rankings_daily 11,671 精确+listing 4+observe 3。首跑校准 26/26 全 PASS、24 strict 档比率全 1.000(仅 sales_daily 0.997/sku_fin 1.000−3 行合并)。挂接:four_gates_nightly.py GATES 第 8 道(cron 不动,门列表在文件内,19:10 UTC 首跑今晚)。

校准中带出的三件事:①中央 rankings_daily 有 72 行 noon 目录级杂凑键(Z3F1A35…CZ/N51736509A 形,product-reviews 目录级端点全目录回灌、三集外)滞留 public 侧(清洗层已正确排除 372→300)——采集侧要不要按 mapping 预滤属用户拍板项,已修好·9.70 三集预滤落地(采集侧+折叠保险带+存量清);②Keepa 11 站边界复检完好(ABA_DOMAIN/RANKING_MARKETS 11 键、KEEPA_NO_SITE_MARKETS={AU,NL} 持续告警、COUNTRY_MARKETS AU/UAE/KSA=∅、在册∩11=9 活跃站,keepa_daily/watch 双侧空一致无残留);③9.68 盲区①(单向断言)就此收口,盲区②(孪生坑 22 无机制同步)已修好·9.72 R12 立门、③(卡片无数值护栏)已收口·9.73 量化覆盖实证。


9.68 2026-10-26 LXX 工作台 noon KPI 卡片 -$6,069 事故修复+AE/SA/SE/AU/NL 回灌根因收口(#143 血缘谓词门咬死 PSKU 键形面 · #146) ✅孪生 21 处谓词修正·8 面+2 虚拟层重建·卡片 -$6,069→+$39,130 腿逐一对上·回灌写入方定谳=夜间 ingest 折叠·源表清 6,023+5,766 行·四断言全 0

事故与根因:工作台 platform=noon 30 天利润卡 $-6,069(脚注「月度净结算−广告·日财务流水至 10-21」)。公式本身正确(AC-CAL-12 月对齐+fx 锁 SA3.75/AE3.6725,注册表在案);根因=#143 血缘过滤铺开时 psku 臂带门 coalesce(m.nsku,'')='' AND m.sku=…——noon mapping 106 行 nsku 全非空→门恒假→PSKU 键形面整面砍空:orders 86,803→4,184、sku_pl_monthly 1,343→49(onno 8→0)、sku_status 1,421→50、sku_ads 830→60;结算腿塌到≈+$99、−广告≈$6.3k=卡片负数复现逐分吻合。三集口径=#143 定谳「nsku 精确∪去尾∪psku 无条件」,该门违反口径。

修复与验证:孪生两文件(api/clean_audit.py 镜像内+tools/audit_clean_all.py stdin 工具,坑 22)21 处谓词修正+注释改写(AST 验证,备份 /tmp/*.bak-fix3);stdin 定向重建 8 面+noon_ads_daily 自动连带 2 虚拟层:orders 86,769 干净(raw 86,803 中 34 行真 mapping 外)、sku_pl_monthly 1,222、sku_status 1,305、sku_ads 783;inventory 3,737/ads_daily 16,687 不受影响(NSKU 键形,门本就不咬)。卡片同码复算=结算 9+10 月折 USD $45,376−广告 $6,254=+$39,130(orders30=2,085)腿逐一对上;9 月 orders 抽查 2,927/2,940(13 行真外,#143 已先删过大头)。部署 api+worker build+up 12:00 UTC,容器内谓词 11 处新式·0 处旧门。

回灌根因定谳(关 9.67 挂账):「不明写入方」=夜间 ingest rankings_daily 折叠自身——sync_source _RNK_ZF/_RNK_NOON 从品牌源表折行(snapshot_date≥current_date-120),中央删多少、源表折回多少。SE 632=fittingirls_amazon_rankings、AE/SA 各 1,935=zipforce_amazon_rankings(假市场行,keepa 无域)、fg AU/NL 各 632 同源;noon 侧=zipforce_noon/onno_noon_rankings 旧口径行(10-24 product-reviews 新口径生效前,「两旧口径都错」已拍板)。清理快照先行(tools/backups/noon-rankings-src-pre-purge-20261026.dump+amz-rank-fake-market-pre-purge-20261026.csv 5,768 行)→源表删 noon 6,023(zf 5,927+onno 96,全 pre-10-24)+amazon 5,766(AE/SA/SE/AU/NL 假市场)→中央重折后删 amazon 假 5,766+noon 旧 5,978→cleaned 重建 11,671 行。断言四条全 0/达标:amazon 未登记市场 0·noon 旧口径 0·noon 新口径 372(=124/日×3 天,product-reviews 目录级 sa/ae 同值)·SE/AU/NL 0。Monitor 60s 盯防已停(使命完成)。坑 23 登记:ingest=upsert 不删行——凡中央表与源表会漂移的面,必须源表侧清,只删中央=临时。

门禁与挂账:ruler_recon R1-R8/R10/R11 绿;R9 抓 products 孤儿 16 行(今晨 07:07:01 单事务 ops.py 级联残渣——一次 mapping 上传随后被 #142 表为准重建覆盖;快照 orphan-products-16-pre-146-20261026.csv 已备,DELETE 被权限层拦)——用户放行「16 行孤儿 删」已执行 DELETE 16·孤儿归 0·RULER_RECON 复跑 PASS(R9 孤儿 0/0·缺口 0/0·全尺绿)已修好;dashboard_audit FAIL 0/WARN 5(既有欠账)。台账 next=151。

9.67 2026-10-26 LXIX Keepa 官方 11 站收敛+AI 边界铁律(用户截图实证+拍板「amazon只抓取这11国, 没有的持续报警」·AC-EL-MAP-053 · #145) ✅域表/白名单/展开表三处收敛 11 站·public 删 1642+4502 行(断言迁移 150)·无站持续告警 2 行落地·e2e 三租户芯片全符

定谳与拍板:用户上传 keepa.com 官方域名切换器截图实证——Keepa 支持集=11 站(US/CA/MX/BR/UK/DE/FR/IT/ES/JP/IN)={1..6,8..12},无 AU 无 NL。旧域表 AU:13/NL:14 系 2026-09-27 误定(「13/14 不报 invalidParameter」被当成有效站,实为无效残留域号;@13 批拉 fg/AU 208 ASIN 仅 1 个有档案=B0FHHF2SQX 数据来路不明,@14 的 NL 744 行同判假)。当日晨 fg/AU 试拉 212/213 缺席与「源断供」定性被用户截图推翻,定性改为「Keepa 无此站点」。用户拍板:Amazon 只抓 11 国,没有的市场持续报警。

同日新铁律(AI 边界,用户原话「指定ai,按照指定操作,没有指定ai的,全是代码执行。这也是铁律」):只有效果上明确指定为 AI 的功能(ai.py 族:数据问答/选品建议/广告文案/广告优化/三页浮窗)按指定调 LLM;其余一切功能 100% 纯代码执行,禁止任何 LLM 参与。LLM 盘点:SaaS 内调用点=ai.py+dashboard 浮窗+listing 规格书 AI 兜底(_ai_kv_extract, ai_added 标记)三处;listing 兜底是否属「指定 AI 面」——同日用户拍板「算指定 AI 面」,指定 AI 面全集就此闭合=ai.py 族+三页浮窗+listing 兜底(ai_added 标记),铁律同步入尺=audit-base AC-SEC-13已拍板。

收敛执行:①keepa_client.py:ABA_DOMAIN 删 AU/NL 键(11 键)、DOMAIN_CURRENCY 删 13/14、KEEPA_SOURCE_DEAD 更名 KEEPA_NO_SITE_MARKETS={"AU","NL"}(语义=keepa 无站,取代「源断供」);②core.py:RANKING_MARKETS 13→11 站;③tasks.py:COUNTRY_MARKETS AU→空集、EU 6→5 域(去 NL);④冒牌兜底两处封死:listing.py keepa_watch 入池+ sourcing.py keepa_live 实时兜底对 AU/NL 跳过(原 ABA_DOMAIN.get(,1) 默认域 1 会把 AU/NL 冒牌成 US);⑤metrics.py:巡检新增「无站持续告警」——sku_mapping×KEEPA_NO_SITE_MARKETS 动态派生(与行存在无关),实测 fg/AU 208 ASIN+onno/AU 5 ASIN 两行每轮必报,取代原行级「源断供」标签。

存量清理与断言:public rankings_daily 删 AU 898(fg, domain13 假数据)+NL 744(fg657/onno14/zf73, domain14 假数据)=1642 行(快照 rank-aunl-pre-145-20261026.dump);另删 AE 1935+SA 1935+SE 632=4502 行——该批 #144「假市场」谓词曾删过(故迁移 149 当时 PASS),06:4x-07:0x UTC 间被不明写入方以历史 snap_date(07-11→09-29)回灌,audit_clean_all 只写 audit.cleaned_ 已验清白、pg_restore 无 rankings 回灌记录,回灌写入方已明(=夜间 ingest 源表折叠)·9.68 源表侧收口。迁移 150=11 站展开镜像断言(outside=0+AU/NL 残留=0,执行时当场拦下首次回灌后重删再 PASS)+台账 158 行。部署 api+worker 15:5x UTC 重建,容器内验证 RANKING_MARKETS/ABA_DOMAIN 11 键、AU 空集生效。

e2e:三租户 rankings 市场芯片全收敛 11 站内(zf 8 市场 FR/IT/DE/ES/US/GB/BR/JP——NL 消失;fg 7 市场 US/CA/GB/DE/FR/IT/ES——AU 消失;onno 6 市场);巡检告警恰 2 行=fg/AU+onno/AU「Keepa 无此站点…在册 N ASIN 机制性不采——数据源缺口, 非采集故障」。Keepa 未来上线 AU/NL 时四处同步:ABA_DOMAIN 加键+NO_SITE 删名+COUNTRY_MARKETS+RANKING_MARKETS+迁移镜像。

铁律册补遗(同日,用户指正「audit-base 为什么今天整理的铁律没有加进来…是所有的铁律…1-20」=《上线前全量审计与测试规范》20 节文档):规范文档头部核心铁律 8 条(只审计不修改/先测绘再校验/全页面全元素全维度组合/横向一致性/纵向业务流核验/强隔离/单一指标事实源/全链路可追溯)整体入铁律册=audit-base AC-SEC-14——9.59 方法尺(AC-AUD-01~16)与 9.60 需求尺(AC-REQ-01~26)已承载各 Step,但铁律层总纲此前散在条目里未立铁律条,用户视角即「没加进来」;各条现带 AC-AUD/AC-REQ 锚。§6 同步立「全册铁律登记处」导语(AC-SEC-07~14),立规矩=新铁律立规即入尺,未决子项行内挂账 pill 承载不等闭合(纠本日 AI 边界铁律迟入尺的时机问题)。快照 backups/audit-*-pre-sec14-16-20261026.tgz。

9.66 2026-10-26 LXVIII 排名面市场维度按 mapping 登记国收敛(用户拍板「严格按照mapping table, 没有登记的不用做」·AC-EL-MAP-052 · #144) ✅采集目录 26 组合全登记·public 删 7150 行(断言迁移 149)·cleaned 未登记 0·e2e 13 面对数全符

  • ①核对与拍板 —— 用户问「ranking 页面的 sku 数对吗」全面核对:页面=DB(zf US 6/DE 10/AU 7/noon SA 46 e2e 实调相符);血缘 100% mapping 内(#143 保证);数字偏小=设计(#57-g 家族代表制:每品牌×家族×市场 1 代表 ASIN,全空不写);EU 面对齐良好(fg DE/ES/FR/IT 9=EU 家族数、zf BR 3=3/JP 2=2)。呈报两真缺口+一口径点:AU 全线 Keepa 源断供(fg 停 10-10/zf 停 09-26,告警在案);fg/JP 连 8 天全空;**未登记国溢出行**(fg BR/IN/MX、zf IN/MX、onno MX 等)=采集器「未登记市场回退全市场代表」抓的——用户拍板「没有登记的不用做」。
  • ②采集面收敛(COUNTRY_MARKETS 唯一展开) —— api/tasks.py 新增 country→抓取市场集:US/CA/AU/JP/BR→自身、EU→GB/DE/FR/IT/ES/NL 六域(EFN 泛欧语义)、UAE/KSA→空集(无 keepa 域机制性不采,同 aba_keepa 池口径);_family_groups 改展开登记;_rankings_family_rows 去掉未登记市场回退——只出登记组合。容器内验证新目录:216 行/26 组合(fg 9 市场 84+onno 8 市场 40+zf 9 市场 92),与 SQL 模拟期望逐一相符;skipped 68=UAE/KSA 登记行(无域跳过)。
  • ③存量清理(快照先行+断言护栏) —— 快照 tools/backups/rank-pre-144-20261026.dump(全表 25,537 行)。public rankings_daily 单事务 DELETE 7150 行:zf UAE/KSA 旧形 AE/SA 3981+假市场 EU/SE/PL/BE/IE/domain1 2459(#49 起页面已滤的库存行)+未登记国 IN/MX/BR 560+zf/AU 旧宇宙 21;UK 640 行=GB 旧码历史保留(#49 归一并入 GB 趋势)。cleaned_rankings_daily 定向重建 18,387 行全干净、未登记市场 0。迁移 149 断言式落 pg-init(合法集动态从 mapping 展开派生,未来租户/新国登记不误伤);台账补登 147/148 漏行(#142/#143 只执行未登记,144 补登先例)→157 行,next=150。
  • ④部署与验证 —— api+worker compose build+up(07:2x UTC,避 08:00 晨检整点前完成)。e2e 三租户 13 面对数:未登记国全空(zf IN/MX/AU=0、fg BR/IN=0、onno MX=0)、登记国数值不变(zf US 6/DE 10/BR 3、fg US 9/CA 9、onno US 3/GB 5)、fg AU=1(10-10 合法登记市场,源断供保留另案);市场芯片端点自动收敛(zf 芯片=9 登记市场+noon 2,IN/MX/AU 消失——按有行市场派生无需改码)。AU/fg-JP 源断供仍挂告警账(Keepa 站点无数据非采集缺口)。

9.65 2026-10-26 LXVII 全业务面按新 sku_mapping 收敛(用户令「基于最新的Sku映射表往下梳理所有的业务…多sku的全部删除。少的都补全」·AC-EL-MAP-051 · #143) ✅public 26 表断言绿(迁移 148)·cleaned 23 面 mapping 外全 0·引擎血缘过滤全面铺开·RULER_RECON PASS·e2e 12/12

  • ①盘点与分类 —— 枚举 50+ 含 sku/asin/nsku 列表(public+audit.cleaned_* 镜像 142 张)。删:业务事实面(public 26 表≈29,133 行)+cleaned 镜像同口径;排除:audit_log/bak_*/keepa_product_raw(raw 归档铁律)/collection_schedule(品牌级调度——2 行空品牌=平台级单行合法非僵尸)/ads_optimization_log(决策留痕, asin 列混型号码形态非键错位)/promotion_products(推广候选清单, asin 可空未转正, 运营工具面非 SKU 事实)。键形态三坑修正:Noon 面 sku=NSKU(Z…Z-1)主形态+裸 slug(115 行)/N 系 ID 混存→判据统一三集=nsku 精确∪regexp_replace(nsku,'-[0-9]+$','')∪psku;rankings_daily noon 行无 asin 键在 name 列(裸 slug)→分平台支谓词;盘点期 asin NOT IN (SELECT sku…) 全假外已纠。
  • ②public 层删除(快照先行) —— tools/backups/sku-convergence-pre-143-20261026/(59MB/47 万行/26 表)。单事务 DELETE:sales_daily 911/inventory_health 5483/sku_fin 449/refund 61/finance_monthly 285/order_items 682/ads_sku_daily 525(campaign 级行豁免)/listing 2+6+1/aging 268/keepa_watch 2/keepa_daily 107/rankings 7419(amazon asin 6567+noon name 852=13 旧产品)/aba 1108/aplus 13/noon 面 588+10347+492+116+99+27+121+18;豁免保留:noon_ads_daily 聚合行 202(账号级总额真值, agg_shadow 依赖)。aging/promotion 两表 DELETE 0=盘点旧数撞键误差, 现值 asin 全在 mapping 内(验收对真值)。
  • ③引擎血缘过滤铺开(防再生, 孪生两文件) —— api/clean_audit.py+tools/audit_clean_all.py 同步:noon 表族 9 面+3 虚拟层落地三集判据(R-KEY-NOON 键位差禁令随 #142 nsku 列解除);ASIN 面 7 表(keepa_daily/watch/rankings/aba/aplus/reviews/aging)asin 血缘;listing/采购 5 表 sku 血缘;ads_sku_daily 补血缘(campaign 级行豁免);rankings_daily 分平台支。存量删后引擎夜间重建/档内增量均不再回灌 mapping 外行。
  • ④孪生漏同步三连坑(执行中揪出) —— tools 版 audit_clean_all.py 相对 api 版积欠三笔逐个现形:⑴key_disp 修补缺失(single_pk 标量 key 打日志 'int' object is not iterable——noon_ads_daily 单列 id 主键暴露, api 版 817 行早修);⑵unique_indexes 停在 6 列旧键(api 版 10-08 已扩 9 列最细键, 6 列遇最细行必建失败);⑶均随本次补同步。教训:孪生以 R8 字面量核对覆盖有限, 动 SPECIAL_TABLES/VIRTUAL_SPECS 时两文件 diff 必过。
  • ⑤cleaned 层重建+验证 —— 全量 17m47s+定向两轮:cleaned_sku_mapping 镜像 1483→1267、products 1213、sales_daily 28036、noon_inventory 3648、noon_ads_daily 16604 干净/142780 遮蔽(agg_shadow 等历史去重正常挡)、finest 121847、campaign 7622;23 面 mapping 外全 0。promotion 镜像重灌 15 行(排除口径)。补全面:keepa/aba 池 pool_outside 0, 缺 9 ASIN 全为 KSA/UAE(keepa 无站)+EU(无单一域名)机制性排除——可拉取域 100% 对齐, 每晚 04:40 seed_from_mapping 自动补种持续生效。
  • ⑥收尾 —— 部署 api+worker compose build+up 06:1x(避整半点/非广告档);迁移 148 断言式(26 表 outside 恒 0 幂等)落 pg-init;RULER_RECON PASS(R5-R11, R9 双 0 保持);e2e:三租户 mapping 17 列+placement(zf/fg)+orders/inv health/dashboard kpi/charts/noon catalog-sales/offers 全 200。快照 audit-html-pre-965-0538.tgz。

  • ①事实源与列集 —— 上传 5 xlsx(zf/Amazon 120 含 onno 5 行 Distribute、zf/Noon 92、onno/Amazon 20、onno/Noon 14、fg/workspace 1021)=唯一事实源 1267 行。列删 campaign_pattern/parent_asin/account(表无;活值 112/197/1424 随列删——048 保值语义终结、#57-e keepa 回填段退役、sync_source 10-11 起 mapping 通道已删无其他写方);列增 color_short_code(1260 填充)/size_full_name(1021 全 fg);NOON PSKU→sku、NOON NSKU→nsku;mode 值域约束 ('','direct','consignment')→('','Direct','Distribute')。
  • ②行集与值域迁移 —— 2424→1267:fg -132(EU-/NA-/USS- 旧前缀 SKU 系)、zf/Noon -24(IP16P 旧系+country 空串脏行)、onno -1(ONY2002US);zf/Amazon 品牌行 115 持平+收编 onno 5 行=onno/Amazon 25。country 形态迁移:AE→UAE、SA→KSA、GB/DE/FR 等 9 欧洲单国→EU 聚合行,新增 BR/JP/AU/CA;brand 小写租户键+tenant_id 盖章 1/2/3(brand 平台值 'Zipforce'/'ONNO'/'Amazon' 表原样归一至现行键形)。
  • ③执行(放行缝事务) —— DELETE 全表(SET LOCAL app.allow_guarded_delete)→新列集 INSERT 1267→级联 products/inv_products DISTINCT ON (brand,sku) 防 ON CONFLICT 同语句二次更新(同 SKU 多国行)→孤儿 DELETE 42+42(139 先例,用户拍板清理语义延续)。两次受挫记档:mode CHECK 拦 'Direct'(约束置于 DELETE 后重建);worker 清洗大事务持 products 行锁互等(先终止泄漏会话再抢 ads_import_pump 批间窗口)。快照先行:sku-mapping-pre-rebuild-20261026.sql(三表 1.1MB)+源件归档 tools/backups/sku-mapping-source-20261026/。
  • ④代码与部署 —— ops.py:048 快照回填段删+GET _HIDE 收敛+保存空值列清单去 account+导入 _H 增颜色简称/尺码全称中文头;tasks.py:keepa parent_asin 回填段删(keepa_products 自有表仍采);data_dict_meta 标签更新。迁移 147 落 pg-init。api+worker 同镜像 build+up 04:44(避整半点/非广告档;容器 rootfs 只读故走 compose 而非 docker cp)。
  • ⑤验证 —— e2e 三租户 17/17:五组合 GET 列 17+行数=表(115/92/25/14/1021)、roundtrip 保存 md5 零漂移、/api/mapping/skus 200、placement-rows 回归(627 行+31 行产品名 join+TACoS 0.51% 与 9.63 基线一致)、导入中文表头含新列、R9 孤儿 0/0;RULER_RECON PASS(R5-R11 全绿,R10 横向三租户同构零违约)。RLS 品牌隔离实测:zf cookie 访问 onno/fg 被 400 正确拦(P3⑮ 修复语义保持)。
  • ⑥挂账在案 —— worker ads_import_pump 分钟泵与全表 DDL 并发窗口=抢批间静默期执行(本次 25 分钟大事务实证);worker 03:43 star_pct cron 有连接事务泄漏(读后未关,idle 43 分钟持锁——已终止,管道面治本挂账)。

9.63 2026-10-26 LXV 导入表头归一化(「表头无已知列」修复·AC-EL-MAP-049)+广告页投放分析表格 19 列(AC-EL-ADS-102 · #141) ✅中文表头 Excel 直接可导·placement-rows 三配置 e2e·TACoS 本币同币种全链通·bundle 实证

  • ①导入修复(用户报障「产品建档 SKU 映射表 导入 excel 报错」) —— 服务端解析 200 而前端校验层报「表头无已知列」:用户 Excel 为中文表头(品牌/产品名称/成本/UPC 码…),与系统物理列名零交集。修=服务端 mapping_edit_import 加表头归一化(_H 中英映射 23 条+_norm_head 先原串后去空白小写,xlsx/csv 两分支共用)——零用户负担,中文表头文件直接可导。e2e:14 列中文表头 xlsx 导入行集全物理列名+值正确(「UPC 码」内部空格变体覆盖)。
  • ②投放分析表格(用户令 15 列口径,实落 19 列) —— /ads 平台投放 tab 第三 view「投放分析表格」:19 列(投放时间/国家/活动/广告组/关键词·定位/搜索词/产品/SKU/曝光/点击/CTR/花费+币种/CPC/广告订单/广告销量/广告销售额/CVR/ACoS/TACoS);筛选=粒度(日/月/年)+活动+产品+SKU 四下拉;spend DESC+分页。
  • ③API GET /api/ads/placement-rows 数据面定谳 —— 主行=audit.cleaned_ads_search_terms_daily(keyword/term 级,spend/sales=站点本币无折算列);SKU 桥=audit.cleaned_amazon_ads_advertised_products(活源最新 10-24;ads_sku_daily 覆盖不全弃用、cleaned_amazon_ads_daily 停更弃用);TACoS 分母=amazon_order_items.price(本币行金额,三租户填充 70-98%)×amazon_orders(order_status≠Cancelled)同币种相除;产品名=sku_mapping;Noon 面=cleaned_noon_ads_daily(现采仅 [daily_total] 日汇总行,明细如实降级;noon_orders 无金额列 TACoS=—)。派生公式=用户拍板(CTR/CPC/CVR/ACoS/TACoS,分母 0→—)。
  • ④e2e —— amazon month=627 行(TACoS 31 行有值:ASIN 定位行 asin="b0f94d64p3" 挂 SKU ZFH24T0SAB/ZFT11TSABE+产品名 H24/T11,tacos=0.51%);amazon day=151;noon month=4;TACoS 分母 SQL 直连 161 行(SA 30d 本币)双域(saas_admin/tenant_conn RLS)一致。
  • ⑤挂账在案 —— 广告销量(units):采集层 unitsSold* 字段在、清洗层 cleaned_ads_search_terms_daily 未投影,列显「—」待管道补列 ✅已修好(9.73·迁移 153·units_sold_clicks_7d 补列全链贯通);Noon 明细(campaign/sku 级)待采集层 ✅已修好(9.76·采集本就在·投放分析换源 caliber id=18 权威面·260 行明细+对账分毫不差·units 探针定案结构性无源);cleaned_amazon_ads_daily(brand 级日表)已停更(10-20 起无数据)——消费面本批已切 advertised_products 活源。
  • ⑥部署 —— api 03:52/04:04 两次 build+up(避整半点,04:10 周一 settle 为 worker 面不受影响),web 04:06 up;bundle 含「投放分析表格」+placement-rows chunk、/ads 200;快照 audit-base-pre-9-63-0404.tgz。

9.62 2026-10-26 LXIV 删列收尾:产品建档编辑器 campaign_pattern 面隐藏+保存快照保值(AC-EL-MAP-048) ✅编辑面列清单无该列·DELETE+全量重写下 112 行逐字保值·zip 错位隐患排除(显式列 SELECT)·e2e 9/9

  • ①动因 —— 用户令「产品建档 SKU 映射表 编辑 怎么还有 campaign_pattern 列?」:9.61 只删了只读表,EditTab 列清单系服务端下发(GET /api/mapping/edit 读 information_schema 全列),物理列在=编辑器照显。
  • ②决策:面隐藏不删列 —— campaign_pattern 为 DB 物理列且 zf/Noon 112 行活值(Amazon 174 行全空;onno/fg 两租户全空),sync_mercury 同步管道在写、无业务逻辑消费——删列丢历史数据,裸过滤 GET 列会让保存(DELETE+全量重写语义)把存量值抹 NULL。
  • ③手术三处 —— ops.py mapping_edit_get:列清单过滤 campaign_pattern+SELECT * 改显式列 SELECT(该列物理序第 13 位居中,过滤后 zip(cols, SELECT*) 必错位——upc/parent_asin/tenant_id/account/mode 全串位,显式列 SELECT 根治);ops.py mapping_edit_save:DELETE 前按 (sku,country) 快照存量值,INSERT 时回填(导入文件显式带值时以文件为准);collab.py mapping/skus 删 campaign 死字段(前端 Row 类型 9.61 已删,零消费)。
  • ④端到端实证(9/9 全绿) —— GET 列清单/行集无该列;编辑器同语义全量保存 roundtrip(saved=116)后 112 行 campaign_pattern 逐字保值;尾六列(upc/parent_asin/account/mode/nsku/asin)116 行 API/DB 零差异(错位排除强断言);/api/mapping/skus 无 campaign 字段;audit_log mapping.edit.save 留痕。验证脚本 tools/_verify_cp_hide_20261026.py。
  • ⑤部署与记档 —— api 03:30 UTC build+up(避整/半点,04:10 周一 settle 前,不触 worker)容器内健康 200;§11 册新增 AC-EL-MAP-048(下线留档,ID 永不复用)+端点锚表 GET/POST /api/mapping/edit、GET /api/mapping/skus 三行补挂;快照 audit-base-pre-map018-0332.tgz。

9.61 2026-10-26 LXIII 需求尺两挂账清零(迁移145/146)+产品建档页删「广告活动模式」列+迁移台账补正 ✅AC-REQ-18/24 ⚠️→✅·迁移151→154·RULER_RECON 全绿·端到端实证

  • ①迁移145(AC-REQ-18 清零) —— audit_log 补维度五列(platform/brand/sales_mode/country/sku,text NULL;存量行不回填不造值);写入面三件套:zlog 新增 _CV_DIM contextvars(set_dim/dim)+zlog_access_middleware 从 query 提取五维(只读 query 无副作用,不碰 body 流)+core.py audit()/_audit() 显式 dim 参数>contextvars 兜底(86 调用点零改动全量生效,POST 面维度经显式参数渐进补点)。端到端实证:verify.acreq18 行 platform=Amazon/brand=zf/country=US/sku=ZF-TEST-01 五列落值。
  • ②迁移146(AC-REQ-24 清零) —— metric_calibers 加 formula_version text NOT NULL DEFAULT 'v1'(37 行机器可读版本锚);版本化语义不变:改公式必生新版本号禁覆盖,三件承载(迁移+decision_date+台账)并存。
  • ③迁移台账补正 —— 144(横向镜像 29 表)效果在案(R10 全绿)但 schema_migrations 漏登记行,本批按原文件 sha256 校验补登(applied_at=9.57 记载部署时刻 00:32 UTC);台账 151→154(+144 补+145+146)。
  • ④产品建档页删列(用户令) —— mapping 页(AppShell title=产品建档)「广告活动模式」列删:th/td/colSpan 10→9/Row 类型 campaign 字段四清除净;§11 册随修随换:AC-EL-MAP-010 表头 10→9 列、AC-EL-MAP-017 整行状态改「下线」留档(ID 永不复用);web build+up 02:46 UTC(窗口合规),线上 bundle「广告活动模式」零残留、「产品建档」chunk 在案实证。
  • ⑤部署与验证 —— api 03:01 UTC up(避 03:00 整点,03:43 star_pct cron 前,不触 worker)健康 ok;RULER_RECON R1-R11 全绿(尺子条目 2737,REQ-18/24 ⚠️→✅ 状态随修随换+AC-AUD-05/10 挂账注同步换);快照:audit-base-pre-map017-offline / audit-base-pre-fix18-24 / audit-pre-9.61-0305 三拍。

9.58 2026-10-26 LX 「挂账全干」:star_pct 复活线调度真接线(评论墙 dp 直方图破局)+R6 扩面 121 隐行+R11 新立(§12 锚列防回退)+AC-AUD-04 缺口清零(DB 会话级 trace 标注)+onno 镜像表定谳+product_reviews 缺陷呈报 ✅worker 80 functions 加载·cron:amz_reviews_star_crawl 03:43 首排在册·R6+R11 零悬空零无锚·X-Request-Id→pg_stat_activity 会话名端到端恒等·29 表=13 有数+16 零行(结构占位定谳)·RULER_RECON PASS·web 200

  • ①star_pct 复活线收口(断源 09-29 后唯一重启线) —— 适配器 amz_reviews_crawl.py 改造(9.57 前夜开工本批全收):评论页 2026-10 起 Amazon 对数据中心 IP 弹登录墙(crawlbase js/standard 双 token 同墙)→ dp 详情页破局(详情页开放,星级直方图 ul._cr-ratings-histogram 两页同源同值;窗口法解析取前 5 个百分比,sum∈{99,100,101} 合理性闸);回写中央 rankings_daily.star_pct 只补不造行(当日/昨日行 UPDATE,keepa 05:20 建行次序兼容);取数缺值优先(30 天内无 star_pct 的 ASIN 排前)+limit 25→60 → 1318 对首铺约 22 天后退化为纯维护轮换。试跑实证:3/3 ASIN 解析([53,16,10,10,11] 等),B09XF8DXYR/CA star_pct={57,15,12,8,8} implied 均值 4.05 vs 页面 rating 4.10 相容。调度真接线:原 docstring「worker 日 cron 03:40+手动按钮」为空头支票(host crontab/registry/按钮三处皆无实锚)→ tasks.py 新增 amz_reviews_star_crawl(_arun 账本收口)+arq cron 03:43 注册,api/worker 重建加载实证(80 functions 含 cron:amz_reviews_star_crawl,00:32/00:46 UTC 部署避开各档口),首跑今晚 03:43。
  • ②尺子门禁扩面(R6 隐行+R11 新立) —— 「§11 无锚 67 行」挂账复核:批G-C2 组锚(19 个 AC-EL-{DOM}-G01 覆盖 67 端点行)前段已全落地(§12 400/400 有锚),但发现真缺口在门禁面——R6 行正则 \d+ 漏扫 -G01(组锚)/-A01(W 系审计追加)共 121 行,其视图/端点引用从未被执法 → 正则放宽 [A-Z]?\d+ 一并纳管,扩面后零悬空(121 隐行引用全干净,无潜伏缺陷);新立 R11 §12 锚列双向核(每行锚列必含 ≥1 AC-EL 引用=防无锚回退;引用必在 §11 真实存在=防悬空),首跑 400 行·命中集 2745·违约 0。RULER_RECON 全量 PASS。
  • ③AC-AUD-04 TraceID 缺口清零(快照先行 backups/audit-base-pre-aud04-20261026.tgz) —— 挂账两面:web 前端携带=P2-35 已在(2026-10-23 kit.tsx 一次性 fetch 补丁:全部 /api/ 请求注入 x-request-id=标签页种子,响应 id 领养回存,条目文本此前未同步);DB 会话级标注=本批补面:api/core.py _TracePool(getconn 时 set_config application_name=saas-api/<trace_id>,25 处 getconn 调用点子类一处收口)+tasks.py worker 面同款子类(saas-worker/,arq @job contextvar/ZLOG_TRACE_ID 领养链天然衔接)。端到端实证:X-Request-Id: verify-aud04-26 打 /api/health→pg_stat_activity 会话名 saas-api/verify-aud04-26 恒等(pg_stat_activity/PG 日志 %a 归因可见)。audit-base 条目缺口段改「缺口清零」终态;标注失败不阻断取连(尽力而为)。
  • ④onno_amazon 镜像表定谳(29 表消费面盘点) —— 今日精确 count(n_live_tup 滞后不可作证):13 有数(ads_daily 1455 行=onno-ads-csv 通道在供·inventory_fba 740·spapi 族 11 表 2,536)+16 零行(ads 族 12 张:2025/advertised_products/campaigns/keywords/optimization_log/payments/purchased_products/sb_campaigns/sd_campaigns/sd_targeting/search_terms/targeting+field_registry/ops_settlement_log/rankings/spapi_storage_fees)。定谳:消费面=audit.cleaned_* 清洗层(onno 已由通道覆盖),空镜像=原始层结构占位(AC-SEC-07 横向一致载体)无消费缺口;断供透明承载=ads_staleness_alarm(>7 天品牌信箱)+页面空态提示;数据渐进=上传通道铺开(amz-ads-csv --brand onno 任意 ads 表补数可用)+历史样本待投递(rankings/2025 存量可由快照灌)。不另建消费旁路,防双事实源。
  • ⑤product_reviews 缺陷呈报(AI 评论分析数据源空转) —— 采集器 2026-10-07 上线(用户令:AI 分析评论内容需数据源)至今 0 行,双根因:(a) 调度从未接线(见①,本批修复);(b) product-reviews 页 2026-10 起对数据中心 IP 登录墙(js/standard 双 token 同墙,抓回=登录页 3000+ 字符无评论数据钩子)。本批 dp 通道救回 star_pct(直方图两页同源)但逐条评论仍被墙——通路恢复自动续采(适配器幂等近重复跳过,无数据损失风险,每夜 60 ASIN 轮巡即自愈);AI 评论分析功能数据源依赖此表,上线时序受 Amazon 风控面制约非工程面,如实挂账不硬绕。

9.55 2026-10-25 LVII 「列构那9张也补齐对齐」收口:迁移142 Amazon 9 实体列构三租户统一(fg 新口径)+视图闭包 18 对象复原+R10 横向列构哨兵 ✅仍不一致=0·行数守恒·17/18 视图逐字节复原·fxd 双签名并存·台账150·R10 首跑 PASS·七道门禁全绿(迁移后池陈旧连接两瞬态复跑即绿)

  • ①口径先于代码 —— 对齐面=LV/LVI 横向验收抓出的三方漂移 9 实体(orders/order_items/settlements/settlement_items/sales/finances/service_fees/inventory_fba/rankings);类型基准=fg 新口径(id bigint/长文本 text/时点 timestamptz——fg finances.posted_date 83% 带真实时刻(非零 73,865/88,841),反向转 date 丢数据,故 zf/onno 升级方向);列名基准=三方并集(zf settlement_items.item_key/quantity/seller_sku 补 onno/fg、zf rankings.star_pct 补 fg;补列不加 UNIQUE 保持 zf as-built);签名口径=列名:类型集合按列名序——物理列序=各租户建表批次产物不属对齐面(后验曾按 ordinal_position 聚合致类型全同的 9 实体全假 FAIL=铁证修正)。
  • ②视图闭包 18 对象随迁回收重建 —— pg_depend/pg_rewrite 全边表定谳真实视图间边仅 3(v_fittingirls_order_finance_detail→v_fittingirls_shipment_agg→v_fittingirls_finances_flat 三层链+v_settlement_tracker→v_order_master;deptype='n' 排 rule 内部自环——递归 CTE UNION ALL 因 rule→view 自环死循环两挂后弃用);DROP 拓扑序/CREATE 反序;属主授权 as-built 复刻(16 张 owner=collector+SET ROLE 后 GRANT mcp_read,zf/fg 2 张 saas_admin 属主 relacl NULL 原样);mv_asin_daily WITH DATA 重灌 4,064 行。后验:17/18 定义逐字节一致,唯 v_sku_profit 剥 posted_date::timestamptz 冗余转型(语义等价,R7 契约面不含它零影响)。快照先行 backups/align9-pre-142-20261025.dump(26 表全量)+align9-viewdefs-pre-142-20261025.sql。
  • ③九放终落地(17:03:36 UTC,16:59 整点邻域主动等过 17:00 后 17:01 放行) —— 六记拦截各修:③DROP 被 order_finance_detail 依赖拦截→闭包首端补进 DROP 面;④fxd(date,varchar) 失配(finances.posted_date 升 timestamptz 后 v_order_finance_detail 炸)→加 fxd(ts timestamptz,c) 重载委托原签名((ts AT TIME ZONE 'UTC')::date,视图文本零改动、双签名并存);⑤18 份 pg_get_viewdef 定义尾带分号令 matview WITH DATA; 成孤儿语句→剥尾分号;⑥后验嵌套聚合→双层子查询;⑦哨兵物理列序假 FAIL(见①);⑧audit_log 在 saas_registry 非 amazon_analytics→127 先例两库两段 \connect 各自 BEGIN/COMMIT。量面:id→bigint 18 处·text 7 处·timestamptz 3 处(zf/onno finances.posted_date+zf rankings.created_at,USING AT TIME ZONE 'UTC')·补列 7 处·FK 3 组同事务 drop→alter→re-add 原名复原;行数守恒 zf_orders=15,461/fg_settle_items=256,297/fg_rankings=4,424;台账 150 行(sha256=6a4478ca…)+audit_log trace registry.column_align_142_20261025(before view_closure:18/after views_recycled:18·mcp_read_grants:16·fxd_overload)。
  • ④R10 横向列构核(ruler_recon 第 10 道,同平台列构恒等执法面) —— 域=按平台有 schema 的租户(fg 无 noon schema=未注册整租户不比);三面双向执法:共有实体(≥2 租户)签名不恒等=FAIL(SIG_EXEMPT 挂账降 INFO)/实体集差异未豁免在册=FAIL/豁免条目失效(防册腐烂)=FAIL。EXEMPT_ENTITIES 30 条全带出处注记(onno Amazon 16=Ads 暂停拍板 ADEF-C+brand_override 分家+rankings 无适配器等/noon onno 6/fg 6/zf 2)。首跑 PASS:平台域 amazon=[fittingirls,onno,zipforce]·noon=[onno,zipforce],实体 amazon 29/noon 43,豁免 30/30 全活,违约 0,签名挂账 INFO 仅 noon.fbn_inventory 1 张(sku_mapping 列名:类型集合已同——按 R10 现值修正 L 段「noon 2 张差」旧口径)。首课:豁免册须用库全名 zipforce/fittingirls(简称撞库内 split_part 曾 15 FAIL)。
  • ⑤门禁(142 后七道串行 17:12–17:27+复跑 17:29–17:39 全绿) —— dashboard_audit PASS · audit_nodes ALL PASS(zf 3,095/32·onno 2,669/31·fg 3,088/29·MCP 6/6×3)· priv_channel_audit PASS(66 站点零漂移)· ruler_recon PASS(R7b 1/0·R9 双向 0/0·R10 首跑如④·registry 37 行/尺子 2,689/漏锚 0)· storage_fee_recon PASS(平 99/豁免 16/true-up 3/当月 1/窗外 31)。pen_tests+frontend_e2e 首跑各撞一记迁移后 API 连接池陈旧连接(17:12:38 zf login 522/17:13:21 alerts 500,同 OperationalError「server closed the connection unexpectedly」,各自秒级自愈——17:13:31 同端点已 200;PG 日志无崩溃/终止记录、DB 容器 11 天未重启)→复跑全绿(pen_tests 220 PASS·e2e 205 PASS)。附带暴露 pen_tests 空 token 时签名篡改用例 IndexError 崩(门禁健壮性小瑕,FAIL 判定本身无误,挂账不修)。本批纯 DB+tools(R10),无 api/worker 代码变更不涉镜像重建。
  • ⑥呈报(挂账待拍板,未自行处置) —— ①适配器数据不齐:补列后 onno(558 行)/fg(256,297 行)settlement_items 的 item_key/quantity/seller_sku 恒 NULL、fg rankings star_pct 0/4,424——须 /opt/collection 适配器升级写入才有值(zf_settle_items.py 有写逻辑可参照移植;zf 现值 item_key 100%/seller_sku 98.6%/quantity 7.6%·star_pct 1,756/3,870);②noon fbn_inventory 列构差是否补齐(唯一签名挂账);③onno rankings 实体缺失(无适配器挂账);④fg 月度开销快照处置(L 段挂账延续)。页面快照 backups/audit-html-pre-955-20261025.tgz。

9.54 2026-10-25 LIV 「1,2执行」:231 行级联回填(迁移140)+Reserve 过滤口径入册执法(迁移141·id37·AC-CAL-19·R7b)+R9 升格双向 FAIL ✅双向缺口0·孤儿仍0·零造值·id37纯注册零量值改动·R7b自咬验证·七道门禁15:51–16:06全绿

  • ①级联回填(迁移 140,用户令「1,2执行」①) —— 9.53 挂账的正向缺口收口:80/151 mapping 行缺口=去重键 32/44(同 sku 多国/多平台多行;断言护栏首拦——首放按行数 80/151 写断言被自身 DO 块拦下中止,改键口径后重放成功,报数行/键口径必须注明)。语义逐字照抄 ops.py:322-339 级联(title=product_name 兜底''/category=''/price=0/cost=cost_rmb;inv.standard_cost=cost_rmb 兜底 0)——值全部来自 mapping 零造值(与 AC-CAL-17 展示页禁造值同精神)。实测 products 1,282→1,314/inv 1,270→1,314,双向缺口 0/0(mapping 1,483 行全覆盖)·孤儿仍 0/0;audit_log trace backfill140-20261025;快照沿 139 档(orphan-cleanup-pre-139 两表全量 dump,回填纯 INSERT 可按窗口剔除)。
  • ②Reserve 口径入册(迁移 141+AC-CAL-19,用户令「1,2执行」②) —— 9.51 候选挂账转正:metric_calibers id37(monthly_overhead/amazon,filters.exclude_adjustment_type={ReserveCredit, ReserveDebit},audit_base_ref=AC-CAL-19,setval 37)+audit-base §AC-CAL-19 条目(储备金=资金池往返科目后续月份对冲回转,计入虚增/虚减当月开销;as-built 烘焙于视图与批F 分层真源拍板一致;视图固定结构字面量不在口径范围)。纯注册零量值改动——注册前视图既有行为=本口径;metric_calibers 快照 backups/metric-calibers-pre-140-141-20261025.dump 先行;台账 149 行(146+139+140+141)。
  • R7b Reserve 烘焙哨兵(ruler_recon 新锚,随 id37 落地) —— 三库含 'Reserve' 字面量视图必须唯一=(amazon_analytics, v_monthly_overhead)+其 adjustment_type 比较位字面量集≡id37 册集(双向逐比较位,同 R7 手法)。首跑两课:⑴ pg_views 返回带 schema 前缀致 v_monthly_overhead 自身漏认——即修;⑵ ~* 'reserve' 误伤 v_inventory_health.reserved_quantity/amazon_inventory_aging.reserved——FBA 库存预留语义非资金储备金,收窄大小写敏感 ~ 'Reserve'(资金科目 PascalCase 惯例),小写 reserved 出执法面。自咬测试在案:册值临时删 ReserveDebit→红(比较位字面量≠册集)→恢复→PASS。
  • R9 升格双向 FAIL —— 正向缺口由 INFO 升格 FAIL:140 回填后缺口恒 0,ops.py mapping/edit 为唯一 mapping 写路径且恒级联(2026-09-19 拍板「新SKU创建完所有业务流自动创建」),今后任何方向缺口/孤儿=级联铁律违约当晚红(夜跑 19:10 第 6 道)。现值:孤儿 products 0/inv 0 · 正向缺口 0/0。
  • 门禁(140/141 后七道串行,15:51–16:06 UTC 全绿) —— pen_tests · dashboard_audit · frontend_e2e · audit_nodes · priv_channel_audit · ruler_recon(R9 升格首跑:双向 0/0 · 违约 0;R7b 首跑常态:扫面 1 张=契约 1 · 违约 0)· storage_fee_recon。本批动 products/inv 数据面+metric_calibers+tools/ruler_recon.py(无 api/worker 代码变更,不涉镜像重建)。

9.53 2026-10-25 LIII mapping 宇宙验收:258 行立规前孤儿清理(用户拍板 A)+迁移台账漏登修复 ✅迁移139·products孤儿95→0·inv孤儿163→0·mapping 1483未动·台账147=147零漂移·立规后零新增

  • 验收复现(用户问「所有产品源都来自mapping table没问题吧」) —— 机制面四锚全在:官方通道 mapping/edit 级联建 products/inv_products;防再生双引擎血缘判据;keepa 池 seed_from_mapping 正向;radar 公共道 22,681 纯市场 ASIN 不逆向流入。存量抓到 258 行孤儿(全部立规 10-17 之前创建,最晚 10-12;立规后新增=0,无绕 mapping 活跃写入方):products 95(fg 93 100% 命中 10-10 瘦身删除集 bak_sku_mapping_fg_20261010+zf 2)+inv_products 163(全 zf,含 1999-TEST-DE 测试行;10-21 快照时已在 mapping 外)——跨租户/品牌污染零,属「mapping=宇宙」纯净度残留。成因:10-19 严格执行批次清扫面按拍板只盖六个数据面,级联注册表不在内且无不变量执法——用户拍板 A:清理。
  • 迁移 139(快照先行+断言守卫) —— backups/orphan-cleanup-pre-139-20261025.dump(两表全量 -Fc);DO 块 DELETE 断言 95/163 精确命中不符即中止;实测 products 1,377→1,282 孤儿 0/inv 1,433→1,270 孤儿 0/mapping 1,483 未动;audit_log 留痕(trace orphan139-20261025)。信息性挂账(不在本批动):反向级联缺口 80 mapping 行无 products/151 无 inv(存量未回填,属缺非污)。
  • 迁移台账漏登修复(同场排雷) —— 批C-G 当日五批连跑,133–138 六文件多库 \connect 手工 psql 应用未走 migrate.py 登记(下次 migrate.py 会误判 pending 重放的地雷);六文件内容逐项在库探针全中(133=write 行 115/134-135=id32-35/136=id36/137=id29/138=空 platform 0)→ --register-existing sha 锁定收编。现值:目录 147|账本 147|待应用 0|漂移 0。教训入册:多库迁移也必须走台账(手工应用后补 --register-existing 或拆单库文件)。
  • R9 级联注册表纯净度(铁律执法面,用户指正「这不是铁律吗」后即落) —— 「mapping=唯一数据源、禁逆向捕捉」系 2026-10-19 用户亲定成文铁律,执法补强非新口径。ruler_recon(夜跑 19:10 第 6 道)新增 R9:products/inv_products 每行必须可反撞现行 sku_mapping,孤儿>0=当晚红(下游自造第二事实源=铁律违,139 清存量后应恒 0);正向缺口(mapping 行无级联子行,存量未回填)属缺非污,INFO 计数呈报不误报(现值 80/151,待拍板是否回填)。
  • 门禁(139 后七道串行,15:19–15:35 UTC 全绿) —— pen_tests ALL PASS · dashboard_audit PASS · frontend_e2e ALL PASS · audit_nodes ALL PASS · priv_channel_audit PASS · ruler_recon PASS(R9 首跑:孤儿 products 0/inv 0 · 正向缺口 80/151 INFO · 违约 0)· storage_fee_recon PASS。展示/消费面零改动(纯 DB 存量清理+tools 脚本,无 api/worker 代码变更,不涉镜像重建)。

9.52 2026-10-25 LII 恢复演练:venus 异地备份链端到端验证(用户令「演练」) ✅判定 PASS·11/11 逐位全同·三库恢复零警告·差异 100% 时点语义解释·备份链零缺陷

  • 四关方法与结果 —— ①拉取关:venus 11 份 *_20261025.dump 全量拉回,sha256 与 mars 本地 11/11 逐位全同;②档头关:pg_restore -l 11/11 TOC 完好;③恢复关(db 容器 /tmp 中转+pg_restore -j4,毕即删容器内副本——stdin 管道不可寻址不能用 -j):saas_registry 135s/zipforce_ba 1001s/amazon_analytics 28s,三库 EXIT=0 错误日志全 0 字节;④对数关:结构全等(表 177=177·视图 1=1·触发器 24=24;ba:ba_search_terms 精确 count 54,471,273=54,471,273+期次锚 2026-09 两同·sourcing 三表逐位相等·catalog_perf 9,308=9,308;amz:表 2=2 视图 19=19);冷表精确相等(delete_policy 49·tenants 3·ads_rule_config 60·sku_mapping 1,483);热表 audit_log 差 429=live 中 created_at>03:30 恰 429 行逐行全数解释。
  • 发现→定谳(演练价值的兑现点) —— 首扫 RLS 启用表 152 vs 151+策略 155 vs 154,差异表=amazon_order_status_log(live 有 ENABLE+FORCE+brand_isolation,drill 无)。时间线定谳(schema_migrations 台账为证):111 建表只落触发器+授权漏 RLS 三件套(DDL 先行 10-23/台账补登记 10-24 06:17)→ GOV-01 不变量次日抓回 → 127-fourlayer-f 04:45:54 UTC 补齐,而演练 dump 取自 03:30——早 75 分钟,drill 无策略=时点语义非备份缺陷。自证闭环:对 live 现取 schema-only dump 含 ENABLE/FORCE/CREATE POLICY 三行(6152/18002/18319)→ pg_dump 捕获无恙,明晚档自然携带。同理全数解释其余差异:metric_calibers 36 vs 25(+11=id26-36 今日批种)·endpoint_registry 330 vs 215(+115=write 行入册)·台账 140 vs 134(+6=127–132)。
  • 判定 PASS+清场 —— 异地链与本地逐位一致、档头完好、三库可完整恢复、恢复态=03:30 时点精确快照(全部 live 侧漂移均由时间戳在案事件解释),备份链零缺陷、backup.sh 无改动需求;坑记:live pg_stat n_live_tup 54,293,992 系统计估计值陈旧(精确 count 54,471,273),对数一律精确 count。清场毕(DROP drill_registry/drill_ba/drill_amz 零残留+rm -rf /tmp/drill)。证据档 evidence/restore_drill_20261025.txt;页面快照 backups/audit-html-pre-952-restore-drill-20261025.tgz。

9.51 2026-10-25 LI 批G 五级优化批全量落地(用户令「ABCDE都做」:备份尾巴+三小件+归一/补锚/对账门+拍板项查证+杂项) ✅迁移137+138·id12潜伏缺陷闭合·第7道对账门·R7哨兵·gate_lock·七门禁全绿·E3 git init

  • A 备份切换尾巴(迁移 137+晨检第 7 面) —— id29 offsite_backup_keep 改 venus as-built:host=venus 唯一异地(mercury 同日 FROZEN 留档)/03:30 UTC 日档/keep_per_series=2(prune 先于 push 防瞬态超盘)/mars 本地 14 天/venus 故障只告警不阻断+failure_policy 指向晨检第 7 面;audit_log 留痕。pipe_morning_check 新 check_offsite()(第 7 面):mars+venus 双侧 dump 戳/份数/盘余/镜像四查——FAIL=双侧任一滞后·venus 不可达·缺 dump·盘<2G,WARN=份数不齐·盘<5G·镜像缺目录;stamp 解析严格 grep(旧名 saas_registry-v2026.10.21-round2 类文件曾污染 sort 首查即修);实测 4×PASS(11 库@20261025/24.4G)。E1 勘误:monitor.py 代码 10-24 已切 monitor_smtp_*,本批仅清 docstring 残词。
  • B 三小件(互斥·漂移语义·缺行 WARN) —— ①tools/gate_lock.py:全局 flock /tmp/zf_saas_gates.lock,8 个打 API 门禁脚本 __main__ 首行接入(e2e×audit_nodes 240/min 限速桶+pen×dash logout-all 连坐两族冲突根治;排队≤30min/超时退 2),双进程实测 holder 6s/waiter 排队 4.5s;②priv 账本 sha8 优先匹配:账本 sha 同文件可寻=纯行号漂移降 WARN(例行 --regen 即清),全文件不可寻才 FAIL(真增删改);首版两缺陷自修(悬垂 else 语法/新行 sha 自咬——配对改键于账本 sha);66 站点再生纯行号 diff 验讫;③caliber_filters 缺行 WARN:行缺/类型异常→logging.warning(DB 不可达仍静默 {} 兜底),容器内正反双向实证(缺行 WARN 触发/命中行零 WARN)。
  • C 归一+补锚+对账门(迁移 138+19 域组锚+第 7 道门) —— ①platform 空串→'all' 5 行(cost/fx_pegged/health_line/offsite_backup_keep/brand_fix)+5 调用点同步(core _pegged/_AL 实参+health_line SQL 谓词+clean_audit+ruler_recon R5/R8 needle),DO 断言 empty_platform_left=0;id12 潜伏缺陷闭合:core 调用默认 platform='' vs 行存 'amazon',自 #61B 起静默回落字面量 35/90——值恰与 A4 原值全同零行为变化,caliber 今起真源生效(容器命中实证);②§12 全量册 67 个「无§11锚」pill → 19 个 AC-EL-{DOM}-G01 域组条目(ADS/AI/BILLING/DASHBOARD/FINANCE/HEALTH/INTERNAL/LISTING/MATRIX/MCP/NOON/NOONOPS/ORDERS/PROMOTION/REPORTS/SOURCING/TENANT/TODAY/WEBHOOKS;写端点批D 已全方法入册故 R6 零悬空);③tools/storage_fee_recon.py=夜跑第 7 道:id27/AC-CAL-18 全派生(专表月−1+税前折算+双侧绝对值+true-up carve+报表缺月豁免+LTSF/Vine 挂行+当月结算 INFO 一次保护+--window=3 新断即红/31 历史已解释残差不红;fg/onno 结构性无报表面注记挂行),首跑 PASS:99 平/16 豁免/3 true-up/1 当月/31 窗外。
  • D 拍板项逐项查证定论 —— ①_NOON_BID_DIFF 收编 id26:advisor 孤立字面量 0.05 删除,改派生 _BID_DEF["diff_pct"](单源);②P2-15 记忆冲突查证:已拍板已落地——2026-10-24「ADEF全部接受修复」A① 即含拍板(结算 sku 轴可拆+账户级按销售额分摊),id31 svc_fee_allocation+_SVC_BRANCH_CONSIGN(sync_source.py:546,消费 :2344/:2353)在册在役,「分摊仍待拍」旧记作废(session memory 已同步更正);③E4(用户抄 26,501/fg 84 两数字与页内任一快照日均不匹配)+E5(audit-base 撞号 ID 指认)=用户侧未回,维持呈报;④mercury 旧数据/机器处置=维持先保留(FROZEN-20261025 原地)。
  • E2 R7 反向哨兵(覆盖面扩展) —— 三库普查 cancel 字面量视图=10 张:契约 4(orders/amazon 三视图+orders/noon 一视图)+展示标签映射 5(单值 'Canceled'→'已取消' 文案映射非排除谓词;LABEL_MAP_ALLOW 封闭名单:v_order_master/v_order_finance_detail/v_fittingirls_order_finance_detail/v_onno_order_finance_detail/v_settlement_tracker)+v_monthly_overhead 1(ReserveCredit/Debit 过滤,非 cancel 类)。哨兵执法=三库 pg_views definition ~* 'cancel' 任一视图不在契约∪白名单→当晚红(首扫 9 张 0 违约)。呈报①:v_monthly_overhead 的 adjustment_type Reserve 过滤无注册口径,是否册化待拍板(按「口径定义先于代码」未自行注册)。
  • E3 zipforce-hub 转 git(init+暂存落地,首提交待批) —— 前置安全件:changelog.zipforcehub.com file_server 默认不挡点文件(.gitignore 公网 200 实证)→ Caddyfile changelog 块双 file_server 加 hide .git .claude .gitignore(首版 hide /.git 带斜杠=绝对路径永不匹配即改相对;admin off 设计→容器重启生效),实证点文件 404/页面 200/截图真文件 200(目录列表 404=无 browse 常态);git init -b master+168 文件暂存(.gitignore 沿 10-09 版:keepa 548M/截图 445M/测试报告 77M/backups/saas 快照不入库,本批补 .claude/);首提交待用户「commit」令(与 saas 仓库同请示)。
  • 部署+门禁(13:1x–13:4x UTC,避 19-22 广告档/整半点/02:00 日档/08:00 晨检) —— 迁移 137+138 先行→api+worker 镜像重建→容器换血(迁移与换血同窗,fallback 值全同分析在案);七道门禁串行全绿:pen_tests ALL PASS · dashboard_audit 198+ 项 FAIL 0 WARN 1(既有过渡态) · frontend_e2e ALL PASS(205 项) · audit_nodes ALL PASS(zf 3104/32·onno 2671/31·fg 3089/29+3 空,MCP 6/6×3) · priv_channel_audit PASS(66 站点 sha 全对齐零漂移) · ruler_recon PASS(R5 19 契约违约 0/R6 悬空 0/R7 契约 2+哨兵 9 张违约 0/R8 违约 0,registry 36 行↔带锚 36) · storage_fee_recon PASS(99 平)。今晚 19:10 UTC 夜跑首纳第 7 道+138 后全口径。

9.50 2026-10-25 L 备份去向拍板落地:venus 唯一异地,mercury 停推 ✅首推 11/11 逐字节验讫·KEEP=2·prune 先于 push·mercury 块 FROZEN·每日 03:30 自动

  • 拍板(用户 2026-10-25 三连令:「备份到venus服务器」+「不要在Mercury上备份了」+「1删/2先保留/3commit」) —— 2026-10-18 起挂账「备份去向(紧迫)」闭卷。分工:mars 本地 14 天全量(主)+venus 唯一异地(全系列最新 2 份+代码/secrets/采集器镜像);backup.sh 两处 mercury 块(dump 推送+代码镜像)FROZEN-20261025 注释留档停用,活跃行零 mercury 引用(语法核过);mercury 上已存的每系列 5 份旧备份用户令「先保留」原地未动。
  • Dell 信息答疑+清剿(用户问「怎么还有Dell的信息」→令删) —— Dell 字样只在两处冻结历史残留、无在役依赖:① mars crontab 的 FROZEN 注释行(记录旧任务为何停,非执行体,留档);② venus /opt/backups/offsite-222=Dell 时代旧管道(Dell 经 222 反向隧道推 zipforce_ba)最后三天 dump 实体(10-15/16/17 三份 17G)——用户批删,已删毕(删前三份清单核点,venus 释放至 26G 空闲)。
  • 容量裁定(工程面) —— venus 盘 79G:残留删除前仅 19G 空闲(KEEP=5/KEEP=3 装不下)→ 删后 26G 空闲 → 全系列 KEEP=1 升 KEEP=2(稳态 ~17.5G/空闲 ~18G;防单日坏档:N 损仍有 N-1),且 prune 先于 push 防瞬态超盘;venus 侧 prune 脚本(KEEP=2)永不触碰当日/未来日期文件。再升份数=加盘。
  • 落地与首推实证 —— backup.sh 唯一异地块(venus 故障只告警不阻断主备份);首推(11:33 UTC):11 库 dump 8.1G+代码镜像 1.3G,11/11 逐文件尺寸 mars↔venus 全同;mars↔venus 同机房段网络(8.1G/48s)每日窗口仅 ~1 分钟。11:54 补推增量(三笔 commit 后代码面)+11:55 审计页面目录入镜(用户批「需要」:zipforce-hub/audit.html 台账+audit-base+tar 快照原为 mars 独份盲区,独立 rsync 整体镜像 1.2G——不共用 --exclude backups 防连 saas 14 天 dump 一起镜像爆盘)。今晚 03:30 UTC 起自动首跑(venus-only+KEEP=2),明早晨检复核 backup.log。

9.49 2026-10-25 XLIX 批F 分层真源+视图烘焙恒等落地(调参层纪律入册) ✅迁移136·id26对齐+id16关联+id36·advisor/clean_audit改派生·R5扩容+R7/R8·六门全绿

  • 拍板(用户 2026-10-25「做」) —— 分层真源:口径层=metric_calibers(定义/公式/基准);调参层=ads_rule_config(只存 per-brand 覆盖,键目录须 ⊆ id36 册,值=基准的行应删);视图保持烘焙(值建迁移时写死于视图 SQL,不与注册表实时绑定——口径变更必须走「拍板+迁移+门禁」仪式,另两因=可复算性与权限面/故障耦合);任何第二份口径实现=缺陷(沿批A–E 总原则)。
  • 注册(迁移 136,metric_calibers 35→36 行) —— id26 bid_calc/noon:defaults 键名对齐 advisor 实名(target_acos_pct→target_acos)+recut_days 补册(代码冻结锚原漏册),值零变化,+layering 分层声明;id16 health_line:+scale_up_link(advisor SCALE_UP acos=25 与 acos_healthy 同语义关联);新行 id36 ads_rules_engine/all:调参层键目录 60 键(与 ads_rule_config as-built 恒等)+纪律(新键须先迁移入册;全局行 brand=''=基准/品牌行=覆盖;值=基准的品牌行应删)+consumers,锚 AC-ADS-04(批F 同步新增于 audit-base §5)。附 metric_calibers_id_seq 修复(批A–E 显式插 id 未 setval:last_value=21 vs max=35)。
  • 消费端改派生(两文件,冻结锚回退零行为变化) —— advisor.py:BID_DEF 九参+BID_GUARD 护栏改 caliber_filters("bid_calc","noon") 派生(容器内实证 BID_DEF==九册值逐键同、BID_GUARD==[0.01,200]);clean_audit.py:brand_fix sku_col 三面映射(amazon_orders→sku_list/ads_sku_daily→sku/amazon_ads_daily→advertised_sku)改派生(id30 platform 实为空串;沿用 guarded import 模式,宿主免 DB 环境零影响)。
  • 门禁扩容(ruler_recon R1–R8) —— R5 内联清零契约 6→19(批E 6+vat_withheld/vat_rate×3/settle_abnormal×2/inventory_alert_level×2/alert_thresholds/fx_pegged/bid_calc/brand_fix+health_line 三元 needle 同池专读);新 R7 视图烘焙恒等:orders/amazon 三视图+orders/noon 一视图 exclude_status 逐比较位双向恒等(兼容 pg 归一化三形态:<>ALL/ARRAY/=::text/NOT IN;自咬测试双向验证——单比较位删值与册外混入均被抓,并集式漏检已修为逐位相等);新 R8 调参层纪律:①键集恒等(ads_rule_config grp.key ≡ id36 catalog)②advisor _BID_DEF_FROZEN ≡ id26 defaults(ast 解析逐键双向)③tools/audit_clean_all.py 镜像 sku_col ⊆ id30。
  • 部署+六门(09:27 UTC,api+worker 重建,避开晨检/夜跑档) —— pen_tests ALL PASS · dashboard_audit PASS(单跑 FAIL 0;与 pen_tests 并行会被其末尾 logout-all 连坐吊销会话=假 FAIL×65,单跑即绿——运维坑同「e2e 与遍历不可并行」类)· caliber_recon PASS · ruler_recon PASS(R1–R8:R5 19 契约违约 0/R6 悬空 0·0/R7 违约 0/R8 违约 0,registry 36 行↔带锚条目 36)· frontend_e2e ALL PASS · audit_nodes ALL PASS(onno 2659/31·zf 3095/32·MCP 6/6)。
  • 挂账(本批新增) —— metric_calibers platform 惯例不一(空串 vs 'all':ids 3/6/16/29/30 存空串,caliber_filters 精确匹配调用方必须传存储原值;未来归一批);advisor _NOON_BID_DIFF=0.05(noon 官方建议采纳噪音门槛)未入册候选;ads_rule_config 今日全为 brand=''=基准全局行(R8 键恒等已执法;值=基准的行清理待品牌覆盖真正出现时一并处置)。

9.48 2026-10-25 XLVIII 批E 内联清零+门禁机器化落地(工程收口) ✅迁移134+135·id32–35·五处消费端改派生·R5+第6夜跑门·全门禁 PASS

  • 注册(迁移 134,metric_calibers 31→35 行) —— id32 asn_input/noon(P2-8 白名单正则+bad_asn 汇总);id33 upload_limits/all(三上传面:collab 15 类/50MB+ads 导入 3 类/50MB+listing 规格书 10MB;uuid 文件名/防穿越/RLS 三重不变量同锚);id34 net_margin_flag/all(AC-FIN-02 红旗阈值 50% 真源先行——无常驻消费端,未来复盘门禁须派生禁再发明);id35 ads_time_window/all(tz 双锚 Riyadh/Shanghai+from/to 精确窗优先规则)。改前快照 backups/metric_calibers-pre-134-20261025.sql+api-src-pre-batche-20261025.tgz。
  • 消费端改派生(五处,冻结锚回退零行为变化) —— noonops.py ASN 正则、collab.py 上传白名单/限额、ads.py 广告导入白名单/限额、listing.py 规格书限额、ads.py 时区锚(_noon_tz 派生+_daywin 默认参字面量清零+5 处 SQL 内嵌 'Asia/Shanghai' 字面量一并派生化);部署 08:04 UTC(避整半点/晨检后),容器内实证派生值==冻结锚(tz Riyadh/Shanghai·ASN 正则·15类/50/50/10)。
  • 门禁机器化 —— R5 内联清零核(INLINE_CONTRACTS 6 契约:消费文件必须含 caliber_filters 派生调用,缺=内联回退 FAIL);夜跑扩第 6 门:four_gates_nightly 19:10 UTC 顺次 pen_tests→dashboard_audit→frontend_e2e→audit_nodes→priv_channel_audit→ruler_recon(R1–R6 全量恒等+内联+引用);R3 立哨即抓 2 处即修(迁移 135:AC-ADS-01 行锚扩 id2,16,35 → id2/id16 ref 补 AC-ADS-01;多值锚格式归一数字型——'id' 前缀致正则截断)。
  • 部署后门禁 —— pen_tests ALL PASS · dashboard_audit PASS(WARN=挂账既有:soft-delete 过渡/回款滞后业务事实)· caliber_recon PASS · ruler_recon PASS(35 行↔35 行恒等·漏锚 0·R5 违约 0·R6 悬空 0)· frontend_e2e ALL PASS(206 项/0 FAIL,含评分面 AC-CAL-17 断言收敛 as-built+反向执法两新断言过)· audit_nodes ALL PASS(三租户遍历,t1 3093/t2 2659 数值节点)。
  • 尺子陈账清点(评分面辐射面) —— e2e 陈账追溯发现 §11 AC-EL-RANK-046..055 十条仍描述 10-24 已删聚合族(KPI 平均评分加权/评论总量 Σ/评分分布/评论数量分布/BSR 分布/品牌对比 9 列/noon 追加行/30 天双轴 avg-sum 趋势/Top15)——状态随修随换违背,十条同刻标 已删·AC-CAL-17+溯源注记(RANK-045 快照日期/RANK-056 脚注/RANK-057 白名单口径仍活未动;尺子行内旧代码行号引用属描述历史,ID 永不复用)。
  • 晨检 FAIL 陈账修正(同刻处置) —— 08:00 晨检四层[web] e2e「排名: 评分与评论 tab 缺区块」:页面 10-24 已按 AC-CAL-17 改采集原值直读(聚合区块删除=拍板行为),e2e 断言仍是旧聚合面=门禁陈账 → 断言改 as-built+反向执法(平均评分/评分分布/评论数量分布/品牌对比四聚合字样再现即 FAIL)。

第10节 2026-10-21/22 round2 审计修复线全量交付(v2026.10.21-round2-audit-fix)

修复线交付记录 · 依据 round2-audit-findings.md 全量清单(P0×12→P1×21→P2×36→P3×13 顺序执行)· 处置账以「代码即账」为准(P0-xx/P1-xx/P2-xx/P3-xx 注释标记全库可查)· 四门禁终验 2026-10-22 00:0x UTC

10.1 清单处置总表 P0×12 清零 · P1 20/21 · P2 11修+2销项 · P3 12/13

  • P0×12 全清 —— P0-1 review-ai country 注入→白名单+三租户线上 400 复测;P0-2 回溯 expected str not list 活 bug 修复+小窗真实回溯验证;P0-3 回溯回滚跨平台误删防护;P0-4/P0-5 净利重造:promo/服务费/广告进 finance 层+net_profit 更名(onno 2026-08 虚高实测 $5,934=promo −7,983 未进层主因,已修;zf 服务费月均 $4.4k 入扣;审计线 4844.11 系 JPY 混币裸加,zf 2026-09 真值 −728.73 更正在案 finance.py:74-80 注释);P0-6~9 四件宿主/解析台账补登记;P0-10 internal 5 GET 端点入账;P0-11 租户子域 /audit/ 收口(changelog 子域=用户指定发布渠道不动);P0-12 agent-console 口令更换+备份清理。
  • P1×21:20 修+1 挂账 —— 已修:P1-1 NoonTab 品牌死锁、P1-2 onno 广告停更告警(授权依赖按用户 2026-10-17 令搁置不动)、P1-3 特权通道强制层+调用点账本(64 站点)、P1-4/5/7 回溯快照/生效/对账门禁、P1-6 库外操作调查、P1-8 净利口径统一(fm 权威+退款净流出)、P1-9 停用租户断流、P1-11/12/13 台账同步+僵尸清理+四门禁夜跑 crontab、P1-14/15/16 E2E 覆盖扩展(201 断言+平板 768+负向输入)、P1-17/18 广告双源分歧调查修复(P1-18 全完结:代码已修+staging 全窗重建 2026-10-23 用户放行执行——263,187 行清空重灌 138,712 行(孤儿/退役词表占比 47% 绝迹),zf 9月 sp AE=3746.81/SA=22868.08 与 mars 分毫不差,cleaned onno 677.82 达预期,删前备份 noon_ads_daily-pre-rebuild-20261023.csv.gz,重跑 dashboard/chart/pipe 门禁仅余在案外部项)、P1-19/20 迁移账本+回滚锚点(VERSION 自 09-24 以来首次更新)、P1-21 审计 before/after 快照。P1-10 已闭卷·9.73 查证:dispatcher cron 2026-10-15 用户令 FROZEN(选品分发器 09-04 起空转 6 周零成功、任务表仅旧 portal 读、SaaS 不读)+mercury 备份角色 2026-10-25 拍板终止——「退役矛盾」在活态已不存在(cron 注释在案 host-crontab,ssh 别名 mercury 仅历史兼容)
  • 【本行速览】(2026-10-24 导航增设)P2 线 36/36 闭卷=已修 24+销项 6+用户拍板 6(逐项枚举见本行正文)。本行另含两件独立大交付:#61 注册表脊柱一期 A+B(endpoint_registry 215 行入库=第四道门登记基准;口径值入库派生——剔取消谓词 20 处/fx 锚/告警线/VAT/健康线全改 metric_calibers 单源下发)与 #62 audit_nodes 三租户化(第四道门 zf/onno/fg 三租户 ALL PASS,基准断言 32→92)。行内各件(P2-23 cron 账本/P2-11·13·20 回溯加固/P2-6 internal 认证/P2-31 CSP/P2-10 授权回收/P2-16·18·36 规格包)均自带部署与门禁详录,按需检索。
    P2×36:已修 24+销项 6+用户拍板 6(P2 线 36/36 闭卷,2026-10-23 12:0x UTC 更新) —— 已修(代码标记在案):P2-2 ADS_SOURCES 矩阵、P2-3 onno noon 广告双源、P2-4 fg 伪国家折叠、P2-5 三品牌硬编码、P2-8 asn_nr 二阶注入、P2-9 collab 黑名单、P2-12 worker 审计 user_id、P2-21 aba-monthly 窗口误判、P2-24 audit_nodes 僵尸条目、P2-26 EXCLUDE 豁免门禁、P2-33 rankings 重复键、P2-23 cron 漏跑账本全覆盖(2026-10-23 用户「全干」放行:_WATCHED_SLOTS 6→35 全部 cron 档入水位账本,missed_slot_sweep 每 10 分钟按档期 gap 补跑,sourcing_dispatcher/promotion_send/promotion_imap 三 tick 补挂 zlog 生命周期+死信,部署 05:06 UTC 验证 md5 三方一致+05:07 sweep 播种 35 键零补跑风暴,快照 code-20261023-pre-p223-api.tar.gz)、P2-11/13/20 回溯加固包(2026-10-23「全干」放行:P2-11 同窗重复护栏=同 (brand,platform,task_type,from,to) 已有 queued/running/done 正式执行默认 409+force=true 显式放行(dry-run 预演不限次),线上实测复打 run=189 得 409 含指引;P2-13 品牌级 advisory lock(bf:{brand} try 型会话锁)快照→执行→回滚全程持锁,封死 tenant_sem 按 task_class 隔离的盲区(异类回溯同品牌可并发互踩),清洗侧=每表全量换名重建(表粒度)由既有 lock_timeout=5s 跳表兜底,cleaned 派生层每轮自 raw 重建自愈+raw 层 P0-3 后回滚永不触碰=无持久丢失;P2-20 同窗并发交织随品牌锁关闭、快照分片 per-run 幂等续传;残留两条挂 P3 候选:崩溃残片快照清理、stale-running 回收器(均已由同日「都修批」④⑤销项:backfill_hygiene 日档 07:37);快照 code-20261023-pre-p2113-api.tar.gz,门禁 pen ALL PASS+dashboard 仅在案外部项 X2 16G/3 WARN)、P2-6 internal 容器网认证(2026-10-23「全干」放行:5 个 /internal/api/v1/* 端点加服务间认证 X-Internal-Auth=HMAC-SHA256(global_secret,'internal-api-v1') constant-time 比对,与 Caddy 公网 404(ARC-01)构成双层——容器网内任意进程不再仅凭 X-Tenant-Id 读任意租户聚合;token 同源派生不外发、不造新密码文件;audit_nodes 探针(api 容器内执行可读同 secret)本地计算发送;worker 进程内 import domains.* 不走 HTTP 零影响;部署 05:44 UTC 实测无头 401/坏 token 401/好 token 200,md5 af49f4d8 一致,nodes+pen 门禁 ALL PASS,快照 code-20261023-pre-p26.tar.gz)、P2-35 trace 链路贯通(2026-10-23「全干」放行:前端 components/kit.tsx 一次性 fetch patch——全部 /api/ 请求注入 x-request-id(标签页种子 sessionStorage.zf_trace),响应 id 领养回存,同标签页全部请求共享一个 trace_id;lib/fmt.ts 失败请求 console.warn 带 trace(用户报障报这一行即可);api 侧 zlog_access_middleware 已有沿用/回带逻辑零改动,Caddy 双侧头透传实测证通(核心版无 uuid 生成能力,锚点定在 api 边);浏览器实测:种子领养 ✓、/ads 页 4/4 请求同种子回传 ✓、api 日志 7 行命中同一 trace ✓、frontend_e2e 201 断言 ALL PASS(快照 code-20261023-pre-p235-web.tar.gz)))、P2-31 CSP nonce 化(2026-10-23「全干」放行:web/middleware.ts 重写——全路由每请求生成 nonce(crypto.randomUUID)、请求头注入 x-nonce+严格 CSP、响应头下发 script-src 'self' 'nonce-{随机}' 'strict-dynamic'(去 unsafe-inline/unsafe-eval,应用面零外部脚本/零 eval,echarts 打包自渲染);Next(15.1.6) 实测不会自动从 CSP 头提取 nonce 打标——必须 app/layout.tsx 读 x-nonce 挂 ,SSR 才会给全部引导脚本+内联水合脚本(self.__next_f)自动打 nonce;Caddy 网关宽松头保留(changelog/audit 静态归档面内联脚本依赖),浏览器多 CSP 头取交集=应用路由按严格者执行,Caddyfile 零改动;matcher 从 {/,/welcome} 扩至全页面路由(静态资产/SEO 文件除外)。浏览器实证(tools/_p231_csp_probe.py):租户面 6 页 login/工作台/dashboard/ads/finance/inventory 严格头逐页新 nonce、SSR 原始 HTML 全部 script 带 nonce 且与头一致(活 DOM 因规范 nonce 隐藏不可读,以 curl 层为准)、水合真实发生(window.next)、工作台 80 个 echarts canvas 全渲染、控制台零 CSP 违规;frontend_e2e 204 断言 ALL PASS。快照 code-20261023-pre-p231-web.tar.gz。教训留痕:首部署仅改 middleware 未挂 ,07:18-07:24 UTC 约 6 分钟窗口浏览器侧内联水合脚本被严格头拦截(SSR 壳可读、客户端交互/图表断),curl 无 JS 执行故未拦住——CSP 类全局响应头改动必须浏览器级实证后方算交付,已按此补验)、P2-16/18/36 口径规格包一批执行(2026-10-23 12:0x UTC 用户令「按建议」拍板 A/A/A,详见下三条;规格包 p2-spec-package-20261023.md 闭卷)、P2-10 portal_app 残留写授权回收(2026-10-23 09:5x UTC 用户令「按建议执行」放行:实证 4 表(findings 记 3 少了 aba_ac_dict)api_fields_catalog(D/I/U)/audit_results(I)/promotion_crawl_stats(D/I/U)/aba_ac_dict(I) 全部 REVOKE,SELECT 全保留四读面零影响;写入方全 saas_admin(four_layer_audit 06:35 cron/apifields_snapshot/promotion_refresh/aba-refresh 日更+月度),worker 合法路径 fx_rates INSERT/UPDATE 不在回收列;default ACL 无写自动授予不长回。验证:四表 portal_app 仅剩 4 行 SELECT、SET LOCAL ROLE portal_app 写探针 permission denied、saas_admin 写通路完好(探针过 ACL 止于测试列 NOT NULL,事务回滚零残留)、pen_tests ALL PASS(含 M 项全基表 SELECT 金丝雀);audit_log trace=p2fix-20261023 留痕,回滚=rollback-grant 文件+授权快照 backups/portal-app-grants-pre-p210-20261023.txt 在册,pending-db-ops 台账 A/B/C 三项全部闭卷;销项:P2-17(CSV 队列必败场景被 P2-2 创建期拦截链整体覆盖)、P2-30(与 P0-11 同源,changelog 子域按用户令不动)、P2-28/29(2026-10-23 门禁三租户覆盖:dashboard_audit 三件套C 192+→198+、frontend_e2e 第 21 节 fg 品牌看板双页 ALL PASS、chart_value 注册表驱动无参即三租户;AC-GATE-07 立册 audit-base v5.11)、P2-1(2026-10-23 用户放行执行:backfill_runs.103+listing_tasks.48 两行孤儿删、审计留痕 p2fix-20261021;listing_events 5 行子事件按库内 append-only 触发器设计保留)、P2-34(2026-10-23 用户放行执行:audit.dirty_data_log 2000 万行清壳至 7 天保留窗 3625→856MB,swap 式 TRUNCATE+回插逐日计数与删前逐字节一致,删前备份 backups/dirty_data_log-pre-purge-20261023.csv.gz 15,681,271 行,补建 idx_dirty_created,每日 07:27 保留任务 dirty_log_retention 上线——表曾 35 天攒 2000 万行失控根因=清洗每批重记同一脏条件,未修复脏条件近 7 天必有余迹故 7 天窗无信息损失)。用户拍板 6:P2-7/15/19/22/25/27;口径规格包四项(p2-spec-package-20261023.md)2026-10-23 全部落定:P2-14=C、P2-16/18/36=A(用户令「按建议」),均已当日执行(见下四条)。注册表脊柱 #61 一期 A 已落地(2026-10-23):public.endpoint_registry 入库 215 行(api197+internal5+豁免前缀13,pg-init/107 迁移+种子)=audit_nodes 第四道门登记基准的库内单源——替代 backups/audit_nodes_snapshot.json 相对路径快照,根治坑13(cwd 依赖/陈旧快照/多副本漂移:仓库根/tools//tmp 三 cwd 实测 ALL PASS 同口径);门禁改 docker exec 容器名直连不再经 compose 项目解析;结构性护栏升级——注册表新增 exclude 豁免行会让既有端点变 stale 必 FAIL,增豁免不可能静默;一期 B 口径值入库派生化同日落地(#61B):全库侦查(metric_calibers 实有 19 行,结构化数值仅 id8/id16)→ pg-init/108 迁移把已冻结于代码的口径值原样入库(id6 fx_pegged 补 peg 结构化数值=H2 冻结锚 3.75/3.6725/6.7963、id12 补 urgent_days=35/watch_days=90、id16 补 waste_spend=20、新行 vat_rate/noon SA15%/AE5%=2026-10-09 用户令原值;全部零行为变化+audit 留痕 p2fix-20261023+序列号 setval 修复)→ 读面/门禁全面派生:①剔取消谓词单源化——audit_nodes(8 处)/dashboard_audit(10 处)/chart_value_audit(1 处)/caliber_recon(1 处)共 20 处内联 2/3 拼写混用('cancelled' 小写漏剔=假基准偏差)全部改引 id4 exclude_status 数组(表不可达回落 3 拼写同值);dashboard_audit 顺手坑13 根治级联(compose exec→docker exec 容器名直连);②回款异常线 sync_source 三模板 >14→id8 threshold_days 派生+ai.py 标签同源;③fx 锚 core.py RMB_USD/FX_PEG 改 id6.peg 下发(import 期读表+冻结锚回落)+rules_ads.py:119 兜底 6.80 与冻结锚 6.7963 分叉修正(H2 禁再内联收尾,fx_rates 空表时 RMB 成本折算偏差 ~0.05% 消除);④ads.py 搜索词 5 处内联 spend>=20/>=4/<=25(H6/C2 收编漏点:判 verdict 的 SQL 与 python _verdict 分叉)→health_line 派生(waste_spend 新键自动生效);⑤noon VAT 四副本(finance 双常量+月表 SQL CASE/dashboard vat_up/sync_source 月度模板)→vat_rate/noon 单源;⑥dashboard 告警线 0.4=acos_watch/100 复刻收编+EU+UK 国集(sync_source _FEES_VAT_EU_CC/MP)→id14 set_eu_uk 下发(MP 名映射留码拼写层);⑦core._ALERT_CTE 35/90→id12 下发。部署 07:01 UTC api+worker 双镜像 md5 三方一致,容器内 import 实测全部派生值与原字面量逐位相等,被改 SQL 真实执行验证(ads verdict 聚合 277 万行/finance 月表视图/告警拼装),门禁 nodes ALL PASS(202 端点/3054 节点)+chart_value PASS(80 图 0 FAIL)+pen ALL PASS+dashboard 198+ 仅在案外部项 X2 16G;快照 code-20261023-pre-p61b-{api,tools}.tar.gz。遗留进拍板包:告警参数族(>60/spends>5 等)未注册、advisor 规则默认值源设计(租户配置层 vs caliber 层)、noon cancelled 拼写未注册(id5 无 exclude_status)、web 展示字面量(后端稳定后)——四项余量已于同日 12:1x-12:5x UTC 用户令「接受」A/A/A/A 全部执行闭卷(见下条),#61 注册表脊柱线就此收官。
    #62 audit_nodes 三租户化交付(08:0x UTC,AC-GATE-07 残余缺口清零):第四道门从单租户(t1)扩三租户同面探测——凭据目录 secrets/audit_tenants/*.env 遍历(chart_value_audit 同款,新租户放 env 即自动入册)、tenant_id 从 tenants 表查得(注册表=DB 模式零硬编码);AB/NR/SO 域+promotion 基准全部 tid 参数化(40+ 模板);promotion_orders items[0].id 补租户过滤(原裸 min(id) 在他租户面会取 zf 首行);空态规则=节点缺失且基准 0/NULL 视为双侧皆空通过(空租户面不假 FAIL),缺失而基准非零仍 FAIL;NULL 吞没修复 3 处(rev30 两加数项 coalesce——fg 无 noon 时 CASE ELSE 内 sum 无 coalesce 把 amazon 真值 32206.13 吞成 NULL、noon 平台 ad_spend 对齐混合面同款 coalesce、amazon.cur.revenue 同型预防)+finance months[0] 月轴数据驱动重锚(onno 4 个月面 months[0]=2026-07,原日历 11 月前锚恒 NULL 假 FAIL;zf 11 个月前有单=锚不变值不变)。终验三租户 ALL PASS:zf 32 基准(与重构前逐项同值)/onno 31/fg 29+双侧空 3,基准断言总量 32→92,采样节点面 3054→8794;迁移 109 endpoint_registry tenant_scope 202 行 zipforce→all(登记语义+audit 留痕);四门禁至此全部三租户。快照 code-20261023-pre-t62-tools.tar.gz。
  • P2-32 mapping 双租户重复行去重交付(2026-10-23 10:10 UTC,用户令「按建议执行 P2-32」放行):裁定删除 sku_mapping 5 SKU(ON3720SEU/ONQ2001EU/ON1020SEU/ONG25X0EU/ONY2002EU)×EU×Amazon 的 zipforce 侧 5 行——mars 真值 shared.mapping_zipforce 此 5 SKU 零行/shared.mapping_onno 各 1 行,onno consignment(t2)=正身保留。执行=事务 SQL 文件(backups/p2-32-dedupe-20261023.sql)+删前备份(backups/sku_mapping-p232-zf-dupes-20261023.csv.gz)+逐行留痕(audit_log 30053-30057,to_jsonb 全行快照,trace=p2fix-20261023,回滚=备份原样回插)。验证:zipforce 残留 0、全表 (sku,platform,country) 重复组 5→0、总量 1337→1332、5 SKU 现仅 onno:consignment 单行。根因机制定位:clean_audit 品牌纠正映射 sku_brand_map 为无 ORDER BY 的 dict 覆盖构建(api/clean_audit.py:529),双行 SKU 取"后到行"=非确定翻牌,删行后确定 onno。9 单甄别闭环:8 单 zf→onno(5 SKU 触发)+1 单 onno→zf(ZFC06TEUBE 单行正身 mapping、zipforce 产品走共享账号的正常纠正,与重复无关)与 dirty_data_log 全部对上。收敛实证(修复连带的两个缺陷后全层重建):cleaned_amazon_orders 404 行/$15571.89(+3 当日新单全 onno)、cleaned_ads_sku_daily 996/$1986.03 逐位一致、order_items/sku_fin 同轮 brand_fix 方向全 onno。下游孤儿未随删(铁律不可误删):products id342-346(zipforce×5 SKU,listing 引用 0)+ inv_products t1 5 行(单据引用 0)已随 D 项于同日 11:5x UTC 用户放行执行完毕(audit_log 10 行留痕 trace=p2fix-20261023,删前备份两份 CSV,验证 zf/t1 残留 0、onno 正身 5+5 完好,dashboard 门禁复跑与删前逐项一致零新增——孤儿若留反而会新增"镜像有成本但 mapping 无权威"WARN 类)。
    连带缺陷修复 2 项(诚实留痕):① #61B 回归——sync_source.py 动态 spec 路径(_refresh_dynamic_specs 三处 format)漏传 th= → KeyError('th'),小时摄取自 07:05 UTC 起连续失败(3 天窗增量、无数据损失,修复后 11:0x 全绿);教训:模板占位符改动必须真执行"运行时重写路径"(import 成功≠懒执行 format 成功),已入实操坑册。② views 二期回归——cleaned_* 上的视图按 OID 钉住物理表,_swap 换名后 DROP _old 被 pg_depend 拦截 → orders/ads_sku_daily 清洗整表失败回滚(清洗层自视图落地起冻结);修法=_swap 依赖感知重绑:pg_rewrite deptype='n' 递归登记全部直接/间接依赖视图(注册表驱动零硬编码清单),深者先 DROP、换名删 _old 后按依赖序重建并还原 security_invoker/SELECT 授权/视图与列注释——视图永远钉在"当前叫 cleaned_X 的表"上;tools/audit_clean_all.py 同款同步修。过程事故留痕:重绑初版递归 CTE 漏 deptype='n' 过滤,视图 _RETURN 规则对自身的 deptype='i' 依赖边造成无限递归(烧 CPU 约 5 分钟,cancel+杀探针进程收尾,库内原子回滚零残片);修正后单测(statement_timeout=5s 秒回、依赖树与报错清单逐项吻合)才重建部署。终验:ingest_today 全绿(orders 6246/noon_orders 8646/inventory 8978/sales_hourly 3353)+三表补清 3/3 成功;9 视图全属性复原(security_invoker+portal_app/mcp_read 授权+注释)且活查询吃到新数据;门禁 pen ALL PASS+dashboard 198+ 仅在案外部项(X2 16G 用户挂账+3 成本主数据 WARN)。快照 code-20261023-pre-p232fix-api.tar.gz,部署 10:44/11:0x UTC(避开广告档)。
  • P2-14 财务基准差双基准并行登记交付(2026-10-23 11:0x UTC,用户令「按建议执行 P2-14」拍板 C):定性收口——fg≈−15%/onno≈+23% 的财务差=两品牌财务基准不同的实测结果,非错账;全库无任何调整因子(metric_calibers 20 行无一 adjuster),审计记录"±% 调整因子"表述不成立。基准归属(sync_source 证据链):fittingirls=现金/结算基准(settlement items 按 posted_date 归期,_FIN_BRANCH_VIEW 走 source_map.finances_view;结算滞后+退款冲抵→比订单口径低≈15%);onno=权责/订单基准(v_onno_orders_unified 订单时点确认收入,settled=订单金额派生标记非结算事实,官方 net_usd 全空走 (revenue−|fees|−|promo|)/fxd 回退公式→比现金口径高≈23%);zipforce 归属权责(_ORDERS_MASTER_TPL COALESCE 序=订单时点重算优先(R15 ot.amt/fxd 逐日),结算事件+settlement_* 列兜底并存,主口径=订单时点)。执行=注册表两行(pg-init/110 迁移):id21 finance_basis_cash/amazon brands=[fittingirls] + id22 finance_basis_accrual/amazon brands=[onno,zipforce]——规格包原文「caliber=cash/accrual 两行」按实际 schema 适配(表无 caliber 列,基准承载于 metric 键、品牌数组在 filters jsonb,(metric,platform) 唯一键两行 metric 不同共存;108 同款 setval 对齐+ON CONFLICT 幂等);删前备份 backups/metric_calibers-pre-p214-20261023.csv.gz+audit_log 留痕(action=p2fix.p2_14_basis_registry,trace=p2fix-20261023)。消费端:core.finance_basis()/finance_bases() 注册表派生(复用 caliber_filters 进程缓存+冻结锚回落 _BASIS_FALLBACK,表不可达不炸;noon 平台未登记→空,留待单独拍板批);finance 读面 9 端点打 basis 标签——summary/sku-profit/kpi-wall/full/product-pl(amazon)/monthly/profit-matrix 顶层 basis map + onno amazon main/ads 两视图 {"onno":"accrual"},全部附加 JSON 键零数值改造(无 SQL 触碰金额列)。口径规则入册:跨品牌横向对比仅同 basis 内成立。验证:9 端点 200 全带正确 map(fg=cash/onno=accrual/zf=accrual);pen_tests ALL PASS;dashboard 198+ 仅在案外部项(X2 16G+3 成本 WARN)零新增;worker 容器 core 派生实测同值。A 项(fg 应计推导公式)=二期届时单独拍板。部署 10:59-11:0x UTC api+worker 双镜像(避开广告档/整点半点),快照 code-20261023-p214-registry-api.tar.gz。
  • P2-16 订单状态轨迹表+append-only 触发器交付(2026-10-23 11:1x UTC,用户令「按建议」拍板 A):现状=90 天窗刷新 ON CONFLICT DO UPDATE 每轮覆盖 order_status/status_cn/shipped_date,状态变迁历史全库无处落——"这单何时从 pending 变 shipped"不可回答。执行=pg-init/111 迁移:public.amazon_order_status_log(brand,amazon_order_id,old_status,new_status,changed_at,source)+AFTER UPDATE 行触发器 WHEN (OLD.order_status IS DISTINCT FROM NEW.order_status)——只记真实变迁,金额列覆盖(sync_source:1929 只碰 revenue_usd/local_amount)与同值写不触发,P2-13 快照回插 ON CONFLICT DO NOTHING 状态不变不触发(零污染);挂载面=public.amazon_orders mirror 层(audit.cleaned_* 为每轮换名重建层,触发器随表消亡,不挂);append-only 守卫=BEFORE UPDATE/DELETE RAISE(listing_events _listing_event_immutable 同型先例,铁律"不可误删")。验证:saas_admin 与 portal_app(SET LOCAL app.tenant_id 过 RLS)双写路 UPDATE 1 触发 INSERT 落行实证+改回再验+守卫拒改拒删+事务回滚零残留;变迁前历史不可补,轨迹自本迁移起算,真实变迁自 12:05+ 摄取周期自然累积。
  • P2-18 采集 run 结构化账本 collection_runs 交付(2026-10-23 11:2x-11:47 UTC,用户令「按建议」拍板 A):现状=采集可观测全靠 stdout 翻容器日志,失败无法门禁化。实况修正(对规格包):P0-2(2026-10-11)已把 SaaS→/opt/collection 全部 subprocess 收敛为 tasks.py _arun 单点(唯一 subprocess.run,14 个采集域函数调用;规格侦查记的 17+1 调用点被代码实况取代)——wrapper 落 _arun 即全覆盖、零调用点翻改,backfill.py 无采集缝。执行=pg-init/112 表(task=调用函数名 sys._getframe(1)/site=argv[2] 适配器名即 brand×platform 载体/exit_code/duration_s/rows=stdout 正则 best-effort/error_digest 尾 400 字/trace_id=zlog)+_arun 计时落行(含 TimeoutExpired 落 exit_code NULL+超时摘要再 raise;观测永不杀管道=落行异常仅 stderr)+保留窗 30 天并入 dirty_log_retention(同任务顺带清)+pipe_morning_check 第 5 面(四面→五面):近 24h 非零退出/exit_code IS NULL 即 FAIL 逐行列出,24h 零行 WARN(账本断流或采集停摆,缺跑面兜底);引擎本体(/opt/collection 只读挂载)零改动。验证:portal_app INSERT 授权探针过(worker _pool 同身份)+容器内 import 实测+部署 11:47 UTC 后采集周期真路落行(首批行见下方追记);晨检次日起第 5 面生效。
    追记(12:00 UTC 档首批行落地):collection_cycle_ads_snapshot / ads-snapshot, exit_code=0, 63.01s, rows=789——单 subprocess 链路真路落行实证,task/site/计时/行数四字段全对账(截至 12:56 UTC 累计 6 行 6 零退出,随采集周期持续累积;晨检第 5 面次日起读表)。
  • P2-36 DELETE 分级注册表+sku_mapping 删除守卫交付(2026-10-23 11:35-11:52 UTC,用户令「按建议」拍板 A):口径=不是禁 DELETE,是哪些表许物理删/须 append-only/须软删首次成文。实锚=运行时静态删除口 45 处(37 表名;规格包记 49 为审计估算数)+动态缝 4 处(sync_source _snapshot_reconcile 7 张对账表/backfill 回滚面仅 audit.cleaned_*/clean_audit 换名重建层/tasks.py offboard_purge 全 tenant_id 表级联)。执行=pg-init/113:public.delete_policy 48 行——immutable 3(listing_events/sku_mapping/amazon_order_status_log)、soft 30(users/user_brands/tenants/po 系/promotion×10/report_defs/neg_keywords/ads_rule_config/aplus×2/keepa_watch/upload_files/listing_tasks/pm×2 等业务实体,渐进加 deleted_at,未改造=门禁 WARN 过渡态)、hard_ok 15(对账删×7/缓存 aba×2/保留窗 dirty_data_log+collection_runs/dry-run runs/重算建议/改名映射+audit.cleaned_% 前缀通配);sku_mapping 守卫=BEFORE DELETE 触发器拦裸 DELETE(UPDATE/INSERT 合法:parent_asin 同步/listing 列编辑/onboarding 种子/编辑器重插);放行 GUC app.allow_guarded_delete='on'(仅 SET LOCAL 事务内)三缝=①ops.py 映射编辑器全量重写(:284 实况=先删后插的保存缝非独立删除口——对规格包"优雅报错"设想的实况修正,编辑器行为不变)②tasks.py offboarding 级联拆除(listing_events 带 tenant_id,原触发器 UPDATE/DELETE 恒拦会撞死级联=潜在断点,守卫函数换体补 DELETE 放行口、UPDATE 仍恒拦,触发器本身不动)③裁定式去重 release SQL(P2-32 型)。
    守卫函数 NULL 陷阱实测教训:current_setting(guc,true) 未设返回 NULL,NULL<>'on' 为 NULL 不走 RAISE——首测 155 行裸穿;coalesce 兜底后四向实证(sku_mapping 裸删拦/GUC 放行删过/listing_events UPDATE 恒拦/listing_events GUC 删过,全部事务 ROLLBACK 零残留)。门禁新面=dashboard_audit 检查 9:静态扫 api/**.py DELETE FROM 对注册表(含 % 前缀通配),未注册/immutable 命中=FAIL(ops.py 编辑器缝白名单),soft 未改造=1 条汇总 WARN——实测 45 处静态删除口全合规 0 FAIL。部署 11:47 UTC api+worker;验证 pen ALL PASS 221+dashboard 仅在案外部项(X2 16G+3 成本 WARN+新增 1 条 soft 过渡 WARN=设计形态)。快照 code-20261023-p218-collection-runs.tar.gz+code-20261023-p236-delete-policy.tar.gz。soft 30 表 deleted_at 渐进改造=后续小批。
  • #61 余量四项执行闭卷(2026-10-23 12:1x-12:5x UTC,用户令「接受」拍板 A/A/A/A,规格包 p61-leftovers-spec-20261023.md):项1 告警参数族登记=pg-init/114 新行 id23 alert_thresholds/amazon(window_days 30/min_spend_usd 100/acos_alert_pct 60/acos_high_pct 100/stock_days_low 7/stock_days_critical 3)+id24 alert_thresholds/noon(window_days 30/min_spend_acos_usd 10/acos_high_pct 60/min_spend_zero_usd 5/zero_window_days 14),dashboard.py 告警块 _alert_th() 逐键派生+表不可达回退同值(_VAT_UP 同范式);范围口径入迁移注释:计数类结构语义(长仓 365/SKU 数>5>10/零动销 qty>10/评分 3★·0.15/ROAS spend>50·roas<1.0/noon sellable≤5/BuyBox 0.3·3)=规则结构非阈值族不登记留代码;noon 高 ACOS 线本体=_ACOS_WATCH(health_line acos_watch)属全局健康线层不重复登记(id24 semantics 注明)。项2 advisor 两层设计确认=_rule_cfg 上注释成文:全局口径层 metric_calibers(health_line 派生)vs 租户策略层 ads_rule_config(_rule_cfg/_f 平台/品牌可覆盖)两层语义不同不混表;SCALE_UP `_f(r,"acos",25)` 默认 ↔ acos_healthy(=25) 语义关联仅注释不派生,零行为。项3 noon 剔取消谓词注册=id5 orders/noon 补 exclude_status=['cancelled'](数据实证全库 item_status 仅 6 值全小写无 'Cancelled' 变体——注册=现行为单源化,大写变体从读面谓词自然消失);audit_nodes/dashboard_audit 新 _xc_noon()→XN 单源(表不可达回落双拼写),3 处 noon 内联改引(nodes totals.noon.units、dash sku-matrix 营收/件数两处)+dash canc 计数器三拼写 IN 改引既有 XC;undeliverable(5022 行)排除=独立口径题另议未并入。项4 web 展示字面量下发=/api/metric-thresholds 附加 urgent_days/watch_days(id12 派生,缺失回退 35/90)+waste_spend 原已随 health_line 下发;fmt.ts Thresholds 扩三键;ads 页 3 处改引(零转化浪费"≥$20"→th.waste_spend、出价建议"??25"→??th.acos_healthy、帮助文案 40%→acos_watch/25%→acos_healthy×2——$15/点击≥5/4 折/1.25=advisor 规则层文案按项2 两层设计不动);inventory 页首次接入 useThresholds:35/90 天线表头+补货口径/缺口合计/表 caliber/算法 5 处文案全部 ud/wd 派生,need35/need90 API 键不动。
    执行时事故留痕(诚实记录):amazon ACOS 谓词参数化首版参数序错位(acos_frac 落入 bf 品牌槽→SQL 异常被既有 except:pass 吞→连接事务中止殃及同请求后续全部告警块,platform='' 面板静默归零)——真路径探针抓到("空面板≠无数据":吞异常与零数据在告警面不可区分,教训与 P2-32 连带缺陷①同课不同型:彼为懒执行路径漏传参,此为静默吞异常链掩盖中止态);修序后复测 zf 全平台 10 条/onno 4 条告警(noon 广告/库存/amazon 库存三类真数据回归)。部署 12:31 UTC api+worker+web(web build=TS 门禁)+12:35 修版重建;门禁四道全绿:pen 221 ALL PASS、dashboard 198+ 仅在案外部项(X2 16G 用户挂账+3 成本主数据 WARN+1 soft 过渡设计态 WARN;delete-policy 面 45/45)、frontend_e2e ALL PASS(含 fg 面)、audit_nodes zf 3044 节点/32 基准 ALL PASS(XN 新谓词真路对账)。快照 code-20261023-p61leftovers.tar.gz。
    新发现挂下批:dashboard_audit _npl9ad noon 佣金折算 CASE 1.15/1.05 仍未派生(vat_rate/noon 已注册、#61B 侦查未及的读面漏点,小批改引)——已由同日「都修批」①当日销项。
  • 都修批执行闭卷(2026-10-23 13:0x-15:0x UTC,用户令「都修」=修尽当时在案的已知可修项;备份档 douxiu-20261023-cost-backup.md+快照 code-20261023-douxiu-pre.tar.gz):① _npl9ad vat 派生=dashboard_audit 新 _vat_noon()→VN(id20 vat_rate/noon {SA:0.15,AE:0.05} 派生 CASE,表不可达回落 1.15/1.05 字面量;标签文案同步 VN_TXT 派生),容器外进程实测 VN=AE1.05/SA1.15 与原值逐位相等(零行为变化)。② X2 16G 成本对齐权威=mars zipforce_noon_procurement_cost id12 cost_sar 105→95(note 留痕「2026-10-23 105→95 对齐 sku_mapping 权威=95(用户令都修)」,X2 8G id26 2026-09-26 拍板留痕同型)+worker ingest_all 重灌镜像 → 成本对账门「X2 型单边改价」FAIL 当轮清零。
    ③ 3 SKU 成本权威——侦查翻案:拉全量后发现两个「缺行」实为拼写错位(非缺行)——Airfit Neo:权威 sku_mapping 存在但拼作 Airfirt Neo(笔误,×2 行 SA/AE@23.52,sku/nsku 与 mars sku_mapping 逐位一致)→ UPDATE 权威改正拼写(product_name+model_name,24 列文本列全库扫描零引用,visibility 触发器正常通过);S-988 Pro:mars procurement id15 孤例拼写,权威+mars sku_mapping 双方共识皆 998Pro@175 → UPDATE mars 改名对齐共识+镜像重灌+残行清除(spec 表 upsert-only 同步不回收旧主键行——镜像 (brand,product_name) 主键改名后旧行残留会续 WARN,人工清 1 行留痕);Keyboard 35.00:2026-08-01「estimated 30% of avg price」估值批残留(同批 Bento/Water Bottle/iPhone Case 均已按估值建权威行故不告警),权威键盘族 4 型全有真值(Cyber Line 107.36×6/CX22 119.69×2/G502 159×2/Cyber Max 240×2)、库存快照 6 个键盘 SKU 全数归属 4 型无孤儿可绑 → 不可无捏造地建权威行,WARN(维护欠账·不拦部署)保留挂决策清单——15:4x UTC 用户拍板「作废」当日销项:mars id27 cost_sar 35.00→0(NOT NULL 列以 0 代空,作废原因+原值全量入 notes 留痕)+镜像重灌,对账门 cost_rmb>0 过滤自然跳过零值行。修后成本对账门实跑:FAIL 0/WARN 1(仅 Keyboard)→ 作废后复跑 FAIL 0/WARN 0(成本面全清)。④⑤ backfill 崩溃卫生=tasks.py 新日档 backfill_hygiene(07:37,dirty_log 07:27 后 10min,78 函数册+cron 注册+missed_slot_sweep 水位账本覆盖):⑤ stale-running 回收——backfill_runs 卡 running/queued 且 updated_at 心跳超 2h → status='error' 注明回收来源(只 UPDATE 不删,操作历史不可销=delete_policy id42 原则;阈值标定:实测最长合法 run 15m37s/p95<1s,2h=8 倍余量;当前库存 0 滞留行=预防机制);④ 崩溃残片快照回收——backfill_snapshots 属终态 run 超 30 天物理删、孤儿 run_id 同窗删、非终态 run 快照=崩溃现场回滚资产不删(先⑤回收→仍留 30 天溯源窗再清;当前 3 行全属 done run 零残片);pg-init/119 入 delete_policy hard_ok 注册(静态删除口 45→46 处 46/46 合规)。SQL 真库预演(0/0/0 命中+造行 UPDATE 命中后回滚零残留)+部署 15:02 UTC api+worker(避开整/半点)。
    门禁:pen ALL PASS/dashboard 198+ FAIL 0 WARN 2(Keyboard 维护欠账+soft-30 过渡设计态,delete-policy 面 46/46)/frontend_e2e ALL PASS(含 fg 面)/audit_nodes 三租户 ALL PASS(zf 3048 节点/32 基准、onno 2679/31、fg 3110/29,与批前 3044/32 逐位同量)。
    执行事故留痕(诚实记录):nodes 首跑(2612 节点/20 基准)与后台 e2e 并发互踩——AC-GATE-06 互斥规则(240 共享限速桶)被本批自己踩中,429 假缩水与 #61 e2e 限速事故同型;串行复跑即复原,互斥规则再自证一次。执行序留痕:①~③ 无需部署(tools 改动宿主侧生效+数据面直改),④⑤ 改 worker 代码故 build+up 15:02 UTC。(10-24 勘误:本批数据面操作/Keyboard 作废/部署实际发生在 23:0x-23:31 UTC=北京次日 07:0x-07:31,上文 13:0x-15:0x 系北京时区误记为 UTC;证据=db log 2026-10-23 23:29:32 not-null 报错行(作废第一击)+audit_log p2fix.douxiu 23:30:10 落账+备份档/门禁日志 mtime 23:30-23:31。由此 10-23 夜档 19:11 的 Keyboard WARN 是作废前合法快照非复发——见下条)
  • 夜检三案闭卷(2026-10-24 00:0x-00:5x UTC,10-23 夜档两门 FAIL+一 WARN 追查):⑴ Keyboard 夜档 WARN=时间线误记非复发——夜档 19:11 报「镜像=35.0」,但作废实际 23:29-23:31 UTC(晚于夜档 4h,见上勘误);现值三面核验 mars id27=0/镜像行=0/成本对账门 0 FAIL 0 WARN,今晚夜档将自然清零。⑵ [today] day 时间边界首犯=间歇假红,锚作用域修复——根因:夜档 19:10 UTC 落在北京日切后窗口(UTC 16:00~19:10=北京 00:00~03:10),当日跨租户品牌(fg/onno 自营)订单先翻北京日而租户 1 会话域内无新日订单时,无作用域锚 max=次日 vs API(RLS 品牌域+账号域)=当日 → 结构性假红(10-21/10-22 无此串扰故未犯;cleaned_amazon_orders RLS=tenant_brands(is_active)+brand_scope+seller_owner∈tenant_accounts 三条件实证)。修复=dashboard_audit day 锚加 _ABSO(与 2026-10-08 _SO 同日同修同口径——「数据日=订单表最大日」指 API 自己的域内),复跑实跑 EXIT 0/FAIL 0/WARN 1(仅 soft-30 已知过渡态);host crontab 直读仓库,今夜夜档即生效,无需部署。⑶ priv_channel_audit 14×STALE+41×UNREGISTER=10-23 巨批行号漂移未过账本——巨批(#61/P2/都修批)横移 api/ 5 文件(advisor/backfill/rules_ads/sync_source/tasks)调用点行号而账本钉 file:lineno#sha8 未再生。流程=tar 快照 backups/priv-ledger-pre-regen-20261024.tar.gz→--regen→diff 审:64 旧站点 sha8 零消失零改动=纯行号移动;净新增 2 处均过目——tasks.py:2034(backfill_hygiene 取连,dirty_log_retention 同模式后台日档)、tasks.py:2144(promotion 邮件发送后台件取连,行内已注明 saas_admin 跨租户用途),均后台件非请求路径,f-string 红旗 0;复跑 PASS(code=66 ledger=66 new=0 stale=0 edited=0 fstr_flags=0)。
    待核:backfill_hygiene 首个真实日档 2026-10-24 07:37 UTC(worker 日志验 result dict)✅2026-10-24 已核验正常——worker 日志 07:37:00.412 start/07:37:00.447 done,duration 36ms,result={'recycled_runs': 0, 'snapshots_deleted': 0},与预期量级一致(库存 0 滞留行+0 残片快照=预防机制空转,符合部署时预演基线)。
  • P3×13:已修 12+挂账 1 —— P3-1~8/10~13 均已处置(代码标记在案);挂账:P3-9 退款件数不净额(口径拍板项)。补验轮新增项全修:KPI orders 口径(见 10.3)、noon SKU 广告归因、fx 汇率停更、非法日期静默忽略、frm/to 双闭区间标注(首页「含首尾」已上)。

10.2 本晚修复(10-21 深夜~10-22 00:15 UTC)e2e ALL PASS 201/0

  • Settings 凭据面(P1 级,审计线 21:42 新测试抓出) —— 页面为 tab 作用域渲染:ApiFieldsTab 此前 import 未渲染(字段 tab 空白)、凭据列表守卫误盖字段/大模型 tab。修:字段 tab 渲染 ApiFieldsTab、凭据列表限平台/物流两 tab;e2e 8b 重写为逐 tab 断言(平台=凭据列表/字段=API 字段参考/大模型=供应商卡)。
  • 768 平板首页 4px 横向溢出(P3) —— 根因=5 列 deck 卡内宽 ~96px 装不下换槽 select(maxWidth 108+flexShrink 0 溢出 4px);globals.css 增 deck ≤980px 三列档。探针 4px→0;e2e 新增平板 768 三断言(无溢出/无请求失败/断点形态汉堡可见)入夜跑常驻。
  • P3-5 品牌色级联 —— 首页品牌点散写三元改 brandColor()(fg 落灰修;fmt.ts 色表+租户级 brand_colors 运行时级联)。
  • priv 账本 regen + nightly 告警降级 —— 特权通道账本 64 站点纯行号漂移(内容级 diff 零增删改,过目后 regen,门禁 PASS);four_gates_nightly 告警邮件在 secrets/monitor_smtp_pass 缺失时改优雅降级(与晨检同款文案,密码落位即自动生效)。

10.3 P2a orders 口径级联补齐(10-22 00:0x)门禁复跑 FAIL 1(仅 X2 16G 用户挂账)

  • 经过(自家门禁抓自家违例) —— 补验轮 P2a(orders=有效订单剔取消,取代 2026-09-27 全量含取消定稿;审计实证同卡口径打架稀释单均 18%)22:28 改码 22:47 部署,落在 18:04 final 门禁之后且未重跑=违「改数字相关代码必跑四道门禁」;四门禁 nightly 首跑 23:51 当场抓 6 FAIL:dashboard_audit 基准未同步(amazon 订单 api 311 vs base 383=72 单取消差)+跨页门抓 finance/full 矩阵漏级联(kpi 223 vs full 268)。
  • 修(三处级联+复验) —— ①finance/full 矩阵 aord 子查询剔取消(分市场 countries 块本就剔取消,修后「同字段全站同值」重新成立);②dashboard_audit 基准同步:amz_base orders 剔取消+orders_all 全量、kpi-pool A 字典同构、取消率分母改 orders_all(防剔后 >100%);③api 镜像 00:07 重建部署,门禁复跑 FAIL=1(仅 X2 16G 成本漂移=用户挂账)。注册表 metric_calibers id=4 deck_caliber 补登记 UPDATE 已备(分类器拦截待用户放行)——「口径定义先于代码」此次为代码先行注册表后补,被自家 nightly 反抓,方法教训入档。

10.4 跨会话爬虫事故与恢复(10-21 23:17–23:40 UTC)全量恢复+e2e ALL PASS 复验

  • 事故 —— 审计线 /tmp/element_test.py「台账驱动逐元素实测」按按钮文本正则分类点击,DANGER 正则漏裸「关闭」→三租户×9 模块全关(billing.module.toggle 27 写)+KPI 换槽 onChange 自存盘 49 写(audit ids 28143-28232);同窗本线 e2e 4 FAIL(模块 403 波及)。审计线即刻停跑、确认三租户 0/9 损害清单,并承诺重启浏览器测试时带网络层写阻断(非 GET 全 abort)+跳过 billing/dashboard/settings/account 四页。
  • 恢复(用户「修好」放行) —— 27 模块行 UPDATE 三租户 9/9 enabled+3 租户 user_dashboard_prefs 自 21:50 全量 pg_dump 临时表回写(kpi_cards/chart_order/chart_locked 与备份逐字段一致);live 复验 kol-library 200(total 479,931)+e2e 全量 ALL PASS 201/0。证据:backups/post-crawler-damage-20261021-2336.sql.gz;审计线自写事故报告(其口径)另文在案。
  • 规则升级 —— 「e2e 与遍历不可并行」扩为跨会话互斥:两线任一在跑浏览器门禁前互查对方进程(本次根因=互不知情,两线各自合规、并发即互毁)。

10.5 四门禁终验(10-22 00:0x UTC)

  • pen_tests PASS | dashboard_audit FAIL 1=X2 16G 成本漂移(用户挂账,非回归) | frontend_e2e ALL PASS 201/0(含平板 768 三断言) | audit_nodes ALL PASS(202 端点·3044 节点采样·32 基准对账) | priv_channel_audit PASS(64 站点 regen 后)
  • 日志:logs/gate-nightly-20261021-2348.log(nightly 首跑)+ gate-run-1022-calibersync-dashboard_audit.log(口径级联后复跑)+ gate-run-1022-postregen-priv_channel_audit.log;四门禁 nightly 自此每日 19:10 UTC 自动(host-crontab 第 17 条)。

10.6 回滚锚点 v2026.10.21-round2-audit-fix

  • images 3/3 打 tag(api 6ec250a37c86 含口径级联/worker 70e867497702/web 6f19beb633ba 含 Settings/768/品牌色);code tar 15M(排除 node_modules/.next/backups/logs/uploads/static/screenshots/evidence/secrets);db dump 1.7G pg_dump -Fc(10-21 23:56=爬虫事故恢复后态);VERSION 更新含 rollback 串(docker tag 回滚+pg_restore --clean);host-crontab 17 条清单(恢复脚本 install-host-crontab.sh)。

10.7 用户拍板/挂账清单(累计视图)

  • DB 放行类:X2 16G mars UPDATE(镜像 105 vs 权威 95,$10/件)已 2026-10-23 用户令「都修」放行执行完毕(mars 105→95+note 留痕 id26 同型+镜像重灌,成本对账门 FAIL 清零,见都修批条目);metric_calibers id=4 deck_caliber 口径补登记(SQL 已备,见 10.3);pending-db-ops-20261021.md 两项均已 2026-10-23 用户放行执行完毕(P2-1 孤儿删+P1-18 staging 全窗重建);P2-34 脏日志清理已 2026-10-23 放行执行完毕(清壳+每日保留任务上线)。
  • 配置落位类:secrets/monitor_smtp_pass(晨检+夜跑 SMTP 告警通道收口,落位即生效)。
  • 决策类:P2-7/15/19/22/25/27+六维规格偏差+P1-10( dispatcher/222 );audit.html 两线条目 ID 撞号甄别(用户主导);3 SKU 缺成本主数据——2026-10-23 都修批侦查翻案:Airfit Neo/S-988 Pro 实为权威行已存在、拼写错位(Airfirt Neo 笔误/S-988 Pro 孤例)当日已对齐销项;仅 Keyboard 35.00(2026-08-01 估值批残留)真缺权威行——键盘族 4 型(Cyber Line 107.36/CX22 119.69/G502 159/Cyber Max 240)全有真值、无孤儿键盘 SKU 可绑,不可无捏造地建行,待拍板(作废估值行 vs 绑定某型)——2026-10-23 15:4x UTC 用户拍板「作废」已执行:mars id27 cost_sar 35.00→0(列 NOT NULL 故 0 代空,作废原因全量入 notes)+镜像重灌+audit_log 留痕,成本对账门 WARN 全清(当轮 gate FAIL 0/WARN 1 仅剩 soft-30 过渡态);远端推送与 git commit(不经允许不动)。

10.7.1 未闭环全量清单(2026-10-24 00:5x UTC 盘点;本节为 10.7 的全量展开+散落各条目挂账项的集中视图,只增不替——原条目不动,闭环时在本节随修随换打标)

【A–H 总览】(2026-10-24 结构化增设;各行原文只增不删在下方)
行内容当前状态
A等你拍板的规格/安全决策(=AC-PEND-01)7 项全处置(10-24 一批定谳+二批「ADEF全部接受修复」收口①③⑥)
Bmercury(旧称 222)与备份去向(P1-10)定名/零失败/白名单已定谳;保留策略已拍板 2026-10-24:每系列最新 5 份
C凭据落位SMTP 已落位收口(monitor@+三品牌信箱,告警路由口径生效);onno Amazon Ads 授权=用户控制台侧
D工程二期 9 项9 项全处置:5 落地·2 滞后销项·1 已拍板 2026-10-24(D4 noon 妥投=维持不剔,立 AC-CAL-16)·1 用户侧暂停(DAT-01/onno Ads)
E业务数据侧 5 项3 闭;2 挂用户输入(E4 两数字出处页/E5 撞号 ID 指认)
F商务/外部依赖 6 项5 闭;1 挂终评 10-28(fg/ES 44% 双管复评)
G版本管理git commit/push 不经允许不动(远端通道双重待解)
H自动化待核验1 闭(backfill_hygiene 首跑 07:37 UTC ✓)+1 自证中(今夜 19:10 夜档四门)
挂用户/留拍汇总:E4 两数字出处 · E5 撞号 ID 指认 · F② 10-28 终评 · G 待允许 · C/D8 onno Amazon Ads 授权=用户暂停(2026-10-24)。B 保留策略(每系列最新 5 份)与 D4 noon 口径(维持不剔)已于 2026-10-24 拍板闭卷。其余全部闭卷。
  • A|等你拍板的规格/安全决策(=AC-PEND-01「六维规格偏差+P2 六项」,处置权在用户) 7 项全处置:①六维规格偏差——sales_mode 等六维全库 0 命中,直营/代理区分现靠 tenant_accounts 账号桥,要按直营/代理分账时现结构拆不出,要不要落真实数据结构;②P2-7 tenants/promotion_kol_reddit 非 RLS 表 SELECT 开放(kol_reddit 租户归属定位);③P2-15 ServiceFee 历史断更月是否重算/范围(防复发已接线,历史未回补);④P2-19 注销/归档仅文件系统无 DB 登记要不要 DB 化;⑤P2-22 cron_audit 仍探测 222(与 B 类联动);⑥P2-25 internal 容器网通道不设 brand_scope 要不要收紧;⑦P2-27 MCP 返回值无 BASAL 对账门要不要加。
    → 2026-10-24 逐项拍板处置:①六维——接受「不落结构、tenant_accounts 账号桥即口径」;新需求「财务按品牌分开计算」落位:营收/订单/广告/采购成本本有品牌列,费用侧见③,账户级费用分摊规则(按销售额/体积/件数)为剩余拍板项;②P2-7 已定谳——前提确认 promotion_kol_reddit 现为共享单份目录(portal_app 只读),演进已拍板「谁购买这个服务谁可以用」(购买制授权,设计挂账二期)✅已修好(9.77·promotion 独立可购模块落地:迁移 154 grandfather 三租户零变化·55 端点换门·导航/预设切换·未购 403↔开通 200 往返实证·全量门禁 ALL PASS);tenants 表四权限各有合法用主(INSERT=注册通道 auth.py:266、UPDATE=计费/组织、DELETE=注销清除 tasks.py:1912 走 portal_app 池、TRIGGER 本未授)→ 零收权,原「收 INSERT/DELETE/TRIGGER」建议作废;③P2-15 调查闭环——代理(onno 经 zf 卖家账号)费用 90 天实证:可拆=结算行级 1049 行 −12,899.79 USD(seller_sku→sku_mapping→品牌,其中 onno 403 行 −3,409.56 USD;仅 3 行 −15.85 无映射待补,2 行为 Amazon 分组 sku);不可拆=服务费专表整表 ≈−13,323 USD/90 天(FBA 仓储/长期仓储/订阅/Vine/Coupon/Deal/EPR 全无 sku 轴)+结算无 sku 行 47 行 −2,043 USD(ProductAds 账户级;广告费可另走 ads 管道品牌轴归集);分摊规则待拍板;④P2-19 已定谳满足——DB 记录全链路已在:注销发起 org.py:273(含归档文件名+行数)、恢复 org.py:294、物理清除 tasks.py:1908(同事务、audit_log 无 FK 永存)、归档到期回收 tasks.py:1985;⑤P2-22 已定谳——222 定名 mercury(勿再称 222);调查结论:备份推送无失败(10-09 起 mars 日志+mercury 落盘+watch 抓写入三证连续成功);真正天天失败的是 monitor 报告邮件推送(旧 smtp_* 凭据 526 已失效,切 monitor_smtp_* 新命名+pass 落位一并延后=用户「晚点再配置」);cron_audit 的 mercury 探测已登记 bianque 两个异地保留件白名单→PASS;⑥P2-25 已确认闭卷(2026-10-26 用户「都同意」拍板)——internal 三层防护定谳=①X-Internal-Auth HMAC(P2-6 交付)+②容器网 404 双层(ARC-01)+③租户 RLS;brand_scope 不另收紧,三层即准;⑦P2-27 已修——audit_nodes 新增 MCP 面 6 断言/租户(无 key 401/tools/list 工具集/brands+sales_summary 数值对账(_AB+_SO 同构域)/跨租户品牌参数归零/吊销即 401/临时 key 用后即删),首跑三租户 6/6 全过 EXIT 0(tools/_gate_p27_mcp_nodes_20261024.log)。
    → 2026-10-24 二批(用户令「ADEF全部接受修复」,①③⑥ 收口):①已修——账户级费用分摊拍板=按销售额比例:sync_source 落 _SVC_BRANCH_CONSIGN(代卖宿主账号 zf 承 onno 的月度服务费,按同 schema finances 营收份额分品牌——与 _FIN_BRANCH SKU 层 a/r 摊分同源同基数「一份基数」;无收入月全部归宿主、尾差归宿主保月总额逐分不变、LEFT JOIN 保零收入月费用不丢月),mars 干跑 26 个月逐月守恒实证:2026-08 −370.51=−207.79(onno)−162.72(zf)、2026-09 −728.73、2026-10 −391.47 与原分支分毫不差,2026-08 前 onno 零行=代卖未开始,随下次 04:30 夜档同步入 cleaned_amazon_service_fees→v_amz_net_profit_monthly(onno 六维财务自 2026-08 起真实扣费,此前恒少计);③已修(方案B)——LTSF 外源真值通道全断实证(V2结算×3 变体 400=SP-API 应用缺 Finance 角色;GET_FBA_INVENTORY_AGED_DATA 正确报表名 JP/US 双市场 202 受理后 FATAL=同角色墙),拍板走方案B 内源估算:mars 视图 zipforce_amazon.v_ltsf_asin_est(per-ASIN 体量份额摊 FBALongTermStorageFee 月区真值——LTSF 按滞库体量计费、体量份额为现有数据最贴动因,金额真值仍专表不替代;无体量月区 vol_basis=false 挂账户级,随 per-ASIN 仓储报表回补逐月自愈),守恒 −4,627.11 vs 真值 −4,627.12(1¢ 舍入);首个有基数月 2026-09 EU:onno 4 ASIN −20.64/zf 17 ASIN −136.74;Vine 全期 17 笔 −9,198 维持账户级(无公开 per-ASIN 报表;如后续指认报名 ASIN 可一次性映射再拆);⑥已修——internal 契约面 3 条带 brand 参数路由(order/sku-aggregate、ads/spend、finance/monthly)加 _check_brand_scope:brand 非空须命中本租户 brands_source(RLS 定域)否则 403,随批部署生效(部署后探针 X-Tenant-Id:2+brand=zipforce 应 403);②④⑤⑦ 维持一批定谳。
  • B|mercury(旧称 222,2026-10-24 定名)与备份去向(P1-10) 2 项:dispatcher FROZEN 占位与「222 退役」口径矛盾,222 现仅作异地备份盘(每日 backup.sh 仍推 222)去留/换目标待拍板;备份去向(紧迫)+散件、历史项三拍板(isolation VII 线)。
    → 2026-10-24 定谳:该机定名 mercury(用户口径,全栈命名已切换:ssh 别名/backup.sh/cron_audit,Host 222 仅存历史);异地备份盘角色确认——每日 11 库 dump+代码/secrets 镜像推 mercury,10-09 起零失败(mercury 落盘清单逐日核对);mercury 盘 10-22 曾 96%(14 天×8.2G/天将至满),bianque 当日装 prune_offsite_backups 保留策略(zipforce_ba 留 3 天、saas_registry/kol_db/amazon_analytics 留 7 天、小库 14 天;mars 本地仍全量 14 天),现 79%(33G 空闲)+dump_writer_watch 观察件,两件已在 cron_audit 白名单登记;异地保留天数如需调整待拍板。
    → 2026-10-24 拍板落地:每系列保留最新 5 份——mercury /usr/local/bin/prune_offsite_backups.sh KEEP_* 全改 5 并同刻手动执行(zipforce_ba 现存 3 份将随日推攒满 5;registry/kol/amazon/tiny 系列即时收到 5),盘 79%→76%(37G 空闲);标准入 audit-base AC-OPS-07。
  • C|凭据落位(落位即生效,工程侧无法代做) 1 项:secrets/monitor_smtp_pass 已落位 2026-10-24(晨检+夜跑 SMTP 告警收口,缺位期告警=日志+退出码兜底)——2026-10-24 用户两次交付凭据后收口(先三品牌信箱、后 monitor@ 专用信箱 pass):系统告警发件箱维持专用监控信箱 monitor@zipforcehub.com(飞书 smtp.feishu.cn:465 SSL,公共邮箱成员可读),monitor.py mail() 弃失效旧 smtp_*(526)切 monitor_smtp_* 同源四件(monitor/four_gates/pipe_morning_check/夜跑),实测登录✓+自发自收投递✓(526 消失);三品牌信箱 secrets/{zf,fg,onno}_smtp_user/pass 对称落位备用(登录均✓,host/port 四箱共用);密码文件用户落位+门禁双约束下由用户明确交付后写入,规则=只编程使用勿打印值不变;同日用户定告警邮件路由口径=SaaS 系统问题→monitor@zipforcehub.com、租户各自业务问题→对应品牌信箱:worker 四件(daily_pipe_alarm/fee_coverage_alarm/ads_staleness_alarm/eval_keepa_alerts)收件切品牌信箱(brands_source 品牌映射+owner 回退,tasks.py _tenant_alert_to/_mon_smtp_cfg 单实现)+发件切 monitor@(compose 注入 monitor_smtp_* 容器 secrets;坑:compose secrets=宿主文件直挂,worker uid1000 下须 644 对齐旧 smtp_* 惯例),顺带修复四件 best-effort 邮件一直走 526 失效旧 smtp_* 通道的静默失败;host 侧 monitor.py/pipe_morning_check 收件改 monitor@ 自收(摘租户 owner),four_gates 原本自收已合规;po_pdf 采购单 business@ 通道与 promotion Fernet 邮箱池不在此口径内不动;api/worker 镜像重建+up -d(04:33 UTC 窗内),worker 容器内实测 monitor@→zf 品牌信箱投递✓;onno Amazon Ads 授权(onno 广告现唯一源=CSV 手动通道,接 API 需授权,关联 DAT-01 搁置族)用户暂停 2026-10-24。
  • D|工程二期(方向已定、排期待启) 9 项→ 2026-10-24 三批(用户令「ADEF全部接受修复」)9 项全处置:5 落地·2 滞后销项·1 留拍·1 用户侧:AC-PEND-02/10.8 口径统一全站铺开(views+metric_calibers,P2a 级联已预演);P2-14 A 项 fg 应计推导二期;soft-30 渐进改造(30 张软删表逐步加 deleted_at,P2-36 拍板=渐进,WARN=设计过渡态);noon undeliverable 口径(#61 余量批独立留拍);#61B 拍板包三项(告警阈值参数族>60/spends>5、advisor 规则默认值源租户层 vs 口径层、web 展示字面量后置);P3-9 退款件数不净额;6.2 架构疑问 Q7/Q10;9.8 巡检挂账 1 项;audit-base 校对线 LOG-028(燕文管道承诺句)+LST-062(Impex 子页旧端点)。
    → 逐项处置(2026-10-24):D1=二批落地(部分)——有效订单双实现统一中发现并修复真 bug:finance 页利润矩阵前端本地 orders−canceled,而后端矩阵 orders 已是 aord(P2a 口径级联单源,剔取消)→双剔取消、有效订单列偏小 canceled 量;修法=profit-matrix 端点增 gross_orders 字段(毛订单量;orders 保持 aord 不动,MonAgg/图表等既有消费零影响),前端「订单」列改读 gross_orders、「有效订单」列直引 aord(finance.py:890/1039、page.tsx:1538;tsc 本地无 node_modules,部署后浏览器探针+19:10 e2e 兜底验);views/calibers 全指标铺开仍属后续批次(AC-PEND-02 仍挂;2026-10-24 批一已落 9.38=谓词派生+34 站点+视图三迁+门禁全绿,余批二读面/门禁自身站点)。
    D2=落地——P2-14 A 项 fg 应计推导:mars 视图 fittingirls_amazon.v_fg_finance_accrual_est(归期=订单 purchase_date 月·订单日 fxd 逐日汇率·事件驱动 Shipment/Refund 天然剔取消,rev/fee/promo/net 四列,DDL 留档 evidence/r40_adef_fix/fg_accrual_view_20261024.sql);成熟月对账 08 +12.0%/09 +19.0%(与 P2-14 实测现金基准低≈15% 量级吻合;10 月 −22.4%=当月结算滞后混窗,正常);fg 主基准仍=现金(id21 注册不变),视图=对比/对账面不进主读面,跨品牌应计对比自此三品牌同基可用。
    D3=一期落地——soft-30 渐进试点 report_defs(全库读写面 survey 最小:DELETE 1 处/读 2 处/零跨文件读者):pg-init/121 加 deleted_at+delete_policy 注记更新+audit_log 留痕,删口 UPDATE deleted_at=now()(reports.py:485),list/update 过滤 IS NULL,白盒探针 _audit_buttons_w7 df3(0|1 软删断言)/_audit_pixel_values13 m_defs(过滤)同步跟语义;门禁 delete-policy soft WARN 30→29(迁移应用后生效),余 29 表按批渐进。
    D4=推荐方案已录·留拍——noon undeliverable 剔除与否:实证 2026-09 undel 150/2940≈5.1%(非可忽略)但状态列会计恒等式不闭合(units 2940 vs cancelled+pending+delivered+undeliverable 四列和 2687,残差 253≈8.6% 其他态)→诊断列非分区、减法派生正是 XXII① 修掉的坑型;推荐=有效件维持 units−cancelled 不剔 undeliverable(Amazon 侧有效件同构、重派成功件会被误剔、财务后果已由退款净额面 P3-9 捕捉不双重惩罚),妥投口径需求走 delivered 权威直读(已在案)——按「待拍板项禁自行决定」留用户拍板。→ 2026-10-24 用户拍板:维持不剔(推荐方案采纳),标准入 audit-base AC-CAL-16(Noon 有效件=units−cancelled,妥投走 delivered 直读)。
    D5=滞后销项——#61B 三项于 2026-10-23 12:1x-12:5x「接受」A/A/A/A 已全部执行闭卷(id23/24 告警参数族+dashboard _alert_th 派生、advisor 两层设计成文注释、id5 exclude_status+XN 单源、useThresholds web 字面量下发),本行 10-24 00:5x 誊写时滞后重复登记,非未修。
    D6=落地(待部署)——P3-9 退货/退款 KPI 卡件数→退款净额 USD:AMZ=audit.cleaned_amazon_refund_monthly 净流出金额(amount_usd 恒负)月窗和+Noon=最新月逐国 sum(refund)×_noon_usd 折算(本币金额口径,卡值=净流出 USD、AMZ 件数与「Noon 无件数列」进脚注);顺带修 dashboard.py 原 int(sum(refund)) 把 Noon 本币金额截断当件数显示的连带缺陷。
    D7=双落地——Q7 并发幂等专项核验(四层证据链:tenant_sem 队列层/P2-11 同窗 409/P2-13 品牌锁/写面自然键 UPSERT 四表实证,cron×回溯=确定性 last-write-wins,结论=现防护完整零新增代码,详见 6.2 Q7 行);Q10 容量/隔离实证+收紧(详见 6.2 Q10 行;pg-init/120 mars CONNECT 收至 saas_admin/collector)——6.2 架构疑问清单就此 10/10 全绿。
    D8=用户侧——9.8 巡检挂账 1 项即 onno Amazon Ads 授权(DAT-01 搁置族,用户控制台侧 foncye Advertising API 授权,与 C 类同源同挂,工程侧无可执行面)。
    D9=滞后销项——LOG-028(燕文管道承诺句)/LST-062(Impex 子页旧端点)在 audit-base v5.x 均已 p-ok 生效在册,本行滞后重复登记,非未修。
    → 部署与验证(2026-10-24 06:15-06:3x UTC,窗内避开整半点/广告档):快照 code-20261024-adef-batch-d.tgz;迁移账本收编(107-119 共 16 个历史手工应用迁移 --register-existing 回填 sha 锁定)+120/121 单应用(120 验证 portal_app mars CONNECT=false/collector·saas_admin=true;121 验证 report_defs.deleted_at 在列);api+worker+web 三镜像重建 up -d(06:20);部署后探针全绿——A⑥ internal brand=zipforce@tenant2 403/无 brand 200;D1 /api/finance/full 矩阵 gross_orders−canceled=aord 三月逐位吻合(286−50=236/477−110=367/341−59=282);D3 软删生命周期探针(建→删 ok:true→列表不可见 0→再删幂等 ok:false→库内行留 deleted_at=06:24:07);kpi-pool return 基准随 D6 净额口径同步(dashboard_audit.py A.refunds 换单表 amount_usd 窗口月和、N.refund 加 /_FXC 逐国折取负);四门禁 ALL PASS(pen/nodes/chart_value/dashboard 198+ FAIL 0,delete-policy soft WARN 30→29=D3 生效实证);回补 2 号携 403 自愈修复重启(worker 容器重建连带旧进程清退,docker exec -d 重拉,日志 zf-storage-backfill2-20261024.log)。
  • E|业务数据侧待定 5 项 → 2026-10-24 用户令「ADEF全部接受修复」收口 3 闭 2 挂用户输入:①R-REG-87 已收口——事实修正:按 fg 订单面重算现为 99 个未登记 ASIN,且 100% 属 10-10 瘦身删除集成员(bak_sku_mapping_fg_20261010 全命中,原「从未登记的正向缺口」定性有误,实为删除集),随 mapping 变动与订单回补数随日漂移;其中 8 个 2026-10 仍出单的活品已原样恢复(按 10-10 备份表全字段 INSERT 132 行/12-17 国,seller_sku 订单↔结算联查实证:B0F5HRFH6G 等 NA-/EU-2519/2305 族+B0FJMBLWLB AUS8196NU00MA;此前被 source_where SKU 血缘过滤=fg 六维漏算面,恢复后次日重建自动回到账内),池 seed +65;91 个不出单者(有排名无订单)清单落 backups/ca-restore-19-20261024/fg_剩余91_业务核对清单.txt 待业务逐个定(死品维持删除/恢复,备份表可原样恢复);②cleaned_inventory_health 1,870 行未收敛 已自愈=0——XVI 防再生(夜重建 source_where 只留 mapping 内行)生效,现库 3,497 行 mapping 外=0(fg 831 SKU 全在现行 mapping 内,fg mapping 已回长至 1,021 行);③zf/CA 19 条 已补回 2026-10-24——XXIX ②(b) 误删定谳落地:19 行入 mapping(6 个真 seller_sku 订单↔结算联查实证:MUS05002203W/WBP16502203W/WBP16502203P/WBS07002203P/ZP0801GRA/ZP0801BLU+13 个占位 CA-<ASIN>,sku 列 NOT NULL 且唯一索引不容空串,占位真值到手后 UPDATE 换入),seed_from_mapping +28 入池(zf CA 域 247 行、fetched_at=30 天前=队头),今夜 04:40 cron 恢复拉取、次日快照自动回;备份+SQL 留存 backups/ca-restore-19-20261024/(pre-sku_mapping.sql.gz+restore_ca_19.sql+restore_fg_live8.sql);④两数字复现 穷尽复现失败·待用户出处页——26,501 已测口径:三表行和 13,338/五表行和 37,455/五表全列去重 22,702/三表各自去重和 3,908/机会层 3,045,均非;雷达表按 period 轮换,疑为 10-18 时点快照数;fg 84 已测:1,021/831/441/348/459/188/189/310 均非——两个数字待用户给出处页/查询后对齐修订;⑤ID 撞号甄别 全库频扫无真撞号·待用户指认——AC/P0-P3/LOG/LST/SEC/R- 族全量频次扫描,高频重复(R-INFO-01×7/R-REG-87×5/SEC-01×3 等)经逐一定位均为同一条目跨节引用非两条例目共用一 ID;用户所指具体 ID 待指认后即时甄别。
  • F|商务/外部依赖(非工程缺陷) 6 项 → 2026-10-24 用户令「ADEF全部接受修复」收口 5 闭 1 挂终评:①onno/amazon 休眠组合 已定谳=维持休眠(数据实证 5 活动全停于 08-31=平台侧停投 2 个月非管道断更;整体 ACOS 42.4% 高于健康线 25%;onno 无自控 amazon 广告账号,唤醒条件挂账=onno 采购成本行补齐(R24 同挂)+商务确认预算归属再评);②fg/ES 44% 双管 7 天窗复评(R39)中期已评·终评 10-28(4/7 天:焚烧炉 2402「暂停」半管实际未执行——仍 ENABLED,但降价管生效,日烧 20.0→15.0€ −25%、自身 ACOS 39.4→32.3% 改善中;组合 ACOS 33.6→37.4% 系 7d 归因未熟虚高;终评排 10-28=窗关+归因熟);③fg/AU 终判 已定谳=维持监控(Keepa AU 域外部源断供实锤,KEEPA_SOURCE_DEAD 机制在位,源恢复自动回数+自动回常规报警,撤监控零收益);④Keepa 误判窗口脏行 DELETE 已执行 2026-10-24(用户 ADEF 批授权:rankings_daily 2026-10-21 AU 5 行+audit.cleaned_rankings_daily 同 5 行+aba_keepa_full@12 27 行(9×3 租户)事务删除,删后三面残留=0;备份+SQL 留存 backups/keepa-misjudge-clean-20261024/ pre-delete-dump.sql.gz+cleanup.sql);⑤R39 挂账 noon 预算不同步数仓 口径已标注(advisor._detect_noon SCALE_UP 块注明:noon 日预算真值只在平台侧、快照可滞后、花尽判定无法机械保真→noon 加预算整类挂起,卡面 metrics 增 budget_source="noon 快照(近3天, 非平台真值)");⑥R-KEY-NOON 键位差 口径已标注(clean_audit.noon_ads_daily 块注明:noon 表族 sku 列=平台 slug(Z…Z-1)vs sku_mapping=卖家 SKU(…ME),键位差非违规,amazon 表族 source_where 血缘判据不适用 noon,键位统一属后续拍板项)。
  • G|版本管理 1 组:git commit+远端推送(不经允许不动;GitHub 私有仓 token 无权访问+内网 git 443/22 不通双重待解)。
  • H|自动化待核验(无需动作,自证后本节打标) 1 项:backfill_hygiene 首个真实日档 2026-10-24 07:37 UTC(worker 日志验 result dict)✅已核验 2026-10-24:result={'recycled_runs': 0, 'snapshots_deleted': 0}·36ms·正常;今夜 19:10 夜档四门(day 锚修复+priv 账本再生后首次夜跑,预期全绿)。

10.8 后续项

  • 口径统一(views+metric_calibers 全站铺开=AC-PEND-02,排期后启动,本轮 P2a 级联即其预演);audit-base.html v2(55 条,AC-UI-03/04/05 生效+AC-UI-07 新增)随口径演进只增不删;补验轮 5.1 基线表(12/12 精确一致等)作为后续对账锚。

§11 逐页元素标准全册(AC-EL,自 audit-base 整体迁入 2026-10-24,§11.1–§11.40 原文全量)

2026-10-25 权威本迁回:用户澄清 audit-base=完整验收尺子(所有公式/chart/表格标准必须在册,验收照此进行),§11 权威本已迁回 audit-base §11。本节自此为 2026-10-24 收档快照,只存档不再更新;后续 §11 增改一律落 audit-base。
v4 扩建纪律(2026-10-22 用户令:"每一页的所有元素的描述和定义都写清楚,全量,最细颗粒度"):每个页面每个可见元素(卡片 / 表格 / 列 / 图表 / 筛选 / 页签 / 按钮 / 弹层 / 脚注 / 色点 / 徽标 / 空态…)单列一条 AC-EL-<页>-<序号>。七列结构:ID / 元素(含 tab·区块位置)/ 类型 / 描述(是什么·给谁看)/ 定义(数据来源·口径·公式·边界·交互,口径直接引用 §1 AC-CAL 条目号)/ 验证方法 / 状态。条目一律从源码实证生成(web/app·web/components + 对应 API router 逐行核对),禁凭空撰写;页面出现而库中无条目的元素 = 验收缺口。状态流:待建 → 生效(条目落地并经一次验证)→ 变更时新增带日期新行不覆盖原句。§11 元素条目单独计数(下表"元素条目"列随建随更),顶层计数卡仍计 §1–§10。
路由页面(ID 前缀)源码规模元素条目状态
/首页看板 AC-EL-HOME(KPI deck/告警面板/图组/分市场)702 行176 条(结构 49 + 图 80+22 + SKU 表 25)已建 v4.1
/today今日页 AC-EL-TODAY459 行32 条(校对通过·全生效)已建 v4.5
/orders订单页 AC-EL-ORDER175 行26 条(校对通过·全生效)已建 v4.5
/finance财务页 AC-EL-FIN(总览/月度/SKU P&L)1858 行64 条(62 生效 / 2 待核);§11.27 列级 173 条(173 生效)v5.0已建 v5.0
/ads广告页 AC-EL-ADS(深度分析/日表/导入)2475 行169 条(168 生效 / 1 待深化)已建 v4.7
/sourcing选品页 AC-EL-SRC(explore/情报台 charts)2200 行82 条(82 生效);§11.28 六外部 tab 187 条(全生效)v5.0;§11.38/§11.39 图表墙逐图 153 条(148 生效 / 5 废止)v5.3已建 v5.2
/noonNoon 专页 AC-EL-NOON495 行42 条(42 生效)已建 v4.4
/logistics物流页 AC-EL-LOG(ASN)759 行51 条(50 生效 / 1 待核)已建 v5.1
/listingsListings 页 AC-EL-LST1162 行159 条(158 生效 / 1 未上线保留)已建 v5.1
/rankings排名页 AC-EL-RANK718 行84 条(84 生效)已建 v5.1
/products产品页 AC-EL-PRD299 行40 条(40 生效)已建 v5.1
/inventory库存页 AC-EL-INV278 行57 条(57 生效)已建 v5.1
/mapping映射表页 AC-EL-MAP317 行47 条(47 生效)已建 v5.1
/poPO 页 AC-EL-PO413 行76 条(76 生效)已建 v5.1
/projects项目页 AC-EL-PRJ709 行64 条(64 生效)已建 v5.1
/offsitepromotion站外促销页 AC-EL-OFF389 行§11.37 全页 65 条(65 生效)v5.1;§11.40 子组件列级 446 条(全生效)v5.4已建 v5.4
/settlement结算页 AC-EL-STL130 行43 条(全生效·校对通过)已建 v5.0
/settings设置页 AC-EL-SET(凭据/字段/大模型 tabs)236 行24 条(全生效·校对通过)已建 v5.0
/billing账单页 AC-EL-BIL205 行33 条(31 生效 / 2 待核·校对通过)已建 v5.0
/backfill回填页 AC-EL-BKF238 行31 条(全生效·校对通过)已建 v5.0
/database数据浏览器 AC-EL-DB183 行20 条(全生效·校对通过)已建 v5.0
/dictionary数据字典页 AC-EL-DIC145 行23 条(全生效·校对通过)已建 v5.0
/documents文档页 AC-EL-DOC140 行24 条(全生效·校对通过)已建 v5.0
/account账号页 AC-EL-ACC111 行44 条(全生效·校对通过)已建 v5.0
/team团队页 AC-EL-TEAM291 行17 条(全生效·校对通过)已建 v5.0
/aiAI 助手页 AC-EL-AI110 行48 条(47 生效 / 1 待核·校对通过)已建 v5.0
/pipeline管道页 AC-EL-PIPE334 行46 条(全生效·校对通过)已建 v5.0
/dashboard/[brand]品牌看板 AC-EL-BRD(BrandBoard)39 行+组件22 条(全生效·校对通过)已建 v5.0
/dashboard/noon/[brand]Noon 品牌看板 AC-EL-BRDN(NoonBoard)39 行+组件31 条(全生效·校对通过)已建 v5.0
/onboarding入驻页 AC-EL-ONB310 行13 条(12 生效 / 1 待拍板·校对通过)已建 v5.0
/offboarding离场页 AC-EL-OFB80 行55 条(全生效·校对通过)已建 v5.0
/register ·/login ·/verify ·/welcome认证四页 AC-EL-AUTH388 行3 条(2 生效 / 1 待深化·校对通过)已建 v5.0
/promotion ·/upload跳转页 AC-EL-REDIR18 行42 条(全生效·校对通过)已建 v5.0
/en ·/training帮助两页 AC-EL-HLP238 行41 条(40 生效 / 1 待核=价格分歧坐实·校对通过)已建 v5.0
/privacy ·/terms ·/feishu法务/集成三页 AC-EL-LEGAL347 行41 条(41 生效)已建 v5.0
(全局)AppShell 导航壳 AC-EL-SHELL(品牌切换/租户信息/模块菜单/告警入口)组件16 条(全生效·校对通过)已建 v5.0
(全局)共享组件 ×19 AC-EL-CMP(KpiDeck/DataTable/ChartCard/EChart/GChart/ChartGrid/MatrixSection/BrandBoard/NoonBoard/NoonStatement/AdsAdvice/SkuMasterTable/AIChat/AIContext/CustomModules/RegGate/BrandContext/kit/…)组件55 条(52 条目+3 引用行·校对通过)已建 v5.0

§11.1 首页工作台(/ · AC-EL-HOME,源码 web/app/page.tsx 702 行 + dashboard.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-HOME-01工具栏·平台切换按钮组筛选Amazon / Noon 两个平台 tab,全页数据的平台轴选项由 /api/dashboard/filters 判定:该品牌 Noon 无业务则隐藏 Noon 按钮并自动纠正 platform;platform=noon 时 period 强制 rolling(Noon 无日粒度,day 返回空);"全部平台"合并视图按钮 2026-09-16 用户拍板下架(代码保留,见 AC-EL-HOME-15..21)e2e 点选联动 + 无 Noon 品牌不渲染按钮生效
AC-EL-HOME-02工具栏·国家下拉筛选"全部国家"+当前平台国家列表选项=filters.countries[platform];未选平台=两平台并集去重;切换平台后当前国家不在新选项内自动清空回"全部国家"filters 端点 vs 下拉选项逐字一致生效
AC-EL-HOME-03工具栏·时间窗预设组(7/30/60/90/全部)筛选统一时间选择器预设档,同时驱动 KPI 卡与图表墙"全部"=2020-01-01 起;点预设清空自定义日期;窗口天数换算 boardDays(自定义=起止天数,上限 3650);2026-09-16 用户拍板为全局统一选择器e2e 切档后 KPI/墙请求参数 date/date2 断言生效
AC-EL-HOME-04工具栏·自定义起止日期双输入 + "~含首尾"标注筛选date 输入×2,双闭区间语义前端标注max=今日;起改晚于止→止自动跟随;北京时区今日锚(filters.max_day 覆盖,与后端 bg_today 对齐,修 0-8 点窗口标签差一天 P3-7);双闭区间=AC-UI-05(相邻窗拼接日重叠属设计)e2e 输入框值/边界;标注文案存在生效
AC-EL-HOME-05智能报警·面板卡(总)卡片⚡ 智能报警 + 总数/🔴/🟡/⚪ 计数行,工作台首要异常入口/api/dashboard/alerts?brand&platform;边框规则 high>0 红/medium>0 黄;total=0 整卡不渲染(非空态文案);请求失败兜底空对象不报错alerts 端点 JSON vs 面板计数;空告警租户页面无此卡生效
AC-EL-HOME-06智能报警·展开/收起按钮按钮面板折叠开关,头部整行可点按钮 stopPropagation 防与头部点击双触发;默认展开e2e 点击切换生效
AC-EL-HOME-07智能报警·店铺分组头分组按店铺(Amazon/Noon)分组的头部条店铺→品牌→SKU 三级分组(2026-10-08 用户令"先按店铺再按品牌再按SKU");店铺头=emoji+品牌数+报警数+店铺内红标数;背景色店铺含 high→danger-weak 否则 warn-weak分组结构与 alerts platform/brand 字段一致生效
AC-EL-HOME-08智能报警·品牌分组行分组店铺内按品牌聚合的行头:色点+品牌名+项数色点=brandColor() 级联(AC-UI-07);组内按 severity high→low 排序;红标计数随行色点色值=注册表/兜底级联;排序断言生效
AC-EL-HOME-09智能报警·单条报警行列表项 severity 图标 + 标题 + 详情 + 建议 action + category 角标规则集(dashboard.py 2549-2710,11 条):AMZ ACOS>100% high 否则 medium(🎯广告)|AMZ ROAS 回收<花费 high(🎯广告)|AMZ 断货风险<3 天 high 否则 medium(📦库存)|AMZ 长期仓储>366 天 medium|AMZ 零动销 low|AMZ 低分 SKU(<3★ 占比)medium(🏥账号)|Noon 高 ACOS|Noon 零转化(14 天有点击零销售)|Noon 断货(可售=0)/低库存|Noon Buy Box 丢失 medium;high 标题红字各规则触发条件独立 SQL 复算 vs 端点输出生效
AC-EL-HOME-10KPI 概览·标题行标题📊 KPI 概览 + 使用说明 + ⓘ 口径说明折叠钮说明文案="每张卡片右上 ▾ 可换指标 · 选择即保存到你的账号 · 随品牌 / 国家筛选联动";Ⓘ切换口径表显隐e2e 文案存在生效
AC-EL-HOME-11KPI 卡槽 ×10(2 行×5)卡片可自定义指标的 KPI 卡组,工作台唯一 KPI 区每卡右上指标切换 select(aria-label=第 N 张);池内互斥(选已在别卡的指标→toast 拒绝);选中即 PUT /api/dashboard/kpi-cards 持久化 user_dashboard_prefs(账号级,校验 10 槽且 key∈池);未保存返回 KPI_DEFAULT(orders30/rev30/profit30/fees30/commission/fba/margin/aov/ad_spend/acos);加载=10 skeleton;失败=错误卡换卡后刷新保持;互斥 toast;dashboard_audit 卡池断言生效
AC-EL-HOME-12KPI 指标池(19 项)数据可上卡的全量指标清单KPI_POOL:rev30/units30/profit30/commission/fba/margin/pending/cancelled/undeliverable/return/ad_spend/ad_sales/acos/tacos/cps/orders30/fees30/aov/cancel_rate;orders30=有效订单(剔取消)·aov=营收÷有效订单·cps=广告花费÷有效订单·cancel_rate=取消÷全量订单(AC-CAL-02);acos/tacos desc 健康线占位下发回填=metric_calibers.health_line 单源(AC-CAL-06);值随品牌/国家/平台/窗联动(period rolling 近30天/day/month/year;noon rolling 也吃工具栏窗换算,金额按触月对齐)kpi-cards 响应 pool 19 项逐条比对;健康线值=注册表生效
AC-EL-HOME-13KPI 卡值/脚注/tone数据卡主体:数值+着色+脚注fmtVal 按 unit usd/pct/int 格式化;null→"—";tone 条件染色;foot 必标分子/分母构成(AC-KPI-01,如 orders30 脚注含全量数、aov/cps 标"÷有效订单");label"近30天"随窗口标签替换dashboard_audit kpi-cards desc/foot 全量断言生效
AC-EL-HOME-14KPI ⓘ 口径说明折叠表表格Ⓘ 展开的"各卡片计算方式"19 行表+3 脚注恒定标准:表内每行文案必须与 AC-CAL-02/KPI_POOL desc 一致(口径说明是 UI 的一部分,AC-UI-01)。现状 5 处过时待修:①"订单 AMZ count(*)(全状态, 含 Pending/Cancelled)"→实现为有效订单剔取消;②"客单价 营收÷订单"→÷有效订单;③"CPS 广告花费÷订单"→÷有效订单;④"取消率 取消÷订单"→分母=全量订单 orders_all;⑤脚注"② 订单数含全状态"→全量仅作取消率分母。前端 KpiDeck.tsx,修复后本条带日期转生效。

2026-10-22 已修复上线:5 处文案对齐 AC-CAL-02(订单=有效订单剔取消 / 客单价÷有效订单 / CPS÷有效订单 / 取消率分母=全量订单 / 脚注②改「仅取消率分母用全量」);web 镜像 31f9b5812522,部署前后 frontend_e2e 各一轮 ALL PASS(201 / 0 FAIL),公网 chunk page-56691201d80f3d61.js 字节验证
表文案 vs KPI_POOL desc 逐行 diff(本库新增机器可查项)生效
AC-EL-HOME-15合并视图·订单卡卡片全部平台合并 KPI:订单=AMZ+Noon 之和+件数脚注/api/dashboard/merged-kpi?brand&mode&date&date2;全部=各平台之和单位 USD(2026-09-15 用户拍板);mode rolling/calendar 禁混标(AC-KPI-03);每卡脚注=平台拆分(相加即合计,可直接对账);日级窗口金额跨平台不可加→显示"日级金额跨平台不可加"+ref 参考月合计;
当前未上线:platform="" 入口按钮 2026-09-16 下架,代码保留(AC-EL-HOME-01),复活=恢复按钮
merged-kpi 端点 vs 两平台页相加对账(脚本可复算)未上线保留
AC-EL-HOME-16合并视图·营收 USD 卡卡片AMZ 营收+Noon GMV 折 USD 合计未上线保留
AC-EL-HOME-17合并视图·净利 USD 卡卡片净利+净利率副注未上线保留
AC-EL-HOME-18合并视图·费用 USD 卡卡片AMZ 佣金FBA促销广告 + Noon 佣金配送广告未上线保留
AC-EL-HOME-19合并视图·回款 USD 卡卡片AMZ payout + Noon payout 折 USD未上线保留
AC-EL-HOME-20合并视图·取消率/ACOS 卡卡片恒"—":跨平台口径不同不展示(防混合口径失真)未上线保留
AC-EL-HOME-21合并视图·口径说明行+平台页跳转双按钮说明+按钮"合并口径: …·每卡脚注=两平台拆分"+📦Amazon/🌍Noon 平台页按钮(Noon 按钮随 hasNoon)同上;跳转=setPlatform 不换路由e2e 按钮存在与跳转未上线保留
AC-EL-HOME-22图表墙·容器卡卡片"品牌深析图表墙" + 平台口径 sub/api/dashboard/charts?brand&country&platform&(days|frm&to|mons);sub:amazon="订单级单遍聚合"/noon="月度结算口径 · 折 USD";空态 data.empty→reason 文案;加载 skeleton;错误 role=alert;墙内 KPI 卡已取消(2026-10-02 拍板 A:与 KpiDeck 重叠+费用口径分叉);全部图展开 1 行 3 个不分 tab、key 去重(2026-09-28 用户令)端点 groups/charts 结构 vs 墙渲染数(#chartwall-count)生效
AC-EL-HOME-23图表墙·品牌快切 tabs筛选墙内品牌切换(顶栏"全部品牌"时出现)顶栏选具体品牌→显示跟随标签"品牌·国家";顶栏全部→账号品牌列表 tabs(tenant_brands,铁律),记忆 pick 默认第一个;品牌永不聚合混排(2026-09-28 用户令)品牌列表=账号品牌;切换墙请求 brand 参数生效
AC-EL-HOME-24图表墙·Noon 月窗按钮组(近6/12/24月/全部)筛选Noon 墙月粒度窗口控制跟随顶部统一时间选择器(2026-10-02 台账§4-26 方案A):工具栏窗口换算涉及月份数(自定义=月份差+1;天数窗=ceil(days/31));窄窗不足 6 月按下限 6 月(2026-10-16 用户令"月度chart默认显示6个月");"全部"(0)与≥6 月窗不受影响;工具栏变→清墙内手动覆盖切工具栏窗后墙 mons 参数断言生效
AC-EL-HOME-25图表墙·排序锁按钮(🔒排序/🔓拖拽中)按钮账号级图表排序锁默认锁;解锁=图卡可 HTML5 拖拽换位,drop 即 PUT /api/dashboard/chart-order 持久化;锁定=保存当前序+locked;初始 GET 载入;新图(不在 order)排末尾;拖拽后 50ms 抑制 click 误弹模态(2026-10-02 用户令)拖拽后刷新序保持;e2e 拖放模拟生效
AC-EL-HOME-26图表墙·计数条(#chartwall-count)说明range 起→止 · 订单数 · 图数 · 窗标签 · 平台口径说明id=chartwall-count 为 e2e/审计锚点;Amazon 附"利润=结算净额−平台费用(spapi 财务事件聚合,本币按单折 USD)"、Noon 附"月度结算口径 · 本币按锚定汇率折 USD"计数条数值 vs 端点 range/orders/chart_count生效
AC-EL-HOME-27图表墙·图卡网格布局repeat(3,1fr) 一行三图事件委托点击弹模态;draggable=!locked;≤980px 3 列、≤700px 2 列(768 溢出修复 AC-UI-04 联动)768px 视口 overflow=0(AC-UI-04 探针)生效
AC-EL-HOME-28图表墙·图卡本体卡片图标题+hint+sub+GChart 渲染sub 为 YYYY-MM-DD 时显示"· 数据日";title 属性提示"点击放大/拖拽换位·点击放大";spec 全部来自 charts 端点(前端不造图)卡内容 vs 端点 spec 逐字生效
AC-EL-HOME-29图表墙·放大模态容器弹层点图卡弹出的放大层(遮罩+标题+hint+✕)fixed inset 遮罩 zIndex=1000;点遮罩关闭;✕ aria-label=关闭;标题=spec.title 回退 chartKey(2026-10-02 用户令)e2e 点卡弹出/关闭生效
AC-EL-HOME-30放大模态·品牌 select筛选弹层内独立品牌切换选项=账号品牌列表;改动→重查 charts 按 key 取 spec改品牌后图数据变化生效
AC-EL-HOME-31放大模态·国家 select筛选弹层内国家过滤,"全部国家"+动态选项选项=filters 端点 countries[platform] 随品牌联动选项 vs filters 端点生效
AC-EL-HOME-32放大模态·时间组筛选弹层内时间窗:noon=月窗四档;amazon=7/30/90/365时间窗语义与墙一致(amazon=days,noon=mons)切档后请求参数生效
AC-EL-HOME-33放大模态·图区与空态图表GChart height=420;筛选下无此图→"该筛选下无此图数据"重查后按 chartKey 找 spec,找不到=空态文案(不白屏)e2e 极端筛选空态生效
AC-EL-HOME-34Amazon 区块头标题"📦 Amazon 平台 · USD · 订单级"仅 data.amazon 存在时渲染e2e生效
AC-EL-HOME-35Noon 区块头标题"🟡 Noon 平台 · SA / AE 本币分列 · 折USD 合计"仅 data.noon 存在时渲染e2e生效
AC-EL-HOME-36Amazon 无数据空态卡空态"该筛选下无 Amazon 平台数据"platform≠noon 且无 amazon 数据时e2e 空品牌筛选生效
AC-EL-HOME-37Noon 无数据空态卡空态"该品牌无 Noon 平台业务(Noon 为 SA / AE 两国)"platform=noon 且无数据;NoonSection 内层空态(per_country/ads_30d/trend 全空)另有文案e2e生效
AC-EL-HOME-38Noon 分国家·结算明细表(表级)表格按国家分列的结算金额表,"本币分列不混加"数据=k.per_country(/api/dashboard/kpi noon 块);本币主显+折 USD 副列(AC-CAL-12);折算汇率 filters.noon_fx 单源(AC-CAL-05,锚定汇率 SA=3.75/AE=3.6725 默认值仅请求前兜底,P3-7)kpi 端点 per_country vs 表行;无混加值生效
AC-EL-HOME-39结算明细·列"国家/币种"列国家代码+币种缩写(SAR/AED)country+currency 随行;Noon 仅 SA/AE行数=有业务国家数生效
AC-EL-HOME-40结算明细·列"订单"列分国家订单数(int 千分位)Noon 月表订单口径Σ国家=总计生效
AC-EL-HOME-41结算明细·列"营收 本币/折USD" ×2列GMV 本币主显+折 USD 副显(灰)gmv_usd=null→"—"(无锚定汇率时诚实空值)本币×汇率=折USD 抽样生效
AC-EL-HOME-42结算明细·列"净额 本币/折USD" ×2列结算净额本币+折 USDnet_usd=null→"—"同上生效
AC-EL-HOME-43Noon 分国家·广告明细表(表级)表格近 30 天分国家广告表,"本币分列 · 折USD 为锚定汇率"数据=k.ads_30d(cleaned_noon_ads_daily 单源,AC-CAL-03 总额层);30 天固定窗kpi 端点 ads_30d vs 表行生效
AC-EL-HOME-44广告明细·列"国家/币种"列同结算明细——生效
AC-EL-HOME-45广告明细·列"花费 本币/折USD" ×2列广告花费本币+折 USDspends/spends_usd(锚定汇率)×汇率抽样生效
AC-EL-HOME-46广告明细·列"销售 本币"列广告销售(本币)sales;Noon 广告销售不折 USD 副显(口径仅花费折算随行)端点一致生效
AC-EL-HOME-47广告明细·列"曝光/点击"列views/clicks(int 灰显)—端点一致生效
AC-EL-HOME-48广告明细·列"订单"列广告订单数—端点一致生效
AC-EL-HOME-49自定义模块区区块CustomModules page="dashboard":账号自定义报表模块区端点 /api/reports/defs?page、/api/reports/fields、/api/reports/query、defs POST/PUT;明细元素条目归 AC-EL-CMP 深化(本库待建行)defs 列表渲染;查询表格出数待深化

§11.2 图表墙图型清单(AC-EL-HOME-A##/N##,由 /api/dashboard/charts spec 驱动;标准=端点下发 key/title/hint/kind 与本表逐字一致、墙内去重全展开;验证=charts 响应机器比对)

ID元素(key·标题)图型描述(hint 原文)定义验证方法状态
AC-EL-HOME-A01dailyRev·每日营收图·line按天看销售额走势,识别增长或下滑拐点/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A02dailyCnt·每日订单数图·bar按天看订单量走势,配合营收判断客单价变化;* = 当日进行中(半日)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A03dailyProfit·每日利润走势图·line每天净利润(营收−平台费用)变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A04monthlyGmv·月度 GMV图·barUSD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A05monthlyNet·月度结算净额图·barUSD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A06weeklyOrders·每周订单图·bar件 · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A07weeklyRev·每周营收图·bar按周看销售趋势,平滑日常波动/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A08cumRev·累计营收图·line从区间起点到当前的累计销售额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A09aovTrend·客单价趋势图·line平均订单金额随时间变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A10hourly24·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图;x=00–23 时,series=品牌逐线,无品牌数据时补零线charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A11statusPie·订单状态构成图·pieShipped / Canceled / Pending 等状态占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A12statusTime·订单状态随时间图·stack各状态数量按月变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A13cancelRate·每日取消率图·line取消订单占比走势,异常升高需排查/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A14shipCancel·发货 vs 取消趋势图·line发货量增 + 取消量降 = 健康/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A15dow·星期订单分布图·bar一周中哪天单量最高(广告投放参考)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A16hourDist·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A17promoTime·促销订单趋势图·line促销订单(促销费>0)随时间变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A18fbaMfn·每日 FBA vs MFN 订单图·stack两种配送方式每日单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A19valueDist·订单金额分布图·bar订单金额区间统计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A20multiSku·单 SKU vs 多 SKU 订单图·pie一单买一个 vs 一单买多个/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A21aging·发货时效分布图·bar已发货订单从下单到发货的等待天数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A22monthCancel·月度取消数图·bar每月取消订单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A23fulfillPie·配送渠道占比图·pieFBA vs MFN(自发货)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A24salesChan·销售渠道占比图·pie各销售渠道订单比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A25promoPie·促销 vs 非促销订单图·pie依赖促销出单的程度/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A26itemsPerOrder·单均件数趋势图·line平均每笔订单购买件数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A27ordersPerItem·每单件数分布图·bar1件/2件/3件…订单数分布/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A28revPerItem·单品营收趋势图·line总营收 ÷ 商品件数(单件产出)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A29monthProfit·月度利润走势图·bar每月净利润变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A30monthSettle·月度结算总额图·bar每月 Amazon Settlements 实际打款/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A31monthFee·月度费用走势图·bar每月平台扣费(佣金+FBA+促销+其他)变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A32monthSettleRate·月度回款率图·line已回款订单营收 ÷ 总营收(派生口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A33avgFee·单均费用趋势图·line平均每笔订单的平台扣费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A34feeVsSettle·费用 vs 回款(月)图·line同一时间轴对比平台扣费与实际打款/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A35feeComp·费用构成图·pie佣金 / FBA / 促销 / 其他占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A36settleStatus·回款状态金额图·pie已回款 vs 待回款 vs 其他(订单营收口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A37dailyFee·每日费用图·bar每天平台扣费金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A38monthFeeRatio·月度费用占比图·line费用 ÷ 营收/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A39dailySettle·每日回款口径营收图·line已回款订单的每日营收(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A40curRev·分币种营收图·pieUSD / SAR / AED 等币种销售分布(本币)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A41settleCur·分币种回款图·pie已回款订单各币种营收(本币,派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A42orderCur·分币种订单数图·pie各币种订单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A43revChan·分渠道营收图·hbar各销售渠道销售额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A44profChan·分渠道利润图·hbar各渠道净利润/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A45settleRateChan·分渠道回款率图·hbar各渠道已回款营收占比(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A46last24Country·最近数据日分国家订单图·pie各站点最近一天的单量分布/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A47countryRev·分国家营收图·hbar各国销售额对比,找出主力市场/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A48countryProfit·分国家利润图·hbar卖得多不一定赚得多/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A49countrySettle·分国家结算金额图·hbar各国实际结算净额(回款)对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A50countryShare·国家订单占比图·pie各国订单份额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A51countryAov·分国家客单价图·hbar各国平均每单金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A52countryMargin·国家利润率图·hbar各国净利润率/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A53countryFeeRate·国家费率图·hbar各国平台扣费比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A54countrySettleRate·国家回款率图·hbar各国结算净额 ÷ 营收,回款效率对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A55countryCancelRate·国家取消率图·hbar各国取消订单比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A56countryCancel·分国家取消订单数图·hbar各国取消订单量,找出异常站点/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A57countryFba·FBA 费用分国家图·hbar各国 FBA 物流费对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A58countryComm·佣金分国家图·hbar各国平台佣金对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A59countryCommRate·分国家佣金率图·hbar各国佣金比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A60countryPromo·分国家促销返点图·hbar各国促销补贴金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A61countryRefund·分国家退款件数图·hbar各国退款退货量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A62countryFbaMix·FBA vs MFN 分国家图·stack各国配送方式占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A63countryItems·分国家单均件数图·hbar各国平均每单件数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A64countryShipDays·分国家平均发货天数图·hbar各国物流时效(下单→发货)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A65countryFbaUnit·分国家单件 FBA 费图·hbar各国每件物流费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A66top3FeeTrend·Top 3 国家费率趋势图·line(f-string 动态) f"营收前三({'、'.join(top3c)})费率按月变化"/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A67top5CountryDaily·Top 5 国家每日订单图·line单量最高的 5 个国家每日走势/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A68fbaMonthly·FBA 费用按月图·bar物流费月度走势(spapi 财务事件四项合计)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A69skuMargin·SKU 利润率图·hbar负值 = 亏损品(营收 Top,费用事件已到)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A70skuFeeRate·SKU 费率图·hbar每个产品的平台扣费比例(营收 Top,费用事件已到)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A71skuUnits·热卖 SKU(按件数)图·hbar畅销品排行,快速了解主力产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A72skuRev·营收 Top SKU图·hbar贡献销售额最多的产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A73skuProfit·利润 Top SKU图·hbar与营收榜对比可发现高营收低利润品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A74skuSettle·回款口径 Top SKU图·hbar已回款订单营收最多的产品(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A75skuCnt·SKU 订单数 Top 15图·hbar订单量最高的 15 个产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A76top3SkuDaily·Top 3 SKU 每日营收图·line(f-string 动态) f"营收前三({'、'.join(sku_label(k) for k in sku_rev_top)})每日表现"/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A77rating·产品评分分布图·hbar各 Listing 当前星级(rankings 快照)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A78reviews·评论数对比图·hbar各产品评论数量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A79bsrSmall·小类 BSR图·hbar细分类目排名(越低越好)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A80bsrBig·大类 BSR图·hbar大类目排名(越低越好)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N01nGmvBar·月度 GMV图·bar折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N02nNetBar·月度结算净额图·bar折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N03nWeeklyOrders·每周订单图·bar件 · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N04nDailyRev·每日营收图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N05nDailyCnt·每日订单数图·bar件/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N06nDailyProfit·每日利润走势图·line折 USD · 结算净额−佣金−履约费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N07nWeeklyRev·每周营收图·bar折 USD · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N08nAovTrend·客单价趋势图·line折 USD · 营收÷订单/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N09nStatusPie·订单状态构成图·pie件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N10nCancelRate·每日取消率图·line% · 取消件÷订单/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N11nCountryCancel·分国家取消订单数图·hbar件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N12nFeeStack·月度费用构成图·stack折 USD · 8 项平台费用拆解/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N13nCurRev·分币种营收图·pie本币 · SAR/AED/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N14nCountryMon·国家 × 月营收图·stack折 USD · 堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N15nCountryGmv·国家营收排名图·hbar折 USD · 窗口合计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N16nCountryShare·国家营收份额图·pie折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N17nCountryOrders·国家 × 月订单数图·stack堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N18nTopSku·Top 15 SKU 营收图·hbar本币 · 按营收排序/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N19nTopSkuTrend·Top 5 SKU 月度营收图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N20nBrandMon·品牌 × 月营收图·stack折 USD · 堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N21nModelTop·Top 10 型号营收图·hbar本币 · sku_mapping 归并型号/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N22nSkuUnits·热卖 SKU(按件数)图·hbar件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效

§11.3 SKU 主表(AC-EL-SKU,web/components/SkuMasterTable.tsx 268 行 + /api/dashboard/sku-matrix;2026-10-12 三卡合并用户拍板:Top15×2+SKU销量明细+四维矩阵→一张全量表)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SKU-01表卡标题标题"SKU 主表 · 平台 × 国家 × 品牌 × SKU 全量 · 15 列含税口径 · 默认营收降序 · 独立时间选择器"位于页面最底部(自定义模块之前,2026-09-28 用户令);时间选择器独立于工作台全局选择器e2e 标题渲染生效
AC-EL-SKU-02时间预设(7/30/90 天)+起止双输入筛选表内独立时间窗预设=北京锚 daysAgo(n)~bjToday();改动翻页重置 page=1;双输入 type=date请求 date_from/date_to 断言生效
AC-EL-SKU-03平台组(全部/Amazon/Noon)筛选表内平台过滤默认全部请求 platform 断言生效
AC-EL-SKU-04国家下拉筛选跟随工作台国家选项,且随全局选择联动countryOpts 传入;全局 country 变化→表内同步(useEffect)联动断言生效
AC-EL-SKU-05⬇ 导出 CSV 按钮按钮按当前筛选导出全量 CSV请求带 export=1;22 列 CSV(BOM 头防 Excel 乱码);文件名 sku_master_{brand}_{from}_{to}.csv;含引号/逗号转义导出行数=total;列头 22 项生效
AC-EL-SKU-06数据质量警示条(⚠ chips)徽标六类口径/覆盖警示黄条flags:ads_note(广告覆盖说明)/ads_sku_note/fee_lag_brands(费用滞后品牌)/old_seg_brands(旧段品牌)/onno_gap(onno 缺口:日期段+缺单数+缺金额)/noon_unsettled_months(Noon 未出账月)sku-matrix flags vs chips 渲染生效
AC-EL-SKU-07列·平台列📦 Amazon / 🟡 Noon——生效
AC-EL-SKU-08列·国家列国家代码空→"—"—生效
AC-EL-SKU-09列·品牌列色点+品牌名branddot=brandColor()(AC-UI-07)色值级联生效
AC-EL-SKU-10列·SKU(可排序)列SKU + 行级标记flags 含 fees_alloc→"·近似分摊";含 unsettled→"·未出账"排序请求;标记渲染生效
AC-EL-SKU-11列·产品名列sku_mapping 规范名product_name 优先(AC-CAL-10);空→"—"名称≠ASIN 抽样生效
AC-EL-SKU-12列·ASIN列ASIN(灰显)空→"—"—生效
AC-EL-SKU-13列·售价(可排序)列AMZ=$两位小数;Noon=本币price=null→"—"币种正确生效
AC-EL-SKU-14列·销量(可排序)列件数(加粗)AMZ=行级 items⋈orders 订单日切;Noon=行级订单事件日切(金额才月对齐,销量不月对齐)抽样 SQL 复算生效
AC-EL-SKU-15列·订单数(可排序)列行级订单数同上行级日切抽样复算生效
AC-EL-SKU-16列·营收(可排序)列AMZ=USD 单值;Noon=本币主显+$折USD 副行AMZ=行级订单日切;Noon=pl P&L 月对齐(§89 方案A:窗口触月整月计入)两口径脚注在案;抽样对账生效
AC-EL-SKU-17列·广告费(可排序)列同上双币显示AMZ=ads_sku_daily∪amazon_ads_daily 并集原值(AC-CAL-04;未全覆盖约29%披露);Noon=花费×(1+SA15%/AE5%) 含税上浮并集合计=平台汇总生效
AC-EL-SKU-18列·佣金(含税)(可排序)列结算实扣=天然含税AMZ=fin_daily 费用;Noon=月表 commission抽样复算生效
AC-EL-SKU-19列·尾程(含税)(可排序)列FBA/配送费,结算实扣Noon=delivery_fee抽样复算生效
AC-EL-SKU-20列·利润(可排序)列=营收−佣金−尾程−其他−代扣VAT−广告;负值红字加粗AMZ/Noon 同公式异源(见 16-19)公式复算抽样生效
AC-EL-SKU-21列·利润率(可排序)列利润÷营收,pct 一位小数null→"—"复算生效
AC-EL-SKU-22合计行(tfoot)行全量合计:件/单/营收/广告/佣金/尾程/利润(两平台 USD 折算相加)营收合计下 Noon 本币分项副行(如"1,234,567 SA + 567,890 AE");利润合计负值红;利润率列合计恒"—"Σ列=合计;分项币种直加禁生效
AC-EL-SKU-23分页条分页上一页/下一页 + "第 x / y 页 · 共 N 行"page_size=50;total≤50 不渲染翻页请求 page生效
AC-EL-SKU-24空态/加载态空态"该筛选组合暂无数据"/"加载中…"items=0→空态;未载→加载态e2e生效
AC-EL-SKU-25口径脚注(表底)说明AMZ/Noon 两段完整口径说明+数据窗口+Noon 触月列表AMZ:行级订单日切·结算实扣天然含税·广告已授权账户原值(未全覆盖约29%)·利润公式;Noon:本币 SA=SAR/AE=AED 锚定汇率折USD·金额月对齐§89 方案A·销量订单日切·广告×(1+SA15%/AE5%)·valid_units 源头恒0不采用;动态尾缀=数据窗口 from~to+触月脚注文案逐字(AC-UI-01)生效

§11.4 今日页(/today · AC-EL-TODAY,32 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-TODAY-001页标题/面包屑 @页头静态「今日 · 今日经营 · 数据每 2 小时增量更新」AppShell title/crumb;「每 2 小时」=worker 增量拉取节奏;页级数据日锚 day=max(purchase_date)(AMZ)/max(order_placed_at::date)(Noon)——对齐订单最大日而非 sales_hourly 最大日(2026-09-09 fittingirls 零订单日案例在案)e2e 断言 crumb 文案生效
AC-EL-TODAY-002错误横幅 @页顶反馈接口失败时红条展示错误消息err state ← getJson catch断网/坏参数 e2e 断言 role=alert生效
AC-EL-TODAY-003平台筛选标签组 @工具条筛选全部平台/Amazon/Noon 三标签platform state;选项经 /api/dashboard/filters?brand= 推导,Noon 按钮仅 platforms.noon 非空时渲染(brands_source 注册表 platform='noon' 品牌非空);切品牌后当前平台无数据自动回落「全部平台」(page.tsx:53-54) |交互:单击切换,触发重拉SQL brands_source noon 品牌数 vs 按钮 presence;纯 Amazon 租户无 Noon 按钮生效
AC-EL-TODAY-004国家下拉 @工具条筛选平台后级联国家单选options=filters.countries[platform](Amazon=cleaned_amazon_orders DISTINCT country;Noon=cleaned_noon_sku_pl_monthly DISTINCT country);platform="" 时 disabled 显示「先选平台」;选项变更后已选国家不在列表则清空(:72-74) |交互:change 重拉选 Amazon→下拉列出订单表实有国家生效
AC-EL-TODAY-005更新于时间戳 @工具条右侧状态「更新于 HH:MM:SS」loadedAt=每次成功响应时 toLocaleTimeString('zh-CN',{hour12:false})肉眼/快照生效
AC-EL-TODAY-006自动刷新开关 @工具条右侧开关「◉ 自动刷新开 / ○ 自动刷新关」auto state;开时 60s interval 且仅 document.visibilityState==='visible' 才 setTick(切后台暂停,page.tsx:63-69) |交互:单击切换e2e 点按后 class 变化生效
AC-EL-TODAY-007手动刷新按钮 @工具条右侧按钮「↻ 刷新」setTick+1 触发 useEffect 重拉 /api/today |交互:单击e2e生效
AC-EL-TODAY-008全部平台提示卡 @工具条下(仅 platform="")提示⚠ 「全部平台」视图当前仅聚合 Amazon 订单数据;Noon 实时数据请切换 Noon 标签条件渲染 platform==="";诚实披露聚合边界e2e 默认视图文案存在生效
AC-EL-TODAY-009Noon 数据源说明卡 @Noon 视图顶部说明卡h2「Noon 平台 · 今日实时」+ sub「数据源 noon_orders · 按日数据 · 订单=去重单号 · 件数=件级行 · 状态标注」+ 今日/昨日日期行 + 状态词释义(cancelled=取消, cir=客户主动退货, undeliverable=无法送达)day=max(order_placed_at::date),prev_day=day−1;无数据返回 noon_no_realtime=true 且全空文案断言;API 空态响应生效
AC-EL-TODAY-010Noon KPI·今日订单 @Noon KPI 行KPI卡今日订单数+昨日对比+环比%/api/today platform=noon → audit.cleaned_noon_orders count(DISTINCT order_nr)(2026-09-26 D批P2-2:件级行误当订单数修正);delta=(cur−prev)/prev,prev=0/缺失显「—」,升绿降红SQL 同日 count(DISTINCT order_nr) 对拍生效
AC-EL-TODAY-011Noon KPI·今日件数 @Noon KPI 行KPI卡件数+昨日+环比%同表 count(*)(件级行数)SQL count(*) 对拍生效
AC-EL-TODAY-012Noon KPI·取消 cancelled @Noon KPI 行KPI卡取消件数(红)count(*) FILTER (WHERE item_status='cancelled');foot=昨日同口径SQL FILTER 对拍生效
AC-EL-TODAY-013Noon KPI·客户退货 cir @Noon KPI 行KPI卡退货件数(橙 warn)count(*) FILTER (item_status='cir')同上生效
AC-EL-TODAY-014Noon KPI·无法送达 @Noon KPI 行KPI卡undeliverable 件数(红)count(*) FILTER (item_status='undeliverable')同上生效
AC-EL-TODAY-015Noon KPI·已送达 @Noon KPI 行KPI卡delivered 件数(绿)count(*) FILTER (item_status='delivered')同上生效
AC-EL-TODAY-016Noon KPI·已发货 @Noon KPI 行KPI卡shipped 件数(默认色)count(*) FILTER (item_status='shipped')同上生效
AC-EL-TODAY-017Noon KPI·已导出 @Noon KPI 行KPI卡exported 件数count(*) FILTER (item_status='exported')同上生效
AC-EL-TODAY-018Noon 分品牌表 @Noon 双卡左表格品牌×(订单/件数/取消/退货/无法送达)day 当日 GROUP BY brand ORDER BY 订单 DESC;品牌列带 brandColor() 色点(AC-UI-07);空态行「今日暂无数据」colSpan=6SQL 分组对拍生效
AC-EL-TODAY-019Noon 分国家表 @Noon 双卡右表格国家×同五列GROUP BY country ORDER BY 订单 DESC;空态「本月暂无数据」(文案沿用)SQL 分组对拍生效
AC-EL-TODAY-020KPI·今日订单(Amazon) @主 KPI 行(platform≠noon)KPI卡「今日订单(MM-DD)」+昨日+环比%+Pending 附注/api/today Amazon 分支:audit.cleaned_amazon_orders purchase_date=day count(*)(当日全量含取消/Pending,实时口径非 AC-CAL-02 有效订单);canceled 另卡呈现;pending>0 时附「含 Pending N 单 · 金额待结算」(warn 色)SQL 当日 count(*) 对拍;与「今日订单=有效订单」误用区分(页面无剔取消声明,验收按全量)生效
AC-EL-TODAY-021KPI·今日件数 * @主 KPI 行KPI卡件数+昨日+环比%,标签带 *sum(coalesce(nullif(items_count,0), array_length(string_to_array(sku_list,','),1), 1))——Pending 单 Amazon 不回传件数按 SKU 清单估、皆缺按 1(2026-09-12 修,2026-09-26 E批P3-6 全站口径) |交互:悬停 title「Pending 未确认单按 SKU 清单估算」SQL 同式对拍生效
AC-EL-TODAY-022KPI·今日营收 @主 KPI 行KPI卡营收 USD+昨日+环比%sum(revenue_usd)(当日全量,usd() 千分位 2 位);pending>0 附「N 单 Pending 金额未计入」SQL sum 对拍生效
AC-EL-TODAY-023KPI·今日净利 @主 KPI 行KPI卡净利 USD+昨日(无环比)sum(net_usd) 当日全量;净利口径见 AC-CAL-01SQL sum(net_usd) 对拍生效
AC-EL-TODAY-024KPI·Prime/取消 @主 KPI 行KPI卡Prime 占比%(取整)+「取消 N 单」prime% = round(count(is_prime)/count(*)*100);orders=0 显「—」;canceled=count(order_status='Canceled')(仅美式拼写单值过滤)SQL 复算生效
AC-EL-TODAY-025分国家小时订单图 @主视图卡1折线图每国家今日实线+昨日合计虚线,x=0–23 时EChart;hourly_today=cleaned_sales_hourly day=当日 GROUP BY hour,country sum(orders)(北京时间);昨日合计=day−1 同表 sum(hour);颜色 COUNTRY_COLORS 7 色循环;虚线 #94a3b8 无点;空态「暂无小时数据」/加载态 |交互:legend 滚动、tooltip axisSQL sales_hourly 对拍生效
AC-EL-TODAY-026SKU TOP20 条形图 @grid2c 左条形图今日件数 TOP20 SKU(hbar)by_sku:当日剔取消单(NOT IN ('Canceled','Cancelled','cancelled'))sku_list 拆分,件数按订单内 SKU 数均摊 est=items_count>0?items_count:len(parts),每 SKU += est/len(parts),round 取整,取前 20(T2-7) |交互:GChart 渲染SQL 均摊复算对拍生效
AC-EL-TODAY-027小时×国家堆叠柱 @grid2c 右堆叠柱图24 小时×国家堆叠订单量同 hourly_today 数据;bar stack='t' barMaxWidth=18,x 轴「N时」;空态「暂无小时数据」 |交互:tooltip/legend对拍 25生效
AC-EL-TODAY-028小时×国家明细表 @主视图卡4表格行=小时(该时合计 0 整行跳过),列=国家(排序)+合计列,末行合计行cell=hourly_today find(hour,country) orders ?? 0;0 值格显 muted「·」;表头国家列来自数据 DISTINCT行/列/总和 SQL 三向对拍生效
AC-EL-TODAY-029分国家今日表 @grid2c(下方)左表格国家×(今日/昨日/变化%)by_country=cleaned_amazon_orders 当日与昨日 count(*) FILTER(purchase_date=...) GROUP BY country ORDER BY 今日 DESC;country 空→「—」;delta 着色SQL 对拍生效
AC-EL-TODAY-030分品牌今日表 @grid2c(下方)右表格品牌×(订单/件数/营收 USD/Pending)by_brand=当日 count(*)、件数兜底同 21、sum(revenue_usd)、count FILTER(Pending);品牌色点 branddot;Pending>0 warn 色;空态「暂无数据」SQL 对拍生效
AC-EL-TODAY-031Pending 脚注 @分品牌表下脚注「Pending = 平台尚未确认结算的订单(金额暂缺属正常);长期不转化=采集侧状态回刷问题,见数据管道页水位」静态口径文案文案断言生效
AC-EL-TODAY-032页脚数据链路说明 @页底脚注SP-API 采集库→每 2 小时增量(今日订单+小时销量)→只读库;「今日」=最新数据日北京时间;* 件数估算口径静态文案断言生效

源码实证注记:待核:0。注:今日页 Amazon KPI 口径=当日全量(含取消/Pending),与 AC-CAL-02 看板 30 天有效订单口径不同属页面定位差异,验收按本表口径。

§11.5 订单页(/orders · AC-EL-ORDER,26 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-ORDER-001页标题/面包屑 @页头静态「订单 · Amazon 订单明细 · 三品牌统一(订单主表口径)」AppShell title/crumbe2e 文案断言生效
AC-EL-ORDER-002错误横幅 @页顶反馈接口失败红条err ← getJson catchrole=alert生效
AC-EL-ORDER-003KPI·订单数(当前筛选) @KPI 行KPI卡当前筛选总单数+有效/已取消拆分total=筛选内 count(*)(含取消);foot「有效订单 N · 已取消 M」M=total−valid;valid=count FILTER(order_status NOT IN ('Canceled','Cancelled','cancelled'))(D批P3-1 三拼写对齐)SQL 同 where 复算 total/valid生效
AC-EL-ORDER-004KPI·营收 USD @KPI 行KPI卡筛选内有效订单营收sum(revenue_usd) FILTER 剔取消;valid=0 显「—」不显误导 $0.00(D批P3-4),foot「当前筛选无有效订单(全为取消单)」;正常 foot「有效订单口径(不含取消)」SQL 对拍;全取消筛选下断言「—」生效
AC-EL-ORDER-005KPI·件数 @KPI 行KPI卡筛选内有效订单件数sum(items_count) FILTER 剔取消;valid=0 显「—」SQL 对拍生效
AC-EL-ORDER-006KPI·客单价 @KPI 行KPI卡AOV=营收/有效订单aov=sum(rev)/valid(valid=0 为 0.0 前端显「—」),usd 2 位;foot「营收 / 有效订单」复算生效
AC-EL-ORDER-007KPI·状态分布 @KPI 行(仅 by_status 非空首项渲染)KPI卡每状态一行「status:N 单 · 金额」by_status=GROUP BY order_status count(*)+sum(revenue_usd)+sum(items_count)+rev_missing(revenue_usd IS NULL 计数);Pending/Unshipped 且 rev_missing>0 → 全缺显「金额待结算」、部分缺显「$X · N/M 单待结算」(2026-10-01 拍板②-B2 误导性 0 铁律)SQL 复算 rev_missing生效
AC-EL-ORDER-008状态筛选按钮组 @明细卡工具条筛选全部/已发货/待发货/未发货/已取消key=空/Shipped/Pending/Unshipped/Canceled,SQL o.order_status=精确等值 |交互:单击重置页码点「已取消」→ total=取消单数生效
AC-EL-ORDER-009快捷天数下拉 @工具条筛选全部时间/近1年/近90天/近30天days=N → purchase_date >= 北京时区 today−(N−1)(含界 N 自然日,2026-09-28 A1 与 KPI 对齐;D批P3-2 北京日切) |交互:change 清空 frm/to 重置页码30 天窗 SQL 边界日对拍生效
AC-EL-ORDER-010国家下拉 @工具条筛选全部国家+固定 17 国清单COUNTRIES=US,CA,MX,GB,DE,FR,IT,ES,SE,BE,NL,PL,IE,AU,JP,SA,AE(2026-09-28 C7 与库存页同源;无数据国家=0 行如实显示) |交互:change 重置页码选无数据国家→空表生效
AC-EL-ORDER-011自定义日期区间 frm/to @工具条筛选起止日期双输入(title 含首尾)frm/to=YYYY-MM-DD 双闭区间;非法非空输入 API 400「日期格式非法」(P3 补验轮,原静默忽略);设区间自动 days=0(两窗不并存);to min=frm / frm max=to |交互:change 互斥快捷窗frm=2026-13-45 → 400 断言生效
AC-EL-ORDER-012清除区间按钮 @工具条(仅 frm/to 非空)按钮清空自定义区间setFrm/setTo 空串+重置页码 |交互:单击出现/消失条件断言生效
AC-EL-ORDER-013搜索框+搜索按钮 @工具条右筛选「搜索订单号 / SKU」search → amazon_order_id ILIKE %q% OR sku_list ILIKE %q%;form submit 才置 query(输入不即搜) |交互:回车/点搜索输入部分单号断言结果集生效
AC-EL-ORDER-014订单明细表容器 @主卡DataTable明细表+CSV 导出+分页+口径脚注exportCsv="orders";pager page/pages/total pageSize=20(API 上限 100);caliber 行=「金额=USD(订单级)|数据源=订单主表+order_fees…|营收=revenue_usd(非取消单)」;empty=「无匹配订单」;排序 purchase_date DESC, amazon_order_id |交互:列头排序/翻页/导出 CSV翻页断言 total 不变生效
AC-EL-ORDER-015列·订单号 @明细表列brandColor 色点+订单号amazon_order_id;色点=brandColor(brand)(AC-UI-07) |交互:可排序色点颜色=品牌注册色生效
AC-EL-ORDER-016列·下单日期 @明细表列muted 数字日期purchase_date 字符串;可排序 |交互:排序格式断言生效
AC-EL-ORDER-017列·国家 @明细表列国家码country |交互:排序—生效
AC-EL-ORDER-018列·状态 @明细表列状态徽章badge class=ST_BADGE[status]:Shipped=ok(绿)/Pending·Unshipped=warn(橙)/Canceled=dim(灰),未知=dim;文案=status_cn||status(中文缺失回退英文原值)status生效
AC-EL-ORDER-019列·渠道 @明细表列履约渠道+Prime 标fulfillment_channel + is_prime 时「 · Prime」;CSV 同款—生效
AC-EL-ORDER-020列·件数 @明细表列整数右对齐items_count;可排序 |交互:排序—生效
AC-EL-ORDER-021列·本币金额 @明细表列「CUR N,NNN.NN」或「—」currency=coalesce(o.currency, marketplaces.currency, 'USD')(GB→UK 映射);local_amount null→「—」;toLocaleString 2 位抽样 JP 单显 JPY生效
AC-EL-ORDER-022列·营收 USD @明细表列加粗 USD 金额revenue_usd=本币/锚定汇率(fx 链在 ingest),usd 2 位;null→usd(null);可排序(null 排 −1) |交互:排序—生效
AC-EL-ORDER-023列·回款状态 @明细表列回款徽章is_abnormal→「回款异常」bad(红);否则 settlement_status 映射 已回款=ok/待回款=warn/已取消=dim/空=「—」异常单红徽章断言生效
AC-EL-ORDER-024列·SKU @明细表列SKU 清单截断sku_list 逗号清单,260px ellipsis 单行截断,空=「—」;CSV 全量 |交互:悬停看全(title 无,视觉截断)长清单截断样式生效
AC-EL-ORDER-025表脚注 @主卡底脚注数据源与口径说明「订单主表+按品牌分表财务明细视图;营收 USD=本币/fx();无财务明细列品牌回款状态按订单状态推导;快捷窗口=N 自然日(北京时区·含首尾,2026-09-28 起与工作台 KPI 30 天口径一致)」文案断言生效
AC-EL-ORDER-026自定义模块挂载位 @页底组件CustomModules page="orders"租户自定义模块位(见 AC-EL-CMP) |交互:随租户配置—生效

源码实证注记:待核:0。权限:require_module("orders")——未开通模块租户 403。注:状态筛选 status=精确匹配 order_status 原值('Cancelled' 英式拼写单在已取消筛选下不命中,仅影响三拼写并存历史数据,验收时以 SQL 实值为准)。

§11.6 财务页(六张大表列级条目下一批逐列展开)(/finance · AC-EL-FIN,64 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-FIN-001AppShell 标题/面包屑 @顶栏导航标题"财务"+面包屑"全维度损益与口径披露"page.tsx 静态常量,路由 /finance |交互:面包屑回上级浏览器开页标题可见生效
AC-EL-FIN-002错误横幅 @页首提示条data.error 时红条 role=alertuseFullBlock('hero') error 态;触发= /api/finance/full 非200断网/mock 观察生效
AC-EL-FIN-003⚠数据质量提示条 @页首提示条"N 个 SKU 缺采购成本映射(COGS按0计,毛利高估)"+去维护按钮/full 返回 unmapped_sku_count(cost CTE 中 coalesce(m.cost_rmb,pc.cost_rmb,0)=0 计数) |交互:按钮→/mapping构造缺映射 SKU 观察条出现生效
AC-EL-FIN-004平台选择器 @全局分段按钮Amazon/Noon 两枚,默认 amazon;无 all(2026-09-27 用户令砍掉)前端 state platform;控制 KpiSection 分支与页签可见性 |交互:切换重载noon 下 monthly/years 页签隐藏生效
AC-EL-FIN-005全局时间范围 @全局下拉全部/今年/本月/上月/近3月/近12月 6档timeParams 折算 mstart/mend 传 /full |交互:切档刷新请求参数随档变化生效
AC-EL-FIN-006财务 AI 分析师 @侧栏AI入口useAIContext('finance') 3 预设前端 hook 注入页面上下文 |交互:打开面板面板含财务预设生效
AC-EL-FIN-007盈利总览块 BlockBar @卡头筛选器国家pills+时间pills(7档+自定义起止date)独立 useFullBlock('hero'),参数 country/time |交互:pill 切换请求参数同步生效
AC-EL-FIN-008卡标题行 @卡头标题"盈利总览"+sub(品牌·Amazon·月·USD·环比)brand/platform/时间档拼装静态核对生效
AC-EL-FIN-009KPI卡1 净收款 @六卡KPINet Proceeds 值+Delta环比%+foot"未扣平台费·上月对比"/full rows.rev=Σrevenue_usd(未扣平台费);AC-CAL-01 起点项;环比=(当期−上期)/上期SQL Σrevenue_usd 同窗相等生效
AC-EL-FIN-010KPI卡2 结算净额 @六卡KPI值+Delta+foot"已扣佣金FBA促销"fin.net=rev−comm−fba−promo−other−vat;AC-CAL-01SQL 复算相减生效
AC-EL-FIN-011KPI卡3 毛利润 @六卡KPI值+Delta+毛利率footgross=net−ad;毛利率=gross/rev;AC-CAL-01复算生效
AC-EL-FIN-012KPI卡4 净利润 @六卡KPI值+Delta+净利率foot;底色正绿负红net2=gross−cost;cost=件数×(sku_mapping.cost_rmb 回退 procurement)÷RMB_USD(2026-09-26 C批P1-6 拍板);AC-CAL-01复算+正负换色生效
AC-EL-FIN-013KPI卡5 广告 @六卡KPI广告花费+广告销售 foot+上月ads=cleaned_ads_sku_daily ∪ cleaned_amazon_ads_daily 双源并集(P1-17/18 修)双源并集复算生效
AC-EL-FIN-014KPI卡6 平台回款 @六卡KPIPayout+foot"Settlements 月度打款"pay=Σcleaned_amazon_settlement_monthly.payout_usd;AC-CAL-08 回款层SQL 对表相等生效
AC-EL-FIN-015瀑布 flowbar @卡中图7步:净收款→−平台费→结算净额→−广告→毛利润→−采购→净利润平台费=rev−net;其余同 KPI 卡公式末值=KPI净利润;各步代数和=首值生效
AC-EL-FIN-016底部指标行 @卡底指标条7项:订单/销售件数/取消订单/退款件/ACOS/TACOS/VAT订单=aord FILTER 剔取消三变体(AC-CAL-02);取消=can WHERE order_status='Canceled' 单变体;退款件=ret Σunits;ACOS=ad/ad_sales、TACOS=ad/rev 均 mon_ratios 后端单源(C3批#60);色=阈值 API /api/metric-thresholds(AC-CAL-06 健康线);VAT=order_fees.vat 官方税额SQL 复算+阈值改 API 色变生效
AC-EL-FIN-017分市场块 BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('ckB') |交互:同007同007生效
AC-EL-FIN-018月份下拉 @卡头下拉2026-01→当前月,默认最新月由 rows 月份集合生成;控制 kpi-wall mon 参数 |交互:切月刷新参数同步生效
AC-EL-FIN-019分市场表 @卡体表格表头17列:市场/订单/已结算/销售件数/取消订单/本土币营收/净收款/佣金/尾程配送FBA/结算净额/广告/VAT/毛利润/毛利率/采购成本/净利润/回款;行=全市场+countries;本币列显 local 无则USD;采购成本原生 RMB¥;净利润全程 USD/api/finance/kpi-wall;订单=aord 剔取消(AC-CAL-02);已结算=has_finance 计数;取消=can 'Canceled';待核①:表头17 th vs 行渲染18 td(第5 td=pending 在途 muted 无对应表头,其后 canceled 错位到"本土币营收"名下)→ 列头与数据错位一格候选,浏览器验收必须数列。

2026-10-22 补翻换绿:表头已补「在途 Pending」(finance/page.tsx:729,表头 18=行渲染 18),_gate_fin_th_20261022 门禁已过;待核① 系早间修复后本行漏翻,今对账补正 |交互:行悬停
th 数=td 数;抽行 SQL 复算生效
AC-EL-FIN-020Amazon 销量柱状图 @卡体图Orders bar+Net Profit line,dataZoom同 kpi-wall 月份序列 |交互:缩放图值=表值生效
AC-EL-FIN-021Annual Summary 卡 @卡体表格10列:产品/订单/件数/净收款/结算/广告/毛利润/净利润/毛利率/Net per Unit;空态"无数据"kpi-wall annual 段(按产品年聚合)年合计=12月和生效
AC-EL-FIN-022页签行 @主区tabs5枚:品牌月度矩阵(默认)/📈盈利矩阵/产品损益/月度对账/年度对比前端 state tab;monthly/years 仅 amazon 渲染 |交互:切tabnoon 下仅3枚生效
AC-EL-FIN-023趋势块 BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('trendB') |交互:同007同007生效
AC-EL-FIN-024月度营收·净利·回款图 @卡体双轴图月度营收 bar+净利润 line+回款 dashed line/full matrix 段逐月 rows与027表逐月相等生效
AC-EL-FIN-025费用结构堆叠图 @卡体堆叠图佣金/FBA/促销/广告/VAT 五层同上字段五层和=净收款−其他费生效
AC-EL-FIN-026矩阵卡 BlockBar+年份下拉+导出 @卡头筛选器/按钮国家+时间 pills;年份下拉;导出ExceluseFullBlock('mxB');导出=前端xlsx |交互:导出文件行数=表行数生效
AC-EL-FIN-027品牌×月度全维度矩阵 @卡体表格23列:月份/品牌/订单/已结算/销售件数/取消订单/有效订单/净收款/佣金/FBA/促销/广告/广告销售/ACOS/TACOS/VAT/采购成本/结算净额/毛利润/毛利率/净利润/回款/退款件/full matrix:订单=aord 剔取消(AC-CAL-02);有效订单=订单−取消 前端派生;gross=net−ad;ACOS=ad/ad_sales;TACOS=ad/rev;AC-CAL-01 |交互:导出Excel抽1月 SQL 复算全列生效
AC-EL-FIN-028分市场 KPI 卡 @卡体表格8列:市场/币种/订单/销售件数/本地营收/本地VAT/本地净利润/净利润率;最新月份;导出Excel/full countries 块(源表直读,2026-09-18 注释:finance_monthly 漏 onno 不用);local_net=local_amount×(net_usd/revenue_usd) 拍板折算;订单剔取消两变体 |交互:导出折算公式复算;币种=marketplace 本币生效
AC-EL-FIN-029hero 隐藏 @—分支noon 下不渲染 ProfitHeroKpiSection noon 分支(E批 P3-8)noon 下无六卡瀑布生效
AC-EL-FIN-030Noon SKU P&L 卡 @主区卡国家/月份/型号 3筛选下拉+21列 SKU 表(本币)+caliber 说明+SKU 销量柱状图(型号堆叠 bar+Units line+GMV dashed,dataZoom)/api/finance/noon-pnl;源 cleaned_noon_monthly+noon_statement+noon_sku_status+noon_sku_pl_monthly+noon_ads_daily+noon_sku_ads;VAT 推算 SA 15/115 AE 5/105;AC-CAL-05/12 |交互:下拉筛选本币列标注 SAR/AED 不混生效
AC-EL-FIN-031Noon SKU 深度表 @主区表格年份pills(今年/去年/前年)+国家下拉(全部/SA/AE)+汇总行(行数/订单/GMV/广告/净利润)+44列 NOON_SPEC+caliber+DataTable(排序/筛选/CSV/Excel,minWidth 3400)/api/finance/noon-sku?year&country;源 cleaned_noon_sku_status+sku_pl_monthly+noon_ads_daily;金额列头加(本币)后缀(2026-10-03 用户令),汇总行=USD;ACOS>50/TACOS>30 红色;margin 正绿负红;待核②:卡头文案"39 列深度表" vs NOON_SPEC 实际 44 项 → 文案与代码不符。

2026-10-22 补翻换绿:卡头文案已改「Noon SKU 表现 · 44 列深度表」(finance/page.tsx:966,「39 列」全文件 0 处),_gate_lst3_fin49_20261022 门禁已过;待核② 系早间修复后本行漏翻,今对账补正 |交互:pills/下拉/排序/导出
导出列数=44;文案列数核对生效
AC-EL-FIN-032Noon 产品×月损益卡 @主区表格18列:月份/品牌/国家币种/订单/Del/Ship/Canc/Und/GMV本币/GMV折USD/佣金/履约/广告/VAT推算/Cost$/结算净额/TACOS/Mgn;BlockBar(SA/AE);导出Excel/api/finance/noon-ops;GMV折USD=fx 换算(AC-CAL-05);本币/USD 两列并存 |交互:pills/导出两币列不混生效
AC-EL-FIN-033Noon 账户余额卡 @主区表格6列:月份(·派生标记)/品牌/市场/期初/打款/期末;BlockBar;导出Excel/full noon_balances;cleaned_noon_statement DISTINCT ON (market, stmt_month);AC-CAL-08 |交互:pills/导出期初(n)=期末(n−1) 链条守恒生效
AC-EL-FIN-034期间下拉 @卡头下拉期间6档(今年/本月/上月/近3月/近12月/去年)+单月24项OPS_PERIODS+periodRange(单月窗口=[月,月],NoonStatement.tsx) |交互:切换刷新参数同步生效
AC-EL-FIN-035GMV 月柱状图 @卡体图SA(SAR)/AE(AED) 双 bar 本币跨品牌/api/noon/summary;AC-CAL-12 禁跨币直加,图例分币种两币不合并生效
AC-EL-FIN-036环比图 @卡体图SA/AE 环比% 双 line(当月−上月)/上月 分市场;#56b 修复=前置月纳入窗口首月环比可算生效
AC-EL-FIN-037官方对账单 26字段表 @卡体表格粒度tabs(M/Q/Y)+期间下拉;26列=8基础(月份/品牌/市场/期初/净入账/总费用/打款/期末)+8费项×(含税,VAT)(ads广告/referral佣金/fbn出库/returns退回退款/warranty保修/ret_admin退货管理/damaged破损退/promo促销)+银行转账+余额转账/api/noon/summary;cleaned_noon_statement;VAT 内拆 SA=15/115 AE=5/105;银行/余额转账=钱包划转非应税;聚合规则=期初取期内首月/期末取末月/其余 SUM_KEYS 求和;全量口径不随品牌筛选(脚注披露) |交互:tabs/下拉M→Q→Y 聚合守恒(期初期末取端点)生效
AC-EL-FIN-038月度经营总表 20字段表 @卡体表格3标签列(月份/品牌/市场)+17指标列:Orders/Units Sold/Valid Units/Delivered/Pending/Cancel Order/未妥投/CIR/GMV/Commission/Delivery/Ad Spend/Gross Profit/COGS/Net Profit/Settlement净额/Payout;两段口径脚注/api/finance/noon-ops;Orders=订单号去重;六态口径(Valid/Delivered/Pending/Cancel/未妥投/CIR);广告含 VAT 对齐;COGS=Valid×单价;Payout=对账单打款去重求和;gross=结算−广告;net=gross−cogs |交互:下拉脚注公式逐列复算生效
AC-EL-FIN-039行维度 chips @卡头chips国家/产品/品牌/api/finance/profit-matrix dim 参数 |交互:切换重载参数同步生效
AC-EL-FIN-040平台 chips @卡头chips全部折USD/Amazon/Noonplat 参数;全部=两平台折 USD 融合(AC-CAL-05) |交互:切换融合行=两平台和生效
AC-EL-FIN-041汇总条 @卡头汇总近N月·维度行数+CountryPills+六指标(Revenue/毛利润/广告/VAT/成本/净利润)+净利润率进度条/profit-matrix pm-stat 段 |交互:pills六指标=列合计生效
AC-EL-FIN-042口径说明行 @卡头脚注单元格=净利润热力(绿赚红亏深浅∝金额);毛利=结算净额−广告;净利=毛利−COGS(头程恒0);Noon 折 USD静态披露与后端公式一致生效
AC-EL-FIN-043热力矩阵表 @卡体热力表行=维度值+平台来源标;列=逐月净利润(热力色)+合计净利润+毛利率;hover tip 9指标构成/profit-matrix:ord=orders×fees sku_list unnest × sku_mapping 定维;ads 双源并集;cost 同012 |交互:hover/点击行下钻抽1格 SQL 复算生效
AC-EL-FIN-044下钻明细 @行展开表格13列:月份/订单/件数/营收/结算净额/广告/VAT/毛利/成本/净利润/毛利率/Amazon/Noon同端点 drill 段,双平台分列 |交互:展开明细和=行合计生效
AC-EL-FIN-045合计行 @表底合计逐月合计热力+总净利润+总毛利率列聚合合计=列和生效
AC-EL-FIN-046显示更多 @表底按钮15 行→+30前端分页 |交互:点击行数递增生效
AC-EL-FIN-047平台子tabs @卡头tabsAmazon USD / Noon 本币platform 子 state,随顶部 |交互:切换币种标注切换生效
AC-EL-FIN-048RangePills @卡头筛选器时间档 pillstimeParams |交互:切换参数同步生效
AC-EL-FIN-049月份下拉+搜索 @卡头筛选器月份 select+SKU/标题搜索框+搜索按钮q 参数(SKU/标题模糊) |交互:输入+回车/按钮命中集变化生效
AC-EL-FIN-050排序下拉 @卡头下拉5种 PL_SORTS,仅 amazon 显示sort 参数 |交互:切换首行随排序变生效
AC-EL-FIN-051Amazon 14列表 @卡体表格SKU/标题两级行头+品牌/订单/件数/退款件/净收款/佣金/FBA/广告/VAT/毛利润/毛利率/采购成本/净利润/api/finance/product-pl?platform=amazon;gross/net2 后端下发;USD |交互:排序/翻页抽行复算生效
AC-EL-FIN-052分页器 @卡底分页共N行·第x/y页·月份+上一页/下一页;20行/页limit=20 offset |交互:翻页行数=20生效
AC-EL-FIN-053Noon 10列表 @卡体表格SKU/品牌/市场/订单/GMV/佣金/履约/广告/VAT推算/结算净额;SAR/AED 本币标注/product-pl?platform=noon;AC-CAL-12 |交互:翻页本币不混生效
AC-EL-FIN-054年份 pills @卡头pills全部+数据年份year 参数 |交互:切换参数同步生效
AC-EL-FIN-055RangePills @卡头筛选器时间档timeParams |交互:切换同上生效
AC-EL-FIN-056口径说明 @卡头脚注账单总额=平台账单;结算到账/打款=Settlements 月度;差额=对账缺口AC-CAL-07 fm 三方对账(与订单层两条口径,差值带标签披露)与注册表口径一致生效
AC-EL-FIN-057项目×月对账表 @卡体表格17列:月份/项目(品牌)/订单/退款单/营收/退款/佣金/履约/VAT/其他费/净利润/账单总额/结算到账/差额/打款/差额/广告;两差额列 |差|>1 标 warn 色/api/finance/monthly差额=账单−结算 代数复算生效
AC-EL-FIN-058Noon Model×月表 @卡体表格12列:月份/品牌/国家币种/型号/订单/GMV/佣金/履约/广告/广告销售/VAT推算/结算净额;本币/monthly noon 段;AC-CAL-05/12本币列核对生效
AC-EL-FIN-059BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('yrB') |交互:切换参数同步生效
AC-EL-FIN-060年度图 @卡体图营收 bar+净利润 line+VAT dashed/full years 段与表一致生效
AC-EL-FIN-061年度对比表 @卡体表格6列:年份/订单/营收USD/净利润USD/净利率/VAT USD;导出Excel/full years;净利率=净利/营收 |交互:导出抽年复算生效
AC-EL-FIN-062页面级口径脚注 @页脚脚注"官方财务结算事件聚合…"披露文本静态文本在渲染中生效
AC-EL-FIN-063四维矩阵分析卡 @页脚卡平台×国家×品牌×SKU MatrixSection在 /full 数据外独立;full 加载失败也恒渲染;2026-09-14 用户指定置底断 API 仍渲染生效
AC-EL-FIN-064CustomModules @页尾模块区page="finance" 自定义模块前端组件按 page 键渲染配置模块出现生效

源码实证注记:- 全部条目源自上述三文件实读;未实测浏览器渲染。 - 待核①(019):kpi-wall 分市场表 th17 vs td18 错位 —— 需浏览器/ DOM 验收确认(候选缺陷,勿凭代码定罪)。 - 待核②(031):卡头"39 列" vs NOON_SPEC 44 项 —— 文案数字与代码不符。 - 待核③(027 有效订单 vs 016 订单):027 有效订单=订单−canceled('Canceled'单变体) 前端派生;016 订单=aord 三变体 FILTER。同义不同实现,canceled 仅 'Canceled' 变体时两值相等(实测 2026-10-22 仅 'Canceled'×2670),差异归 AC-PEND-02 统一。 - 大表逐列明细以源码列定义为准(027→23列、031→44列、037→26列、038→20列、057→17列),父任务转 AC-EL 条目时逐列展开。

§11.7 Noon 平台页(/noon · AC-EL-NOON,源码 web/app/noon/page.tsx + NoonStatement.tsx;2026-10-22 校对修正版 v4.4)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-NOON-01页标题/面包屑静态「Noon 平台 · 中东 Noon · 月度财务(原币口径)+ 官方对账单」AppShell 面包屑e2e 文案断言生效
AC-EL-NOON-02错误横幅反馈接口失败红条err ← catchrole=alert生效
AC-EL-NOON-03无数据空态空态「当前品牌无 Noon 数据」居中卡months 与 statements 均空时整页空态(/api/noon/summary 空结果)纯 Amazon 品牌视角断言生效
AC-EL-NOON-04KPI·最新月 GMV(每币种一张)KPI卡最新月 GMV + 订单/件数/费用 footlatest=mons 末位;months=audit.cleaned_noon_monthly(RLS 租户域,不随全局品牌筛选);money()=「CUR N,NNN」千分位 0 位(NoonStatement.tsx)SQL 最新月 gross 对拍(按币种分行)生效
AC-EL-NOON-05KPI·累计(每币种一张)KPI卡全期累计 GMV + 累计打款/费用 footΣ gross / Σ payouts / Σ fees 按币种分列(未采集月按 0 计入,口径披露在明细表)SQL Σ 对拍生效
AC-EL-NOON-06全局时间窗条筛选全部 / 近6月 / 近12月 / 近24月win=月数(0=全部),windowMons=mons 尾部 N 月;与看板 Noon 墙同款月窗语义;单击切换切近6月→图表/摘要月数=6生效
AC-EL-NOON-07窗口摘要(#noon-window-strip)状态「窗口 X(N 个月)· CUR: GMV n · 净额 n」(每币种一段)id=noon-window-strip(e2e 断言锚点);GMV=Σ gross、净额=Σ(gross+updates−fees)(窗口内;未采集费用月净额未扣费用)e2e 断言 id 文案;SQL 窗口 Σ 对拍生效
AC-EL-NOON-08月度 GMV 趋势卡图表ChartCard 双轴柱:每月×币种柱(AED=#4f46e5 左轴 / SAR=#0e9384 右轴)cleaned_noon_monthly per (mon,currency);sub「原币口径(AED=阿联酋 / SAR=沙特,未折 USD)」=AC-CAL-05;独立日期区间三态(global/独立/清除);CSV=noon_gmv(月份×币种矩阵);区间选择/CSV/tooltip 交互SQL 月×币 gross 对拍生效
AC-EL-NOON-09月度净额趋势卡图表每月净额柱(同上双轴)netOf=gross+updates−fees(客户端同式);sub「净额 = gross + 冲回 − 费用(原币口径)· 未采集费用月净额未扣费用」;CSV=noon_netSQL netOf 复算生效
AC-EL-NOON-10主页签组页签📊 财务概览 / 💬 评论 / 👁 流量转化noonTab state;默认财务概览;单击切换e2e 三 tab 断言生效
AC-EL-NOON-11月度财务明细表表格月度×品牌×币种明细,列可排序/筛选,CSV+Excel 导出rows=months 全量;exportCsv/exportExcel=noon_monthly;caliber=「金额=本币(SAR/AED 按行币种)|gross=订单入账 · 冲回=order_update · 净额=gross+冲回−费用|数据源=noon_monthly|未采集=首费用/打款交易月之前月份」;空态=无数据导出文件行数=months生效
AC-EL-NOON-12明细表·列「月份」列YYYY-MMmon;text 筛选—生效
AC-EL-NOON-13明细表·列「品牌」列色点+品牌名brandColor 色点(AC-UI-07);排序/筛选—生效
AC-EL-NOON-14明细表·列「币种」列AED/SARcurrency;筛选—生效
AC-EL-NOON-15明细表·列「订单」列整数orders;num 筛选—生效
AC-EL-NOON-16明细表·列「件数」列整数items;num 筛选—生效
AC-EL-NOON-17明细表·列「GMV」列加粗本币money(gross, cur) 0 位;num 筛选—生效
AC-EL-NOON-18明细表·列「冲回」列muted 本币updates(order_update 类交易);num 筛选—生效
AC-EL-NOON-19明细表·列「费用」列「未采集」或本币uncov(m)=mon<fee_cov[brand|currency] → 显「未采集」(muted);否则 money(fees);fee_cov 真源=源库 transactions 首个 statement_fee/payment/balance_transfer 交易月(finance.py:312-335,API 直读源库,失败回落 cleaned 首个非零月启发式);num 筛选fee_cov SQL 复算;早月显未采集断言生效
AC-EL-NOON-20明细表·列「净额」列绿色本币 + * 标netOf=gross+updates−fees;uncov 带「*」=未扣费用;num 筛选复算生效
AC-EL-NOON-21明细表·列「打款」列「未采集」或本币payouts;uncov 判定同 AC-EL-NOON-19—生效
AC-EL-NOON-22未采集脚注脚注「未采集」语义说明+行数(uncovCount>0 时显示)「=该品牌×币种首个费用/打款交易月之前月份…非真零;净额带 *=未扣费用(=毛额+冲回)。R9 扩采回填后自愈。共 N 行」行数=SQL uncov 计数生效
AC-EL-NOON-23官方对账单表(statements 非空)表格月×品牌×市场全分项对账单,8 费项×(含税,VAT) 双层表头数据=audit.cleaned_noon_statement DISTINCT ON (brand,market,left(stmt_month,7)) 归一去重(双格式月份);行序=reverse(最新月在前);金额 money() 0 位无币种前缀(市场即币种:SA=SAR/AE=AED,AC-CAL-12 本币分列);只读表(brand,market,mon) 无重复行 SQL 断言生效
AC-EL-NOON-24对账单·汇总块列组列组月份/品牌/市场/期初余额/净入账/总费用/打款/期末余额opening_balance/net_proceeds/total_fees/payouts/closing_balance 快照值;净入账 strongΣ net+fees−payouts=closing−opening 抽行复算生效
AC-EL-NOON-25对账单·8 费项含税列组列组广告费/佣金/FBN 出库/退回退款/保修/退货管理/破损退/促销(各=含税实扣)STMT_FEES 顺序(NoonStatement.tsx);值=快照原值(贷记冲减为正、扣款为负);muted 样式与源单字段对拍生效
AC-EL-NOON-26对账单·VAT 内拆列组列组每费项右列 VAT(绿显)前端 vat=v×STMT_VAT_RATE[market](SA=15/115、AE=5/105 内拆系数,#47 拍板;noon 无官方税额列);v=null→「—」抽行 v×系数复算生效
AC-EL-NOON-27对账单·转账双列列组银行转账/余额转账bank_transfer/balance_transfer=钱包划转非应税—生效
AC-EL-NOON-28对账单脚注脚注原币未折 USD + 去重说明 + 品牌过滤边界「对账单为平台原币口径(未折 USD);官方账单快照;同月按(品牌×市场)归一(双格式月份已去重);本页暂不随全局品牌筛选」文案断言生效
AC-EL-NOON-29评论 KPI 六卡KPI卡总评论数(accent) / 平均评分(≥4 绿 else 橙) / 好评率(4-5★ 绿) / 差评率(1-2★ 红) / 如实描述✓ / 与描述不符✗(红)/api/noon/reviews-analytics:源库 {schema}_seller_reviews 全量(本租户 noon 品牌聚合,qsource 直读);total=有效评分数、avg=round(均值,2)、positive_pct/negative_pct=round(pct,1)、as_described 布尔计数;随品牌筛选刷新analytics 复算对拍生效
AC-EL-NOON-30评分分布卡图表5→1★ 分布横条(≥4 绿/3 橙/≤2 红)dist=Counter(rating);条宽=count/total×100%;右端计数分布 Σ=total生效
AC-EL-NOON-31评论趋势(月)卡图表月度评论数柱(CSS 柱图,非 EChart)trend=substring(review_date) 计数;柱高=count/max×80px(min 4px);title 悬停「mon: n 条」;x 标签旋转 −45°trend SQL 对拍生效
AC-EL-NOON-32评论最多 SKU Top15表格SKU×评论数 Top15sku_count Counter 取 15;SKU 截 25 字符对拍生效
AC-EL-NOON-33评论卡标题+sub标题「卖家评论 · N 条全量 · noon reputation API 自动拉取」total 同 AC-EL-NOON-29;「757 条(365 天窗)」为写死固定文案(历史快照数字)——待核①:采集扩窗后总数变化文案不随动,验收以 API total 为准,缺陷候选;只记录未拍板。

2026-10-22 换绿:写死「757 条」实仅评论表脚注一处(本行描述的标题/sub 本已动态绑定 total);脚注已改 {total} 动态绑定(noon/page.tsx:175,与头卡/标题同源 reviews-analytics total),采集扩窗后文案随动,验收仍以 API total 为准——探针 PASS(757 清零/动态「N 条(365 天窗)」在场)+frontend_e2e ALL PASS(tools/_gate_noon3_pipe_20261022_frontend_e2e.log)
文案断言;写死 757 vs API total 差异核生效
AC-EL-NOON-34评论品牌筛选筛选全品牌 + 本租户 noon 品牌 tabnoonBrands=info.noon_brands(brands_source 注册表 platform='noon')∩ brands(H9 2026-10-13 单源,不散写 zipforce/onno)=AC-UI-02 同族;单击重拉两接口注册表 vs 按钮 presence生效
AC-EL-NOON-35评论评分筛选筛选全部 / 5★…1★rating=精确等值(SQL r.rating=N);0=全部;单击重拉5★ 列表全 5★ 断言生效
AC-EL-NOON-36评论搜索框筛选「搜索评论内容或 SKU…」客户端过滤comment/sku toLowerCase includes(不重拉,本地过滤当前 200 条)输入无结果词→0 条生效
AC-EL-NOON-37评论计数状态「N / M 条」filtered.length / items.length;随筛选更新—生效
AC-EL-NOON-38评论列表表表格7 列:日期/评分/评论/SKU/订单/国家/描述date='DD Mon YYYY' 原文;评分=★repeat(rating)(≥4 绿/≤2 红/3 橙);comment 服务端截 200 字符;sku 截 20;country upper;as_described true/t→✓ false/f→✗ else —;ORDER BY to_date(review_date,'DD Mon YYYY') DESC(2026-10-10 修字典序乱序);limit≤200;容器 maxHeight 500 滚动首行日期≥次行断言生效
AC-EL-NOON-39评论表脚注脚注「数据源=noon-reputation seller-reviews · 757 条(365 天窗) · 评分/评文/SKU/订单号/如实描述 · 每日刷新」静态文案——待核①(同 AC-EL-NOON-33):「757 条」写死不随采集扩窗变化;只记录未拍板。

2026-10-22 换绿:脚注 757→{total}(page.tsx:175 绑定 reviews-analytics total,与 NOON-33 同源同修);文案随采集扩窗自动变化;探针+门禁记录同 NOON-33
文案断言;与 API total 差异核生效
AC-EL-NOON-40流量国家筛选筛选全部 / AE / SAcountry → SQL upper(country_code) 等值;days 固定 30(API 上限 90);单击重拉—生效
AC-EL-NOON-41SKU 流量表现表表格7 列:SKU/浏览量/总浏览(含竞品)/出货/营收/Buy Box%/转化率%/api/noon/catalog-sales:源库 {schema}_catalog_sales(Impex productviewsandsalesdata)visit_date≥today−30;前端按 SKU 聚合:v/tv/s=Σ,bb/cv=日均均值(Σ/n),r=Σ revenue_shipped(本币,toLocaleString 0 位,未折 USD——AC-CAL-05 披露);排序营收 DESC top30;总浏览 0→「—」;转化率>3 绿;SKU 截 25;API LIMIT 200——待核②:营收列未随行标注币种(AE 行 SAR 行混排仅本币数字,依赖读者知道市场=币种);只记录未拍板。

2026-10-22 换绿:口径修复=聚合键 sku→市场|SKU(新增「市场」列),营收列随行 AED/SAR 后缀;顺带修复比原披露更重一级的真缺陷——原「全部」页签把 AED 与 SAR 直接 Σ(违反本币不可跨币种相加惯例);排序仍按本币数值(跨币种排序近似,AC-CAL-05 未折 USD 披露继续适用);h2 sub 补「按市场分行 · 营收本币(AED/SAR)」;探针 PASS(市场列在场/表头与首行 8=8/营收后缀 AED|SAR 在场)+frontend_e2e ALL PASS
源库 30 天 Σ 对拍生效
AC-EL-NOON-42流量表脚注脚注数据源与字段口径「数据源=Impex productviewsandsalesdata · 月窗(年窗会被 noon 静默截断) · 浏览量=Your_Visitors · 转化率=Conversion_Visitors_Percentage」文案断言生效

§11.8 选品页(/sourcing · AC-EL-SRC,源码 web/app/sourcing/page.tsx 2200 行 + sourcing.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-01KeepaTokenChip(tab 栏右端)chipKeepa token 池余额+今日配额常驻显示GET /api/sourcing/keepa-status,60s 轮询;tokens_left=最近一次真实调用后 Keepa 返回;今日配额=quota_limit−quota_used(套餐 PLAN_KEEPA_QUOTA);未返回显 —curl 端点返回 tokens_left/quota_used;chip 文本断言(数字非 …)生效
AC-EL-SRC-02主 tab 栏(页首)tab×11选品情报台/数据探索/AI选品/畅销榜/促销流/产品查找/类目树/价格历史/卖家/监控池/决策台mtab query state(useQueryState);默认 charts;交互:点击切 mtab;URL ?mtab= 深链curl /sourcing?mtab=explore 各 tab 渲染断言生效
AC-EL-SRC-03站点/国家 select(charts·工具栏)select16 站选择(COUNTRIES,chartCatalog 单源)本地 state,无请求;交互:切换即 ABA 模式自动重查(F2-1)e2e 切站点后图表刷新生效
AC-EL-SRC-04数据源 select(charts·工具栏)selectABA 词分析(快照+词库)/ Keepa 实时搜索(耗配额)双模式smode=aba|keepa;keepa 模式每次耗 1 配额不自动发;切回 aba 恢复一次免费重查e2e 切 keepa 后按钮文案含「耗」生效
AC-EL-SRC-05搜索词 input+datalist(charts·工具栏)input+补全精确搜索词;Keepa 模式=关键词补全:350ms 防抖 GET /api/sourcing/aba/terms?country&q(≥2 字符,前缀索引);空/失败回退 overview.terms 本地 Top50;交互:Enter 触发搜索抓包 /aba/terms 仅 ≥2 字符触发生效
AC-EL-SRC-06近 N 月 select(charts·工具栏)select月窗 3/6/12/18/24(默认 12),仅 ABA 模式传 /api/sourcing/explorer?months=;交互:切换即自动重查(ABA)—生效
AC-EL-SRC-07搜索按钮(charts·工具栏)button双文案:aba「搜索并生成图表」/keepa「搜索 Keepa 实时库(耗 1 次配额)」run() 分派 load()/keepaLoad();keepa 且站点无 KEEPA_DOM 时禁用e2e 按钮禁用态断言(AE/SA/SE+keepa)生效
AC-EL-SRC-08数据水位行(charts·卡内)脚注行ABA 快照/ABA 全库/Keepa 档案/机会雷达四源截至日期,超 3 天 ⚠️N 天前GET /api/sourcing/aba/overview meta(ba_search_terms_fetched_at/keepa_raw_fetched_at/radar_computed_at/snapshot_at);full=countries_n+last_period停更>3 天时 ⚠️ 出现(2026-09-26 E2)生效
AC-EL-SRC-09精确词未命中提示(charts·卡内)提示「精确词未命中,已按最接近的 X 显示」explorer 返回 term_exact=false 且 available输入近似词断言提示生效
AC-EL-SRC-10词宇宙死胡同卡(charts·卡内)卡本站无此词→自动级联 Keepa(有域)或明示无兜底(AE/SA/SE)+可搜词 chipsdata.available=false 触发 keepaLoad("cascade");country_terms chips 点击即以此词 load;交互:点 chip 换词搜索造无词断言级联触发+kres 渲染生效
AC-EL-SRC-11Keepa 实时搜索卡(charts)卡实时结果容器;级联触发时顶部 ⚡ 转向说明条件渲染 smode=keepa 或 kres/kLoading/kErr 存在—生效
AC-EL-SRC-12实时配额/来源行(实时卡内)脚注行⚡实时数据·站·今日剩余配额·匹配 N 个(显示前 M)·已并入池 P 条·🧊缓存命中(0 token)/api/sourcing/search 响应字段 quota_left/_finder_total/pooled/cached;缓存 10 分钟窗口二次同词检索断言 cached 徽标生效
AC-EL-SRC-13实时 5 KPI(实时卡内)kpi×5结果数/BuyBox 中位价/BSR 中位/平均评分/评论总数前端对 items 派生:中位数(buybox_price??price_new/salesrank)、rating 均值、reviews 求和;币种=首行 currencyJS 复算中位数 vs 显示生效
AC-EL-SRC-14实时商品表(实时卡内)表(14 列+#)商品[图36px/标题/品牌/ASIN viewer 深链/🛒 amzUrl 外链/卖家数/已监控]/Buybox/BSR[+subcat 副行]/30/90 掉榜/FBA 卖家/FBM≈[New−FBA 推算]/月销30[Amazon 近30日已购口径]/90均BSR/自营价/二手价/断货30/上架日期/评分/评论数/search 或 /finder+/enrich 全字段映射;BSR=大类口径,小类作副行;rankMode(畅销榜/AI)按 BSR 升序加 # 列;viewer 深链 SPA 无刷新(Ctrl/中键保留新标签);交互:行内 ASIN 点击→viewer;🛒新开 Amazon列头 tooltip 断言;ASIN 点击 mtab=viewer生效
AC-EL-SRC-15ABA 8 KPI(charts·KPI 行)kpi×8所选月份/ABA 有快照月[脚注]/理论席位(=快照月×3)/有效席位(Σappearances)/去重 ASIN/Keepa 覆盖[脚注 x/y]/品牌(大小写空白归一)/类目computeKPIs 前端算自 /explorer 响应(timeline+rotation);F2-4 已删恒重复的「有效 ASIN」卡复算 rotation Σappearances生效
AC-EL-SRC-16子 tab 栏(charts)tab×6ABA 图表[20]/Keepa 图表[39+22]/ABA×Keepa[32]/全部产品与原始行/分析报告总结/🎯机会雷达subtab query state;图表计数取 chartCatalog 常量—生效
AC-EL-SRC-17ABA 图表墙(charts·aba)图墙20 张 ABA 图(份额/趋势等)<ABACharts data>;GET /api/sourcing/explorer(aba_terms_full+aba_search_terms+aba_keepa_full);逐图清单在 charts/ABACharts.tsx+chartCatalog,需另册展开。

2026-10-22 换绿:另册已建=§11.38 SRC-AB 系列 20 条(v5.2 独立校对通过,图题逐字/行号/口径全核)
待另册逐图比对生效
AC-EL-SRC-18单 ASIN 39 图(charts·keepa)图墙rotation 选 ASIN 切换的单品 Keepa 图<KeepaSingleCharts rotation>;快照表无原始时序→历史类图仅窗口聚合近似(卡头明示);逐图清单在 charts/KeepaSingleCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-KS 系列 39 条(v5.2 独立校对通过;含 5 张恒空卡 other-condition-prices/deal-events/coupon-events/seller-offers/content-assets 记为空态卡)
待另册逐图比对生效
AC-EL-SRC-19池级 22 图(charts·keepa)图墙全部去重 ASIN 聚合图<KeepaPoolCharts rotation>;逐图清单在 charts/KeepaPoolCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-KP 系列 22 条(v5.2 独立校对通过)
待另册逐图比对生效
AC-EL-SRC-20ABA×Keepa 32 图(charts·joint)图墙联合图<JointCharts data>;逐图清单在 charts/JointCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-JT 系列 34 条(v5.2 独立校对通过)——计数更正:JT 实为 34 图非本行原述 32(chartCatalog.ts counts.joint:32 注释过时,JointCharts.tsx 头注「34 图」为准;属源码注释文案候选)
待另册逐图比对生效
AC-EL-SRC-21搜索历史全字段台账(charts·raw)卡+表(10 列)+分页该站全部检索词席位 ASIN×Keepa 档案;列 ASIN/品牌/标题/BSR/drops30/drops90/monthly_sold/BuyBox/评分/评论GET /api/sourcing/aba/ledger?page&page_size(50/100/200);共 N·覆盖·缺计数;口径徽标 full+pool|本地租户池(scope 字段);2026-09-17 P0 修复=前端读 items+keepa 嵌套;交互:每页 select/查询按钮/上下页ledger total=SQL count;scope 徽标断言生效
AC-EL-SRC-22ABA 逐月原始行表(charts·raw)表(12 列)月份/状态(✓|缺月)/SFR/Top1-3(ASIN+点击%+成交%)explorer timeline 数据本地渲染,pct() 百分比格式与 aba_terms_full 抽行比对生效
AC-EL-SRC-23分析报告总结(charts·report)卡AI 总结当前词 ABA+Keepa 数据POST /api/ai/sourcing {country,term};每次耗当日 AI 配额 1;基于本地已抓数据;交互:生成/重新分析按钮配额扣减断言(调前后 quota)生效
AC-EL-SRC-24机会雷达五类 chips(charts·radar)tab×5📈上升词/🧩碎片化词/💎黑马 ASIN/🧺同购搭配/🔁复购 ASIN,各带 totalGET /api/sourcing/radar?country&limit=50(&offset 翻页);源表 aba_radar_rising/fragmented/gem/basket/repeat+aba_meta(radar_computed_at);期号/源计算日期在卡头;交互:点击切换 kindSQL count vs chip 数字生效
AC-EL-SRC-25上升词表(radar·rising)表(8 列)搜索词[可点击跳回 ABA 图]/当前排名/上期排名/变化[+绿]/Top1 ASIN/点击/成交/分数同 AC-EL-SRC-24 源表;rank_change>0 绿色;交互:词点击→setTerm+load+切 aba 子 tab抽行 SQL 复算生效
AC-EL-SRC-26碎片化表(radar·fragmented)表(6 列)词/SFR/碎片化分(3 位小数)/Top1 ASIN/点击/成交同 AC-EL-SRC-24 源表;交互:词可点击抽行 SQL 复算生效
AC-EL-SRC-27黑马表(radar·gem)表(7 列)词/SFR/ASIN/点击份额/成交份额/成交÷点击/分数同 AC-EL-SRC-24 源表;交互:词可点击抽行 SQL 复算生效
AC-EL-SRC-28同购表(radar·basket)表(7 列)ASIN/共购 1-3(ASIN+占比%)同 AC-EL-SRC-24 源表抽行 SQL 复算生效
AC-EL-SRC-29复购表(radar·repeat)表(4 列)ASIN/总订单/复购订单/复购率%同 AC-EL-SRC-24 源表抽行 SQL 复算生效
AC-EL-SRC-30雷达加载更多(radar 卡尾)button+脚注展示 Top N/共 M·加载更多服务端 offset 分页只并入当前 kindtotal 与行数关系断言生效
AC-EL-SRC-31页头说明(explore·卡头)脚注全部条件平铺直选·零下拉·选完点底部搜索静态文案—生效
AC-EL-SRC-32站点 chips(explore)chips×1313 站(KEEPA_COUNTRIES,Keepa 后端;非 charts 的 16 站)2026-10-06 F2/F3:AE/SA/SE 档案池永远 0 行已收窄;交互:点击切站选项数=13 断言生效
AC-EL-SRC-33数据范围三档(explore)chips×3⚡实时检索(默认,界面不出现 Keepa 字样)/📚全库(本地档案池 N 条)/当前词池(Top3 去重)GET /explore/fields?scope 拿 pool_total;2026-10-07 用户令默认 live;实时结果 UPSERT 增量并入 aba_keepa_full;交互:点击切 scope全库 chip 显示 pool_total生效
AC-EL-SRC-34live 提示条(explore·live)提示条琥珀底:配额规则+38 项条件在全库档生效说明静态—生效
AC-EL-SRC-35live 根类目 select(explore·live)select全类目(活跃榜)+根类目列表GET /api/sourcing/category-tree(源表 keepa_category_tax,2026-10-19 口径切市场公共维度)选项与 category-tree 响应一致生效
AC-EL-SRC-36live 关键词 input(explore·live)input占位=完整口径说明:纯词=Top30 快照;+任意筛选=自动切全市场条件检索(标题含词);留空=按筛选+类目检索2026-10-21 二次升级口径统一(bsr<80 只 2 个→条件全走 /finder)占位文案断言生效
AC-EL-SRC-37live 筛选行 1(explore·live)控件×18品牌(逗号分隔≤50)/价格类型(NEW|AMAZON|USED)/价≥≤/型号/颜色/尺码/评分≥≤/评论≥≤/月销≥/掉榜30·180·365≥/优惠券三态/秒杀三态组装 POST /finder body;任一筛选回车即检索输入+Enter生效
AC-EL-SRC-38live 筛选行 2(explore·live)控件×10BSR≥≤/卖家数≤/卖家≥/FBA 卖家≥/均价30·90≥/自营可购四态/BuyBox=Amazon 三态/排序(销量/价格↑↓/评论/月销)同 AC-EL-SRC-37;sort=sales 等输入+Enter生效
AC-EL-SRC-39live 更多筛选网格(explore·live)input×~40(7 组)价窗与价格$/排名与掉榜/报价库存/BuyBox 属性 9 布尔/产品标识 4/重量尺寸 9/时间 4白名单直通 extra 字段;价格型 ×100 分币转换;⚠️行披露实时源不可筛字段(180/365 全价型/reviews_avg90/卖家 ID/长尾属性/fetched_at)⚠️披露行存在断言生效
AC-EL-SRC-40实时检索按钮+脚注(explore·live)button「⚡实时检索(所有条件选完后点击, 耗 1 次配额)」+口径脚注(缓存 10 分钟)keepaSearch(0):纯词→GET /search;否则 POST /finder→/enrich 组装 kres(_byCat)抓包仅显式触发不自动烧生效
AC-EL-SRC-41站点不支持提示(explore·live)提示AE/SA/SE 无数据源提示+按钮禁用KEEPA_DOM 映射缺切 AE 断言生效
AC-EL-SRC-42kwNote 动态口径行(explore·live)脚注快照模式:「TopN 已按筛选过滤 X→Y · 未生效(需清词走条件检索): 字段清单」;条件模式:命中 N 个第 M 页;修改后:「已修改——回车重查(10 分钟缓存)」kwApply 纯前端过滤(0 配额)+skipped 字段清单派生;_fsig 与 filterSig 比对检测已修改改筛选后提示行断言生效
AC-EL-SRC-43live 结果区+分页(explore·live)结果区KeepaLiveResults+LiveCharts+上一页/第 N 页/共 ≤200 页/下一页/finder page 翻页(50/页,上限 200 页);交互:翻页按钮翻页请求 body.page 断言生效
AC-EL-SRC-44LiveCharts 实时图墙(explore·live)图墙 19 项10 分布 bar(价格/BSR 对数/评分/评论对数/月销/卖家数/FBA/掉榜30/90均BSR/断货30)+7 散点(价格×BSR/评分×评论/掉榜×BSR/评论×BSR/价格×评论/当前×90均BSR)+上架年份 bar+BuyBox 自营占比大数字卡(>30% 红)+品牌构成 pie(Top8+其他)纯前端聚合 0 token;样本 <3 不渲染该图;n= 计数在卡头抽一图桶计数 JS 复算生效
AC-EL-SRC-45字段组筛选墙(explore·all/pool)控件组×17 组 38 项GROUP_HINT 17 组提示(标识/类目排名/价格/报价库存/评论评分/费用尺寸/快照时间/R1~R10 扩采集)/explore/fields 返回 groups+labels(类目 ID→可读名 reference↔display_group);FieldControl 四型:bool 三态/枚举 chips(低基数优先于数字,2026-09-26 C 修)/number ge~le/date 起~止/text like(### 分隔 ≤50,Keepa 同款);空补丁=不限清除(2026-10-20 修)枚举 chips 与 /fields values 一致生效
AC-EL-SRC-46标识组三件(explore·标识组)input×2+textarea🔍关键词(标题/品牌/型号/ASIN 任一包含)/标题排除词(空格逗号分隔)/批量 ASIN(≤300,换行逗号空格分隔)term 进 POST body;exclude/asins 同;textarea 回车不触发asinCount 正则 [A-Z0-9]{10} 断言生效
AC-EL-SRC-47明细显示列选择(explore·all/pool)chips 卡结果表动态列选择,已选 N/M;图墙字段固定全取不受影响selFields state,默认 8 列表头=选中列顺序生效
AC-EL-SRC-48排序 chips(explore·all/pool)chipssort_fields 白名单(来自 /fields)+↑升/↓降sortF/sortDir 进 body—生效
AC-EL-SRC-49筛选摘要+清空(explore·all/pool)行+button已设 N 项:label≥/≤/含/N 选+排序↑↓+排除+批量 N 个;清空全部筛选按钮filters state 派生 summary摘要与实选一致生效
AC-EL-SRC-50全宽搜索按钮(explore·all/pool)button「🔍 搜 索(所有条件选完后点击)」POST /api/sourcing/explore(body: country/scope/term/fields/conds f|ge|v 拼接/sort/dir/exclude/asins/page/200 页)conds 语法抓包断言生效
AC-EL-SRC-51结果 6 KPI(explore·结果)kpi×6匹配总数[脚注:图表基于前 200 行]/品牌数/类目组数/中位 BuyBox/中位月销/BuyBox FBA 占比%kpi=前端算 result.rows 前 200 行;F2-3:加载更多只扩明细图墙恒 200复算中位数生效
AC-EL-SRC-52ExploreCharts 图墙(explore·结果)图墙 38 图固化维度图墙(全字段+明细列)<ExploreCharts rows 前页 200>;EXPLORE_FIELDS 固定全取;逐图清单在 charts/ExploreCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.38 SRC-EC 系列 38 条(v5.2 独立校对通过,EXPLORE_CHART_GROUPS 7 组 38 图)
待另册逐图比对生效
AC-EL-SRC-53结果明细卡(explore·结果)卡+表CSV 导出按钮+cond_note ⚠️(被拒条件显式亮出 F1-7)+动态列表[ASIN viewer 深链+🛒]+AU 无数据特文案(快照池未采集披露)+keepa_live 琥珀兜底行(本地无匹配→实时结果)+加载更多POST /explore page+1 追加;AU 特例披露;keepa_live=服务端实时兜底已入池;交互:导出/加载更多/行内链接0 行时 X-Export-Rows 提示不下载空文件生效
AC-EL-SRC-54CSV 导出(explore·结果)button同条件同排序导出,上限 1 万行POST /api/sourcing/explore/export;响应头 X-Export-Rows=0 时不下载报「无匹配」;文件名 sourcing_explore_YYYYMMDD.csv(blob)抓包+行数头断言生效
AC-EL-SRC-55搜索按钮口径注释(explore·live 尾)脚注纯关键词=Top30 快照(仅排序本页)·+筛选或留空=全市场条件检索·回车即查·缓存 10 分钟静态口径文案文案存在断言生效
AC-EL-SRC-56数据源双模式 chips(bsr·卡头)chips×2📚档案池 BSR 榜(本地)/⚡Keepa 实时(耗配额)mode=pool|live;pool 自动载,live 永不自动发—生效
AC-EL-SRC-57站点 chips(bsr)chips×1313 站(两模式全 Keepa 后端,F2 修统一收窄)KEEPA_COUNTRIES13 断言生效
AC-EL-SRC-58根类目 chips(bsr·pool)chips全类目+Top15 根类目(带产品计数,title=ID)category-tree 同源;seed 跳转带入 root/ref(首挂载不重置,切站才清);交互:点击切榜conds=sales_rank_reference|eq 或 root_category|eq 抓包生效
AC-EL-SRC-59参考类目子 chips(bsr·pool)chips选中根类目后展开其参考类目子类(带计数)同 AC-EL-SRC-58—生效
AC-EL-SRC-60导出 CSV+当前行(bsr·pool)button+行「⬇导出 CSV(当前榜最多 1 万行)」+当前: 类目名·共 N 产品POST /explore/export 同 body;文件名 sourcing_bestseller_国_日期.csv同 AC-EL-SRC-54生效
AC-EL-SRC-61关键词跳探索(bsr·pool)input+btn搜产品关键词→跳「数据探索」带完整筛选onSearch(kw)=setExploreSeed+切 mtab=explore(key 强制重挂载)URL mtab=explore 且种子生效生效
AC-EL-SRC-62榜单明细表(bsr·pool)表(9 列)#/ASIN[viewer 深链+🛒]/标题/品牌/当前 BSR/月销量/新品价($2 位)/评分(1 位)/评论数POST /explore scope=all sort=bsr_current dir=asc Top100;fields 8 列;空态「无数据」;交互:行内链接BSR 升序断言生效
AC-EL-SRC-63live 刷榜控件(bsr·live)select+input+btn根类目 select(全类目活跃榜)+关键词(优先)+「🔄刷新榜单(耗配额)」有词→/search Top30;无词→/finder(类目 sort=sales;全类目=drops30≥0 活跃榜)+/enrich;二选一说明脚注;缓存 10 分钟不自动发请求断言生效
AC-EL-SRC-64实时榜卡(bsr·live)卡KeepaLiveResults rankMode(# 名次列,BSR 升序)_byCat 按 Keepa 估算销量排序/词榜按 BSR 升序(副标题明示)副标题口径断言生效
AC-EL-SRC-65AI 站点 chips(ai)chips×1212 站全覆盖(US/UK/DE/FR/JP/CA/IT/ES/IN/MX/BR/NL;AU 已删=Keepa 无数据)10 站走 Keepa 官方 MCP;NL/BR 走平台 REST 直连(FBA 费估算不可用)12 断言+AU 缺席生效
AC-EL-SRC-66通道说明行(ai)脚注10 站 MCP·NL/BR REST·中东/瑞典不采集静态—生效
AC-EL-SRC-67问题 textarea+预设(ai)textarea+chips×3自由问题+3 预设(竞争格局/促销甄别/FBA 利润估算)静态预设填入 q;交互:点击预设填入—生效
AC-EL-SRC-68AI 分析按钮(ai)button「🤖AI 分析(1 次 AI 配额+Keepa ≤3 次)」+1-3 分钟勿重复点击提示POST /api/ai/sourcing-agent {question,country};GLM agent 循环调 Keepa MCP;配额门/审计/日志全在服务端;永不自动发quota_left 前后断言生效
AC-EL-SRC-69AI 分析结论卡(ai·结果)卡副标题: 站·model·Keepa 调用 N 次·今日剩余配额 N 次+pre-wrap 答案AgentResp.answerkeepa_calls 与 steps 数关系生效
AC-EL-SRC-70工具调用轨迹卡(ai·结果)卡agent 实际调用的 Keepa MCP 工具逐条(✓/✗ tool+参数截断 40 字+note),副标题「全部经过配额门与审计」AgentResp.stepsok=false 显示 ✗生效
AC-EL-SRC-71AI 检索的商品卡(ai·结果)卡KeepaLiveResults rankMode(BSR 升序)AgentResp.products同 AC-EL-SRC-14生效
AC-EL-SRC-72AI 检索的促销表(ai·结果)表(5 列)ASIN[深链+🛒]/标题/现价/均价/降幅%(降序)AgentResp.deals;Keepa 官方促销流;交互:行内链接降幅降序断言生效
AC-EL-SRC-73站点 chips(cat)chips×1313 站(类目聚合读 Keepa 后端,F2 修收窄)KEEPA_COUNTRIES13 断言生效
AC-EL-SRC-74统计行(cat·卡头)行共 N 产品·根类目 M 个·另有 K 产品未返回类目(不成树节点披露)category-tree total/roots.length/unclassifiedSQL sum(n) 比对生效
AC-EL-SRC-75关键词跳探索(cat·卡头)input+btn同 AC-EL-SRC-61同 AC-EL-SRC-61同 AC-EL-SRC-61生效
AC-EL-SRC-76根类目卡×N(cat)卡列表📁名+N 产品·M 参考类目·ID+「🏆看根类目榜」按钮+子 chips(名+计数,title=ID);无参考类目空态文案category-tree roots/children;onPick({country,root[,ref]})跳畅销榜(seed);交互:点子 chip/按钮跳转后 bsr conds 断言生效
AC-EL-SRC-77👁监控池 tab(mtab=watch)tab→组件WatchTab 组件GET /api/sourcing/watchlist(keepa_watch+keepa_daily LATERAL);POST /watch;DELETE;POST /watch/alert;上限 KEEPA_WATCH_LIMIT;内部元素需另册展开(WatchTab.tsx,归后续批次)。

2026-10-22 换绿:另册已建=§11.28 SRC-W 系列 30 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-78📈价格历史 tab(mtab=viewer)tab→组件ViewerTab 组件;深链参数 vasin/vcountry(全文 5 处 ASIN 链接目标)GET /api/sourcing/price-history(keepa_csv_series SECURITY DEFINER 白名单投影)+keepa-graph+aba_keepa_full;内部元素需另册展开(ViewerTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-V 系列 31 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-79🏪卖家 tab(mtab=seller)tab→组件SellerTab 组件GET /api/sourcing/sellers/top(aba_keepa_full BuyBox 赢家榜+aba_seller_full)+/seller-lookup+POST /seller-finder;内部元素需另册展开(SellerTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-S 系列 43 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-80⚡促销流 tab(mtab=deals)tab→组件DealsTab 组件GET /api/sourcing/deals+/lightning;内部元素需另册展开(DealsTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-D 系列 29 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-81🎯产品查找 tab(mtab=finder)tab→组件FinderTab 组件POST /api/sourcing/finder+/enrich(与 explore live 同引擎);内部元素需另册展开(FinderTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-F 系列 30 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-82⚖决策台 tab(mtab=verdicts)tab→组件VerdictsTab 组件路由端点未见 verdicts 专属(可能在 ai.py 或本地渲染);内部元素需另册展开(VerdictsTab.tsx+端点归属)。

2026-10-22 换绿:另册已建=§11.28 SRC-X 系列 24 条(v5.0 独立校对通过);端点归属实证=专列 router api/routers/verdicts.py(POST /verdicts/materialize @280、GET /verdicts/pareto @408、另有 candidates/legacy/decision;前端 VerdictsTab.tsx:52-105 调用)——原「路由端点未见」系端点在专列文件而非 sourcing.py
待另册展开后逐元素比对生效
  • Keepa 配额:/search、/finder+/enrich、AI agent(≤3 次)共用同一套餐配额池,仅显式按钮/回车触发;条件检索结果缓存 10 分钟命中不扣;服务端配额门+审计。
  • 三处 ASIN 深链路径:viewer(SPA 无刷新,Ctrl/中键=新标签)、amzUrl(Amazon 外链)、explore 结果表。
  • 域覆盖:Keepa 13 站(KEEPA_COUNTRIES);AE/SA/SE 无 Keepa 域(charts 的 16 站 COUNTRIES 与此并存,两清单不同源属已知设计)。
  • 2026-10-21 口径统一:关键词+任意筛选=全市场条件检索(/finder 标题含词),纯关键词=/search 相关性快照 Top30 仅排序本页——kwNote 行(AC-EL-SRC-42)是这套口径的用户可见说明。

§11.9 广告页(/ads · AC-EL-ADS,源码 web/app/ads/page.tsx 2475 行 + AdsAdvice.tsx 787 行 + api/routers/ads.py;2026-10-22 实证清单全量转档,ID 沿用三位编号)

全页通用:口径引用 AC-CAL-03(Noon 广告归因分层)·AC-CAL-04(Amazon 归因 campaign 级禁进 SKU)·AC-CAL-05(Noon 本币折 USD,SAR/AED 禁裸加,合计 USD 走 fx_rates 市场价)·AC-CAL-06(ACOS 阈值单源 /api/metric-thresholds,禁内联 25/40);通用公式 ACOS=花费/收入×100 · ROAS=收入/花费 · CTR=点击/曝光 · CVR=订单/点击 · CPC=花费/点击 · AOV=收入/订单 · CPS=花费/订单;时间窗 全部/今年/本月/上月/近3月/近12月(from/to 自然区间 _daywin 优先);Noon 数据 SA 时区锚、本币行禁跨币种裸加;空态按拉齐铁律显示"暂无数据"不隐藏结构。写操作九层护栏全页一致:EXECUTE_ADS_ACTION 确认串 + X-Idempotency-Key + idempotent_replay 消息 + role 门(owner/admin) + ops_ready 逐按钮解锁 + 数值护栏(bid [0.02,10]USD / Noon 定向 [0.01,200]本币 / AMZ 预算 [1,10000]USD·日 / Noon 预算 [1,30000]本币·日·克隆下限 5 / 活动名 1-128 同名拒建 / Noon 创建仅 AE·SA·SKU 1-50 在售 / Noon 建议采纳走 adopt)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ADS-001页标题+面包屑(全局/顶栏)文本「广告」+「投放分析(概览/明细)· 关键词优化 · 建议决策 · 监测 · 晨报(Noon/Amazon 双线)」AppShell 静态文案目检生效
AC-EL-ADS-002平台选择器(全局/选择器卡)按钮Amazon/Noon 两钮,全页唯一(2026-10-09 删「全部」,用户拍板:主体与 Amazon 相同,深度分析改为分别切换)state platform 默认 amazon;不混平台;交互:点击切换,所有 tab 联动重查切换后各 tab 网络请求 platform 参数=所选值生效
AC-EL-ADS-003平台切换 tab 自动跳转(全局/规则)逻辑当前 tab 属对方平台特有时自动跳对应 tab:bids↔noonkwNOON_ONLY_TABS=[noonkw,noonrec,noonfees];AMAZON_ONLY_TABS=[bids,optlog](page.tsx:2402-2407)Noon 下停留 bids 再切 Amazon,观察 URL tab=platform 映射生效
AC-EL-ADS-004时间选择器(全局/选择器卡)下拉全部/今年/本月/上月/近3月/近12月,所有 tab 共享timeRange state(page.tsx:2409);换算见 005;交互:选择后各 tab 重查切档后请求 days/from/to 变化生效
AC-EL-ADS-005timeParams 换算(全局/逻辑)映射全部=days:0(不限);今年=365d+from:01-01;本月=当月第N日+from:月初;上月=60d+精确自然月 from/to;近3月=90d;近12月=365dpage.tsx:2410-2427;2026-09-21 修「上月=近60天」近似,from/to 传接口由 _daywin 优先采用选上月看请求含 from/to=上月首末日生效
AC-EL-ADS-006tab 条(全局/tab条)页签基座7:morning🌅晨报/advice🧭建议/monitor🩺监测/terms🔍搜索词/hourly🕐分时/platform投放分析/upload📤数据上传;Amazon 插 bids🎯关键词/出价(terms后)+optlog关键词优化(platform后);Noon 插 noonkw🎯+noonrec💡Noon建议+noonfees💰Noon费用;严格同序(2026-10-12 用户令)BASE_TABS/AMAZON_TABS/NOON_TABS(page.tsx:2384-2386);tab 写入 URL query 默认 morning;camp/analysis 旧链接回退 platform;交互:点击/URL 直达双平台各数 tab 数(7/9/10)与顺序生效
AC-EL-ADS-007广告 AI 分析师(全局/AI入口)侧栏page=ads,3 预设问句:最近哪些天赚钱/亏钱?哪些活动有问题怎么调?哪个产品广告效率最高?useAIContext(page:"ads"),getContext 带 {brand,tab,platform,timeRange};交互:点预设提问AI 面板出现 3 预设且上下文含当前 tab生效
AC-EL-ADS-008自定义模块区(全局/底部)容器品牌可配置模块挂载点CustomModules page="ads"(组件本体属 AC-EL-CMP 共享组件范畴,此处登记引用)见 AC-EL-CMP 清单待深化
AC-EL-ADS-009晨报头卡(晨报/头卡)卡片「🌅 晨报 · {bj_date}」+「数据截至 {as_of}(昨日全档入库后)」+去决策按钮GET /api/ads/morning(ads.py:3241);北京 08:00 视角,数据截至昨日;交互:「去决策(N)」跳 advice tab。待核:handler 源表未逐行读。

2026-10-22 换绿:源表已逐行核=audit.cleaned_amazon_ads_campaigns(昨日 USD 合计 :3253)+audit.cleaned_noon_ads_campaign(分国本币 AE/SA :3263)+ads_advice(队列 :3273/计数 :3288/昨日决策 :3293/回访 :3311)+ads_advice_checkin(昨夜回访结论 :3341)+ads_campaign_monitor(:3347)+人工操作单计数(:3350);北京 08:00=timezone(+8) :3245,全代码聚合零 LLM
对比接口 bj_date/as_of 字段;核对 morning 建议存储源表(ads.py:3241 起 SQL)生效
AC-EL-ADS-010KPI 待决策建议(晨报/KPI行)KPI卡queue.total,>0 红色;脚注「escalated 优先 · 去处理」链接同 009;queue.total=pending+escalated 计数;交互:点「去处理」跳 advice值=advice tab 决策队列两态之和生效
AC-EL-ADS-011KPI 昨日决策执行(晨报/KPI行)KPI卡executed_yesterday.length;脚注「API 直连 + 人工兜底」昨日(北京日) decision 落库数与 advice tab 昨日决策数对生效
AC-EL-ADS-012KPI 到期/逾期回访(晨报/KPI行)KPI卡followups.due.length;脚注 逾期 N 项/无逾期检查点 3/7/15/30/60/90d 到期集合;overdue 单列到期日期≤今日的行数生效
AC-EL-ADS-013KPI monitor 告警(晨报/KPI行)KPI卡monitor.by_monitor.alert;脚注 watch N · 观察中 N与 monitor tab 同源计数(ads.py:3131)与监测 tab alert tab 计数相等生效
AC-EL-ADS-014KPI 人工操作单(晨报/KPI行)KPI卡ops_pending;脚注「noon 渠道无 API 直连」executed_by=manual-ops 未回执数(POST /api/ads/ops/{aid}/done 核销,ads.py:3206)Noon 采纳建议后+1,回执后-1生效
AC-EL-ADS-015昨日投放概览表(晨报/表)表格列:品牌/平台国家/花费/销售/ACOS。Amazon 行 USD(全站);Noon 行本币分国({spend} {currency}),副题「Amazon USD / Noon 本币分国」AC-CAL-05:Noon 本币行不折算、禁跨币种裸加;ACOS=花费/销售×100,null 显「—」Amazon 行 SQL 对 cleaned 源表昨日(北京日)复算;Noon 行对 cleaned_noon_ads_daily 分国生效
AC-EL-ADS-016回访检查点表(晨报/条件表)表格仅 due>0 渲染。列:campaign/品牌国家/检查点(Nd)/到期/建议状态;到期≤bj_date 行红字;副题含逾期数followups.due;3/7/15/30d+月度60/90d红行=到期日≤今日生效
AC-EL-ADS-017昨夜回访结论(晨报/条件列表)列表仅 verdicts_yesterday>0。verdict badge(improved绿/flat灰/worse红/no-spend绿/no-data灰)+campaign+品牌国家+规则+检查点+note改前7d vs 改后Nd 全代码判定与 CheckinModal(038/044)同建议记录对生效
AC-EL-ADS-018待决策队列 Top 12(晨报/列表)列表escalated 行加「催办」红 badge;rule badge+campaign+品牌·平台·国家+→动作+reason+花费USD;空态「队列为空」queue.items 前12,副题「共 N 条」与 advice tab 队列前12一致生效
AC-EL-ADS-019状态页签(建议/toolbar)页签决策队列(status=pending,escalated)/全部状态(status 不传)GET /api/ads/advice?status&platform(ads.py:2966);引擎零 LLM。待核:建议存储表名未逐行读;交互:切换重查。

2026-10-22 换绿:存储表=ads_advice(租户 schema,读写同表,决策落同表状态机);status 支持逗号多状态 ANY(:2987,决策队列=pending,escalated;无参默认五状态 :2991);排序 escalated 优先(:3019);引擎=advisor.run_advisor(每日 23:10 UTC,全代码零 LLM)
请求 status 参数;核对 advice 存储源表 SQL生效
AC-EL-ADS-020状态统计行(建议/toolbar)文本「pending N · escalated N · …」+「API 直连: 品牌列表」stats.by_status;api_brands=有 API 直连能力的品牌与全部状态列表计数对生效
AC-EL-ADS-021⚙参数按钮(建议/toolbar)按钮title「规则参数配置(grp=advisor 阈值)」onGoto("config") → RuleConfigTab;交互:点击跳 configURL tab=config生效
AC-EL-ADS-022空态卡(建议/空态)卡片「当前筛选无建议(检测 23:10 UTC / 北京 07:10 每日刷新)」items.length===0新品牌/清队列后目检生效
AC-EL-ADS-023建议卡骨架(建议/列表卡)卡片每建议一卡;escalated 加 danger 边框渲染 data.items见 024-038 各元素生效
AC-EL-ADS-024卡头 badges(建议/卡头)徽标状态badge(ST_COLOR:pending黄/escalated红/rejected灰/monitoring蓝/executed青…)+规则名+campaign 粗体+品牌·平台·国家;hit_count>1 加「连续命中 N天」status_cn/rule_cn/hit_countbadge 色与状态枚举对生效
AC-EL-ADS-025建议行(建议/卡身)文本「建议: {action_cn} → ${new_budget} (×{factor}) — {reason}」budget 类动作附新预算与系数与卡决策历史对生效
AC-EL-ADS-026近N天指标行(建议/卡身)文本「近{win||window_days||7}天: 花费 X · ACOS x% · CTR x% · 曝光 N · 日预算 N · TACOS(月,活动SKU集) x% · 目标ACOS x% · ⚠人工操作单待办 · 冷却至 日期」花费 spendCell:有 currency+spend_local 显本币,否则 USD;TACOS=月广告花费/活动SKU集总销售有币种行显「1,234 SAR」式生效
AC-EL-ADS-027改价明细展开(建议/卡身·条件)折叠表action=update_keyword_bids 且 changes>0:「▸ 展开 N 条改价明细」+「已勾 x/N(不勾选的行不执行)」R23/R24(2026-10-19) 逐条勾选;Amazon 行={keyword,match_type,current_bid,suggested_bid},Noon 行={target_value,current_bid,new_bid};交互:展开见表 028;勾选行切换勾选数进执行载荷生效
AC-EL-ADS-028改价明细表(建议/卡身)表格列:勾/#/关键词定向/匹配/现价/建议价(绿粗+(现价×倍数))/[dim 时+]曝光/点击/点击率/订单/转化率/GMV/花费/ACOS/利润率(负红,带*估算标)/利润/依据(官方: reason_en 或 basis)dim=行带 gmv/clicks 维度(BID_CALC R24);利润率=(结算净额−采购成本×销量)/GMV 按目标内SKU收入加权,*=缺采购成本用品牌×国家均值估算;交互:勾选(仅 pending/escalated 可改);未勾行 opacity .45未勾行不出现在 decision 请求 changes生效
AC-EL-ADS-029利润率脚注(建议/卡身)脚注利润率公式+*估算说明+TACOS 见卡面dim 时显示目检公式句生效
AC-EL-ADS-030加词明细展开(建议/卡身·条件)折叠表action=add_keyword 且 suggestions>0:「▸ 展开 N 个推荐词明细」+已勾 x/N(不勾选的词不添加)R24 推荐词逐条+勾选;交互:展开见表 031同 027生效
AC-EL-ADS-031加词明细表(建议/卡身)表格列:勾/#/关键词/匹配/建议出价(绿粗)/依据交互:勾选(仅 open 态);建议价>0 才可执行全不勾点执行→alert「没有可添加的词」生效
AC-EL-ADS-032加词平台脚注(建议/卡身)脚注Noon:「采纳即按建议出价逐词加词到该 noon 活动; 建议价=有效ACOS×CVR×AOV(活动毛利率封顶)」;Amazon:「逐条加词到广告组 {ad_group_id}(官方建议价, 词史为依据)」;✎可逐词改价BID_CALC 口径(R24,2026-10-19)公式句与 R24 拍板一致生效
AC-EL-ADS-033回访行(建议/卡身·条件)文本monitoring/executed 且有 base_date:「回访: 日期 起 · 3d 7d 15d 30d 60d 90d」,已完成检查点加粗着色followup.checkpoints/donedone 与 CheckinModal 记录对生效
AC-EL-ADS-034✔执行按钮(建议/卡尾)按钮pending/escalated 显示;window.confirm(含品牌/国家/活动/理由/勾选计数);accept 后 exec_result.ok=false → alert「决策已记录, 但 API 执行失败(已转人工兜底)」POST /api/ads/advice/{id}/decision {decision:"accept", suggestions?/changes?};add_keyword 需≥1 个有出价勾选词;update_keyword_bids 需≥1 勾选行DevTools 看载荷含勾选子集生效
AC-EL-ADS-035✎修改按钮(建议/卡尾)按钮打开 EditModal(040-043)仅 open 态;交互:点击开弹层弹层预填卡数据生效
AC-EL-ADS-036✕驳回按钮(建议/卡尾)按钮confirm「驳回该建议? (7 天冷却, 跨级恶化才会重提)」POST decision {decision:"reject"};rejected_until 冷却驳回后卡灰、显示冷却至日期生效
AC-EL-ADS-037✓已办回执(建议/卡尾·条件)按钮monitoring 且 executed_by=manual-ops;confirm 后核销人工操作单并起 3/7/15/30/60/90d 回访POST /api/ads/ops/{id}/done晨报 ops_pending 减 1生效
AC-EL-ADS-038📋回访按钮(建议/卡尾·条件)按钮monitoring/executed/resolved 显示,打开 CheckinModalGET /api/ads/advice/{aid}/checkins(ads.py:3227);交互:点击开弹层弹层列出各检查点生效
AC-EL-ADS-039分页脚注(建议/尾)文本「显示前 N 条 / 共 M 条(按花费降序)」total>items.length 时显示计数与接口 total 对生效
AC-EL-ADS-040EditModal·动作/预算(建议/弹层)表单动作 select:暂停/降预算/加预算/检查创意定向/按建议改关键词出价/按建议加推荐词;budget 类出「预算系数(×)」「新日预算 $(留空用系数算)」7.6 决议:数字/动作/理由都可改,保存即按新值执行;POST decision {decision:"edit",…}修改后卡动作变 modified 语义生效
AC-EL-ADS-041EditModal·改价表(建议/弹层)表格列:勾/关键词定向/现价/建议价/新出价(input step0.01, min Noon 0.01 / Amazon 0.02)/依据;护栏提示 Noon [0.01,200]本币 / Amazon [0.02,100]站点货币勾选行必填价且>0,空/非法报行号错误提交载荷 changes 含新价生效
AC-EL-ADS-042EditModal·加词表(建议/弹层)表格列:勾/关键词/匹配/建议价/新出价/依据;护栏同 041同 041;至少勾一词同 041生效
AC-EL-ADS-043EditModal·理由/备注(建议/弹层)表单理由 textarea(预填)+决策备注(可选)随 decision 提交载荷 reason/note生效
AC-EL-ADS-044CheckinModal(建议/弹层)弹层标题「建议 #N 回访记录 · 改前 7 天 vs 改后 N 天, 全代码判定」;每检查点:Nd 检查点+verdict badge(五色)+到期/记录时间+「改前: ACOS x% · 花费 x · 销售 x → 改后: …」+note;空态「尚无到期检查点(3/7/15/30/60/90 天逐个回访)」GET checkins;before/after 指标集与晨报昨夜结论(017)互证生效
AC-EL-ADS-045monitor 状态页签(监测/toolbar)页签「全部」+按计数降序的状态页签「{中文名} (N)」:告警/建议暂停/观察/观察中/健康GET /api/ads/monitor?monitor&platform(ads.py:3131);by_monitor/monitor_cn;全部 active campaign。待核:monitor 存储源表未逐行读。

2026-10-22 换绿:存储表=ads_campaign_monitor(租户 schema,:3153 GROUP BY monitor);「全 active 常驻」由写入侧 advisor._refresh_monitor 保证——PAUSED 无建议不进表(:1079)、停投剔除(:1105)、30 天未刷新且无关联建议 DELETE(:1119-1124)
计数和=总数;核对 ads.py:3131 起源表 SQL生效
AC-EL-ADS-046监测表(监测/表)表格副题「近 7 天窗口 · 每日 23:10 UTC 刷新 · 共 N 条」。列:状态badge(MON_COLOR:alert红/paused-by-advice青/watch黄/observation蓝/healthy灰)/campaign(非 ENABLED 附注状态)/品牌·平台·国家/日预算 USD/7d花费(本币优先否则USD)/7d ACOS/曝光/更新时间近7天窗口口径;spendCell 同 026;同 045 源(待核同 045)。

2026-10-22 换绿:7 天窗实证(advisor.py:1075 w7 / :1093 window_days=7);每日 23:10 UTC 刷新(pipe_morning_check.py:75);本币优先=noon 行 metrics 带本币(:1109-1113)、amazon 行 USD;底层日线=cleaned_amazon_ads_campaigns+cleaned_noon_ads_campaign 载 14 天算 7 天窗(advisor.py:67/89)
23:10 UTC 跑批后 updated_at 前滚生效
AC-EL-ADS-047视图页签(投放分析/头)页签概览(ov)/明细(国家/产品/SKU)(detail),默认概览page.tsx:759,996-997;交互:切换明细视图出三表生效
AC-EL-ADS-048明细·数据拉取(明细/逻辑)接口明细三表与头部合计的数据源GET /api/ads/analysis?days&brand&platform&from_date&to_date(ads.py:70);Amazon=cleaned_ads_sku_daily(zf/fg)+cleaned_amazon_ads_daily(onno)+ad_campaigns(zf/fg 30d快照);Noon=cleaned_noon_ads_daily(ad_type IN product/sp/all)+归集层 cleaned_noon_ads_sku_attr(2026-10-21 P2 SKU 归因修复,覆盖≈99.8%,AC-CAL-03)切时间档看请求参数;源表名与本行一致生效
AC-EL-ADS-049明细·头部合计行(明细/头)合计三表各自的窗口合计后端聚合(同 048 源)SQL 同窗 SUM 复算生效
AC-EL-ADS-050明细·空态卡(明细/空态)卡片data_through 提示「采集依赖站外侧源表」data_through=max(day) across sources新品牌目检生效
AC-EL-ADS-051明细·三表(明细/主体)表格×3分国家前50 / 分产品前50 / 分SKU前100,均按花费降序同 048 源表分组行数上限与排序生效
AC-EL-ADS-052明细·13列指标头(明细/表列)列集曝光/点击/CTR/花费/订单/收入/CVR/CPC/AOV/ACOS/ROAS/CPS/判定公式见全页通用;CTR/ACOS 百分比列名与顺序生效
AC-EL-ADS-053明细·本币双行(明细/表行)格式local_spend+currency 存在时:本币主行 + USD 副行(小字 t2)AC-CAL-05 变体:Noon 行本币为主 USD 为辅,禁裸加Noon 行见双行生效
AC-EL-ADS-054明细·ACOS 三色(明细/表列)着色ACOS 按阈值三色AC-CAL-06:阈值来自 /api/metric-thresholds 单源,禁内联改阈值配置后颜色分界移动生效
AC-EL-ADS-055明细·判定 badge(明细/表列)徽标HEALTH:healthy健康(绿)/watch观察(黄)/poor超标(红)/zero无转化(红)/idle无花费(灰)/paused已暂停(灰)page.tsx:43-49 判定口径各态构造数据目检生效
AC-EL-ADS-056明细·脚注(明细/脚注)文本数据源+判定口径说明静态(含源表名)目检含源表名生效
AC-EL-ADS-057概览·角色门(概览/逻辑)权限canOps=owner|admin 才显示写操作/api/tenant/info 角色判定viewer 角色无操作钮生效
AC-EL-ADS-058概览·KPI 广告花费(概览/KPI)KPI卡窗口广告花费合计GET /api/ads/platform(ads.py:482);合计后端单源(C3批#60);Noon 合计折 USD 走 fx_rates 市场价(AC-CAL-05)SQL 复算生效
AC-EL-ADS-059概览·KPI 广告销售(概览/KPI)KPI卡窗口广告销售(折USD)+ROAS(健康线着色)+ACOS同 058;ROAS=sales/spend;健康线色同 054同 058生效
AC-EL-ADS-060概览·KPI 曝光·活动数(概览/KPI)KPI卡曝光合计+在投活动数ad_campaigns 计数活动表行数对生效
AC-EL-ADS-061概览·KPI 点击·CTR·CPC(概览/KPI)KPI卡点击合计+CTR+CPC公式全页通用复算生效
AC-EL-ADS-062概览·KPI 广告订单·CVR(概览/KPI)KPI卡广告订单合计+CVR公式通用复算生效
AC-EL-ADS-063月度投放表(概览/表)表格月×花费/销售/ROAS 等;Noon 多国家/币种行+活动数列;尾行「合计 USD」归一AC-CAL-05:分国本币行+合计 USD 行合计行=分国折USD之和生效
AC-EL-ADS-064投放活动表·Amazon 列(概览/表)列集活动/品牌/状态/健康度badge/花费/销售(7天归因,AC-CAL-04 campaign级禁进SKU)/ACOS(色同054)/ROAS=spend?sales:spend/曝光/点击/CTR/订单/操作ad_campaigns 30d 快照+ads_sku_daily;操作列见 066-070ROAS 无销售时=花费值语义生效
AC-EL-ADS-065投放活动表·Noon 列(概览/表)列集国家(币种)/状态/…(指标同 064,本币口径)+操作cleaned_noon_ads_daily(AC-CAL-03 分层)AE/SA 行币种标注生效
AC-EL-ADS-066操作·暂停/启用(概览/操作列)按钮暂停⇄启用活动,EXECUTE_ADS_ACTION 确认串POST /api/ads/campaign-ops(ads.py:1669)+X-Idempotency-Key;交互:弹确认请求含确认串与幂等键生效
AC-EL-ADS-067操作·预算(概览/操作列)按钮「新预算 {单位}(当前 N)」;AMZ [1,10000] USD/日;Noon [1,30000] 本币/日同 066+数值护栏;交互:填值确认越界值被拒生效
AC-EL-ADS-068操作·改名(概览/操作列)按钮新名称 1-128 字符且须与当前不同同 066同名/超长被拒生效
AC-EL-ADS-069操作·克隆(概览/操作列)按钮AMZ:「将以 {名}-copy 克隆(创建即暂停)」;Noon:新名称留空自动 Dup-<原名>-<时间戳>+日预算本币留空继承(下限5);护栏 Noon [5,30000]同 066克隆后活动列表新增暂停态行生效
AC-EL-ADS-070操作·归档(概览/操作列)按钮归档活动(含警告文案+确认串)同 066归档后入折叠区生效
AC-EL-ADS-071ops_ready 逐按钮解锁(概览/逻辑)权限Noon budget/rename/create/clone/archive、Amazon create 等能力旗标逐按钮解锁ops_ready flags(/api/tenant/info 能力面);未解锁按钮隐藏/禁用缺旗标时对应钮不出现生效
AC-EL-ADS-072创建 Amazon 活动(概览/创建)表单国家代码(品牌在投市场如 US/DE/UK)/活动名 1-128 同名拒建/日预算 USD [1,10000] 默认10/投放方式 AUTO|MANUAL;创建即暂停POST campaign-ops create 分支;交互:多步输入+确认串新活动为 PAUSED 态生效
AC-EL-ADS-073创建 Noon 活动(概览/创建)表单国家 AE 或 SA/活动名 1-128/日预算本币 [5,30000](Noon 服务端下限5)/SKU 列表 1-50 个需在 Noon 目录在售同 066 create 分支非在售 SKU 被拒生效
AC-EL-ADS-074零活动/归档折叠区(概览/折叠)折叠区零活动与归档活动收纳,snapshot_only 行默认收起R23b:避免快照行淹没在投列表;交互:展开/收起归档活动默认不可见生效
AC-EL-ADS-075健康度统计副题(概览/表头)文本活动健康度分布统计后端统计分布数=表内 badge 计数生效
AC-EL-ADS-076概览·脚注(概览/脚注)文本数据源说明静态(含源表名)目检源表名生效
AC-EL-ADS-077图·国家筛选(图区/头)下拉国家 selectGET /api/ads/charts?brand&platform&country&days(ads.py:721);交互:选择重查请求 country 参数生效
AC-EL-ADS-078图·天数页签(图区/头)页签7/14/30/60/90/全部(0)CHART_DAYS;交互:切换days 参数生效
AC-EL-ADS-079c1 花费/收入(图区/图)双bar图花费(红)bar+收入(绿)bar,日粒度charts 接口 series;Noon 副题「本币口径」series 数=2生效
AC-EL-ADS-080c2 ROAS(图区/图)折线图ROAS 日趋势=收入/花费与 c1 导出数互算生效
AC-EL-ADS-081c3 CTR(图区/图)折线图CTR 日趋势=点击/曝光复算生效
AC-EL-ADS-082c4 CVR(图区/图)折线图CVR 日趋势=订单/点击复算生效
AC-EL-ADS-083c5 CPC(图区/图)折线图CPC 日趋势=花费/点击复算生效
AC-EL-ADS-084c6 花费Top20(图区/图)横bar图花费 Top20(SKU/ASIN)降序截断20行数≤20生效
AC-EL-ADS-085c7 ROAS by ASIN(图区/图)bar图ASIN 维 ROAS分组聚合与明细表对生效
AC-EL-ADS-086c8 月度双bar(图区/图)双bar图月度花费+收入月聚合月桶数生效
AC-EL-ADS-087c9 月度ROAS(图区/图)bar图月度 ROAS月聚合同 086生效
AC-EL-ADS-088c10 ATC(图区/图)bar图·占位加购紫 bar;Amazon 平台显占位文案「源无ATC数据恒0请切Noon」Amazon 源表无 ATC 列(诚实占位,不造数)Amazon 下显示占位说明生效
AC-EL-ADS-089c11 CPS(图区/图)折线图CPS 日趋势=花费/订单复算生效
AC-EL-ADS-090c12 曝光/点击(图区/图)双线图曝光+点击双线两 seriesseries=2生效
AC-EL-ADS-091断更 badge(图区/头)徽标「数据止于 MM-DD」(最新点>3天前)data_through 判定人为断更后出现生效
AC-EL-ADS-092国家探测回退(图区/逻辑)逻辑选中国家无数据自动回退「全部」+banner「显示全部时段」probe 请求+fullCache 防重查冷门国家验证生效
AC-EL-ADS-093KPI 花费(搜索词/KPI)KPI卡窗口搜索词花费合计GET /api/ads/search-terms?days&brand&platform&min_spend&sort&page_size=30(ads.py:818);Amazon SP 搜索词报告(7天归因,AC-CAL-04)+Noon 查询词报告日更SQL 复算生效
AC-EL-ADS-094KPI ROAS·ACOS(搜索词/KPI)KPI卡ROAS+ACOS公式通用复算生效
AC-EL-ADS-095KPI 点击·CPC(搜索词/KPI)KPI卡点击+CPC公式通用复算生效
AC-EL-ADS-096KPI 搜索词数(搜索词/KPI)KPI卡去重搜索词数count distinct对表行数生效
AC-EL-ADS-097KPI 零转化浪费(搜索词/KPI)KPI卡danger 色「N 个词花费≥$20 无销售」waste 判定:spend≥20 且 sales=0构造词复算生效
AC-EL-ADS-098kpi_note(搜索词/KPI)注释ℹ️ 口径说明静态目检生效
AC-EL-ADS-099月净贡献热力表(搜索词/热力表)表格Top搜索词×月:绿赚红亏,alpha=0.08+|net|/maxAbs×0.47;净贡献=销售−花费;hover 金额;stFmt k 格式;合计列净贡献口径单源单元格色深与金额绝对值单调生效
AC-EL-ADS-100否词候选卡(搜索词/卡)卡片≥$20 零销售词列表+「复制否词列表」按钮(clipboard);脚注「粘贴到亚马逊后台否定投放,竞品词优先」waste 词集;交互:复制粘贴内容=列表词生效
AC-EL-ADS-101明细表(搜索词/表)表格15 列,双平台 badge;判定 ST_VERDICT:star高效/healthy健康(绿)/watch观察(黄)/waste烧钱(红)page.tsx:1156-1158四态目检生效
AC-EL-ADS-102排序/分页(搜索词/表尾)控件sort(spend/sales/roas/clicks/term)+min_spend+分页 page_size=30请求参数;交互:切换请求参数变化生效
AC-EL-ADS-103Noon 占位提示(bids·Noon 进入时)提示引导去 noonkw tab平台特有;交互:跳转Noon 下无此 tab(自动跳转 003)生效
AC-EL-ADS-104匹配页签(bids/头)页签EXACT精确/PHRASE词组/BROAD广泛/Auto投放/定投MATCH_CN;GET /api/ads/keyword-bids?match&action&country&days=30&sort&page_size=30(ads.py:933);交互:筛选match 参数生效
AC-EL-ADS-105KPI×6(bids/KPI)KPI卡关键词投放目标/花费→销售/整体ACOS·目标N%·CPC/建议提价(绿)/建议降价(黄)/暂停观察sort=impact/spend/acos/cut/raise与明细计数对生效
AC-EL-ADS-106动作筛选(bids/toolbar)页签↑提价/↓降价/⏸暂停参考/·观察KB_ACTION(page.tsx:1347);交互:筛选action 参数生效
AC-EL-ADS-107明细表(bids/表)表格14 列:含当前bid/建议bid(粗体)/幅度±%/动作badge/依据规则脚注见 109幅度=(建议−当前)/当前生效
AC-EL-ADS-108导出 CSV(bids/表尾)按钮导出当前筛选前端生成;交互:下载行数=表行数生效
AC-EL-ADS-109规则脚注(bids/脚注)文本花费≥$15零销售→暂停(半价参考);ACOS>40%→降价至目标25%(下限4折);ACOS≤25%且点击≥5→加价(上限1.25倍);无SP报告品牌不在列引擎规则;阈值联动 config(165-169)无 SP 品牌确实不在列生效
AC-EL-ADS-110无数据声明 banner(分时/头)横幅「广告侧仅日粒度无小时数据——订单侧分时分布,分时花费与分时ACOS无数据源不展示」口径诚实声明(不造数)目检生效
AC-EL-ADS-111总量+高峰(分时/头)徽标总订单+高峰小时 badges+覆盖 metaGET /api/ads/dayparting(ads.py:1031);近60天;北京小时。待核:订单侧源表未逐行读。

2026-10-22 换绿:订单侧源表=租户 sales_hourly(Amazon,sync_source 60 天滚动,spapi 下单时间→北京小时 :1058)+audit.cleaned_noon_orders(Noon,order_placed_at AT TIME ZONE Asia/Shanghai :1067);窗口 clamp 7..60 默认 60(:1053);广告侧无小时数据→ads_hourly_available:False+note 明示(:1095-1098)
覆盖日期范围;核对 ads.py:1031 起源表 SQL生效
AC-EL-ADS-112堆叠柱图(分时/图)图表24h 堆叠 bar:Amazon #f59e0b + Noon #7c3aed北京时区小时桶两段和=表合计生效
AC-EL-ADS-113分时表(分时/表)表格列:小时/Amazon订单/Noon订单/合计/占比;占比条 share×4 cap100% brand 色;高峰行高亮share_pct=小时订单/总订单占比列和≈100%生效
AC-EL-ADS-114Noon 占位卡(optlog·Noon)卡片「Amazon 特有」说明卡平台特有 tabNoon 下自动跳转不显示生效
AC-EL-ADS-115RecEngine·KPI 待审建议(optlog/建议引擎)KPI卡warn 色;脚注「规则引擎·每日23:00 UTC·最新跑批·待审7天自动过期」GET /api/ads/recommendations?status&rule&win&brand&limit=50(ads.py:1084)7天前 pending 不再显示生效
AC-EL-ADS-116RecEngine·KPI×4(optlog/建议引擎)KPI卡已接受/已拒绝/已修改/规则分布前4 badgestats 聚合与列表计数对生效
AC-EL-ADS-117RecEngine·窗口页签(optlog/引擎toolbar)页签全部/1d昨日/3d/7d/30dwin 参数;交互:筛选win 参数生效
AC-EL-ADS-118RecEngine·规则/状态筛选(optlog/引擎toolbar)select+页签规则 select+状态页签rule/status 参数;交互:筛选参数生效
AC-EL-ADS-119⟳立即重跑(optlog/引擎toolbar)按钮手动触发跑批POST /api/ads/recommendations/run(ads.py:1301);交互:点击跑批后列表刷新生效
AC-EL-ADS-120⚙参数(optlog/引擎toolbar)按钮跳 config(grp 联动)onGoto("config");交互:点击URL生效
AC-EL-ADS-121RecEngine·建议表(optlog/引擎表)表格列:窗口/规则(RULE_TONE:emergency_stop 行红底/max_clicks_alert 黄底)/目标/品牌平台/花费/建议动作(modified=删除线原动作+修改版)/依据/状态/决策引擎零 LLM;决策列见 122色带规则目检生效
AC-EL-ADS-122RecEngine·决策三按钮(optlog/引擎表)按钮pending:✓接受/✗拒绝/✎修改,均强制理由(usePrompt)POST /api/ads/recommendations/{rid}/decision(ads.py:1162);交互:弹理由框空理由被拒生效
AC-EL-ADS-123RecEngine·⚡执行(optlog/引擎表·条件)按钮accepted+Amazon+keyword级+未执行;新bid USD 预填 suggested,护栏 [0.02,10],确认串 EXECUTE_ADS_ACTIONPOST /api/ads/recommendations/{rid}/execute(ads.py:1388)+X-Idempotency-Key+idempotent_replay 消息;actionMap: bid_raise/bid_lower→update_bid, pause_keyword→pause_keyword载荷含确认串/幂等键/护栏拒越界生效
AC-EL-ADS-124RecEngine·脚注(optlog/引擎)脚注「23:00 UTC 三窗口·零LLM·活动级并入 advisor(23:10 UTC)」与 advice 引擎分工声明目检生效
AC-EL-ADS-125AI 优化日志折叠区(optlog/折叠)details归档折叠;2026-10-11 E 源已停更历史数据只读;交互:展开默认收起生效
AC-EL-ADS-126LogTab·KPI×5(optlog/日志头)KPI卡日志总数(停更标注「⚠️最近一条 N天前(日期)」基准2026-09-26)/待审/已执行/已忽略/人工反馈(本页)GET /api/ads/optlog?limit=50&offset&status&platform&brand&q(ads.py:244)停更天数=今天−最新log日期生效
AC-EL-ADS-127日志搜索(optlog/toolbar)输入活动名/详情/原因/ASIN 关键词q 参数;交互:输入过滤命中高亮生效
AC-EL-ADS-128日志导出 CSV(optlog/toolbar)按钮导出当前筛选前端生成;交互:下载行数一致生效
AC-EL-ADS-129日志表(optlog/表)表格8 列optlog 存储—生效
AC-EL-ADS-130日志展开行(optlog/表行)展开原因/建议动作JSON/执行结果/反馈备注行数据;交互:展开JSON 可读生效
AC-EL-ADS-131反馈四按钮(optlog/展开行)按钮user_status 四态反馈POST /api/ads/optlog/{log_id}/feedback(ads.py:294);交互:点击状态落库刷新生效
AC-EL-ADS-132日志分页(optlog/表尾)分页limit=50+offset参数;交互:翻页offset 变化生效
AC-EL-ADS-133否词·状态页签(optlog/否词)页签全部/生效中/已驳回(带计数)GET /api/ads/neg-keywords?status&q&brand&limit=200(ads.py:1198,250ms debounce);交互:筛选计数对生效
AC-EL-ADS-134否词·添加表单(optlog/否词)表单否词(≤250字符)/站点(空=全部)/类型 negativeExact精准|negativePhrase词组/备注POST /api/ads/neg-keywords(ads.py:1239);交互:提交超长被拒;新词入表生效
AC-EL-ADS-135否词·表(optlog/否词)表格9 列;来源 ORIGIN_CN manual手动/accepted建议采纳/migrated迁移否定;备注行内编辑;驳回↔恢复切换;🗑删除PATCH /api/ads/neg-keywords/{nid}(ads.py:1266)/DELETE(1288);交互:行内操作状态切换即时反映生效
AC-EL-ADS-136否词·单一事实源脚注(optlog/否词)脚注+空态F3-2:注册表为单一事实源,表内词引擎不再重提;空态文案口径声明添加词后建议引擎不再提同名生效
AC-EL-ADS-137主表(noonkw/表)表格Campaign/AdGroup/关键词/匹配/出价/状态(live badge);exportCsv;caliber「admanager campaign details 每日拉取」GET /api/noon/keywords?limit=200。待核:源表未逐行读(Noon 侧 router);交互:导出。

2026-10-22 换绿:handler=noon_data.py:35;源表={品牌schema}.{bs}_ads_keywords(最新 snapshot_date 快照)+{bs}_ads_skus(ad_type=target 近 7 天定向层,effective_bid/recommended_bid);租户隔离=tenant_noon_schemas 路由(ISO-01 2026-10-14 修,模块头注);limit Query(50,le=200) 与前端 200 一致
行数与接口对;核对 noon router 源表 SQL生效
AC-EL-ADS-138🎯定向明细表(noonkw/定向表)表格品牌/国家/活动/定向类型(accent badge)/定向值/搜索词/出价/实际出价(粗体)/激活✓✗/改价入口(canEdit)target 层近7天;effective_bid=实际扣取;交互:见 140实际出价≠出价行存在生效
AC-EL-ADS-139定向脚注(noonkw/脚注)文本「target层近7天·effective_bid=实际扣取·改价走 adgroup-target/update+回读验证·建议出价列从未填充已隐去」口径诚实声明目检生效
AC-EL-ADS-140NoonBidEditModal(noonkw/弹层)弹层新出价护栏 [0.01,200] 本币;原生 window.confirm/alert(非 kit);确认串 EXECUTE_ADS_ACTIONPOST /api/ads/noon-keyword-bid(ads.py:2080)+幂等键+回读验证越界拒;改后表内回读值更新生效
AC-EL-ADS-141类型 badge(noonrec/表)徽标increase_bid加价/add_target加词/remove_target删词GET /api/noon/recommendations;raw JSON 解析(乱码根因见组件注释)。待核:源端表未逐行读。

2026-10-22 换绿:源表={品牌schema}.{bs}_ads_recommendations(最新快照,raw 原样透传 :81=乱码根因)+SaaS 侧 ads_noon_rec_adoptions 关联采纳标记(R21-P2,采集表每日 DROP+CREATE 标记不丢);同经 tenant_noon_schemas 路由
三类型各见行;核对 noon recommendations 源表生效
AC-EL-ADS-142建议表(noonrec/表)表格Campaign/关键词定向/建议出价 X→Y/理由(Noon官方英文)/生成日出价单位市场本币 SA=SAR/AE=AED—生效
AC-EL-ADS-143已采纳 badge(noonrec/表)徽标已采纳行 badge;add_target 行显「待通道」采纳标记存 SaaS 库,采集表每日重建不丢。待核:add_target 加词端点待抓包实证。

2026-10-22 换绿:核验结果——UI「待通道」至今仍准确(一键采纳 add_target 故意 400,ads.py:1990);但「加词端点待抓包」已过时:加词执行端点已实证并投产=noon_exec.exec_rec_accept:785(POST /_svc/productads/v2/recommendations/accept/{recId}),建议队列 add_keyword 决策经 advisor.py:1682 走此通道(含 recId 轮换解析 :765-782+采纳后 update_bid 回读校正 :1696-1703);increase_bid/remove_target 一键采纳走 adgroup-target/update 回读验证;幂等+审计=ads_decision_request/ads_decision_audit(:2002/:2030)
次日仍显示已采纳;抓包实证 adopt 通道生效
AC-EL-ADS-144采纳按钮(noonrec/表)按钮increase_bid/remove_target 可采纳;确认串POST /api/ads/noon-recommendations/{rec_id}/adopt(ads.py:1965);交互:确认采纳后转 badge生效
AC-EL-ADS-145类型页签(noonfees/头)页签referral佣金/storage仓储/outbound出库/fbp直发GET /api/noon/fees?fee_type;按类型解析 JSON 列。待核:源表未逐行读;交互:切换。

2026-10-22 换绿:源表={品牌schema}.{bs}_fees_{fee_type} 四选一(referral/storage/outbound/fbp,最新快照,fee_data JSON 原样回传 :110-113);fee_type pattern 校验 :103;模块门=require_module("finance") 非 ads(:104);同经 tenant_noon_schemas 路由
列集随类型变;核对 noon fees 源表生效
AC-EL-ADS-146referral 列集(noonfees/表)列集履约badge/SKU/市场+SAR/AED/周期/基础价/佣金率%/佣金额佣金=基础价×佣金率单行验算生效
AC-EL-ADS-147storage 列集(noonfees/表)列集月仓储费——生效
AC-EL-ADS-148outbound 列集(noonfees/表)列集出库费/计费重/实重/尺寸L×W×H cm/分类——生效
AC-EL-ADS-149fbp 列集(noonfees/表)列集均值费/取件费/送仓费——生效
AC-EL-ADS-150导出+脚注(noonfees/尾)按钮+文本exportCsv noon_fees_<type>;caliber「noon catalog 费用接口·市场本币·佣金=基础价×佣金率」本币口径(AC-CAL-05 伴生);交互:下载文件名生效
AC-EL-ADS-151数据源模式矩阵(upload/矩阵卡)矩阵品牌×通道 auto自动(ok)/manual手动(warn)/none无此通道(dim badge);当前品牌高亮GET /api/ads/sources(ads.py:2890)高亮行=当前品牌生效
AC-EL-ADS-152上传卡·品牌/平台(upload/上传卡)徽标+下拉品牌 badge+平台 select(Amazon/Noon)平台可手选亦由文件自动识别;交互:选择识别结果覆盖手选生效
AC-EL-ADS-153上传卡·Noon国家(upload/上传卡)下拉SA/AE/ALL(④A 新导出 ALL 无国家段时用);亦可文件名识别文件名优先;交互:选择ALL 文件走 ALL生效
AC-EL-ADS-154文件选择(upload/上传卡)inputaccept .csv,.xlsx,.zip—;交互:选文件非许可扩展名不可选生效
AC-EL-ADS-155①预览解析(upload/上传卡)按钮解析并出预览面板POST /api/ads/upload/preview(ads.py:2762);交互:点击见 156生效
AC-EL-ADS-156预览面板(upload/预览)面板✅平台识别/xlsx/zip member/文件数/国家(重传=覆盖该日该国全部行警告)/行数/日期范围/列映射 k←「列名」/未匹配可选列预览响应渲染;交互:核对后导入列映射与文件头一致生效
AC-EL-ADS-157②确认导入(upload/预览)按钮执行入库POST /api/ads/upload(ads.py:2782);覆盖规则:Amazon 同键(国家+日期+ASIN+活动+广告组)覆盖;Noon 按 日+国 整体替换;交互:点击导入任务出现生效
AC-EL-ADS-158auto 模式提示(upload/上传卡)文本「断供应急补数 SKU 取广告名称」断供降级口径目检生效
AC-EL-ADS-159支持格式脚注(upload/脚注)文本Amazon 中英文报告含 zip;Noon xlsx _OVERVIEW_*_Report_日_日 单日单国可 zip 多日静态目检生效
AC-EL-ADS-160导入任务卡(upload/任务卡)列表5s 轮询刷新GET /api/ads/imports(ads.py:2849);交互:自动轮询导入后≤5s 状态变 done生效
AC-EL-ADS-161任务状态 badges(upload/任务卡)徽标done完成/error失败/running执行中/queued排队中+elapsed_s状态机构造错误文件出 error❌生效
AC-EL-ADS-162任务明细列(upload/任务卡)列集error❌/同步 counts/适配器适配器名与通道对—生效
AC-EL-ADS-163🔁立即重算(upload/任务卡)按钮手动触发重算POST /api/ads/imports/recompute(ads.py:2871);交互:点击重算后聚合更新生效
AC-EL-ADS-164数据归因卡(upload/归因卡)卡片「重新归因近90天」→返回 ads_sku_updated/amazon_ads_updated 计数POST /api/ads/reattribute?brand&days=90(ads.py:2902);交互:点击返回计数>0生效
AC-EL-ADS-165参数分组(config/表)分组14 组 GRP_CN:advisor⓪~rank⑬GET /api/ads/rule-config(ads.py:1319)组数=14生效
AC-EL-ADS-166参数行(config/表)行label/key(⚠未接线 warn badge)/value 行内编辑(Enter保存 Esc取消)POST /api/ads/rule-config(ads.py:1339);交互:行内编辑Esc 不落库生效
AC-EL-ADS-167作用域 badge(config/表)徽标品牌覆盖(warn)/全局默认(dim)存储层判定品牌行显覆盖生效
AC-EL-ADS-168✏️/🗑(config/表)按钮编辑/删除(删除品牌级需 kit confirm)DELETE /api/ads/rule-config/{key}(ads.py:1355);交互:确认弹层删后回全局默认生效
AC-EL-ADS-169生效脚注(config/脚注)文本「次日 23:00 UTC 生效或立即重跑」与 119 联动改参+立即重跑即时生效生效

§11.10 结算页(/settlement · AC-EL-STL,24 条 · 2026-10-22 源码实证 web/app/settlement/page.tsx 130 行 + api/routers/finance.py /api/settlement,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-STL-001页面标题/面包屑导航AppShell title=回款跟踪,面包屑"Amazon 回款/结算跟踪 · 回款跟踪口径"路由 /settlement;接口权限 require_module("finance");数据经 tenant_conn+brand_scope 租户/品牌隔离e2e 登录财务模块账号断言标题与面包屑逐字一致生效
AC-EL-STL-002错误横幅反馈接口失败时红色横幅 role="alert"getJson 异常 setErr 后渲染;无错误时不占位e2e mock 500 断言出现且带 alert 角色生效
AC-EL-STL-003KPI 卡①待回款KPI 卡数量(warn 色)+ foot 金额 usd(pending_amount)(Shipped/Pending 未回款)summary.pending_count=count(*) FILTER(order_status IN ('Shipped','Pending') AND NOT has_finance);金额=sum(revenue_usd) 同过滤;源表 audit.cleaned_amazon_orders;2026-10-01 ⑥拍板:行级 0 占位清洗不影响 KPI(0 不改变 sum)SQL 直连按同口径复算 count/sum 与接口 summary 比对(|Δ|=0)生效
AC-EL-STL-004KPI 卡②回款异常(>14 天)KPI 卡数量(danger 色)+ 金额 + 文案"需优先核查"abnormal_count=count(*) FILTER(is_abnormal);金额=sum(revenue_usd) FILTER(is_abnormal);异常口径=已发货且超 14 天未回款(is_abnormal 同步层置位)SQL 复算 abnormal 两值;抽异常行断言 >14 天生效
AC-EL-STL-005KPI 卡③已回款率KPI 卡pct 百分比;null 显"—";foot"已发货X单中已回款Y单"settled_rate=settled/shipped(shipped=0 时接口返 null);shipped=count FILTER(order_status='Shipped'),settled=count FILTER(order_status='Shipped' AND has_finance);2026-09-21 测试缺陷修复:接口返 0~1 比例,前端需 ×100 后 pct 显示复算 settled/shipped×100 与页面一致;0 发单租户断言显"—"生效
AC-EL-STL-006KPI 卡④等待天数KPI 卡最长等待 max_wait;foot"待回款平均 avg_wait 天 · 健康线 14 天"max_wait=coalesce(max(days_waiting),0);avg_wait=coalesce(round(avg(days_waiting) FILTER(待回款口径)),0);14 天健康线与异常口径同源SQL 复算 max/avg 两值比对生效
AC-EL-STL-007回款明细卡标题卡片h2"回款明细"+ sub"按等待天数倒序"排序 ORDER BY days_waiting DESC, purchase_date DESC(次键下单日期倒序)抽首页数据断言两键单调生效
AC-EL-STL-008状态筛选 tabs筛选待回款/回款异常/已回款/全部 四 tab,默认"待回款",点击重置第 1 页filter→SQL 条件:pending=order_status IN('Shipped','Pending') AND NOT has_finance;abnormal=is_abnormal;settled=has_finance;all=无条件e2e 逐 tab 断言 total 与行集符合条件生效
AC-EL-STL-009搜索框+搜索按钮筛选placeholder"搜索订单号 / SKU",submit 后 setQuery 并回第 1 页amazon_order_id ILIKE %kw% OR sku_list ILIKE %kw%(大小写不敏感);空串=不过滤搜已知单号/SKU 断言命中;搜不存在串断言空态生效
AC-EL-STL-010数据接口接口GET /api/settlement?filter&search&brand&page&page_size前端 pageSize=20;服务端 page=max(1,page)、page_size=min(100,max(1,page_size));响应含 total/page/summary/items接口直调断言分页边界(page=0→1;page_size=999→100)生效
AC-EL-STL-011表格列-订单号表格列等宽 sku 样式展示amazon_order_id,等宽 span.sku 纯文本,无行链接(本页未传 onRowClick,page.tsx:33)抽行比对源表订单号生效
AC-EL-STL-012表格列-品牌表格列品牌色点(branddot + brandColor)+ 品牌名brand;色点颜色由品牌映射函数决定,跨页一致同一品牌在首页/结算页断言同色生效
AC-EL-STL-013表格列-国家表格列国家码文本country 直显抽行比对生效
AC-EL-STL-014表格列-发货日期表格列日期文本shipped_date 为空回退 purchase_date(源无发货列品牌按订单时间推导,同脚注口径)造无发货日期行断言显下单日期生效
AC-EL-STL-015表格列-营收表格列本土币存在→本土币主显+USD 副行小字;否则仅 USDlocal_amount+currency 双字段存在时主显(2026-09-18 本土货币注释);2026-10-01 ⑥:未回款行(has_finance=false)revenue=0 系 local_amount=0 折算占位→接口置 null→前端显"—";settled 区 $0.00 为真值保留造 revenue=0 未回款行断言显"—";settled 区 $0.00 断言保留生效
AC-EL-STL-016表格列-净额 USD表格列muted 色净额net_usd;未回款行 net=0 同为同步占位(fg 2952/zf 1126 单全 0、onno 同位 NULL 实证)→null→"—";已回款区真值照显同 015 断言规则生效
AC-EL-STL-017表格列-回款状态表格列/badgebadge 四态:异常 bad"异常"/已回款 ok/待回款 warn/其他 dim;CSV 导出同款文案coalesce(settlement_status,'') 驱动;异常叠加 is_abnormal 优先;"待回款"=Shipped/Pending 且 NOT has_finance构造四态行断言样式;导出 CSV 断言文案一致生效
AC-EL-STL-018表格列-等待天数表格列天数数字;>14 时 danger 色+700 加粗days_waiting;14 天分界与 KPI 健康线/异常口径同源断言 14 天正常色、15 天红色加粗生效
AC-EL-STL-019表格列-SKU表格列多 SKU 逗号串,ellipsis 截断 maxWidth 220pxsku_list 原串;超宽 CSS 截断不换行长 SKU 串断言截断显示生效
AC-EL-STL-020加载态/导出按钮状态/按钮加载中骨架;exportCsv("settlement") 导出 CSVCSV 列=表列同序同文案(含状态列文案与页面一致)断言 CSV 首行表头与页面列名一致生效
AC-EL-STL-021空态空态"无匹配记录"total=0(含筛选/搜索无命中)时整表替换无命中搜索断言空态文案生效
AC-EL-STL-022分页器分页page/pages/total 展示与切页服务端 LIMIT/OFFSET 分页;切页保持当前 filter/search/brand末页/越界页断言行为正确生效
AC-EL-STL-023表上口径说明条口径caliber 常量文案:"结算明细表口径:金额=USD|数据源=结算明细(settlement 应计金额,非计数)|已结算 Settlement=已回款订单营收(settled_orders 计数口径不同)|回款状态=已回款/已退款+已回款。"UI 文案即验收标准(AC-UI-01),逐字受保护;计数/金额双口径区分声明页面文案与库内记录逐字 diff生效
AC-EL-STL-024底部口径脚注口径"Shipped/Pending 且无结算回款 = 待回款;已发货且超 14 天未回款 = 异常(各品牌一律要求未回款)。等待天数随每日同步实时重算(起点按品牌配置;源无发货列的品牌按订单时间推导)。回款状态来自财务明细视图,或按订单金额是否入账推导(入账=已回款)。"前两句已由 /api/settlement SQL 证实;"起点按品牌配置/订单时间推导"与"财务明细视图/入账推导"逻辑在同步层生成 days_waiting/has_finance/is_abnormal,本页源码未含其实现。

2026-10-22 换绿:同步层实证(只读 fork 逐行):起点推导=api/sync_source.py:283-289——zf=last_update_date(OrderLastUpdatedAt≈发货时点)、fg=coalesce(shipped_date,order_date)、onno=purchase_date,口径由 source_map 注册表显式键注入(:288-289);has_finance:zf 取 v_order_master(:306)、fg 取 v_fittingirls_order_finance_detail settlement_status=已回款(:333)、onno=LATERAAL settled(:374-376)=Shipped 且有金额(语义微差注记:是「有金额」非「有入账记录」);is_abnormal=Shipped AND 未回款 AND 等待>14 天(master:309/fg:341/onno:364);落表 _ORDERS_COLS(:1405-1414) 写租户 orders 表即本页数据源
待核:读同步层 days_waiting 起点品牌配置项与 has_finance 入账推导实现,证实脚注三句与代码一致后转 p-ok生效

§11.11 API 接入(/settings · AC-EL-SET,源码 web/app/settings/page.tsx 237 行 + settings/ApiFieldsTab.tsx 91 行 + api/routers/settings.py·ai.py·collab.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SET-001页面框架·标题与面包屑布局AppShell title=「API 接入」,crumb=「平台 API 与服务商凭据 · 加密存储 · 仅管理员 · 全程审计」web/app/settings/page.tsx:100;页头注释 2026-09-16 立项:租户自助管理平台 API(SP-API/Ads/Noon) 与服务商(货代等)凭据e2e 断言标题与 crumb 文本;组件本体见 AC-EL-CMP(AppShell)生效
AC-EL-SET-002顶部 Tab 组(4 个)导航🔌 平台 API / 🚚 服务商(货代等)/ 📖 API 字段 / 🤖 大模型;默认 platform;切 tab 时 setEditing(null) 关闭编辑卡page.tsx:101-106;tab 状态 ∈ {platform, logistics, fields, llm}e2e 逐个点选断言 on 类切换与内容区联动生效
AC-EL-SET-003Tab·🔌 平台 API筛选只显示 category=platform 的接入类型与凭据page.tsx:64-65 过滤式 p.category === tab;provider 目录来自 GET /api/settings/providers(settings.py:109, 仅 owner/admin)e2e 切到本 tab,列表不应出现货代/other 类条目生效
AC-EL-SET-004Tab·🚚 服务商(货代等)筛选显示 category=logistics 与 category=other 两类(货代/物流/其他第三方服务接口凭据)page.tsx:64-65 tab === "logistics" && p.category === "other" 一并纳入e2e 断言 other 类凭据在本 tab 可见、platform tab 不可见生效
AC-EL-SET-005Tab·📖 API 字段挂载本 tab 渲染 ApiFieldsTab 组件(全库数据字典),详见 AC-EL-SET-036…043page.tsx:108 {tab === "fields" && <ApiFieldsTab />};组件本体 web/app/settings/ApiFieldsTab.tsxe2e 切 tab 断言「API 字段参考」标题出现生效
AC-EL-SET-006Tab·🤖 大模型挂载本 tab 渲染大模型供应商卡(#83),进入即拉取 GET /api/ops/llm/providers(ai.py:924)page.tsx:37 useEffect(tab==="llm" → loadLlm);权限门在后端(仅平台主租户 owner/admin),前端 tab 按钮对所有登录者可见e2e 切 tab 断言卡标题;非主租户账号断言出现无权限提示(SET-028)生效
AC-EL-SET-007凭据区·头部卡容器「平台凭据/服务商凭据 N 条」计数 + 按 tab 切换的说明文字 + 右侧「+ 新增接入」按钮;仅 platform/logistics 两 tab 且非编辑态渲染page.tsx:178-189;platform 说明=「SP-API 凭据支持一键 LWA 连通验证(真换 access token)」,logistics 说明=「货代/物流/其他第三方服务的接口凭据, 供运费/轨迹/对账集成」;N=catItems.length(当前 tab 过滤后条数)e2e 断言计数与列表行数一致;点新增进入编辑卡生效
AC-EL-SET-008凭据列表·表头表格7 列:名称/类型/掩码/状态/验证时间/更新/操作page.tsx:194;数据源 GET /api/settings/credentials(settings.py:117, 仅 owner/admin, 返回掩码 preview 不回明文)e2e 断言 7 个 th 文本生效
AC-EL-SET-009凭据列表·名称列列用户自起凭据名,strong 样式page.tsx:198;创建时必填且 trim 非空(page.tsx:69「类型与名称必填」),maxLength=80(SET-022)e2e 断言与新增时输入名一致生效
AC-EL-SET-010凭据列表·类型列列接入类型的展示名(provider label),目录中查不到时回退裸 keypage.tsx:199 providers.find(...)?.label || c.providere2e 断言与新增时选的类型 label 一致生效
AC-EL-SET-011凭据列表·掩码列列后端生成的掩码串,空值显「—」;任何接口不回明文page.tsx:200 c.preview || "—";掩码由 settings.py _mask(cfg) 生成;本库条目禁止出现任何真实凭据值或样例值e2e 断言掩码格式且与明文无子串重叠;抓包断言响应无明文字段生效
AC-EL-SET-012凭据列表·状态列列badge 四态:draft=草稿(warn)/verified=已验证(ok)/failed=验证失败(bad)/disabled=已停用(dim),未知值回退显原始 status;下方 t2 行显 status_msg 前 60 字符page.tsx:20-23 STATUS map + 201-202 slice(0,60);status/status_msg 来自列表接口与 verify 结果e2e 断言四态 badge 类名与文案;构造超 60 字 status_msg 断言截断生效
AC-EL-SET-013凭据列表·验证时间列列last_verified_at 截断到分钟(yyyy-MM-dd HH:mm),未验证显「—」page.tsx:203 slice(0,16).replace("T"," ")e2e LWA 验证成功后断言本列从「—」变为时间生效
AC-EL-SET-014凭据列表·更新列列updated_at 截断到分钟,恒有值page.tsx:204 同上截断式e2e 重录保存后断言时间刷新生效
AC-EL-SET-015操作列·🔍 验证按钮操作仅当该凭据所属 provider 规格 verify==="lwa" 时渲染(SP-API 类);点击 POST /api/settings/credentials/{id}/verify(settings.py:202),toast「✅/❌ + msg」,完成后刷新列表page.tsx:206-208, 84-91;后端 settings.py:215 同判 verify == "lwa" 才走真换 access token 的 LWA 连通验证e2e 断言非 LWA 类型无此按钮;LWA 类型点击后状态列变化与 toast 文案生效
AC-EL-SET-016操作列·✎ 重录按钮操作进入编辑卡,config 清空待整包重录(掩码即旧值,接口不回明文)page.tsx:210-213 setForm({provider, name, config:{}})e2e 点重录断言编辑卡打开且字段输入框为空生效
AC-EL-SET-017操作列·删除按钮操作danger 确认框「删除凭据?/关联的采集/推送将失效, 不可恢复。」(「采集/推送」为全角斜杠原文,page.tsx:94)确认后 DELETE /api/settings/credentials/{id}(settings.py:187),toast 已删除并刷新page.tsx:93-97, 215;删除走原生 fetch DELETE(postJson 无 DELETE 封装)e2e 删除测试凭据断言行消失与审计落账生效
AC-EL-SET-018凭据列表·空态行空态colSpan=7 居中行「还没有接入 — 点右上「新增接入」录入你的平台 API 或服务商凭据」page.tsx:219-223 catItems.length === 0e2e 空租户断言文案;新增后消失生效
AC-EL-SET-019凭据列表·安全脚注说明「安全:AES 加密存储 · 明文提交后即丢弃, 任何接口不回明文 · 变更全程只追加审计 · 仅 owner/admin 可见可操作。阶段边界:凭据自动接入采集管线为下一期(当前为管理与验证闭环)。」page.tsx:227-230;与页头注释(2026-09-16)阶段边界一致;审计走 settings.py _event() 只追加e2e 断言脚注全文;audit 表断言增删改各留一条且无 UPDATE 痕迹(只追加)生效
AC-EL-SET-020编辑卡·标题容器新增态「新增接入」,编辑态「编辑 #{id}」;副标显当前接入类型 label + hint(有则拼「 · 」)page.tsx:146-149 editing === "new" ? "新增接入" : \`编辑 #${editing}\`;curSpec 来自 providers 目录e2e 两种进入路径断言标题与副标生效
AC-EL-SET-021编辑卡·接入类型下拉输入选项=当前 tab 过滤后的 catProviders;编辑态 disabled(类型不可改);新增态切换类型时 config 清空重填page.tsx:151-155 disabled={editing !== "new"} + onChange 重置 confige2e 编辑态断言 select 不可交互;新增态切换断言已填字段清空生效
AC-EL-SET-022编辑卡·名称输入输入label 文本「名称(便于识别, 如 "US 主账号")」(input 无 placeholder 属性,page.tsx:157-158),maxLength=80,必填(trim 空则保存被拦)page.tsx:157-158 + 69 前置校验 toast「类型与名称必填」e2e 空名保存断言拦截 toast;81 字符断言截到 80生效
AC-EL-SET-023编辑卡·动态字段组输入按 provider 规格 fields 动态渲染:secret 字段 type=password,全部 autoComplete="new-password";optional 字段 label 后缀「(选填)」page.tsx:160-166;字段清单由 GET /api/settings/providers 下发(Field={key,label,secret?,optional?}),前端不硬编码e2e 断言 secret 字段 input.type=password 与 autocomplete 属性;选填后缀生效
AC-EL-SET-024编辑卡·💾 保存按钮操作新增 POST /api/settings/credentials、编辑 PUT /api/settings/credentials/{id};toast「已保存(加密存储)」/「已更新(整包替换)」;成功后关卡、表单重置、列表刷新;busy 期间 disabledpage.tsx:68-82;整包重录=PUT 携带全量 config(旧密文不参与合并)e2e 新增+重录各走一遍断言 toast 与列表行变化生效
AC-EL-SET-025编辑卡·取消按钮操作关闭编辑卡并把表单重置为当前 tab 首个 provider + 空名称/空 configpage.tsx:170e2e 填一半点取消,再点新增断言表单为干净态生效
AC-EL-SET-026编辑卡·明文丢弃提示说明保存/取消按钮旁灰字「提交后明文即刻丢弃(AES 加密落库, 列表只显掩码; 编辑需整包重录)」page.tsx:171-173;对应后端 _enc AES 加密落库、列表接口只回 _mask 结果e2e 断言文案存在;保存后再次编辑断言输入框为空(非回显明文)生效
AC-EL-SET-027LLM 卡·标题容器「大模型供应商」副标「平台级 AI 出口 · 仅平台主租户 owner/admin · 切换前自动连通自检(失败即回滚)」;出处 #83(2026-09-27)「大模型供应商自由切换 — 平台主租户(zipforce) owner/admin 专属卡」page.tsx:16 注释 + 112;权限强制层在后端 GET /api/ops/llm/providers(ai.py:924)e2e 主租户 admin 断言卡渲染;普通租户断言 SET-028 提示生效
AC-EL-SET-028LLM 卡·无权限态空态llmErr 时灰字「无权限或加载失败:{err}(仅平台主租户管理员可管理)」page.tsx:113;请求 403/失败均落此态,不弹全局错误e2e 普通租户 owner 打开 🤖 tab 断言本文案生效
AC-EL-SET-029LLM 表·表头表格6 列:供应商/模型/协议/端点/Key/操作(无验证时间等列,区别于凭据表)page.tsx:117;行数据=LlmState.providers(LlmP={id,label,model,format,endpoint,key_ok})e2e 断言 6 个 th生效
AC-EL-SET-030LLM 表·供应商列列label + badge:id===active 显「当前」(ok)、id===default 显「默认」(dim),二者互斥优先当前page.tsx:121-123 三元链 active > default > 无e2e 断言当前行恰一枚「当前」badge;默认行(非当前)显「默认」生效
AC-EL-SET-031LLM 表·模型/协议/端点列列model(sku 样式)/format/endpoint 三列纯展示page.tsx:124-126e2e 断言与 providers 接口返回一致生效
AC-EL-SET-032LLM 表·Key 列列badge:key_ok=true「就绪」(ok)/false「缺失」(bad);不显示任何 Key 内容page.tsx:127;key_ok 由后端判定(配置存在性),Key 值不出后端e2e 断言 badge 二态;页面源码/网络面板无 Key 值生效
AC-EL-SET-033LLM 表·切换按钮操作三态文案:busy=「探针中…」/当前行=「当前使用」/其余=「⇄ 切换到此」;disabled 条件 llmBusy || id===active || !key_okpage.tsx:129-132e2e 断言当前行与缺 Key 行均 disabled生效
AC-EL-SET-034LLM·切换流程操作确认框「切换大模型供应商?」正文含「切换到「{pid}」前会先实测一发连通探针, 失败自动回滚保持当前供应商。全平台 AI 立即走新供应商。」确认后 POST /api/ops/llm/switch(ai.py:938) {provider};changed=true toast「已切换 → {active}(探针回声: {probe_answer})」,false toast「已是当前供应商 {active}」page.tsx:39-48;探针+失败自动回滚在后端 switch 内实现,前端只呈现结果e2e 切换到另一供应商断言 badge 迁移与 toast;再切回断言幂等文案生效
AC-EL-SET-035LLM 卡·脚注说明「切换即时生效(下一次 AI 调用即走新供应商, 无需重启); 探针失败自动回滚保持原供应商; 全程审计。」page.tsx:140-142e2e 断言文案;切换后立即问一句 AI 断言走新供应商(audit 记录)生效
AC-EL-SET-036API 字段 Tab·标题容器「API 字段参考」副标「全库数据字典 · {total} 张表/视图 · 点击行展开列定义」;total 千分位ApiFieldsTab.tsx:28;total 来自 GET /api/mapping/api-fields(collab.py:105) 响应e2e 断言标题与 total 数与本节脚注(SET-043)快照数一致生效
AC-EL-SET-037API 字段 Tab·分组 Tab 组筛选「全部({N} 组)」+ 各分组按钮「{group} · {sub}({tables})」(sub===group 时只显 group);点分组即带 group&sub 重查,点全部清空两筛选ApiFieldsTab.tsx:30-38;groups 元数据(group/sub/tables/rows)由接口下发;点选后 setAf(null) 显加载态e2e 点任一分组断言表清单只剩该组;点全部恢复生效
AC-EL-SET-038API 字段 Tab·搜索表单筛选输入框 placeholder「表名 / 列名 / 描述」+「搜索」按钮;submit 才触发查询(输入过程不实时搜)ApiFieldsTab.tsx:39-44 onSubmit → setAfQuery(afSearch),afQuery 入参 search=e2e 输入已知列名提交,断言结果含该列所在表生效
AC-EL-SET-039API 字段 Tab·表头表格6 列:表 / 视图、schema、分组、列数(右对齐)、行数(右对齐千分位)、说明ApiFieldsTab.tsx:50;列数=columns.length,行数=接口 rows 字段e2e 断言 th 与数值格式生效
AC-EL-SET-040API 字段 Tab·表行与展开表格行尾 ▸/▾ 指示;点击行 toggle 展开(expanded===id),展开行背景 #f8f8ff;说明列超长省略号;schema 空显「—」ApiFieldsTab.tsx:53-62 expanded === t.id ? " ▾" : " ▸";单展开(再点同行收起,点他行切换)e2e 点行断言列定义区出现、再点收起、点第二行断言首行收起生效
AC-EL-SET-041API 字段 Tab·列定义展开区表格colSpan=6 子行,grid 卡片式列出每列「列名[红*] …… 类型」;红 *= !nullable(非空/主键列)ApiFieldsTab.tsx:63-76;columns={name,type,nullable} 由接口下发e2e 展开一张已知非空列的表断言红 * 出现生效
AC-EL-SET-042API 字段 Tab·空态行空态搜索/筛选无结果时 colSpan=6「无匹配」ApiFieldsTab.tsx:79e2e 搜乱码串断言文案生效
AC-EL-SET-043API 字段 Tab·脚注说明「数据源:数据字典快照(2026-09-06,Amazon/Noon/视图/共享库/选品库 8 组 181 张)。红色 * 为主键/非空列;本平台日更采集已覆盖其中 17 张核心表(见 数据管道)。」ApiFieldsTab.tsx:84-87;快照口径为静态文案,181 张为 2026-09-06 时点数(total 为接口实时数,二者允许不一致=快照定义)e2e 断言脚注全文含 2026-09-06/8 组 181 张/17 张生效

§11.12 账单页(/billing · AC-EL-BIL,24 条 · 2026-10-22 源码实证 web/app/billing/page.tsx 205 行 + api/routers/billing.py,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BIL-001Suspense 兜底状态加载中占位useSearchParams 需 Suspense 边界,加载期整页兜底e2e 慢网断言加载文案出现后消失生效
AC-EL-BIL-002页面标题/面包屑导航AppShell title=计费,面包屑"套餐与订阅 · Stripe Checkout"路由 /billing;登录即可见(无模块门)e2e 断言标题与面包屑生效
AC-EL-BIL-003支付成功卡反馈?upgraded={plan} 回跳后 ok 边框卡"已订阅X,配额即时生效"checkout success_url=/billing?upgraded={plan};webhook checkout.completed 置 UPDATE tenants SET plan 后回跳才见带 query 直访断言卡片出现且套餐名正确生效
AC-EL-BIL-004错误横幅反馈接口失败红条仅 plans 失败 setErr(page.tsx:37);status 与 modules 失败静默吞掉 catch(()=>{})(page.tsx:33/38)不显红条mock plans 500 断言出现;mock modules 500 断言不出红条生效
AC-EL-BIL-005KPI 当前套餐KPI 卡套餐名;foot"支付通道已配置/支付通道未配置(演示模式)"GET /api/billing/status:plan=tenants.plan;stripe_configured=bool(STRIPE_KEY),两值同响应接口比对;未配 key 环境断言演示模式文案生效
AC-EL-BIL-006KPI AI 助手额度KPI 卡ai_ask 次/租户/天按当前 plan 取 PLAN_AI_QUOTA(core.py 单一事实源,与执行层限额共用同常量)断言显示值与 AI 问答实际拦截限额同源同值生效
AC-EL-BIL-007KPI 选品搜索/关注池KPI 卡keepa_search 次/天 · keepa_watch 个上限PLAN_KEEPA_QUOTA / KEEPA_WATCH_LIMIT(core.py 单源)断言与选品页实际限额一致生效
AC-EL-BIL-008未配置提示卡提示"联系平台管理员开通,无需您做任何配置"!stripe_configured 时展示演示模式断言出现生效
AC-EL-BIL-009模块超市卡标题卡片h2"模块超市"+ sub"八大模块按需采购 · 演示模式(免费开通/关闭,Stripe 接入后转正式计费)/正式计费"demo_mode 时演示分支文案,否则"正式计费"两种模式各断言 sub 文案生效
AC-EL-BIL-010info 说明横幅提示卡内 ok 色 info 横幅(ok-banner role=status,page.tsx:113)非静态:模块开关操作成功的结果反馈(setInfo 由 toggleMod 置值,初始为空不占位)切换模块断言横幅出现且文案含模块名生效
AC-EL-BIL-011模块卡网格布局grid minmax(215px,1fr),每模块一卡,卡头=模块名模块清单来自 MODULES(core.py),与导航/接口同源断言卡片数=MODULES 条数且名称一致生效
AC-EL-BIL-012模块状态 badgebadge已开通(ok)/未开通(dim)GET /api/billing/modules 返回租户开通态接口比对逐模块生效
AC-EL-BIL-013模块覆盖页面文本该模块覆盖页面列表 join(" · ")MODULES 定义内 pages 字段与 core.py MODULES 逐字比对生效
AC-EL-BIL-014模块开关按钮按钮demo_mode:开通/关闭(busy"处理中…";成功仅 info 横幅"X 已开通/关闭(导航与接口即时生效)",本页无 toast);非 demo:联系开通 disabledPOST /api/billing/modules/toggle body {module,enabled};demo 模式免 Stripe 即时生效e2e 切换后断言 badge 翻转、导航菜单与模块接口同步变化生效
AC-EL-BIL-015模块高亮定位反馈?mod={key} query→目标模块卡 brand 色边框+高亮(params.get("mod"),page.tsx:24)参数名为 mod;全仓 grep 未发现仓库内调用方,保留为外部直链入口带 mod=query 断言仅目标卡高亮生效
AC-EL-BIL-016套餐卡网格布局grid minmax(240px,1fr),四卡=Trial/Starter/Growth/EnterpriseGET /api/billing/plans 返回 BILLING_PLANS(billing.py 常量)+stripe_configured接口断言四档齐全生效
AC-EL-BIL-017当前套餐 badgebadge当前套餐卡显"当前"(ok)status.plan==plan.key 判定切换套餐后断言 badge 跟随生效
AC-EL-BIL-018套餐价格文本"$price/月"BILLING_PLANS:trial 0/starter 49/growth 199/enterprise 499与常量逐字比对生效
AC-EL-BIL-019套餐权益列表文本features 逐条 ulBILLING_PLANS.features 数组原文(含各档 AI/搜索/关注池次数文案)与常量逐字比对;文案内次数须与 022 表数字一致生效
AC-EL-BIL-020套餐按钮三态按钮trial→"默认套餐"disabled;当前→"使用中"disabled;其他→"升级到X"(disabled=!stripe_configured||busy;busy"跳转中…")三态状态机由 status.plan 与 busy 派生e2e 断言三态渲染与禁用条件生效
AC-EL-BIL-021升级跳转动作接口点击升级→POST /api/billing/checkout {plan}→取 url 整页跳转 Stripe;失败显 detail定价=STRIPE_PRICE_{PLAN} env;client_reference_id=tenant.slug、metadata[plan];审计 billing.checkout 留痕;plan 白名单 starter/growth/enterprise未配通道断言按钮禁用;已配环境断言跳转 url 为 stripe.com 域生效
AC-EL-BIL-022配额对比表表格列:套餐/价格$/AI 天/选品搜索天/关注池上限;当前行底色 #f8f8ff+"(当前)"数字同 PLAN_AI_QUOTA/PLAN_KEEPA_QUOTA/KEEPA_WATCH_LIMIT 单源(与 006/007/018 一致)断言表内 4×3 配额数字与 KPI 卡、features 文案三处同值生效
AC-EL-BIL-023底部脚注口径"订阅由 Stripe Checkout 托管,本平台不接触卡号;回调经 HMAC 验签后即时变更套餐与配额。降级 / 退订在 Stripe 客户门户操作,webhook 同步生效。"HMAC 已证:hmac.compare_digest(sig, hmac.new(STRIPE_WHSEC,...))(billing.py:131-132);降级/退订=客户门户操作,subscription 结束事件置 plan 回退 trial,billing_events 留痕文案逐字比对;webhook 无效签名请求断言 400 拒绝生效
AC-EL-BIL-024页面 loading状态"加载中…"plans/status 未回时整页占位慢网断言出现后消失生效

§11.13 回填页(/backfill · AC-EL-BKF,33 条 · 2026-10-22 源码实证 web/app/backfill/page.tsx 238 行 + api/routers/backfill.py,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BKF-001页面标题/面包屑导航AppShell title=回溯任务,面包屑"三类回溯 · dry-run 预演 · 快照可回滚 · 死信队列 · 仅管理员"路由 /backfill;GET 类接口仅 current_user 鉴权;POST 类(runs/cancel)有 _require_admin 强制(见 013/026)e2e 断言标题与面包屑生效
AC-EL-BKF-002错误横幅反馈limits/runs 拉取失败红条 role="alert"Promise.all 任一失败 setErr;DLQ 拉取失败静默不报错mock 500 断言出现生效
AC-EL-BKF-003发起回溯卡标题卡片h2"发起回溯"+ sub"高危财务操作 · 全程审计留痕 · P2 低优队列(不挤占日常采集)"文案即风险声明;P2 低优=worker 队列优先级文案逐字比对生效
AC-EL-BKF-004平台下拉表单Amazon/Noon 二选,切换联动品牌与任务类型可选集limits 按平台过滤;brands=该平台去重品牌切平台断言品牌列表与上限 badge 重算生效
AC-EL-BKF-005品牌/店铺下拉表单该平台品牌列表;空显"—";默认取首个GET /api/backfill/limits:brands_source 启用品牌聚合(bool_or(enabled)),max(platform)接口比对品牌集生效
AC-EL-BKF-006任务类型下拉表单广告归因回溯/订单/退款补采/本地指标重算;选项取该品牌平台注册的 types(无则回退全量 TASK_META)TASK_TYPES=(backfill_ad, backfill_order_refund, recalc_order_metric) 白名单;每品牌平台 types 来自注册表合并不同品牌断言选项集差异;非法 task_type 提交断言 422生效
AC-EL-BKF-007时间口径下拉表单订单创建时间(order_created)/退款发生时间(refund_posted)time_basis 原样入 backfill_runs 并透传 worker 分片依据断言记录回显口径列正确生效
AC-EL-BKF-008起日期表单date 输入,max=今天;默认 30 天前todayStr(-30);spanDays=今天−起(自然日)断言默认值与 max 属性生效
AC-EL-BKF-009止日期表单date 输入,max=昨天;默认昨天todayStr(-1)——不允许选当日(回填不含今天)断言 max=昨天生效
AC-EL-BKF-010dry-run 复选框表单默认勾选;文案"只出差异报表,不写业务库"dry_run=true 入库;按钮文案/进度列/删除权限均随 dry_run 变化勾选提交断言 toast"(dry-run 预览)"生效
AC-EL-BKF-011规则版本 badgebadge"规则版本 {NEXT_PUBLIC_BACKFILL_RULE ?? 2026-10-v1}"构建时环境变量注入,未设回退"2026-10-v1";版本随回溯规则修订升级断言当前构建显示值与发布配置一致生效
AC-EL-BKF-012平台上限 badgebadgemaxDays 存在时显"平台上限 N 天 · 本次回看 M 天";超窗变 bad 追加"· 超窗将被拒绝"上限=注册表 brands_source.source_map.backfill(*_max_days 键)合并代码 DEFAULT_LIMITS(Amazon:广告 60/订单退款 731/重算 731;Noon:订单退款 180/重算 180);服务端超窗 400 拒绝不入队(前端预判+后端强制双层)超窗提交断言前端禁用+直接调接口断言 400;边界值 N 天断言放行生效
AC-EL-BKF-013提交按钮按钮disabled=busy||无品牌||超窗||止<起;文案 dry-run"预演出报表"/正式"正式执行(快照可回滚)";busy"提交中…"POST /api/backfill/runs(_require_admin,backfill.py:93):校验租户品牌归属→INSERT backfill_runs→审计 backfill.create→arq 入队(_job_id=backfill:{id});成功 toast"任务 #N 已入队"e2e dry-run 全流程:提交→toast→记录出现;非本租户品牌断言拒绝生效
AC-EL-BKF-014发起卡脚注口径"平台最大回溯窗口注册表驱动(brands_source.source_map.backfill):Amazon 广告 60 天 / 订单退款 731 天,Noon 订单退款 180 天。单租户同类任务同时仅 1 个在跑(排队自动延迟);补采走既有幂等 UPSERT 主干,报文另存 JSONB 快照表供溯源/断点续传。"窗口数字已证(DEFAULT_LIMITS+注册表合并);"同类仅 1 个在跑/幂等 UPSERT 主干/JSONB 快照表"在 worker 执行层,本页与 router 创建段未含其实现。

2026-10-22 换绿:worker 执行层实证(只读 fork 逐行):同类仅 1 在跑=Redis 租户信号量 api/tasks.py:50-68 tenant_sem(limit=1, ttl=86400, INCR 超限 DECR 拒绝、崩溃次日 TTL 自愈),调用点 backfill.py:216/:336/:586 三类均 limit=1,:5 docstring 单租户同类并发=1;幂等主干=窗口回写先按 brand+窗口 DELETE 再逐行 INSERT…ON CONFLICT DO NOTHING(:746-757)、快照分片已存跳过(:153-160)、:3/:10 常规链路 UPSERT 主干零改动;JSONB 快照表=public.backfill_snapshots(:158-160 写 run_id/tenant_id/table_name/kind/range_key/payload,溯源/回滚用不进业务读路径)
待核:读 worker 回溯执行体,证实同类互斥排队、UPSERT 幂等与快照表写入三句后转 p-ok生效
AC-EL-BKF-015任务记录卡标题卡片h2"任务记录"+ sub"{N} 条 · 进度/差异报表实时"GET /api/backfill/runs limit=50(服务端 min(limit,200)),created_at 倒序接口比对条数与排序生效
AC-EL-BKF-016列-序号表格列"#id"加粗backfill_runs.id 自增主键抽行比对生效
AC-EL-BKF-017列-品牌/平台表格列品牌名 + muted 小字"· 平台"brand/platform 入库原值抽行比对生效
AC-EL-BKF-018列-任务表格列TASK_META 中文名;dry_run 行追加"dry"badge未知 task_type 回退显示原始键断言三种类型名与 dry badge生效
AC-EL-BKF-019列-区间表格列"date_from~date_to"等宽 12px入库区间原值抽行比对生效
AC-EL-BKF-020列-口径表格列refund_posted→"退款",其他→"下单"time_basis 二值映射断言两口径回显生效
AC-EL-BKF-021列-状态 badge表格列/badgedone=ok/running=warn/queued=dim/error=bad/cancelled=bad;未知回退 dimSTATUS_TONE 前端映射;状态由 worker 经 backfill_runs.status 更新造各状态记录断言五态样式生效
AC-EL-BKF-022列-进度表格列"N 片"(chunks);无 chunks 时 dry_run→"预演"/"—";追加"· N 行"(rows)与"· 快照N"(snapshot_rows)progress JSONB(chunks/rows/dry_run)由 worker 实时更新;snapshot_rows=快照表行数跑一次 dry-run 断言进度字段渲染生效
AC-EL-BKF-023列-操作人表格列操作人邮箱,空显"—"创建时 users.email(_op_email)写入 operator_email断言当前账号提交后回显其邮箱生效
AC-EL-BKF-024列-时间表格列created_at"T"换空格截 16 位(分钟)UTC 入库时间抽行比对格式生效
AC-EL-BKF-025差异报表按钮按钮/弹层diff_report!=null 才显示;点击展开/收起,JSON 缩进 2 空格 pre(pre-wrap、break-all、maxHeight 320 滚动)diff_report JSONB 由 dry-run/正式执行产出dry-run 完成断言按钮出现、JSON 可读展开收起生效
AC-EL-BKF-026取消按钮按钮仅 queued/running 行显示"取消"POST /api/backfill/runs/{id}/cancel(_require_admin,backfill.py:146)→UPDATE status='cancelled'+审计 backfill.cancel;后端另有 DELETE /api/backfill/runs/{id}(仅 dry_run 记录可删,未在本页暴露 UI)e2e 取消排队任务断言状态翻转为 cancelled生效
AC-EL-BKF-027错误详情反馈status=error 且 error 非空→行内 danger 色文本截前 220 字backfill_runs.error 全量入库,展示截断造失败任务断言前 220 字显示生效
AC-EL-BKF-028记录空态空态"暂无回溯任务"(colSpan=10 跨全列)runs=[] 时渲染新租户断言空态生效
AC-EL-BKF-029死信队列卡标题卡片h2"死信队列"+ sub"arq:dlq · 重试耗尽的任务 · 重投原样参数"GET /api/ops/dlq(Redis arq:dlq,lrange(0,99) 上限 100 条,backfill.py:198);接口失败静默置 null 不阻塞页面断言正常加载;接口挂断时页面其余功能不受影响生效
AC-EL-BKF-030死信空态空态"队列为空,无死信。"dlq 为 null 或 count=0空队列断言文案生效
AC-EL-BKF-031死信表格列表格列列:#index/任务(function+args JSON 截 60 字)/job_id 等宽/错误(error_code+message,danger 色)/时间(ts 截 19 秒)arq DLQ 条目结构 {index,ts,job_id,function,args,error_code,message};缺省字段显"—"造死信断言各列渲染与截断生效
AC-EL-BKF-032死信重投按钮按钮"重投"→toast"死信已重投队列"POST /api/ops/dlq/retry {index}:原样参数重新入队e2e 重投断言条目离开 DLQ 且任务重新出现生效
AC-EL-BKF-033死信丢弃按钮按钮"丢弃"→toast"死信已丢弃"POST /api/ops/dlq/drop {index}:从 DLQ 移除(不可恢复)e2e 丢弃断言条目消失生效

§11.14 数据浏览(/database · AC-EL-DB,源码 web/app/database/page.tsx 183 行 + api/routers/collab.py 355-483)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DB-001页框架·AppShell框架title=数据浏览,crumb=「表结构 · 数据浏览(只读)」AppShell 共享组件(§11 组件批);本页无独立工具栏,品牌过滤经顶栏 BrandContext 注入(AC-EL-DB-031)e2e 路由可达 + 标题/crumb 逐字生效
AC-EL-DB-002错误横幅反馈err 非空时 div.error role=alert 渲染三个数据端点(tables/table/rows)任一 catch 均写 err=String(e.message);marginBottom 16断端点/403 场景横幅出现生效
AC-EL-DB-003布局容器 .db-layout布局左表清单 + 右结构/数据双栏2026-10-01 像素审计 P3 缺陷㊱修复:原 inline width:280+flexShrink:0 在 390px 视口把右栏压到 94px 且横向溢出 2px(截图 392px 实证)→ 布局参数移入 CSS 类 + 移动端断点改上下堆叠390px 视口无横向滚动条(截图比对)生效
AC-EL-DB-004左栏·表清单卡容器card db-tree,全部可浏览表的入口内容=/api/db/tables items;敏感表/备份表在后端被拦(AC-EL-DB-026),清单内不可见端点 JSON 行数 vs 清单行数一致生效
AC-EL-DB-005搜索表名输入框筛选placeholder「搜索表名…」,即时前端过滤filter 非空时 tables.filter(t.table.includes(filter)) 子串匹配,不发请求;不 trim、大小写敏感(原样 includes)输入子串清单实时收缩生效
AC-EL-DB-006表清单行列表行每行=表名+右侧元信息,点击选中该表选中态:背景 var(--brand-weak,#e0f2e9)+fontWeight 700;行 padding 6px 10px fontSize 13,space-betweene2e 点选后右侧加载结构卡生效
AC-EL-DB-007🏷 品牌列徽标徽标has_brand 表名前显 🏷,title=「有品牌列」has_brand=后端查 information_schema.columns 存在 brand 列的表集合有 brand 列的行悬停提示存在生效
AC-EL-DB-008行数估算数值清单行右侧 int(rows_est)pg_class.reltuples 估算(后端 max(0,reltuples)),非精确 count——避免逐表全表 count;空态 legend 明示「行数为估算值」(AC-EL-DB-011)与 pg_class 直查值一致生效
AC-EL-DB-009无匹配表空态空态filtered.length=0 时 p.muted「无匹配表」仅前端过滤结果为空触发输入不存在子串显示该行生效
AC-EL-DB-010右栏·未选空态卡空态sel 为空时居中卡「选择表名查看结构和数据」padding 40 textAlign center初始进入页面显示生效
AC-EL-DB-011空态 legend说明「🏷 = 有品牌列(可随顶栏品牌切换过滤)· 行数为估算值」🏷 语义 + 估算行数双重声明(fontSize 12)文案逐字存在生效
AC-EL-DB-012表结构卡标题标题h2=表名 + sub「{N} 列 · {total} 行{ · 🏷 品牌过滤}」N=columns.length;total=后端 count(*) 精确值(此处非估算);has_brand 才追加 🏷 段结构端点 JSON vs 标题三段生效
AC-EL-DB-013列徽标墙徽标每列一枚 badge dim:列名+灰色小字号类型title={type} · {可空|非空}{ · 默认 X}(default 非空才追加);flex wrap gap 4悬停 title 与 information_schema 一致生效
AC-EL-DB-014数据卡·搜索表单筛选input「搜索…」maxWidth 300 + 「搜索」按钮onSubmit:preventDefault + setPage(1)+setQuery(search)——提交才生效(非即时);搜索范围=后端 ILIKE 前 8 列(任意类型,AC-EL-DB-028)e2e 提交后 rows 请求带 search 参数生效
AC-EL-DB-015行数/页码计数器数值rows 就绪「{total} 行 · 第 {page}/{pages} 页」,否则「加载中…」total=过滤后 count(*);pages=max(1, ceil(total/50))翻页/搜索后计数联动断言生效
AC-EL-DB-016结果表容器表格.tbl-wrap maxHeight 55vh overflow auto,fontSize 12行/列双向滚动,表头 sticky(AC-EL-DB-017)滚动行为 + 表头吸附生效
AC-EL-DB-017表头 sticky表头每列 th nowrap + position sticky top 0列名=rows.columns(后端 ordinal_position 顺序);背景 var(--card,#fff) zIndex 1端点 columns vs 表头逐字一致生效
AC-EL-DB-018单元格 NULL格式值 null/undefined → span.muted「NULL」区分空字符串(空串原样显示为空白)含 null 列的行显示 NULL生效
AC-EL-DB-019单元格长值截断格式String 值长度 >80 → slice(0,80)+「…」仅显示层截断;全值经 title 悬停可见(AC-EL-DB-020)长文本列悬停得全文生效
AC-EL-DB-020单元格 ellipsis格式maxWidth 200 + overflow hidden + ellipsis + nowraptitle=String(r[c] ?? "")——悬浮给完整值悬停 title=完整值生效
AC-EL-DB-021空数据行空态items 空 → colSpan 全列居中提示brand 非空「品牌 {brand} 无数据」否则「无数据」——品牌过滤是空因之一选品牌后空表显示品牌提示生效
AC-EL-DB-022翻页器翻页「← 上一页」「下一页 →」两按钮page≤1 / page≥pages 时 disabled;点击 setPage(∓1) 触发重载首末页禁用态 e2e生效
AC-EL-DB-023页大小常量口径pageSize=50(前端常量)后端 page_size 钳制 [1,200],50 在界内;pages 由 total/50 向上取整rows 请求参数断言 page_size=50生效
AC-EL-DB-024换表重置行为交互sel 变更 → detail/rows 置空 + page=1 + query/search 清空先渲染空/加载态再拉新表,避免旧表数据残留e2e 连续切换两表无残留生效
AC-EL-DB-025后端·表清单端点APIGET /api/db/tables_require_admin 门禁(仅管理员);public schema BASE TABLE 全集去敏感表;has_brand=information_schema DISTINCT brand 列表;rows_est=pg_class.reltuples端点响应 vs information_schema/pg_class 直查生效
AC-EL-DB-026后端·敏感表黑名单安全_BLOCKED_TABLES 精确集 11 表 + bak_ 前缀双拦11 表=users/tenants/tenant_brands/audit_log/usage_daily/tenant_credentials/tenant_credential_events/credentials/mcp_keys/billing_events/subscriptions(凭证/密码/token/计费身份绝不进浏览器;D批P3-15 删 4 死条目补 6 后上线表);P2-9(2026-10-21):bak_ 前缀拦手工备份表(bak_ 表常含跨租户全集,精确集漏列即整表可浏览),后续备份表按 bak_<表>_<日期> 命名自动被拦逐表请求 403「敏感表不可浏览」;bak_ 造名同拦生效
AC-EL-DB-027后端·表结构端点APIGET /api/db/table/{table}admin 门禁+表名白名单(AC-EL-DB-029)+黑名单三重;columns=information_schema(name/type/nullable/default,ordinal_position 序);无列 404「表 {t} 不存在」;total=精确 count(*);has_brand=列中有 brand结构 JSON vs pg 直查生效
AC-EL-DB-028后端·数据行端点APIGET /api/db/table/{table}/rowsbrand 过滤仅 has_brand 表生效(brand=%s);search=前 8 列任意类型(排除 id/tenant_id,非按类型筛选,collab.py:459-460)coalesce ::text ILIKE %kw% OR 组;ORDER BY 1 DESC(首列倒序);page=max(1,page),page_size 钳 [1,200]请求参数 vs SQL 语义逐项生效
AC-EL-DB-029后端·表名白名单正则安全^[A-Za-z_][A-Za-z0-9_]{0,62}$P2-9 纵深防御:table_name 拼 f-string SQL,白名单先于一切;结构/行两端点同拦注入载荷(引号/分号/空格/超长)返回 400「非法表名」生效
AC-EL-DB-030后端·行值序列化口径datetime→isoformat()[:19];dict/list→json.dumps(ensure_ascii=False)[:200];float→round(,4)三类规整后下发,jsonb 截 200 字符防大对象含 jsonb/浮点列的行值形态生效
AC-EL-DB-031品牌过滤联动筛选顶栏品牌(BrandContext)→ rows?brand= 参数仅 has_brand 表后端加 brand= 条件;无 brand 列表忽略该参数(返回全量行);tenant_conn 带 request.state.brand_scope(RLS 双保险)切品牌后行数变化 + 空态文案联动生效

§11.15 数据字典(/dictionary · AC-EL-DIC,源码 web/app/dictionary/page.tsx 145 行 + api/routers/collab.py 512-550 + api/data_dict_meta.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DIC-001页框架·AppShell框架title=数据字典;crumb=「全部业务表 × 字段含义 · 按业务域分组 · 语义注释与 changelog 归档同源」2026-09-24 用户令「所有字段按业务输出到 zipforcehub」立页e2e 路由可达 + crumb 逐字生效
AC-EL-DIC-002双 tab 切换导航「字段字典(系统口径)」「电商词汇(行业口径)」两 tabview state fields|gloss,tab.on 选中态;两视图共用同一 q 搜索词 state(切 tab 不清空)e2e 切换渲染对应视图生效
AC-EL-DIC-003计数行数值fields:「{total_tables} 张业务表 · {total_columns} 个字段 · {N} 个业务域」;gloss:「{total} 个词条 · {N} 个业务域」;未就绪「加载中…」站内不展示行数(多租户规模不泄露;md 归档版含行数——AC-EL-DIC-019)端点 totals vs 计数行生效
AC-EL-DIC-004字段 tab·搜索框筛选placeholder「搜索表名 / 列名 / 含义(如 settlement、净利、acos)」maxWidth 380即时 useMemo 过滤(输入即生效,无提交按钮)输入即过滤生效
AC-EL-DIC-005字段过滤逻辑口径q.trim().toLowerCase() 后 includes 匹配命中面:表名/表描述/任一列名/任一列含义;域内表全不命中则整域卡隐藏大小写不敏感子串命中抽测生效
AC-EL-DIC-006加载失败行反馈「加载失败: {err}」p.muted仅 /api/dictionary 失败显示;glossary 失败静默(AC-EL-DIC-017)不影响字段面断 dictionary 端点显示该行生效
AC-EL-DIC-007业务域卡容器h2=域名(fontWeight 800)+「 · {N} 张表」域序=/api/dictionary domains 顺序(data_dict_meta.DOMAINS 定义;立页时 12 域)域数/域序与端点一致生效
AC-EL-DIC-008表行列表行mono 表名 + muted 表描述 + badge「{N} 列」+「展开 ▼/收起 ▲」点击 toggle,open=domain+"/"+table——单开互斥(同时只展开一张表);desc 空则不渲染描述段展开互斥行为 e2e生效
AC-EL-DIC-009展开字段表表格3 列:列(sku mono,宽 190)/类型(muted,宽 150)/含义(fontSize 13)minWidth 480 横向滚动;列序=information_schema ordinal_position展开后列名序列 vs 端点 cols生效
AC-EL-DIC-010含义空值格式c.desc 空 → muted「—」desc 三级回退:SPECIFIC[表][列] → COMMON[列] → ""(后端)无注释列显示 —生效
AC-EL-DIC-011其他表(未分域)卡容器h2「其他表(未分域)」+ other_tables 以「 · 」连接仅 other_tables 非空且无搜索词(!q)时渲染;other_tables=不在 DOMAINS 的库表排序集搜索时该卡隐藏生效
AC-EL-DIC-012词汇 tab·搜索框筛选placeholder「搜词条 / 英文 / 释义(如 ACOS、跟卖、IPI)」maxWidth 380即时过滤(与字段 tab 同一 q)输入即过滤生效
AC-EL-DIC-013词汇过滤逻辑口径五字段 lowercase includes命中面:term/en/abbr/desc/sys;空域整卡隐藏任一字段子串命中抽测生效
AC-EL-DIC-014词汇域卡容器h2=域名+「 · {N} 条」域序=glossary_domains() 顺序域数/条数与端点一致生效
AC-EL-DIC-015词汇表表格5 列:词条(strong,120)/英文全称(190)/官方缩写(sku mono,90)/释义(13)/系统落点(sku,220)minWidth 520 横向滚动;系统落点 whiteSpace normal 可换行列头与端点字段一一对应生效
AC-EL-DIC-016系统落点空值格式e.sys 空 →「—」sys=后端 attach_sys 注入(term_field_map:词条→库表/页面落点)无落点词条显示 —生效
AC-EL-DIC-017词汇加载态/静默失败反馈g 未就绪「加载中…」;glossary 请求失败静默catch 空函数——词汇面缺席不阻断字段面断 glossary 端点页面仍可用生效
AC-EL-DIC-018后端·字典端点APIGET /api/dictionaryinformation_schema 全 public 列按表分组;DOMAINS 分域 + SPECIFIC/COMMON/TABLE_DESC 语义注释;total_tables=有列表数、total_columns=列总数;不在 DOMAINS 的表进 other_tables(sorted)端点 vs pg 直查计数生效
AC-EL-DIC-019语义层单一事实源口径api/data_dict_meta.py = 字典语义唯一源站内 /api/dictionary 与 tools/gen_data_dictionary.py(md 导出)共用;站内无行数、md 归档版含行数;立页时 12 业务域 × 113 表(页内计数实时取端点);现值 12 域 × 114 唯一表(115 token 中 1 重复,2026-10-22 校对数);changelog 归档同源(crumb 声明)md 归档版与站内字段/含义抽测一致生效
AC-EL-DIC-020后端·词汇端点APIGET /api/glossaryglossary_domains()+attach_sys 注入系统落点;total=Σ各域词条;与 MCP glossary 工具共用同源;changelog 归档版 /audit/ecommerce-glossary-2026-09-24.md 同步维护端点 total vs 页面计数生效

§11.16 文档中心(/documents · AC-EL-DOC,源码 web/app/documents/page.tsx 140 行 + api/routers/collab.py 75-103)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DOC-001页框架·AppShell框架title=文档;crumb=「文档中心 · 飞书云盘链接树」require_module("collab") 门禁(AC-EL-DOC-023)e2e 路由可达 + crumb 逐字生效
AC-EL-DOC-002错误横幅反馈err 非空时 div.error role=alertload/doSearch catch 均写 err=String(e.message)断端点场景横幅出现生效
AC-EL-DOC-003KPI 卡·根目录KPIint(kpi?.roots);foot「品牌 / 部门 / 运营资料分区」roots=documents_nodes 中 parent='' 行数(后端 FILTER);kpi 仅 parent="" 根请求返回(AC-EL-DOC-022);kpi null → int=0端点 kpi vs 卡值生效
AC-EL-DOC-004KPI 卡·文档链接KPIint(kpi?.files);foot「飞书云文档 / 表格 / 上帝视角」files=type='file' 行数(FILTER 计数)同上生效
AC-EL-DOC-005KPI 卡·节点总数KPIint(kpi?.total);foot「含全部文件夹层级(去重后)」total=documents_nodes count(*)(path 唯一——去重口径声明)同上生效
AC-EL-DOC-006文档树卡标题标题h2「文档树」+ sub「点击文件夹展开 · 文件跳转飞书原链」交互语义声明:树内导航 + 文件外跳文案逐字存在生效
AC-EL-DOC-007搜索表单筛选input「搜索路径或文件夹名」maxWidth 380 + 「搜索」按钮onSubmit→doSearch()(提交才请求);输入框清空(!trim)时即时 setResults(null) 回树e2e 提交后切结果表生效
AC-EL-DOC-008搜索 P0 修复注记缺陷史2026-09-17 修(P0):原 doSearch 读 query 但 setQuery 全文件零调用(死 state),搜索永远短路现版本 doSearch(kw?) 提交即 setQuery+请求;空 q 直接回树搜索可用 e2e(历史缺陷不回归)生效
AC-EL-DOC-009清除按钮交互ghost「清除」,仅 results 存在时渲染点击 setResults(null)+setSearch("") 回树视图有结果才显示;点击回树生效
AC-EL-DOC-010搜索结果表表格3 列:路径(sku mono)/类型/操作类型 badge:文件夹 dim「文件夹」/文件 ok「文件」;操作列 url 有值才渲染「打开 ↗」(brand 色 target _blank)结果行 vs 端点 items生效
AC-EL-DOC-011无匹配空态空态results 空 → colSpan 3「无匹配」居中 padding 28total=0 或 items 空均触发无结果关键词显示生效
AC-EL-DOC-012结果计数行数值「匹配 {resultTotal} 条,显示前 {results.length} 条」resultTotal=ILIKE 命中总数(count(*));items 上限 min(500, limit)、默认 limit=300——总数与显示上限分离计数 vs 端点 total生效
AC-EL-DOC-013树容器容器border 圆角容器 maxHeight 560 overflowY auto根未载入时 p.muted「加载中…」长树纵向滚动生效
AC-EL-DOC-014树行·文件夹按钮列表行btn inline ghost「{…|−|+} 📁 {name}」,点击 toggleloading 中显示 …;isOpen=−;未展开=+;fontSize 13e2e 展开加载子级生效
AC-EL-DOC-015树行·文件链接列表行a「📄 {name}」跳 url 新窗口target _blank rel noreferrer;颜色 var(--text) 无下划线点击打开飞书原链生效
AC-EL-DOC-016文件夹子项计数数值文件夹行右 muted「{children} 项」P3 缺陷⑤ polish:原守卫 children>0 使空文件夹无计数——快照 82% 文件夹为空,显示「0 项」区分「真空文件夹」与「未展开」;API 侧 children 始终真计数(含根级)空文件夹显示 0 项生效
AC-EL-DOC-017缩进规则布局marginLeft = depth×18每层级 18px 表达树深多层展开缩进递增生效
AC-EL-DOC-018惰性加载交互toggle 展开且 children[path] 无缓存才 load(path)loading 中子级不渲染(null 防闪旧数据);已缓存直接复用二次展开不重发请求生效
AC-EL-DOC-019数据源脚注说明「数据源:飞书云盘文档树快照(按本租户品牌范围过滤)。链接目标为飞书域,访问权限跟随飞书账号;树为租户自有资产(RLS 隔离)。」三层边界声明:快照按租户品牌过滤 / 飞书侧权限独立 / RLS 租户隔离文案逐字存在生效
AC-EL-DOC-020后端·树端点 children 模式APIGET /api/documents/tree?parent=单层子节点:WHERE parent=%s,ORDER BY (type='folder') DESC, name(文件夹优先);children=子路径 count 真计数;total=len(items)parent 逐层请求 vs SQL 直查生效
AC-EL-DOC-021后端·树端点 search 模式APIGET /api/documents/tree?search=path ILIKE %kw%;total=count(*) 全命中;items LIMIT min(500,limit);search 项 children 恒 0;kpi=null搜索总数/上限语义验证生效
AC-EL-DOC-022后端·kpi 口径口径仅 parent="" 根请求返回 kpikpi={total: count(*), files: FILTER(type='file'), roots: FILTER(parent='')};非根请求 kpi=null(前端仅根 load 存 kpi)根/子请求响应对比生效
AC-EL-DOC-023模块门禁安全require_module("collab")需 collab 模块授权账号;tenant_conn 租户库(documents_nodes 表)未授权账号 403生效

§11.17 账户安全(/account · AC-EL-ACC,源码 web/app/account/page.tsx 111 行 + api/routers/auth.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ACC-001页面框架·标题与面包屑布局AppShell title=「账户安全」,crumb=「会话管理 · 修改密码 · 服务端会话可吊销」account/page.tsx:51;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-ACC-002错误横幅反馈红色 error 条,role="alert",marginBottom 16;err 非空时渲染account/page.tsx:52;内容为接口异常 message 原文e2e 构造改密失败(旧密码错)断言横幅出现生效
AC-EL-ACC-003成功横幅反馈ok-banner 条,role="status";改密成功后显示回执(见 ACC-010)account/page.tsx:53e2e 改密成功断言横幅文案生效
AC-EL-ACC-004修改密码卡·标题容器「修改密码」副标「改密后其他设备全部下线,当前设备保持登录」account/page.tsx:56e2e 断言标题与副标生效
AC-EL-ACC-005修改密码·当前密码输入输入type=password,受控 pwd.oldaccount/page.tsx:58e2e 断言 input.type=password生效
AC-EL-ACC-006修改密码·新密码输入输入label「新密码(≥8 位)」type=password,受控 pwd.new1account/page.tsx:59;≥8 位为前后端一致约束(前端 ACC-008 先拦)e2e 断言 label 文本生效
AC-EL-ACC-007修改密码·确认新密码输入输入type=password,受控 pwd.new2account/page.tsx:60e2e 断言三输入框齐备生效
AC-EL-ACC-008修改密码·客户端校验校验两次提交前检查:new1≠new2 →「两次输入的新密码不一致」;new1.length<8 →「新密码至少 8 位」;均写 err 横幅不发请求account/page.tsx:38-39e2e 两种非法输入各断言拦截文案且网络面板无 POST生效
AC-EL-ACC-009修改密码·按钮操作文案 busy=「提交中…」/常态「修改密码」;disabled = busy || !old || !new1(new2 空可点但会被一致性校验拦)account/page.tsx:62-64e2e 空表单断言 disabled;填齐断言可点生效
AC-EL-ACC-010修改密码·成功反馈反馈POST /api/auth/password(auth.py:559) {old,new};成功回执「密码已修改;其他 {revoked_other} 个设备会话已吊销,当前设备保持登录」,三个输入框清空account/page.tsx:42-45;revoked_other 由后端统计并吊销的其他会话数,当前会话豁免e2e 双会话账号改密:另一会话刷新即 401 跳登录,当前会话保持;回执数=另一会话数生效
AC-EL-ACC-011在册会话卡·标题容器「当前在册会话」副标「8 小时滑动有效期 · 每次访问自动续期」account/page.tsx:68;8h 滑动=会话机制卡口径(ACC-023)e2e 断言标题与副标生效
AC-EL-ACC-012在册会话卡·加载态空态items 未返回时灰字「加载中…」account/page.tsx:69e2e 弱网断言先显加载态生效
AC-EL-ACC-013会话表·表头表格3 列:会话/登录时间/状态account/page.tsx:73;数据源 GET /api/auth/sessions(auth.py:151) → items: Sess[]e2e 断言 3 个 th生效
AC-EL-ACC-014会话表·会话标识列列sid 打码展示(前 8 位+「…」,sid[:8]+"…" auth.py:157;sku 样式),每行 key=sidaccount/page.tsx:77;sid 为服务端在册会话 ID,非令牌本体e2e 断言至少一行 sid 非空生效
AC-EL-ACC-015会话表·登录时间列列created 原样展示(muted),不做时区/格式转换account/page.tsx:78e2e 断言与登录时刻一致生效
AC-EL-ACC-016会话表·状态列列badge:current=true「当前设备」(ok)/false「其他设备」(dim)account/page.tsx:79e2e 断言恰一行「当前设备」生效
AC-EL-ACC-017会话表·空态行空态colSpan=3「无在册会话」(登出后立即回显场景)account/page.tsx:82e2e 退出全部后未跳转前断言(或 mock 空 items)生效
AC-EL-ACC-018刷新按钮操作「刷新」重拉 GET /api/auth/sessions;busy 期间 disabledaccount/page.tsx:88e2e 另开登录后点刷新断言新行出现生效
AC-EL-ACC-019退出全部设备按钮操作danger 确认框「退出全部设备?/所有已登录会话立即作废。」确认后 POST /api/auth/logout-all(auth.py:165),成功即 router.replace("/login");失败显 err 且 busy 复位account/page.tsx:26-34, 89-91;成功路径不 reset busy(直接离开页面)e2e 双会话账号执行:两处均被登出且旧 Cookie 复用请求 401生效
AC-EL-ACC-020会话机制卡·标题容器「会话机制」副标「2026-09-06 安全加固」account/page.tsx:96;静态说明卡,无接口调用e2e 断言标题与副标生效
AC-EL-ACC-021会话机制·令牌形态行说明「HMAC 签名(防伪造)+ Redis 服务端在册(可吊销),双校验缺一不可」account/page.tsx:100e2e 断言文案;渗透测试矩阵含伪造签名/未在册令牌双拒用例生效
AC-EL-ACC-022会话机制·登出生效行说明「服务端即刻吊销,旧 Cookie 立即作废(此前仅删浏览器 Cookie,令牌仍有效 8h)」account/page.tsx:101e2e 登出后用旧 Cookie 重放断言 401生效
AC-EL-ACC-023会话机制·有效期行说明「8 小时滑动;Redis 故障时按未认证处理(fail closed)」account/page.tsx:102e2e 断言文案;故障注入 Redis 不可用断言全部 401(fail closed 不放行)生效
AC-EL-ACC-024会话机制·防跨租户行说明「令牌绑定租户 slug,跨子域使用直接拒绝(渗透测试矩阵覆盖)」account/page.tsx:103e2e 持 A 租户令牌访问 B 租户子域断言 401生效

§11.18 团队(/team · AC-EL-TEAM,源码 web/app/team/page.tsx 291 行 + api/routers/org.py·auth.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-TEAM-001页面框架·标题与面包屑布局AppShell title=「团队」,crumb=「员工账号 · 模块×品牌授权 · 品牌管理」team/page.tsx:151;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-TEAM-002非管理员拒绝态权限meta 拉取 403 时整页替换为居中卡「仅管理员可见」+「员工账号管理需要 owner / admin 权限。{err}」,无任何管理功能渲染team/page.tsx:47-49, 137-146;权限门在 GET /api/team/meta(org.py:62, _require_admin),前端以请求成败表达e2e 普通员工账号访问 /team 断言只出拒绝卡生效
AC-EL-TEAM-003错误横幅反馈error 条 role="alert";各写操作失败时填入后端 message 原文team/page.tsx:152e2e 重复邮箱建员工断言 409 文案上横幅生效
AC-EL-TEAM-004成功横幅反馈ok-banner 条 role="status";建/改/删员工、品牌增删恢复各写各自回执(见对应条目)team/page.tsx:153e2e 各操作后断言回执文案生效
AC-EL-TEAM-005员工账号卡·标题容器「员工账号」副标「席位 {used}/{limit} · 权限实时生效:改动后该员工全部会话立即吊销」team/page.tsx:157-158;seats 来自 GET /api/team/meta(org.py:62):used=count(users.status=active),limit=PLAN_SEATS[plan](未配计划默认 5)e2e 断言 used/limit 与库内 active 用户数一致;改员工权限后其会话立即 401生效
AC-EL-TEAM-006+ 添加员工按钮操作打开新增抽屉,品牌授权预勾选全部在营品牌(modules 空)team/page.tsx:53 openNew brands: meta?.brands ?? [],161e2e 点开断言抽屉品牌 chips 全 on生效
AC-EL-TEAM-007员工表·加载态空态members 未返回时灰字「加载中…」team/page.tsx:163e2e 弱网断言先显加载态生效
AC-EL-TEAM-008员工表·表头表格9 列:姓名/邮箱/职能/角色/模块/品牌/状态/最后登录/操作team/page.tsx:167;数据源 GET /api/team/users(org.py:75):owner 排最前(ORDER BY role='owner' DESC, id),modules=已授权模块数组、brands=授权品牌数组e2e 断言 9 个 th 与 owner 首行生效
AC-EL-TEAM-009员工表·姓名列列strong 样式,空值显「—」team/page.tsx:171 m.name || "—"e2e 无名员工断言「—」生效
AC-EL-TEAM-010员工表·邮箱列列登录邮箱,muted 样式team/page.tsx:172e2e 断言与库内一致生效
AC-EL-TEAM-011员工表·职能列列job_label 展示,空值显「—」team/page.tsx:173e2e 断言与抽屉保存值一致生效
AC-EL-TEAM-012员工表·角色列列badge dim 展示 role(owner/admin/member)team/page.tsx:174e2e 断言 badge 文本生效
AC-EL-TEAM-013员工表·模块列列owner/admin 显「全部」;其余显授权模块名(key→meta.modules[k].name,查不到回退 key)「、」连接,空显「(未授权)」;列宽上限 220team/page.tsx:175-178e2e 三种角色/空授权断言三种呈现生效
AC-EL-TEAM-014员工表·品牌列列owner/admin 显「全部」;其余显授权品牌「、」连接,空显「(无)」team/page.tsx:179e2e 同上三态生效
AC-EL-TEAM-015员工表·状态列列badge:active=「在职」(ok)/其他=「停用」(bad)team/page.tsx:180e2e 停用员工断言 badge 翻转生效
AC-EL-TEAM-016员工表·最后登录列列last_login_at 截「yyyy-MM-dd HH:mm」(slice(0,16) T→空格),从未登录显「从未」team/page.tsx:181e2e 新建未登录员工断言「从未」生效
AC-EL-TEAM-017员工表·操作列·编辑操作打开编辑抽屉(回填 email/name/job_label/modules/brands,密码置空),见 TEAM-035…044team/page.tsx:54-58, 184e2e 点编辑断言抽屉回填值生效
AC-EL-TEAM-018员工表·操作列·停用/启用操作按钮文案随状态翻转(在职→「停用」/停用→「启用」);停用需 danger 确认「停用 {email}?/其会话立即吊销。」;PUT /api/team/users/{id} {status}team/page.tsx:91-96, 185;后端 org.py:125;启用无需确认直接发e2e 停用后该员工请求 401;重新启用可登录生效
AC-EL-TEAM-019员工表·操作列·删除操作danger 确认「删除员工 {email}?/其所有会话立即作废。」确认后 DELETE /api/team/users/{id}(org.py:179),回执「已删除 {email}」team/page.tsx:84-89, 186e2e 删测试员工断言行消失+审计落账生效
AC-EL-TEAM-020员工表·owner 行保护边界role=owner 的行不渲染任何操作按钮(编辑/停用启用/删除全无)——owner 不可被他人改动team/page.tsx:183 m.role !== "owner" && <>…</>e2e 断言 owner 行操作列为空生效
AC-EL-TEAM-021品牌管理卡·标题容器「品牌管理」副标「运营公司可挂多个品牌,数据按品牌隔离(RLS)」team/page.tsx:198;数据源 GET /api/tenant/brands(auth.py:407):行=tenant_brands 全量(含停用),排序 is_active DESC, brande2e 断言标题;品牌清单与库一致生效
AC-EL-TEAM-022品牌名输入框输入placeholder「品牌名(小写字母/数字/连字符, 2-40 位)」;提交前 trim+toLowerCase 归一team/page.tsx:99-101;后端 auth.py:420 同规则强制 ^[a-z0-9-]{2,40}$ fullmatch,违例 400;重复 409「品牌已存在」e2e 大写输入断言被归一保存;非法字符断言 400 上横幅生效
AC-EL-TEAM-023+ 添加品牌按钮操作POST /api/tenant/brands(auth.py:420) {brand};成功清空输入、回执「品牌 {brand} 已添加」并整页刷新;审计 tenant.brand.addteam/page.tsx:98-103e2e 添加测试品牌断言三卡(员工抽屉品牌 chips/品牌表)同步出现生效
AC-EL-TEAM-024品牌表·表头表格4 列:品牌/商品数/数据截至/操作team/page.tsx:206e2e 断言 4 个 th生效
AC-EL-TEAM-025品牌表·品牌列列品牌名 strong;停用品牌追加 badge dim「已停用」且整行 opacity 0.5team/page.tsx:209-210 is_active === falsee2e 停用后断言 badge+变淡生效
AC-EL-TEAM-026品牌表·商品数列列该品牌 products 行数计数后端 auth.py:411 子查询 (SELECT count(*) FROM products WHERE brand=…)e2e 与库内 count 对账生效
AC-EL-TEAM-027品牌表·数据截至列列该品牌最新销售日,空显「—」后端 auth.py:412 max(day) FROM sales_daily WHERE brand=…(销售最大日,非今日)e2e 与库内 max(day) 对账生效
AC-EL-TEAM-028品牌表·停用按钮操作仅当租户品牌总行数(含停用)>1 时渲染(brands.length>1,page.tsx:214;「至少一个在营」校验仅 permanent 注销分支有——1 在营+1 停用时在营品牌仍可停用);确认框非 danger「停用品牌 {b}?/品牌将从所有页面隐藏,数据保留在数据库中,可随时恢复。」;DELETE /api/tenant/brands/{b}?mode=archive(auth.py:435)team/page.tsx:214-216;后端 archive=is_active=false+审计 tenant.brand.archive;②C(2026-09-26):全部品牌停用→自动暂停该租户调度(pause_tenant_jobs)并广播 ShopConfigUpdated——级联自动生成/停摆,不需人工接线e2e 停用品牌断言各页隐藏、可恢复;仅剩 1 行品牌(任意状态)断言无停用按钮生效
AC-EL-TEAM-029品牌表·恢复按钮操作仅停用品牌渲染(ok 色);PUT /api/tenant/brands/{b}/activate(auth.py:523),回执「品牌 {b} 已恢复」无需确认框team/page.tsx:217-219e2e 停用→恢复断言行态复原且各页数据回归生效
AC-EL-TEAM-030品牌表·彻底删除按钮操作仅停用品牌渲染(danger 色);UI-07(2026-10-14) 接线两步走定稿(2026-09-22)第二步——先停用才可彻底删除;danger 确认「彻底删除品牌 {b}?/将永久删除该品牌的所有商品、订单、库存数据,不可恢复!」;DELETE ?mode=permanentteam/page.tsx:113-117, 220-222;后端 ⑬(2026-10-01) 三段式引用计数级联重写:租户间绝对隔离、跨租户操作绝对禁止(业务表无 tenant_id 列,旧按 brand 全局 DELETE 曾险些波及他租户同名品牌)——铁律:租户/品牌绝对独立、不可误删;级联按依赖顺序清全部业务数据e2e(仅测试租户)彻底删除测试品牌:断言其商品/订单/库存清零且他租户同名品牌毫发无损;审计 tenant.brand.* 留痕生效
AC-EL-TEAM-031注销租户卡·标题容器「注销租户(危险区)」副标「注销整个租户账号 · 与单个品牌的停用无关」;卡片红边框 borderColor=var(--danger) 独立于其余卡team/page.tsx:232-233e2e 断言标题与红边样式生效
AC-EL-TEAM-032注销租户卡·流程说明文说明「注销流程:先完整归档本租户全部数据 → 子域停用、全员会话吊销 → 进入 30 天冷静期。冷静期内业主可随时在恢复页一键撤回(数据原样回归);届满后系统自动物理清除,不可恢复。注销/恢复/清除全程写入审计日志,永久留存。」team/page.tsx:234-238;#62(2026-10-10) 注销流程入口注释:成功后全员会话已被吊销,直接落在 /offboarding 自助恢复页e2e 断言说明文全文(恢复页本体见 /offboarding 页条目)生效
AC-EL-TEAM-033注销租户卡·slug 确认输入输入placeholder「输入 {meta.slug} 以确认」——回显本租户 slug 作双重确认team/page.tsx:240-241;slug 由 GET /api/team/meta 下发(org.py:62,#62);后端 org.py:258 再校验 confirm===slug 否则 400e2e 输错 slug 断言按钮仍 disabled/后端 400生效
AC-EL-TEAM-034注销租户卡·发起注销按钮操作danger 色;disabled = 确认框空 || busyOff || 无 slug;busy 文案「归档中…」;danger 确认「确认注销租户 {slug}?/全部数据先归档,随后子域停用、全员会话吊销并登出。30 天冷静期内可随时自助恢复;届满后数据永久清除。」确认后 POST /api/org/tenant/offboard(org.py:252) {confirm} → 跳 /offboarding?due={purge_due}&just=1team/page.tsx:119-135, 242-245;后端:confirm≠slug 400;已在冷静期 409;状态非 active 409;_archive_tenant 先行(归档是清除的前置铁条件,任一步失败 status 不动)→ status=offboarding → 吊销全员会话;审计 tenant.offboard 含归档文件名/行数/冷静期天数e2e(仅测试租户)发起注销断言跳恢复页、全员 401、审计留痕;重复发起断言 409生效
AC-EL-TEAM-035员工抽屉·标题容器新增态「添加员工」/编辑态「编辑 · {email}」;drawer-mask 点遮罩关抽屉,drawer 内 stopPropagation 防误关team/page.tsx:250-253e2e 点遮罩空白处断言抽屉关闭、点内容区不关生效
AC-EL-TEAM-036抽屉·邮箱输入输入新增态可输入(登录账号);编辑态 disabled(邮箱不可改)team/page.tsx:255-256 disabled={edit !== "new"}e2e 编辑态断言不可交互生效
AC-EL-TEAM-037抽屉·姓名输入输入自由文本,可空(列表显「—」)team/page.tsx:257e2e 留空保存断言列表「—」生效
AC-EL-TEAM-038抽屉·职能输入输入自由文本 job_label;点职能预设 chip 会覆盖此值(TEAM-040)team/page.tsx:258e2e 手填+预设各试一次断言联动生效
AC-EL-TEAM-039抽屉·密码输入输入label 随态:新增「初始密码(≥8 位)」/编辑「重置密码(留空不改)」;type=passwordteam/page.tsx:259-260;新增前端先拦 <8 位(page.tsx:68),后端 org.py:93 同判 400;编辑态仅填了才随 PATCH 带 passworde2e 新增 7 位密码断言双端拦截;编辑留空保存断言密码未变生效
AC-EL-TEAM-040抽屉·职能预设 chips输入分区标题「职能预设(一键勾选模块,可逐项微调)」;每个预设 chip 点击=setForm(job_label=预设名, modules=meta.presets[预设]),选中 chip 高亮 on(判据 job_label===预设名)team/page.tsx:59-61, 262-267;presets=ROLE_PRESETS 由 meta 下发e2e 点预设断言模块 chips 自动勾成预设集合再手工微调一项保存成功生效
AC-EL-TEAM-041抽屉·模块授权 chips输入分区标题「模块授权」;每个模块 chip 点击 toggle 进/出 form.modules,选中 onteam/page.tsx:268-274;模块清单=meta.modules(key→{name,pages}),chip 显 namee2e 勾/退各一次保存后断言列表模块列与库内授权一致生效
AC-EL-TEAM-042抽屉·品牌授权 chips输入分区标题「品牌授权(不选 = 该员工看不到任何品牌数据)」;chip=各在营品牌 toggleteam/page.tsx:275-281;铁律边界:品牌数据按品牌授权隔离,不选任何品牌=零品牌可见(白名单式拒绝默认)e2e 全不选保存后以该员工登录断言各数据页空/无品牌生效
AC-EL-TEAM-043抽屉·取消/保存按钮操作取消=关抽屉不改;保存 busy 文案「保存中…」disabled;新增 POST /api/team/users(org.py:93) 全量表单→回执「已创建员工 {email}」;编辑 PUT /api/team/users/{id}(org.py:125) 仅 patch name/job_label/modules/brands(+password 若填)→回执「已更新 {email}(其已登录会话已被吊销,需重新登录)」;成功后关抽屉+整页刷新team/page.tsx:64-82, 282-285;编辑必吊销该员工全部会话=权限实时生效(TEAM-005 副标承诺)e2e 双端各存一遍;编辑后断言该员工旧会话 401、新权限生效生效
AC-EL-TEAM-044抽屉·遮罩与层级布局drawer-mask 全屏遮罩居中抽屉;点击遮罩=setEdit(null)(未保存内容丢弃不提示)team/page.tsx:251-252e2e 填一半点遮罩断言直接关闭无确认生效

§11.19 AI 助手(/ai · AC-EL-AI,源码 web/app/ai/page.tsx 110 行 + api/routers/ai.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-AI-001页面框架·标题与面包屑布局AppShell title=「AI 助手」,crumb=「四大 AI 能力 · 数据经 RLS 隔离 · 全量审计」ai/page.tsx:58;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-AI-002Tab 组(4 个)导航数据问答/选品建议/广告文案/广告优化;默认 insight;切 tab 即清空 answer 与 err(不保留旧答案)ai/page.tsx:6-13 TABS, 63-65 setTab(k); setAnswer(""); setErr("")e2e 生成答案后切 tab 断言输出区清空生效
AC-EL-AI-003Tab·数据问答(insight)能力desc=「用自然语言问经营数据,AI 只依据本租户真实数据回答。」ai/page.tsx:9;后端 POST /api/ai/insight(ai.py:323, require_module("ai")),审计 ai.insight(截 question 前 100 字)e2e 断言 tab 文案;问一句断言审计行生效
AC-EL-AI-004Tab·选品建议(sourcing)能力desc=「基于毛利率 / 营收趋势 / 广告效率 / 库存可售天数,给出加码、止损与补货建议。」ai/page.tsx:10;后端 POST /api/ai/sourcing(ai.py:432):F3-6(2026-09-26) 权限拆分——sourcing 或 ai 任一模块即放行;未开通 ai 的租户走降级路径(审计 ai.sourcing.degraded)e2e 仅 sourcing 模块租户断言可用;未开通 ai 走降级不 403生效
AC-EL-AI-005Tab·广告文案(adcopy)能力desc=「输入 SKU,生成 3 组英文广告标题 + 五点卖点。」ai/page.tsx:11;后端 POST /api/ai/adcopy(ai.py:350, require_module("ai")),审计 ai.adcopye2e 传入有效 SKU 断言回答含 3 组标题结构生效
AC-EL-AI-006Tab·广告优化(ads)能力desc=「逐广告活动分析 ACOS,给出加预算 / 降竞价 / 否定词 / 暂停建议。」ai/page.tsx:12;前端 path 映射 ads→POST /api/ai/ads-optimize(ai.py:804, require_module("ai")),审计 ai.ads-optimizee2e 断言请求落在 ads-optimize 端点生效
AC-EL-AI-007insight·问题输入框输入textarea rows=3;默认问题「最近哪个 SKU 营收下滑最严重?跌了多少?」;placeholder「如:上个月哪个 SKU 毛利跌了?为什么这个 SKU 的广告没有花费?」ai/page.tsx:31, 70-71e2e 断言默认值与 placeholder生效
AC-EL-AI-008insight·快捷问题按钮组输入6 个 ghost 小按钮,点击将问题填入 textarea(不自动触发生成):最近哪个 SKU 营收下滑最严重?/最新月各品牌赚了还是亏了?/库存有哪些断货风险?/回款有没有异常订单?/各品牌近 30 天营收对比如何?/哪些 SKU 有广告花费但没有转化?ai/page.tsx:73-77 onClick={() => setQuestion(q)}e2e 点任一按钮断言 textarea 同步生效
AC-EL-AI-009adcopy·SKU 输入输入placeholder「SKU(见商品页)」,随 body.sku 提交ai/page.tsx:83e2e 断言占位文本生效
AC-EL-AI-010adcopy·侧重点输入输入placeholder「侧重点(可选),如:户外场景」,空则不约束生成角度ai/page.tsx:84e2e 断言占位文本生效
AC-EL-AI-011sourcing/ads·说明段落说明两 tab 无输入控件,仅 muted 小字展示 active.desc(即 TEAM 对应 desc 文案)ai/page.tsx:87-89e2e 切两 tab 断言无输入框且段落文案正确生效
AC-EL-AI-012生成按钮操作文案 busy=「分析中…(大模型思考约 10–30 秒)」/常态「生成」;busy 期间 disabled;点击时先清空旧答案/元信息/错误再发请求ai/page.tsx:39-40, 91-93;请求体:insight={question}、adcopy={sku,angle}、sourcing/ads=无 body;端点 ads-optimize 其余=tab 名(page.tsx:42-44)e2e 断言 busy 文案与 disabled;抓包断言四 tab 各落对端点生效
AC-EL-AI-013错误提示条反馈error 样式 role="alert";后端 detail 为字符串时原样透传,否则「调用失败」ai/page.tsx:22-24, 48-49, 95e2e 未授权模块账号生成断言 detail 上屏生效
AC-EL-AI-014回答元信息行反馈回答区上方灰字「{model} · tokens: {input_tokens} → {output_tokens}」,usage 缺失字段显「-」ai/page.tsx:46-47, 98;响应契约 {answer, model, usage?{input_tokens,output_tokens}}e2e 生成成功断言元信息行含模型名与两个 token 数生效
AC-EL-AI-015回答输出区反馈ai-out 样式块渲染 answer 全文(Markdown 由样式类承接,页面不做二次加工)ai/page.tsx:99e2e 断言回答文本出现于 .ai-out生效
AC-EL-AI-016页脚口径说明说明「AI 数据上下文取自本租户(RLS 行级安全强制隔离);业务口径与财务模块一致:利润模型、ACOS/TACOS/ROAS 健康线、人民币成本 ×0.1471 折算。」ai/page.tsx:104-106;口径一致性承诺对齐 §11.6 FIN 同源定义(AC-CAL 系列);RLS=租户行级隔离(铁律:租户/品牌绝对独立)e2e 断言脚注全文;跨租户数据不得出现在回答中(抽问租户专属 SKU 验证)生效
AC-EL-AI-017组件挂载关系·边界边界本页未挂载 AIChat/AIContext 组件(页面自含问答 UI,仅引 AppShell);AIChat/AIContext 的逐元素条目归 §11.26 共享组件库ai/page.tsx:1-5 import 清单实证;组件本体见 AC-EL-CMP静态检查 import 断言无 AIChat/AIContext 引用生效

§11.20 管道任务(/pipeline · AC-EL-PIPE,源码 web/app/pipeline/page.tsx 334 行 + api/routers/collab.py 207-352 + api/metrics.py 160-276 + web/lib/fmt.ts)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PIPE-001页框架·AppShell框架title=管道任务;crumb=「采集任务注册表 · 数据新鲜度巡检 · 外部生产工具」current_user 门禁(任意登录用户可看状态;执行按钮另有 admin 门——AC-EL-PIPE-047)e2e 路由可达 + crumb 逐字生效
AC-EL-PIPE-002错误横幅反馈err 非空时 div.error role=alert仅 /api/pipeline/status 失败写 err;/api/pipeline/audit 失败静默 catch(审计面缺席不阻断)断 status 端点横幅出现生效
AC-EL-PIPE-003KPI 卡·定时任务KPIjobs.length,未就绪「—」;foot「worker 定时调度 · UTC」jobs=PIPELINE_JOBS 代码常量(29 条,AC-EL-PIPE-022);调度时刻全部 UTC 口径卡值=29 vs 注册表生效
AC-EL-PIPE-004KPI 卡·数据表在管KPItables.length,未就绪「—」;foot「RLS 租户可见范围行数」tables=后端 22 表 UNION ALL 常量行(AC-EL-PIPE-025);行数在 RLS 租户可见范围内统计卡值=22 vs 巡检表行数生效
AC-EL-PIPE-005KPI 卡·Keepa 关注池KPIint(keepa_watch);foot「每日 05:10 UTC 快照补拉」keepa_watch=keepa_watch 表 count(*);KEEPA_REFRESH_UTC 常量(web/lib/fmt.ts)=「05:10 UTC」,与 refresh_keepa_watch 任务 05:10 一致卡值 vs count(*);foot 文案逐字生效
AC-EL-PIPE-006KPI 卡·状态页日期KPIas_of(fontSize 19 文本卡);foot「任务定义代码化」as_of=后端 date.today()(响应生成日);「代码化」=任务清单非 DB 存档而是 collab.py 常量卡值=当日 ISO 日期生效
AC-EL-PIPE-007四层审计卡标题标题h2「🧭 四层审计」+ sub「rawdata → cleandata → api → web · 每日 06:35 全代码自动跑(零 LLM)· 部署时另有六道门」06:35=host-crontab.txt「35 6 * * * tools/four_layer_audit.py」(实证);零 LLM=全代码判定;六道门=deploy_gate(含 pipe_audit/chart_value 两门)crontab 行逐字;sub 文案逐字生效
AC-EL-PIPE-008审计空态空态audit 未就绪或 batch=null → 「暂无审计批次(每日 06:35 自动生成,或 python3 tools/four_layer_audit.py 手动触发)」audit_results 表无批次时整卡只出此行空库租户显示该行生效
AC-EL-PIPE-009层卡片·四层定义卡片L1 源头采集 / L2 清洗层 / L3 端点层 / L4 前端层 四卡(LAYER_META)L1「源表新鲜度 · 财务独立源交叉 · Pending 回刷」;L2「断流扫描 · 订单vs小时两表一致 · 清洗标记」;L3「KPI 对账 · hourly24 基准日 · 全量 81 图在部署门」;L4「核心页登录态探活 · SSR 载荷」四卡名称/描述逐字 vs LAYER_META生效
AC-EL-PIPE-010层卡片·状态灯指示层名左 10px 圆点颜色fail>0 → var(--danger,#dc2626);否则 warn>0 → var(--warn,#b54708);否则 var(--ok,#0e9384)造 FAIL 批次圆点变红生效
AC-EL-PIPE-011层计数行数值「FAIL n · WARN n · PASS n」(FAIL 红粗/WARN 黄)FAIL/WARN 段条件渲染(=0 不显示);PASS 恒显计数 vs audit 端点聚合生效
AC-EL-PIPE-012层展开明细交互点击层卡片 toggle(openLayer 单开互斥)非 PASS 项全列(FAIL 红/WARN 黄粗 + key + detail);PASS 项仅前 3 条(75% 透明度);pass>3 → 「…其余 {pass-3} 项 PASS(明细见 audit_results 表)」展开后明细 vs audit_results 直查生效
AC-EL-PIPE-013审计脚注说明「最近批次 {batch} · 检查于 {checked_at} · 点击层卡片展开明细 · 结果只追加存 audit_results 表」+ 趋势 + 外链趋势(trend.length>1 才显):「近 7 天 {N} 批次,累计 FAIL {Σfails}」(8 天窗口);外链「📘 注册表架构文档」=changelog.zipforcehub.com/audit/registry-architecture-2026-09-24.md(八张注册表/接入流程/挂账与阈值运维速查)脚注批次号 vs audit_results 最新 batch_id生效
AC-EL-PIPE-014注册表卡标题标题h2「定时任务注册表」+ sub「worker 容器内定时调度 · {N} 个任务」N=jobs.length=29sub 计数 vs 注册表生效
AC-EL-PIPE-015任务分组分组按 group 聚合渲染,组名下边框 2px 品牌色9 组:数据采集 3 / Amazon 采集 9 / Noon 采集 3 / Keepa/排名 2 / 汇率 1 / 源库同步 3 / 监控报警 3 / 广告规则 3 / 系统 2(含 1 手动);组序=首次出现序组数/各组任务数 vs PIPELINE_JOBS生效
AC-EL-PIPE-016任务表表格4 列:任务 / 调度(UTC) / 说明 / 操作每组一张表(tbl-wrap);行 key=name列头逐字生效
AC-EL-PIPE-017任务行·名称与说明列名称 strong;说明 muted(whiteSpace normal 可换行)名称/说明=PIPELINE_JOBS name/desc 字面(含口径注记如「零 LLM」「剔取消」等)行值 vs 常量逐字生效
AC-EL-PIPE-018任务行·调度列列badge ok 显示 cron_utc人类可读 UTC 时刻串(04:30 / 周日 02:00 / 每 15 分钟 / 每 2h :43 / 手动 等),非标准 cron 表达式;与 worker 实际调度一致为准badge 值 vs 常量;抽样 vs worker 日志时刻生效
AC-EL-PIPE-019▶ 执行按钮操作btn inline sm「▶ 执行」,running 时「⏳」+disabled点击 postJson /api/pipeline/run/{func};成功 toast ok「{name} 已入队 ({job_id 前 8}…)」;失败 toast err(端点报错原文);仅入队不等待完成e2e 点击后 toast + audit_log 出现 pipeline.run生效
AC-EL-PIPE-020手动任务行列func="" 的任务无执行按钮现仅「ABA 情报快照」(cron_utc=「手动」;desc 注明日更待专用受限 key)——按钮渲染条件 j.func 非空该行无按钮、调度显「手动」生效
AC-EL-PIPE-021任务执行载体架构执行发生在 worker 容器,页面按钮仅经 ARQ 入队采集引擎代码位于 /opt/collection(worker 容器内挂载只读 :ro,事实源);run.py 透传 argv;ads_attr_core 按 31 天分片;错误在 stdoutdocker inspect worker 挂载含 /opt/collection:ro生效
AC-EL-PIPE-022任务注册表数据源口径PIPELINE_JOBS 代码常量(collab.py 207-237,29 条 9 组)非 DB 注册——改任务=改代码发版(「任务定义代码化」);run 端点白名单也取此常量集(AC-EL-PIPE-047)常量行数 vs KPI 卡值生效
AC-EL-PIPE-023新鲜度巡检卡标题标题h2「数据新鲜度巡检」+ sub「各表行数与数据截至日(当前租户可见范围)」租户可见范围=RLS 口径声明文案逐字生效
AC-EL-PIPE-024巡检表表格4 列:数据表(strong)/行数(r num int)/数据截至(sku,null→「—」)/新鲜度(badge)行=tables 顺序(后端 UNION ALL 定序)列头与行序 vs 端点生效
AC-EL-PIPE-025巡检表·22 表清单口径后端 UNION ALL 固定 22 行商品/日销量/小时销量/广告日耗/广告SKU×日/广告活动/月度财务/订单明细/月度回款/月度退货/Noon产品月度/SKU映射/库存健康/BSR排名/物流船票/Keepa快照/推广渠道/ABA情报/供应商/PO单/Noon投放日表/Amazon投放日表;行数=count(*),数据截至=各表时间列 max(广告活动/SKU映射/供应商为 NULL)端点 tables 长度=22 且名称逐字生效
AC-EL-PIPE-026新鲜度·快照口径判定last=null → badge dim「快照」适用:广告活动 / SKU映射 / 供应商(后端显式 NULL)——不做天数判定三表行 badge=快照生效
AC-EL-PIPE-027新鲜度·月度表判定last 为 YYYY-MM(长 7):本月/上月 ok,更早 warn「滞后」适用:月度财务/月度回款/月度退货/Noon产品月度/ABA情报(max(mon)/max(period));与浏览器本地时区当前月比较(new Date()/getMonth(),pipeline/page.tsx:33-35——非 UTC,北京用户月末/月初边界会差一天口径)月度行 badge 口径抽测生效
AC-EL-PIPE-028新鲜度·日表阈值判定FRESH_OK_DAYS 表别阈值,age=now-last(UTC 日)日销量 3/小时销量 3/广告日耗 3/广告SKU×日 3/订单明细 4/库存健康 3/Keepa快照 3/BSR排名 4/物流船票 90/推广渠道 90,未列默认 30;age≤days → ok「n 天前」;≤3×days → warn;再超 → bad阈值表 vs 常量逐项生效
AC-EL-PIPE-029巡检脚注说明「月度表(财务/回款/退货/Noon)按月粒度判定;快照口径表(SKU 映射/广告活动/物流)不做新鲜度判定。表行数随 04:30 UTC 日更自动变化。」⚠ 文案-代码不一致:脚注称「物流」不做判定,但 FRESH_OK_DAYS 实含「物流船票: 90」(代码做判定仅阈值宽,90 天 ok/270 天 bad)——判定归属需拍板:改脚注或删物流阈值。

2026-10-22 换绿:拍板落地(2026-10-22 用户令"除了外部事件 都修",选改脚注对齐代码真值、行为不动):pipeline/page.tsx:212 改为「…快照口径表(SKU 映射/广告活动)无数据截至日、不做新鲜度判定;物流船票/推广渠道为低频表,按 90 天宽阈值判定(≤90 天前正常、≤270 天前预警、更久异常)」;API 侧实证=collab.py:246 表清单(广告活动/SKU映射 last=NULL→前端显「快照」确不判定;物流船票 max(ship_date) 日粒度走 FRESH_OK_DAYS 90 阈值);探针 PASS(新文案在场/旧文案清零)+frontend_e2e ALL PASS
物流船票行 badge 实际渲染 vs 脚注声明生效
AC-EL-PIPE-030骤降巡检块标题标题「⚠ 数量骤降巡检」红字 + 说明行说明「对比日 vs 前 7 日日均(广告按站点日 T+1 取 D-2),双门槛:降幅 ≥50% 且超绝对差下限」文案逐字生效
AC-EL-PIPE-031骤降表表格5 列:品牌/指标(· 表名小字)/7日日均/对比日/降幅降幅列红粗「-{drop_pct}%」;行 key=brand-table-metric行值 vs drops 端点生效
AC-EL-PIPE-032骤降空态空态「数量骤降巡检:近窗口无超阈值项。」drops 空数组时渲染正常日显示该行生效
AC-EL-PIPE-033骤降后端口径口径volume_drop_rows(metrics.py)品牌面=brands_source enabled+platform=amazon+source_map 非空;4 检查项:订单数(amazon_orders,lag1)/销量单(sales_hourly,lag1)/日销量件(sales_daily,lag1)/广告行数(ads_sku_daily,lag2);对比日=北京时区日-lag;双门槛 drop/base≥0.50 且 drop≥floor=max(2, min(mindiff, 30%×base))(2026-09-29 门槛自适应——固定绝对差≥10 漏小体量品牌整段断流,onno 订单基线日均~6 单实证);base≤0 无基线跳过(新管道免误报);onno 广告走 amazon_ads_daily 专表(pipe_domains.brand_override,查表失败同值兜底)SQL 复算 vs 页面行生效
AC-EL-PIPE-034排名巡检块标题标题「⚠ 排名分市场巡检」红字 + 说明行说明「各市场最新快照在榜数 vs 前 7 日日均(塌缩 ≤30%);停更按各市场自身节律判定,不被品牌级最新快照掩盖」文案逐字生效
AC-EL-PIPE-035排名表表格6 列:品牌/市场/最新快照/在榜(strong)/7日日均(muted)/异常(红 reason)noon 平台市场名前缀「Noon 」(如 Noon AE);lag>0 时最新快照后缀 warn 色「(停{lag}天)」;行 key=brand-platform-market行值 vs rank_markets 端点生效
AC-EL-PIPE-036排名空态空态「排名分市场巡检:各市场在榜数与快照节律正常。」rank_markets 空数组时渲染正常日显示该行生效
AC-EL-PIPE-037排名口径·塌缩口径在榜数塌缩判定n_now≤30%×avg7 且 avg7-n_now≥2 → reason 追加「在榜 {n_now} ← 7日均 {avg7}」;avg7=0 新市场跳过(BR/MX 首日入列属清单变更走需求单)SQL 复算(cleaned_rankings_daily)生效
AC-EL-PIPE-038排名口径·停更口径分市场停更判定lag>tol → 「快照停更{lag}天(同平台最新 {gmd}, 节律容忍{tol})」;tol=ceil(7/近7天快照天数)-1:日采市场(days7=7→tol=0)停 1 天即报,隔日采(zf noon days7=4→tol=1)不误报;2026-09-29 盲区修复——原品牌级 max(snap_date) 水位被最大市场掩盖(onno EU 停 10 天不报实证);KEEPA_SOURCE_DEAD 市场 reason 前缀「源断供(keepa 站点无数据, 非采集缺口): 」(metrics.py:270-273,2026-10-21 加入)——排名表异常列区分上游断供与采集缺口SQL 复算 tol/lag生效
AC-EL-PIPE-039排名口径·市场白名单口径amazon 域=RANKING_MARKETS 白名单2026-10-16 对齐 #49/#60,与采集器/_family_groups/排名页市场芯片同口径;白名单外(SE/BE/IE/PL/AE/SA/EU、UK→GB 归一、空 country)历史行保留但采集器永不更新不进巡检;白名单内 keepa 全空市场(zf CA/AU 代表 ASIN 疑下架)仍报——真实在榜变化属巡检职责;noon 平台不限白名单白名单常量 vs 巡检行市场集生效
AC-EL-PIPE-040外部生产工具卡标题标题h2「外部生产工具」+ sub「独立系统 · 各自账号体系」边界声明:与本平台账号不相通文案逐字生效
AC-EL-PIPE-041外部工具行列表行整行 a 外链(target _blank),左名称+↗+描述,右裸域名2 项(PIPELINE_EXTERNAL 常量):AI Listing 工厂(factory.zipforcetek.com,项目/SKU→标题/五点/A+/图片/视频 AI 生成与版本管理,需工厂账号)/ 工厂管道状态(factory.zipforcetek.com/pipeline,公开只读)行数/名称/域名 vs 常量生效
AC-EL-PIPE-042外部工具脚注说明「Listing 文案生成已内置于本平台(智能 → AI 助手 → 广告文案);工厂为独立生产工具(图片/视频/A+ 模块化生成),后续按租户需求评估是否产品化并入。」内置/外置边界声明文案逐字生效
AC-EL-PIPE-043词汇速查卡卡片GlossaryCard 子组件:「📖 电商词汇速查」+ sub「12 域 × {total} 词条 · 同源数据字典 · 完整版在 /dictionary」2026-09-24 用户令「加到 /pipeline」;fetch /api/glossary(credentials include);失败静默 catchsub 计数 vs glossary 端点 total生效
AC-EL-PIPE-044词汇速查搜索与结果筛选input「搜词条 / 英文 / 缩写(如 ACOS、IPI、FBN)」maxWidth 380term/en/abbr/desc/sys 五字段 lowercase includes;命中 slice(0,12) 上限 12 条;q 空不渲染结果区;结果表 5 列(词条 120/英文全称 180/缩写 90/释义/系统落点 200,minWidth 480);空命中「无匹配词条」过滤命中与 12 条上限抽测生效
AC-EL-PIPE-045后端·status 端点APIGET /api/pipeline/statuscurrent_user 门禁;22 表 UNION ALL(count+max 时间列)+ keepa_watch count(*) + drops(volume_drop_rows)+ rank_markets(rankings_market_rows)+ external(PIPELINE_EXTERNAL)+ as_of=date.today();metrics 两函数在租户连接上下文内执行(RLS 生效)端点 JSON vs 各源表直查生效
AC-EL-PIPE-046后端·audit 端点APIGET /api/pipeline/auditaudit_results 最新 batch_id(无批次→batch=null 触发前端空态);4 层固定序聚合 pass/fail/warn;趋势=8 天窗口按 batch GROUP BY(batch/日/fails/total);ISO-01(2026-10-14) 遮蔽:detail 含他租户品牌名→「(含他租户信息, 已遮蔽)」,check_key 内品牌名就地打码 ■(计数保留——平台健康面不因遮蔽失真)端点 vs audit_results 直查(含打码抽测)生效
AC-EL-PIPE-047后端·run 端点APIPOST /api/pipeline/run/{func_name}_require_admin 门禁(非管理员 403);func 必须在 PIPELINE_JOBS 注册集否则 404「未知任务 {func}」;经 ARQ Redis enqueue(SAAS_REDIS_URL,redis://redis:6379/0 兜底)异步执行不阻塞请求;audit 日志记 pipeline.run + job_id非 admin 403;未知 func 404;成功后 audit_log 有行生效
AC-EL-PIPE-048页面数据时序交互挂载即并行拉 status+audit 两端点(一次 useEffect)status 失败→错误横幅(AC-EL-PIPE-002);audit 失败→静默;无轮询/自动刷新——刷新页面才更新网络面板两请求各一次生效

§11.21 品牌主看板(/dashboard/[brand] · AC-EL-BRD-001…,源码 web/app/dashboard/[brand]/page.tsx 39 行 + components/BrandBoard.tsx 323 行 · API GET /api/dashboard/charts + /api/brandboard/orders + /api/brandboard/country-sku,routers/brandboard.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BRD-001路由页壳页壳动态路由 /dashboard/[brand],URL 段即 brandKey;AppShell title={brandLabel(brandKey)} Amazon 主看板,crumb=对齐 UVPVP 8 区块 · 数据源 /api/dashboard/charts + /api/brandboardtitle 展示名=fmt.brandLabel(brands_source.source_map.label 注入,H9 2026-10-13);title/crumb 为页面固定文案e2e 访问 /dashboard/zipforce 断言标题与面包屑生效
AC-EL-BRD-002未知品牌守卫卡守卫brandKey 不在本租户品牌列表时整页换居中卡:未知品牌 {brandKey} + muted 品牌不存在或无权访问 · 从工作台进入(Link → /)合法性=useBrand().brands(本租户注册品牌)——铁律①租户/品牌绝对独立;P3 缺陷⑱(2026-10 修):原文案列全品牌名单泄露他租户品牌名,改后不列名单e2e 访问 /dashboard/他租户品牌名 断言守卫卡且页面无品牌名单生效
AC-EL-BRD-003主体挂载组件挂载通过守卫后渲染 <BrandBoard brandKey brandLabel={brandLabel(brandKey)} />BrandBoard 为共享组件:独立路由(自治时间窗)与工作台内嵌(compact 受控)同一主体;展示名经 fmt.brandLabel代码走查 + e2e 工作台品牌区展开与独立页数据一致生效
AC-EL-BRD-004时间窗预设组按钮组标题条内 7天/30天/90天/全部 tab,选中 on 高亮;ownDays 默认 90「全部」=3650 天;compact 模式不渲染按钮组,改显提示 窗口随顶部时间选择器 · 近 {N 天|全部}(受控 props days/from/to/country)e2e 点 7天 断言请求 days=7;compact 内嵌断言无按钮组生效
AC-EL-BRD-005独立区间→拖尾天数语义卡片独立日期区间换算天数:round((end−start)/86400000)+1clamp 1..3650;非法区间(NaN/end<start)回落全局窗口;独立区间仍是拖尾天数语义代码走查 + e2e 卡片选 2026-10-01→2026-10-08 断言按 8 天窗口请求生效
AC-EL-BRD-006墙数据加载APIGET /api/dashboard/charts?brand&platform=amazon&country&days(有精确区间时 +frm/to)返回 Wall{groups, kpis, chart_count, range, empty};失败→err 横幅;命中缓存不重复请求e2e 断言请求参数;API 报错注入断言横幅生效
AC-EL-BRD-007墙缓存缓存内存 cache 按 {days}|{from}|{to}|{country} 键brandKey 变更即整体清空(内嵌实例不重挂载,不清则永远旧品牌);country 已入缓存键(2026-09-16 修「切国家看板不变」)e2e 同窗切换国家断言新请求;切品牌断言无旧数据残留生效
AC-EL-BRD-008错误横幅横幅.error role=alert,置顶显示墙加载错误文本仅墙加载失败触发;数据表错误不触发(各自静默)e2e 断言 role=alert生效
AC-EL-BRD-009标题条标题条{brandLabel} + 时间窗组(或 compact 提示)+ 加载中…(loading 时)+ 右缘计数单卡布局;品牌展示名与守卫口径一致e2e 断言品牌名与加载态生效
AC-EL-BRD-010#brandboard-count计数条右缘 {chart_count} 图 · {range.orders} 单({from} → {to})2026-10-01 像素审计P3:from/to 均 null 时省略括号段(原渲染「( → )」箭头残片);未加载=—e2e 空品牌断言无「( → )」残片生效
AC-EL-BRD-011KPI 卡×5KPI 卡订单(foot {units} 件)/营收 USD(foot 客单价 ${aov})/净利 USD(foot 利润率 {margin}%)/费用 USD(foot 已回款 ${settled})/取消率 %(foot 区间 {from} → {to})值=wall.kpis(/api/dashboard/charts);订单口径=有效订单剔取消、取消率分母=全量订单(AC-CAL-02);compact 内嵌不渲染(由工作台 KPI 区承担)e2e 断言 5 卡标签与 foot;SQL 复核对 AC-CAL-02生效
AC-EL-BRD-012空墙卡空态卡wall.empty 时整板换居中卡 该品牌窗口内无订单数据 + 试试「全部」窗口,或检查采集管道empty 由 API 判定(窗口内无订单);空墙时不渲染图组/表格/导航e2e 空窗口品牌断言空态卡生效
AC-EL-BRD-013错误引导卡错误卡墙从未加载且已报错(!wall && err)时整板换 无法加载该品牌看板 + {err} · 请从工作台品牌区进入P3 缺陷㊴(2026-10-01 修):brandboard/* 的 catch(()=>{}) 吞错导致骨架永卡、订单表空分页「第1/1页·0条」误导;墙失败即整板引导卡不再渲染残板e2e 403 品牌(他牌)断言引导卡而非骨架生效
AC-EL-BRD-014锚点导航锚点导航每组一个 tab {g.label} {n} → #sec-{g.key},末尾固定 📋 数据表格 → #sec-tables组集=wall.groups(API 返回,对齐 UVPVP 8 区块);图数=组内 charts.lengthe2e 断言锚点跳转与组标签生效
AC-EL-BRD-015图组区块区块每组 <section id="sec-{g.key}">,h2 {g.label} + sub {n} 图 · 卡片可拖拽排序(🔓 状态),排序按账号记忆组与图由 /api/dashboard/charts 返回(8 区块 81 图口径,逐图条目见 §11.1 工作台图表条目同源)e2e 断言区块标题与 sub 文案生效
AC-EL-BRD-016ChartGrid 拖拽持久化持久化每组独立 ChartGrid,pageKey=/dashboard/{brandKey}:{g.key}拖拽排序按账号持久化(user_dashboard_prefs);pageKey 区分独立页与工作台内嵌(内嵌 pageKey 见 §11.1)e2e 拖拽后刷新断言顺序保持生效
AC-EL-BRD-017ChartCard 标题图表卡标题title=CHART_TITLES[c.key]?.title ?? c.key标题字典=lib/chartTitles;无字典项时裸 key 兜底e2e 断言卡标题生效
AC-EL-BRD-018ChartCard 副题图表卡副题sub=spec.hint 优先 → CHART_TITLES 静态 hint 兜底;spec.sub 为日期形态时追加 · 数据日 {YYYY-MM-DD}P3 缺陷⑯(2026-10 修):hint 优先 API 动态值(本租户真前三),静态表仅兜底e2e 断言副题含数据日生效
AC-EL-BRD-019空图兜底空图兜底spec 缺失时 option=EMPTY_OPT(居中「暂无数据」)P3 缺陷⑰(2026-10 修):原为裸空坐标系 {series:[]} 误导e2e 空图断言「暂无数据」生效
AC-EL-BRD-020ChartCard CSV导出csvName={brandKey}_{c.key},内容由 specCsv 生成(pie=项/值;直角=维度+各系列)独立区间生效时用独立 spec,否则用原始 ce2e 下载断言文件名与首行表头生效
AC-EL-BRD-021ChartCard 独立区间区间选择每卡 range 下拉(默认 global,globalLabel=当前窗标签);选区间→onCardRange 按换算天数加载对应窗口墙并取同 key 图独立区间未加载时回落全局 spec;语义同 BRD-005e2e 卡片选区间断言新墙请求与卡内数据变化生效
AC-EL-BRD-022订单明细表容器表格容器DataTable:GET /api/brandboard/orders?brand&days(+frm/to/country)&page&page_size=20;loading=!ord;empty=无数据;分页条 page/pages/total行键=oid;失败静默(catch(()=>{}),墙层已兜错误面);随 brandKey/days/区间/country/页码联动e2e 翻页断言 page 参数;断言 20 行/页生效
AC-EL-BRD-023订单列·Order ID列订单号,文本筛选源字段 oid;rowKey 同源e2e 列头筛选断言过滤生效
AC-EL-BRD-024订单列·Date列下单日期源字段 date;表整体按下单时间倒序(API 排序)e2e 断言首行日期≥末行生效
AC-EL-BRD-025订单列·Country列国家代码,文本筛选源字段 countrye2e 筛选 US生效
AC-EL-BRD-026订单列·Currency列本币币种,文本筛选源字段 currency(List Price 的币种)e2e 断言币种与 List Price 对应生效
AC-EL-BRD-027订单列·Status列订单状态,文本筛选源字段 status(含取消态,本表为全量明细非剔取消口径)e2e 筛选 Cancelled生效
AC-EL-BRD-028订单列·List Price列挂牌价,右对齐,数值筛选=本币金额(无挂牌价源)——见 BRD-037 口径脚注e2e 断言与 Currency 同币种生效
AC-EL-BRD-029订单列·Price列成交金额,右对齐加粗,数值筛选源字段 revenue_usd(折 USD)e2e 断言加粗样式与数值生效
AC-EL-BRD-030订单列·Promotion列促销金额,右对齐,数值筛选源字段 promo(折 USD)e2e 断言列存在生效
AC-EL-BRD-031订单列·Commission列佣金,右对齐,数值筛选源字段 commission(折 USD)e2e 断言列存在生效
AC-EL-BRD-032订单列·FBA Fees列FBA 费用,右对齐,数值筛选源字段 fba(折 USD)e2e 断言列存在生效
AC-EL-BRD-033订单列·Settlement列回款状态,文本筛选取值=已回款/已退款+已回款(见 BRD-037);非金额列e2e 筛选 已回款生效
AC-EL-BRD-034订单列·Settled列回款金额,右对齐,数值筛选源字段 settled(折 USD);KPI「已回款」同源(BRD-011 foot)e2e 断言与 KPI 已回款一致生效
AC-EL-BRD-035订单列·Rate%列汇率,右对齐,数值筛选源字段 rate(本币→USD 换算率)e2e 抽一行核 List Price×Rate≈Price生效
AC-EL-BRD-036订单列·SKUs列订单内 SKU 列表,文本筛选;超 22 字符截断加 …,title 悬停显全文源字段 skus(拼接串);CSV 导出含全文e2e 长串断言截断与 title生效
AC-EL-BRD-037订单明细口径脚注口径脚注表底固定:订单明细表口径(UVPVP 14 列):金额=折 USD(费用为折 USD)|按下单时间倒序|List Price=本币金额(无挂牌价源)|Settlement=回款状态(已回款/已退款+已回款)|数据源=cleaned_amazon_orders + order_fees。14 列=BRD-023…036;卡片 sub 同口径缩写版;口径与 AC-CAL-02 不冲突(本表=全量明细,KPI=汇总剔取消)e2e 断言脚注全文;SQL 对 cleaned_amazon_orders 复核生效
AC-EL-BRD-038订单明细导出导出exportCsv/exportExcel 均为 {brandKey}_orders导出内容=当前筛选/排序结果全量列(含 SKUs 全文)e2e 下载断言文件名与行数生效
AC-EL-BRD-039Country/SKU 表容器表格容器DataTable:GET /api/brandboard/country-sku?brand&days(+frm/to/country)&limit=200;loading=!cs.length && !wall;empty=无数据;行键=country+sku无分页(limit=200 截断);失败静默(墙层兜错误面)e2e 断言 200 上限与列头生效
AC-EL-BRD-040C/S 列·Country列国家代码,文本筛选分组维度=国家×SKUe2e 断言分组正确生效
AC-EL-BRD-041C/S 列·SKU列SKU,文本筛选SKU 宇宙事实源=sku_mapping(不另造清单)e2e 筛选已知 SKU生效
AC-EL-BRD-042C/S 列·Qty列件数,右对齐,数值筛选按订单内 SKU 数均摊(见 BRD-045)SQL 复核均摊合计=订单件数生效
AC-EL-BRD-043C/S 列·Revenue (Local)列本币营收,右对齐,数值筛选源字段 rev_local;均摊口径同上e2e 断言与 Country 币种一致生效
AC-EL-BRD-044C/S 列·Revenue (USD)列美元营收,右对齐加粗,数值筛选源字段 rev_usd;均摊口径同上e2e 断言加粗与折算一致生效
AC-EL-BRD-045Country/SKU 口径脚注口径脚注表底固定:Country/SKU 汇总表口径:金额=折 USD|件数与金额按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径)|按国家×SKU 分组。卡片 sub 同口径缩写版;近似口径声明为恒定标准(items 级 ingest 落地前不改)e2e 断言脚注全文生效
AC-EL-BRD-046Country/SKU 导出导出exportCsv/exportExcel 均为 {brandKey}_country_sku导出内容=当前 200 行内筛选结果e2e 下载断言文件名生效

§11.21(续) Noon 品牌主看板(/dashboard/noon/[brand] · AC-EL-BRDN-001…,源码 web/app/dashboard/noon/[brand]/page.tsx 39 行 + components/NoonBoard.tsx 248 行 · API GET /api/brandboard/noon + /api/noon-inventory,routers/brandboard.py L141/L428)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BRDN-001路由页壳页壳动态路由 /dashboard/noon/[brand];AppShell title={brandLabel} Noon 主看板,crumb=对齐 UVPVP Noon(按日) · FBN 预警联动 /inventory展示名=fmt.brandLabel(H9 2026-10-13 注册表注入)e2e 访问断言标题与面包屑生效
AC-EL-BRDN-002未知品牌守卫卡守卫brandKey 不在合法集时居中卡 未知品牌 {brandKey} + 品牌不存在或无权访问 · 从工作台进入合法性=(info.noon_brands ∩ useBrand().brands)——noon 注册表品牌且属本租户(H9 2026-10-13:散写 noon 品牌名单已删);守卫文案缺陷⑱同款修复(不列名单)e2e 访问非 noon 品牌断言守卫卡生效
AC-EL-BRDN-003主体挂载组件挂载通过守卫后渲染 <NoonBoard brandKey brandLabel />NoonBoard 为共享组件(2026-09-15 抽出):独立页自治窗口;工作台内嵌 compact 受控(days/from/to/country),数据/交互/ChartGrid pageKey 两态一致代码走查 + e2e 两态数据一致生效
AC-EL-BRDN-004时间窗预设组按钮组7天/30天/90天/全部 tab;ownDays 默认 90「全部」=3650;compact 不渲染按钮组,显 窗口随顶部时间选择器 · 近 {N 天|全部}e2e 点窗断言 days 参数生效
AC-EL-BRDN-005独立区间→拖尾天数语义round((end−start)/86400000)+1,clamp 1..3650非法区间回落全局;与 BRD-005 同实现同语义代码走查生效
AC-EL-BRDN-006墙数据加载APIGET /api/brandboard/noon?brand&days&country(+frm/to)返回 Wall{groups, kpis, chart_count, range, empty};失败→err 横幅e2e 断言请求与渲染生效
AC-EL-BRDN-007墙缓存缓存内存 cache 键 {days}|{from}|{to}|{country};brandKey 变更整体清空与 BRD-007 同实现;内嵌实例切品牌不残留旧数据e2e 切品牌断言无残留生效
AC-EL-BRDN-008错误横幅横幅.error role=alert 置顶显示墙错误仅墙加载失败触发e2e 注错断言 role=alert生效
AC-EL-BRDN-009标题条标题条{brandLabel} · Noon + 时间窗组(或 compact 提示)+ 加载中… + 右缘计数布局与 BRD-009 同构e2e 断言文案生效
AC-EL-BRDN-010#noonboard-count计数条{chart_count} 图 · {range.orders} 件({from} → {to})单位=件(Noon 件级口径);2026-10-01 像素审计P3:from/to 均 null 省略括号段;未加载=—e2e 空墙断言无残片生效
AC-EL-BRDN-011空墙卡空态卡该品牌窗口内无 Noon 数据 + 试试「全部」窗口,或检查采集管道empty 由 API 判定;空墙时不渲染图组/审计卡e2e 空品牌断言空态卡生效
AC-EL-BRDN-012KPI 卡×4KPI 卡窗口订单(件)(foot 最新日 {last_day_orders} 件)/取消率 %(foot CIR 率 {cir_rate}%)/最新月 GMV $(foot 折 USD · 月度结算口径)/最新月利润 $(foot 结算净额−广告)值=wall.kpis;金额卡显式标注月度口径(Hub 无 Noon 日级金额源的已知偏差,卡内注明=恒定要求);取消率口径 AC-CAL-02;compact 内嵌不渲染 KPI 行(仅 FBN 卡常驻)e2e 断言 4 卡与月度口径脚注生效
AC-EL-BRDN-013FBN 库存预警卡KPI 卡id=nsec-fbn;k-value=FBN 总库存;foot=🔴 {urgent} · 🟡 {watch} · 🟢 {ok} · 缺口 {shortage_units}u · {period_days}d(快照 {snapshot}) 或 暂无快照(等待每日 08:00 采集);尾链 明细 → → /inventoryGET /api/noon-inventory?brand(brandLabel 就绪后拉取);urgent>0 卡边框转 danger 红;compact 与全屏两态均渲染(UVPVP 同位)e2e 断言分级数与 /inventory 链接;urgent>0 断言红边生效
AC-EL-BRDN-014锚点导航锚点导航每组 tab {g.label} {n} → #nsec-{g.key}组集=wall.groups(核心指标/销售/订单状态/财务/国家/SKU+广告 对齐 UVPVP Noon)e2e 断言锚点生效
AC-EL-BRDN-015图组区块区块每组 <section id="nsec-{g.key}">,h2 + sub {n} 图 · 卡片可拖拽排序(🔓 状态),排序按账号记忆组与图由 /api/brandboard/noon 返回e2e 断言区块文案生效
AC-EL-BRDN-016ChartGrid 拖拽持久化持久化pageKey=/dashboard/noon/{brandKey}:{g.key}账号级记忆,与内嵌实例共用同 pageKey(两态排序互通)e2e 拖拽刷新断言保持生效
AC-EL-BRDN-017ChartCard 标题图表卡标题title=CHART_TITLES[c.key]?.title ?? c.key与 BRD-017 同源字典e2e 断言标题生效
AC-EL-BRDN-018ChartCard 副题图表卡副题sub={EN[c.key] 原图名}{ · hint};无 EN 项时仅 hintEN 名册=32 个墙 key(NoonBoard.tsx L39-54 实数)→UVPVP 英文原图名(nDailyOrders→Daily Orders … nCpsTrend→Ad Spend per Order (CPS),验收台账对照);月度替代图(nMonthlyAov/nSettleRate/nMonthlyProfit)原图名内含 → Monthly 标注偏差e2e 断言副题含英文原图名生效
AC-EL-BRDN-019空图兜底空图兜底spec 缺失→EMPTY_OPT 居中「暂无数据」P3 缺陷⑰同款修复(原裸空坐标系)e2e 空图断言生效
AC-EL-BRDN-020ChartCard CSV导出csvName=noon_{brandKey}_{c.key}specCsv 同 BRD-020 实现e2e 下载断言文件名生效
AC-EL-BRDN-021ChartCard 独立区间区间选择range 下拉默认 global;选区间按换算天数加载对应墙取同 key 图,未加载回落全局语义同 BRD-005/BRD-021e2e 选区间断言数据变化生效
AC-EL-BRDN-022数据审计说明卡说明卡id=nsec-audit;五条口径声明:①订单/状态/CIR/取消/时段=noon_orders 件级按日(92 天滚动窗,每日 04:30 ingest)②金额类(GMV/结算/费用/利润/广告 ROI)=月度结算口径折 USD——Hub 无 Noon 日级金额源,UVPVP 的 Daily GMV/AOV/Profit/SettlementRate 以月度替代(图题已标注)③利润=结算净额−广告(与工作台 Noon 月墙同口径,唯一实现)④广告日趋势(CTR/CVR/CPS/花费)=noon_ads_daily;SKU 级广告=noon_sku_ads 月表 ⑤FBN 库存=fbn_inventoryv2_aging 最新快照(SALEABLE 口径),92 天销速分级 35d/90d 线UVPVP 同位卡;月度替代为已声明恒定偏差(非缺陷),落库口径以本卡文字为准e2e 断言五条全文;SQL 对 noon_orders/noon_ads_daily 复核生效

§11.22 品牌入驻向导(/onboarding · AC-EL-ONB-001…,源码 web/app/onboarding/page.tsx 310 行 · API routers/onboarding.py L42-L269;铁律核心场景:租户/品牌创建 + 注册表级联)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ONB-001页壳页壳AppShell title=品牌管理,crumb=开户自动化 · 注册表驱动 · 新品牌/新产品零建表零发版三块(web/库/采集)以注册表为合同:本页只写注册表与主数据,管道与健康由注册表驱动,零 LLMe2e 断言标题与面包屑生效
AC-EL-ONB-002元数据加载APIGET /api/onboarding/meta → platforms/marketplaces/categories/tenant_brands/brands_source失败→toast err;tenant_brands=本租户品牌(铁律①,RLS 限定)e2e 断言选项渲染生效
AC-EL-ONB-003管道健康加载APIGET /api/onboarding/pipeline → pipelines(水位表数据源)失败静默 catch(()=>{})(表显空态,不阻断向导)e2e 断言表渲染生效
AC-EL-ONB-004三步向导步骤头步骤头stepHead(n):22px 圆号(当前=品牌色/其他=边框色)+标题;step>n 显 ✓步骤 1 品牌与平台 / 2 类目与 SKU 导入 / 3 完成态;step 只进不退(再接入按钮重置)e2e 断言步骤流转与 ✓生效
AC-EL-ONB-005品牌标识输入输入input placeholder=品牌标识(小写字母/数字, 如 mybrand);提交时 trim().toLowerCase()服务端 _BRAND_RE:2-31 位小写字母/数字/-/_,字母或数字开头,违者 400 品牌名 2-31 位, 小写字母/数字/-/_, 字母或数字开头;空值前端 toast 请填写品牌名e2e 提交非法名断言 400 文案生效
AC-EL-ONB-006已有品牌补登记下拉下拉仅 tenant_brands 非空渲染;占位 选择已有品牌补登记…,选项=本租户品牌选中即回填品牌输入框;名单=meta.tenant_brands(本租户口径,铁律①)e2e 断言仅本租户品牌可选生效
AC-EL-ONB-007平台多选 tab 组多选meta.platforms 渲染 tab {name} · {ads_model},选中 on;可多选可取消提交前空选 toast 请至少选择一个平台;服务端校验 platform∈platforms(active),未开放 400 平台未开放: {p}e2e 空选提交断言 toast生效
AC-EL-ONB-008店铺账号输入输入可选;placeholder=如 zf-us-main(多店铺区分用)填写时随品牌提交 channels(每平台一条,marketplace 取该平台首个选中站点);留空则不带 channelse2e 填写提交断言 brands_source/brand_channels 落库生效
AC-EL-ONB-009直营/代卖下拉下拉mode 选择:直营=direct / 代卖=consignment铁律②直营/代理区分的登记入口;服务端 mode 仅 direct/consignment,违者 400 mode 仅 direct/consignment: {v};写入 brand_channels.modee2e 两 mode 提交断言落库值生效
AC-EL-ONB-010经营站点多选多选仅唯一平台选中时渲染;activeMks=marketplaces 按该平台过滤;tab {country} {currency} 可多选服务端校验 (platform,country)∈marketplaces,坏站点 400 平台 {p} 无站点: {列表};多平台时隐藏(站点仅单平台语义)e2e 双平台断言隐藏;单平台勾选断言提交生效
AC-EL-ONB-011登记品牌按钮按钮登记品牌, 下一步(busy=登记中…);POST /api/onboarding/brandbody={brand, entries[{platform, marketplaces}], channels?};成功 toast 品牌已登记(,下一步导入 SKU)→step2+meta/pipeline 重载e2e 提交断言 toast 与步骤流转生效
AC-EL-ONB-012跨租户品牌占用防线防线(铁律)ISO-08 铁律修复(2026-10-17):品牌名是全局命名空间(products 主键 (brand,sku) 无租户维度),已被其他租户持有的品牌 409 该品牌已被其他租户持有, 无法自助注册; 如需跨租户共享请联系平台管理员查重走 saas_admin 直连(tenant_brands FORCED RLS,portal 请求上下文看不见外租户行);受控共享(如 onno 演示镜像)走管理员手工登记;修复前任意租户可用同名 SKU 覆写他租户主数据(实测复现)e2e 租户 B 注册租户 A 已持品牌断言 409生效
AC-EL-ONB-013登记级联(单事务四连)级联(铁律)铁律③级联自动生成:①tenant_brands 品牌授权插入(RLS WITH CHECK 仅本租户,已存在跳过)②brands_source 注册表 upsert(冲突 (tenant_id,brand,platform) 时 UPDATE marketplaces/collector/note 且 enabled=true)③inv_warehouses 无仓则种子 MAIN 主仓 ④brand_channels 渠道 upsert(冲突 (tenant_id,brand,platform,marketplace,account) 时 UPDATE mode/note 且 enabled=true)一个事务完成 品牌授权+管道注册+默认仓种子+审计;幂等=重复提交即更新注册;全程 _prov 置备事件 + audit(onboarding.brand)e2e 新品牌提交后 SQL 断言四表级联落库生效
AC-EL-ONB-014管道自动装配声明文案响应 hint=品牌已登记; 采集管道将于注册表驱动下自动装配(P2), 数据到位后全站页面自动带出;step3 文案=采集管道按注册表自动装配(P2 接管),数据回流后订单/广告/财务分析自动带出——全程无需任何前端发布注册表=brands_source 是采集装配的合同;hint 非空时 toast 追加「,下一步导入 SKU」e2e 断言 hint 文案生效
AC-EL-ONB-015步骤1回显文案step>1 时卡内显 {brand} · {plats 以 " / " 连接} · 站点 {逗号列表|全部}回显已登记选择,不可再编辑(重走需 step3 重置)e2e 断言回显生效
AC-EL-ONB-016类目下拉下拉选项=meta.categories(value=category 显 name)+ 固定尾项 ➕ 新建类目…(__new__)选已有→setCategory;选 __new__→展开新建面板e2e 断言选项与面板切换生效
AC-EL-ONB-017默认站点下拉下拉占位 默认站点(空值)+ activeMks 选项值随 SKU 导入提交 country;多平台时 activeMks 为空(同 ONB-010 单平台语义)e2e 断言选项生效
AC-EL-ONB-018新建类目标识/名称输入标识 placeholder=标识(英文, 如 fishing);名称 placeholder=名称(如 渔具)前端校验 /^[a-z][a-z0-9_]{1,29}$/,违者 toast 类目标识: 小写字母开头, 2-30 位字母/数字/_;空名 toast 请填写类目名称;服务端 category 2-30 同 pattern、name 1-20e2e 非法标识断言 toast生效
AC-EL-ONB-019类目属性行输入组每行:key(placeholder key(英文))/名称/类型下拉(文本=text/数字=number/单选=select)/单位(≤8 字符)/select 时选项输入(placeholder 选项,逗号分隔,split /[,,、]/ trim 去空)/必填 checkbox服务端 AttrDef:key 1-32 ^[a-z][a-z0-9_]*$、label 1-20、type 无枚举校验(type: str="text" 默认,text/number/select 三值仅前端下拉约束,API 直调可传他值,onboarding.py:165)、unit≤8、options≤20 项、required 布尔;attrs≤20 条;留空 key/label 的行忽略e2e 构造 select 类目含选项断言落库生效
AC-EL-ONB-020加属性/保存类目按钮按钮+ 加属性(追加空行);保存类目→POST /api/onboarding/categorybody={category, name, attrs};成功 toast 类目已保存、自动选中新类目、meta 重载;busy 期间禁用e2e 保存断言下拉出现新类目生效
AC-EL-ONB-021类目属性提示文案选中类目有 attr_schema 时显 类目属性: {label}{必填加 *} · … — 属性可经 API attrs 字段导入引导 API 导入路径(attrs 字段);general 等无属性类目不显e2e 选有属性类目断言提示生效
AC-EL-ONB-022SKU 粘贴框输入textarea rows=8,placeholder=每行一条: SKU, 品名, ASIN, 成本RMB 例: BN-001, BrainNews 智能台灯, B0XXXXXXXX, 45.5;等宽字体行分隔 /\n+/;列分隔 /\t|,/(制表符或逗号);列序=SKU,品名,ASIN,成本RMBe2e 粘贴样例断言解析生效
AC-EL-ONB-023即时解析规则校验逐行解析:缺 SKU 行整体丢弃(filter(r=>r.sku),page.tsx:59——err=缺 SKU 赋值后即被滤掉从不显示,系死代码);成本缺省容忍(0);成本为负标 err=成本为负badRows=err 行计数;err 行仍入预览(红字)但阻断提交(实际仅「成本为负」触发红字/阻断)e2e 负成本行断言红字与阻断生效
AC-EL-ONB-024解析预览表表格解析 {N} 行(有误时追加红字 · {n} 行有误);表 4 列 SKU/品名/ASIN/成本RMB;最多显前 50 行(maxHeight 200 滚动);err 行红字预览≠提交集(50 行截断仅显不截断提交)e2e 60 行粘贴断言 50 行显示、按钮显 60生效
AC-EL-ONB-025导入 SKU 按钮按钮导入 {N} 个 SKU(busy=导入中…);POST /api/onboarding/skus空清单 toast 请先粘贴 SKU 清单;有误行 toast 有 {n} 行无法解析,请修正;body={brand, platform: plats[0], country, category, rows[{sku,title,asin,cost_rmb}]};成功 setDone(imported)→step3e2e 导入断言 imported 数与 step3生效
AC-EL-ONB-026步骤3完成态完成态✓ 已导入 {imported} 个 SKU + 说明(商品页 /products 链接与工作台品牌筛选立即可见;管道自动装配文案)级联效果声明:主数据入库即全站可见,数据回流后分析自动带出e2e 导入后断言完成态文案与 /products 可见生效
AC-EL-ONB-027再接入一个品牌按钮按钮step3 显 再接入一个品牌;点击重置 step/brand/plats/csv/done→步骤1mks/category/account 不重置(保留上次选择)e2e 点击断言回到步骤1且品牌输入为空生效
AC-EL-ONB-028品牌管道健康表表格h2 品牌管道健康 sub 注册表驱动 · 水位实时 · 断更 > 2 天标红;列=品牌/平台/6 水位列/状态水位列=WM_LABELS:订单=amazon_orders、广告(SKU)=ads_sku_daily、广告(活动)=amazon_ads_daily、Noon广告=noon_ads_daily、财务=finance_monthly、小时销=sales_hourly;行=brands_source 注册的品牌×平台e2e 断言表头与注册行生效
AC-EL-ONB-029水位单元格单元格显 watermark 原值(空=—);daysSince>2 红字+⚠daysSince=now−watermark 天数;YYYY-MM 形态补 -28 计月龄;每列独立判红e2e 断旧水位标红生效
AC-EL-ONB-030状态列单元格三态:未启用(enabled=false,灰)/断更 {days} 天(红,加粗)/正常(绿,加粗)days=该行全部水位 daysSince 最大值(空水位不计;Math.max(0,…,-1) 含字面 0,实际下限 0,-1 仅为空集兜底,page.tsx:288);判红线=2 天e2e 构造断更行断言红态生效
AC-EL-ONB-031空管道行空态pipelines 空 时单行 暂无注册品牌管道(colSpan=10,居中)新租户/接口静默失败共用户面e2e 新租户断言空态行生效

§11.22(续) 注销冷静期(/offboarding · AC-EL-OFB-001…,源码 web/app/offboarding/page.tsx 80 行 · API routers/org.py L252-L295(offboard@252、restore@280,全文 295 行)+ core.py OFFBOARD_COOLDOWN_DAYS;铁律核心场景:不可误删)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFB-001页面形态页壳不挂 AppShell;独立居中卡(min(460px,100%),全屏 flex 居中)#62(2026-10-10):offboarding 租户的中间件只放行 login+restore 两条 API,本页不得发起任何其他数据请求(AppShell 的 /api/me 等探测会 404)e2e offboarding 租户访问断言渲染且网络面板无其他 API生效
AC-EL-OFB-002query 参数吸收交互挂载时从 URL query 读 due(届满日期)与 just=1(刚发起)来源两路:登录自救(login 响应)或团队页危险区发起注销(offboard 响应)由入口带入e2e 带 due/just 访问断言渲染生效
AC-EL-OFB-003警示图标+标题图标44px 红底圆角「!」图标 + h1 注销冷静期 + 租户已停止服务,数据已完整归档danger 色变量(fallback #c0392b)e2e 断言标题与图标生效
AC-EL-OFB-004just 横幅横幅just=1 时 ok-banner role=status:注销已发起:全部数据归档完成,子域与全员会话已停用。仅刚发起路径渲染;与恢复路径(无 just)互斥e2e ?just=1 断言横幅生效
AC-EL-OFB-005冷静期说明三行文案①本租户处于 30 天注销冷静期,期间数据只读封存、业务面已停用 ②届满日期 {due | 自注销发起日起 30 天},届时数据将被永久清除 ③冷静期内业主可随时一键恢复,数据与账号原样回归,无任何损失OFFBOARD_COOLDOWN_DAYS=30(core.py L423,auth 共享);due 由服务端 purge_due 传入e2e 断言三行文案与 due 日期生效
AC-EL-OFB-006恢复按钮(恢复路径)按钮恢复租户,撤回注销(busy=恢复中…);POST /api/org/tenant/restore成功→info 横幅 已恢复,正在进入工作台…+router.replace(/);失败→err 横幅;服务端:status offboarding→active、suspended_at 置空、审计 tenant.offboard.restore(cooled=N d);非 offboarding 409 不在注销冷静期, 无需恢复;_require_admine2e 冷静期租户点恢复断言回 active 可进工作台生效
AC-EL-OFB-007重新登录后可恢复按钮(just 路径)按钮just=1 时改显 a.btn 重新登录后可恢复(href=/login)+ 说明 注销时全员会话已吊销——登录后会被自动带回本页,再点「恢复租户」即可撤回。会话已吊销故不能直接恢复;登录后被中间件带回本页走 OFB-006e2e ?just=1 断言登录按钮与说明生效
AC-EL-OFB-008权限说明脚注文案恢复需要 owner / admin 权限;如你不是业主,请联系业主在本页操作。审计记录(注销/恢复)永久留存。与 _require_admin 服务端契约一致;审计永久留存=不可误删的反向保障e2e 断言脚注;SQL 断言审计行生效
AC-EL-OFB-009err/info 横幅横幅err=.error role=alert;info=.ok-banner role=status恢复失败/成功两条反馈通道;busy 期间按钮禁用e2e 注错断言 role=alert生效
AC-EL-OFB-010注销前置归档(不可误删铁律)契约(铁律)POST /api/org/tenant/offboard:归档→offboarding→吊销全员会话;归档是清除的前置铁条件,任何一步失败则 status 不动confirm 必须回显本租户 slug(400 confirm 必须回显本租户 slug);已 offboarding 409 已在注销冷静期;非 active 409 当前状态 {s} 不可发起注销;_archive_tenant 逐表 COPY 写 gzip SQL 流+sidecar manifest(逐表行数),gzip 魔数+尺寸校验不过即抛错;吊销全员会话;审计 tenant.offboard(archive/rows/cooldown)e2e 发起注销断言归档文件生成+审计行;破坏归档断言 status 不变生效
AC-EL-OFB-011归档去向归档_archive_tenant 落盘 /srv/offboarding/{slug}/{slug}-archive-{YYYYmmdd-HHMMSS}.sql.gztenant_conn RLS + 显式 tenant_id 过滤双保险逐表导出;备份长期去向(含届满清除后留存策略)2026-10-18 用户待拍板挂账(隔离审计 VII),未拍板前不得迁移/清理该目录。

2026-10-22 对账闭环:留存策略已由 #63(2026-10-10 用户拍板「那就优化好」)落地——api/tasks.py ARCHIVE_RETENTION_DAYS=90,offboarding_archive_retention 每日 07:17 对非 offboarding 租户的满 90 天归档整目录回收并写 tenant.archive.retire 审计;/srv/offboarding 当前不存在=零注销常态(audit_log tenant.offboard*/archive.retire 0 行,tenants 3 全 active);目录由 org.py _archive_tenant makedirs 按需创建。2026-10-18 挂账系与 #63 未对账之重复挂账,据此换绿
ls /srv/offboarding/{slug}/ 断言文件与 manifest 行数生效
AC-EL-OFB-012届满物理清除声明契约purge_due=发起时刻+30 天(随 offboard 响应下发为本页 due);届满数据将被永久清除,无手工捷径本条为页面文案+org.py 契约声明;届满清除执行器在管道/cron 侧(非本页源码),其条目归管道章节e2e 断言 due=发起日+30;清除执行器另册验证生效
AC-EL-OFB-013双向审计留存审计注销=tenant.offboard(archive 文件名/rows/cooldown);恢复=tenant.offboard.restore(cooled=N d)审计永久留存,恢复不删注销记录(追加式);与 OFB-008 脚注互证SQL 断言双向审计行齐备生效

§11.23 认证四页(/register /login /verify /welcome · AC-EL-AUTH,源码 web/app/register/page.tsx 120 行 + login/page.tsx 80 行 + verify/page.tsx 56 行 + welcome/page.tsx 132 行 + web/components/RegGate.tsx 23 行,后端 api/routers/auth.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-AUTH-001注册门 RegGate(页面级)守卫/register 整页内容外包 RegGate,注册关闭时显示关闭文案,页面路由本身保留可见机制:客户端挂载后 fetch /api/auth/registration-status(credentials include),open=false → 渲染 closedText「注册暂未开放,如需开通请联系 support@zipforcehub.com」;接口异常/拿不到状态 → 放行显示原入口(fail-open,API 层 403 兜底);开关真值=运行时 SAAS_REGISTRATION_OPEN,营销页预渲染读不到构建时 env读 web/components/RegGate.tsx:1-23;curl -s https://zipforce.zipforcehub.com/api/auth/registration-status 看当前 open 真值生效
AC-EL-AUTH-002Z logo 品牌块结构注册页顶部 44×44、圆角 10、var(--brand) 底白字「Z」,无「ZIPFORCE Hub」品牌字(register/page.tsx:61-65)纯静态展示,无数据依赖;welcome/en/privacy/terms 四页为另一形态(30×30、圆角 8、#4f46e5+品牌字,welcome:52/en:53/privacy:119/terms:96)——两形态并存非同组件;#4f46e5=globals.css:2 --brand读 register/page.tsx 品牌块段;浏览器看渲染生效
AC-EL-AUTH-003标题「注册 ZIPFORCE」文本注册页主标题 h1静态文案;页面 document title 与 h1 分离,h1 不变读 register/page.tsx h1 段生效
AC-EL-AUTH-004副标题「Amazon 卖家的电商数据 AI 工作台 · 14 天试用」文本注册页副标题,声明试用口径「14 天」与 terms §二「14 天全功能免费试用,无需绑定支付方式」同口径(跨层一致);静态文案读 register/page.tsx;对照 terms/page.tsx §二首条生效
AC-EL-AUTH-005公司/店铺名字段表单注册表单字段:label「公司/店铺名」必填;minLength=2 maxLength=60;值作为 company 提交(后端据此生成租户 slug 与子域)读 register/page.tsx 公司字段段;提交 1 字符公司名应被前端拦生效
AC-EL-AUTH-006邮箱字段表单注册表单字段:邮箱type=email 必填;autoComplete=username;提交名 email;为验证邮件投递目标读 register/page.tsx 邮箱字段段生效
AC-EL-AUTH-007密码字段表单注册表单字段:label「密码(至少 8 位)」规则仅此一条:必填、最少 8 字符(minLength=8)、type=password、autoComplete=new-password;本条只描述校验规则,不录入任何真实或样例密码;存储侧=不可逆散列(见 privacy §二「仅存储不可逆散列值」)读 register/page.tsx 密码字段段;读 privacy/page.tsx §二首条口径行生效
AC-EL-AUTH-008注册错误提示区交互表单下方错误提示,role=alert失败显示「注册失败」+后端 detail;网络异常 fallback「网络错误,请重试」;无障碍语义=alert读 register/page.tsx err 段;断网提交看 fallback生效
AC-EL-AUTH-009同意条款复选框表单必选复选框 + 两个法务链接勾选为提交前置条件(见 010 禁用逻辑);链接《服务条款》→/terms、《隐私政策》→/privacy,均 target=_blank 新窗打开读 register/page.tsx agree 段;未勾选时提交按钮应禁用生效
AC-EL-AUTH-010提交按钮「创建账号」交互注册表单提交按钮,双态文案禁用条件=busy || !agree(提交中或未勾选条款);busy 态文案「注册中…」,常态「创建账号」读 register/page.tsx 按钮段;未勾选+点按钮验证不可点生效
AC-EL-AUTH-011注册接口 POST /api/auth/registerAPI提交 {email, password, company},credentials: include后端 api/routers/auth.py:236 起;成功返回 {ok:true, subdomain:"{slug}.zipforcehub.com"}(auth.py:291);有限速(注册 IP 维度 Redis 键,auth.py:243 expire 3600)grep -n "auth/register" api/routers/auth.py;读 auth.py:236-291生效
AC-EL-AUTH-012成功态提示「验证邮件已发送到 {email}(24 小时内有效)」交互注册成功后绿色提示,role=status「24 小时内有效」声明在两层一致:页面文案 + 验证邮件正文(auth.py:204 纯文本 / auth.py:209 HTML 均「24 小时内有效」);验证链接形如 https://zipforcehub.com/verify?token={token}(auth.py:203)读 register/page.tsx 成功态段;grep -n "24 小时" api/routers/auth.py;token 实际 TTL 常量在 parse_token 侧复核生效
AC-EL-AUTH-013子域展示文本成功态展示分配到的租户子域值来自注册响应 subdomain 字段(后端拼 {slug}.zipforcehub.com,auth.py:291),前端不自行拼接读 register/page.tsx 成功态 subdomain 段;对照 auth.py:291生效
AC-EL-AUTH-014重发验证邮件按钮交互成功态内「重新发送」按钮POST /api/auth/resend {email}(auth.py:319 起);后端限速键 resend:{email}(auth.py:324,Redis expire 3600);成功 toast/文案「验证邮件已重新发送,请查收」读 register/page.tsx resend 段;读 auth.py:319-326生效
AC-EL-AUTH-015「返回登录」链接链接成功态内回登录页链接指向 /login;静态读 register/page.tsx 成功态链接段生效
AC-EL-AUTH-016页脚「已有账号?登录」链接注册页底部切换入口指向 /login;在 form 内、RegGate 包裹范围内(register:70-116,链接在 111-113)——注册关闭时该链接同样被隐藏,非独立于开关读 register/page.tsx 页脚段生效
AC-EL-AUTH-017登录页标题「ZIPFORCE Portal」+ 副标题文本h1「ZIPFORCE Portal」,副标题「多租户电商数据平台 · 登录」静态文案;与注册页「注册 ZIPFORCE」命名体系并列读 login/page.tsx 标题段生效
AC-EL-AUTH-018登录邮箱字段表单登录表单邮箱输入必填;autoComplete=username(浏览器密码管理器配对用)读 login/page.tsx 邮箱段生效
AC-EL-AUTH-019登录密码字段表单登录表单密码输入必填;type=password;autoComplete=current-password(与注册页 new-password 区分);本条只描述交互属性,不涉及任何密码值读 login/page.tsx 密码段生效
AC-EL-AUTH-020登录接口 POST /api/auth/loginAPI提交邮箱+密码,credentials: include后端校验账号 active 且密码散列匹配(auth.py:113);成功种会话 Cookie(httponly secure samesite=lax max_age=SESSION_TTL,auth.py:127);登录失败限速 Redis 键 expire 600(auth.py:117)读 login/page.tsx 提交段;读 auth.py:113-132生效
AC-EL-AUTH-021登录后分流跳转交互登录成功按租户状态路由j.tenant_status==="offboarding" → router.replace(j.purge_due ? /offboarding?due=… : /offboarding),否则 → /;后端依据:offboarding 租户登录是自救通道(#61 挂账②,auth.py:122-123),响应带 tenant_status/purge_due,purge_due=offboard 时间+OFFBOARD_COOLDOWN_DAYS(auth.py:132)读 login/page.tsx on-ok 分支;读 auth.py:122-132生效
AC-EL-AUTH-022登录错误提示交互登录失败提示,role=alert展示后端错误信息;网络异常 fallback;无障碍语义=alert读 login/page.tsx err 段生效
AC-EL-AUTH-023登录按钮交互登录提交按钮,双态文案busy 态「登录中…」,常态「登 录」(半角空格 U+0020 分隔,login/page.tsx:67)读 login/page.tsx 按钮段生效
AC-EL-AUTH-024登录页注册入口(RegGate)守卫页脚「还没有账号?注册(14 天试用)」→ /register,外包 RegGateclosedText=「注册暂未开放」(短版,区别于注册页长版文案);机制同 AC-EL-AUTH-001;「14 天试用」口径同 004读 login/page.tsx RegGate 段;对照 RegGate.tsx 默认 closedText生效
AC-EL-AUTH-025登录页脚法务链接链接页脚淡色「服务条款 · 隐私政策」链接分别指向 /terms、/privacy;静态读 login/page.tsx 页脚段生效
AC-EL-AUTH-026verify token 参数读取交互/verify 从 URL 查询串读 tokennew URLSearchParams(window.location.search) 取 token 作为验证唯一凭证;无 token 走失败态读 verify/page.tsx token 段生效
AC-EL-AUTH-027验证接口 GET /api/auth/verify?token=…API页面加载即请求验证后端 auth.py:293 起;结果二值化驱动页面三态(loading/ok/fail)读 verify/page.tsx fetch 段;grep -n "auth/verify" api/routers/auth.py生效
AC-EL-AUTH-028验证 loading 态状态请求期间显示「正在验证邮箱…」初始态;接口返回后必然离开此态(ok 或 fail)读 verify/page.tsx loading 段生效
AC-EL-AUTH-029验证成功态状态h1「邮箱验证成功 🎉」+「你的工作台已开通,正在前往登录页…」仅当接口 ok 进入;文案声明工作台开通事实(租户激活完成)读 verify/page.tsx ok 段生效
AC-EL-AUTH-030自动跳转登录(2500ms)交互成功态 setTimeout 2500ms 后跳登录目标=响应里的 login_url 字段(前端不硬编码);倒计时期间用户可先点「立即登录」(见 031)读 verify/page.tsx setTimeout 段;改本地时钟不可绕过(服务端已验证)生效
AC-EL-AUTH-031「立即登录」按钮交互成功态手动跳转按钮,不等 2500ms目标同 030 的 login_url;静态文案读 verify/page.tsx 按钮段生效
AC-EL-AUTH-032验证失败态状态h1「验证失败」+ role=alert 错误区展示后端 detail,无 detail 时 fallback「验证失败」/「网络错误,请重试」;常见触发=token 过期/已用/缺失读 verify/page.tsx fail 段;用过期 token 访问 /verify 复现生效
AC-EL-AUTH-033「重新注册」链接链接失败态出口 → /register静态;失败态唯一主动出口读 verify/page.tsx fail 态链接段生效
AC-EL-AUTH-034welcome 页 metadata(SEO)元数据中文营销首页 SEO 元数据组title「亚马逊卖家店铺与广告数据分析平台 · SP-API / Ads API 官方对接」;canonical /;alternates:zh-CN /、en /en、x-default /;openGraph siteName ZIPFORCE Hub、locale zh_CN(与 /en 页 en_US 互为 hreflang 对)读 welcome/page.tsx metadata 段;view-source 看 canonical/hreflang生效
AC-EL-AUTH-035welcome header 导航导航顶栏:功能(#features)/ 数据安全(#security)/ EN(→/en)/ 免费注册(→/register,RegGate 包裹)锚点两项页内滚动;EN 切英文版;注册 CTA 受 RegGate 管控(机制同 001)读 welcome/page.tsx header 段生效
AC-EL-AUTH-036hero 徽章「亚马逊店铺 + 广告一体化数据分析 · SaaS」文本hero 区胶囊徽章静态定位语;与 /en 页英文徽章互译对应读 welcome/page.tsx hero 徽章段生效
AC-EL-AUTH-037hero 主标题文本h1「连接你的亚马逊店铺与广告数据,AI 一句诊断广告赚没赚」静态;核心价值主张一句话(店铺+广告数据接入 → AI 诊断)读 welcome/page.tsx h1 段生效
AC-EL-AUTH-038hero 主 CTA「免费开始 —— 14 天全功能试用」交互主按钮 → /register,外包 RegGateclosedText=联系 support@zipforcehub.com 版本;「14 天全功能试用」口径同 004/terms §二读 welcome/page.tsx CTA 段生效
AC-EL-AUTH-039hero 已有账号提示文本「已有账号?访问 你的公司名.zipforcehub.com」提示租户子域登录路径;与 auth.py:291 子域格式 {slug}.zipforcehub.com 同构读 welcome/page.tsx hint 段生效
AC-EL-AUTH-040功能卡 1「广告活动分析」卡片FEATURES 卡:广告活动分析描述=活动级花费/销售/ACOS 趋势与健康度;对应站内 /ads 能力区(§11.9)读 welcome/page.tsx FEATURES[0];对照 §11.9 广告组条目生效
AC-EL-AUTH-041功能卡 2「SP 店铺数据」卡片FEATURES 卡:SP 店铺数据描述=订单明细/FBA 库存健康/月度财务结算,经官方 SP-API;对应 /orders、/finance 等能力区读 welcome/page.tsx FEATURES[1]生效
AC-EL-AUTH-042功能卡 3「AI 广告洞察」卡片FEATURES 卡:AI 广告洞察描述=基于真实业绩数据的 AI 广告诊断+预算/定向建议;对应 /ai 能力区读 welcome/page.tsx FEATURES[2]生效
AC-EL-AUTH-043功能卡 4「利润报表」卡片FEATURES 卡:利润报表描述=每 SKU 每月收入/费用/回款/净利,跨市场统一折 USD;对应 /finance(§11.6)读 welcome/page.tsx FEATURES[3]生效
AC-EL-AUTH-044功能卡 5「广告告警」卡片FEATURES 卡:广告告警描述=高 ACOS/零销售活动/低 CTR 自动告警+每日优化清单读 welcome/page.tsx FEATURES[4]生效
AC-EL-AUTH-045功能卡 6「Listing 分析」卡片FEATURES 卡:Listing 分析描述=标题/五点/关键词覆盖与 Listing 变更追踪;对应 /listings 能力区读 welcome/page.tsx FEATURES[5]生效
AC-EL-AUTH-046场景卡 1「亚马逊多站点卖家」卡片CASES 卡:多站点卖家描述=北美/欧洲/日本店铺与广告账户一屏统管,利润与 ACOS 分市场核算读 welcome/page.tsx CASES[0]生效
AC-EL-AUTH-047场景卡 2「品牌大卖」卡片CASES 卡:中文实题「品牌大卖」(welcome:34;英文卡 title「品牌组合卖家」系回译对照)描述=多品牌管理,品牌级利润报表与广告预算矩阵分配读 welcome/page.tsx CASES[1]生效
AC-EL-AUTH-048场景卡 3「代运营团队」卡片CASES 卡:代运营团队描述=每客户独立隔离租户工作区,数据完全分离,仅展示各客户授权范围读 welcome/page.tsx CASES[2]生效
AC-EL-AUTH-049安全卡 1「独立租户身份」卡片SECURITY 卡:租户隔离描述=每公司独立租户 ID+子域,行级访问隔离,对其他租户不可见;与铁律「租户绝对独立」及 privacy §七 RLS 声明同口径读 welcome/page.tsx SECURITY[0];对照 privacy §七生效
AC-EL-AUTH-050安全卡 2「官方 API 授权接入」卡片SECURITY 卡:官方授权描述=仅经官方 Amazon SP-API/Ads API,卖家 LWA OAuth 授权后拉数;与 privacy §四同口径读 welcome/page.tsx SECURITY[1]生效
AC-EL-AUTH-051安全卡 3「授权可随时撤销」卡片SECURITY 卡:撤销即停描述=卖家在亚马逊后台撤销授权后自动停止拉新数据;与 privacy §四「授权撤销」条同口径读 welcome/page.tsx SECURITY[2]生效
AC-EL-AUTH-052安全卡 4「数据删除流程」卡片SECURITY 卡:删除流程描述=清晰的删除流程(取消/撤销后可请求数据移除);与 privacy §四「30 天内完成删除」同口径读 welcome/page.tsx SECURITY[3]生效
AC-EL-AUTH-053安全卡 5「令牌加密存储」卡片SECURITY 卡:令牌加密描述=授权令牌静态加密+严格访问控制,全站 TLS;与 privacy §二「AES-GCM 信封加密」、§七「传输加密」同口径读 welcome/page.tsx SECURITY[4]生效
AC-EL-AUTH-054安全卡 6「每日备份」卡片SECURITY 卡:每日备份描述=每日备份+异常访问/操作全审计轨迹;与 privacy §七「数据库每日备份」同口径读 welcome/page.tsx SECURITY[5]生效
AC-EL-AUTH-055welcome 页脚脚注© 2026 ZIPFORCE + 隐私政策/服务条款链接链接 → /privacy、/terms;版权年份硬编码 2026读 welcome/page.tsx footer 段生效

§11.24 跳转页 + 帮助页 + 法务页(AC-EL-REDIR /promotion /upload · AC-EL-HLP /en /training · AC-EL-LEGAL /privacy /terms /feishu,源码 web/app/ 下 7 文件共 603 行 + api/routers/ops.py + collab.py)

AC-EL-REDIR 跳转/薄壳路由

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-REDIR-001/promotion 路由壳结构AppShell 壳页:title「站内促销」,crumb「平台促销 · noon deals/coupons · Amazon promotions(即将)」薄壳路由,自身无业务逻辑,内容整体委托 NoonPromoTab;crumb 声明 Amazon promotions 为「即将」(未上线能力,边界明确)读 promotion/page.tsx(12 行全文)生效
AC-EL-REDIR-002NoonPromoTab 承载组件/promotion 唯一内容区=子组件 NoonPromoTab(站内促销 deals/coupons 面)本组只立壳层条目;NoonPromoTab 内部逐元素(表格/筛选/操作)未在本组展开,属促销组件另册待后续批次录入读 promotion/page.tsx import;ls web/app/promotion/ 看子组件文件待深化
AC-EL-REDIR-003/upload 308 重定向重定向访问 /upload 永久重定向到 /listingsredirect("/listings")(next/navigation);代码注释载明缘由:2026-09-15 页面合并,上传(文件+A+)并入 /listings;旧链接/书签兼容通道读 upload/page.tsx(6 行全文);curl -sI /upload 看 308 Location生效

AC-EL-HLP 帮助/营销页(/en /training)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-HLP-001/en metadata(SEO)元数据英文营销页 SEO 元数据组title「Amazon Seller Analytics — Official SP-API / Ads API Integration」;canonical /en;alternates:en /en、zh-CN /、x-default /;openGraph locale en_US、type website(与 welcome 页 zh_CN 互为 hreflang 对,canonical 各自独立不互指)读 en/page.tsx metadata 段;view-source /en 验 hreflang生效
AC-EL-HLP-002/en header 导航导航顶栏:Features(#features)/ Data security(#security)/ 中文(→/)/ Start free(→/register,RegGate 包裹)closedText=「Registration closed」(导航短版);语言切换双向(中文页 EN ↔ 英文页 中文)读 en/page.tsx header 段生效
AC-EL-HLP-003/en hero 徽章文本「Amazon store + ads analytics in one platform · SaaS」静态;welcome 页中文徽章的英文对应读 en/page.tsx hero 段生效
AC-EL-HLP-004/en hero 主标题文本h1 含高亮短语「let AI tell you if your ads actually pay off」(紫色强调)静态;中文页 h1 的英文对应;高亮为内联样式不拆组件读 en/page.tsx h1 段生效
AC-EL-HLP-005/en hero 段落文本卖家授权数据说明段(orders, inventory, settlements, ad campaigns, ACOS, AI diagnostics, isolated tenant)静态能力总述;与中文页 hero 副文口径一致(官方 API+授权+租户隔离)读 en/page.tsx hero p 段生效
AC-EL-HLP-006/en 主 CTA「Start free — 14-day full trial」交互主按钮 → /register,外包 RegGateclosedText=「Registration is currently closed — contact support@zipforcehub.com」(英文长版);「14-day full trial」口径同中文页/terms §二读 en/page.tsx CTA 段生效
AC-EL-HLP-007/en 已有账号提示文本「Have an account? Visit yourcompany.zipforcehub.com」子域格式示例与 {slug}.zipforcehub.com 同构;静态读 en/page.tsx hint 段生效
AC-EL-HLP-008功能卡 1「Ad Campaign Analysis」卡片FEATURES 英文卡:广告活动分析描述=campaign 级 impressions/clicks/spend/sales/ACOS 趋势+分国分品牌健康分;中文对应 AC-EL-AUTH-040读 en/page.tsx FEATURES[0]生效
AC-EL-HLP-009功能卡 2「SP Store Data」卡片FEATURES 英文卡:SP 店铺数据描述=订单明细/FBA 库存健康/月度结算,官方 SP-API;中文对应 041读 en/page.tsx FEATURES[1]生效
AC-EL-HLP-010功能卡 3「AI Ad Insights」卡片FEATURES 英文卡:AI 广告洞察描述=基于真实业绩的 AI 诊断+预算/定向建议;中文对应 042读 en/page.tsx FEATURES[2]生效
AC-EL-HLP-011功能卡 4「Profit Reports」卡片FEATURES 英文卡:利润报表描述=每 SKU 每月收入/费用/回款/净利,跨市场统一 USD;中文对应 043读 en/page.tsx FEATURES[3]生效
AC-EL-HLP-012功能卡 5「Ad Alerts」卡片FEATURES 英文卡:广告告警描述=高 ACOS/零销售/低 CTR 自动告警+每日优化清单;中文对应 044读 en/page.tsx FEATURES[4]生效
AC-EL-HLP-013功能卡 6「Listing Analysis」卡片FEATURES 英文卡:Listing 分析描述=标题/五点/关键词覆盖/变更追踪;中文对应 045读 en/page.tsx FEATURES[5]生效
AC-EL-HLP-014场景卡 1「Multi-marketplace sellers」卡片CASES 英文卡:多站点卖家描述=NA/EU/JP 一屏统管,利润与 ACOS 分市场核算;中文对应 046读 en/page.tsx CASES[0]生效
AC-EL-HLP-015场景卡 2「Brand portfolio sellers」卡片CASES 英文卡:品牌组合卖家描述=多品牌利润报表+广告预算矩阵;中文对应 047读 en/page.tsx CASES[1]生效
AC-EL-HLP-016场景卡 3「Agency teams」卡片CASES 英文卡:代运营团队描述=每客户独立隔离租户工作区;中文对应 048读 en/page.tsx CASES[2]生效
AC-EL-HLP-017安全卡 1「Isolated tenant identity」卡片SECURITY 英文卡:租户隔离描述=独立租户 ID+子域+行级隔离;中文对应 049读 en/page.tsx SECURITY[0]生效
AC-EL-HLP-018安全卡 2「Official API authorization」卡片SECURITY 英文卡:官方授权描述=仅官方 SP-API/Ads API,LWA OAuth 后拉数;中文对应 050读 en/page.tsx SECURITY[1]生效
AC-EL-HLP-019安全卡 3「Revoke anytime」卡片SECURITY 英文卡:撤销即停描述=撤销授权自动停拉新数据;中文对应 051读 en/page.tsx SECURITY[2]生效
AC-EL-HLP-020安全卡 4「Data deletion process」卡片SECURITY 英文卡:删除流程描述=取消/撤销后可请求删除;中文对应 052读 en/page.tsx SECURITY[3]生效
AC-EL-HLP-021安全卡 5「Encrypted token storage」卡片SECURITY 英文卡:令牌加密描述=令牌静态加密+严格访问控制+全站 TLS;中文对应 053读 en/page.tsx SECURITY[4]生效
AC-EL-HLP-022安全卡 6「Daily backups」卡片SECURITY 英文卡:每日备份描述=每日备份+异常访问审计轨迹;中文对应 054读 en/page.tsx SECURITY[5]生效
AC-EL-HLP-023/en 页脚脚注© 2026 ZIPFORCE · zipforcehub.com · 定位语 + Privacy/Terms 链接链接 → /privacy、/terms;含英文长定位句(seller-authorized data…solely for each seller's own analysis)读 en/page.tsx footer 段生效
AC-EL-HLP-024/training 路由壳结构AppShell 壳页:title「培训」,crumb「运营培训中心 · 内部培训资料({体量})」crumb 内嵌体量数字来自接口(见 026),非硬编码;页面 2026-09-06 内部培训站整体搬运而来、2026-09-17 UVPVP 内容按用户指定「复制内容不是挂链接」入站读 training/page.tsx 壳段与头注释生效
AC-EL-HLP-025KPI「培训模块」KPI值=SECTIONS.length=10前端常量数组长度(十模块:amazon/noon/ai-design/gpt-image2/seedance2/nano-views/brainews-ui/listings/projects/scripts);foot「Amazon / Noon / AI 工具链 / 项目实战」读 training/page.tsx SECTIONS 数组+KPI 段;数组成员数应=10生效
AC-EL-HLP-026KPI「内容体量」+ stats 接口KPI显示「{mb} MB」;foot「{files} 个文件 · PPT / HTML 教程 / 设计切图 / 视频」UI-01(2026-10-14):体量真值来自 GET /api/training/stats(后端 ops.py:40,api 侧 du /srv/training 实测),不硬编码;接口失败/挂载缺失降级显示「—」与静态 foot 文案,不显示编造数字读 training/page.tsx stats useEffect 段;grep -n "training/stats" api/routers/ops.py;curl 接口比对 mb/files生效
AC-EL-HLP-027KPI「主推课程」KPI值「Amazon 全攻略」,foot「运营 + 广告深耕 + 广告 SOP + 核心词汇」静态文案;指向 amazon 模块聚合读 training/page.tsx 主推课程 KPI 段生效
AC-EL-HLP-028课程卡 1「Amazon 运营」卡片SECTIONS 卡:amazon 目录desc「运营全攻略 PPT / 广告深耕 / 广告 SOP / 核心词汇」;tone=ok;链接 /training/amazon/ 新窗直出静态内容读 training/page.tsx SECTIONS[0]生效
AC-EL-HLP-029课程卡 2「Noon 运营」卡片SECTIONS 卡:noon 目录desc「Noon 平台运营全攻略 / 平台培训 PPT」;tone=warn;链接 /training/noon/读 training/page.tsx SECTIONS[1]生效
AC-EL-HLP-030课程卡 3「AI 设计工具」卡片SECTIONS 卡:ai-design 目录desc「AI 设计工作流与工具指引」;tone=ok;链接 /training/ai-design/读 training/page.tsx SECTIONS[2]生效
AC-EL-HLP-031课程卡 4「GPT-Image 生图」卡片SECTIONS 卡:gpt-image2 目录desc「文生图提示词与出图案例」;tone=ok;链接 /training/gpt-image2/读 training/page.tsx SECTIONS[3]生效
AC-EL-HLP-032课程卡 5「Seedance 视频」卡片SECTIONS 卡:seedance2 目录desc「AI 视频生成脚本与成品」;tone=ok;链接 /training/seedance2/读 training/page.tsx SECTIONS[4]生效
AC-EL-HLP-033课程卡 6「NANO 外观图库」卡片SECTIONS 卡:nano-views 目录desc「BraiNews NANO 设备三视图 / 尺寸图」;tone=dim;链接 /training/nano-views/读 training/page.tsx SECTIONS[5]生效
AC-EL-HLP-034课程卡 7「BraiNews UI 规格」卡片SECTIONS 卡:brainews-ui 目录desc「NANO 18 页设计规格与全套 UI 切图(89MB)」;tone=dim;链接 /training/brainews-ui/;89MB 为静态声明值读 training/page.tsx SECTIONS[6]生效
AC-EL-HLP-035课程卡 8「Listing 模板副本」卡片SECTIONS 卡:listings 目录desc「A+ 模板本地副本(主库见 Listing 入口)」;tone=dim;边界=副本非主库,主入口在 /listings读 training/page.tsx SECTIONS[7]生效
AC-EL-HLP-036课程卡 9「项目实战」卡片SECTIONS 卡:projects 目录desc「视频 / 图文项目工作区」;tone=dim;链接 /training/projects/读 training/page.tsx SECTIONS[8]生效
AC-EL-HLP-037课程卡 10「辅助脚本」卡片SECTIONS 卡:scripts 目录desc「幻灯片排序等整理脚本」;tone=dim;链接 /training/scripts/读 training/page.tsx SECTIONS[9]生效
AC-EL-HLP-038UVPVP 卡 1「核心词汇」卡片UVPVP_SECTIONS 卡:vocabdesc「运营核心词汇表(ACOS/BSR/冗语等术语速查)」;tone=warn;链接 /training/uvpvp/vocab.html(静态直出,无 UVPVP 账号依赖)读 training/page.tsx UVPVP_SECTIONS[0]生效
AC-EL-HLP-039UVPVP 卡 2「运营 SOP」卡片UVPVP_SECTIONS 卡:sopdesc「标准作业流程(Listing 上架 / 广告 / 客服)」;tone=warn;链接 /training/uvpvp/sop.html读 training/page.tsx UVPVP_SECTIONS[1]生效
AC-EL-HLP-040UVPVP 卡 3「Listing 教程」卡片UVPVP_SECTIONS 卡:listingdesc「Listing 编写教程(标题/五点/A+ 要领)」;tone=warn;链接 /training/uvpvp/listing.html读 training/page.tsx UVPVP_SECTIONS[2]生效
AC-EL-HLP-041UVPVP 卡 4「Listing 设计规范」卡片UVPVP_SECTIONS 卡:listing-designdesc「设计规范 + 13 个真实案例图解」;tone=warn;链接 /training/uvpvp/listing-design.html;源=旧版 /opt/uvpvp templates+static/cases 去 Jinja 本地化读 training/page.tsx UVPVP_SECTIONS[3] 与头注释生效
AC-EL-HLP-042培训页脚说明脚注「数据源:内部培训站整体搬运(2026-09-06)。新员工入职路径:Amazon 运营 → 广告深耕 → Noon 运营 → AI 设计工具 → 项目实战;PPT 可直接下载。」静态说明;载明搬运时间与推荐学习顺序读 training/page.tsx 页脚段生效

AC-EL-LEGAL 法务页(/privacy /terms /feishu)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-LEGAL-001/privacy metadata元数据title「隐私政策」+ description(收集哪些数据/如何使用保护/AI 处理/子处理方/权利)静态 SEO 元数据;description 为十三节内容摘要句读 privacy/page.tsx metadata 段生效
AC-EL-LEGAL-002/privacy header导航顶栏 logo + 「首页」(→/)「服务条款」(→/terms)静态互链;无登录态元素读 privacy/page.tsx header 段生效
AC-EL-LEGAL-003/privacy 标题与生效日期文本h1「隐私政策」;生效日期「2026 年 10 月 14 日(补充运营主体与存储地域)」生效日期为政策版本锚点;括注载明该版变更性质读 privacy/page.tsx 日期段生效
AC-EL-LEGAL-004§一 运营主体与适用范围区块适用 zipforcehub.com 及租户子域;运营主体深圳优艾谱科技有限公司;联系 support@zipforcehub.com三要素:适用范围(主域+租户子域)/主体名称/联系渠道;主体名与 terms §一同一口径读 privacy/page.tsx §一;对照 terms §一生效
AC-EL-LEGAL-005§二 我们收集的信息区块五类:账号信息(密码仅存不可逆散列)/店铺授权凭证(AES-GCM 信封加密)/业务数据/上传文件/日志信息(IP+时间戳+审计)密码处理口径=仅散列不存明文(与 AC-EL-AUTH-007 呼应,本条同样只述规则不涉任何密码值);凭证加密算法明示 AES-GCM读 privacy/page.tsx §二五条生效
AC-EL-LEGAL-006§三 AI 功能的数据处理区块AI 助手(数据问答/选品/文案/广告优化)将必要数据片段发第三方大模型 API;不用于训练(以当时 API 条款为准);可不用 AI,核心面板不依赖边界三条:发送范围最小必要/训练用途排除/可选性;与 terms §四「AI 处理方式见隐私政策第三节」互引读 privacy/page.tsx §三;对照 terms §四第三条生效
AC-EL-LEGAL-007§四 Amazon 平台数据区块四条:仅 SP-API/Ads API + LWA OAuth 后获取;仅用于向你提供分析服务不外流;授权撤销自动停拉(已入库数据按 §八处理);删除请求 30 天内完成与 welcome/en 安全卡 2/3/4(AC-EL-AUTH-050~052、HLP-018~020)营销口径同源;30 天删除时限与 §八注销口径一致读 privacy/page.tsx §四四条;对照 §八生效
AC-EL-LEGAL-008§五 使用目的区块四条:服务运维/交易验证与通知(阿里云企业邮箱)/安全保障(限流+审计+租户隔离校验);不投广告不出售数据「不投广告不出售」与 terms §四第二条同口径读 privacy/page.tsx §五生效
AC-EL-LEGAL-009§六 子处理方区块清单:云服务器与数据库托管/Stripe(订阅支付)/第三方大模型 API(仅 AI)/阿里云企业邮箱(事务邮件)/Amazon·Noon 平台 API(数据来源方)+ 签数据处理协议声明子处理方封闭清单,页面枚举即全量口径;新增须改本节(政策更新机制 §十二)读 privacy/page.tsx §六生效
AC-EL-LEGAL-010§七 存储与安全区块四条:全站强制 HTTPS(TLS)/敏感凭证静态加密+数据库每日备份/租户隔离=独立子域+独立数据模式+RLS 行级安全+品牌级数据范围/存储地域美国加州圣何塞RLS+品牌级范围=铁律「租户/品牌绝对独立」的法务表述;每日备份与 VERSION 登记 crontab 实操对应读 privacy/page.tsx §七;对照 VERSION 备份登记生效
AC-EL-LEGAL-011§八 数据保留区块业务数据账号存续期内保留;注销后 30 天内删除或匿名化(法定保留除外)30 天窗口与 §四删除时限、terms §八导出窗口三处同口径读 privacy/page.tsx §八生效
AC-EL-LEGAL-012§九 你的权利区块访问/更正/导出(产品内导出入口,未覆盖部分人工处理);删除与注销;经 support@zipforcehub.com 行使导出入口边界如实声明「暂未覆盖的部分可联系我们」读 privacy/page.tsx §九生效
AC-EL-LEGAL-013§十 Cookie区块仅必要会话 Cookie(HttpOnly、Secure、SameSite=Lax),无跟踪类 Cookie,无第三方统计脚本三属性与 auth.py:127 登录 Cookie 实参(httponly/secure/samesite=lax)跨层一致读 privacy/page.tsx §十;对照 auth.py:127生效
AC-EL-LEGAL-014§十一 跨境传输区块数据可能在中国境外处理(指回 §五/§六),采取措施保障传输安全合规与 §七存储地域(美国圣何塞)事实对应读 privacy/page.tsx §十一生效
AC-EL-LEGAL-015§十二 政策更新区块更新在本页公布并更新生效日期;重大变更站内或邮件通知更新机制=页面公布+日期锚点(见 003)读 privacy/page.tsx §十二生效
AC-EL-LEGAL-016§十三 联系我们区块疑问联系 support@zipforcehub.com单一联系渠道,与 §一/§四/§九同址读 privacy/page.tsx §十三生效
AC-EL-LEGAL-017/privacy 页脚脚注© 2026 ZIPFORCE + 服务条款(/terms)+ zipforcehub.com(/)链接静态;与 header 互链闭环读 privacy/page.tsx footer 段生效
AC-EL-LEGAL-018/terms metadata元数据title「服务条款」+ description(服务内容/试用订阅/数据所有权/公平使用/终止/责任限制)静态 SEO 元数据读 terms/page.tsx metadata 段生效
AC-EL-LEGAL-019/terms header导航顶栏 logo + 「首页」(→/)「隐私政策」(→/privacy)静态互链;与 privacy header 镜像对称读 terms/page.tsx header 段生效
AC-EL-LEGAL-020/terms 标题与生效日期文本h1「服务条款」;生效日期「2026 年 10 月 14 日(补充运营主体与法律适用条款)」与 privacy 同日版本(2026-10-14 双政策同步更新)读 terms/page.tsx 日期段生效
AC-EL-LEGAL-021§一 服务描述区块面向跨境电商(以 Amazon 卖家为主)的多租户数据分析与 AI 工作台 SaaS;每公司独立子域+物理隔离数据空间;运营主体深圳优艾谱科技有限公司「物理隔离」为条款级声明(实现层=独立 schema+RLS,见 privacy §七);主体名与 privacy §一同口径读 terms/page.tsx §一生效
AC-EL-LEGAL-022§二 试用与订阅区块14 天全功能试用无需绑卡;Starter $49/月(单品牌,AI 50 次/天)、Growth $199/月(多品牌母账号,AI 200 次/天)、Enterprise $499/月(白标/BYOK/专属支持,AI 500 次/天);Stripe 按月续费,随时取消至当期止,当期不退;调价提前通知仅对后续周期生效「14 天」与注册/登录/营销页四处同口径;AI 配额三档已对上(core.py:262 PLAN_AI_QUOTA starter 50/growth 200/enterprise 500);2026-10-22 校对实证价格分歧:条款页 Growth $149(terms/page.tsx:20)vs 计费源 growth=199(billing.py:44),且条款页 Enterprise「定制」无价 vs billing.py:47 price=499。2026-10-22 用户拍板以 billing.py 为准:条款页已改 Growth $199/月、Enterprise $499/月(terms/page.tsx:20),web 重建上线(47/47 页编译),线上 /terms 核验两侧一致,frontend_e2e 门禁 ALL PASS(日志 _gate_terms_price_20261022_frontend_e2e.log),待核转生效读 terms/page.tsx §二;billing.py:44/47 对账;复检两侧一致(2026-10-22 已通过)生效
AC-EL-LEGAL-023§三 账号与安全义务区块注册信息真实准确;妥善保管凭证不共享;对上传/接入数据有合法权利用户侧义务三条;无系统实现对应项(纯条款)读 terms/page.tsx §三生效
AC-EL-LEGAL-024§四 数据所有权区块业务数据归用户;授予平台必需处理许可;不出售不投广告;终止后有导出窗口(见 §八)与 privacy §五「不投广告不出售」同口径;导出窗口 30 天见 §八读 terms/page.tsx §四生效
AC-EL-LEGAL-025§五 AI 输出免责区块AI 生成内容按「现状」提供仅供参考,不构成财务/经营/投资建议,决策前自行核实免责边界单条;覆盖分析/建议/文案全部 AI 输出读 terms/page.tsx §五生效
AC-EL-LEGAL-026§六 公平使用区块AI 配额按套餐执行以产品内展示为准;禁止逆向工程/爬取/未授权压测/转售/规避租户隔离与权限控制;违规可暂停终止「规避租户隔离」明列禁止项=铁律的条款化表述读 terms/page.tsx §六生效
AC-EL-LEGAL-027§七 服务变更与维护区块功能持续更新;计划内维护提前通知,突发故障以官网公告为准;不可抗力与第三方平台(Amazon/Noon/支付/邮件)故障免责但尽力减损第三方依赖清单与 privacy §六子处理方口径相容读 terms/page.tsx §七生效
AC-EL-LEGAL-028§八 终止区块可随时注销终止;注销后 30 天数据导出窗口,逾期按隐私政策删除或匿名化;严重违规可暂停终止并通知30 天导出窗口与 privacy §八 30 天删除窗口衔接同口径读 terms/page.tsx §八;对照 privacy §八生效
AC-EL-LEGAL-029§九 责任限制区块适用法律允许范围内:间接损失/利润损失/数据损失(含平台数据同步缺失)不担责;累计责任上限=终止前 12 个月实付订阅费责任上限公式=「终止前 12 个月内实际支付订阅费」读 terms/page.tsx §九生效
AC-EL-LEGAL-030§十 法律适用与争议解决区块中华人民共和国法律管辖;先协商,不成则本公司住所地(广东省深圳市)有管辖权法院诉讼管辖锚点=公司住所地深圳;与 §一运营主体对应读 terms/page.tsx §十生效
AC-EL-LEGAL-031§十一 通知与变更区块通知经站内公告/注册邮箱/本页发出;重大变更提前公告,继续使用视为接受,不同意应停止使用并注销变更接受机制=继续使用推定接受读 terms/page.tsx §十一生效
AC-EL-LEGAL-032/terms 页脚脚注© 2026 ZIPFORCE + 隐私政策(/privacy)+ zipforcehub.com(/)链接静态;与 header 互链闭环读 terms/page.tsx footer 段生效
AC-EL-LEGAL-033/feishu 路由壳结构AppShell 壳页:title「飞书」,crumb「飞书资产导航 · 云盘根目录直达(深度集成待租户凭据)」crumb 即边界声明:当前能力=导航直达,深度集成待租户 BYOK 凭据读 feishu/page.tsx 壳段生效
AC-EL-LEGAL-034文档树接口 GET /api/documents/treeAPI页面加载拉取云盘树:响应 {mode, items[], kpi{total,files,roots}}后端 collab.py:75;items 节点含 path/name/type/url/children;失败静默(catch 空处理,kpi=null → int(undefined) 显「—」而非 0(fmt.ts:19-20)、列表显示加载中)grep -n "documents/tree" api/routers/collab.py;读 feishu/page.tsx useEffect 段生效
AC-EL-LEGAL-035KPI「云盘根目录」KPI值=kpi.roots(int 格式化)来源=documents/tree 响应;foot「品牌 / 部门分区直达」;接口失败显「—」非 0(见 034 降级边界)读 feishu/page.tsx 根目录 KPI 段生效
AC-EL-LEGAL-036KPI「镜像文档链接」KPI值=kpi.files(int 格式化)来源同上;foot「文档中心内可搜索浏览」指向文档中心能力读 feishu/page.tsx 镜像 KPI 段生效
AC-EL-LEGAL-037KPI「API 集成」KPI值固定文案「P2 · BYOK」,foot「租户自建应用授权后开放」静态状态卡非数值;P2=优先级档,BYOK=租户自持密钥模式读 feishu/page.tsx API 集成 KPI 段生效
AC-EL-LEGAL-038云盘根目录卡片网格卡片每个 folder 型且有 url 的根节点一张卡:「📁 {name}」+「{children} 个子项」+「打开 ↗」新窗跳飞书过滤条件=type==="folder" && url 非空;权限跟随飞书账号(本平台不代持);空数组显示「加载中…」(见 039)读 feishu/page.tsx 卡片网格段生效
AC-EL-LEGAL-039云盘列表空态状态roots 为空时显示「加载中…」加载中与加载失败共用此态(catch 静默不清错)——边界:失败也永远显示「加载中…」,无失败专属提示读 feishu/page.tsx 空态段;断网访问复现生效
AC-EL-LEGAL-040集成路线表表格四行三列(能力/说明/状态):云盘目录导航=可用(已上线);文档树镜像日更=待凭据;报表定时推送=P2;审批/请假联动=P2状态徽章 ok/dim 区分已上线与未上线;「代码已预留」为副标题声明读 feishu/page.tsx 集成路线表段生效
AC-EL-LEGAL-041开通方式说明脚注「租户在飞书开放平台自建应用(云盘只读+消息推送权限)后,在计费页提交 App ID/Secret(BYOK,平台不代持密钥)」BYOK 边界明示:平台不代持密钥;提交入口=计费页读 feishu/page.tsx 说明段生效

§11.25 AppShell 导航壳(全局壳 · AC-EL-SHELL,源码 web/components/AppShell.tsx 291 行 + web/app/layout.tsx + web/components/BrandContext.tsx;2026-10-22 批次二实证转档,三位编号)

全壳通用:品牌名单单源=/api/tenant/info(user_brands ?? brands),顶栏切换器、导航、AI 面板、自定义模块一律经 useBrand() 消费,禁散写品牌名单(H9 2026-10-13 已清);品牌拆开铁律贯穿——brand=""(全部聚合)仅显式点击「全部」时生效,多品牌账号默认落在自己的品牌;模块购买门控 require_module 前后端一致;页面主组件在 AppShell 父级,brand 状态走模块级 store 非 context。组件级联:BrandProvider>AIProvider>页面,KitProvider 在根布局(2026-09-17 上移)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SHELL-001品牌切换器(顶栏右)全局控件顶栏右侧品牌切换按钮组:「全部」(brand="")+ 逐品牌按钮,每按钮带 branddot 色点(background=brandColor(b))名单单源=useBrand().brands(info.user_brands ?? info.brands);brands.length<2 时整组不渲染(return null);色点=brand_colors 注册表(D类 2026-10-08 级联);选择持久化 localStorage zf:brand:<slug>;「全部」聚合仅显式点击生效(铁律)源码 AppShell.tsx TopBarRight;单品牌租户顶栏无切换器;多品牌切换后刷新记忆保持生效
AC-EL-SHELL-002brandReady 初始化门门控AppShell 的 children 仅在品牌 store 完成初始化(useBrandReady()===true)后挂载防品牌拆开铁律违例——初始化前以 brand=""(全部聚合)打出首渲染请求;源码两处注释明示;BrandContext 渲染期同步初始化(先于子组件首渲染,消灭竞态)源码 AppShell.tsx brandReady 门 + BrandContext.tsx:59-74;首屏网络面板无 brand="" 聚合请求生效
AC-EL-SHELL-003通知铃铛·轮询全局控件顶栏运营通知铃铛,GET /api/notifications/summary,5 分钟 setInterval 轮询仅 document.visibilityState==="visible" 时拉取(后台标签页暂停);NotifSummary 字段=inv_urgent/inv_watch/settle_abnormal/po_aging/pipe_stale/vol_drop/rank_abnormal?;summary 为 null 时铃铛整个隐藏源码 NotificationBell;network 面板见 5min 周期请求;切后台标签暂停生效
AC-EL-SHELL-004铃铛徽章状态铃铛右上角待处理计数徽章,danger 底色总数=inv_urgent+settle_abnormal+po_aging+pipe_stale+vol_drop+rank_abnormal(不含 inv_watch 观察级);≥100 封顶显示「99+」;总数 0 不显示徽章源码 badge 渲染;构造告警计数核对封顶与 0 隐藏生效
AC-EL-SHELL-005下拉告警 6 项导航点铃铛展开下拉,固定 6 项运营告警,每项含文案/计数/跳转/tone①库存紧急补货(→/inventory,bad,extra「另有 N 个观察级」=inv_watch)②回款异常(>14 天)(→/settlement?filter=abnormal,bad)③PO 滞留(>7 天未推进)(→/po,warn)④数据管道断更(>2 天)(→/pipeline,bad,extra「采集侧断流,看板口径可能缺数」)⑤数量骤降(vs 7日均值)(→/pipeline,bad,extra「采集在跑但量级掉崖」)⑥排名市场异常(塌缩/停更)(→/rankings,bad);n=0 项仍渲染计数 0源码 6 项数组逐字比对;逐项点击跳转路由核对生效
AC-EL-SHELL-006下拉头部/遮罩/刷新文案反馈下拉头部「运营通知 · N 项待处理」或「一切正常」;底部「每 5 分钟自动刷新」fixed 全屏遮罩 zIndex 39 点击关闭下拉;header N=徽章同口径总数源码 header/footer/overlay;点遮罩关闭生效
AC-EL-SHELL-007NAV_GROUPS 导航总纲(7 组)导航侧栏导航 7 组:工作台〔/、/today〕经营分析〔/finance·mod:finance、/ads·mod:ads、/sourcing·mod:sourcing、/rankings〕业务管理〔/products、/orders·mod:orders、/inventory·mod:inventory、/po·mod:inventory、/settlement·mod:finance、/logistics·mod:logistics、/promotion·mod:ads、/offsitepromotion·mod:ads、/projects·mod:collab、/listing·mod:listing〕渠道〔/noon·mod:finance〕数据〔/mapping、/pipeline、/backfill·adminOnly、/dictionary、/database·adminOnly、/onboarding·adminOnly〕协作〔/documents·mod:collab、/training·mod:collab、/feishu·mod:collab、/ai·mod:ai〕账户〔/team、/account、/billing、/settings·adminOnly〕mod=模块购买门控键;adminOnly=角色过滤;菜单项与路由一一对应,禁散写源码 NAV_GROUPS 常量逐项比对侧栏 UI生效
AC-EL-SHELL-008navState 三态门控门控每个菜单项按 (mod) 渲染三态:ok 正常 / unpurchased 未购 / forbidden 未授权!mod→ok;info.modules 不含 mod→unpurchased(Link→/billing?mod=<mod> + 🔒「开通」标签);user_modules!==null 且不含→forbidden(span.nav-lock 灰字「未授权,请联系管理员开通」,不可点);与后端 require_module 门一致未购模块账号见 🔒 开通跳账单页;无权限子账号见灰字锁生效
AC-EL-SHELL-009adminOnly 角色过滤门控backfill/database/onboarding/settings 四项仅 role==="owner"||"admin" 可见渲染层直接滤除(非灰显);名单与 NAV_GROUPS 标注一一对应member 角色登录侧栏无此四项;owner 全显生效
AC-EL-SHELL-010租户信息加载三态状态AppShell 挂载先 GET /api/tenant/info:ok→渲染壳;401 noauth→router.replace("/login");notenant→「未知的租户域名」卡片;等待期 loading 态info=BrandContext.TenantInfo(slug/name/plan/modules/brands/user_brands/brand_colors/brand_labels/noon_brands/user{id,role,name,job_label}/user_modules)源码三态分支;错误域名头访问复现 notenant 卡生效
AC-EL-SHELL-011侧栏品牌区与页脚导航侧栏顶部 logo「Z ZIPFORCE」;页脚 side-foot:租户名、用户名+slug、job_label/role、plan chip、退出登录退出登录 POST /api/auth/logout 成功后跳 /login;plan chip=info.plan;用户字段=/api/tenant/info user 对象源码 side-foot;点退出验证登出与跳转生效
AC-EL-SHELL-012汉堡抽屉(≤768)交互窄屏(≤980px 断点,globals.css:232 @media(max-width:980px)——非 AC-UI-04 的 768 首页溢出标准)顶栏汉堡按钮(aria-label「打开导航」)开抽屉导航 + drawer-mask 遮罩(globals.css:291)pathname 变化自动关闭抽屉(AppShell.tsx:186)980/981 视口分侧实测开合;路由跳转后抽屉自闭生效
AC-EL-SHELL-013顶栏标题与面包屑标题顶栏 h1=AppShell props.title;crumb=props.crumb 面包屑逐元素渲染title/crumb 由各页包裹 AppShell 时传入,壳不硬编码;面包屑与路由层级一致源码 h1/crumb 渲染;任意页核对与路由一致生效
AC-EL-SHELL-014顶栏右侧 6px 缓冲样式顶栏右容器 paddingRight:6,为铃铛徽章 absolute right:-5 悬挂留缓冲2026-10-01 像素审计 P3 缺陷㊳修复——徽章悬挂致横向溢出(fittingirls 实测 scrollWidth 395),留 6px 后 body 不横向滚动源码注释+实测 document.scrollWidth==clientWidth生效
AC-EL-SHELL-015全局 Provider 包裹与 AI 挂载ProviderAppShell 将页面内容包 BrandProvider>AIProvider,尾部全局挂 <AIChat/>;KitProvider(Toast/Confirm/Prompt 宿主)在 app/layout.tsx 根布局挂载页面主组件是 AppShell 的父级,brand 走模块级 store 而非 Provider context(2026-09-09 修复:context 只能向下传播致品牌切换对全部页面不生效);KitProvider 2026-09-17 上移根布局源码 AppShell.tsx:231-289 + layout.tsx:19生效
AC-EL-SHELL-016图标体系 Icon静态导航/按钮图标=内联 SVG path 映射,共 29 键:grid/clock/shield/trophy/box/receipt/megaphone/coins/wallet/layers/globe/sparkles/search/truck/share/key/flow/board/doc/tag/book/up/seed/chip/msg/users/lock/db/history零第三方图标依赖,全部内联 path源码 Icon path map;页面无外部图标资源请求生效

§11.26 共享组件(web/components/ ×19 · AC-EL-CMP,源码逐文件实证;2026-10-22 批次二转档;已录组件只立引用行不重复展开,AppShell 见 §11.25)

全组件通用:图表 spec 驱动(/api/dashboard/charts 等 API 下发 {key,title,hint,kind,x,series});数据缺失须可视化兜底(EMPTY_OPT「暂无数据」,禁裸空轴,P3 ⑰);空态显示「暂无数据/该筛选下无数据(不显示误导性 0)」不隐藏结构;导出文件名 zf_<scope>_<YYYYMMDD> 统一;弹层复用 globals.css .pm-ov/.pm-modal/.pm-toast;所有组件零第三方 UI 依赖(echarts 除外)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-CMP-001KpiDeck(引用行)引用工作台唯一 KPI 区:2 行×5 卡、右上 ▾ 换指标、ⓘ 口径说明已录 §11.1 AC-EL-HOME-10..14;2026-10-22 口径文案×5 对齐 AC-CAL-02(订单/客单价/CPS/取消率/脚注②)并部署(镜像 31f9b5812522)见 §11.1;线上 ⓘ 展开逐字核对生效
AC-EL-CMP-002SkuMasterTable(引用行)引用SKU 主表(全量列与口径)已录 §11.3 AC-EL-SKU(2026-10-12 三卡合并拍板:Top15×2+SKU销量明细+四维矩阵→一张全量表)见 §11.3生效
AC-EL-CMP-003AdsAdvice(引用行)引用广告建议组件(R24 算法/预算护栏/EXECUTE_ADS_ACTION 确认串)已录 §11.9 AC-EL-ADS 对应条目(bid 建议三源、九层写护栏、挂账项)见 §11.9生效
AC-EL-CMP-004EChart 渲染容器图表ECharts 封装:div 容器 + init/dispose 生命周期;height 默认 280、width 100%容器尺寸变化(栅格重排/抽屉开合)走 ResizeObserver 100ms 防抖 resize + window.resize 兜底;卸载即 dispose 防泄漏;merge=true 时 setOption notMerge:false + replaceMerge:["series"](保留用户 dataZoom/legend 交互态、序列整体替换),缺省整图重绘;option.dataZoom 渲染后丢失 console.warn(2026-09-28 调试桩);渲染异常 catch 后 warn 不崩页源码 EChart.tsx(52 行);拖动抽屉/缩窗图自适应生效
AC-EL-CMP-005GChart·specToOption 唯一转换图表ChartSpec{key,title,hint,kind,x,series,sub} → ECharts option 的唯一实现kind=line/bar/stack/pie/hbar 五种;色环=fmt.PALETTE 循环取色;pie 只画 value>0 扇区+底部滚动例;hbar=值轴横置+类目 inverse;类目轴 showMaxLabel:true 强制显示最末标签(2026-09-24:抽稀吞掉最后一天「当日进行中」标注);数值轴缩写 ≥1M→x.xM、≥1k→x.xk;barMaxWidth 18、非堆叠圆角 [3,3,0,0];多序列顶部例;品牌主看板 ChartCard 复用本转换不另写一份源码 GChart.tsx specToOption;对照 charts API spec 渲染生效
AC-EL-CMP-006GChart·dataZoom 规则交互时间序列图加可拖动 dataZoom(slider+inside),固定维度图不加2026-09-28 用户令——判断=数据点>12 且非 hbar/pie 才加(月度 3 点/星期 7 点不加;周度 14 点/日度 90 点加);slider height 22 bottom 4月度图无 zoom、日度 90 点图有 zoom生效
AC-EL-CMP-007GChart·EMPTY_OPT 空图兜底空态spec 缺失/加载中统一渲染居中灰字「暂无数据」常量 EMPTY_OPTP3 缺陷⑰(2026-10-01)——原裸 {series:[]} 渲染空坐标系无提示,违反「数据缺失须可视化兜底」铁律;BrandBoard/NoonBoard 均引用无数据品牌墙图显示「暂无数据」而非空轴生效
AC-EL-CMP-008GChart·单点线补大圆点图表线图仅 1 个非空数据点时 symbol:"circle" symbolSize:10,≥2 点纯线 symbol:"none"2026-09-29——30 天全局窗下月度图只剩当月一点,symbol:none 画不出线成「有轴无线」伪装空白(e2e 像素扫描当场抓获)窗内单点月度图显示圆点生效
AC-EL-CMP-009ChartCard 图卡本体图卡图卡容器:标题+副题+EChart+右上工具组;data-chart-id=<id>props 契约 id/title/sub/option/height(默认280)/range/onRange/globalLabel/csvName/csv/footer;组件不 fetch,数据过滤在父级(父级用 range 决定该图数据窗口);id=ChartGrid 布局持久化键源码 ChartCard.tsx(145 行)生效
AC-EL-CMP-010ChartCard·日期三态筛选每图独立日期控件三态:global 跟随页面全局窗 / {start,end} 独立区间 / null 未设;📅 展开起止 date 输入,独立区间显示「✕ 清除」跟随态 tab 显示「跟随全局 · <globalLabel>」;start≤max(end)、end≥min(start) 互约束;清除回 global 并收起控件设独立区间图卡重查独立窗数据;清除回全局生效
AC-EL-CMP-011ChartCard·⬇CSV导出右上「⬇ CSV」导出本图数据缺省 extractCsv 从 option 提取(类目 x 轴×各 series);业务可传 csv() 覆盖;文件名 zf_chart_<name>_<YYYYMMDD>.csv(name=csvName||id,非 [\w-] 字符替换 _);含引号/换行字段 RFC 转义+BOM任意图卡导出打开核对行列与图一致生效
AC-EL-CMP-012ChartGrid·拖拽/锁定/重置交互图卡栅格:拖拽排序(指针 Y 找插入点 insertBefore 语义)+「🔓 可拖动/🔒 已锁定」切换 +「↺ 重置」(confirm「恢复默认布局?(你的自定义排序会被清除)」)栅格 auto-fill minmax(min(420px,100%),1fr);锁定态 draggable=false;style prop 可覆盖布局(如单列 flex)拖动换序、锁定后不可拖、重置回默认序生效
AC-EL-CMP-013ChartGrid·布局持久化交互顺序与锁定态按登录账号+页面 key 服务端持久化GET /api/layout?page=<pageKey> 载入(未识别新卡 id 追加尾部,与 UVPVP applyOrder 同语义);拖拽结束/锁定切换 POST /api/layout {page,layout,locked};重置 POST /api/layout/reset {page}排序后换浏览器同账号顺序保持;重置后清除生效
AC-EL-CMP-014DataTable·通用表契约表格泛型数据表 DataTable cols/rows/rowKey;Col{key,head,align(l/r),cell,sortValue?,csv?,filter?,sticky?}列头点击排序——传 onSort 则受控透传(服务端排序),否则纯客户端;首击降序(dir:-1)再击反转;数字按数值比、其余 localeCompare zh-CN numeric;onRowClick 行指针态;增量包裹既有 .tbl 表格用,不重写业务列渲染源码 DataTable.tsx(211 行);任意使用页点列头核序生效
AC-EL-CMP-015DataTable·列级筛选行筛选表头下筛选行:filter:"text" 文本包含(不区分大小写)/ filter:"num" 数字 Min-Max 双输入(step any)取值=csv??sortValue;num 列非数字行仅在无 min/max 时保留;筛选先于排序且作用于导出(WYSIWYG);语义对齐 UVPVP colf(T0-3 2026-09-12)设 Min/Max 后表行与导出行数一致生效
AC-EL-CMP-016DataTable·导出 CSV+Excel导出右上「⬇ 导出 CSV」「⬇ 导出 Excel」按钮(分别传 exportCsv/exportExcel scope 才出现)CSV=zf_<scope>_<YYYYMMDD>.csv(RFC 引号转义+BOM);Excel=.xls HTML 表格 WYSIWYG(与页面所见筛选+排序后一致,office:x 命名空间);两导出均只含当前筛选可见行 shown导出文件行数==页面筛选后行数生效
AC-EL-CMP-017DataTable·分页条分页表底 pager:上一页 / 第 N / M 页 · 共 T 条 / 下一页page≤1 禁用上一页、page≥pages 禁用下一页;total 可选缺省省略「· T 条」翻页请求 page 参数递变生效
AC-EL-CMP-018DataTable·口径说明卡 caliber脚注表上方「📖 口径说明(点击展开)」details/summary 折叠卡2026-10-03 用户令,全栈表格统一;传 caliber ReactNode 即渲染;展开态浅底圆角块任意带 caliber 表展开核对文案生效
AC-EL-CMP-019DataTable·加载/空态空态loading 时表体内嵌 Skeleton(行 4×列=cols×高 30);无数据渲染 empty 或默认 EmptyState「暂无数据」空态不隐藏表结构(列头常驻)慢网见骨架;空数据表显示空态生效
AC-EL-CMP-020kit·基础展示件静态Spinner(zf-spin+「加载中…」可自定义文案)/ Skeleton(rows×cols 网格、行透明度 1−r×0.08 递减、aria-busy)/ EmptyState(◍ 图标+title+hint+action)零第三方依赖;全站加载/空态统一件源码 kit.tsx(179 行)生效
AC-EL-CMP-021kit·Delta 环比状态环比涨跌组件:((cur−prev)/prev)×100,好=绿/差=红(invert=true 成本类反转——下降为好)cur/prev 为 null 或 prev===0 → 灰「—」;输出 +x.x%/−x.x% 一位小数传参断言渲染色与符号生效
AC-EL-CMP-022kit·Toast反馈useToast()(msg,kind) 轻提示,pm-toast 样式kind=ok(✓ 默认)/err(✕ danger 底)/info(ℹ brand 底);2800ms 自动消失;KitProvider 宿主根布局挂载一次触发保存成功/失败看 toast 色与前缀、2.8s 消失生效
AC-EL-CMP-023kit·Confirm弹窗useConfirm()({title,body,confirmText,danger}) → Promise<boolean> 弹窗,替代 window.confirmdanger=true 确认键 danger 红;遮罩/取消均 resolve(false);同时只留一个(新开先 resolve 旧为 false)删除流程确认/取消两分支行为生效
AC-EL-CMP-024kit·Prompt弹窗usePrompt()({title,fields}) → Promise<string[]|null> 多字段弹窗,替代 window.prompt字段{label,initial,placeholder,multiline};Enter 提交 / Esc 或遮罩取消(null);副题「确认后提交;取消则不做任何改动」;multiline=textarea rows 3多字段表单提交取值/取消 null生效
AC-EL-CMP-025RegGate·注册门门控SAAS_REGISTRATION_OPEN=0 时把注册入口替换为灰字「注册暂未开放,请联系 support@zipforcehub.com」开关状态以 API /api/auth/registration-status 为准(营销页预渲染,构建时读不到运行时 env);拿不到状态时放行显示原入口(API 层 403 兜底),避免状态接口故障误藏入口关闭注册后入口页显示关闭文案;模拟状态接口故障入口仍在生效
AC-EL-CMP-026BrandContext·brand 模块级 storeProvider当前品牌选择=模块级外部 store(useSyncExternalStore),localStorage zf:brand:<slug> 持久化;info/brands 走 Provider context页面主组件在 AppShell 父级、context 只能向下传播——brand 若走 Provider 页面恒读空串(2026-09-09 修复:此前品牌切换对全部页面不生效);外部 store Provider 内外一致;隐私模式 localStorage 写失败静默忽略源码 BrandContext.tsx:27-29 注释;页首切换品牌全页联动生效
AC-EL-CMP-027BrandContext·初始化优先级门控登录后 info 到达时同步初始化当前品牌,优先级:localStorage 记忆 > 单品牌自动选中 > 账号同名品牌品牌拆开铁律——多品牌账号默认落在自己的品牌而非「全部」聚合,「全部」仅显式点击生效;namesake=brands.includes(slug)?slug:(brands[0]??"");记忆品牌被删回退账号同名;初始化幂等(inited ref 按 slug)多品牌新登录默认选中自己品牌非「全部」生效
AC-EL-CMP-028BrandContext·注册表级联注入Provider每次 info 到达幂等注入品牌色/展示名覆盖表 setBrandColorOverrides(info.brand_colors) / setBrandLabelOverrides(info.brand_labels)D类(2026-10-08)注册即级联 source_map.color + H9(2026-10-13) source_map.label 同款;展示名统一走 fmt.brandLabel,BrandBoard/NoonBoard 散写品牌名单已删租户改注册表色/名后全站点名即时生效生效
AC-EL-CMP-029BrandContext·useBrandReady门控品牌 store 初始化完成信号 hook;页面级请求 effect 必须等其为 true否则初始化前以 brand=""(全部聚合)打出请求——品牌拆开铁律下禁止(与 SHELL-002 门配套)源码 :79-87;新页面接入检查项生效
AC-EL-CMP-030AIContext·页面上下文注册ProvideruseAIContext({page,title,presets,getContext}) 声明「我是谁、能问什么、当前选择是什么」,供 AppShell 挂载的 🤖 面板消费栈式(LIFO)注册——同页多视图(如 sourcing 两个主 tab)各自入栈、卸载即弹出、栈顶生效;getContext 经 ref 恒取最新源码 AIContext.tsx;切 tab 面板标题/预设随之变生效
AC-EL-CMP-031AIChat·悬浮球与面板交互右下角固定悬浮球「🤖 AI 分析」(fixed right:20 bottom:20 zIndex 80,品牌底色圆角胶囊);点开面板 min(460px,100vw−32)×min(600px,100vh−110)无页面注册(cfg=null)时悬浮球不渲染;面板头「🤖 <title>」+「基于本页真实数据」+ ✕ 关闭;空会话列 presets 问题按钮;气泡 user 右对齐品牌底白字 / assistant 左对齐 bg 底;busy「🤖 正在分析数据…」;新消息自动滚底未注册页无球;注册页开面板提问往返生效
AC-EL-CMP-032AIChat·问答链路交互提问 POST /api/ai/page-chat {page: cfg.page||"generic", context: getContext(), question},回 {answer} 入气泡切页面(cfg.page 变)清空会话与错误;Enter 发送(e.nativeEvent.isComposing 防中文输入法组字误发);busy 期输入与发送禁用;失败红字错误条源码 send;中文输入法组字中回车不发送生效
AC-EL-CMP-033MatrixSection·四维矩阵本体表格平台×国家×品牌×SKU 全组合矩阵区:三下拉筛选(平台/国家/品牌,选项来自数据去重)+ DataTable 9 列 + 4 图数据 GET /api/matrix/data?brand= + /api/matrix/charts?brand=(仅随 brand prop 重查);列=平台/国家/品牌/SKU/收入(usd)/利润(红绿)/订单(int)/件数(int)/利润率(红绿 pct);受控排序先对筛选后全量排序再切片(pageSize 20)——分页下点列头是全局排序;工具栏尾「N 组 · 第 x/y 页」源码 MatrixSection.tsx(251 行);末页点排序核全局序生效
AC-EL-CMP-034MatrixSection·四图图表收入趋势图(线)/ 利润对比图(柱,x=品牌-国家)/ SKU 分布图(饼,收入)/ 国家热力图(横条,收入+利润双系列),高 286趋势 2026-09-28 修复——API 内层 key 为「{brand}/amz|{brand}/noon」非裸品牌名,原按裸名取值恒 0 趋势整条贴零;系列按真实 key 生成(两系列均 USD,Noon 侧 API 已按锚定汇率折算);数据未到整区 Skeleton趋势线 Noon 系列非全零生效
AC-EL-CMP-035MatrixSection·口径说明脚注表上方 caliber:四维矩阵分析口径金额=折 USD(Amazon=订单级,Noon=月度结算折 USD)|平台×国家×品牌×SKU 全组合矩阵|订单=count(Amazon 订单表+Noon 订单表)|营收=sum(Amazon revenue_usd + Noon gmv 折 USD)|广告=sum(Amazon ad_cost + Noon spends 折 USD)展开卡逐字核对生效
AC-EL-CMP-036BrandBoard·主看板主体契约引用品牌主看板(Amazon)共享主体,2026-09-15 从 /dashboard/[brand] 路由页抽出:独立路由壳与工作台内嵌复用同一主体(数据/交互/ChartGrid pageKey 不变)props{brandKey,brandLabel,compact,days?,from?,to?,country?}——compact=true 工作台内嵌受控(窗口随顶部时间选择器、KPI 区不渲染),全屏页自治时间窗 7/30/90/全部(3650);页面级条目在 §11.21(品牌看板路由批次)源码 BrandBoard.tsx(323 行)生效
AC-EL-CMP-037BrandBoard·数据源与缓存表格墙 GET /api/dashboard/charts?brand&platform=amazon&country&days[&frm&to];表格 GET /api/brandboard/orders(page_size 20)+ /api/brandboard/country-sku?limit=200墙按 winKey=days|from|to|country 缓存;品牌切换清墙缓存(内嵌实例不重挂载,不清则永显旧品牌数据);国家入缓存键与请求参数(2026-09-16 修「切国家看板不变」)切品牌/国家后请求重发、数据换生效
AC-EL-CMP-038BrandBoard·核心指标 5 卡KPI卡订单(foot=N 件)/ 营收 USD(foot=客单价 $)/ 净利 USD(foot=利润率 %)/ 费用 USD(foot=已回款 $)/ 取消率 %(foot=区间 from→to)值=墙 kpis 字段;仅全屏页渲染(compact 无);空值渲染「—」与墙响应 kpis 对算生效
AC-EL-CMP-039BrandBoard·图题与 EN 对照图表每图题=CHART_TITLES 中文题(EN 映射 80 键系 BrandBoard.tsx:42-73 声明的台账对照常量,全文件零引用未接线——「英文原名小字」仅 NoonBoard 渲染,见 CMP NoonBoard 条)sub=spec.hint 优先 API 动态值(本租户真前三)、CHART_TITLES 静态表兜底 + spec.sub 数据日「· 数据日 YYYY-MM-DD」(P3 ⑯);对齐 UVPVP Amazon 主看板 8 区块 81 图(6 图组+锚点导航+数据表格);锚点导航 tab「组名 N」+「📋 数据表格」抽图核对中英双题与 hint生效
AC-EL-CMP-040BrandBoard·图卡交互交互每图 ⬇CSV(specCsv:pie=项/值两列,其余=维度×系列矩阵)+ 独立日期区间 + ChartGrid 拖拽持久化独立区间仍是拖尾天数语义(rangeDays=区间天数 clamp [1,3650],独立窗墙按需加载、未加载回落全局);pageKey=/dashboard/<brand>:<组>设独立区间图卡换窗数据;CSV 打开核对生效
AC-EL-CMP-041BrandBoard·数据表格区表格📋 数据表格区:订单明细表(UVPVP 14 列:Order ID/Date/Country/Currency/Status/List Price/Price/Promotion/Commission/FBA Fees/Settlement/Settled/Rate%/SKUs,text/num 列筛混布,CSV+Excel)+ Country/SKU 汇总表(5 列:Country/SKU/Qty/Revenue Local/Revenue USD)caliber①订单明细:金额=折 USD|按下单时间倒序|List Price=本币金额(无挂牌价源)|Settlement=回款状态|源=cleaned_amazon_orders+order_fees;caliber②Country/SKU:件数与金额按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径);SKUs 列超 22 字截断+title 悬浮全文两表 caliber 展开逐字;列头 14/5 项核对生效
AC-EL-CMP-042BrandBoard·空态/被拒态空态墙 empty→「该品牌窗口内无订单数据」引导卡(试试「全部」窗口,或检查采集管道);墙未载且 err→「无法加载该品牌看板」引导卡(请从工作台品牌区进入)P3 缺陷㊴(2026-10-01)——品牌被拒(403/他牌)时 brandboard/* 的 catch(()=>{}) 吞错致骨架永卡/「第1/1页·0条」误导;chart_count 行空墙 from/to 为 null 时省略「( → )」括号段(P3 残片修复)越权品牌直达路由看引导卡不卡骨架生效
AC-EL-CMP-043NoonBoard·主看板主体契约引用Noon 品牌主看板共享主体(2026-09-15 抽出):独立路由壳与工作台内嵌复用;props 同 BrandBoard数据 GET /api/brandboard/noon?brand&days&country[&frm&to] + /api/noon-inventory?brand=(FBN 摘要);墙缓存/品牌切换清缓存逻辑同 BrandBoard;pageKey=/dashboard/noon/<brand>:<组>;页面级条目在 §11.21源码 NoonBoard.tsx(248 行)生效
AC-EL-CMP-044NoonBoard·KPI 与 FBN 卡KPI卡4 KPI 卡(窗口订单件·foot 最新日件 / 取消率·foot CIR 率 / 最新月 GMV(折 USD·月度结算口径)/ 最新月利润(结算净额−广告))+ 📦 FBN Inventory Alert 卡FBN 卡值=summary.stock,foot「🔴urgent · 🟡watch · 🟢ok · 缺口 Nu · Pd(快照 date)」+「明细 →」链 /inventory;urgent>0 卡红边框;无快照「暂无快照(等待每日 08:00 采集)」;KPI 仅全屏页渲染、FBN 卡两种形态均渲染FBN 数字与 /inventory 明细对算生效
AC-EL-CMP-045NoonBoard·EN 对照与审计说明脚注EN 映射 32 键(nDailyOrders…nCpsTrend,UVPVP 验收台账对照);尾部「📋 数据审计说明」卡 5 条已知偏差——Hub 无 Noon 日级金额,Daily GMV/AOV/Profit/结算率以月度口径替代(图题已标注);5 条=①订单/状态/CIR/取消/时段=noon_orders 件级按日(92 天滚动窗,每日 04:30 ingest)②金额类=月度结算折 USD ③利润=结算净额−广告(与工作台 Noon 月墙同口径唯一实现)④广告日趋势=noon_ads_daily、SKU 级=noon_sku_ads 月表 ⑤FBN=fbn_inventoryv2_aging 最新快照(SALEABLE 口径)92 天销速 35d/90d 线说明卡逐条与 §11.6 口径一致生效
AC-EL-CMP-046NoonStatement·表①官方对账单表格财务页 Noon 表①:官方对账单 26 字段整表(截图原序不拆分):月份|品牌|市场|期初余额|净入账|总费用|打款|期末余额|8 费项×(含税|VAT)|银行转账|余额转账#55b 用户令「按照这两个表格来」(2026-10-09);8 费项=广告费/佣金/FBN 出库/退回退款/保修/退货管理/破损退/促销(STMT_FEES 顺序);源=api/routers/finance.py /api/noon/summary + #47 拍板——各费项=含税实扣、贷记冲减为正;/noon 页同源引用本组件常量(26 列全分项见 §11.6)列头 26 字段逐字比对用户截图原序生效
AC-EL-CMP-047NoonStatement·VAT 内拆列组每费项拆「含税|VAT」两列,VAT=含税×市场税率,税率写死 STMT_VAT_RATE={SA:15/115, AE:5/105}VAT>0 绿色显示;聚合层不先拆——渲染层按市场税率对聚合后含税值内拆(率恒定,与逐月拆后求和等价);期初/期末/打款等非费项列不拆SA 行 VAT=含税×15/115 手算核对生效
AC-EL-CMP-048NoonStatement·月/季/年聚合表格STMT_GRAINS 月/季/年聚合 aggregateStmts(客户端,源=月粒度行),分组键=品牌|市场|期间期初=期内首月期初、期末=期内末月期末,其余 13 列(净入账/总费用/打款/8 费项/银行转账/余额转账)期内求和;组内全 null 保持 null;排序 mon 降序→品牌→市场;表② aggregateOps 同法(15 量列求和)季行=三月行手算对(期初取首月、期末取末月)生效
AC-EL-CMP-049NoonStatement·表②月度经营总表表格表②:月度经营总表 20 字段(用户字段清单逐字):月份|品牌|市场|Orders|Units Sold|Valid Units|Delivered|Pending|Cancel Order|未妥投|CIR|GMV|Commission|Delivery|Ad Spend|Gross Profit|COGS|Net Profit|Settlement 净额|PayoutOPS_COLS 17 数据列(英文 head 逐字+未妥投/CIR/Settlement 净额中英混合);gross=settlement−ad、net=gross−cogs(聚合后推导列);net<0 红字、gross/net strong 加粗;金额列 muted、计数列裸数字(toLocaleString 0 位小数)列头逐字比对清单;net 手算生效
AC-EL-CMP-050NoonStatement·期间下拉筛选#56 期间下拉(墙钟锚定):今年/本月/上月/近3月/近12月/去年 + #56b 单月键(YYYY-MM 合法,窗口=[该月,该月])periodRange 返回 [起月,止月](this_year=YYYY-01~YYYY-12 等);标题 periodLabel——单月→「2026-09」、月度→月键、年→「YYYY 全年」、近3月→「YYYY-MM~MM」;未知键回本月选上月窗口=上个自然月整月生效
AC-EL-CMP-051CustomModules·模块本体与 CRUD表格每页尾部「🧩 自定义分析」区:模块网格 +「+添加自定义图表」卡;模块=租户共享,卡片署创建者清单 GET /api/reports/defs?page=<page>;新建 POST /api/reports/defs;编辑 PUT /api/reports/defs/{id}(挂账⑤全量预填,原先只能删了重建;域已下线回退 daily);删除 DELETE /api/reports/defs/{id}——确认弹窗露创建人防误删他人图表(挂账⑫);数据域清单 GET /api/reports/fields 拉取失败显式报错+可重试(挂账③,原「添加」静默死点);后端=白名单引擎 5 域 report_defs 注册表(租户 RLS)增/改/删全链路 + 刷新持久 + 他账号可见共享生效
AC-EL-CMP-052CustomModules·编辑器弹窗添加/编辑弹窗:数据域 tab(5 域 daily/stock/rank/noon/noon_daily)→ 维度 chip 多选(第 1 个为 X 轴)→ 度量 chip 多选 → 图型 6 选(折线/柱状/堆叠/饼图/横向条形/表格)→ 时间窗(7/14/30/90/180/365 天)→ 标题(留空自动生成「度量×度量 按 维度/维度」)维度/度量不限量(上限即白名单);时间窗仅 daily 域可选,其余四域固定窗/全量置灰+WIN_HINT 说明防死选项(2026-10-20);品牌联动——def 不烘焙品牌,渲染期套用查看者页首品牌(页首切换→覆盖卡片级选择的主从语义);域切换重置维度度量为默认;daily 域特殊维提示(sku=广告侧仅广告指标/status=订单侧含取消/词维活动与搜索词互斥)建图保存后刷新在列;切页首品牌卡片数据随变生效
AC-EL-CMP-053CustomModules·卡片查询与筛选筛选模块卡片:POST /api/reports/query {domain,dims,metrics,chart_type,filters}(叠页首品牌/国家);表头筛选行——维度列=下拉精确选值(级联:先选国家 SKU 下拉只剩该国 SKU)、度量列=Min-Max 区间;「图表/表格」切换;「筛后 N/M 行」计数筛选同时作用于表格与图表;无数据「该筛选下无数据(不显示误导性 0)」,note「该图表暂不可计算…」红字;表格仅显示前 100 行并提示总数;筛后 0 行仍渲染表头筛选行(否则筛选框随表卸载无法清筛回退);下拉选项跨查询记忆(useRef 累积见过的取值防选项塌缩,2026-10-20);品牌/国家下拉仅选项>1 时出现选维度值图表联动;筛至 0 行可清筛恢复生效
AC-EL-CMP-054CustomModules·成图规则图表dims[0]=X 轴,其余维度组合拆系列(多度量时系列名「组合·度量」);饼图=全维度组合为扇区×首个度量多度量饼图不再只画首度量——逐度量各一饼、各自量纲独立成图(挂账①);顺带修复裸数字数组被 d.value>0 滤空的隐性 bug;渲染走 GChart specToOption 单源两维×两度量图系列数=组合数×2生效
AC-EL-CMP-055CustomModules·Noon 本币提醒脚注noon 域选金额度量且未选「国家/站点」维时编辑器行内提醒挂账⑥——NOON_LOCAL={noon_gmv,noon_net,noon_ad,noon_commission} 站点本币(AE=AED/SA=SAR)未拆国家维直接相加;文案「…两种币种直接相加——建议勾选国家维拆分」构造该组合看提醒文案出现生效

§11.27 财务页六大表列级展开(/finance · AC-EL-FIN-C 系列,源码 web/app/finance/page.tsx + web/components/NoonStatement.tsx + api/routers/finance.py;六表=019 分市场/027 矩阵/031 Noon SKU 深度/037 官方对账单/038 月度经营总表/057 项目×月对账)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-FIN-C-001卡头 h2卡头「Amazon {月} 累计 · 分市场」+ sub 结算净额/毛利润/净利润三公式/api/finance/kpi-wall;page.tsx:718文案断言生效
AC-EL-FIN-C-002月份下拉筛选器monOpts select 切 amzMonpage.tsx:720-724;kpi-wall?month 联动切月行值变生效
AC-EL-FIN-C-003表头行(17 th)表头市场/订单/已结算/销售件数/取消订单/本土币营收/净收款/佣金/尾程配送FBA/结算净额/广告/VAT/毛利润/毛利率/采购成本/净利润/回款原 17 th(page.tsx:729-731)vs amzRow 18 td(page.tsx:693-710)列数不等的表头缺陷已修:2026-10-22 用户拍板补表头,th 序列插入「在途 Pending」(现 page.tsx:729),18 th=18 td;web 重建上线,浏览器 DOM 探针实测 thead th=18/首行 td=18(tools/_gate_fin_th_20261022.log),frontend_e2e 门禁 ALL PASS浏览器 DOM 数列:thead th=18 / tbody tr td=18(2026-10-22 实测通过)生效
AC-EL-FIN-C-004列1 市场+币种列市场名 + cur3 灰字小号amzRow td1(page.tsx:693);全市场行=「全市场 USD」首行文案生效
AC-EL-FIN-C-005列2 订单列int(orders)orders=aord 剔取消(AC-CAL-02);td2(694)SQL aord 对拍生效
AC-EL-FIN-C-006列3 已结算列int(settled_orders),null→—has_finance 计数;td3(695)SQL 对拍生效
AC-EL-FIN-C-007列4 销售件数列int(units)td4(696)SQL 对拍生效
AC-EL-FIN-C-008列5 pending 在途(无表头列)列int(pending??0),muted2026-09-27 五态归并:在途=shipped/exported;原 td5(:697)无表头致其后错位一格——2026-10-22 已补「在途 Pending」th(列序:销售件数/在途/取消订单),错位消除,本列转有头常规列浏览器 DOM 断言 th5=在途 Pending、th6=取消订单(探针实测通过)生效
AC-EL-FIN-C-009列6 取消订单列int(canceled),有取消红字canceled=can 'Canceled' 单变体;td6(698)实际位于表头「本土币营收」名下(错位见上条)SQL 对拍+DOM 数列生效
AC-EL-FIN-C-010列7 本土币营收列local_revenue null→—否则 localCur2026-09-18/19 本土币列;td7(699)SA 行=SAR 标注生效
AC-EL-FIN-C-011列8 净收款列local_revenue 有→本币否则 usd(net_proceeds)td8(700)对拍生效
AC-EL-FIN-C-012列9 佣金列local_commission 优先,回退 usd(commission),mutedtd9(701)对拍生效
AC-EL-FIN-C-013列10 尾程配送 FBA列local_fba 优先,回退 usd(fba),mutedtd10(702);noon 尾程=delivery(2026-09-27)对拍生效
AC-EL-FIN-C-014列11 结算净额列localSettle=本土币营收−佣金−尾程−促销−其他;USD 路径=净收款−…;title 悬停展开实算式td11(703)悬停公式=列值生效
AC-EL-FIN-C-015列12 广告列local_ad 优先,币种=ad_ccy||cur3td12(704)对拍生效
AC-EL-FIN-C-016列13 VAT列local_vat 优先,回退 usd(vat??0),title=order_fees.vat 本币优先td13(705)对拍生效
AC-EL-FIN-C-017列14 毛利润列gross=settlement−ad;本币路径 localGross=localSettle−local_ad;posColortd14(706)复算生效
AC-EL-FIN-C-018列15 毛利率列mgn=gross/net_proceeds×100,.1f%;null→—td15(707)复算生效
AC-EL-FIN-C-019列16 采购成本列product_cost_rmb 原生 ¥ 千分位 0 位,null→—,title=采购成本(RMB)td16(708);不折 USDRMB 原值生效
AC-EL-FIN-C-020列17 净利润列net=gross−product_cost,全程 USD 计算(严禁币种混算),strong+posColortd17(709)复算生效
AC-EL-FIN-C-021列18 回款列usd(payout),null→—td18(710)对拍生效
AC-EL-FIN-C-022全市场行行首行「全市场 USD」底色 #fbfcfdamzRow(wA.amazon.all,…,true)(734)首行样式生效
AC-EL-FIN-C-023销量柱状图图Orders bar + Net Profit line + dataZoom 可拖动amzChartOpt(741)EChart h=280切月联动生效
AC-EL-FIN-C-024卡头+年份下拉卡头矩阵标题 + 「全部年份」select/full matrix;matRef 供导出 Excel导出列数=23生效
AC-EL-FIN-C-025列1 月份列r.mon,num strong行键=brand+mon(1541)排序断言生效
AC-EL-FIN-C-026列2 品牌列branddot 色点+品牌名brandColor(r.brand)色点恒渲染生效
AC-EL-FIN-C-027列3 订单列int(orders)/full matrix;AC-CAL-02 aord 剔取消抽月 SQL 对拍生效
AC-EL-FIN-C-028列4 已结算列int(settled),stronghas_finance 计数对拍生效
AC-EL-FIN-C-029列5 销售件数列int(units)—对拍生效
AC-EL-FIN-C-030列6 取消订单列int(canceled),有值红字'Canceled' 变体对拍生效
AC-EL-FIN-C-031列7 有效订单列int(valid),valid=orders−canceled 前端派生与 016 订单(aord 三变体 FILTER)同义不同实现;2026-10-22 实测 canceled 仅 'Canceled' 两值相等;差异归 AC-PEND-02 统一抽行复算+AC-PEND-02 跟踪生效
AC-EL-FIN-C-032列8 净收款列usd(revenue,2)—对拍生效
AC-EL-FIN-C-033列9 佣金列usd(|commission|,2),muted绝对值化对拍生效
AC-EL-FIN-C-034列10 FBA列usd(|fba|,2),muted—对拍生效
AC-EL-FIN-C-035列11 促销列usd(|promo|,2),muted—对拍生效
AC-EL-FIN-C-036列12 广告列usd(ad,2),muted—对拍生效
AC-EL-FIN-C-037列13 广告销售列usd(ad_sales,2),mutedAMZ 侧 7 天归因对拍生效
AC-EL-FIN-C-038列14 ACOS列ad/ad_sales×100 .1f%;ad_sales≤0→——复算生效
AC-EL-FIN-C-039列15 TACOS列ad/revenue×100 .1f%;revenue≤0→——复算生效
AC-EL-FIN-C-040列16 VAT税列usd(vat??0,2),muted;title=Amazon 官方税额(已含在平台费扣减中)order_fees.vat对拍生效
AC-EL-FIN-C-041列17 采购成本 COGS列usd(cost,2)—对拍生效
AC-EL-FIN-C-042列18 结算净额列usd(net,2)/full net对拍生效
AC-EL-FIN-C-043列19 毛利润列gross=net−ad,正绿负红AC-CAL-01复算生效
AC-EL-FIN-C-044列20 毛利率列pct(margin(revenue,gross))—复算生效
AC-EL-FIN-C-045列21 净利润列net2=gross−cost,strong 正绿负红—复算生效
AC-EL-FIN-C-046列22 回款列usd(payout,2)—对拍生效
AC-EL-FIN-C-047列23 退款件列int(refunds),muted—对拍生效
AC-EL-FIN-C-048空态行空态「无数据」colSpan=23 居中matrix.length===0(1567)断数据渲染生效
AC-EL-FIN-C-049卡头文案「39 列深度表」卡头h2 固定文案「Noon SKU 表现 · 39 列深度表」原 page.tsx:966「39 列」与 NOON_SPEC 实际 44 项不符的文案缺陷已修:2026-10-22 用户令全修,改「44 列深度表」,web 重建上线,编译产物 39 列零残留/44 列在场,frontend_e2e 门禁 ALL PASS导出列数=44 复核(编译产物字符串核验通过)生效
AC-EL-FIN-C-050年份 pills筛选器YEAR_OPTS 今年/去年/前年 tab/api/finance/noon-sku?year切年重载生效
AC-EL-FIN-C-051国家下拉筛选器全部国家/SA/AEcountry 参数(973-976)过滤生效生效
AC-EL-FIN-C-052副标口径静态「本币(SAR/AED)· 头程按拍板以 0 录入」page.tsx:977文案断言生效
AC-EL-FIN-C-053汇总行汇总年窗口·合并(型号×颜色×国家)行数·订单·GMV·广告·净利润(正绿负红)items=品牌过滤后 reduce(960-963);净利润色按正负合计=Σ行生效
AC-EL-FIN-C-054错误横幅反馈红条 role=alerterr←catch(980)role=alert生效
AC-EL-FIN-C-055DataTable 容器表格排序/筛选/CSV=noon_sku/Excel=noon_sku/minWidth 3400/rowKey=brand+model+color+countryNOON_COLS 由 NOON_SPEC 生成;21 个金额列头加(本币)后缀(2026-10-03 用户令)导出列数=44生效
AC-EL-FIN-C-056caliber 口径块脚注6 个分句(|分隔,page.tsx:996 逐段数):金额本币(汇总行折USD)/毛净=结算净额/净利润=结算净额−广告−COGS(头程恒0)/广告=noon_ads_daily F2-6 单源 nsku 映射/有效件=件数−取消−不可投递−CIR/无销售有广告 SKU 不显示(PL 月表驱动)DataTable caliber prop(996)文案断言生效
AC-EL-FIN-C-057列1 型号列key=model,格式化 kind=strNOON_SPEC 第 1 项(数组 page.tsx:903–917,每行 4 项);行键组成抽行对拍生效
AC-EL-FIN-C-058列2 颜色列key=color,格式化 kind=mutedNOON_SPEC 第 2 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-059列3 品牌列key=brand,格式化 kind=brandNOON_SPEC 第 3 项(数组 page.tsx:903–917,每行 4 项);行键组成+品牌过滤键抽行对拍生效
AC-EL-FIN-C-060列4 国家列key=country,格式化 kind=mutedNOON_SPEC 第 4 项(数组 page.tsx:903–917,每行 4 项);SA=SAR / AE=AED 分行抽行对拍生效
AC-EL-FIN-C-061列5 SKU数列key=skus,格式化 kind=numNOON_SPEC 第 5 项(数组 page.tsx:903–917,每行 4 项);合并 SKU 数抽行对拍生效
AC-EL-FIN-C-062列6 订单 Orders列key=orders,格式化 kind=numNOON_SPEC 第 6 项(数组 page.tsx:903–917,每行 4 项);订单号去重抽行对拍生效
AC-EL-FIN-C-063列7 销售件数 Units Sold列key=units,格式化 kind=numNOON_SPEC 第 7 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-064列8 取消订单 Cancel Order列key=cancelled,格式化 kind=absNOON_SPEC 第 8 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-065列9 不可投递列key=undeliverable,格式化 kind=absNOON_SPEC 第 9 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-066列10 CIR列key=cir,格式化 kind=absNOON_SPEC 第 10 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-067列11 有效件 Valid Units列key=valid_orders,格式化 kind=numBNOON_SPEC 第 11 项(数组 page.tsx:903–917,每行 4 项);=件数−取消−不可投递−CIR抽行对拍生效
AC-EL-FIN-C-068列12 GMV列key=gmv,格式化 kind=numNOON_SPEC 第 12 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-069列13 佣金 Commission列key=commission,格式化 kind=absNOON_SPEC 第 13 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-070列14 履约费列key=delivery_fee,格式化 kind=absNOON_SPEC 第 14 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;noon 尾程抽行对拍生效
AC-EL-FIN-C-071列15 运费补贴列key=shipping_credits,格式化 kind=absNOON_SPEC 第 15 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-072列16 其他订单 Orders费列key=other_order_fees,格式化 kind=absNOON_SPEC 第 16 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-073列17 订单 Orders补贴列key=order_subsidies,格式化 kind=absNOON_SPEC 第 17 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-074列18 非订单 Orders费列key=non_order_fees,格式化 kind=absNOON_SPEC 第 18 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-075列19 非订单 Orders补贴列key=non_order_subsidies,格式化 kind=absNOON_SPEC 第 19 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-076列20 其他列key=others,格式化 kind=absNOON_SPEC 第 20 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-077列21 VAT(推算)列key=vat_est,格式化 kind=absNOON_SPEC 第 21 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;五费×市场税率内拆+广告×外加(finance.py)抽行对拍生效
AC-EL-FIN-C-078列22 结算 Settlement净额列key=settlement,格式化 kind=numBNOON_SPEC 第 22 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-079列23 退款 Refund列key=refund,格式化 kind=absNOON_SPEC 第 23 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-080列24 曝光量 Impression列key=views,格式化 kind=numNOON_SPEC 第 24 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-081列25 点击列key=clicks,格式化 kind=numNOON_SPEC 第 25 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-082列26 CTR列key=ctr,格式化 kind=pctNOON_SPEC 第 26 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-083列27 ATC列key=atc,格式化 kind=numNOON_SPEC 第 27 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-084列28 广告花费 Ad Spend订单 Orders列key=ad_orders,格式化 kind=numNOON_SPEC 第 28 项(数组 page.tsx:903–917,每行 4 项);表头文案为源码原样(双语拼接),勿当错字改抽行对拍生效
AC-EL-FIN-C-085列29 CVR列key=cvr,格式化 kind=pctNOON_SPEC 第 29 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-086列30 广告花费 Ad Spend花费 Spend列key=ad_cost,格式化 kind=numNOON_SPEC 第 30 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-087列31 广告花费 Ad Spend销售列key=ad_revenue,格式化 kind=numNOON_SPEC 第 31 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-088列32 ACOS列key=acos,格式化 kind=pctDNOON_SPEC 第 32 项(数组 page.tsx:903–917,每行 4 项);>50% 红标抽行对拍生效
AC-EL-FIN-C-089列33 TACOS列key=tacos,格式化 kind=pctDNOON_SPEC 第 33 项(数组 page.tsx:903–917,每行 4 项);>30% 红标抽行对拍生效
AC-EL-FIN-C-090列34 CPC列key=cpc,格式化 kind=d2NOON_SPEC 第 34 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-091列35 CPS列key=cps,格式化 kind=d2NOON_SPEC 第 35 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-092列36 单件成本 Cost列key=cost_per_unit,格式化 kind=d2xNOON_SPEC 第 36 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-093列37 有效件 Valid Units成本 Cost列key=valid_orders_cost,格式化 kind=numNOON_SPEC 第 37 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-094列38 头程列key=first_mile,格式化 kind=absNOON_SPEC 第 38 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;按拍板恒 0 录入抽行对拍生效
AC-EL-FIN-C-095列39 不可售件列key=unsaleable,格式化 kind=absNOON_SPEC 第 39 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-096列40 不可售成本 Cost列key=unsaleable_cost,格式化 kind=absNOON_SPEC 第 40 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-097列41 毛净列key=gross_net,格式化 kind=numNOON_SPEC 第 41 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;=结算净额抽行对拍生效
AC-EL-FIN-C-098列42 净利润 Net Profit列key=net_profit,格式化 kind=signBNOON_SPEC 第 42 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;正绿负红抽行对拍生效
AC-EL-FIN-C-099列43 净利润 Net Profit率列key=margin,格式化 kind=pctSNOON_SPEC 第 43 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-100列44 单件履约列key=unit_fulfill,格式化 kind=d2NOON_SPEC 第 44 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-101卡头 h2卡头「官方对账单 · Noon {期间} 累计 · 分市场」+ sub 26 字段全分项·本币口径(未折 USD)/api/noon/summary(finance.py:295,cleaned_noon_statement)文案断言生效
AC-EL-FIN-C-102期间下拉筛选器OPS_PERIODS 6 档(今年/本月/上月/近3月/近12月/去年)+ 单月 optgroup(#56b 用户令)opsPeriod 两表共用;periodRange 墙钟锚定切期行集变生效
AC-EL-FIN-C-103粒度 tabs筛选器月/季/年(STMT_GRAINS)stmtGrain 两表共用;stmtPeriodKey Q 分桶M→Q→Y 聚合守恒生效
AC-EL-FIN-C-104双行表头表头第一行 rowSpan=8 基础列+8 费项 colSpan=2+银行/余额;第二行 8×(含税/VAT)NoonStatement.tsx:124-137;物理列=26(8+16+2)DOM 数列=26生效
AC-EL-FIN-C-105列1 月份列label;Q→「2026 Q3」格式aggregateStmts 输出分桶断言生效
AC-EL-FIN-C-106列2 品牌列brand;分组键=brand|market|期全量口径不随全局品牌筛选(脚注披露)切品牌行不变生效
AC-EL-FIN-C-107列3 市场列market(SA/AE)币种由市场决定对拍生效
AC-EL-FIN-C-108列4 期初余额列money() 千分位 0 位聚合=期内首月期初(opening 取 first)M→Q 守恒(端点)生效
AC-EL-FIN-C-109列5 净入账列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-110列6 总费用列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-111列7 打款列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-112列8 期末余额列money()聚合=期内末月期末(closing 取 last)M→Q 守恒(端点)生效
AC-EL-FIN-C-113列9 广告费·含税列money(v) muted含税实扣(源=cleaned_noon_statement.ads);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-114列10 广告费·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-115列11 佣金·含税列money(v) muted含税实扣(源=cleaned_noon_statement.referral);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-116列12 佣金·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-117列13 FBN 出库·含税列money(v) muted含税实扣(源=cleaned_noon_statement.fbn);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-118列14 FBN 出库·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-119列15 退回退款·含税列money(v) muted含税实扣(源=cleaned_noon_statement.returns);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-120列16 退回退款·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-121列17 保修·含税列money(v) muted含税实扣(源=cleaned_noon_statement.warranty);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-122列18 保修·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-123列19 退货管理·含税列money(v) muted含税实扣(源=cleaned_noon_statement.ret_admin);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-124列20 退货管理·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-125列21 破损退·含税列money(v) muted含税实扣(源=cleaned_noon_statement.damaged);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-126列22 破损退·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-127列23 促销·含税列money(v) muted含税实扣(源=cleaned_noon_statement.promo);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-128列24 促销·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-129列25 银行转账列money(bank_tr) muted钱包划转(非应税);SUM_KEYS对拍生效
AC-EL-FIN-C-130列26 余额转账列money(bal_tr) muted钱包划转(非应税);SUM_KEYS对拍生效
AC-EL-FIN-C-131聚合口径条目口径期初/期末取端点,其余 13 键(净入账/总费用/打款/8费项/银行/余额)期内求和NoonStatement.tsx:84-85 SUM_KEYS+aggregateStmtsM→Q→Y 聚合守恒复算生效
AC-EL-FIN-C-132全量口径脚注脚注各费项左列=含税实扣·右列=VAT 内拆…本区块为 Noon 全量口径,暂不随全局品牌筛选page.tsx:834-838文案断言生效
AC-EL-FIN-C-133卡头 h2卡头「月度经营总表 · Noon {期间} 累计 · 分市场」+ sub Orders → Payout 20 字段·本币口径/api/finance/noon-ops(finance.py:2122)文案断言生效
AC-EL-FIN-C-134期间下拉(共用)筛选器同表① opsPeriod 同 state#56 两表共用期间下拉两表同步切生效
AC-EL-FIN-C-135粒度 tabs(共用)筛选器同表① stmtGrain 同 state两表共用粒度两表同步切生效
AC-EL-FIN-C-136列1 月份列label;Q 格式同表①aggregateOps分桶断言生效
AC-EL-FIN-C-137列2 品牌列brand;分组键=brand|market|期—对拍生效
AC-EL-FIN-C-138列3 市场列market(SA/AE)币种由市场决定对拍生效
AC-EL-FIN-C-139列4 Orders列int 千分位订单号去重;OPS_SUM_KEYS 求和SQL 去重对拍生效
AC-EL-FIN-C-140列5 Units Sold列int件数对拍生效
AC-EL-FIN-C-141列6 Valid Units列int六态:Valid=Units−Cancel−未妥投−CIR复算生效
AC-EL-FIN-C-142列7 Delivered列int件数六态对拍生效
AC-EL-FIN-C-143列8 Pending列int件数六态对拍生效
AC-EL-FIN-C-144列9 Cancel Order列int件数六态对拍生效
AC-EL-FIN-C-145列10 未妥投列int件数六态(undeliverable)对拍生效
AC-EL-FIN-C-146列11 CIR列int件数六态对拍生效
AC-EL-FIN-C-147列12 GMV列money 本币实值—对拍生效
AC-EL-FIN-C-148列13 Commission列money含税实扣对拍生效
AC-EL-FIN-C-149列14 Delivery列money含税实扣对拍生效
AC-EL-FIN-C-150列15 Ad Spend列money广告源为净额,按市场加 VAT(SA 15% · AE 5%)对齐对账单实扣对拍生效
AC-EL-FIN-C-151列16 Gross Profit列money,stronggross=Settlement 净额−Ad Spend(聚合后派生)复算生效
AC-EL-FIN-C-152列17 COGS列moneyCOGS=Valid Units×采购单价(SKU 映射表为准回退采购表,折本币)复算生效
AC-EL-FIN-C-153列18 Net Profit列money,strong,<0 红字net=gross−COGS复算生效
AC-EL-FIN-C-154列19 Settlement 净额列money 本币实值—对拍生效
AC-EL-FIN-C-155列20 Payout列money官方对账单打款(同表①,各账号对账单去重后求和)对拍生效
AC-EL-FIN-C-156脚注口径脚注六态口径/广告含 VAT 对齐/COGS 折本币/季/年=月值求和page.tsx:868-873文案断言生效
AC-EL-FIN-C-157列1 月份列月份/api/finance/monthly排序断言生效
AC-EL-FIN-C-158列2 项目(品牌)列项目=品牌—对拍生效
AC-EL-FIN-C-159列3 订单列订单数—对拍生效
AC-EL-FIN-C-160列4 退款单列退款单数—对拍生效
AC-EL-FIN-C-161列5 营业收入列USD—对拍生效
AC-EL-FIN-C-162列6 退款列金额—对拍生效
AC-EL-FIN-C-163列7 佣金列金额—对拍生效
AC-EL-FIN-C-164列8 履约列金额—对拍生效
AC-EL-FIN-C-165列9 VAT列金额—对拍生效
AC-EL-FIN-C-166列10 其他费列金额—对拍生效
AC-EL-FIN-C-167列11 净利润列金额fm 口径(AC-CAL-07)复算生效
AC-EL-FIN-C-168列12 账单总额列平台账单—对拍生效
AC-EL-FIN-C-169列13 结算到账列Settlements 月度—对拍生效
AC-EL-FIN-C-170列14 差额①列账单−结算,|差|>1 标 warn 色对账缺口代数复算差额=账单−结算生效
AC-EL-FIN-C-171列15 打款列金额—对拍生效
AC-EL-FIN-C-172列16 差额②列打款侧差额,|差|>1 标 warn 色—代数复算生效
AC-EL-FIN-C-173列17 广告列金额—对拍生效

§11.28 选品六外部 tab 组件内部元素(/sourcing · AC-EL-SRC-W/V/S/D/F/X 系列,源码 web/app/sourcing/{WatchTab,ViewerTab,SellerTab,DealsTab,FinderTab,VerdictsTab}.tsx;Keepa 配额池口径与缓存说明随元素记录)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-W-001Keepa 未配置空态空态EmptyState「Keepa 通道未配置」keepa_configured=false 整 tab 替换(112-118)断配置渲染生效
AC-EL-SRC-W-002KPI 监控池KPI卡count / watch_limit上限按套餐(可升级)SQL 对拍生效
AC-EL-SRC-W-003KPI 今日搜索配额KPI卡quota_left每次搜索/拉历史消耗 1 次(配额池口径)搜索后 -1生效
AC-EL-SRC-W-004KPI 每日自动刷新KPI卡KEEPA_REFRESH_UTC 常量worker 自动抓取池内全部 ASIN文案断言生效
AC-EL-SRC-W-005实时搜索卡头卡头「实时搜索 · 加入监控」+ Keepa 实时数据·消耗当日搜索配额/api/sourcing/search文案断言生效
AC-EL-SRC-W-006站点 select筛选器13 域(US…NL,WatchTab.tsx:13 逐项数;12=BR/13=AU 2026-10-21 回滚勘误)DOMAINS(13)13 项断言生效
AC-EL-SRC-W-007关键词 input输入≥2 字符校验<2 报「关键词至少 2 个字符」空/1 字符报错生效
AC-EL-SRC-W-008搜索按钮按钮搜索中…禁用态GET /search?q&domain;返回 quota_left 并 load()点击出结果生效
AC-EL-SRC-W-009错误横幅反馈红条 role=alerterr←catchrole=alert生效
AC-EL-SRC-W-010Spinner反馈「实时查询 Keepa…」searching 态加载中出现生效
AC-EL-SRC-W-011无结果空态空态EmptyState「无结果」results.length===0冷词断言生效
AC-EL-SRC-W-012结果表 8 列表格商品/Buybox/BSR/30·90 天掉榜(断货)/FBA 卖家/评分/评分数/操作SearchItem 全字段列序断言生效
AC-EL-SRC-W-013+监控按钮按钮POST /api/sourcing/watchpulled=true→「已加入监控并完成首次抓取」否则每日任务补齐点击变已监控生效
AC-EL-SRC-W-014已监控 badge徽章badge ok「已监控」watched=true 行不再显按钮重复加被拦生效
AC-EL-SRC-W-015监控池卡头卡头「监控池」每日自动刷新·近 7 日趋势迷你图/api/sourcing/watchlist文案断言生效
AC-EL-SRC-W-016池空空态空态EmptyState 引导用上方搜索items.length===0空池断言生效
AC-EL-SRC-W-017监控池表 11 列表格商品/站点/Buybox/BSR/30 天掉榜/FBA/评分/近 7 日价格/🔔提醒/快照/操作WatchItem 全字段列序断言生效
AC-EL-SRC-W-018ASIN 深链 viewer链接点击 SPA 无刷新跳价格历史 tabsetQs({mtab:viewer,…});中键/Ctrl 新开(F6);保留 href左键无刷新生效
AC-EL-SRC-W-019🛒 Amazon 外链链接amzUrl(domain,asin) 新标签stopPropagation 不触发行点击新开商品页生效
AC-EL-SRC-W-020近 7 日 sparkline图EChart h=34 线图 #4f46e5trend≥2 点否则「数据不足」悬停不抖生效
AC-EL-SRC-W-021提醒 badge徽章「监控中/已触发 ≤/≥ 目标价」每日 05:10 评估;title=已触发时间;触发后可清除重设设价后次日评估生效
AC-EL-SRC-W-022目标价 input+方向 select输入number 目标价 + ≤/≥ 下拉回车提交;价必须>0;POST /api/sourcing/watch/alert非法价报错生效
AC-EL-SRC-W-023清除提醒按钮按钮清除 badge 下的 ghost 按钮alert price=null清后回输入态生效
AC-EL-SRC-W-024快照日期列列as_of 取 MM-DD—对拍生效
AC-EL-SRC-W-025移除按钮按钮confirm「移除监控 {asin}?历史快照保留」DELETE /api/sourcing/watch/{wid}移除后行消失生效
AC-EL-SRC-W-026详情 drawer弹层行点击开 drawer-mask maxWidth 640setDetail(it)点遮罩关闭生效
AC-EL-SRC-W-027drawer 元信息静态站点·ASIN·Buybox·BSR·评分detail 字段对拍生效
AC-EL-SRC-W-02890 天历史图图新品价线(#4f46e5)+BSR 副轴(#d97706 反转)GET /product?asin&domain(耗 1 配额);无序列提示拉后 load()生效
AC-EL-SRC-W-029零配额说明+拉取按钮按钮「详情默认展示池内已有快照(零配额消耗);拉取 90 天完整历史会消耗 1 次搜索配额」配额披露文案(281-283)文案断言生效
AC-EL-SRC-W-030drawer 移除/关闭按钮底部 ghost 移除监控/关闭—关闭清 detail生效
AC-EL-SRC-V-001国家 select筛选器KEEPA_COUNTRIES 13 站AE/SA/SE 不采集被收窄(F2 修,选中必 400)13 项断言生效
AC-EL-SRC-V-002ASIN input输入mono 大写自动转,10 位校验^[A-Z0-9]{10}$ 否则报错(67)非法 ASIN 报错生效
AC-EL-SRC-V-003查看价格历史按钮按钮载入中…禁用GET /api/sourcing/price-history?country&asin&range&live点击出档案生效
AC-EL-SRC-V-004时间档 pills筛选器全部/3年/1年/90天/30天RANGES;source≠none 才显示切档重载生效
AC-EL-SRC-V-005错误横幅反馈红条;失败时清空旧 data 防残留误导(F4 修)err←catch;setData(null)断网断言生效
AC-EL-SRC-V-006Spinner反馈「读取时序…」busy 态加载中出现生效
AC-EL-SRC-V-007无数据空态空态EmptyState「该 ASIN 尚未采集入库(无数据)」+ 实时拉取按钮(1 配额,24h 缓存)+ 🛒 外链source=none(205-216);live=1 重查点拉取出图生效
AC-EL-SRC-V-008档案卡头卡头标题(回退 ASIN)+ 国家·ASIN + 🛒 小外链meta.title||asin对拍生效
AC-EL-SRC-V-009🛒 在 Amazon 打开按钮按钮数据视图保留醒目外链2026-10-07 用户令「拉取完历史后 Amazon 按钮不能消失」拉后仍在生效
AC-EL-SRC-V-010KPI 品牌KPI卡meta.brand 回退 ——对拍生效
AC-EL-SRC-V-011KPI 当前 BSRKPI卡bsr_current,foot=月销 monthly_sold—对拍生效
AC-EL-SRC-V-012KPI BuyBoxKPI卡buy_box_price 本币,foot=offers 已采/未 offers 采集csv[18] 三元组(分期三 A)未采显「未 offers 采集」生效
AC-EL-SRC-V-013KPI New/AmazonKPI卡price_new / price_amazon,foot=Used·List—对拍生效
AC-EL-SRC-V-014KPI 评分/评论KPI卡rating .1f / reviews,foot=上市 listed_since—对拍生效
AC-EL-SRC-V-015KPI 时序覆盖KPI卡首日→末日,foot=N 序列·M 点span=全部序列 min/max对拍生效
AC-EL-SRC-V-016数据源 badge徽章「本库 csv 时序(零 token)」ok /「Keepa 实时拉取(1 配额)」+「·缓存」source=local|live;cached冷/热查对比生效
AC-EL-SRC-V-017BuyBox 时序 badge徽章「已解锁(offers 采集)」/「无数据(待 offers 采集铺开)」series.buy_box_price≥2 点判未铺开 ASIN 显灰生效
AC-EL-SRC-V-018价格历史图图7 线:Amazon 橙/New 蓝/Used 绿/List 紫/收藏棕/秒杀红/BuyBox 黑;dataZoom 滚轮+滑条PRICE_LINES 配色对照 Keepa;≥2 点才画线图例可切换生效
AC-EL-SRC-V-019Keepa 官方原图卡图90/365 天 tab + /api/sourcing/keepa-graph 代理 PNG w900 h3201 配额/图;同参数 90min Keepa 侧免配额;redis 5400s;key 不出后端;截不到=无价格记录二次加载 0 配额生效
AC-EL-SRC-V-020BSR 排名历史图图y 轴反转(小=好)#d97706rank 序列方向断言生效
AC-EL-SRC-V-021报价数历史图图New/Used/收藏品卖家数三线count_* 序列图例断言生效
AC-EL-SRC-V-022评分·评论增长图图左轴评分 0-5 紫 / 右轴评论数灰rating+reviews 双序列双轴断言生效
AC-EL-SRC-V-023🔔 价格提醒卡头卡头worker 每日 05:10 刷新后评估·触发邮件租户 owner·改价重新武装/api/sourcing/watch/alert文案断言生效
AC-EL-SRC-V-024已设 badge徽章「已设: 现价 ≤/≥ 目标价 · 已触发时间(改价可重新提醒)/监控中(每日评估)」alert_active;notified_at触发后显示生效
AC-EL-SRC-V-025未设提醒 badge徽章「未设提醒(已关注)」watch 存在但无提醒对拍生效
AC-EL-SRC-V-026目标价+方向+设置按钮输入number+below/above select+设置/更新价>0 校验;POST alert非法价报错生效
AC-EL-SRC-V-027清除提醒按钮按钮仅 alert_active 时显示price=null清后回未设生效
AC-EL-SRC-V-028一键「关注+设提醒」按钮未关注 ASIN:目标价+方向+「🔔 关注 + 设提醒」POST /watch 再 /watch/alert 链式;meta 缺失则提示先去监控池未关注流程生效
AC-EL-SRC-V-029无档案提示空态「该 ASIN 不在干净层档案(仅时序),请在监控池…」watch=null 且 meta=null对拍生效
AC-EL-SRC-V-030初始空态空态EmptyState「输入 ASIN 查看价格历史」!data&&!busy;其他 tab 可深链跳入冷启动断言生效
AC-EL-SRC-V-031提醒口径脚注脚注现价=最新快照 BuyBox(缺省回退 New);一次性触发;重设自动重新武装—文案断言生效
AC-EL-SRC-S-001卖家情报卡头卡头「🏪 卖家情报」+ 热销商家列表/卖家查询对照声明口径脚注:热销榜=本站已铺开 ASIN 池 BuyBox 赢家数(零 token);/seller Δ1 token/家;不冒充 pro/sellerfinder 内部端点文案断言生效
AC-EL-SRC-S-002站点 pills筛选器KEEPA_COUNTRIES 13 站F2 修:AE/SA/SE 选中必 400 已收窄13 项断言生效
AC-EL-SRC-S-003口径脚注脚注热销榜/卖家档案/官网类目筛选三段口径page 190-194文案断言生效
AC-EL-SRC-S-004错误横幅反馈红条 role=alerterr←catchrole=alert生效
AC-EL-SRC-S-005热销商家列表卡头卡头按池内 BuyBox 赢家数降序·点行查档案·未拉档案显「未入库」/api/sourcing/sellers/top?country&limit=50文案断言生效
AC-EL-SRC-S-006热销表 11 列表格#/卖家 ID/名称/池内 BuyBox 赢家/均值价/样本 ASIN/评分/评分数/FBA/中国发货/店铺在架TopResp.sellers列序断言生效
AC-EL-SRC-S-007未入库占位空态名称列 muted「未入库」seller_name null对拍生效
AC-EL-SRC-S-008样本 ASIN 链接链接前 2 个 ASIN:深链 viewer+🛒goViewer SPA 无刷新点击跳 viewer生效
AC-EL-SRC-S-009热销空态行空态colSpan=11「该站点池内尚无 BuyBox 卖家数据(需 offers 采集铺开)」sellers.length===0冷站断言生效
AC-EL-SRC-S-010卖家查找卡头卡头/sellerquery 官网检索同款 — 10 配额+1/百家·至少一个筛选·10 分钟缓存POST /api/sourcing/seller-finder?country文案断言生效
AC-EL-SRC-S-011全文检索 input输入名称/商号/地址/VAT/邮箱/ID(官网同款)search 字段词命中生效
AC-EL-SRC-S-012好评率≥ input输入0-100rating_gte阈值生效生效
AC-EL-SRC-S-013终身评分数≥ input输入—rating_count_gte阈值生效生效
AC-EL-SRC-S-014近30日评分数≥ input输入—rating_count30_gte阈值生效生效
AC-EL-SRC-S-015店铺在架≥ input输入—storefront_gte阈值生效生效
AC-EL-SRC-S-016FBA select筛选器不筛/用过 FBA/没用过 FBAhas_fba true/false筛选生效生效
AC-EL-SRC-S-017排序 select筛选器评分数最多/好评率最高/店铺在架最多sort=count|rating|storefront首行随排序变生效
AC-EL-SRC-S-018公司地址国 pills筛选器14 国 ISO 多选=任一,全不选=不筛address_country 小写数组多选生效生效
AC-EL-SRC-S-019查找按钮按钮「🔍 查找卖家(10 配额+1/百家)」postJson seller-finder点击出 ID 表生效
AC-EL-SRC-S-020命中计数+缓存徽标反馈「命中 N 家」+「缓存命中(0 token)」绿字total+cached10min 内复点 0 token生效
AC-EL-SRC-S-021结果 ID 表表格#/卖家 ID/查档案按钮(3 列)ids 每页 100对拍生效
AC-EL-SRC-S-022查档案按钮按钮逐家调卖家查询解析lookupQuery(id)点开出档案生效
AC-EL-SRC-S-023翻页器分页上一页/下一页,第 N 页·本页 X 家;上限 1 万page*per_page≥10000 禁下一页末页禁用生效
AC-EL-SRC-S-024无命中说明空态「Keepa 对无值字段不索引——『无评分』和『0% 好评』不同」ids.length===0空条件断言生效
AC-EL-SRC-S-025最高评分卖家榜卡头卡头/topseller 全库按评分数排序(日更)— 固定 50 配额·24h 缓存命中零配额GET /api/sourcing/topsellers?country文案断言生效
AC-EL-SRC-S-026BR 不可用提示空态「BR 域该端点官方不可用,请换站点」country===BR 分支选 BR 断言生效
AC-EL-SRC-S-027拉取/刷新按钮按钮「🏅 拉取最高评分卖家榜(50 配额)」/「刷新榜单(50 配额)」loadTs点击出榜生效
AC-EL-SRC-S-028全库计数+缓存徽标反馈全库 N 家·展示前 M + 缓存命中(0 token)total_ids+ids.length24h 内复点 0 token生效
AC-EL-SRC-S-029榜 ID 表表格#/卖家 ID/查档案(前 200 控制体积)ids对拍生效
AC-EL-SRC-S-030榜单口径脚注脚注全库口径(非本站池内)·日更·可达 10 万 ID 取前 200—文案断言生效
AC-EL-SRC-S-031卖家查询卡头卡头13~14 位 ID 直查(零 token)·名称检索已拉库·未入库可实时拉取(1 配额)GET /api/sourcing/seller-lookup?country&q&live文案断言生效
AC-EL-SRC-S-032ID/名称 input输入mono 大写;ID 正则 ^A[A-Z0-9]{12,13}$ 种子跳入vseller 深链对拍生效
AC-EL-SRC-S-033⚡实时拉取档案按钮按钮「1 配额, Δ1 token」入库常驻live=1;found 后标记「刚实时入库」点击入档案生效
AC-EL-SRC-S-034名称无匹配提示反馈hint+「当前已拉 N 家」mode=name&&!found对拍生效
AC-EL-SRC-S-035ID 未命中 hint反馈hint 文本mode=id&&!found对拍生效
AC-EL-SRC-S-036名称匹配表表格卖家 ID/名称/池内赢家/评分/评分数(5 列)行点击转 ID 查matches[]点行出档案生效
AC-EL-SRC-S-037档案 KPI×6KPI卡卖家(商号·刚实时入库)/评分评分数(近30天评价)/池内赢家+ASIN 链/BuyBox 新品占有率(二手·均竞争)/FBA·中国发货(店铺在架·追踪自)/档案更新(评分更新)Profile 全字段对拍生效
AC-EL-SRC-S-038评分历史图图0-100 线图;Amazon 自营 ATVPDKIKX0DER 空态=真值说明rating_series(Keepa csv[0])自营显真值提示生效
AC-EL-SRC-S-039评价数四窗表表格30/90/180/365 天评价数+好评%rating_count_*+positive_*对拍生效
AC-EL-SRC-S-040主营品牌 Top 表表格品牌/产品数/均 BSR(30d)/含自营(前 8)brand_stats对拍生效
AC-EL-SRC-S-041主营类目 Top 表表格类目/catId/产品数/均 BSR(30d)/含自营(前 10);池外类目显「池内未收录」缺名不猜category_stats缺名断言生效
AC-EL-SRC-S-042BuyBox 竞争者 chips按钮组sellerId+percent% 点击查档案competitors[]点 chip 出档案生效
AC-EL-SRC-S-043地址/电话行静态地址 · 电话(Keepa 公开档案)address/phone 有则显对拍生效
AC-EL-SRC-D-001促销流卡头卡头「⚡ 促销流」Keepa /deal 实时降幅榜 — 近 12 小时内有变价的产品/api/sourcing/deals文案断言生效
AC-EL-SRC-D-002站点 pills筛选器Keepa 13 域全集(AE/SA/SE 无 Keepa 域显式不提供)DEAL_COUNTRIES=KEEPA_COUNTRIES 单源13 项断言生效
AC-EL-SRC-D-003价格类型 select筛选器9 项:新品市场价/Amazon 自营价/BuyBox 含运费/New FBA/二手价/秒杀/仓储/翻新/销量排名price_type 1/0/18/10/2/8/9/6/3切换列头变(排名型)生效
AC-EL-SRC-D-004时间窗 select筛选器近 24 小时/7 天/31 天/90 天date_range 0-3切换重拉生效
AC-EL-SRC-D-005排序 select筛选器百分比降幅/绝对降幅/最新变价/销量排名sort 4/2/1/3首行随排序变生效
AC-EL-SRC-D-006拉取按钮按钮「⚡ 拉取促销流(5 配额/页)」GET /deals?country&price_type&date_range&sort&page点击出表生效
AC-EL-SRC-D-007口径脚注脚注只含近 12h 变价品;每页≤150 条、单查询最多翻 1 万 ASIN;时间窗越短降幅越显著;结果缓存 30 分钟命中不耗配额—文案断言生效
AC-EL-SRC-D-008当前条件+缓存徽标反馈「当前: 价格类型·窗口·排序」+ 缓存命中(0 token)绿字price_type_name+cached30min 内复点 0 token生效
AC-EL-SRC-D-009错误提示反馈红字 ⚠err←catch对拍生效
AC-EL-SRC-D-010结果表 12 列表格#/图/ASIN/标题/类目/现价(现排名)/窗口均价(均排名)/降幅/降幅%/BSR/变价时间/操作DealRow 全字段;is_rank 切换列头与格式列序断言生效
AC-EL-SRC-D-011行缩略图图36×36 containimg null→—对拍生效
AC-EL-SRC-D-012秒杀至标记标记「⚡秒杀至{end}」橙字lightning_end 有则显对拍生效
AC-EL-SRC-D-013📈 历史按钮按钮跳价格历史 tab(种子 viewer)setQs({mtab:viewer,…})点击跳转生效
AC-EL-SRC-D-014🛒 行外链链接ASIN 合法才显^[A-Z0-9]{10}$新开商品页生效
AC-EL-SRC-D-015翻页器分页上一页/下一页;第 N 页·本页 X 条(<150=已到末页)page 150/页末页禁用生效
AC-EL-SRC-D-016无变价空态空态「该站点×组合近 12 小时没有变价产品(非站点不可用)」+ 三条建议rows.length===0冷组合断言生效
AC-EL-SRC-D-017初始空态空态「选好站点与条件后点拉取…30 分钟内重复拉取走缓存不耗配额」!data冷启动断言生效
AC-EL-SRC-D-018秒杀专场卡头卡头/lightningdeal 近 4 天 Lightning Deals(含过期),全表一次 500 配额/api/sourcing/lightning?country&state&asin文案断言生效
AC-EL-SRC-D-019状态过滤 select筛选器6 态:进行中/候补中/已抢完/候补满/已结束/已下架LT_STATES切换重拉生效
AC-EL-SRC-D-020单 ASIN input输入mono 大写 B0XXXXXXXX;回车查单条asin 参数(1 配额)对拍生效
AC-EL-SRC-D-021查单条按钮按钮「查单条(1 配额)」仅填 ASIN 时显示loadLightning(asin)点击出单行生效
AC-EL-SRC-D-022全表二次确认按钮按钮两段式:先「⚡ 拉取秒杀全表(500 配额,需二次确认)」→「⚠ 再点一次确认拉全表(500 配额)」橙底ltArmed armed 态;Keepa 最贵端点首点不拉生效
AC-EL-SRC-D-023秒杀口径脚注脚注全表=近 4 天全部(含过期)固定 500 配额;缓存 60 分钟零配额;dealPrice「—」=未开始(官方 -1 哨兵)—文案断言生效
AC-EL-SRC-D-024秒杀表 13 列表格#/图/ASIN/标题(+变体)/秒杀价/现价/折扣/已领/状态(🅿)/起止 UTC/卖家(·FBA)/评分/操作LightningRow 全字段列序断言生效
AC-EL-SRC-D-025秒杀价哨兵列列deal_price null→「—」=秒杀未开始官方 -1 哨兵转 null未开始断言生效
AC-EL-SRC-D-026Prime 标记标记🅿 角标 title=Prime 资格is_prime对拍生效
AC-EL-SRC-D-027卖家列列seller_name||seller_id(title=ID)+·FBAis_fba对拍生效
AC-EL-SRC-D-028秒杀行操作按钮📈 历史 + 🛒同促销流跳 viewer生效
AC-EL-SRC-D-029无秒杀空态空态「该站点×状态×ASIN 近 4 天没有秒杀记录」deals.length===0对拍生效
AC-EL-SRC-F-001产品查找卡头卡头Keepa Product Finder 官方筛选 — 10 配额+1/百 ASIN,同条件 10 分钟缓存POST /api/sourcing/finder?country文案断言生效
AC-EL-SRC-F-002站点 pills筛选器Keepa 13 域全集(AE/SA/SE 无 Keepa 域)FINDER_COUNTRIES 单源13 项断言生效
AC-EL-SRC-F-003标题关键词 input输入引号=短语,-词=排除title 字段短语命中生效
AC-EL-SRC-F-004品牌 input输入逗号/中文逗号分隔=任一brand[] 数组多品牌命中生效
AC-EL-SRC-F-005价格类型 select筛选器新品价/Amazon 自营价/BuyBox 含运费/二手价/New FBAprice_type切换生效生效
AC-EL-SRC-F-006价格区间 min/max输入本币两位 inputprice_min/price_max区间生效生效
AC-EL-SRC-F-007BSR 排名区间输入大类 min/maxbsr_min/bsr_max→Keepa current_SALES;2026-10-20 用户报「BSR 区间不可选」补 UI(后端早支持)区间生效生效
AC-EL-SRC-F-008近30日月销≥ input输入Amazon 搜索页口径,多数 ASIN 无值monthly_sold_gte对拍生效
AC-EL-SRC-F-00930天掉榜≥ input输入估算销量口径drops30_gte对拍生效
AC-EL-SRC-F-010评分≥ input输入0-5 星 step 0.1rating_gte对拍生效
AC-EL-SRC-F-011评论数≥ input输入—reviews_gte对拍生效
AC-EL-SRC-F-012总报价数≤ input输入竞争热度offers_lte对拍生效
AC-EL-SRC-F-013Amazon 自营状态 select筛选器不筛/自营现货/无自营报价/自营预售/自营补货amazon_offer对拍生效
AC-EL-SRC-F-014BuyBox 归属 select筛选器不筛/BuyBox=Amazon 自营/BuyBox≠自营buybox_is_amazon对拍生效
AC-EL-SRC-F-015排序 select筛选器销量最好(BSR)/月销最高/价格低→高/价格高→低/评论最多sort首行随排序变生效
AC-EL-SRC-F-016查找按钮按钮「🎯 查找产品(10 配额 + 1/百ASIN)」至少填一个筛选(否则 Keepa 400)load(0)点击出结果生效
AC-EL-SRC-F-017默认窗提示提示「不填上架时间默认限近 6 个月;完整筛选族(60+)见官方文档,此处为精选白名单」—文案断言生效
AC-EL-SRC-F-018错误提示反馈红字 ⚠err←catch对拍生效
AC-EL-SRC-F-019结果卡头卡头「命中 N 个 ASIN · 第 N 页(每页 50, 上限 1 万)」+ 缓存命中(0 token)FinderResp.total/page/cached10min 复点 0 token生效
AC-EL-SRC-F-020翻页+导出工具条上一页/下一页 + ⬇ 导出 Excel(enrich 成功才显)exportTableXls(tblRef,'finder')导出行数=本页生效
AC-EL-SRC-F-021详情配额提示提示「详情 1 配额/ASIN(逐 ASIN 24h 缓存,翻页复查 0 配额);点 ASIN/标题跳价格历史」/api/sourcing/enrich 自动链式复拉 0 配额生效
AC-EL-SRC-F-022详情加载/失败提示反馈⏳ 拉取五字段中… / ⚠ 失败(仍显示 ASIN 网格)eloading/eerr失败回退网格生效
AC-EL-SRC-F-023品牌销量占比条汇总本页 N 品·近30日月销合计·X/N 有月销值 + 12 个品牌 chip(占比%)EnrichResp.brands/sold_coveragechip 合计≈100%生效
AC-EL-SRC-F-024五字段产品表 10 列表格#/图/产品/ASIN/品牌/现价/细分类目排名/近30日销量/品牌占比/操作Enriched 全字段列序断言生效
AC-EL-SRC-F-025细分类目排名列列#rank·类目;缺失回退根类目 BSR(title 披露);再缺→—subcat_rank→salesrank 回退链回退标注生效
AC-EL-SRC-F-026近30日销量列列≥10万显「10万+」;无值显灰「无值」不计分母monthly_sold封顶断言生效
AC-EL-SRC-F-027ASIN 跳转按钮按钮tab sku 样式「{asin} 📈」+行尾「📈 历史」setQs viewer 种子点击跳 viewer生效
AC-EL-SRC-F-028ASIN 网格回退态空态enrich 未就绪/失败时纯 ASIN chip 网格rows.map chip失败仍可跳生效
AC-EL-SRC-F-029无命中空态空态「该条件组合未命中任何 ASIN(近 6 个月内上架)」+ 放宽建议rows.length===0严条件断言生效
AC-EL-SRC-F-030口径脚注脚注现价=BuyBox(缺失回退新品价);细分类目排名=类目树最深层节点;月销=Amazon 搜索页口径上限 10 万;品牌占比=品牌月销合计÷本页有值 ASIN 合计—文案断言生效
AC-EL-SRC-X-001重算窗口按钮按钮「⬇ 重算窗口(雷达物化)」confirm 五类雷达去重合入+ABA≥3 期播种关注池;10 分钟冷却POST /api/sourcing/verdicts/materialize;429 时 owner/admin 可二次确认强制冷却拦截生效
AC-EL-SRC-X-002强制重算分支逻辑冷却中 owner/admin 弹「强制重算?」→ force=trueisAdmin←/api/tenant/info role429 复现生效
AC-EL-SRC-X-003Pareto 排序按钮按钮「⚖ Pareto 排序 Top30」GET /api/sourcing/verdicts/pareto?limit=30点击出表生效
AC-EL-SRC-X-004状态筛选 select筛选器全部状态/跟进/观察/放弃/主攻/杀state 参数过滤生效生效
AC-EL-SRC-X-005搜候选词 input输入回车触发 loadq 参数命中集变生效
AC-EL-SRC-X-006Pareto 卡表格排名/候选词/可用维度;四维(周期数↑ 月销↑ 评论↓ BSR↓)缺维省略不充零·仅跟进/观察候选available_dimensions join ·缺维断言生效
AC-EL-SRC-X-007决策台卡头卡头「机器永不给『主攻』;终裁必填备注;审计只追加」—文案断言生效
AC-EL-SRC-X-008候选池空态空态EmptyState 引导点「从雷达物化候选」items.length===0空池断言生效
AC-EL-SRC-X-009决策台表 12 列表格候选词/来源/周期/趋势/竞对/评论中位/月销中位/门禁/机器建议/旧裁决/状态/操作GET /api/sourcing/verdicts/candidates?state&q&limit=60列序断言生效
AC-EL-SRC-X-010来源 badges徽章上升/碎片化/隐蔽宝石/篮子/复购(SRC_CN)dimsources[]对拍生效
AC-EL-SRC-X-011趋势列列rank_slope<0 绿「变热」/>0 红「变冷」/null→—斜率符号对拍生效
AC-EL-SRC-X-012月销中位 ≈ 标记列own_src=keepa_daily 时显「≈N」title=日档回退·drops30 估算口径null 不充 0 纪律≈ 断言生效
AC-EL-SRC-X-013门禁 badge徽章「全过」ok /「6−N/6 过」warn;title=全部门禁 k:vgates PENDING 计数;缺据=PENDING 不误杀悬停列全生效
AC-EL-SRC-X-014机器建议 badge徽章有潜力 ok/数据不足 warn/观望 dim(永不 QUALIFIED)machine_rec无主攻项生效
AC-EL-SRC-X-015旧裁决 badge徽章杀 bad/副攻 warn/其余 dim+score;title=kill_reasonlegacy 历史旁证避免重复翻案对拍生效
AC-EL-SRC-X-016状态 badge徽章跟进 ok/观察 warn/放弃 dim/主攻 ok/杀 bad(state_cn)STATE_TONE对拍生效
AC-EL-SRC-X-017裁决按钮按钮行尾 ghost;打开 drawer 默认 watch→followsetDecide(c)点开 drawer生效
AC-EL-SRC-X-018加载更多按钮分页「加载更多(已显示 N 条)」60/页 offset 翻页;不满页显「已到底」items.length%PAGE!==0 禁用分页累计生效
AC-EL-SRC-X-019脚注脚注证据缺数据显 — 不按 0 计算;月销 ≈ 为 Keepa 日档回退;财务与合规门禁永久留人工;旧裁决计数动态(杀 X/副攻 Y/待验 Z)legCnt←/verdicts/legacy total_by_verdict(2026-09-26 去硬编码)计数=SQL生效
AC-EL-SRC-X-020裁决 drawer弹层「裁决 · {term}」+ 国家·来源·机器建议(机器永不终裁)decide 态 maxWidth 520点遮罩关闭生效
AC-EL-SRC-X-021状态选择按钮组输入跟进/观察/放弃/主攻/杀 五钮单选dState单选断言生效
AC-EL-SRC-X-022终裁必填警告反馈主攻/杀时橙字「⚠ 终裁必须填写备注理由(入库强校验),审计记录不可修改删除」qualified|rejected空备注提交被拦生效
AC-EL-SRC-X-023备注 textarea输入3 行;rejected placeholder=为什么杀?(写入 kill_reason)note 必填校验对拍生效
AC-EL-SRC-X-024记录/取消按钮按钮「记录裁决」POST /decision(审计不可篡改)toast「已记录」candidate_id+state+note+kill_reason提交后行状态变生效

§11.29 物流页(/logistics · AC-EL-LOG,51 条 · 2026-10-22 源码实证 web/app/logistics/page.tsx 759 行 + web/lib/logiSteps.ts 99 行 + api/routers/logistics.py 496 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-LOG-001页壳/面包屑导航AppShell title=物流,面包屑「国际物流跟踪 · 双清订单(公司级货代)」路由 /logistics;整页 Suspense 包裹(useQueryState 需边界);全端点 require_module("logistics")(logistics.py 各 Depends);数据经 tenant_conn(tenant, brand_scope)(铁律:租户/品牌绝对独立)e2e 登录物流模块账号断言标题与面包屑逐字一致;未开通租户断言 403生效
AC-EL-LOG-002tab 状态 URL 同步导航五 tab 选中态同步进 URL query(tab 参数)useQueryState({ tab: "tracking" }) 默认 tracking;2026-09-21 起 tab 不再是纯前端 state——刷新/分享链接不回默认 tabe2e 切到 pricing 后刷新断言仍停 pricing生效
AC-EL-LOG-003数据接口·船票列表接口GET /api/logistics/shipments?badge&search&brand&page&page_sizelogistics.py:141-195;前端 pageSize=20,服务端 page_size=min(100,max(1,·));search 六字段 ILIKE(awb/remark/products_text/city/product_name/model_number);排序 stage_overdue DESC, ship_date DESC(超期置顶);响应含 total/page/page_size/stats/by_badge/items接口直调断言分页 clamp(page_size=999→100);翻页 total 不变生效
AC-EL-LOG-004KPI·在途KPI 卡卡面标签「在途」·运输中票数(badge=TRANSIT)stats.transit=count(*) FILTER(badge='TRANSIT');foot=「待离港 {awaiting} · 清关中 {customs}」两计数并列展示(page.tsx:96,非相加);stats 为与明细同源实时聚合(2026-09-26 B批P2-3,logistics.py:156-170;旧 logistics_stats 快照表停在 09-05 与 RLS 品牌键不可见两问题一并消除,旧表退役留档)SQL 同口径复算 transit/awaiting/customs 与接口 stats 比对生效
AC-EL-LOG-005KPI·累计签收KPI 卡卡面标签「累计签收」·已签收票数(ok 色)+ foot「历史累计 N 票 · 截至 as_of」stats.delivered=count FILTER(badge='DELIVERED');total=筛选品牌内全部票;as_of=max(coalesce(nullif(latest_event_time,''), ship_date::text))(logistics.py:166)SQL 复算三值;断言 as_of=最新轨迹时间或发货日兜底生效
AC-EL-LOG-006KPI·阶段超时KPI 卡卡面标签「阶段超时」·超期票数(danger 色)+ foot「需跟进货代 · 在册 N 票」stats.stage_overdue=count FILTER(stage_overdue);foot 在册数=by_badge 各档 count 合计;stats=null(租户 0 票,st[0] 真值判断)时 KPI 显「—」不显 0(P3 缺陷④polish:误导性 0 同禁)空租户断言「—」;SQL 复算 stage_overdue 计数生效
AC-EL-LOG-007KPI·动态徽章卡KPI 卡by_badge 前两档各一卡:label + count + 「{int(weight)} kg 合计」by_badge=GROUP BY badge,badge_label ORDER BY count DESC(logistics.py:171-175),weight=sum(weight)::float8;前端 slice(0,2) 取前两卡SQL 复算 by_badge 顺序与 weight 合计生效
AC-EL-LOG-008状态筛选 BADGES筛选TRANSIT 运输中/CUSTOMS 清关中/AWAITING 待离港/INF 已收件/DELIVERED 已签收/空=全部BADGES 常量六项;badge→SQL s.badge=· 精确等值;与 KPI/表格同请求e2e 逐项断言 items 全部行 badge 一致生效
AC-EL-LOG-009徽章配色 BADGE_CLS样式TRANSIT:ok CUSTOMS:warn AWAITING:warn INF:dim DELIVERED:ok;未知回退 dim文案=badge_label 空则回退 badge;映射表驱动非逐条 if构造未知 badge 行断言 dim生效
AC-EL-LOG-010搜索框筛选按运单号/备注/产品/城市/型号等检索search 六字段 ILIKE(同 003 where);提交后过滤表格与计数搜已知 AWB 断言命中;搜不存在串断言空态生效
AC-EL-LOG-011⬆ 导入运单 CSV 按钮按钮/上传上传货代运单报表;title=「上传货代运单报表 CSV(列名中英文均可:运单号/品牌/目的国/发货日期/最新轨迹…),按 运单号+品牌 幂等去重」;成功 toast「导入完成:处理 N 票」,skipped>0 时追加「 · 跳过 M(缺运单号/品牌)」(page.tsx:70 d.skipped 三元,0 跳过则无此段)POST /api/logistics/shipments/import?brand=(FormData file);logistics.py:71-138;2026-09-21 补采集缺口:燕文 API 凭据未到位前数据通道=货代报表手动上传(与广告上传同模式)e2e 上传样例 CSV 断言 toast 数字与 DB 行数一致;重复上传断言幂等(不增行)生效
AC-EL-LOG-012导入后端契约接口列名映射/幂等/归一规则logistics.py:35-52 _SHIP_COL_MAP 标准列↔中英别名(匹配小写去空格,首个命中生效);限 10MB(超限 400「文件超限(10MB)」)、空文件 400;utf-8-sig 解码容错 BOM;缺运单号列 400(回显支持别名清单);ship_date/latest_event_time 解析失败保原串;weight 正则剔除非数字;未登记品牌(tenant_brands is_active)行跳过——RLS 对越权 INSERT 抛 InsufficientPrivilege 裸 500 的前置防护;ON CONFLICT (brand,awb) DO UPDATE UPSERT 幂等;badge 归一 _ship_badge 关键词(签收/delivered→DELIVERED、清关/customs→CUSTOMS、awaiting/待取/待派→AWAITING、转运/运输/transit 等→TRANSIT、默认 INF);audit logistics.shipments.import中英列名双份 CSV 各传一次断言同结果;未登记品牌行断言 skipped 计数;audit 表留痕生效
AC-EL-LOG-013Tracking 表·列 产品名/型号表格列两行:product_name(strong)+ t2「型号 · AWB」product_name/model_number 为产品对齐核心(同全站);空 product_name 回退型号行展示抽行与源表 product_name/model_number 比对生效
AC-EL-LOG-014Tracking 表·列 AWB 提单号表格列AWB + overdue 时叠加「超时」bad badgeawb 直显;stage_overdue 服务端置位(同步层),前端只渲染超期行断言 badge 出现;正常行断言无生效
AC-EL-LOG-015Tracking 表·列 路线表格列「from → to · city」from_country/to_country/city 三字段拼接抽行比对生效
AC-EL-LOG-016Tracking 表·列 重量kg表格列右对齐 toFixed(1)weight float8;null 显「—」无重票断言「—」生效
AC-EL-LOG-017Tracking 表·列 发货日表格列muted 日期文本ship_date 字符串直显(YYYY-MM-DD)抽行比对生效
AC-EL-LOG-018Tracking 表·列 状态表格列/badge状态徽章(同 009 配色)BADGE_CLS 回退 dim;文案 badge_label 空则回退 badge同 009生效
AC-EL-LOG-019Tracking 表·列 载货表格列ellipsis 单行截断 maxWidth 220pxproducts 空则回退 remark 再空显「—」;title=remark 悬停看全长品名断言截断样式与 title生效
AC-EL-LOG-020Tracking 表·列 最新轨迹表格列event 文本 + 时间latest_event + latest_event_time(T 换空格、截前 16 字符)抽行断言格式生效
AC-EL-LOG-021Tracking 表·空态空态「无匹配船票」items 空时整行替换 colSpan=8(含筛选/搜索无命中)无命中搜索断言文案生效
AC-EL-LOG-022Tracking 表·分页器分页「共 {total} 行 · 第 {page} / {pages} 页」+ 上一页/下一页服务端 LIMIT/OFFSET;边界页按钮 disabled;切页保持 badge/search/brand末页断言下一页 disabled生效
AC-EL-LOG-023行点击·轨迹抽屉抽屉drawer-mask + maxWidth 760 抽屉;标题「运单 {awb} · 轨迹详情」+ 路线摘要行行 onClick setDetail;traces 来自接口 rows[].traces(time/st/desc/loc 四字段,logistics.py:191-192)e2e 点行断言抽屉开、AWB 正确生效
AC-EL-LOG-024抽屉·15 段节点 stepper(logiSteps.ts:15-20 实 15 项,文件头「14 段」注释陈旧)可视化全流程节点横向圆点条buildSteps(web/lib/logiSteps.ts:69-99,纯函数移植旧系统权威映射表);STAGE_LABELS 15 段(0 收件→14 签收,含出口/进口申报·查验·放行·离港到港·海外总仓·派送·零售仓);STAGE_MAP 燕文状态码→段;缺状态码走 KW 关键词兜底(签收/派送/清关/查验/运输/收件);轨迹先按时间倒序规范化;每节点 time/note 小字;cls:current=brand 色+boxShadow、inspect=warn(INSPECT_STAGES={3,9} 出/进口查验段)、done=ok、pending=#e4e7ec、overdue=danger构造含查验码(91/92)与 ETA 轨迹断言 warn 标注与 ETA note;单测 buildSteps 纯函数逐码表抽验生效
AC-EL-LOG-025节点·超期判定口径节点「超期」徽标规则未签收且已到节点 >7 自然日未推进(OVERDUE_DAYS=7)且非运输段(TRANSIT_STAGE=6 豁免——海运以 ETA note 提示代替);delivered=reached≥14 或 =13(已入零售仓视同妥投);与页脚口径句逐字一致造 8 天前「已离港」未签收票断言 overdue;运输中 8 天断言不 overdue生效
AC-EL-LOG-026抽屉·原始轨迹列表列表新→旧时间序;maxHeight 260 滚动traces 按 time 倒序渲染;空态「无轨迹明细」断言首行时间≥次行;无轨迹票断言空态生效
AC-EL-LOG-027抽屉·关闭按钮mask 点击与关闭按钮双通道关抽屉setDetail(null);无路由变化e2e mask 点击+关闭按钮断言关闭(无 Esc 监听,page.tsx:193-241)生效
AC-EL-LOG-028页脚口径(受保护文案)口径「数据源:货代运单报表(⬆ 导入运单 CSV 手动导入 · KPI 实时聚合;货代 CSS 双清渠道,公司级发货,归母账号品牌隔离)。状态:已收件 → 待离港 → 运输中 → 清关中 → 已签收;表格/KPI「超时」= 超过货代时效节点,节点「超期」= >7 自然日未推进且未签收(运输段豁免)。采集管道接入后自动刷新。」(page.tsx:243 起)前两句已由源码证实(手动导入=011/012、实时聚合=004、状态机=008、超期=025);末句「采集管道接入后自动刷新」为承诺句——当前采集管道未接(数据通道=手动导入,logistics.py:74-76 注释),「自动刷新」尚无实现载体;2026-10-22 用户确认管道规划=燕文 API 接入(与 logistics.py 文档串「燕文 API 凭据到位前的数据通道=货代报表手动上传」一致;/opt/collection 无燕文代码)——承诺句保留,待凭据到位+管道接通回验自动刷新兑现后转生效文案与库内记录逐字 diff;待核:燕文 API 管道接通后回验自动刷新是否兑现,届时本条转 p-ok待核
AC-EL-LOG-029五 tab 导航导航📦 Tracking/➕ Create Shipment/⚙️ Parameters/📊 Pricing 报价/📚 参考附录 Referencetab 值同步 URL(002);五 tab 分别对应下列 030-050 组e2e 逐 tab 断言渲染容器生效
AC-EL-LOG-030Create·地址 select输入空选项=默认地址;选项「{label 空取 id} · {country} {cityName}」地址簿来自 params.addresses(默认地址 is_default=true);提交时 address_id 传后端(见 035 合并顺序)e2e 切地址下单 dry-run 断言返回 address 变化生效
AC-EL-LOG-031Create·产品 select输入选项「{code} — {name}」默认首项GET /api/logistics/products(logistics.py:243-246)返 LOGISTICS_PRODUCT_CATALOG 19 型号(199-219 行:Airfit/Luna Neo/T03/T11/J80/H24/Clip04 系列,各含 weight/hs=8543709990/value 申报值)接口断言 19 项且 code 唯一生效
AC-EL-LOG-032Create·数量输入number input min=1 默认 100qty≤0 后端 400「Quantity must be > 0」;非法串归 0 同 400submit qty=0 断言 400生效
AC-EL-LOG-033Create·虚线预览卡反馈「{code} × {qty} = {weight} kg · HS {hs} · 申报 ${value} · 合计 ${(value×qty).toFixed(2)}」weight=product.weight×qty(与后端 round(·,2) 同式);HS/value 取目录常量改数量断言合计随动且与 dry-run 返回 weight 一致生效
AC-EL-LOG-034Create·🔍 校验 Dry-Run按钮只校验不外呼;成功显「✓ 校验通过: {product} × {qty} = {weight}kg」/失败「✗ {detail}」POST /api/logistics/create body dry_run=1(logistics.py:425-427):返回 ok/dry_run/product/qty/weight/address,不调 Vnlin、不占幂等锁断言响应无 order_id;网络层断言无外呼生效
AC-EL-LOG-035Create·🚀 真实下单按钮/接口两步创建双清运单;成功「✓ 下单成功: 订单号 {order_id}」logistics.py:383-496:①POST {OMS}/api/doubleClearance/create 取 orderId ②POST /api/doubleClearance/packageBox 提交箱单(cartonNumber=1、hsCode、price=value、totalAmount=value×qty、箱规 60×40×30cm、volume=60×40×30/1e6、Brand/NonBattery);参数合并顺序=默认→logistics_params 存档→body.params→地址簿(address_id→is_default→首个,九字段覆盖);weight=round(weight×qty,2);幂等锁 Redis SET NX 600s 指纹 sha1(order_body)(B批P2-4 2026-09-26),窗口内重复提交 409;VNLIN 凭据缺失 503;步骤②失败=502 如实报错带 order_id(「请勿重复下单,请在 Vnlin 后台…补录箱单」,半成功不再 ok:True)+ audit 记 HALF_FAIL同参双击断言第二笔 409;mock 箱单失败断言 502 带 order_id;audit 留痕 HALF_FAIL生效
AC-EL-LOG-036Create·警示文案文案「真实下单会调 Vnlin OMS 外部 API 创建运单, 谨慎点击」(page.tsx:332,半角逗号+空格)常驻 muted 提示;下单按钮在 busy 或未选产品时禁用文案逐字 diff;未选产品断言按钮禁用生效
AC-EL-LOG-037Parameters·读接口接口GET /api/logistics/paramslogistics.py:248-272:存档与 LOGISTICS_DEFAULT_PARAMS(221-229:origin=CN/serviceCode=shuangqing/transport=A/platform=NOON FLEX/storeLocation=STW/country=SA/cityName=Riyadh/destCode=Badaya/transportMode=5101/packageType=XPS/is_solely=NO/battery=0/documents=2/shopName=ONNO/shortAddressTypes=NSA)合并保证字段齐全;地址簿空时注入 addr_default(is_default=true);另返 service_codes/platforms/transports 元数据(231-239 行常量)新租户首拉断言返回默认值+默认地址生效
AC-EL-LOG-038Parameters·12 固定字段输入组origin 文本/country select(SA·AE·QA·KW 四国)/cityName/destCode/transport←meta.transports/serviceCode←meta.service_codes/platform←meta.platforms/storeLocation/shopName/packageType/battery number/documents number下拉源=接口 meta 三数组(37);文本源=params 合并结果;保存走 042e2e 断言各字段初值=默认参数生效
AC-EL-LOG-039Parameters·地址簿卡输入组label(maxWidth 200)/默认地址 checkbox(互斥)/删除按钮 + country·cityName·destCode·area·contact·mobile·address 七输入地址簿=params.addresses 列表;默认地址唯一(勾选互斥逻辑在前端 state)勾 B 默认断言 A 失去默认生效
AC-EL-LOG-040Parameters·➕ 新增地址按钮追加空白地址卡id="addr_"+Date.now() 前缀防撞;country 默认 SA;shortAddressTypes=NSA点击断言新卡出现且九输入可填生效
AC-EL-LOG-041Parameters·Remark textarea输入备注多行文本remark 字段随参数保存,下单时进 Vnlin order_body.remark存 remark 后 dry-run 响应/后台参数含该值生效
AC-EL-LOG-042Parameters·💾 保存参数按钮/接口POST /api/logistics/params;前端「✓ 已保存」/「✗」logistics.py:274-296:读旧档→白名单字段覆盖(只保留 LOGISTICS_DEFAULT_PARAMS 已知键,未知字段丢弃)→addresses 列表整体替换→UPSERT logistics_params(tenant 级 ON CONFLICT);audit logistics.params.save带未知键提交断言被过滤;audit 留痕生效
AC-EL-LOG-043Pricing·报价接口接口GET /api/logistics/pricinglogistics.py:298-304:静态读 api/data/yamwen_pricing.json(106 渠道 8 分类,公司级共享只读、不分租户);文件缺失 404「pricing data not found」接口断言渠道分组数;删文件场景(测试环境)断言 404生效
AC-EL-LOG-044Pricing·🧮 运费计算器计算器副标题「体积重 = 长×宽×高 ÷ 泡比 · 计费重 = max(实重, 体积重) · 全渠道比价」输入实重/长宽高/泡比(默认 6000);体积重=长×宽×高÷泡比、计费重=max(实重,体积重);A 模式 charged=max(计费重,min_kg)、freight=charged×per_kg+fee;B 模式 units=ceil((计费重−首重)/续重−1e-9)、freight=首重价+units×续重价+fee+干线费×计费重;结果按运费升序 top30、最低价绿色高亮(T3-1 2026-09-12 对齐 UVPVP)手算样例对拍(A/B 模式各一);断言排序与首行绿标生效
AC-EL-LOG-045Pricing·报价表 A 模式列表格列4 列:重量段 Weight(kg)/公斤运费 ¥/kg/处理费 ¥/件/最小计费 Min(kg)列集随渠道计费模式切换(A/B 二选一渲染,page.tsx:639)A 渠道断言恰 4 列表头生效
AC-EL-LOG-046Pricing·报价表 B 模式列表格列7 列:重量段 Weight(kg)/首重(kg)/首重价 ¥/续重(kg)/续重价 ¥/处理费 ¥/干线费 ¥/kg同 045 条件渲染;续重进位公式见 044B 渠道断言恰 7 列表头生效
AC-EL-LOG-047Pricing·分组/空态/脚注表格配件🌍 大洲·国家(code) 分组头行;空态「无匹配报价行」;脚注「共 {n} 行报价 · {m} 国家」;<details> 展开「价格说明 Notes ({n})」分组按报价单结构渲染;Notes 折叠块默认收起过滤无命中国家断言空态;脚注计数 SQL/JSON 对拍生效
AC-EL-LOG-048Reference·附录接口接口GET /api/logistics/appendix?ds=&limit=800&q=logistics.py:306-365:12 数据集 20.6 万行经 sync_source.qsource 只读通道查 mars 本地 amazon_analytics(shared.yanwen_appendix_dataset/row,2026-09-29 起);无 ds=meta 模式(dataset_key/title/stype/note/extra/row_count);有 ds=行模式 searchtext ILIKE;limit clamp [1,5000];字符白名单拒绝(ds=[a-z0-9_]{1,40}、q=[a-zA-Z0-9 '&.\-]{0,80}——拼 SQL 面收敛纵深防御;2026-09-17 P0 修:空 ds=合法 meta 模式原被 400);未知 dataset 404;DB 凭据未配 503ds=bad-name! 断言 400;ds=state_city&q=Riyadh 断言命中;空 ds 断言 12 节 meta生效
AC-EL-LOG-049Reference·10 类列头映射表格列REF_COLS 按数据集类型出列state_city 省份/城市/地区、uk_postcode 邮编/分类、ca_postcode 邮编/分区、aus_postcode 分区/邮编、reachable 区域/邮编、remote_reach 邮编、remote_unreach 邮编/性质、prohibited 类别/明细、vat 国家/VAT税率(小数)/无IOSS税率(小数)、hpra 类型/说明/归类/监管机构;rowToArr 按类型取值(prohibited/vat/hpra/state_city 专用分支;含中文键 区域/邮编/不通达性质;兜底 vals 前 4 或非 _search 键)逐类型抽验表头与行值列数一致生效
AC-EL-LOG-050Reference·搜索防抖与空态交互q 输入 300ms debounce 后自动刷新;空态「无数据」+「匹配「q」」回显;ℹ️ note 条默认 limit=800;note 取数据集 meta.note快速连打断言仅末次请求;无命中断言空态文案生效
AC-EL-LOG-051权限与隔离总则口径模块门+租户隔离logistics.py 全端点 Depends(require_module("logistics"));列表/导入均 tenant_conn(tenant, brand_scope);导入越权品牌行前置跳过(012)——铁律:租户/品牌绝对独立;公司级货代数据按归母账号品牌隔离(页脚口径句)跨租户 brand 参数断言空集;未开通模块断言 403生效

§11.30 Listing 页(/listings · AC-EL-LST,159 条 · 2026-10-22 源码实证 web/app/listings/page.tsx 1162 行 + listings/NoonListingTab.tsx 591 行 + upload/FilesTab.tsx 126 行 + upload/AplusTab.tsx 334 行 + web/lib/listingStatus.ts + api/routers/listing.py 1894 行·aplus.py·collab.py·noon_data.py 对应端点随条目引,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
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-009SKU 下拉下拉占位「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.countriesmks=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「关键词(逗号分隔, 标题用)」,宽度 240nu.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,.csvPOST /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-020AI 抽取兜底(规格书)口径规则命中 <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+1gen_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=200page.tsx:554-558;TITLE_MAX=200(listing.py:136)计数=n/200 实时;粘贴超长截断生效
AC-EL-LST-025流程③·五点编辑输入组label「五点描述(≥3 条)」;5 行编号输入 maxLength=500page.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;「关键词」inputpage.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→下拉(空选项+枚举/选项),否则文本 inputpage.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 时 disabledbatch("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-040generate_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:703imported 任务断言徽标与 ASIN生效
AC-EL-LST-044任务详情头卡卡头「{brand} · {sku}」+ 灰字「{platform} · {market} · {category} · v{version}」+ 状态 badgeopenTask 经「编辑内容 →」触发(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=5000page.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 均 disableddoSubmit→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-059ASIN 行与提交结果 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-060Amazon 推送结果与 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-063Noon 预检 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 PASSdry 响应键集断言无 csv_preview(已删分支,编译产物零残留)生效
AC-EL-LST-064NSKU 行(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/inputpage.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.brandspage.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-082SKU 明细/收起按钮与行展开交互分组行点击或按钮切换展开;展开行背景 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 ∪ exportedreadyTasks.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 截 500done/成功 两值行断言仍 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、其余 oklisting.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 天销量,无数据=nodatalisting.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-108NoonListingTab 承载组件挂载页级 noon 三 tab(LST-002 后三键)渲染 NoonListingTab,sub=tab 去前缀,setSub 回写页级 tabpage.tsx:1029-1032;NoonListingTab.tsx:39-42;受控挂载(原常驻底部自带第二套 tab 栏已并轨,page.tsx:1029 注释)三 tab 切换页级高亮同步生效
AC-EL-LST-109noon 内层 sub-tab 条页签三键:「📋 SKU 清单」「🚀 建品向导」「🗂 任务与 QC」NoonListingTab.tsx:65-69三键顺序逐字生效
AC-EL-LST-110noon 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-111noon 清单表 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-CMP8 列表头与渲染规则逐项;CSV 导出文件名 noon_listings生效
AC-EL-LST-112noon 清单口径注口径行表脚 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-122noon 任务保存端点口径保存=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 全量 payloadNoonListingTab.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.qcQC 后任务状态仍 imported;submit_result.qc 更新生效
AC-EL-LST-126QC 语言卡内容展示每语言卡:{语言}+状态 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-127QC 图片审核块展示「图片审核 ({N})」前 6 张:review_status badge(VALID ok/INVALID bad/其余 warn,去前缀)+URL 省略灰字NoonListingTab.tsx:496-508超 6 图仅显前 6生效
AC-EL-LST-128QC 失败呈现错误态HTTP 非 200=红 pre「查询失败 HTTP {n}: {raw 截 200}」NoonListingTab.tsx:510-514mock 非 200 断言格式生效
AC-EL-LST-129向导编辑深链路由?edit={id} 打开即载入该 noon 任务回填全部字段+submit_result/qc,并按其类目拉属性表单NoonListingTab.tsx:151-170;配合 LST-003 初始 tab带参访问断言回填与 tab 落位生效
AC-EL-LST-130noon 任务与 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-131noon 任务表列表7 列:# 灰 / SKU(文本筛选)/ 品牌 / 标题(截 40 悬停全文,空 —)/ 状态 badge(单源 LST-045,文本筛选)/ 更新(截 16)/ 操作NoonListingTab.tsx:559-576列序与渲染逐项生效
AC-EL-LST-132noon 任务行操作按钮组「编辑」=写 ?edit= 后整页 reload 进向导;「预检」=dry toast(缺 N 项: 清单 或 预检通过 ✓);「提交」仅 ready 显示,confirm「真实提交任务 #{id} 到 noon 建品?」;「QC」仅 imported 显示,toast 逐语言「{lang}:{状态}({完整度})」或「无状态」NoonListingTab.tsx:532-557,568-575四按钮状态门各断言生效
AC-EL-LST-133A+ tab 条页签三键:「📄 A+ 创建」「🖼️ 媒体库」「📋 文档 & 历史」AplusTab.tsx:85-89三键顺序逐字生效
AC-EL-LST-134A+ ①·基本信息卡卡h2「① 基本信息」sub「ASIN 多个逗号分隔 · 站点多选」;「文档名称(后台识别用)」(placeholder「如 T11 A+ 2026-09」)与「ASIN(多个逗号分隔)」两输入AplusTab.tsx:93-101;保存前必填校验:名称空 toast「文档名称必填」、ASIN 空「至少一个 ASIN」(66-68)两必填 toast 各断言生效
AC-EL-LST-135A+ ①·站点多选 toggle按钮组站点 pill 点击切换选中(on 态);来源 /api/aplus/meta marketsAplusTab.tsx:103-111,51;GET /api/aplus/meta(aplus.py:14)点击切换与 markets 集一致生效
AC-EL-LST-136A+ ①·语言缺失警告提示选了站点且媒体库全为 none 语言时黄字「⚠ 媒体库暂无非英文图 → 将用英文图打底(UVPVP 同语义警告)」AplusTab.tsx:56-58,113-117;判定=所选站点 locale 无对应语言图(UVPVP 同语义)媒体库仅 none 语言断言警告出现生效
AC-EL-LST-137A+ ②·模板布局单选三 radio pill:「经典版(推荐)」「简洁版」「自定义」+ 说明「经典版=Header大图+3图文+4宫格+对比表 · 简洁版=无对比表 · 自定义=按需填模块」AplusTab.tsx:120-134;TEMPLATES:classic=header+three+quad+compare / simple=无 compare / custom=全四模块(28-32)选简洁版断言 compare 模块不渲染生效
AC-EL-LST-138A+ ③·模块内容与图片槽表单按模板渲染模块:① 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-139A+ ④·保存卡按钮「💾 保存草稿」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-140A+ ④·提交审核(禁用)按钮「🚀 提交审核(未接凭证)」恒 disabled,title「SP-API 凭证未接入(需求单)」AplusTab.tsx:179;本期闭环=草稿+媒体库+登记+历史(AplusTab.tsx:3-4 注释)按钮恒禁用;无网络请求未上线保留
AC-EL-LST-141A+ 媒体库·登记卡表单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-142A+ 媒体库·已登记表表h2「已登记图片({N})」;5 列:媒体引用(省略)/语言 chip/标签(空 —)/登记时间/「删」按钮(confirm「删除媒体登记」)AplusTab.tsx:239-258,214-218;DELETE /api/aplus/media/{id}(aplus.py:61);空态 EmptyState「暂无登记」提示「上方登记第一条媒体引用」删除后行消失并 toast生效
AC-EL-LST-143A+ 文档表表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-144A+ 操作历史表表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=6FilesTab.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-151PT 元数据端点(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_adminlisting.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/qcaudit 调用 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 走查无第三处挂载点生效

§11.31 排名页(/rankings · AC-EL-RANK,84 条 · 2026-10-22 源码实证 web/app/rankings/page.tsx 718 行 + api/routers/dashboard.py 排名端点,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-RANK-001页面标题/面包屑导航AppShell title=市场表现,面包屑「排名 · 评分 · 评论 · AI 分析 — Amazon/Noon 在榜产品全景(大类/小类 BSR · 90 天趋势)」路由 /rankings(page.tsx:518);AppShell 壳层归 AC-EL-CMP 共享组件条目,此处只立本页定制文案e2e 登录后断言标题与面包屑逐字一致生效
AC-EL-RANK-002页级错误横幅反馈红色横幅 role="alert",展示最近一次接口异常 messagepage.tsx:519;markets 清单或榜单任一 getJson 失败 setErr 触发;无错误不占位e2e mock /api/rankings 500 断言横幅出现且带 alert 角色生效
AC-EL-RANK-003四视图 Tab 组导航「📊 BSR 排名 / ⭐ 评分与评论 / 💬 评论内容 / 🤖 AI 评论分析」四 tab,默认 BSR 排名page.tsx:520-524,view state=bsr∣rating∣reviews∣ai 默认 bsr(2026-10-07 用户令四合一,page.tsx:389-390);tab 只切前端视图不发请求e2e 依次点四个 tab 断言各视图容器出现生效
AC-EL-RANK-004品牌选择器筛选顶栏品牌下拉(共享组件,本页不重复展开)useBrand() 单源(H9 2026-10-13),brand 参数贯穿 markets/榜单/analytics/评论各请求;共享元素归 AC-EL-CMPe2e 切品牌断言 markets 与榜单请求均带新 brand 参数生效
AC-EL-RANK-005🔄 更新数据按钮按钮tab 行右端「🔄 更新数据」,运行中变「采集更新中…」并 disabled;title 提示「立即采集排名/评分/review数量(Keepa)并回报各源新鲜度」page.tsx:526-528;POST /api/rankings/refresh(dashboard.py:2917-2946)同步 asyncio.run(tasks.daily_amazon_rankings_keepa),写完自动触发清洗;限 owner/admin,否则 403「仅 owner/admin 可手动更新数据」以 viewer 角色点按钮断言 403 提示;owner 点后断言 refreshNote 出现生效
AC-EL-RANK-006采集回报条反馈成功:「✅ 采集 N ASIN 写入 M 行 · Amazon排名至 D1 · noon评论至 D2 · Amazon评论 X 条」;失败:「❌ + 错误信息」page.tsx:394-408、531;N/M 取 refresh.asins/written,D1/D2/X 取 sources.amazon_rankings/noon_reviews/amazon_reviews.count(noon 取各租户 schema 最新,ISO-01)e2e 点更新数据断言回报条格式与字段齐全生效
AC-EL-RANK-007KPI①快照日期KPI大数字=as_of 日期,foot=「Amazon/Noon · 市场码」或「选择市场」page.tsx:537-541;as_of=/api/rankings 回传该平台×市场 max(snap_date)(dashboard.py:2060-2061)SQL 查该市场 max(snap_date) 与页面比对相等生效
AC-EL-RANK-008KPI②在榜产品(截断披露)KPI值=当前展示行数;筛选后总数超 60 时 foot=「按BSR/评论总量显示前 60(筛选后共 N 个)」,否则「最新快照(N 个站点行)」page.tsx:542-550;D批P3-10(2026-09-26)截断显式披露——服务端 LIMIT 60 并回传 total_matched(dashboard.py:2056-2059),不让用户误以为榜上只有 60 个 SKU;N 个站点行=markets 卡该市场 productscurl /api/rankings 断言 total>items.length 时 foot 出现「筛选后共」字样生效
AC-EL-RANK-009KPI③平均评分/总评论KPI值=平均评分(两位小数),foot=「N 条评论」page.tsx:472-476、551-555;客户端口径=当前 60 行内 rating 非空行均值 toFixed(2)(无评分行不计分母),总评论=Σreview_count;边界=仅统计展示行,非全市场口径取 /api/rankings items 手工复算均值与页面相等生效
AC-EL-RANK-010KPI④当前品牌KPI值=品牌名或「全部」,foot=「Amazon X · Noon Y 个市场」page.tsx:556-560;X/Y=markets 清单按平台计数(含无快照市场);品牌过滤后为该品牌有数据的市场数切品牌断言 foot 两数与 markets 清单分组计数一致生效
AC-EL-RANK-011市场选择卡标题标题「市场选择」+ 副题「平台 · 站点(产品数 / 快照日)」page.tsx:564;副题即 chip 内容承诺(产品数+快照日两元素必须同时在 chip 上,见 RANK-013)e2e 断言标题与副题文本生效
AC-EL-RANK-012平台双 Tab筛选「Amazon(N 市场)/ Noon(N 市场)」两 tab,各只列本平台市场 chippage.tsx:565-575;2026-10-12 用户令分平台双 tab;切平台 pickPlat 自动选中该平台首个市场(page.tsx:453-460),无数据则置空走空态并清空展开态e2e 切 Noon 断言首个 noon 市场自动选中生效
AC-EL-RANK-013市场 chip筛选每市场一枚 chip:「市场码 · 产品数 · MM-DD 快照日」;快照落后全场最新的标琥珀色,无快照显「· 无快照」page.tsx:578-590;2026-09-29 修——各市场计数取自各自最新快照日,断流市场(如 UK 停 09-27)与当日市场混排无标识会误导,故 chip 必须带快照日且 latest<maxLatest 标 var(--warn)(page.tsx:436-438 注释)e2e 断言含停更市场的环境里该 chip 颜色为 warn生效
AC-EL-RANK-014市场清单加载与选中数据进入页面/切品牌即拉市场清单,自动选中首个市场GET /api/rankings/markets?brand=(page.tsx:422-432;dashboard.py:1926-1954)——audit.cleaned_rankings_daily 按平台×市场取 max(snap_date)+当日计数;排序=有真实数据(rating/bsr 非空)优先(2026-09-19 修:domain1/5/6 等全 NULL 占位行不再排首致默认选中空白);brand 切换重取并自动选该品牌首个有数据市场(2026-09-19 修,如 onno 在 DE 无快照不停留)curl markets 断言排序首个市场 real_cnt>0;SQL 造占位行复现排序修复生效
AC-EL-RANK-015amazon 市场白名单口径amazon 平台市场只出 keepa 真实域站点#49(2026-10-09,dashboard.py:1934-1938 注释/1971-1972 白名单拦截):RANKING_MARKETS 白名单过滤 EU 假市场(FBA 报表残留 country=EU)、UK(目录改码 GB 后 09-29 冻结)与历史 domain 占位行;SE/BE/IE/PL 曾用 US 域冒牌数据一并退场;noon 不受影响;巡检侧同口径见 §11.20 AC-EL-PIPE-039curl markets?platform=amazon 断言无 EU/SE/BE/IE/PL 市场生效
AC-EL-RANK-016平台无市场空态空态「该品牌暂无 Amazon/Noon 平台市场数据」page.tsx:591-593;该品牌此平台 markets 过滤后为空时渲染e2e 选无 noon 数据品牌切 Noon tab 断言空态文案生效
AC-EL-RANK-017产品搜索框筛选placeholder「搜索产品名 / ASIN」+「搜索」按钮page.tsx:595-598;submit 把 search 存入 query 触发重拉;服务端匹配=name ILIKE 或 sku_mapping 解析名 sm.product_name ILIKE 或 asin ILIKE(dashboard.py:2042),三路任一命中curl /api/rankings?search=ASIN 断言命中行;e2e 搜已知 ASIN 断言表内出现生效
AC-EL-RANK-018榜单卡标题(双态)标题Amazon=「BSR 排名」副题「点击行展开 90 天 BSR 趋势(Y 轴反向 = 越上越好)· 每行 = 家族代表 ASIN…」;Noon=「卖家反馈全景」副题「noon 无类目排名数据源——按评论总量排序,点击行展开 90 天评分/评论趋势」page.tsx:603-605;2026-10-14 noon 口径B(用户拍板,page.tsx:512-513 注释):noon 源表实为卖家评论日快照、BSR 四列全 NULL,表格/卡片/展开图按平台分支e2e 分别在 amazon/noon 市场断言对应标题与副题生效
AC-EL-RANK-019Amazon 表头 10 列表格#/产品/品牌/BSR 大类/小类/评分/评论/卖家评分/90 天变化/区间page.tsx:616-620;列集为 amazon 平台专属,noon 切 8 列(见 RANK-020)e2e 断言 thead 列名与列数生效
AC-EL-RANK-020Noon 表头 8 列表格#/产品/品牌/评论总量/评分/卖家评分/90 天净增/快照次数page.tsx:613-615;colN=8(page.tsx:517);口径B 不展示无意义的 BSR 列e2e 切 noon 市场断言 8 列且无 BSR 字样生效
AC-EL-RANK-021行主键口径口径一行=一(品牌, 行键);展开态以「品牌+行键」标识_RANK_KEY=coalesce(nullif(asin,''),name)(dashboard.py:1958):ASIN 缺失时(Noon Z 码等)回退产品名,与历史趋势 join 同口径; DISTINCT ON (brand,行键) 去重SQL 抽 noon 行断言 key=Z 码产品名、amazon 行 key=ASIN生效
AC-EL-RANK-022列·产品名表格加粗显示名服务端 coalesce(nullif(sm.product_name,''),c.name)——2026-10-14 修(用户报障「排名没有产品名称」):源 name 列是机器键(amazon=ASIN、noon=Z码),显示名经 sku_mapping LATERAL 解析(amazon 按 (brand,asin);noon 按 (brand,nsku 前缀=Z码-序号)),无映射回退机器键(dashboard.py:1975-1981 注释与 name_on/2010/2022-2024 sm LATERAL)SQL 对今日快照 amazon 行断言 100% 可映射出显示名生效
AC-EL-RANK-023列·产品底行 SKU·ASIN表格产品名下小字「渠道SKU · ASIN」,无 SKU 回退 ASIN 或「—」page.tsx:633;2026-09-28 C9——SKU 同样经 sku_mapping 解析(LATERAL 取 LIMIT 1),无映射回退机器键e2e 断言已映射行底行含「·」连接的 SKU+ASIN生效
AC-EL-RANK-024列·家族代表徽标表格Amazon 行产品下方胶囊「家族代表 {家族键} · 家族 N 个 ASIN」(仅 N>1 且非 noon)page.tsx:632-638;2026-10-20 方案A(用户问询 fg 在榜 9 ASIN vs mapping 208):#57-g 起采集每(品牌,家族,市场)只拉 1 个代表 ASIN,行内标注家族防观感断层;fam/fam_asins 由 sku_mapping 静态 LATERAL 计算(dashboard.py:2029-2041),家族键=型号>归一化产品名>~asin 与采集器 _family_groups 同口径,平台限 Amazon(noon 无 asin 自然落空)SQL 取 fg Amazon 某家族断言 fam_asins=sku_mapping 同家族 DISTINCT asin 数生效
AC-EL-RANK-025列·品牌表格品牌色点+品牌名page.tsx:643;brandColor 共享调色(AC-EL-CMP)e2e 断言多品牌行色点颜色随品牌变化生效
AC-EL-RANK-026列·BSR 大类表格加粗整数 BSR 值+灰色后缀「 · 大类类目名」;NULL 显「—」page.tsx:657-663;类目名后缀=2026-10-10 #60挂账③(与小类横向统一,有的都要);bsr_big/bsr_big_category 取自最新快照 cur CTEe2e 断言有类目名的行后缀存在且以「 · 」分隔生效
AC-EL-RANK-027列·小类表格灰字整数+「 · 小类类目名」;NULL 显「—」page.tsx:664-668;bsr_small/bsr_small_category 同快照口径e2e 断列存在与格式生效
AC-EL-RANK-028列·评分/评论/卖家评分(Amazon)表格评分、评论数各一位小数/整数;卖家评分灰字;NULL 均「—」page.tsx:665-667;rating/seller_rating toFixed(1)、review_count intSQL 抽行比对三值与页面渲染一致生效
AC-EL-RANK-029列·90 天变化(Amazon)表格「±N (±P%)」;改善(d≤0)绿、恶化红;基准缺失显「—」page.tsx:22-27 trend():d=bsr_big−first_bsr、pct=d/first_bsr×100——BSR 数值降=名次升=改善故 d≤0 绿;first_bsr=90 天窗口首值(hist CTE array_agg 首日,dashboard.py:2002);首值 NULL/0 显「—」取一行 90 天快照手工差分比对 txt 与颜色生效
AC-EL-RANK-030列·区间(Amazon)表格灰字「min90~max90 · N次」;无 90 天数据显「—」page.tsx:671-673;min90/max90=90 天窗口 bsr_big 极值、snapshots=窗口内快照行数(hist CTE,窗口=最新日−90)SQL 复算窗口极值与快照数比对生效
AC-EL-RANK-031列·评论总量(Noon)表格加粗整数;NULL 显「—」page.tsx:645;口径B 排序列=review_count DESC NULLS LAST(dashboard.py:1984)curl noon 榜断言行按评论总量降序生效
AC-EL-RANK-032列·90 天净增(Noon)表格「+N」绿色(>0)、「N」无色、「—」(无法计算)page.tsx:649-652;net90=90 天评论净增(dashboard.py:2008 骤降检出/2014-2020 CASE):源端 09-30 全线计数重置(旧口径聚合值不可比)——服务端检出最近一次骤降(降至前值一半以下)为纪元起点 era_cnt,net90=现值−era_cnt;无重置走窗口首值差分;现值<基准时 NULL 显「—」SQL 取 09-30 前后有快照的 noon 行复算 net90=现值−重置日值生效
AC-EL-RANK-033列·快照次数(Noon)表格灰字「N 次」page.tsx:652;snapshots=hist 90 天窗口内该行快照数,coalesce(h.n,1) 至少 1SQL 复算窗口计数比对生效
AC-EL-RANK-034行点击展开交互点行切换展开行(colSpan 整行),再点收起;切换市场/平台收起展开态page.tsx:461-470/681;展开即 GET /api/rankings/history?platform&market&brand&key(dashboard.py:2065-2087):返回 date/bsr_big/bsr_small/rating/reviews/stars;market+brand+key 任一缺失返回空;失败静默置空图表e2e 点行断言展开行出现且图表 canvas 挂载生效
AC-EL-RANK-035展开图①BSR 趋势线图平滑折线+浅面积,Y 轴反向标注「BSR(升)」page.tsx:502-513(histOption);Y 轴 inverse=BSR 数值越小越靠上;noon 展开跳过此图(口径B 无 BSR 源);T2-8(2026-09-12)五图 UVPVP 对齐e2e amazon 行展开断言首图为 BSR 图、noon 行展开无生效
AC-EL-RANK-036展开图②评分线/③评论数线图两图并排网格:「评分」「评论数」平滑折线(X 轴 MM-DD)page.tsx:481-490(lineOpt 复用);双平台共用e2e 展开断言两图节点数=快照日数生效
AC-EL-RANK-037展开图④星级分布堆叠柱图5★~1★ 五色堆叠柱(Y 轴上限 100%),仅当历史含 star_pct 五元组时渲染page.tsx:479/491-504;star_pct=[5★,4★,3★,2★,1★]% 数组,缺失为 None(T2-8,dashboard.py:2084-2086);hasStars=任一快照 stars 长度≥5SQL 抽有 star_pct 的行展开断言堆叠图出现生效
AC-EL-RANK-038展开加载态加载展开行内「加载趋势…」page.tsx:694;hist 未返回前渲染e2e 慢网络断言过渡文案出现生效
AC-EL-RANK-039表空态空态居中「该市场暂无快照」(colSpan=列数)page.tsx:702-704;items 为空时渲染;市场本身无数据(market 为空)则显示「该品牌在 X 平台暂无市场数据」(page.tsx:606)e2e 选空市场断言两种空态各自出现生效
AC-EL-RANK-040表加载态加载「加载中…」page.tsx:607;!data 且 market 非空时渲染(切市场即置 null 重拉)e2e 断言切市场瞬间出现加载文案生效
AC-EL-RANK-041榜单排序与截断口径口径Amazon 按 BSR 大类升序、Noon 按评论总量降序;均 LIMIT 60dashboard.py:1984 rank_expr=bsr_big ASC NULLS LAST(amazon)/ review_count DESC NULLS LAST(noon,口径B 2026-10-14 用户拍板);LIMIT 60+total_matched 回传(D批P3-10,page.tsx:546 注释)curl 断言 items≤60 且 total 字段存在生效
AC-EL-RANK-042UK→GB 归一口径查询 UK 自动归一 GB,GB 榜单并入历史 UK 行#49(2026-10-09,dashboard.py:1969-1970/2073-2074):目录改码 co.uk→ISO GB 后 UK 断更(09-29 冻结),GB 查询 market IN ('GB','UK') 保 90 天趋势连续;归一仅榜单+历史两处,markets 端点无归一(其市场白名单本身滤 UK)curl /api/rankings?market=GB 断言含 09-29 前快照行的趋势数据生效
AC-EL-RANK-043榜单口径脚注(双态)口径通用句「数据源:平台榜采集(amazon/noon),AE/SA 高频更新,其余站点周期快照;趋势 = 90 天窗口内 BSR 大类对比。」;noon 追加「noon 侧为卖家评论日快照…源端于 09-30 全线重置计数,净增自重置日起算。」page.tsx:709-712;追加句仅 isNoon 渲染,与 RANK-032 net90 口径互证e2e 双平台断言脚注句式切换生效
AC-EL-RANK-044⭐视图数据加载数据切评分视图即拉聚合,失败红横幅,未返回「加载中…」page.tsx:48-55;GET /api/rankings/rating-review-analytics?brand=(dashboard.py:2805-2889)单端点回 as_of/distribution/review_distribution/brands/bsr_distribution/trend/top_review_skus/noon_reviewscurl 端点断言八键齐全生效
AC-EL-RANK-045⭐KPI①快照日期KPIas_of 日期,foot「Amazon 全站点」page.tsx:89-92;as_of=amazon 平台(白名单市场)max(snap_date)(dashboard.py:2818-2821)SQL 复算白名单内 max(snap_date) 比对生效
AC-EL-RANK-046⭐KPI②在榜 SKU/平均评分KPI「N · X.XX」,foot「M 个品牌」page.tsx:59-60/93-97;N=Σdistribution.count、均值=Σ(avg_rating×skus)/Σskus 客户端加权(按品牌 SKU 数加权,非简单平均)取 brands 数组手工加权复算比对生效
AC-EL-RANK-047⭐KPI③评论总量(Amazon)KPI总量,foot「零评论 SKU N 个」page.tsx:98-102;Σbrands.total_reviews、零评论=Σzero_reviews(review_count=0 行)SQL 复算两值比对生效
AC-EL-RANK-048⭐KPI④noon 卖家评论KPI总量,foot「差评(≤2星) N 条」page.tsx:103-110;Σnoon_reviews.reviews、差评=Σnegative(rating≤2 计数);数据源=各租户 noon schema seller_reviews 经 qsource 聚合(ISO-01 租户品牌路由,dashboard.py:2861-2885),异常时该品牌记零不炸页qsource 复算某租户 seller_reviews 总数与 ≤2 星计数生效
AC-EL-RANK-049⭐卡·评分分布图横条图:档位「4.5-5/4-4.5/3.5-4/3-3.5/<3」★+计数+「均N条」page.tsx:112-126;分桶=服务端 CASE(dashboard.py:2823-2829),条宽=count/全图最大 count;avg_reviews=该档平均评论数;空态「无评分数据」SQL 复算各档计数与均值比对生效
AC-EL-RANK-050⭐卡·评论数量分布图横条图:档位「0/1-10/11-100/101-1k/1k+」条+计数page.tsx:127-139;2026-10-07 用户令「review 数量」维度;分桶=服务端 CASE(dashboard.py:2829-2835);空态「无数据」SQL 复算五桶计数比对生效
AC-EL-RANK-051⭐卡·BSR 大类分布图横条图:档位「<1K/1K-10K/10K-50K/50K-100K/>100K」page.tsx:140-154;只统计 bsr_big 非空行(dashboard.py:2845-2850);2026-10-07 起采集器补写 BSR 大类后开始积累,无数则 EmptyState「暂无 BSR 数据」hint「2026-10-07 起排名采集已补写 BSR 大类,点右上「🔄 更新数据」立即拉一次,数据从此日起积累。」如实空不造数SQL 复算五桶计数;空库断言 EmptyState 文案生效
AC-EL-RANK-052⭐表·品牌对比 9 列表格品牌/SKU/平均评分/评论总量/平均评论/≥4★(绿)/<3★(红)/零评论/优良率page.tsx:158-176;优良率=round(good/skus×100)%(客户端);good=rating≥4、poor=rating<3、zero=review_count=0(服务端 FILTER,dashboard.py:2836-2843);空态「无数据」colSpan=9SQL 复算某品牌 good/poor/zero 与优良率生效
AC-EL-RANK-053⭐品牌对比·noon 追加行表格浅底(#fafbfc)行:品牌+「· noon卖家评论」标签,品牌列下国家拆分行「AE N条·X.X★ / SA …」,SKU/平均评论/≥4★/零评论列「—」,<3★列=差评数(红),优良率列=「最新 日期」page.tsx:177-193;只追加 reviews>0 的 noon 品牌;国家拆分=seller_reviews 按 upper(country) 分组(2026-10-10 修复后可用,dashboard.py:2867-2885 循环内);与 amazon 行同表不同源不混算qsource 复算某品牌国家拆分与差评数比对生效
AC-EL-RANK-054⭐图·评分与评论趋势(近30天)图双轴:平均评分紫折线(Y 左轴 3~5 定区间)+评论总量灰柱(Y 右轴)page.tsx:63-79/204-206;数据=snap_date≥current_date−30 按日 avg(rating)/sum(review_count)(dashboard.py:2851-2857);快照日<2 个 → EmptyState「趋势点不足」hint「少于 2 个快照日,无法画线。」SQL 复算 30 天逐日均值比对;单快照日断言空态生效
AC-EL-RANK-055⭐表·评论最多的 SKU(Top 15)表格列 #/ASIN/品牌/评论数/评分;仅 Top15 非空时整卡渲染page.tsx:209-222;服务端最新快照 review_count 非空行 ORDER BY review_count DESC LIMIT 15(dashboard.py:2856-2859)SQL 复算 Top15 顺序比对生效
AC-EL-RANK-056⭐分析页口径脚注口径「数据源:rankings_daily(Amazon,Keepa 日采)+ noon seller_reviews(portal API);评论正文在「💬 评论内容」tab,AI 分析在「🤖 AI 评论分析」tab。」page.tsx:229-231;三视图互链说明e2e 断言脚注逐字生效
AC-EL-RANK-057⭐聚合白名单口径口径评分视图全部聚合只算 RANKING_MARKETS 白名单内市场#60(2026-10-10,dashboard.py:2812-2816):历史占位/冒牌市场行(EU/SA/AE/PL/IE/BE/SE/UK/domain1 共 4,439 行,≤10-09)不再混入分布/品牌对比/30天趋势;实证 fg 趋势 10-09 SKU 441→2319、评论 109,973→470,112 假尖峰;与 RANK-015 榜单侧白名单同源同口径SQL 造 domain1 历史行断言不进 distribution/trend生效
AC-EL-RANK-058💬卡标题标题「💬 评论内容」副题「noon=卖家评论(portal API 直采) · Amazon=商品评论(crawlbase 采集)」page.tsx:258;2026-10-07 用户令双源合一列表(page.tsx:236-237)e2e 断言标题与副题生效
AC-EL-RANK-059💬源切换双 Tab筛选「Noon 卖家评论 / Amazon 商品评论」,默认 noonpage.tsx:260-261;src state 切换即重拉;两源字段名不同(comment vs body、count vs total)由前端兼容e2e 切源断言请求 URL 与列表重拉生效
AC-EL-RANK-060💬星级筛选筛选下拉「全部星级/5 星/4 星/3 星/2 星/1 星」page.tsx:262-265;rating=0 表全部,作为 rating 参数下发两源curl 断言 rating=5 只回 5 星评论生效
AC-EL-RANK-061💬刷新按钮与计数按钮「刷新」按钮重拉当前源;右侧「共 N 条」page.tsx:266-267;N=noon 源 count / amazon 源 total(page.tsx:251)e2e 点刷新断言计数与返回 total 相等生效
AC-EL-RANK-062💬数据源 URL数据noon 源=/api/noon/reviews?rating&limit=200&brand;amazon 源=/api/rankings/amazon-reviews?rating&brandpage.tsx:246-249;amazon 端点(dashboard.py:2892-2915)查 product_reviews 表(2026-10-07 起 crawlbase 采集器填充,未采集前如实返回空),filters brand/country/rating/q,ORDER BY review_date DESC NULLS LAST,limit 服务端默认 100 上限 200,另回全表 total+last_fetched;noon 端点实现属 noon 路由,本组不展开(页面侧调用已实证)curl amazon-reviews 断言 items/total/last_fetched 三键生效
AC-EL-RANK-063💬评论卡·星标展示「★★★☆☆」实星+空星共 5 位;≤2 星红色、其余绿色page.tsx:254/279;星数=round(rating)e2e 断言 1 星评论星标红且空星补足 5 位生效
AC-EL-RANK-064💬评论卡·meta 行展示「日期 · 品牌(或 order/asin) · 国家 · ✓已验证购买 · N人觉得有用」(按字段有无拼接)page.tsx:278-283;verified/helpful 缺省不渲染对应片段e2e 断言已验证评论含「✓已验证购买」生效
AC-EL-RANK-065💬评论卡·正文展示「标题 — 正文」,无标题省略前缀,无正文显「(无正文)」page.tsx:285-287;正文取 comment(noon)或 body(amazon),word-break 换行e2e 断言无正文评论显「(无正文)」生效
AC-EL-RANK-066💬评论卡·SKU 底行展示小字「SKU: xxx · 与描述相符: N」(有 sku 字段时)page.tsx:288;as_described=null 时不渲染该段;noon 卖家评论特有字段e2e 断言 noon 评论卡底行格式生效
AC-EL-RANK-067💬空态(双源)空态amazon:「暂无 Amazon 评论数据」hint「Amazon 商品评论采集自 2026-10-07 启动…」;noon:「无匹配评论」hint「调整星级筛选或点刷新。」page.tsx:272-275;amazon 空态如实告知采集起点不造数e2e 各源空结果断言对应文案生效
AC-EL-RANK-068💬加载/错误态加载「加载中…」过渡;失败红色错误块page.tsx:269-271e2e mock 500 断言错误块出现生效
AC-EL-RANK-069🤖卡标题标题「🤖 AI 评论分析」副题「noon 卖家评论 + Amazon 商品评论 → 问题清单 / 优点 / 缺点 / 建议 · 每次运行耗 1 次 AI 配额」page.tsx:326;2026-10-07 用户令;配额扣减见 RANK-081 服务端口径e2e 断言标题与配额提示生效
AC-EL-RANK-070🤖品牌下拉筛选「全部品牌」+本租户品牌列表page.tsx:304-305/327-330;H9(2026-10-13)单源=useBrand().brands,不再散写 zipforce/onno;顶栏品牌切换联动默认值e2e 断言下拉项=顶栏品牌集生效
AC-EL-RANK-071🤖站点下拉筛选「全部站点」+AE/SA/US/UK/DE/CA/MX/FR/IT/ES 十项page.tsx:331-334;country 上行服务端转大写并过白名单(见 RANK-081)e2e 断言十国选项生效
AC-EL-RANK-072🤖运行分析按钮按钮「🤖 运行分析」,运行中变「AI 分析中…(约 30-90 秒)」并 disabledpage.tsx:336;POST /api/rankings/review-ai body={brand,country}(page.tsx:311-318)e2e 触发后断言按钮禁用与等待文案生效
AC-EL-RANK-073🤖样本说明口径工具栏小字「分析样本=两源最新评论各 ≤150 条」page.tsx:337;与 RANK-081 服务端 LIMIT 150 采样口径一致( noon 与 amazon 各 ≤150)e2e 断言说明文案存在生效
AC-EL-RANK-074🤖结果头展示「分析样本 N 条,结果按重要性排序:」page.tsx:342-344;N=res.samples=实际进入语料条数(>150 时随机抽样后计数)断言 N≤150(>150 时服务端 random.sample 降采样后计数,dashboard.py:2987-2988)生效
AC-EL-RANK-075🤖⚠️问题清单展示每条=左侧色条+问题主题+[severity]+描述;色条 high=红/mid=琥珀/其他灰;空显「无」page.tsx:346-355;severity 由 GLM 输出三档;borderLeft 3px 按档变色e2e 断言 high 条目左色条为 danger 色生效
AC-EL-RANK-076🤖✅优点/❌缺点展示双卡并排,条目「· 文本」列表;空显「无」page.tsx:356-367;pros/cons 由 GLM 输出 3-8 条中文e2e 断言两卡标题与列表结构生效
AC-EL-RANK-077🤖💡给卖家的建议展示编号列表「1. 2. 3. …」;空显「无」page.tsx:368-374;suggestions 可执行建议按重要性排序e2e 断言编号前缀生效
AC-EL-RANK-078🤖原文兜底展示AI 未返回结构化 JSON 时:「AI 未返回结构化结果,原文如下:」+ pre-wrap 原文page.tsx:376-380;analysis=null 时走 raw(服务端截 2000 字,dashboard.py:3005)mock LLM 返回非 JSON 断言兜底渲染生效
AC-EL-RANK-079🤖错误态反馈失败红色错误块(如样本不足 400 文案)page.tsx:316-317/338;样本<5 条服务端 400「评论样本不足(当前 N 条, 需 ≥5)——先点「更新数据」或等采集积累」(dashboard.py:2984-2985)e2e 空库运行断言 400 文案透出生效
AC-EL-RANK-080🤖配额前置口径每次运行消耗 1 次 AI 配额dashboard.py:2956 _ai_quota(t) 入口即校验,配额不足直接拒绝;副题与说明双处披露(page.tsx:326/337)耗尽配额运行断言拒绝响应生效
AC-EL-RANK-081🤖服务端口径口径样本汇聚与安全边界dashboard.py:2948-3005:①country 白名单 ^[A-Z]{2,3}$ 否则 400(P0-1 2026-10-21 补真白名单——qsource 无参数化,10-14 立案的假白名单并不存在);②noon=brand 属本租户 noon schema 才取(ISO-01),comment 非空按 review_date DESC LIMIT 150,country 过滤为白名单后安全内插;③amazon=product_reviews body 非空 LIMIT 150;④合计<5 拒绝;⑤>150 random.sample 均衡两源;⑥GLM llm_chat 严格 JSON system prompt(问题/优点/缺点各 3-8 条中文按重要性排序);⑦regex 提取 JSON 失败走 raw;⑧audit rankings.review-ai 记 brand/country/ncode review 逐条比对;注入 country=AE' OR '1 断言 400生效
AC-EL-RANK-082更新数据源新鲜度回报口径refresh 回报三源:amazon_rankings/noon_reviews/amazon_reviews(count+last)dashboard.py:2926-2946;amazon_rankings=cleaned_rankings_daily max(snap_date);noon_reviews=各租户 noon schema 最新评论日取最大(ISO-01,不硬编码 zipforce_noon);amazon_reviews=product_reviews 全表 count+max(fetched_at);仅 noon_reviews 源带 try/except 兜底(dashboard.py:2932-2942),amazon_rankings/amazon_reviews 两路无保护SQL 三源复算与 sources 回报比对生效
AC-EL-RANK-083排名源断供口径(跨页引用)口径上游 keepa 断供与采集缺口的区分不在本页判定,本页只呈现快照日滞后(RANK-013 琥珀标)断供判定与「源断供(keepa 站点无数据, 非采集缺口): 」reason 前缀归管道巡检口径(§11.20 AC-EL-PIPE-034~039,metrics.py:270-273,KEEPA_SOURCE_DEAD);两页共用 cleaned_rankings_daily,同口径跨层必相等对同一停更市场比对巡检 reason 与本页 chip 琥珀标一致生效
AC-EL-RANK-084数据底表与租户隔离口径本页全部读路径经租户+品牌双隔离八端点(markets/list/history/analytics/amazon-reviews/refresh/review-ai+noon reviews)全部走 tenant_conn(tenant_id, brand_scope);noon 侧按 tenant_noon_schemas 路由(ISO-01 一租户一公司,不向他牌租户披露组合);写路径仅 refresh(owner/admin)与 review-ai(配额+audit)跨租户账号访问断言只见本租户品牌数据生效

§11.32 产品页(/products · AC-EL-PRD,40 条 · 2026-10-22 源码实证 web/app/products/page.tsx 299 行 + api/routers/ops.py /api/products(62-113 行)+ api/routers/brandboard.py /api/brandboard/product-drill(481-533 行)+ api/routers/ads.py /api/ads/price-suggestions(1137 行),建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PRD-001页壳/面包屑导航AppShell title=商品,面包屑「产品本体 × 渠道 SKU · product_name + model_number 为对齐核心」路由 /products;权限=current_user(登录即可,无模块门,ops.py:63);产品对齐核心=(brand, product_name, model_number),SKU/ASIN/NSKU 是渠道呈现(ops.py:68 docstring)e2e 登录断言标题与面包屑逐字生效
AC-EL-PRD-002错误横幅反馈接口失败红色横幅 role="alert"仅 /api/products 失败 setErr;调价建议接口失败静默(见 019)mock 500 断言横幅出现生效
AC-EL-PRD-003视图切换 tab导航「📋 商品清单(30 天)」默认 /「🗂 下钻视图(Series→…→Size)」本地 useState 切 flat/drill(不进 URL);两视图独立数据流e2e 切 tab 断言容器互换生效
AC-EL-PRD-004flat·搜索框筛选placeholder「搜索 产品名 / 型号 / SKU / ASIN / 类目」+ 搜索按钮submit 才 setQuery 并回第 1 页(输入不即搜);SQL:p.sku/p.title/p.category ILIKE + m.product_name/m.model_number ILIKE(LEFT JOIN LATERAL sku_mapping)搜型号断言命中映射行;搜不存在串断言空态生效
AC-EL-PRD-005flat·排序 select筛选SORTS 五项:按营收/按销量/按售价/按毛利率/按 SKUops.py:71-73 sort_sql 映射:revenue→rev30 DESC NULLS LAST、units→u30、price→p.price、margin→_PROFIT_EXPR、sku→p.sku;change 重置第 1 页逐排序断言首页单调生效
AC-EL-PRD-006flat·国家筛选筛选「全部国家」+ data.countries 动态选项语义=sku_mapping 中该 (brand,sku) 在该国上架(2026-09-28 C8;products 表无国家列,EXISTS 子查询 ops.py:77-78);countries=DISTINCT sku_mapping.country 非空(109-112 行)选国断言全部行在该国有映射;countries 与 SQL DISTINCT 对拍生效
AC-EL-PRD-007flat·数据接口接口GET /api/products?search&sort&country&brand&page&page_sizeops.py:62-113;agg CTE=sales_daily 30 天窗(day > current_date−30)GROUP BY brand,sku 聚 u30/rev30/sp30;LEFT JOIN LATERAL sku_mapping LIMIT 1 取产品本体;page_size 前端 25、服务端 clamp [1,100];COALESCE 聚合空档为 0接口直调断言 clamp;30 天窗边界日 SQL 对拍生效
AC-EL-PRD-008flat·列 产品名/型号表格列两行:product_name(strong,fallback title→「—」)+ t2「model_name · model_number · color · size」product_name/model_name/model_number/color/size 均来自 sku_mapping 映射(空段省略);CSV 三段拼接抽行与 sku_mapping 比对生效
AC-EL-PRD-009flat·列 品牌表格列branddot 色点 + 品牌名brandColor(brand) 跨页一致(AC-UI-07);可排序同品牌多页断言同色生效
AC-EL-PRD-010flat·列 渠道 SKU表格列等宽 sku 样式p.sku 直显;可排序;rowKey=brand+sku抽行比对生效
AC-EL-PRD-011flat·列 ASIN / NSKU表格列「{asin} / {nsku}」muted;空 asin 显「—」asin/nsku 来自 sku_mapping;CSV 两值斜杠拼接抽行比对映射表生效
AC-EL-PRD-012flat·列 类目表格列muted 文本category→platform→「—」三级回退;排序键同回退链无类目行断言显 platform 或 —生效
AC-EL-PRD-013flat·列 售价 USD表格列右对齐 usd 2 位p.price::float8;null 由 fmt 层显「—」;排序 null 计 −1无价行断言 —生效
AC-EL-PRD-014flat·列 成本 RMB表格列右对齐整数p.cost:truthy 显 int(cost) 否则「—」;成本口径=sku_mapping.cost_rmb(映射优先,采购表回退,见 021 caliber)缺成本 SKU 断言 —(与 3 SKU 缺成本主数据挂账联动)生效
AC-EL-PRD-015flat·列 30 天销量表格列右对齐整数units30=COALESCE(a.u30,0)(agg CTE,007)SQL 同窗复算生效
AC-EL-PRD-016flat·列 30 天营收表格列strong usd 2 位revenue30=COALESCE(a.rev30,0);金额=USD(caliber)SQL 同窗复算生效
AC-EL-PRD-017flat·列 30 天广告费表格列右对齐 usd 2 位ad_spend30=COALESCE(a.sp30,0)(sales_daily 同源广告聚合)SQL 同窗复算生效
AC-EL-PRD-018flat·列 估算毛利率 *表格列pct 百分比;null 显「—」_PROFIT_EXPR(ops.py:59-60)=(price − cost×0.1471 − 0.12×price)/price×100,ROUND 1 位;price 或 cost 空/0→NULL→「—」不兜底假值(D批P3-14:删与实现相悖的「缺失按 0.25×售价」旧注);人民币成本 ×0.1471 折算与 FIN 同源利润模型同口径(AC-EL-AI-016 脚注同源引用);排序 null 计 −999手算样例对拍;缺成本行断言 —;与财务模块同 SKU 毛利率跨层一致(Δ 绝对值≤0.1)生效
AC-EL-PRD-019flat·列 💰 调价建议表格列badge warn=action + t2「毛利 X%」「库存 Y 天(status)」;title=reason 悬停看依据GET /api/ads/price-suggestions?brand=(ads.py:1137)取每 SKU 最新一期未驳回建议;无建议显「—」;无广告模块权限静默留空(catch 置空表不显红条);CSV=action;2026-10-11 A 从 /ads 建议列表迁入本页有建议 SKU 断言 badge+悬停依据;无权限租户断言列全 —生效
AC-EL-PRD-020flat·DataTable 契约组件复用表格容器/CSV/分页/口径行复用 AC-EL-CMP-014(通用表)/016(导出 CSV)/017(分页)/018(caliber)/019(加载空态);本页仅传参:exportCsv="products"、empty=「无匹配商品」、pager pageSize=25、loading=!data&&!err断言空态文案与导出文件名生效
AC-EL-PRD-021flat·caliber 口径行口径「产品表口径:金额=USD|数据源=产品主表(sku_mapping/products)|30 天聚合(销量/营收/广告)|成本=sku_mapping.cost_rmb(映射优先,采购表回退)。」UI 文案即验收标准(AC-UI-01),逐字受保护;与 007-017 各列实现一一对应页面文案与库内记录逐字 diff生效
AC-EL-PRD-022flat·底部脚注口径三行:①「* 官方口径估算:(售价 − 采购成本×0.1471 − 0.12×售价) / 售价;未维护成本的 SKU 显示 —」②「💰 调价建议来自广告规则引擎(每日 23:00 UTC,库存/毛利率护栏),悬停看依据;接受/拒绝到「广告 → 关键词优化」处理。」③「产品本体 = product_name + model_number(全站对齐核心);SKU/ASIN/NSKU 是渠道呈现。」①与 _PROFIT_EXPR 同式(018);②规则引擎调度 23:00 UTC 属广告模块口径(AC-CAL 系列域);③与 ops.py:68 docstring 同义逐字 diff;公式与 018 实现对拍生效
AC-EL-PRD-023drill·粒度 tabs筛选周(默认)/月/日gran 白名单 day/week/month,非法值后端回落 week(brandboard.py:485-486)gran=year 直调断言响应 gran=week生效
AC-EL-PRD-024drill·窗口 tabs筛选30/90/180/365 天(默认 90)days 服务端 clamp [1,3650](brandboard.py:487)days=9999 直调断言响应 days=3650生效
AC-EL-PRD-025drill·计数条反馈「{rows} SKU · 共 {total_units} 件」/「加载中…」rows=接口明细行数;total_units=round(sum(r.total))(brandboard.py:532-533)与接口响应两值对拍生效
AC-EL-PRD-026drill·Expand/Collapse按钮全展开/全收起allOpen 布尔覆盖单节点 open 记录;Collapse 同时清空 open 表Expand 后断言全部叶行可见生效
AC-EL-PRD-027drill·⬇ CSV按钮导出 zf_product_drill_YYYYMMDD.csvBOM 头 Excel 直开;列=系列/产品/国家/颜色/尺码/SKU+全桶列(不截断,区别于展示 26 桶)+TOTAL;esc 处理引号/逗号/换行断言文件名日期、表头全桶数=buckets.length生效
AC-EL-PRD-028drill·数据接口接口GET /api/brandboard/product-drill?brand&days&granbrandboard.py:481-533;数据源=audit.cleaned_amazon_orders(剔 'Canceled','Cancelled' 两拼写)+ sku_mapping 层级映射(series=product_name/product=model_name/color/size/国家,缺省回退「(无系列)/(无色)/(无码)/?」或 sku 本身)+ audit.cleaned_inventory_health 库存快照;无 SKU 单记「(无SKU)」桶接口直调对拍三源行数;剔取消单口径 SQL 复算生效
AC-EL-PRD-029drill·件数均摊口径口径每订单 items_count 按 SKU 数均摊sku_list 逗号拆分 n 份,每份 +(ic or 1)/n(items 级粒度未 ingest 的近似口径,脚注原文);桶值/total 均 round 取整两 SKU 单各记 0.5 再 round 对拍手算生效
AC-EL-PRD-030drill·bucket 格式口径桶标签三种粒度月=YYYY-MM、周=ISO 年-Www(周数补零,brandboard.py:503-509 bucket())、日=MM-DD;桶全集升序跨年周断言 ISO 年正确生效
AC-EL-PRD-031drill·五级树构建逻辑Series→Product→Country→Color→Size 层级树buildTree(page.tsx:14-40):叶=bucket 求和+total;rollup 自底向上累加、同级按 total 降序单测:给定行集断言父级=子级和且排序生效
AC-EL-PRD-032drill·26 桶展示截断边界表体只显示最近 26 个桶buckets.slice(-26) + off 偏移取值(page.tsx:60-61);防横向爆炸;CSV 导出不受限(027)365 天日粒度断言列数=26生效
AC-EL-PRD-033drill·表头表格列「Series → Product → Country → Color → Size」+桶列+TOTAL+AVG+📦Stock首列表头为层级链说明文字;桶列右对齐表头文案断言生效
AC-EL-PRD-034drill·行渲染表格列缩进=8+depth×16 px;▾/▸ 折叠钮;depth0 背景加深;叶行附 SKU muted 小字无子级行 26px 占位符对齐;名称加粗 depth0=700 其余 500视觉断言缩进梯度与折叠交互生效
AC-EL-PRD-035drill·AVG 列表格列桶均销量 toFixed(1);0 显「·」avg=total/max(1, 非零桶数)(分母只计值>0 的桶,page.tsx:70)单桶有值行 avg=total 对拍生效
AC-EL-PRD-036drill·📦Stock 列表格列叶行库存数;无映射/非叶显「—」stock[leaf.sku]=cleaned_inventory_health.total_qty(FBA 快照口径,与 037 脚注一致)抽 SKU 与库存页总库存对拍生效
AC-EL-PRD-037drill·TOTAL 行表格列表底根合计行(背景加深 700 加粗)各桶列=根节点子树合计;TOTAL=全部 total 和;AVG/Stock 显「—」(跨 SKU 加总无意义)断言 TOTAL 行各桶=列求和生效
AC-EL-PRD-038drill·空态空态「无数据」/「加载中…」data 有值且树空=无数据;data=null=加载中;colSpan=buckets.length+4空品牌断言「无数据」生效
AC-EL-PRD-039drill·脚注口径「件数按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径);层级名取 SKU 映射(系列=产品名 / 产品=型号名);📦Stock = FBA 快照 total_qty。Expand 展开全部层级。」与 029/028/036 实现一一对应;逐字受保护逐字 diff生效
AC-EL-PRD-040隔离与品牌联动口径两接口均吃全局品牌选择器/api/products 与 /api/brandboard/product-drill 均经 tenant_conn(tenant, brand_scope)+brand 参数(铁律:租户/品牌绝对独立);调价建议请求同带 brand切品牌断言两视图数据集与 KPI 计数随之切换且无跨租户行生效

§11.33 库存页(/inventory · AC-EL-INV,57 条 · 2026-10-22 源码实证 web/app/inventory/page.tsx 278 行 + inventory/DocsTab.tsx 575 行 + inventory/NoonTab.tsx 256 行 + api/routers/inventory_po.py /api/inventory/*(44-182 行)+ api/routers/inv.py 台账端点(60/72/92/126/149/182/235/275/291/320/352/370/387 行)+ api/routers/brandboard.py /api/noon-inventory(428 行)+ api/routers/noon_data.py(102/119 行)+ api/routers/noonops.py(123/274/283/304 行),建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-INV-001页壳/面包屑导航AppShell title=库存,面包屑「亚马逊 FBA 库存健康 · 每日快照」路由 /inventory;FBA 域端点 require_module("inventory")(inventory_po.py:45/133);2026-09-19 起接入全局品牌选择器(与其他页一致)e2e 断言标题面包屑;未开通租户 403生效
AC-EL-INV-002主 tab×3导航「FBA 库存快照(补货预警)」默认/「🧾 单据台账(国内仓/在途)」/「📦 Noon FBN 预警」(条件渲染)mtab 本地 state(fba/docs/noon);docs→DocsTab、noon→NoonTab、fba→本页 FBA 区e2e 逐 tab 断言容器生效
AC-EL-INV-003Noon tab 可见性探测守卫品牌无 Noon 数据时隐藏 Noon tab 并回落 fbabrand 非空时 GET /api/noon-inventory?brand=&page_size=1(brandboard.py:428)探测 rows 非空;失败=隐藏;brand 空=显示;mtab=noon 且 hasNoon=false 时 useEffect 拉回 fba(2026-09-22 用户令:fittingirls 没 Noon 不需要 Noon tab)fittingirls 断言无 Noon tab;onno 断言有生效
AC-EL-INV-004FBA·KPI 状态卡组KPI 卡每 stock_status 一卡:count + foot「可售 N · 在途 M」断货 danger/无销售 warn/其余 ok 色(page.tsx:169);by_status=GROUP BY stock_status(count+sum(total_qty)+sum(inbound)+sum(good_qty),inventory_po.py:84-94);吃 status/brand/search 筛选、不吃国家(后端注释明示)SQL 复算各状态四值;断言色规生效
AC-EL-INV-005FBA·KPI 空卡KPI 卡「库存数据 — 当前品牌暂无 FBA 库存快照」data 已加载且 by_status 空时渲染(不裸空白)无快照品牌断言该卡生效
AC-EL-INV-006FBA·合计可售/在途卡KPI 卡totalGood 大数 + foot「在途 N 件」totalGood/totalInbound=by_status 求和(前端 reduce,page.tsx:149-150)断言=by_status good/inbound 列总和生效
AC-EL-INV-007FBA·国家 tab 行筛选「各国在库 SKU:」标签 + 🌍 全部 + 各国按钮;主数=在库 SKU、斜杠后小字=在管行数主数=stocked(total_qty>0 的 SKU 数)/count=在管行数(上架即统计,2026-09-22 口径保留为辅注;C批C1 2026-09-26 两数并列不推翻旧拍板);每按钮 title 双数说明;EU 显示「EU·共享」;全部按钮 title=全量合计双数;右侧提示「← 主数=在库 SKU,/后=在管行数…」点国断言明细只剩该国行;title 双数 SQL 对拍生效
AC-EL-INV-008FBA·by_country 后端口径口径站点归一+固定国家清单inventory_po.py:62-83:_MP_NORM 13 个 marketplace 原始 ID→国家码(ATVPDKIKX0DER→US…A2VIGQ35RCS4UG→AE,与 sync_source ingest 归一化一致);_FIXED_COUNTRIES=US,UK,DE,FR,IT,ES,SE,BE,NL,PL,IE,CA,MX,AU,JP,SA,AE 固定列出(无数据写 0);非固定码(EU 聚合桶等)单列追加——2026-09-28 A5:原 skip 把 onno 5 行/zipforce 38 行静默藏掉已修SQL 按 _MP_NORM 复算 stocked/count;断言 17 固定国全出现生效
AC-EL-INV-009FBA·库存明细接口接口GET /api/inventory/health?status&search&brand&country&page&page_sizeinventory_po.py:44-120;page_size clamp [1,10000](前端首拉 10000 全量,保客户端排序/列筛选/导出);搜索四字段 ILIKE(sku/asin/m.product_name/m.model_number);排序 stock_status 断货1/无销售2/正常3/充足4/ELSE 5 + daily_sales DESC NULLS LAST(断货优先)接口直调断言 clamp 与排序首行断货生效
AC-EL-INV-010FBA·状态筛选筛选全部状态/断货/无销售/正常/充足/低库存 六枚STATUS_FILTERS 常量(2026-09-17 修:KPI 有 5 态而筛选原缺低库存);status→stock_status 精确等值;「低库存」不在列头 BADGE 映射内→badge 回退 dim;点选重置第 1 页选断货断言全行断货;低库存筛选按 DB 实值验收生效
AC-EL-INV-011FBA·国家下拉筛选「全部国家」+ 各国({count})与国家 tab 同 state 同步(双向一致);选项文案 EU·共享;change 重置第 1 页tab 与下拉互切断言同步生效
AC-EL-INV-012FBA·搜索框筛选placeholder「搜索 产品名 / 型号 / SKU / ASIN」+ 搜索按钮submit 才 setQuery 回第 1 页;四字段 ILIKE 同 009搜 ASIN 断言命中生效
AC-EL-INV-013FBA·⬇ 导出 CSV按钮按当前筛选导出全量明细(跨页)exportDetailCsv(page.tsx:125-148):动态翻页 1000/页按 total 翻到底,50 页=5 万行防御上限触顶显式报错「导出不完整…请缩小筛选范围后重试」(B批P2-8 2026-09-26:原 50 页×100 行=5000 静默截断 t3 8809 行丢 3809 已修);文件名 inventory_{品牌名或 all}_{国家码或 all}.csv;BOM 头;13 列表头(品牌,国家,产品名,型号,SKU,ASIN,总库存,可售,预留,在途,日均销量,可售天数,状态);exporting 时禁用+「…」fg 全量导出断言行数=total;CSV 表头 13 列断言生效
AC-EL-INV-014FBA·明细表 11 列表格列产品名/型号(两行:product_name→title→sku 回退 + 型号·SKU/ASIN)·品牌色点·站点·ASIN·总库存·可售·预留·在途·日均销量·可售天数·状态INV_COLS(page.tsx:37-52):站点=marketplace 归一码(008);可售 strong;日均 null→「—」否则 toFixed(1);天数 null→「—」否则 Math.round;状态 badge BADGE={断货:bad,无销售:warn,正常:ok,充足:ok} 未知 dim;列头排序(DataTable 客户端)抽行比对源表;null 销速行断言 —生效
AC-EL-INV-015FBA·70vh 限高滚动容器边界明细表容器 maxHeight 70vh 滚动2026-10-01 像素审计 P3 缺陷㊲:首拉 10000 行在 fittingirls 8500 SKU 把页面撑到 62 万 px——限高兜底(mapping 页同模式);服务端分页方案列 P4 待拍板fg 全量加载断言页高正常、容器内滚动生效
AC-EL-INV-016FBA·明细空态空态「无匹配库存」data 加载且 items=0(含筛选无命中)时渲染;loading 期不显无命中搜索断言文案生效
AC-EL-INV-017FBA·明细 caliber 与脚注口径「库存健康表口径:数量=件|数据源=FBA 库存健康每日快照(cleaned_inventory_health,约 04:00 UTC 更新)|仅含在管 SKU|断货=优先补货或清仓决策|无销售=有库存但无动销|销速=近 30/90 天日均销量。」+ 卡底脚注同源UI 文案即验收标准(AC-UI-01)逐字受保护;04:00 UTC 更新属采集管道口径文案逐字 diff;更新时刻对采集日志核验生效
AC-EL-INV-018预警卡标题与口径 sub口径「补货预警」+ sub「补货口径:有销速 → 可售 < 35 天需求线 = 紧急,< 90 天 = 观察;无销速 → 断货 = 紧急,其余单列「无动销」(2026-09-28 重构,销速缺失不再冒充健康)」2026-09-28 A4 重构(fittingirls 取证:原算法 daily_sales=0→天线=0→恒落 ok,健康桶 6307 断货+2053 无销售=93% 错分);与 020 _ALERT_CTE 分桶一致逐字 diff;分桶规则对拍 020生效
AC-EL-INV-019预警·级别 tabs筛选紧急/观察/无动销/健康 +「({count})」;默认 urgentLEVEL_LABEL 映射(urgent 紧急/watch 观察/nosale 无动销/ok 健康);count=summary[l].count 无数据显示「—」;page_size=15(无分页器仅取首页)切级断言表行 level 全一致生效
AC-EL-INV-020预警·接口与分桶接口GET /api/inventory/alert?level&search&brand&countryinventory_po.py:132-182 + _ALERT_CTE(core.py 共享,ARC-02 2026-10-14 迁移,notify 同源)分桶四规则:①有销速行才参与 35/90 天线(urgent=可售<n35、watch=可售<n90、ok=其余)②无销速且断货或可售≤0→urgent ③其余无销速→nosale ④need/shortage 无销速=NULL 不可算;need=ceil(日均销速×35/90);shortage=max(0,n90−可售);销速=v_inventory_health 30 天口径;po_inbound=本租户在途 PO(submitted/confirmed/in_transit)未收数量按 brand+SKU+市场关联(D批P3-7 2026-09-26 市场维:pi.marketplace 空=不限国/非空=精确匹配);排序 urgent→watch→nosale→else + shortage DESC NULLS LAST + daily_sales DESC NULLS LASTSQL 按 CTE 复算各级 count/shortage;断货无销速行断言落 urgent生效
AC-EL-INV-021预警·summary 汇总口径口径{level:{count,good,inbound,shortage,po_inbound}}与明细同 CTE 同参数(brand+country);D批P3-6 2026-09-26:原只吃 brand——选国家后 urgent/watch 数字仍全量与页面自相矛盾已修选国后 summary 与明细同筛选复算一致生效
AC-EL-INV-022预警·缺口合计行反馈「紧急缺口合计 N 件 · 90 天线缺口合计 M 件」紧急合计=summary.urgent.shortage;90 天线=urgent+watch shortage 相加;urgent 桶全为无销速行时 shortage=NULL→整体显「—」(分量未知即整体 —,??0 会显误导性 0;误导性 0 禁则同 AC-EL-ORDER-004 系)全无销速 urgent 桶断言「—」非 0生效
AC-EL-INV-023预警表 12 列表格列产品名/型号(map_asin)·品牌·站点·可售·在途·在途(PO)·日均销量·35 天线·90 天线·缺口·级别·操作ALERT_COLS(page.tsx:58-76):可售在 level≠ok 且 good<need35 时 danger 色;在途>0 brand 色;po_inbound>0 ok 色;日均 null「—」;两天线 muted int;缺口>0 warn 色 700 加粗;级别 badge LEVEL_TONE={urgent:bad,watch:warn,nosale:dim,ok:ok};列头排序构造行断言四色规则与 null 显 —生效
AC-EL-INV-024预警·下PO 按钮操作行内「下PO」链接Link href=/po?prefill={encodeURIComponent(sku)}——跨页预填 /po 新建(AC-EL-PO 域联动)点下PO 断言跳转且 prefill=该 SKU生效
AC-EL-INV-025预警·空态与导出空态「该级别无 SKU」;exportCsv="inventory_alerts"DataTable 复用(AC-EL-CMP-014/016/019);loading=!alert健康级空断言文案;导出文件名断言生效
AC-EL-INV-026预警·caliber口径「库存预警表口径:数量=件|数据源=cleaned_inventory_health(SKU×marketplace 库存快照)|90 天销速算缺货分级(urgent/watch/ok)|缺口=按 90 天销速×当前库存推算的缺货件数。」逐字受保护(AC-UI-01);与 020 实现对应逐字 diff生效
AC-EL-INV-027预警·脚注口径「补货算法:需求线 = ⌈日均销速 × 35/90⌉(销速取 30 天口径,随日内增量任务每 2h 刷新);缺口 = 90 天线 − 可售。无销速行不参与天数线(需求线/缺口显 — ):断货即紧急,其余入「无动销」——销速源头覆盖稀疏(约 5% 行有值),补齐取数见采集需求单。紧急 SKU 建议结合在途量决策补货。」公式与 020 一致;「约 5% 行有值」为覆盖率披露(采集缺口挂账);2h 刷新属采集调度逐字 diff;SQL 复算销速非空占比≈5%生效
AC-EL-INV-028CustomModules 挂载位组件页底 CustomModules page="inventory"租户自定义模块位(AC-EL-CMP 域);随租户配置渲染配置模块租户断言出现生效
AC-EL-INV-029DocsTab·子 tab×5导航单据(默认)/库存余额/流水/📈 报表/基础资料;docs sub 显「+ 新建单据」、stock sub 显「📋 盘点录入」sub 本地 state;数据按需懒加载(stock/base 首开加载、ledger 每开刷新);台账引擎在 api/routers/inv.py(DocsTab.tsx:2-3 文件头注释:移动加权平均/单事务/红冲按台账净额反向)e2e 逐 sub 断言容器与按钮生效
AC-EL-INV-030DocsTab·单据筛选双下拉筛选「全部类型」+DOC_TYPES 6(GRN 采购入库/PRETURN 采购退货/OUT 其他出库/TRANSFER 调拨/STOCKTAKE 盘点/ADJUST 报损溢);「全部状态」+草稿/已过账/已红冲/取消GET /api/inv/docs?doc_type&status&brand(inv.py:92);STATUS 三态=draft/approved/cancelled选类型+状态断言行集双条件成立生效
AC-EL-INV-031DocsTab·单据表 9 列表格列单据号·类型·日期·仓库·关联 PO·行数·金额·状态·操作docCols(DocsTab.tsx:113-131):单据号 sku strong;类型 badge dim 中文;仓库 TRANSFER 显「仓 → 目标仓」;关联 PO ref_no 空显「—」;金额 toLocaleString 2 位(0 显「—」);状态 badge approved ok/cancelled dim/draft warn;exportCsv=inv_docs抽单据与台账表比对九列生效
AC-EL-INV-032DocsTab·操作列操作详情(恒显)+ 过账(仅 draft)+ 红冲(仅 approved,danger 色)详情=openDetail GET /api/inv/docs/{id}(inv.py:126);过账/红冲见 033/034;操作后刷新列表并置空余额缓存approved 行断言无过账钮;draft 行断言无红冲钮生效
AC-EL-INV-033DocsTab·过账确认操作confirm「过账 {doc_no}?」正文「过账后写入台账并计算移动平均成本;已过账单据只能红冲。」POST /api/inv/docs/{id}/approve(inv.py:182);成功 toast「{doc_no} 已过账」e2e(测试租户)过账草稿断言状态翻已过账+余额变动生效
AC-EL-INV-034DocsTab·红冲确认操作confirm「红冲 {doc_no}?」正文「按台账净额反向冲回;草稿直接取消。操作会留审计记录。」POST /api/inv/docs/{id}/cancel(inv.py:235);danger 色确认钮;成功 toast「{doc_no} 已红冲」过账→红冲断言余额回到过账前(净额反向)生效
AC-EL-INV-035DocsTab·单据空态空态EmptyState「暂无单据」hint「点右上「新建单据」录入入库/出库/调拨;PO 收货会自动生成入库单。」PO 收货自动 GRN 联动(inventory_po.py:429-439 auto_grn_for_po_receive)新租户断言空态文案生效
AC-EL-INV-036DocsTab·单据 caliber口径「库存单据表口径:数量=件|数据源=台账单据(入库/出库/调拨,手工录入+PO 收货自动生成入库单)|状态=草稿/已过账/已作废。」逐字受保护(AC-UI-01)逐字 diff生效
AC-EL-INV-037DocsTab·详情抽屉抽屉maxWidth 640;标题「{doc_no} · {doc_type_cn}」+状态 badge;muted 行「日期 · 仓库 · 关联 · 备注」;明细表 SKU/产品/数量/单价/金额;底部过账/红冲/关闭明细项数量附「(账面 {count_qty})」当盘点单有账面数;单价/金额空显「—」开盘点单详情断言账面数显示生效
AC-EL-INV-038新建抽屉·表头字段输入组类型 select(DOC_TYPES)/仓库 select(warehouses);条件字段:TRANSFER 目标仓、ADJUST 方向(报溢(+)/报损(−))、GRN/PRETURN 关联 PO(approved 且 PO- 前缀前 50 条);源码另有 dtype=「PO」供应商分支(GET /api/po/suppliers,DocsTab.tsx:328/387-394)但类型下拉仅 DOC_TYPES 6 项无 PO=死代码永不渲染仓库源 GET /api/inv/warehouses(inv.py:60);关联 PO 下拉按类型懒加载(dtype 变化触发);「供应商」懒加载分支同属死代码切类型断言条件字段出现/消失生效
AC-EL-INV-039新建抽屉·物料行编辑输入组行内 SKU/产品名/数量/单价(仅 GRN·TRANSFER·ADJUST)/批次/序列号/删行(多行时);「+ 加行」;合计 ¥;备注输入合计=Σ qty×unit_price(仅非空 SKU 行)toFixed(2) 实时计算;数量 type=number、单价 step=0.01改行数断言合计随动生效
AC-EL-INV-040新建抽屉·保存两钮操作「保存草稿」/「保存并过账」校验「至少一行有效物料(SKU + 正数量)」;保存=POST /api/inv/docs(inv.py:149)body 含 doc_type/warehouse_id/target_warehouse_id/supplier_id/ref_no/adj_sign/remark/items;过账=连调 approve;toast「{doc_no} 已存草稿/已保存并过账」;引擎行为=移动加权平均成本(services.py:113-150)、单事务幂等(inv.py:186-194)、净额反向冲销(inv.py:248-269)e2e 双路径各建一单断言状态;inv.py 端点体已逐行核(单事务+幂等+反向三行为实证)v5.1生效
AC-EL-INV-041新建抽屉·类型说明文案口径按类型切换的 muted 说明五种GRN「入库按单价计入移动平均成本;可在备注写 PO 号关联。」/PRETURN「退货出库按当前均价扣减。」/TRANSFER「调拨出按均价、入按填写的单价(默认填转移价值)。」/STOCKTAKE「盘点请用「库存余额」页的 📋 盘点录入(自动带账面与标准成本)。」/ADJUST「报损出库、报溢入库(可带成本)。」逐类型断言文案生效
AC-EL-INV-042余额 sub·台账库存表表格列10 列:SKU·产品·仓库·在库·在途·预留·预计可售·ROP·移动均价·库存总价GET /api/inv/stock?page_size=200&brand(inv.py:291);预计可售 low=true 时 danger 700;ROP 空显「—」;均价 2 位;总价 toLocaleString 2 位;exportCsv=inv_stock;caliber「…与 FBA/FBN 快照独立(手工台账)」;空态「暂无台账库存」hint「过账第一张入库单后这里会出现余额。」过账入库单后断言余额行出现且数值=单据量生效
AC-EL-INV-043盘点录入抽屉操作仓库 select(切换重拉计划);表 SKU/账面/实盘输入/差异(+ok/−danger/0 muted/空「—」);「提交盘点 & 过账」计划 GET /api/inv/stocktake/plan?warehouse_id(inv.py:275)带 on_hand/avg_cost/std_cost;提示「只提交实盘≠账面的行;过账时服务端重算差异」;提交=STOCKTAKE create+approve 两连调(unit_price=std_cost 空则 avg_cost);无差异 toast「没有差异行(实盘与账面一致或未填写)」e2e 盘点一 SKU 实盘±N 断言差异过账进台账生效
AC-EL-INV-044流水 sub表格列搜索「搜 SKU / 单据号 / 备注」(Enter/按钮)+ 表 8 列:时间·SKU·仓库·变动·结存·单价·单据·备注GET /api/inv/ledger?q&brand(inv.py:320);变动正+绿/负−红 600 加粗;加载 Spinner/空 EmptyState「无流水」过账一单后搜单据号断言流水行生效
AC-EL-INV-045报表 sub·出入库报表图表近 7/30/90 天 tabs(默认 30)+ 双色柱条 + 表 4 列(日期·入库量+绿·出库量−红·流水笔数)GET /api/inv/report?days&brand(inv.py:387);柱高=值/窗口最大值、minHeight 2px、title「{date} 入 X / 出 Y · Z 笔」;表 reverse 最新在前;空态「窗口内无流水/加载中…」;副标题「库存流水按日聚合 · 入库=正变动 / 出库=负变动」(T3-3 2026-09-12 UVPVP 对齐)造已知流水断言柱与表数值生效
AC-EL-INV-046基础资料·产品主数据表单/表格录入行(SKU/产品名/标准成本/ROP/补货量/安全库存+保存)+ 表 6 列POST /api/inv/products(inv.py:370);空值列显「—」;exportCsv=inv_products;caliber「…ROP=补货点(库存低于此值触发预警)|补货量=单次补货件数|安全库存=最低保有件数。」;空态 hint「过账单据时 SKU 会自动登记;补全 ROP 后库存预警才会生效。」录 ROP 后余额表 low 触发断言生效
AC-EL-INV-047基础资料·仓库表单/表格录入行(代码/名称/类型 select 国内仓·在途仓·平台仓·退货仓+新增仓库)+ 表 4 列(代码·名称·类型·状态)POST /api/inv/warehouses(inv.py:72);kind→中文映射;状态 badge 启用 ok/停用 dim;副标题「国内仓 / 在途仓 / 平台仓」建仓断言列表新增且下拉可选生效
AC-EL-INV-048NoonTab·子 tab×5导航📊 库存总览(默认)/📋 FBN 明细/🏭 直发仓/📦 ASN 入库/⚙️ 库存管理平台隔离:本 tab 只在品牌含 noon 时显示(页面级 003 控制,NoonTab.tsx:2-3 注释);2026-10-04 增强版(预警+明细+仓库+设库存)e2e 逐 sub 断言容器生效
AC-EL-INV-049NoonTab·数据源接口offers+fees 双请求GET /api/noon/offers?limit=200(noon_data.py:119)与 GET /api/noon/fees?fee_type=outbound(noon_data.py:102);失败静默空数组(不显红条);fees 按 sku 建 feeMap 供分类/费率列接口直调对拍行数;断言失败静默生效
AC-EL-INV-050Noon·总览表 10 列表格列Partner SKU·产品·价格·MSRP·FBN 库存·销量·GMV·Buy Box·前台可见·尺寸分类offerCols(NoonTab.tsx:31-44):Partner SKU 带列筛选(AC-EL-CMP-015);产品 title 截 40 字;价格 2 位/MSRP 0 位 null「—」;FBN 库存 <20 danger、<50 warn、其余 ok 且 700 加粗;GMV toLocaleString 0 位;Buy Box「✓ 赢得」ok/「✗ 未赢得」warn;前台可见「在线」ok/「不可见」bad;尺寸分类 feeMap 回退「—」构造库存 19/49/51 行断言三色阈值生效
AC-EL-INV-051Noon·总览 caliber/导出/空态口径「数据源=noon-catalog offer/list API · gmv/units=当前累计 · BuyBox=是否赢得购物车 · FBN 库存=FBN 仓净库存。」;exportCsv="noon_fbn_overview";空态「无数据」/「加载中…」逐字受保护;gmv/units=当前累计(非滚动窗)口径声明文案 diff;导出文件名断言生效
AC-EL-INV-052Noon·FBN 明细表 10 列表格列SKU·长(cm)·宽(cm)·高(cm)·重(kg)·分类·出库费·FBN 库存·库存状态·首次入库尺寸/重量/分类/出库费取 fees 行(feeMap),无费率行显「—」;库存状态 condition=SALEABLE「可售」ok/UNSALEABLE「不可售」bad/其余「—」;首次入库 muted 12px有费率 SKU 断言尺寸四列数值生效
AC-EL-INV-053Noon·直发仓清单表格列4 仓表 5 列(仓库代码·名称·国家·模式·状态)前端硬编码常量(NoonTab.tsx:46-51):W00751249AE Vnlin WH-03 AE active/W00751251SA Vnlin JV85 KSA active/W00805734AE Cititrans AE active/W00778783EG EG inactive;模式 directship_v2;Active ok/Inactive dim;副标题「4 仓 · directship_v2 模式」断言四行逐字段(静态清单逐字核)生效
AC-EL-INV-054Noon·ASN 创建面表单/操作类型 select(SHIPMENT_TYPE_FBN/SHIPMENT_TYPE_FBN_GLOBAL)+仓库 select(SA W00751251SA/AE W00751249AE)+确认执行 checkbox+「创建 ASN」+「刷新」POST /api/noonops/asn/create(noonops.py:304)body {shipment_type,warehouse_code,confirm,reason=UI ASN+ISO 时间戳};默认 dry-run(勾选才真调);刷新=GET asn/shipments(noonops.py:274)+ eligible-items(:283);结果 pre JSON 截 600 字dry-run 断言无 ASN 产生;确认执行断言列表新增生效
AC-EL-INV-055Noon·ASN 列表与可入库 SKU表格列「ASN 列表 ({n})」表 4 列(ASN 号·状态·仓库·类型)+「可入库 SKU ({n})」表 3 列(SKU·品名截 50·仓储类型)状态 badge INBOUNDED ok/CREATED warn/其余 dim;ASN 空态「暂无 ASN(点击「创建 ASN」建首单)」;可入库列表截前 50 行 maxHeight 300 滚动;生命周期脚注「创建(CREATED)→加货项→SEAL→预约时段→SCHEDULED→noon 收货→INBOUNDED(自动 GRN 入台账) · dry-run 默认(勾选确认才真调)」文案 diff;INBOUNDED 断言 ok 色与台账联动生效
AC-EL-INV-056Noon·库存管理(设库存)表单/操作Partner SKU+仓库 select 3 仓+数量+确认执行 checkbox;按钮文案随 confirm 切「⚠️ 设库存」/「🔍 Dry-run 预览」POST /api/noonops/stock/set(noonops.py:123)body {brand,warehouse,sku,qty,confirm,reason=UI 库存管理+ISO};未选品牌报「请先在品牌选择器选定 noon 品牌(库存设置需具体品牌)」;SKU/数量必填;结果 pre JSON 截 500 字;确认成功 toast「库存已设置」;口径脚注「SET 绝对值(非增量) · FBN 库存由 noon 管理(不可设) · 此处仅设直发仓库存 · 全部操作记审计日志」dry-run 断言无变更;确认后 API 复查库存=设定值;audit 留痕生效
AC-EL-INV-057权限/铁律/写面护栏总则口径隔离与写操作边界FBA 域两接口 require_module("inventory")+tenant_conn(brand_scope)(铁律:租户/品牌绝对独立);本页 FBA/预警/明细为只读+导出,无删除面(库存不可误删边界);Noon 写操作(设库存/ASN)dry-run 默认+确认执行+审计(写面护栏同 §11.7 Noon 专页 AC-EL-NOON 系列);台账域(DocsTab)写操作有过账/红冲确认+审计跨租户 brand 断言空集;全部写操作断言审计留痕生效

§11.34 映射表页(/mapping · AC-EL-MAP,47 条 · 2026-10-22 源码实证 web/app/mapping/page.tsx 317 行 + api/routers/collab.py:35-73 + api/routers/ops.py:202-365,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-MAP-001页面标题/面包屑导航AppShell title=产品建档,面包屑「SKU 映射」路由 /mapping(page.tsx:48);本页=sku_mapping 宇宙事实源的读面+写面入口e2e 断言标题与面包屑生效
AC-EL-MAP-002页级错误横幅反馈红色横幅 role="alert"page.tsx:49;只读面 getJson 失败触发;编辑器内错误走 toast 不走横幅e2e mock /api/mapping/skus 500 断言横幅生效
AC-EL-MAP-003Tab 组(单 tab)导航仅一枚「SKU 映射」tabpage.tsx:51-53;2026-09-20 起 SKU 映射+新品建档合并为一个 tab,editMode 切换只读/编辑两形态(page.tsx:25-26);tab 本身不可切换e2e 断言 tab 唯一且无第二 tab生效
AC-EL-MAP-004KPI·平台卡(每平台一枚)KPI标签=平台名(空平台显「未标平台」),值=行数,foot「ASIN x · NSKU y · 成本 z」page.tsx:56-62;by_platform=/api/mapping/skus 聚合(collab.py:50-58):sku_mapping GROUP BY platform,count(asin)/count(nsku)/count(cost_rmb) 非空计数;受 platform/search/brand 当前筛选影响SQL 按同筛选 GROUP BY 复算四值生效
AC-EL-MAP-005KPI·映射总行KPI值=total,foot「当前品牌可见范围」page.tsx:63-68;total=同 where 计数(collab.py:59);「当前品牌可见范围」明示品牌过滤口径(全部品牌时为本租户全量)SQL 复算 total;切品牌断言随 brand_scope 变化生效
AC-EL-MAP-006卡标题(双态)标题「SKU 映射表」副题「SKU ↔ ASIN(Amazon) / NSKU(Noon)」;编辑模式追加「· 编辑模式(单元格点击直接编辑 · 保存=该品牌+平台分支整体替换)」page.tsx:71;副题随 editMode 联动e2e 双形态断言副题切换生效
AC-EL-MAP-007编辑模式切换按钮按钮「✏️ 编辑」↔「↩ 退出编辑」page.tsx:72-74;切换只换前端形态,编辑器进入时另行拉取编辑数据;未保存修改退出无拦截(拦截只在编辑器内目标切换,见 MAP-023)e2e 断言两态文案与形态切换生效
AC-EL-MAP-008平台 Tab筛选「全部平台 / Amazon / Noon」三 tabpage.tsx:75-79;PLATFORMS=["","Amazon","Noon"](page.tsx:20);切换即 setPage(1) 回第一页e2e 切 Amazon 断言请求 platform=Amazon 且页码复位生效
AC-EL-MAP-009搜索框筛选placeholder「搜索 SKU / ASIN / NSKU / 产品名 / 型号」+「搜索」按钮page.tsx:80-84;submit 置 page=1 并生效 query;服务端五路 ILIKE:sku/asin/nsku/product_name/model_number(collab.py:41-46),空值列 coalesce 防 NULL 漏配curl 按型号片段搜索断言命中生效
AC-EL-MAP-010只读表头 10 列表格SKU/产品/品牌/平台/国家/ASIN/NSKU/UPC/成本 ¥/广告活动模式page.tsx:90-93e2e 断言列名与列数生效
AC-EL-MAP-011列·SKU表格等宽字体加粗 SKU 码page.tsx:97;行 key=brand+sku+platform+country(page.tsx:96,与保存行键同口径)e2e 断等宽样式类生效
AC-EL-MAP-012列·产品表格主行产品名(空显「—」)+次行小字「型号 · 颜色 · 尺寸」(按有值拼接)page.tsx:98-101;model_no/color/size 空值过滤后「 · 」连接e2e 断言次行拼接格式生效
AC-EL-MAP-013列·品牌表格品牌色点+品牌名page.tsx:102;brandColor 共享(AC-EL-CMP)e2e 断色点渲染生效
AC-EL-MAP-014列·平台表格徽标:Amazon=绿(ok)、其余=灰(dim)、空=「—」page.tsx:103e2e 断 Amazon 行绿徽 Noon 行灰徽生效
AC-EL-MAP-015列·国家/ASIN/NSKU/UPC表格灰字等宽,空值均显「—」page.tsx:104-107e2e 断空值占位符生效
AC-EL-MAP-016列·成本 ¥表格「¥xx.xx」两位小数;未录显「—」page.tsx:108;cost_rmb 数值列 NULL→「—」(部分补录状态如实展示,见 MAP-022 脚注)SQL 抽 NULL 成本行断言页面显「—」生效
AC-EL-MAP-017列·广告活动模式表格灰字 campaign_pattern,空显「—」page.tsx:109e2e 断列存在生效
AC-EL-MAP-018只读排序口径固定排序:platform, country, skucollab.py:65-66 ORDER BY;无前端排序交互SQL 同序复算首页 20 行比对顺序生效
AC-EL-MAP-019表空态空态居中「无匹配映射」(colSpan=10)page.tsx:112;筛选无命中时渲染e2e 搜不存在串断言空态生效
AC-EL-MAP-020分页器分页「共 N 行 · 第 p / P 页」+「上一页/下一页」(边界禁用)page.tsx:45/115-120;pageSize=20 固定(page.tsx:33),服务端 clamp 1~100(collab.py:42);P=ceil(total/20)e2e 断首页上一页禁用/末页下一页禁用生效
AC-EL-MAP-021只读加载态加载「加载中…」(编辑模式或已有错误时不显示)page.tsx:85-87e2e 断过渡文案生效
AC-EL-MAP-022只读口径脚注口径「数据源:官方映射表(本租户各品牌分支)。成本(人民币采购价)当前部分补录,未录显示 —;补录完整后商品页毛利率列自动生效。」page.tsx:123-126;明示 sku_mapping=官方映射表+成本补录状态+下游联动(商品页毛利率依赖 cost_rmb)e2e 断脚注逐字生效
AC-EL-MAP-023编辑目标选择器筛选左上下拉「品牌 · 平台」,选项=本租户各品牌×其平台分支;有未保存修改时切换弹 confirm「有未保存修改,切换将丢弃,继续?」page.tsx:142-151/275;targets=brands.flatMap——注册表 noon_brands 含该品牌才给 Noon 分支(H9 2026-10-13 单源=注册表 TenantInfo.noon_brands;一租户一公司 2026-10-02 不向他牌租户披露品牌×平台组合);target 越界自动钳回e2e 造 dirty 后切换断言 confirm 文案;无 noon 品牌断言无 Noon 选项生效
AC-EL-MAP-024编辑数据加载数据进入编辑/切目标即拉该分支全量网格page.tsx:153-159;GET /api/mapping/edit?brand&platform(ops.py:202-222):brand/platform 必填否则 400;2026-10-01 像素审计缺陷⑮修——GET 补 allowed_brands 前置校验(与 POST 对称),未登记/跨租户品牌 400「品牌未登记或不属于当前租户: {brand}」不再静默空表;columns=information_schema 全列(除 id)、rows=该分支 ORDER BY sku跨租户 brand 请求断言 400 文案生效
AC-EL-MAP-025编辑器标题标题「新品建档」副题「单元格点击直接编辑 · 保存=该品牌+平台分支整体替换(事务) · 行键 brand+sku+platform+country · 保存自动级联创建产品主数据+库存主数据」page.tsx:273;四要素一句明示(整体替换/行键/级联/交互)e2e 断副题逐字生效
AC-EL-MAP-026+加行按钮新行插入网格首行,brand/platform 预填当前目标,其余列空page.tsx:166-169;加行即 dirtye2e 点加行断言首行出现预填行生效
AC-EL-MAP-027编辑网格表格id=mapping-edit-table 全列可编辑输入框网格;表头吸顶;容器 maxHeight 62vh 内滚page.tsx:292-308;列宽 sku/product_name 130 其余 84;每格 input defaultValue+onChange 写回行状态(setCell,page.tsx:162-165);input key 含 rows.length 使加/删行后重挂载取新默认值e2e 改单元格断 dirty 徽标出现生效
AC-EL-MAP-028行删除按钮行尾红色「删」按钮移除该行page.tsx:306(delRow page.tsx:170);删除即 dirty;实际落库在保存整分支替换时生效e2e 删一行保存后断言只读表无该行生效
AC-EL-MAP-029●未保存徽标与行数反馈dirty 时琥珀徽标「● 未保存」;右侧灰字「N 行」实时计数page.tsx:286-288e2e 任一编辑动作后断言徽标出现生效
AC-EL-MAP-030💾保存到数据库按钮「💾 保存到数据库」(busy 显「保存中…」);未 dirty 或 busy 时 disabledpage.tsx:289;前端预拦:rows>2000 直接 toast「当前 N 行超出单次保存上限 2000 行,请筛选/分批后保存(超出部分服务端会忽略)」不发包(page.tsx:173-177,D批P3-12 2026-09-26)造 2001 行点保存断言预警且无网络请求生效
AC-EL-MAP-031保存成功 toast(双态)反馈正常:「已保存 N 行」;被截断:「已保存 N 行(⚠ 超上限,后 M 行被忽略,请分批保存)」(红)page.tsx:178-186;M=truncated 回传值;成功后 setDirty(false) 并 onSaved 联动刷新只读表(2026-09-21 修——否则退出编辑显示编辑前旧数据,刚保存的行「消失」)e2e 保存新行退出编辑断言只读表含新行生效
AC-EL-MAP-032保存端点·整分支替换口径保存=DELETE 该 brand+platform 分支后逐行 INSERT(整体替换,事务内)POST /api/mapping/edit(ops.py:271-339):①allowed_brands 校验(未登记 400);②schema 动态取列;③DELETE WHERE brand+platform;④body.rows[:2000] 截断并显式回传 truncated(不再静默丢弃);⑤冲突键列(brand/sku/platform/country/account/mode)空值写 '' 非 NULL——NULL 会绕过唯一索引判重且违反 NOT NULL;⑥空 SKU 行跳过(无业务含义且污染映射表);⑦行级品牌指向未登记品牌跳过(RLS 会拒);⑧ON CONFLICT (tenant_id,brand,sku,platform,country) DO NOTHING=行键重复仅留首条造重复行键保存断言库中仅一条;造 2001 行断言 truncated=1生效
AC-EL-MAP-033保存·tenant_id 会话盖章口径归属租户由服务端会话写入,客户端不可指定ops.py:291-293;row 内 tenant_id 列被 t["id"] 强制覆盖(注册表宪法:归属租户不可客户端指定)构造含伪造 tenant_id 的行保存断言库中仍为本租户生效
AC-EL-MAP-034保存·级联创建口径每行 INSERT 后自动级联创建 products+inv_products 主数据(存在即跳过)ops.py:321-333;products(brand,sku,title=product_name,category='',price=0,cost=cost_rmb) 与 inv_products(tenant_id,sku,product_name,standard_cost=cost_rmb or 0) 均 ON CONFLICT DO NOTHING;回传 cascaded_products/cascaded_inv 新建计数;2026-09-19 用户拍板——新 SKU 创建完所有业务流自动创建(铁律:级联自动生成)保存全新 SKU 断言 products/inv_products 各 +1 且重复保存计数为 0生效
AC-EL-MAP-035保存·审计留痕口径每次保存写 audit 事件ops.py:334 mapping.edit.save "{brand}/{platform}: N rows, cascade products=X inv=Y"保存后查 audit 表断言事件与行数生效
AC-EL-MAP-036编辑器口径脚注口径「保存整分支替换并跳过行键冲突(brand+sku+platform+country 重复行仅留首条);改动写入审计日志(mapping.edit.save)。」page.tsx:312-314;与 MAP-032⑤⑧ 服务端行为互证e2e 断脚注逐字生效
AC-EL-MAP-037↺重载按钮「↺ 重载」放弃网格改动重拉当前分支page.tsx:290(load page.tsx:153-159);重载后 dirty 复位e2e 改动后点重载断言改动消失徽标熄灭生效
AC-EL-MAP-038⬇CSV 导出按钮导出 mapping_{brand}_{platform}.csvpage.tsx:191-198;前端本地生成——BOM()+表头+逐行 CSV(含逗号/引号/换行的值加引号转义);同时 POST /api/mapping/edit/export {fmt:csv,rows} 留审计(见 MAP-040)e2e 下载断言文件名与 BOM 首三字节生效
AC-EL-MAP-039⬇Excel 导出按钮导出 mapping_{brand}_{platform}.xls(HTML 表格流派 Excel 文件)page.tsx:199-207;Blob type=application/vnd.ms-excel;charset=utf-8 带 BOM;单元格经 he() 转义 &<> 防 Excel 公式/标签注入;audit fmt=xlse2e 下载断言文件头含 <table 与转义生效生效
AC-EL-MAP-040导出审计端点口径导出文件虽前端生成,导出动作服务端留痕POST /api/mapping/edit/export(ops.py:350-362);UI-09(2026-10-14):SKU 映射含成本等敏感列,导出与保存同权级留审计——fmt 白名单 csv/xls 否则 400、allowed_brands 校验、audit mapping.edit.export "{brand}/{platform}: N rows fmt=x";文件本体不下发导出后查 audit 表断言事件;fmt=pdf 断言 400生效
AC-EL-MAP-041📥导入 xlsx 入口按钮「📥 导入 xlsx」label 包隐藏 file input,accept=.xlsx,.xls,.csvpage.tsx:281-285;选文件即 importXlsx,input 值即时清空可重复选同一文件e2e 连续导入同一路径文件两次断言均触发生效
AC-EL-MAP-042导入·服务端解析口径xlsx/xls 服务端 openpyxl 解析,csv 服务端 DictReader 解析,回 {rows} 字典行集POST /api/mapping/edit/import FormData(ops.py:225-268);2026-09-21 从浏览器 SheetJS(CDN) 挪服务端——部分 WPS 系 xlsx 触发 SheetJS「e.replace is not a function」崩溃且 CDN 脆弱;边界:>10MB 400「文件超限(10MB)」、xlsx 无法解析 400、取首 sheet 表头驱动、日期值格式化为 YYYY-MM-DD、'none' 归空、跳全空行导入 WPS xlsx 样本断言不崩;超限文件断言 400生效
AC-EL-MAP-043导入·空表守卫校验解析结果 0 行 → toast「空表」page.tsx:219e2e 导入只有表头的文件断言提示生效
AC-EL-MAP-044导入·表头守卫校验表头与编辑器已知列零交集 → toast「表头无已知列(需要 {前4列名}/…)」page.tsx:221-223;提示取 cols 前 4 列名e2e 导入无关表断言提示含列名生效
AC-EL-MAP-045导入·分支守卫校验文件 brand/platform 列唯一值与当前目标不符 → toast「文件是 X·Y,请先把左上目标切到该分支再导入(当前 …)」page.tsx:229-238;防串分支(如 fittingirls 文件导进 zipforce 分支);文件两列各自唯一才判定,缺列放行(由预填兜底)e2e 在 zipforce·Amazon 目标导入 fg 文件断言拒绝文案生效
AC-EL-MAP-046导入·合并语义口径导入=按「sku+country」键合并进当前网格(非整网格替换):已有行按列覆盖(文件空值不覆盖),新行插首行;brand/platform 强制当前目标;完成 toast「已合并 N 行:更新 u · 新增 a · 保留其余 r 行(点「保存」落库)」,合并后总数>2000 追加「⚠ 当前共 N 行超单次保存上限 2000,请分批保存」page.tsx:239-266;新行 added.slice().reverse() 前插保持文件行序;id 列不参与覆盖;不自动保存——落库仍走保存按钮(D批P3-12 预警)e2e 导入半空值文件断言已有值不被清空;造超限合并断言 ⚠ 提示生效
AC-EL-MAP-047宇宙事实源定位口径本页=sku_mapping(ASIN/SKU 宇宙事实源)的唯一读写工作台铁律「所有动作基于 mapping table」:读面=/api/mapping/skus(分页只读)+ /api/mapping/edit(分支网格);写面=整分支替换保存(级联创建 products/inv_products);消费方(排名页显示名/家族、商品页毛利率、库存主数据等)均经同一表解析,不另造清单code review 断言各页 SKU 解析均 LATERAL sku_mapping 而非独立清单生效

§11.35 采购页(/po · AC-EL-PO,76 条 · 2026-10-22 源码实证 web/app/po/page.tsx 413 行 + api/routers/inventory_po.py 440 行 + api/routers/po_pdf.py 363 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PO-001页面标题/面包屑导航AppShell title=PO 采购,面包屑「进销存 · 采购单全生命周期(草稿→提交→确认→在途→收货)」路由 /po(page.tsx:176);接口权限 require_module("inventory")(inventory_po.py 全端点);数据经 tenant_conn 租户隔离e2e 登录 inventory 模块账号断言标题与面包屑逐字一致生效
AC-EL-PO-002Suspense 加载壳反馈useSearchParams 依赖深链,页面组件以 Suspense 包裹,fallback 居中「加载中…」page.tsx:38,75;仅深链参数解析期短暂显示e2e 直开 /po?prefill=X 断言不抛 useSearchParams 错生效
AC-EL-PO-003错误横幅反馈接口失败红色横幅 role="alert"(page.tsx:177)getJson 异常 setErr;操作失败复用同横幅;无错误不占位e2e mock 500 断言出现且带 alert 角色生效
AC-EL-PO-004成功信息横幅反馈操作成功蓝色 ok-banner role="status"(page.tsx:178)创建/流转/收货/删除/导入/发邮件成功均 setInfo;仅 createPO 在提交前先清空 err/info(page.tsx:109),transition/delPO/sendMail/submitReceive/addSupplier 均直接覆写不清空e2e 建单成功断言「已创建 PO-…(草稿)」生效
AC-EL-PO-005采购单卡标题容器卡片 h2「采购单」(page.tsx:182)含状态页签+搜索+双按钮+列表+分页;列表数据源 /api/po/liste2e 断言卡片标题文本生效
AC-EL-PO-006卡片口径子说明口径声明sub 文案「收货不回写 FBA 库存快照;在途数量会体现在补货预警「在途(PO)」列」页面级口径边界(page.tsx:182):收货录入不修改库存快照;PO 在途量仅进 /api/inventory/alert 的 po_inbound 列(_ALERT_CTE 已迁 core.py 常量集中,ARC-02 2026-10-14;inventory_po.py:29 仅 import)收货后比对 FBA 快照无变化+预警页 po_inbound 增量生效
AC-EL-PO-007状态页签组筛选7 个页签:全部/草稿/已提交/已确认/在途/已收货/已取消,各带计数(page.tsx:25-27,184-189)STATUSES=["","draft","submitted","confirmed","in_transit","received","cancelled"];切换即重查并回到第 1 页e2e 逐个点击断言列表状态过滤正确生效
AC-EL-PO-008「全部」页签计数计数全部=各状态 count 求和(page.tsx:187)前端 Object.values(summary).reduce(count 求和);与服务端 total 同源应相等对账 summary 各态之和 = 无过滤 total生效
AC-EL-PO-009页签计数数据源口径计数来自 /api/po/list 响应 summary 字段服务端按状态聚合 {count,qty} 两值(inventory_po.py /api/po/list);qty 未在页签展示仅 countSQL 直查各状态 PO 数比对页签数字生效
AC-EL-PO-010搜索框筛选placeholder「搜 PO 号 / 供应商」,宽 200(page.tsx:191-192)输入即触发重查(onChange setStatus 前先回第 1 页);参数 search 服务端 ILIKE 匹配 po_no 与供应商名e2e 输入 PO 号片段断言列表收敛生效
AC-EL-PO-011「+ 新建 PO」按钮操作主按钮打开新建抽屉(page.tsx:193)setCreating(true);抽屉见 AC-EL-PO-037e2e 点击断言抽屉出现生效
AC-EL-PO-012「从补货预警导入」按钮操作secondary 按钮开建单视图并拉预警(page.tsx:194,90-95)/api/inventory/alert?level=urgent&page_size=50 懒加载一次(alertItems null 才拉,失败落空数组不报错)e2e 点击后网络面板断言 alert 请求恰好一次(重复开不重拉)生效
AC-EL-PO-013列表加载占位反馈items 为 null 时「加载中…」(page.tsx:196)与空态区分:null=加载中,[]=「无采购单」e2e 慢网络断言占位先现后表生效
AC-EL-PO-014列表表头表格9 列:PO 号/供应商/状态/目的市场/行数/总量/总成本(RMB)/创建/更新(page.tsx:200)列序固定;行数据来自 /api/po/list itemse2e 断言表头 9 列文本与顺序生效
AC-EL-PO-015PO 号列列sku strong 样式展示 po_no(page.tsx:204)格式 PO-{yymmdd}-{pid:04d}(inventory_po.py /api/po/create,token_hex 占位后回填真 id)建单后断言编号格式正则 ^PO-\d{6}-\d{4}$生效
AC-EL-PO-016供应商列列供应商名,空显「—」(page.tsx:205)PO 未指定供应商(supplier_id null)合法,展示占位符建不指定供应商的 PO 断言显示 —生效
AC-EL-PO-017状态徽章 tone 映射列badge 四色映射(page.tsx:206)received=ok(绿)/cancelled=bad(红)/draft=dim(灰)/submitted·confirmed·in_transit=warn(黄);文本=status_cn 服务端中文名逐状态建 PO 断言四类颜色生效
AC-EL-PO-018目的市场列列muted 展示 dest_market,空显「—」(page.tsx:207)自由文本(建单 placeholder「如 US / AE / EU」),无枚举校验填写任意市场字符串断言原样回显生效
AC-EL-PO-019行数列列item_count(page.tsx:208)服务端聚合该 PO 物料行数;服务端建单时 qty≤0 行被静默跳过,行数按落库行计建 3 行(1 行 qty=0)断言行数=2生效
AC-EL-PO-020总量列列qty_total(page.tsx:209)服务端 sum(qty_ordered);口径=有效行数量和对账单行 qty 之和生效
AC-EL-PO-021总成本列列·金额「¥」+ toLocaleString(page.tsx:210),null 显「—」口径=total_cost_rmb=round(sum(qty×unit_cost_rmb),2) 服务端计算落库(inventory_po.py /api/po/create,unit null 按 0);RMB 计价,无汇率换算;前端千分位本地化不改数值SQL 直算 sum(qty×unit_cost) 与列值相等(分位四舍五入)生效
AC-EL-PO-022创建时间列列created_at.slice(0,10) 即 YYYY-MM-DD(page.tsx:211)服务端 timestamptz 原样返回,前端截日期比对 DB created_at 日期位生效
AC-EL-PO-023更新时间列列updated_at.slice(0,16) 且 T 替换为空格(page.tsx:212)精度到分钟;秒位截断流转状态后断言该列前移生效
AC-EL-PO-024行点击开详情交互行 cursor pointer,onClick 调 /api/po/{id} 开详情抽屉(page.tsx:203,119-122)详情 404「PO 不存在」走错误横幅e2e 点击行断言抽屉打开生效
AC-EL-PO-025列表空态空态colSpan=9 居中「无采购单」(page.tsx:215)仅 items=[] 时显示新租户首访断言空态文案生效
AC-EL-PO-026分页器分页上一页/「x / y」/下一页,仅 pages>1 显示(page.tsx:220-226)固定 20 条/页(请求 page_size=20,page.tsx:66;服务端上限 min(100,…)=20 生效);pages=ceil(total/20)造 21 条 PO 断言分页器出现且翻页正确生效
AC-EL-PO-027列表请求参数口径/api/po/list?status&search&brand&page&page_size=20(page.tsx:66)brand 取自 useBrand() 品牌上下文随请求透传;页签/搜索/翻页/品牌变化即重查(useCallback 依赖)网络面板断言参数完整生效
AC-EL-PO-028品牌过滤铁律口径·铁律带 brand 时服务端以 EXISTS(purchase_order_items pi WHERE pi.po_id=p.id AND pi.brand=brand) 过滤inventory_po.py /api/po/list;跨品牌 PO 绝不互见(铁律:品牌绝对独立);summary/total 同过滤口径双品牌账号切换断言列表互不可见生效
AC-EL-PO-029列表排序口径ORDER BY created_at DESC(inventory_po.py /api/po/list)最新创建在最上;无二次排序键建两单断言新单在前生效
AC-EL-PO-030供应商卡容器卡片 h2「供应商」(page.tsx:229-230)含添加表单+6 列表;数据源 /api/po/suppliers(随主列表 load 一并拉取)e2e 断言卡片渲染生效
AC-EL-PO-031供应商表单表单名称/联系人/邮箱(email 型,placeholder「邮箱(PO 确认后自动发 PDF)」)/电话 +「+ 添加」(page.tsx:232-236)仅名称必填(trim 非空,page.tsx:160);其余可空空名称点添加断言无请求生效
AC-EL-PO-032添加供应商写操作POST /api/po/suppliers,成功清空表单并刷新(page.tsx:159-163)重名返回 409「供应商已存在」走错误横幅;护栏=名称去重,无需确认弹窗(低风险可改项)重复添加同名断言 409 横幅生效
AC-EL-PO-033供应商表列表格6 列:名称/联系人/电话/邮箱/未完成 PO/操作(page.tsx:240)空字段统一「—」;行键 s.ide2e 断言表头 6 列生效
AC-EL-PO-034「未完成 PO」列列·计数open_pos 数值(page.tsx:248)服务端=该供应商名下未取消 PO 计数(inventory_po.py /api/po/suppliers GET);口径含全部非 cancelled 态为供应商建 2 单(1 已取消)断言显示 1生效
AC-EL-PO-035删除供应商写操作红字「删除」按钮 + danger 确认「被未取消 PO 引用时会被拒绝。」(page.tsx:164-168,249)DELETE /api/po/suppliers/{id};服务端护栏=存在未取消 PO 返回 409「供应商仍有未取消 PO, 不能删除」(tenant_id 域内)引用中删除断言 409 横幅;取消全部 PO 后删除成功生效
AC-EL-PO-036供应商空态与静默失败空态「暂无供应商」colSpan=5(page.tsx:252);列表加载失败静默 catch(()=>{})(:70)供应商面失败不打错误横幅(不阻塞主列表);空态含=0 与失败两种情形mock suppliers 500 断言页面无横幅且表空生效
AC-EL-PO-037新建抽屉容器抽屉drawer-mask + drawer 宽 760(page.tsx:261-262)点遮罩关闭;点内容区 stopPropagation;标题「新建采购单(保存为草稿)」e2e 断言抽屉宽 760 与遮罩关闭行为生效
AC-EL-PO-038新建表单三字段表单供应商下拉(首项「(不指定)」→null)/目的市场(placeholder「如 US / AE / EU」)/备注(page.tsx:264-273)供应商选项来自本租户供应商表;三字段均可空不选供应商保存断言成功且列表显 —生效
AC-EL-PO-039补货预警块容器建单抽屉内嵌块,标题「补货预警(urgent)· 勾选导入,数量=90 天缺口」(page.tsx:275-277)alertItems 非 null 才渲染(openAlertImport 或预填流程触发加载);表体 maxHeight 200 滚动e2e 开导入断言块出现与 200px 滚动生效
AC-EL-PO-040预警表列表格7 列:勾选/品牌/SKU/市场/可售/缺口/在途PO(page.tsx:280)数据源 /api/inventory/alert urgent 级前 50 条;可售=good,缺口=shortage,在途PO=po_inbound(_ALERT_CTE)与 /inventory 页 urgent 行对账一致生效
AC-EL-PO-041缺口列样式列红字加粗 var(--danger)(page.tsx:287)shortage=max(0, 90 天线−可售)(inventory_po.py _ALERT_CTE:need=ceil(日均×90))断言缺口>0 行红色加粗生效
AC-EL-PO-042预警勾选框交互行首 checkbox,状态存 Set<index>(page.tsx:284-285)勾选仅本地态;跨筛选不保留(关闭抽屉不重置 checked,重开保留——已知轻量实现)e2e 勾选两行断言按钮计数=2生效
AC-EL-PO-043「导入选中(N)」按钮操作按钮文案实时反映勾选数,无勾选禁用(page.tsx:294-296)disabled=!checked.size;导入后清空勾选并 setInfoe2e 无勾选断言 disabled生效
AC-EL-PO-044导入行为口径口径勾选行追加为物料行:qty=max(1,shortage),带入 brand/sku/asin/marketplace(page.tsx:96-106)提示文案「已导入 N 条缺货 SKU(数量=90 天缺口,可修改)」;shortage=0 时数量=1;重复 SKU 不去重(直接追加)导入 shortage=7 行断言物料行 qty=7生效
AC-EL-PO-045预警空态空态「当前无 urgent 预警」colSpan=7(page.tsx:290)alertItems=[] 时显示;与未加载(块隐藏)区分无 urgent 租户断言文案生效
AC-EL-PO-046物料行表列表格7 列:品牌/SKU/ASIN/市场/数量/单价(RMB)/删(page.tsx:303)全部行内编辑(input);空表也可先加行e2e 断言 7 列表头生效
AC-EL-PO-047数量输入输入number 型 min=1(page.tsx:311)onChange Number(e.target.value) 非数值落 0;保存时 qty≤0 行被客户端过滤(:111)+服务端跳过(双护栏)清空数量保存断言该行不落库生效
AC-EL-PO-048单价输入输入·金额number 型 min=0 step=0.01,空串=null(page.tsx:312)unit_cost_rmb null 语义=未定价;服务端 null→0 计总额(AC-EL-PO-021 口径);RMB 计价留空保存断言总成本按 0 计生效
AC-EL-PO-049删行按钮操作行内「删」按钮移除该物料行(page.tsx:313)仅本地态,无确认弹窗;保存前不落库e2e 删行断言行数减一生效
AC-EL-PO-050「+ 加一行」按钮操作追加 emptyItem(qty=1,unit null,其余空)(page.tsx:35,319-320)新行默认数量 1e2e 连点两次断言两行 qty=1生效
AC-EL-PO-051取消/保存草稿按钮操作底部 toolbar 右对齐:取消关抽屉 / 保存草稿提交(page.tsx:321-324)取消不落库不确认;保存走 createPOe2e 取消后刷新断言无新 PO生效
AC-EL-PO-052保存草稿客户端校验校验有效行=brand+sku 非空且 qty>0,至少一行否则报「至少一行有效的品牌+SKU+数量」(page.tsx:111-112)无效行静默剔除后提交(items2)全空行保存断言错误横幅生效
AC-EL-PO-053create 服务端口径写操作POST /api/po/create(inventory_po.py)po_no=PO-{yymmdd}-{pid:04d};qty≤0 行跳过;unit null→0;total=round(sum,2);初始 status=draft;审计事件 po.create(操作者+内容留痕)建单后查 audit_events 断言 po.create 行存在生效
AC-EL-PO-054创建成功反馈反馈「已创建 {po_no}(草稿)」+关抽屉+重置表单+刷新(page.tsx:113-115)po_no 服务端返回回显e2e 断言横幅含完整 PO 号生效
AC-EL-PO-055prefill 深链交互/po?prefill=<sku> 自动开建单并预填该 SKU(page.tsx:74-88)查 /api/products?search=<sku>&page_size=5,取 sku 全等匹配(大小写不敏感)否则取首项;已在物料行则不重复加;qty=1e2e 带合法 SKU 深链断言行预填生效
AC-EL-PO-056详情抽屉容器抽屉drawer 宽 720,遮罩点击关闭(page.tsx:330-332)openDetail 成功才渲染;404 走错误横幅e2e 断言宽 720生效
AC-EL-PO-057详情标题标题「{po_no} · {status_cn}」(page.tsx:333)GET /api/po/{pid} 返回单头+itemse2e 断言标题两段拼接生效
AC-EL-PO-058流程条 flowbar可视化5 步:草稿→已提交→已确认→在途→已收货,done/cur 两态(page.tsx:28,334-342)当前态之前的步骤=done;cancelled 不在主流,追加灰底「已取消」cur 徽章(:341)各状态开详情断言高亮位生效
AC-EL-PO-059详情 meta 行信息「供应商 X · 目的市场 Y · 创建 Z · 备注 W」(page.tsx:343-345)空字段显「—」;备注仅在非空时追加;创建时间到分钟e2e 断言四段拼接与空值占位生效
AC-EL-PO-060详情物料表表格6 列:品牌/SKU/市场/订量/单价(RMB)/已收(page.tsx:349)已收=qty_received 累计值;单价「¥」前缀 null 显「—」部分收货后断言已收列更新生效
AC-EL-PO-061状态流转按钮组操作NEXT 映射(page.tsx:29-34):draft=[提交审批];submitted=[确认订单,驳回,取消];confirmed=[标记在途,取消];in_transit=[收货];received/cancelled 无按当前态渲染下一跳按钮;驳回=回 draft(逆向边)逐状态开详情断言按钮集合生效
AC-EL-PO-062流转确认弹窗护栏useConfirm「确认{动作}该 PO?」(page.tsx:123-131)动作中文映射 提交/确认/驳回/标记在途/收货/取消;确认才 POST /api/po/{id}/statuse2e 点流转断言确认框文案生效
AC-EL-PO-063服务端状态机口径·护栏PO_FLOW 服务端镜像校验(inventory_po.py /api/po/{pid}/status)非法流转 400(错误文案含中文状态名);合法流转写库+审计 po.status;前后端两份映射必须一致(代码与条目不一致=缺陷)curl 直发非法流转断言 400生效
AC-EL-PO-064确认触发钩子联动流转到 confirmed 时服务端经 hooks.fire_po_confirmed 触发 ARC-02 钩子(inventory_po.py)钩子=po_pdf.generate_and_maybe_mail(po_pdf.py:319-331 注册):生成盖章 PDF+尝试发供应商邮件,best-effort 任何异常吞掉不阻断确认事务确认带邮箱 PO 后断言 pdf_path 回写+mail_status 变化生效
AC-EL-PO-065「收货录入」入口操作仅 in_transit 态显示(page.tsx:366-368)开收货抽屉(AC-EL-PO-072);与「收货」流转按钮并存(后者直接转 received 不录明细)confirmed 态断言无此按钮生效
AC-EL-PO-066删除按钮写操作仅 draft/cancelled 态显示,红字(page.tsx:369-371)danger 确认「删除该 PO?」body「仅草稿/已取消状态可删除。」confirmed 态断言无删除按钮生效
AC-EL-PO-067服务端删除约束护栏DELETE /api/po/{pid} 仅 draft/cancelled 可删(inventory_po.py)其余状态 400;删除审计 po.delete;物料行随删(不可误删护栏:非草稿物理不可删)curl 删 confirmed PO 断言 400生效
AC-EL-PO-068「✉ 发邮件」按钮操作status≠draft 显示;mailBusy 期间禁用文案「发送中…」(page.tsx:373-377)源码注 2026-09-17 修:sendMail 原是死代码无按钮,补按钮+防重复;POST /api/po/{id}/mail连点发送断言仅一请求生效
AC-EL-PO-069无邮箱补录 prompt交互供应商未维护邮箱时 window.prompt 输入收件邮箱(page.tsx:132-135)取消(null)则中止不发;输入空串等同 skipped 由服务端判定e2e 无邮箱 PO 点发送断言 prompt 出现生效
AC-EL-PO-070mail 结果三分支反馈反馈sent→「邮件已发送」;skipped→「未发送:{reason}」;failed→「发送失败:{reason}」(page.tsx:138-139)响应字段 mail_status+reason;发送后刷新列表并在详情开着时重开详情三场景各断言横幅文案生效
AC-EL-PO-071send_mail 服务端口径口径收件人优先级 body.to > 供应商 email(po_pdf.py:282-316)无收件人→mail_status=skipped「供应商未维护邮箱」;SMTP 未配→skipped「SMTP 未配置」;成功→sent+mailed_at 落库;失败→failed:{原因[:120]} 落 mail_status;审计 po.mail(po_pdf.py:358-363)四场景各查 purchase_orders.mail_status 值生效
AC-EL-PO-072PDF 端点文件GET /api/po/{pid}/pdf 惰性生成返回 FileResponse;POST 同路径强制重生成(po_pdf.py:338-355)文件不存在时生成并回写 pdf_path;po_no 非法(非 [A-Za-z0-9_-]+)400;审计 po.pdf / po.pdf.regen;PDF 含盖章水印与公司脚注(po_pdf.py:240-243)GET 断言 content-type=application/pdf 与文件名={po_no}.pdf生效
AC-EL-PO-073收货抽屉容器抽屉drawer 宽 560,标题「收货录入 · {po_no}」(page.tsx:384-388)说明文案「逐行填本次实收数量;全部收齐后 PO 自动转为「已收货」」e2e 断言宽 560 与标题生效
AC-EL-PO-074收货表列与 clamp表格·输入4 列:SKU/订量/已收/本次收货(page.tsx:391)本次收货 number min=0 max=qty,onChange clamp 到 [0, 订量](:396-397);初值=已收累计(增量编辑模型)输入超订量断言自动截到订量生效
AC-EL-PO-075receive 服务端口径写操作POST /api/po/{pid}/receive(inventory_po.py)仅 confirmed/in_transit 可收否则 400;qty_received=least(本次值, qty_ordered);正增量写 recv_items 收货流水;全部行满足 qty_received≥qty_ordered→received 否则停留 in_transit;审计 po.receive;成功后 best-effort auto_grn_for_po_receive 自动 GRN(失败不影响收货)部分收货断言状态仍 in_transit+流水行存在生效
AC-EL-PO-076收货结果反馈反馈received→「全部收货完成,PO 已完结」;否则「部分收货,PO 保持在途」(page.tsx:149-157)依据响应 status 字段二分;关双抽屉并刷新列表e2e 两路径各断言文案生效

§11.36 项目页(/projects · AC-EL-PRJ,64 条 · 2026-10-22 源码实证 web/app/projects/page.tsx 709 行 + api/routers/projects.py 333 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PRJ-001页面标题/面包屑导航AppShell title=项目,面包屑「产品研发甘特图 · 8 阶段 × 任务 · 基线偏差」(page.tsx:314)路由 /projects;接口权限 require_module("collab")(projects.py 全端点);数据经 RLS 租户隔离(页面脚注声明,page.tsx:474)e2e 登录 collab 模块账号断言标题与面包屑生效
AC-EL-PRJ-002错误横幅反馈红色横幅 role="alert"(page.tsx:315)产品列表/详情拉取失败 setErre2e mock 500 断言横幅生效
AC-EL-PRJ-003产品下拉选择器导航选项「{name}({task_count} 任务)」(page.tsx:319-323)GET /api/pm/products(page.tsx:67);切换触发详情加载;metas 空时下拉为空e2e 断言选项格式含任务数生效
AC-EL-PRJ-004产品列表排序口径口径ORDER BY start_date, created_at, id(projects.py:104-105)下拉顺序=启动日期升序,同日按创建先后;首项自动选中(page.tsx:68)建三个不同启动日期产品断言下拉顺序生效
AC-EL-PRJ-005「+ 新建产品」按钮操作开产品弹窗 new 模式(page.tsx:324)恒可用(无产品也可建)e2e 断言弹窗标题「新建产品项目」生效
AC-EL-PRJ-006「编辑产品」按钮操作仅 prod 已加载时显示(page.tsx:325)开产品弹窗 edit 模式,key=当前产品 id无产品断言按钮不渲染生效
AC-EL-PRJ-007「+ 新任务」按钮操作disabled=!prod(page.tsx:326)开任务弹窗 new 模式(追加到任务列表末尾)未选中产品断言禁用生效
AC-EL-PRJ-008「⛓ 一键串链」按钮操作仅 tasks.length>1 显示,title「按任务顺序连成 完成→开始 依赖链」(page.tsx:327-329)chainBusy 期间禁用;POST /api/pm/products/{pid}/chain {enabled:true}(page.tsx:99)单任务产品断言按钮不渲染生效
AC-EL-PRJ-009「拆链(N)」按钮操作仅 stats.chained>0 显示,N=有依赖任务数(page.tsx:330-332)POST chain {enabled:false};toast「已拆链」串链后断言按钮出现且计数正确生效
AC-EL-PRJ-010串链服务端语义口径按 seq 顺序将任务连成 完成→开始 单链(projects.py:262-277)enabled=true:每任务 depends_on=前一任务(首任务无依赖),返回 chained=len-1;enabled=false:全部依赖清空返回 0;审计事件 pm.chain;产品不存在 404串链后断言首任务无依赖+其余各一依赖生效
AC-EL-PRJ-011「⬇ 导出」按钮操作disabled=!metas.length(page.tsx:334)GET /api/pm/export 全量 products+tasks(projects.py:279-283);前端存 blob 下载,文件名 pm-gantt-{YYYY-MM-DD}.json(page.tsx:294);失败 toast「导出失败」导出断言文件名与 JSON 结构含 products 数组生效
AC-EL-PRJ-012「⬆ 导入」按钮操作触发隐藏 file input,accept=".json,application/json"(page.tsx:335-336)读文本 JSON.parse;失败 toast「导入失败:…」;成功后刷新 metas 并选首项(page.tsx:299-311)选非 JSON 文件断言 toast 错误生效
AC-EL-PRJ-013导入=全量替换口径·护栏POST /api/pm/import(projects.py:285-333)先 DELETE FROM pm_products 级联清全部任务再插入(同租户内);toast「已导入 N 个产品 · M 个任务(全量替换)」;页面提示「可先导出备份」(page.tsx:474);审计 pm.import;护栏=无有效产品 400「无有效产品可导入」导入 1 产品后断言原产品全部消失生效
AC-EL-PRJ-014导入字段映射与容错口径兼容 camelCase/snake_case 双写法(projects.py:294-316)产品需 name+合法 startDate 否则整产品跳过;任务 phase 非法或日期非法静默跳过该任务;end<start 时 end=start;status 非法回 pending;任务 id 统一换新 id,depends_on 经旧→新映射重指,指不到即断链;title 截 200 / owner 截 60 / name 截 120构造混合非法字段文件导入断言容错行为生效
AC-EL-PRJ-015缩放控件交互「-」「{dayW}px」「+」三件(page.tsx:337-341)步进 6px,clamp [18,72](:338,340);dayW 影响日格宽/条宽/拖拽吸附粒度连点放大断言到 72 后不再增生效
AC-EL-PRJ-016阶段筛选 chips筛选8 个 chipbtn:P1 选品调研→P8 上架运营,各带色点(page.tsx:17-26,344-349)颜色常量 PHASES(与服务端 PM_PHASES 一致);至少保留 1 个选中(:121 全取消被拒)点击取消 7 个断言最后 1 个不可取消生效
AC-EL-PRJ-017负责人 chips筛选当前产品去重 owner 排序后渲染(page.tsx:81,351-353)ownerSel null=全选默认;至少保留 1 个(:125)断言 chips 集合=任务 owner 去重集生效
AC-EL-PRJ-018搜索框筛选placeholder「搜索任务 / 负责人 / 备注」,宽 180(page.tsx:354-355)对 title/owner/notes 三字段 toLowerCase 包含匹配(page.tsx:127-130);即时过滤(vis 数组)不重新请求输入关键词断言行数收敛生效
AC-EL-PRJ-019vis 过滤口径口径vis=阶段∩负责人∩搜索 三条件交集(page.tsx:128-130)甘特图行/箭头/统计的「任务 N/M」均按 vis;底部统计 stats 按全量 tasks(不含筛选)——两口径并存需区分筛选 1 阶段断言标签列计数变化而统计条总数不变生效
AC-EL-PRJ-020统计条容器信息pm-stat 行:产品名/总任务/已完成(pct)/进行中/延误/依赖(page.tsx:357-370)仅 prod 加载后显示;数字来自 useMemo stats(全量 tasks)e2e 断言六段文本生效
AC-EL-PRJ-021完成率 pct口径round(done/total×100),total=0 时 0%(page.tsx:148)done=status=done 任务数;进度条 width 同值(:369)对账 tasks 表 done 占比生效
AC-EL-PRJ-022延误口径口径delayed=ddays(baseline_end, end_date)>0 计数(page.tsx:143)即当前结束晚于基线结束的任务数;ddays=UTC 日差四舍五入(:40)改期任务跨过基线断言计数+1生效
AC-EL-PRJ-023依赖冲突口径口径conflicts=后继 start_date≤前置 end_date 的依赖边数(page.tsx:135-137)显示「依赖 N · 冲突 M」仅当 chained>0;有冲突红字无冲突 muted(:364-367);title 提示定义「后继任务早于前置任务结束即冲突」构造重叠依赖断言冲突数生效
AC-EL-PRJ-024进度条可视化pm-progress 条 width={pct}%,title「完成率 {pct}%」(page.tsx:369)纯前端派生无接口断言 width 与 pct 一致生效
AC-EL-PRJ-025空态卡空态metas.length=0 时居中卡「还没有产品项目。新建后将按 8 阶段模板生成 48 个任务(选品调研 → 上架运营)。」+「+ 新建第一个产品」(page.tsx:374-379)仅零产品时显示;48=标准模板 8×6新租户断言空态文案与按钮生效
AC-EL-PRJ-026加载占位卡空态有产品但 prod 未回时「加载甘特图…」(page.tsx:465-469)与零产品空态互斥慢网络断言占位出现生效
AC-EL-PRJ-027甘特图容器容器pm-gantt 双栏:左标签列+右滚动时间轴,CSS 变量 --day-w(page.tsx:382)左右通过 onScroll 同步 scrollTop(:216-219);滚动时清 tooltip滚动右侧断言左侧跟随生效
AC-EL-PRJ-028标签列头信息「任务 · {vis.length}/{tasks.length}」(page.tsx:384)分母=全量分子=过滤后筛选断言分子变化生效
AC-EL-PRJ-029任务标签行行状态按钮+阶段色块+标题+负责人四件(page.tsx:385-397)done 任务行 is-done 置灰;title 属性=完整任务名;双击行开编辑弹窗(:387)e2e 断言行结构与双击行为生效
AC-EL-PRJ-030状态切换按钮操作圆形按钮点击循环 pending→doing→done→pending(page.tsx:106-116,388-392)title「{中文态}(点击切换)」;done 显 ✓;PUT /api/pm/tasks/{id} 全字段回传仅改 status;成功 toast 已完成/进行中/回到待办;双击不触发(stopPropagation)e2e 三连击断言状态循环生效
AC-EL-PRJ-031无匹配任务行空态标签列「无匹配任务」+ 甘特区「无匹配任务 · 调整上方筛选或搜索词」(page.tsx:398,459)vis=0 时两处同时显示过滤至空断言双空态生效
AC-EL-PRJ-032月行时间轴格式 {yy}/{m},span=该月覆盖天数(page.tsx:181-199,402-404)UTC 月界切分;与日格对齐(gridColumn span)跨月项目断言月分段数生效
AC-EL-PRJ-033日格时间轴每格一日:wk 周末底色/first 月首加粗/today 高亮;dayW≥30 才显日期数字(page.tsx:405-409)totalDays 决定横向 grid 列数;缩到 30px 以下数字隐藏仅留底纹缩放到 24px 断言数字消失生效
AC-EL-PRJ-034时间范围口径口径range=min/max 所有任务 baseline 与当前四组日期,各外扩 3 天(page.tsx:150-158)空任务时锚今日+90 天;仅随 prod 变化重算断言首日=最早任务−3 天生效
AC-EL-PRJ-035今日线可视化pm-today 竖线 left=todayPx(page.tsx:201-203,412)仅今日落在范围内才渲染拖动系统日期到范围外断言消失生效
AC-EL-PRJ-036初始滚动定位交互产品切换时滚到今日线附近(page.tsx:208-214)scrollLeft=max(0, 今日偏移−min(clientWidth×0.4, 520));仅 prod.id 变化触发切产品断言滚动位置含今日线生效
AC-EL-PRJ-037周网格背景可视化repeating-linear-gradient 每 7×dayW 画分隔线(page.tsx:204-206)backgroundPositionX 按范围首日星期偏移(周一为界)对齐断言分隔线落在周界生效
AC-EL-PRJ-038依赖箭头 SVG可视化完成→开始连线:前置条右缘→水平→垂直→后继条左缘(page.tsx:160-179,413-427)仅 vis 内两端均可见才画;箭头 marker 灰色 pm-ar;行高 24px 定位;宽=totalDays×dayW 高=vis.length×24串链后断言 path 数=依赖边数生效
AC-EL-PRJ-039冲突箭头红可视化bad 边(后继 start≤前置 end)用红色 marker pm-ar-bad+bad 类(page.tsx:175,419-424)与统计条冲突计数同口径(AC-EL-PRJ-023)构造冲突断言红色 path生效
AC-EL-PRJ-040基线条可视化pm-bar base 灰条,left/width 按 baseline_start/baseline_end(page.tsx:433-434,444)width=max(基线长, 4px) 下限防消失改期后断言灰条不动彩条动生效
AC-EL-PRJ-041当前计划条可视化pm-bar cur 彩条按 start/end,色=阶段色(page.tsx:435-448)延误时条体改 warn/over 类不用阶段色;宽下限 4px;行 zebra 隔行底色断言颜色与阶段一致生效
AC-EL-PRJ-042延误着色阈值口径delay>0:delay>期长×20%=over(红)/否则 warn(黄)(page.tsx:430-432)delay=ddays(baseline_end,end_date);期长=当前工期+1 天;脚注声明「黄=轻微延误 <20% 期长,红=严重延误」(page.tsx:472-473)构造 25% 延误断言红条生效
AC-EL-PRJ-043条内标题可视化条宽>70px 才显示,done 前缀 ✓(page.tsx:447)窄条隐藏文字防溢出缩放到条宽<70 断言文字消失生效
AC-EL-PRJ-044拖拽改期交互交互仅鼠标左键;条体=整体平移,左右 8px 边缘=缩放起/止(page.tsx:236-272)位移 <4px 不触发(防误触);触摸留给滚动不拖拽;拖拽中禁 tooltip条左缘 5px 处按下拖动断言仅改起始生效
AC-EL-PRJ-045拖拽按日吸附口径dx=round(像素位移/dayW) 天(page.tsx:250)连续量转离散天;拖拽预览 dLeft/dWidth 即时跟随慢拖 0.5 日格断言无半日状态生效
AC-EL-PRJ-046拖拽提示浮层反馈显示新起止(M/D 格式)+「(±N 天)」(page.tsx:449-455)仅 dx≠0 显示;mode=r 固定显示原起始,mode=l 固定显示原结束拖动断言浮层数字随动生效
AC-EL-PRJ-047松手提交条件护栏engaged 且 dx≠0 才提交;ne<ns 或无变化放弃(page.tsx:253-260)PUT 全字段回传仅改日期;成功 toast「「{title}」顺延/提前 N 天」;失败 toast 改期失败拖成交叠(r 边拖过 s)松手断言无请求生效
AC-EL-PRJ-048悬浮提示卡反馈hover/点击彩条显示 pm-tip:标题/阶段·负责人·状态/基线区间/当前区间/启动完成偏差天数/备注(page.tsx:221-233,478-488)定位防溢出(右缘 320px 内、底部翻转向上);偏差带 +/− 号;尾行提示「双击行编辑 · 改期自动记历史」hover 断言七行内容与 DB 一致生效
AC-EL-PRJ-049底部口径说明口径声明灰字说明灰条=基线/彩条=当前/黄红延误定义/双击编辑/改期记历史/导入全量替换/RLS 租户隔离(page.tsx:471-475)页面级口径汇总,与各条目一致(不一致=缺陷)逐句与对应条目比对生效
AC-EL-PRJ-050toast反馈pm-toast 2.8 秒自动消失(page.tsx:57,64,515)所有操作反馈共用;无错误横幅则仅 toast断言 2.8s 后消失生效
AC-EL-PRJ-051任务弹窗容器弹窗pm-ov 遮罩+pm-modal,标题「新任务/编辑任务」二态(page.tsx:490-499,562-566)ESC 关闭(:536-540);遮罩自点击关闭;sub 说明编辑模式会记历史e2e ESC 断言关闭生效
AC-EL-PRJ-052任务表单字段表单任务名称 maxLength200/阶段 select 8 项/负责人 input+datalist/状态 select 三态/前置任务 select/起止 date 双件/备注 textarea maxLength500(page.tsx:567-601)负责人 datalist=现有 owners∪{Patrick,Susan,未分配}(:586-588);新任务默认 p1/未分配/pending/今日起 5 天(:526-532)打开新任务弹窗断言默认值生效
AC-EL-PRJ-053前置任务下拉表单选项=同产品其余任务,带起止日期展示(page.tsx:589-596)排除自身防自依赖;服务端另有环校验(AC-EL-PRJ-062)双护栏编辑任务断言列表无自身生效
AC-EL-PRJ-054任务保存校验校验名称必填+结束≥开始(page.tsx:542-544);服务端同校验 400(projects.py:193-194,227-228)新建 POST /api/pm/products/{pid}/tasks;编辑 PUT /api/pm/tasks/{id};phase/status 枚举非法服务端 400交叠日期保存断言错误提示生效
AC-EL-PRJ-055改期历史块信息「改期历史(N 次)」倒序列表:旧区间→新区间+时间(page.tsx:602-612)数据=history JSON 数组;仅编辑弹窗内展示拖拽改期两次后开弹窗断言两行倒序生效
AC-EL-PRJ-056history 服务端口径口径日期变化即 append {fs,fe,ts,te,time:UTC ISO}(projects.py:236-239)仅 start/end 变化才记(改状态/负责人不记);time 到毫秒;只增不删改状态断言 history 不增长生效
AC-EL-PRJ-057删除任务写操作danger 确认「删除任务「{title}」?」(page.tsx:555-560)DELETE /api/pm/tasks/{id};服务端不存在 404;审计 pm.task.delete;删除后依赖该任务的后继断链(depends_on 悬空由前端容忍)删除被依赖任务断言后继箭头消失生效
AC-EL-PRJ-058产品弹窗容器弹窗pm-modal 标题「新建产品项目/编辑产品」二态(page.tsx:500-514,671-675)ESC+遮罩关闭;edit 模式 key=产品 id 保证表单重置切换模式断言表单值刷新生效
AC-EL-PRJ-059新建产品表单表单产品名称 maxLength120(placeholder「如:X3 按摩仪」)/启动日期 date/阶段数 select 1-8/每阶段任务 select 1-6/阶段间隔 number 0-60(page.tsx:677-694)间隔输入 clamp [0,60](:692);名称必填(:648);POST /api/pm/products(phases_count/tasks_per_phase/phase_gap)边界值 1×1 间隔 0 建产品断言 1 任务生效
AC-EL-PRJ-060任务数预告反馈「将生成 N 个任务(标准模板 8 × 6 = 48,选品调研 → 上架运营)」(page.tsx:696-698)N=phasesN×tasksN 实时联动;创建成功 toast 补「(标准模板)」当恰 48(:509)改阶段数断言预告数字联动生效
AC-EL-PRJ-061模板生成算法口径任务=PM_PHASES 前 N 阶段×每阶段前 M 个模板任务(projects.py:35-52,133-142)每任务 e=s+(dur−1);baseline=首次生成日期;阶段间 offset+=phase_gap 天顺延;模板 48 任务各带固定标题/工期/负责人(Patrick/Susan);审计 pm.product.create标准模板断言 48 任务+起止连续+负责人符合模板生效
AC-EL-PRJ-062依赖合法性校验护栏_pm_dep_ok:同产品存在/非自身/沿链 ≤100 跳无环(projects.py:85-101)违规 400「前置任务非法(不存在/自身/成环)」;创建与更新均校验构造 A→B→A 环断言 400生效
AC-EL-PRJ-063编辑产品口径口径仅改名称+启动日期,不重排已有任务(page.tsx:675,658;projects.py:165-174)PUT 复用 PmProductIn(未传 phases 参数取默认 8/6/15 但更新 SQL 不使用);toast 明示「任务日期未联动,如需重排请编辑任务」;审计 pm.product.update改启动日期断言任务日期不动生效
AC-EL-PRJ-064删除产品写操作danger 确认「删除产品「{name}」?」body「其全部任务将一并删除。」(page.tsx:664-669)DELETE /api/pm/products/{pid} 级联删任务;审计 pm.product.delete 附「(级联删任务)」;删除后回产品列表自动选首项;护栏=确认弹窗+级联范围明示(不可误删铁律:删除范围对用户可见)删含任务产品断言任务全清生效

§11.37 站外促销页(/offsitepromotion · AC-EL-OFF,65 条 · 2026-10-22 源码实证 web/app/offsitepromotion/page.tsx 389 行 + 11 子组件(面板级)+ api/routers/ads.py /api/promotion/* 族,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFF-001页面标题导航AppShell title=推广(page.tsx:92)路由 /offsitepromotion;接口权限 require_module("ads")(ads.py 全 /api/promotion/* 端点);数据经 tenant_conn 租户隔离e2e 登录 ads 模块账号断言标题生效
AC-EL-OFF-002错误横幅反馈红色横幅 role="alert"(page.tsx:93)仅渠道库列表请求失败 setErr;摘要失败静默(:70)e2e mock channels 500 断言横幅生效
AC-EL-OFF-003顶级页签组导航8 页签:总览看板/达人库/Reddit 专库/邮件模板/邮件外联/收件工作台/邮箱设置/项目·任务·资源;默认总览看板(page.tsx:52,95-104)单选切换;信息架构 2026-10-11 定稿(:51 注释)e2e 断言 8 页签文本与默认选中生效
AC-EL-OFF-004子面板委派容器前 7 页签各委派一个子组件:OverviewTab/LibraryTab/RedditTab/TemplatesTab/SegmentsTab+SendTasksTab(外联=两件同屏)/InboxTab/MailboxesTab(page.tsx:106-118)委派关系为页面唯一结构;子组件文件均在 web/app/offsitepromotion/ 下逐 tab 切换断言对应组件渲染生效
AC-EL-OFF-005work 页签组导航「项目·任务·资源」页签内二级 6 页签:渠道库/采集监控/✅任务/📣KOL/🚀推广项目/🌐全部资源;默认渠道库(page.tsx:53,152-159)二级状态独立于顶级 tab;KPI 区恒显示于二级页签上方e2e 断言 6 页签与默认选中生效
AC-EL-OFF-006KPI·渠道总数KPI 卡数值+foot「去重后(同名合并)」(page.tsx:122-127)源 /api/promotion/summary kpi.total=count(*)(ads.py:370-373);同名去重发生在入库层非查询层SQL count(*) 与卡片数字对账生效
AC-EL-OFF-007KPI·含联系方式KPI 卡数值+foot「N% 可直接触达」(page.tsx:128-132)with_contact=count(contact);百分比=round(with_contact/total×100),total=0 时 0%对账 contact 非空占比生效
AC-EL-OFF-008KPI·待联系/待投稿KPI 卡双数值斜杠分隔+foot「养号中 N」(page.tsx:133-139)by_status 数组按 status 字符串查找;status 为空者服务端归「未标注」不参与这三项对账 by_status 各态计数生效
AC-EL-OFF-009KPI·近 7 日采集KPI 卡发现数+foot「发现 · 入库 N · 联系方式 M」(page.tsx:140-144)crawl7=前端对 sum.crawl 全行 reduce(page.tsx:83-86);后端只回近 7 日(interval '7 days',ads.py:403-407)故两端一致对账 promotion_crawl_stats 近 7 日和生效
AC-EL-OFF-010KPI·数据截至KPI 卡last_checked 日期+foot「快照口径 · 日更待接入」(page.tsx:145-149)max(last_checked)::date;空显「—」;foot 明示非实时(口径声明)对账 max(last_checked)生效
AC-EL-OFF-011摘要数据源口径挂载即 GET /api/promotion/summary 一次,失败静默(page.tsx:70)KPI/筛选 facets/分布/采集监控共用此响应;失败时相关区域显示 0 或空不报错mock 500 断言页面可用无横幅生效
AC-EL-OFF-012渠道库卡标题容器h2「渠道库」sub「共 N 条 · 按粉丝数排序」(page.tsx:163)N=data.total;「按粉丝数排序」指默认 sort=followers(可改排序,sub 文案不随动——已知文案固化)改排序断言列表顺序变而 sub 不变生效
AC-EL-OFF-013类型下拉筛选「全部类型(N)」+各类型带计数(page.tsx:165-168)选项=facets.types(空 type 剔除);选择即重查回第 1 页选一类型断言 total 收敛生效
AC-EL-OFF-014层级按钮组筛选「全部层级」+「X 级」按钮组(page.tsx:169-172)选项=facets.tiers(DISTINCT 升序);单选互斥选 B 级断言仅 B 级行生效
AC-EL-OFF-015国家/状态下拉筛选两个 select:全部国家/全部状态(page.tsx:173-180)选项=facets.countries/statuses(DISTINCT,空值剔除);服务端 coalesce 等值匹配组合筛选断言结果生效
AC-EL-OFF-016搜索表单筛选input「渠道 / 联系方式 / 备注」+排序下拉+「搜索」按钮(page.tsx:181-187)输入即时存 search 态,submit 才置 query 触发请求(防抖语义);提交回第 1 页输入不提交断言无请求生效
AC-EL-OFF-017排序下拉筛选4 项:按粉丝数/活跃度/最近核验/名称(page.tsx:40-42,183-185)默认 followers;服务端映射 PROMO_SORTS(ads.py:320-321):followers=follower_count DESC NULLS LAST 等;非法值回退 followers选活跃度断言顺序变化生效
AC-EL-OFF-018渠道表表头表格12 列:渠道/类型层级/国家·平台/粉丝/活跃度/费用/预估单/联系方式提交/状态/适配产品线/核验/操作(page.tsx:194-197)列序固定;行键=namee2e 断言 12 列文本与顺序生效
AC-EL-OFF-019渠道列列source_url 非空时名称为外链(新窗 noreferrer),notes 超 60 字截断加…(page.tsx:201-204)title 属性=完整 notes 可看全文;无 url 纯文本断言截断与悬停全文生效
AC-EL-OFF-020类型/层级列列类型文本+层级 badge「X 级」(B=ok 绿 其余 dim 灰)(page.tsx:205-208)tier 空则无 badge;类型空显「—」断言 B 级绿徽章生效
AC-EL-OFF-021国家·平台列列[country, platform, language] 过滤空后「 · 」连接,全空显「—」(page.tsx:209)三字段拼接展示缺字段行断言拼接正确生效
AC-EL-OFF-022粉丝列列int() 千分位,null 显「—」(page.tsx:210)源 follower_count 整数对账 DB 值生效
AC-EL-OFF-023活跃度列列数值一位小数(page.tsx:211)服务端 round(activity_score::numeric,1)(ads.py:350);null 显「—」对账 round 一位小数生效
AC-EL-OFF-024费用/预估单列列文本展示 cost/est_orders,空显「—」(page.tsx:212-213)源库自由文本(非数值字段),无汇总口径断言原样回显生效
AC-EL-OFF-025联系方式/提交列列contact 主行+submit 副行(page.tsx:214-217)submit=投稿方式(submit_method 字段);空 contact 显「—」对账两字段生效
AC-EL-OFF-026状态徽章 tone 映射列STATUS_TONE 十态映射(page.tsx:43-46)待投稿=ok/养号中·暂缓=warn·bad/其余(待联系 待评估 待代理 待注册 待开通 待布局)=dim;未知态回退 dim逐状态断言颜色生效
AC-EL-OFF-027适配产品线 chips列fits 数组渲染中文 chip(page.tsx:37-39,219)FIT_LABELS 五线:keyboard=机械键盘/earphone=耳机/security=安防/bra=女士bra/brainews=BraiNews;空显「—」断言 chip 文本映射生效
AC-EL-OFF-028fits 口径(0-3 评分)口径fits=fit_* 五列中值≥1 的集合(ads.py:361)fit_* 为 0-3 评分非布尔;筛选条件 fit_col>=1(ads.py:333-335,2026-09-17 P0 修:原 =1 漏 90% 渠道);此口径为已修缺陷基准评分 2/3 的渠道断言命中筛选与 chip生效
AC-EL-OFF-029核验列列last_checked 日期(page.tsx:220)服务端 str[:10] 截日期;空显「—」对账 last_checked生效
AC-EL-OFF-030操作列(投稿/下单)操作每行「投稿」「下单」两按钮开记录弹窗(page.tsx:221-224,50)T3-2(2026-09-12):行级「投稿/下单」表单(UVPVP 记录投稿/申请投放对齐);弹窗见 AC-EL-OFF-044e2e 点投稿断言弹窗标题生效
AC-EL-OFF-031渠道表空态空态「无匹配渠道」colSpan=12(page.tsx:227)仅 items=[] 显示过滤至空断言文案生效
AC-EL-OFF-032分页器分页重置筛选/「共 N 条 · 第 x / y 页」/上一页/下一页(page.tsx:231-236)pageSize 固定 20(:66;服务端 clamp [1,100]);pages=ceil(total/20);越界按钮禁用;重置=清全部筛选回第 1 页翻页断言参数 page 正确生效
AC-EL-OFF-033channels 服务端搜索口径口径search 匹配 name/contact/notes/platform 四字段 ILIKE(ads.py:339-340)任意子串不分区大小写;空 search 全量platform 片段搜索断言命中生效
AC-EL-OFF-034类型×层级分布卡表格「类型 × 层级分布」sub「Top 12 类型」:类型/B 级/C 级/合计 4 列(page.tsx:248-271)byType=distribution 前端按 type 求和降序前 12(:87-89);B 级=tier=B 行,C 级=其余 tier 合计(含空);0 显「—」对账 distribution 分组求和生效
AC-EL-OFF-035采集监控卡表表格6 列:日期/发现/入库/富化/失败/联系方式,按日倒序(page.tsx:272-300)源 promotion_crawl_stats 平台级表:无租户列无 RLS 登录即可见(ads.py:402 注释);date_trunc('day',hour) 聚合近 7 日对账 crawl_stats 日聚合生效
AC-EL-OFF-036失败列红色阈值口径failed>100 时红字 var(--danger)(page.tsx:284)阈值 100 为展示告警线,不影响数据构造 101 失败日断言红色生效
AC-EL-OFF-037近 7 日合计行行底行浅底 #f8f8ff 加粗:五指标合计(page.tsx:288-297)与 KPI 近 7 日同源 crawl7;富化 0 显「—」合计与 KPI foot 对账一致生效
AC-EL-OFF-038采集监控口径说明口径声明「渠道发现 → 入库 → 联系方式富化三段式采集离线运行;失败数偏高多为目标页反爬(429/403),不影响已入库数据。」(page.tsx:301-303)三段式链路口径;失败为采集侧非数据侧文案与采集器行为比对生效
AC-EL-OFF-039投稿/下单弹窗容器弹窗440px 卡片弹窗,标题二态「📝 记录投稿/💵 申请付费投放」+「渠道:X」(page.tsx:347-352)遮罩点击关闭;渠道名只读回显e2e 断言两模式标题生效
AC-EL-OFF-040弹窗·产品下拉表单5 固定选项(page.tsx:316,354-357)PRODUCTS=[机械键盘,耳机,安防,女士bra,BraiNews] 与 FIT_LABELS 值域一致;默认首项断言 5 选项生效
AC-EL-OFF-041弹窗·投稿模式字段表单结果 select 4 态(待审/上稿/拒绝/无回复,默认待审)+单量 number 可空(page.tsx:359-367)单量空=null 不传 0留空提交断言 orders=null生效
AC-EL-OFF-042弹窗·下单模式字段表单金额 number+货币 select(USD/CNY 默认 USD)(page.tsx:368-377)金额 Number(amount)(空串落 0);备注可选空金额提交断言 amount=0生效
AC-EL-OFF-043弹窗·提交与反馈写操作投稿 POST /api/promotion/submission toast「投稿已记录」;下单 POST /api/promotion/orders toast「投放申请已提交(待审批)」(page.tsx:329-344)busy 期间按钮禁用「提交中…」;失败 toast 错误信息;成功关弹窗e2e 双路径断言 toast生效
AC-EL-OFF-044submission 服务端口径写操作product/channel 必填 400「产品与渠道必填」(ads.py:2475-2491)截断 product 80/channel 120/result 20/note 500;result 空默认「待审」;落 promotion_submissions 含 submitted_by;审计 promotion.submission 事务内原子化(2026-10-01 P2-波⑤ 修:原 audit NameError 致半成功)——已修缺陷基准提交后查审计行存在且与 INSERT 同事务生效
AC-EL-OFF-045orders 服务端口径写操作INSERT promotion_orders,status 默认 pending,含 requested_by(ads.py:2293-2302)审计 promo.order.create;金额原币存储不折算(currency 字段区分)提交申请断言 status=pending生效
AC-EL-OFF-046orders 审批护栏护栏POST /api/promotion/orders/{oid}/approve 需管理员(_require_admin)+action=approve/reject(ads.py:2305-2320)仅 pending 可批,否则 409「订单不存在或已审批」;审计 promo.order.approve/reject非管理员调用断言 403;重复审批断言 409生效
AC-EL-OFF-047子面板·总览看板面板OverviewTab(page.tsx:106)数据源 kol-library(suppression=all&page_size=1)+kol-stats+channel-dict(OverviewTab.tsx:30-34);含「达人渠道分布 Top 12」「Deal 资源怎么找 三处口径」「待上线模块」等卡(h2 行 87/106/115)切 tab 断言三请求发出与卡片渲染生效
AC-EL-OFF-048子面板·达人库面板LibraryTab(page.tsx:107)数据源 /api/promotion/kol-library 多选筛选(suppression 默认隐藏,h2 sub 声明,LibraryTab.tsx:117)+批量类目 /api/promotion/kol-categories/batch(:103)+类目管理 /api/promotion/categories(:288-302)+渠道字典 /api/promotion/channel-dict(:349-367,插行即生效)断言四组端点与三卡渲染生效
AC-EL-OFF-049子面板·Reddit 专库面板RedditTab(页签按钮 page.tsx:98,渲染行 :108)数据源 /api/promotion/kol-reddit(RedditTab.tsx:37);h2「共 N 位达人 · 仅站内联系方式,只读浏览」(:53)——只读面板无写操作断言请求与只读(无写按钮)生效
AC-EL-OFF-050子面板·邮件模板面板TemplatesTab(页签按钮 page.tsx:99,渲染行 :109)数据源 /api/promotion/email-templates 列表/新建/编辑 PUT/删除/预览 preview(TemplatesTab.tsx:46,53,159-175)CRUD+预览各断言一次生效
AC-EL-OFF-051子面板·分群面板SegmentsTab(page.tsx:113)数据源 /api/promotion/segments 建删(SegmentsTab.tsx:54,77,86);h2 口径「达人 ID 快照 · 发送时仍实时查 suppression + 30 天冷却」(:92);建删后通知发送任务刷新分群下拉(page.tsx:67-68 segVer 机制)建分群断言返回 kol_count 与下拉刷新生效
AC-EL-OFF-052子面板·发送任务面板SendTasksTab(page.tsx:114)数据源 /api/promotion/send-tasks 建/列表/状态动作 /{tid}/{action}/删//{tid}/logs 分页日志(SendTasksTab.tsx:50,83,95,103,208);依赖 email-templates/mailboxes/segments 三下拉源(:56-65)建任务断言状态机流转+日志分页生效
AC-EL-OFF-053子面板·收件工作台面板InboxTab(page.tsx:117)组件文件 web/app/offsitepromotion/InboxTab.tsx(366 行);本批未核其端点与元素——列级条目待深化(验收缺口挂账)。

2026-10-22 换绿:§11.40 OFC-INB 63 条已建档——面板容器+全部端点(列表/翻页/15s 轮询/thread/kol-profile/email-templates/claim/classify/handled/reply/classify-rules CRUD)+列+交互元素,InboxTab.tsx 逐行实证
读源后补列级条目生效
AC-EL-OFF-054子面板·邮箱设置面板MailboxesTab(page.tsx:118)数据源 /api/promotion/mailboxes 列表/新建/编辑 PUT/连通测试 /{id}/test/删(MailboxesTab.tsx:61,85,88,99,110)建邮箱+测试断言连通结果生效
AC-EL-OFF-055子面板·✅任务面板TasksPanel(page.tsx:242,实现于 TasksTab.tsx)数据源 /api/promotion/submissions(投稿记录 100 条,h2 行 39)+/api/promotion/orders(投放申请,h2 行 51「pending 状态管理员可批」)+审批 approve 调用(TasksTab.tsx:27-32)断言两列表与审批按钮生效
AC-EL-OFF-056子面板·📣KOL面板KolPanel(page.tsx:243,实现于 TasksTab.tsx)含「平台效果分析(互动率=(均赞+均评)/均播 · 100K+ 占比按订阅)/粉丝量级性价比/品类分布/国家分布」四卡(TasksTab.tsx h2 行 313-327);数据源 kol-analysis 族断言四分析卡渲染生效
AC-EL-OFF-057子面板·🚀推广项目面板ProjectsPanel(page.tsx:244,实现于 ProjectsTab.tsx 374 行)端点族 10 个:projects 列表/建/删、/{id}/kols 筛选分页、/project-kols/{pkid}/status、email/batch-send、export CSV、kols/add 勾选加入、/project-kols/{pk_id}/content+manual PUT(ProjectsTab.tsx:31,38,91,129,135,141,147,256,303,315)走通建项目→加 KOL→批送→导出链生效
AC-EL-OFF-058子面板·🌐全部资源面板ResourcesPanel(page.tsx:245,实现于 ResourcesTab.tsx)数据源 /api/promotion/resources?rtype&platform(ResourcesTab.tsx:30);h2「渠道站 + 达人 · 共 N 条 · 按粉丝降序」(:46)断言列表与筛选生效
AC-EL-OFF-059tasks 端点族口径GET/POST /api/promotion/tasks+/{tid}/status+DELETE(ads.py:2195-2256)列表排序 in_progress→blocked→其余,LIMIT 300;stats=pending/blocked/in_progress 三计数;状态非法 400「未知状态」;动作必填 400;审计 promo.task.create/status/delete对账三计数与排序生效
AC-EL-OFF-060渠道状态流转口径POST /api/promotion/channels/{cid}/status(ads.py:2257-2278)自由九态(待投稿/已投稿/已上稿/已拒/待代理/暂缓/养号中/待注册/待评估);审计留痕流转一态断言列表回显生效
AC-EL-OFF-061KOL 外联状态护栏护栏POST /api/promotion/kol/{kind}/{kid}/outreach(ads.py:2327-2339)kind∈{channel,site,high};kind=channel 固定 400「KOL 渠道表不支持外联状态(仅测评站/高优清单支持)」(2026-09-17 修:原代码对该表必 500)——已修缺陷基准;审计 promo.kol.outreachkind=channel 调用断言 400 非 500生效
AC-EL-OFF-062KOL 库口径口径GET /api/promotion/kol(ads.py:2342+)kind 三源:渠道 1000/测评站 315/高优 65(docstring 口径);limit clamp [1,200] 默认 50三 kind 各拉一页对账量级生效
AC-EL-OFF-063submissions/orders 回读口径GET /api/promotion/submissions 与 GET /api/promotion/orders(ads.py:2279-2290,2494-2503)各新→旧 100 条;orders 2026-09-17 补(原提交后无页面可读回,审批无入口)——已修缺陷基准;orders 含 requested_by/approved_by提交后断言列表首行回显生效
AC-EL-OFF-064子组件列级深化挂账边界声明本节对 11 个子组件按面板级建档(端点+标题+核心口径),组件内部逐元素条目未建面板出现而库中无列级条目=验收缺口(沿用 §11.27 财务列级+§11.28 采集六 tab 列级两级先例:先页级后列级);InboxTab 连面板级端点都未核(AC-EL-OFF-053)优先补后续批次按组件逐个补列级。

2026-10-22 换绿:§11.40 OFC 系列 446 条列级全建档(11 子组件+InboxTab),两级先例(页级→列级)闭环
生效
AC-EL-OFF-065模块权限与隔离口径·铁律全部 /api/promotion/* 端点 require_module("ads")(ads.py 各路由签名)渠道库/分群/模板/邮箱经 tenant_conn 租户隔离;唯 promotion_crawl_stats 平台级无租户列(登录可见,AC-EL-OFF-035 已声明); crawl 数据不涉品牌隔离非 ads 模块账号访问断言 403生效

§11.38 选品图表墙逐图·ABA/Explore(/sourcing · AC-EL-SRC-AB/EC 系列,源码 web/app/sourcing/charts/{ABACharts,ExploreCharts}.tsx + chartCatalog.ts;数据接线 web/app/sourcing/page.tsx)

ABA 墙 20 图=ABA_CHARTS 目录驱动循环渲染(chartCatalog.ts:5-26,卡片网格 ABACharts.tsx:35-41,图题=目录第二列逐字);数据=GET /api/sourcing/explorer(page.tsx:260 拉取、:421 <ABACharts data> 注入,payload 含 timeline/turnover/rotation/cross;姊妹端点 /api/sourcing/aba/chart sourcing.py:2206 同口径);timeline 空则整墙零构建、逐卡显「当前范围无可绘制数据」(:30/:38);periods>18 的折线自动 dataZoom;源=aba_terms_full+aba_search_terms+aba_keepa_full(SRC-17 口径,未变)。

Explore 墙 38 图 7 组=EXPLORE_CHART_GROUPS 目录驱动(ExploreCharts.tsx:21-74,组头 h2 显「N 图 · 固化架构」:96,卡网格 :97-103);数据=/api/sourcing/explore 行集前 200 行、EXPLORE_FIELDS 33 字段固定全取(:10-19,SRC-52 口径未变),全部图前端由行集计算(bucketize :111-118 / cnt :124-128 / sc :175-176 / topAsin :186-189 / boxBy :196-203 / pearson :232-240);无数据图渲染「无数据 · 空白占位」斜纹卡(:84-88)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-AB-001SFR月度趋势折线ABA 墙第 1 图timeline.search_frequency_rank 逐月;y 轴反转(SFR 越小越热),yLabel「SFR (越小越热)」;目录项 chartCatalog.ts:6,构建器 ABACharts.tsx:51-56读 chartCatalog.ts chartCatalog.ts:6 与构建器 ABACharts.tsx:51-56;图题逐字比对生效
AC-EL-SRC-AB-002SFR月度变化量/变化率折线ABA 墙第 2 图逐月差分=prev−cur(首月无前值记空);目录项 chartCatalog.ts:7,构建器 ABACharts.tsx:57-66读 chartCatalog.ts chartCatalog.ts:7 与构建器 ABACharts.tsx:57-66;图题逐字比对生效
AC-EL-SRC-AB-003季节性热力图(年份×自然月)热力图ABA 墙第 3 图timeline 按年×月矩阵,色值=−SFR(反转着色);目录项 chartCatalog.ts:8,构建器 ABACharts.tsx:67-78读 chartCatalog.ts chartCatalog.ts:8 与构建器 ABACharts.tsx:67-78;图题逐字比对生效
AC-EL-SRC-AB-004ABA月份完整度/缺月图柱图ABA 墙第 4 图逐月 status=available 记 1 否则 0,竖柱;目录项 chartCatalog.ts:9,构建器 ABACharts.tsx:79-87读 chartCatalog.ts chartCatalog.ts:9 与构建器 ABACharts.tsx:79-87;图题逐字比对生效
AC-EL-SRC-AB-005Top1/2/3点击份额曲线折线ABA 墙第 5 图asin_{1,2,3}_click_share 三线,百分轴;目录项 chartCatalog.ts:10,构建器 ABACharts.tsx:88-95读 chartCatalog.ts chartCatalog.ts:10 与构建器 ABACharts.tsx:88-95;图题逐字比对生效
AC-EL-SRC-AB-006Top1/2/3成交份额曲线折线ABA 墙第 6 图asin_{1,2,3}_conv_share 三线,百分轴;目录项 chartCatalog.ts:11,构建器 ABACharts.tsx:96-103读 chartCatalog.ts chartCatalog.ts:11 与构建器 ABACharts.tsx:96-103;图题逐字比对生效
AC-EL-SRC-AB-007Top3与榜外点击份额堆叠图堆叠ABA 墙第 7 图top3_click_share+other_click_share 两段百分堆叠;目录项 chartCatalog.ts:12,构建器 ABACharts.tsx:104-112读 chartCatalog.ts chartCatalog.ts:12 与构建器 ABACharts.tsx:104-112;图题逐字比对生效
AC-EL-SRC-AB-008Top3与榜外成交份额堆叠图堆叠ABA 墙第 8 图top3_conv_share+榜外=1−Top3 推导(源无榜外成交原始列);目录项 chartCatalog.ts:13,构建器 ABACharts.tsx:113-121读 chartCatalog.ts chartCatalog.ts:13 与构建器 ABACharts.tsx:113-121;图题逐字比对生效
AC-EL-SRC-AB-009点击份额-成交份额差值曲线折线ABA 墙第 9 图top3_click_share−top3_conv_share 逐月,百分轴;目录项 chartCatalog.ts:14,构建器 ABACharts.tsx:122-127读 chartCatalog.ts chartCatalog.ts:14 与构建器 ABACharts.tsx:122-127;图题逐字比对生效
AC-EL-SRC-AB-010指定月份Top3与榜外份额结构图环形ABA 墙第 10 图取最近 status=available 且份额非空月的 Top1/2/3+榜外四段百分环;目录项 chartCatalog.ts:15,构建器 ABACharts.tsx:128-141读 chartCatalog.ts chartCatalog.ts:15 与构建器 ABACharts.tsx:128-141;图题逐字比对生效
AC-EL-SRC-AB-011全部上榜ASIN点击份额轨迹折线ABA 墙第 11 图逐 ASIN 聚合各席位 click_share 成线,仅前 15 ASIN(slice 0,15);目录项 chartCatalog.ts:16,构建器 ABACharts.tsx:142-158读 chartCatalog.ts chartCatalog.ts:16 与构建器 ABACharts.tsx:142-158;图题逐字比对生效
AC-EL-SRC-AB-012全部上榜ASIN成交份额轨迹折线ABA 墙第 12 图同 011 口径改 conv_share,仅前 15 ASIN;目录项 chartCatalog.ts:17,构建器 ABACharts.tsx:159-175读 chartCatalog.ts chartCatalog.ts:17 与构建器 ABACharts.tsx:159-175;图题逐字比对生效
AC-EL-SRC-AB-013ASIN×月份×Top1/2/3席位热力图热力图ABA 墙第 13 图矩阵值=席位号 1/2/3;ASIN 取 rotation 前 15;目录项 chartCatalog.ts:18,构建器 ABACharts.tsx:176-191读 chartCatalog.ts chartCatalog.ts:18 与构建器 ABACharts.tsx:176-191;图题逐字比对生效
AC-EL-SRC-AB-014Top1占位ASIN时间带时间带ABA 墙第 14 图逐月 asin_1 占位标签带;目录项 chartCatalog.ts:19,构建器 ABACharts.tsx:192-197读 chartCatalog.ts chartCatalog.ts:19 与构建器 ABACharts.tsx:192-197;图题逐字比对生效
AC-EL-SRC-AB-015每月新进入/退出ASIN数折线ABA 墙第 15 图turnover.entered/exited 双线;目录项 chartCatalog.ts:20,构建器 ABACharts.tsx:198-206读 chartCatalog.ts chartCatalog.ts:20 与构建器 ABACharts.tsx:198-206;图题逐字比对生效
AC-EL-SRC-AB-016随选月增加的累计去重ASIN曲线折线ABA 墙第 16 图turnover.cumulative_unique 单线;目录项 chartCatalog.ts:21,构建器 ABACharts.tsx:207-211读 chartCatalog.ts chartCatalog.ts:21 与构建器 ABACharts.tsx:207-211;图题逐字比对生效
AC-EL-SRC-AB-017ASIN上榜月数分布柱图ABA 墙第 17 图rotation.appearances 分桶计数(X 月);目录项 chartCatalog.ts:22,构建器 ABACharts.tsx:212-219读 chartCatalog.ts chartCatalog.ts:22 与构建器 ABACharts.tsx:212-219;图题逐字比对生效
AC-EL-SRC-AB-018相邻月份席位换手率折线ABA 墙第 18 图turnover.turnover_rate,百分轴;目录项 chartCatalog.ts:23,构建器 ABACharts.tsx:220-224读 chartCatalog.ts chartCatalog.ts:23 与构建器 ABACharts.tsx:220-224;图题逐字比对生效
AC-EL-SRC-AB-019月份数→理论席位→有效席位→去重ASIN漏斗横柱ABA 墙第 19 图四级横柱:有效月数→×3 理论席位→Σappearances 有效席位→rotation 数去重;目录项 chartCatalog.ts:24,构建器 ABACharts.tsx:225-239读 chartCatalog.ts chartCatalog.ts:24 与构建器 ABACharts.tsx:225-239;图题逐字比对生效
AC-EL-SRC-AB-020同一精确词跨站点SFR/Top1/Top3集中度对比折线ABA 墙第 20 图cross[].sfr_median/top1_click_median/top3_click_median 按 country 三线;仅 cross.length>1 构建,否则空卡;目录项 chartCatalog.ts:25,构建器 ABACharts.tsx:240-249读 chartCatalog.ts chartCatalog.ts:25 与构建器 ABACharts.tsx:240-249;图题逐字比对生效
AC-EL-SRC-EC-001BuyBox 价格分布柱图价格维度组图卡buy_box 分桶 0/10/20/30/50/80/120/200,币种轴;构建器 ExploreCharts.tsx:132读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:132;图题逐字比对生效
AC-EL-SRC-EC-002Amazon 自营价分布柱图价格维度组图卡price_amazon 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:133读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:133;图题逐字比对生效
AC-EL-SRC-EC-003Marketplace 新品价分布柱图价格维度组图卡price_new 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:134读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:134;图题逐字比对生效
AC-EL-SRC-EC-004Used 价分布柱图价格维度组图卡price_used 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:135读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:135;图题逐字比对生效
AC-EL-SRC-EC-005List 价分布柱图价格维度组图卡list_price 分桶 0/15/30/50/80/120/200/400,币种轴;构建器 ExploreCharts.tsx:136读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:136;图题逐字比对生效
AC-EL-SRC-EC-006当前 BSR 档位分布柱图排名/销量维度组图卡bsr_current 分桶 0/1k/5k/1w/5w/10w/50w/100w;构建器 ExploreCharts.tsx:139读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:139;图题逐字比对生效
AC-EL-SRC-EC-00790 天均 BSR 档位分布柱图排名/销量维度组图卡bsr_avg90 同 7 档桶;构建器 ExploreCharts.tsx:140读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:140;图题逐字比对生效
AC-EL-SRC-EC-008近月购买量档位分布柱图排名/销量维度组图卡monthly_sold 分桶 0/100/300/1k/3k/1w/3w;构建器 ExploreCharts.tsx:141读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:141;图题逐字比对生效
AC-EL-SRC-EC-00930 天 Rank Drops 档位分布柱图排名/销量维度组图卡drops30 分桶 0/500/2k/5k/1w/3w/10w;构建器 ExploreCharts.tsx:142读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:142;图题逐字比对生效
AC-EL-SRC-EC-010365 天 Rank Drops 档位分布柱图排名/销量维度组图卡drops365 分桶 0/5k/2w/5w/10w/30w/100w;构建器 ExploreCharts.tsx:143读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:143;图题逐字比对生效
AC-EL-SRC-EC-011评分分布柱图评论/评分维度组图卡rating 分桶 1/3/3.5/3.8/4/4.2/4.4/4.6/4.8;构建器 ExploreCharts.tsx:146读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:146;图题逐字比对生效
AC-EL-SRC-EC-012评论数档位分布柱图评论/评分维度组图卡reviews 分桶 0/10/50/100/500/1k/5k;构建器 ExploreCharts.tsx:147读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:147;图题逐字比对生效
AC-EL-SRC-EC-01390 天均评论档位分布柱图评论/评分维度组图卡reviews_avg90 分桶 0/1/5/10/50/100/500;构建器 ExploreCharts.tsx:148读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:148;图题逐字比对生效
AC-EL-SRC-EC-014总报价数档位分布柱图报价/库存维度组图卡total_offers 分桶 0/2/5/10/20/50/100;构建器 ExploreCharts.tsx:151读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:151;图题逐字比对生效
AC-EL-SRC-EC-01530 天缺货次数分布柱图报价/库存维度组图卡oos_amazon_30 分桶 0/1/3/5/10/20;构建器 ExploreCharts.tsx:152读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:152;图题逐字比对生效
AC-EL-SRC-EC-016商品重量档位分布柱图报价/库存维度组图卡item_weight 分桶 0/0.2/0.5/1/2/5/10/20;构建器 ExploreCharts.tsx:153读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:153;图题逐字比对生效
AC-EL-SRC-EC-017品牌占比 Top15环形结构占比维度组图卡brand 计数 Top15 环;构建器 ExploreCharts.tsx:156读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:156;图题逐字比对生效
AC-EL-SRC-EC-018制造商占比 Top10环形结构占比维度组图卡manufacturer 计数 Top10 环;构建器 ExploreCharts.tsx:157读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:157;图题逐字比对生效
AC-EL-SRC-EC-019BSR 显示组占比 Top12环形结构占比维度组图卡sales_rank_display_group 计数 Top12 环;构建器 ExploreCharts.tsx:158读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:158;图题逐字比对生效
AC-EL-SRC-EC-020颜色占比 Top10环形结构占比维度组图卡color 计数 Top10 环;构建器 ExploreCharts.tsx:159读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:159;图题逐字比对生效
AC-EL-SRC-EC-021尺寸占比 Top10环形结构占比维度组图卡size 计数 Top10 环;构建器 ExploreCharts.tsx:160读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:160;图题逐字比对生效
AC-EL-SRC-EC-022BuyBox FBA / FBM 占比环形结构占比维度组图卡buy_box_is_fba true/false/其余未知 三段;构建器 ExploreCharts.tsx:161-166读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:161-166;图题逐字比对生效
AC-EL-SRC-EC-023BuyBox 自营 / 第三方占比环形结构占比维度组图卡buy_box_is_amazon true/false/其余未知 三段;构建器 ExploreCharts.tsx:167-172读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:167-172;图题逐字比对生效
AC-EL-SRC-EC-024BuyBox 价 × 月销量散点关联散点维度组图卡气泡=reviews,x 币种轴;sc() :175-176;构建器 ExploreCharts.tsx:177读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:177;图题逐字比对生效
AC-EL-SRC-EC-025当前 BSR × 月销量散点关联散点维度组图卡x=bsr_current y=monthly_sold 气泡=reviews;构建器 ExploreCharts.tsx:178读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:178;图题逐字比对生效
AC-EL-SRC-EC-026评分 × 评论数散点关联散点维度组图卡x=rating y=reviews;构建器 ExploreCharts.tsx:179读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:179;图题逐字比对生效
AC-EL-SRC-EC-027BuyBox 价 × 评论数散点关联散点维度组图卡x 币种轴;构建器 ExploreCharts.tsx:180读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:180;图题逐字比对生效
AC-EL-SRC-EC-02830 天 Drops × 月销量散点关联散点维度组图卡x=drops30 y=monthly_sold;构建器 ExploreCharts.tsx:181读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:181;图题逐字比对生效
AC-EL-SRC-EC-029总报价数 × BuyBox 价散点关联散点维度组图卡y 币种轴;构建器 ExploreCharts.tsx:182读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:182;图题逐字比对生效
AC-EL-SRC-EC-030品牌上榜数 Top20柱图Top榜/箱线/相关性组图卡cnt(brand,20) 计数降序;构建器 ExploreCharts.tsx:185读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:185;图题逐字比对生效
AC-EL-SRC-EC-031月销量 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(monthly_sold desc) 前 20(topAsin :186-189);构建器 ExploreCharts.tsx:190读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:190;图题逐字比对生效
AC-EL-SRC-EC-032评论数 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(reviews desc);构建器 ExploreCharts.tsx:191读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:191;图题逐字比对生效
AC-EL-SRC-EC-033BuyBox 价 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(buy_box desc) 币种轴;构建器 ExploreCharts.tsx:192读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:192;图题逐字比对生效
AC-EL-SRC-EC-034BSR 最优 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(bsr_current asc)(越小越优);构建器 ExploreCharts.tsx:193读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:193;图题逐字比对生效
AC-EL-SRC-EC-035品牌 BuyBox 价格箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy 按品牌样本数 Top10(boxBy :196-203),币种轴;构建器 ExploreCharts.tsx:204读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:204;图题逐字比对生效
AC-EL-SRC-EC-036品牌评分箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy(rating);构建器 ExploreCharts.tsx:205读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:205;图题逐字比对生效
AC-EL-SRC-EC-037品牌月销量箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy(monthly_sold);构建器 ExploreCharts.tsx:206读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:206;图题逐字比对生效
AC-EL-SRC-EC-038核心指标相关性矩阵热力图Top榜/箱线/相关性组图卡9 指标(BuyBox/BSR/月销/评分/评论/drops30/报价数/New报价/重量)两两 Pearson,逐对仅取双字段均有限行,n<3 不计,值留 2 位(pearson :232-240);构建器 ExploreCharts.tsx:209-228读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:209-228;图题逐字比对生效

§11.39 选品图表墙逐图·Keepa 单 ASIN/池级/ABA×Keepa 联合(AC-EL-SRC-KS/KP/JT 系列,源码 web/app/sourcing/charts/{KeepaSingleCharts,KeepaPoolCharts,JointCharts}.tsx;图录 chartCatalog.ts)

数据源 /api/sourcing/explorer → rotation[*].keepa(aba_keepa_full 快照+30/90/180/365 窗口聚合,无原始时序——历史类图为单点/窗口近似,KeepaSingleCharts.tsx:2-5 头注明示);34+22+34=90 图目录卡全渲染(网格 auto-fit minmax(380px,1fr),无数据兜底「无数据」)。KS 降级规则:纯线图非空点<3 → 快照摘要卡(:49-73);「⚡ 拉取 Keepa 原始曲线」(GET /api/sourcing/keepa-history,1 token/24h 缓存,:87-94)就位后 7 个历史图升级真曲线(720 点,:97-111)。JT 实为 34 图——chartCatalog.ts:136 counts 注 joint:32 已过时;JointCharts.tsx:67-74 sfrVsKeepa 数组为死代码(计算后未用,:84-104 循环另行构建)。 2026-10-22 v5.3 更正:KS 5 张恒空卡撤卡(KS-014/016/017/023/035→废止),7 处图题对齐实构(KS-025/032/034、KP-022、JT-005/009/010);上句 counts 过时与 sfrVsKeepa 死数组问题均已修复——counts 现 joint:34/keepa_single:34/total:110(chartCatalog.ts:132),死数组 :67-74 已删(本节 JointCharts 行号已随删行平移)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-KS-001BSR原始变化点线图BSR 两点近似keepa-single-bsr-raw 目录项;bsr_avg90+bsr_current 两点线, invert 轴; 快照近似非真时序(构建 KeepaSingleCharts.tsx 162-170)chartCatalog.ts:29+KeepaSingleCharts.tsx:162生效
AC-EL-SRC-KS-002BSR日末值及日内最好/最差区间线图BSR 区间近似keepa-single-bsr-daily-range 目录项;avg90/current±drops30 模拟上下界; 快照近似(构建 KeepaSingleCharts.tsx 171-179)chartCatalog.ts:30+KeepaSingleCharts.tsx:171生效
AC-EL-SRC-KS-003BSR周级/月级聚合柱图(横)drops 四窗分布keepa-single-bsr-week-month 目录项;drops30/90/180/365 四横柱(以 drops 代理聚合)(构建 KeepaSingleCharts.tsx 181-190)chartCatalog.ts:31+KeepaSingleCharts.tsx:181生效
AC-EL-SRC-KS-004Amazon近月购买量档位阶梯线线图月销档单点keepa-single-monthly-sold 目录项;monthly_sold 档位单点线(构建 KeepaSingleCharts.tsx 192-195)chartCatalog.ts:32+KeepaSingleCharts.tsx:192生效
AC-EL-SRC-KS-005BSR×近月购买量档位双轴图双轴线BSR×月销档keepa-single-bsr-sold 目录项;bsr_current×monthly_sold 双轴, 主轴 invert(构建 KeepaSingleCharts.tsx 196-206)chartCatalog.ts:33+KeepaSingleCharts.tsx:196生效
AC-EL-SRC-KS-00630/90/180/365天Sales Rank Drops对比柱图drops 四窗对比keepa-single-rank-drops 目录项;drops30/90/180/365 四柱(构建 KeepaSingleCharts.tsx 207-217)chartCatalog.ts:34+KeepaSingleCharts.tsx:207生效
AC-EL-SRC-KS-007Amazon自营价历史线图price_amazon 单点近似keepa-single-amazon-price 目录项;当前单点; 非空点<3 降级快照摘要卡; keepa-history S.amazon 升级真曲线(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:35+KeepaSingleCharts.tsx:220生效
AC-EL-SRC-KS-008Marketplace New价历史线图price_new 单点近似keepa-single-new-price 目录项;同上降级规则; keepa-history S.new 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:36+KeepaSingleCharts.tsx:221生效
AC-EL-SRC-KS-009Used价历史线图price_used 单点近似keepa-single-used-price 目录项;keepa-history S.used 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:37+KeepaSingleCharts.tsx:222生效
AC-EL-SRC-KS-010List Price历史线图list_price 单点近似keepa-single-list-price 目录项;keepa-history S.list 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:38+KeepaSingleCharts.tsx:223生效
AC-EL-SRC-KS-011BuyBox价历史线图buy_box 单点近似keepa-single-buybox-price 目录项;当前单点(无真时序升级项)(构建 :224)chartCatalog.ts:39+KeepaSingleCharts.tsx:224生效
AC-EL-SRC-KS-012New FBA最低价历史线图FBA 条件价keepa-single-new-fba-price 目录项;buy_box_is_fba?price_new:空(构建 :225)chartCatalog.ts:40+KeepaSingleCharts.tsx:225生效
AC-EL-SRC-KS-013New FBM含运费价历史线图FBM 条件价keepa-single-new-fbm-price 目录项;!buy_box_is_fba?price_new:空(构建 :226)chartCatalog.ts:41+KeepaSingleCharts.tsx:226生效
AC-EL-SRC-KS-014Warehouse/Refurbished/Collectible价历史空态卡恒无数据keepa-single-other-condition-prices 目录项;无构建器(:234 注释跳过), 卡渲染「无数据」。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 234)
chartCatalog.ts:41+KeepaSingleCharts.tsx:234废止
AC-EL-SRC-KS-015二手各成色价格历史柱图used 单点keepa-single-used-condition-prices 目录项;price_used 单值柱(currency)(构建 KeepaSingleCharts.tsx 235-239)chartCatalog.ts:42+KeepaSingleCharts.tsx:235生效
AC-EL-SRC-KS-016Lightning/Prime/Deal事件时间线空态卡恒无数据keepa-single-deal-events 目录项;无构建器(:240 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 240)
chartCatalog.ts:43+KeepaSingleCharts.tsx:240废止
AC-EL-SRC-KS-017Coupon与折扣历史空态卡恒无数据keepa-single-coupon-events 目录项;无构建器(:241 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 241)
chartCatalog.ts:44+KeepaSingleCharts.tsx:241废止
AC-EL-SRC-KS-018New报价数量历史线图count_new 单点keepa-single-new-offer-count 目录项;当前单点线(构建 KeepaSingleCharts.tsx 242-246)chartCatalog.ts:43+KeepaSingleCharts.tsx:242生效
AC-EL-SRC-KS-019FBA/FBM报价数量历史柱图FBA vs FBMkeepa-single-fba-fbm-count 目录项;offer_fba/offer_fbm 双柱(蓝/橙)(构建 KeepaSingleCharts.tsx 247-255)chartCatalog.ts:44+KeepaSingleCharts.tsx:247生效
AC-EL-SRC-KS-020Used/Refurbished/Collectible报价数量历史柱图其他报价近似keepa-single-other-offer-count 目录项;total_offers−fba−fbm 近似三柱(构建 KeepaSingleCharts.tsx 256-266)chartCatalog.ts:45+KeepaSingleCharts.tsx:256生效
AC-EL-SRC-KS-021BuyBox卖家占位时间线柱图占位 0/1keepa-single-buybox-seller 目录项;buy_box_is_amazon/buy_box_is_fba 0/1 柱(构建 KeepaSingleCharts.tsx 267-276)chartCatalog.ts:46+KeepaSingleCharts.tsx:267生效
AC-EL-SRC-KS-022Amazon/第三方/空窗BuyBox持有结构环形三类 100/0keepa-single-buybox-holder-structure 目录项;Amazon/FBA 三方/FBM 三方 百分比环形(构建 KeepaSingleCharts.tsx 277-286)chartCatalog.ts:47+KeepaSingleCharts.tsx:277生效
AC-EL-SRC-KS-023各卖家报价历史空态卡恒无数据keepa-single-seller-offers 目录项;无构建器(:287 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 287)
chartCatalog.ts:50+KeepaSingleCharts.tsx:287废止
AC-EL-SRC-KS-024Amazon可售/缺货/恢复事件事件图缺货事件keepa-single-amazon-availability 目录项;oos_amazon_30/90 → 缺货次数事件点(构建 KeepaSingleCharts.tsx 288-297)chartCatalog.ts:48+KeepaSingleCharts.tsx:288生效
AC-EL-SRC-KS-02530/90天缺货次数对比柱图实构两窗keepa-single-oos-windows 目录项;题称四窗, 源只有 oos_amazon_30/90 两柱(构建 KeepaSingleCharts.tsx 298-306)。

2026-10-22 图题对齐:目录题「30/90/180/365天缺货率对比」→「30/90天缺货次数对比」(chartCatalog.ts:49),实构未动
chartCatalog.ts:49+KeepaSingleCharts.tsx:298生效
AC-EL-SRC-KS-026评分历史线图rating 单点keepa-single-rating 目录项;keepa-history S.rating 升级(构建 KeepaSingleCharts.tsx 307-311)chartCatalog.ts:50+KeepaSingleCharts.tsx:307生效
AC-EL-SRC-KS-027评论数历史线图reviews 单点keepa-single-reviews 目录项;keepa-history S.reviews 升级(构建 KeepaSingleCharts.tsx 312-316)chartCatalog.ts:51+KeepaSingleCharts.tsx:312生效
AC-EL-SRC-KS-028评论增长速度柱图90 天增长keepa-single-review-growth 目录项;reviews−reviews_avg90 单柱(构建 KeepaSingleCharts.tsx 317-322)chartCatalog.ts:52+KeepaSingleCharts.tsx:317生效
AC-EL-SRC-KS-029父ASIN变化历史柱图(横)parent 占位keepa-single-parent-history 目录项;parent_asin 存在时占位横柱(构建 KeepaSingleCharts.tsx 323-327)chartCatalog.ts:53+KeepaSingleCharts.tsx:323生效
AC-EL-SRC-KS-030BSR参考类目/类目变化历史柱图(横)类目占位keepa-single-category-history 目录项;sales_rank_display_group 占位横柱(构建 KeepaSingleCharts.tsx 328-332)chartCatalog.ts:54+KeepaSingleCharts.tsx:328生效
AC-EL-SRC-KS-031变体结构及历史变化柱图(横)color/size 占位keepa-single-variation-history 目录项;颜色/尺寸占位横柱(构建 KeepaSingleCharts.tsx 333-340)chartCatalog.ts:55+KeepaSingleCharts.tsx:333生效
AC-EL-SRC-KS-032BSR Current/Avg90/Drops30/Drops90对比柱图(横)实构四柱keepa-single-window-comparison 目录项;题称五窗, 实构 Current/Avg90/Drops30/Drops90(构建 KeepaSingleCharts.tsx 341-351)。

2026-10-22 图题对齐:目录题「Current/Avg30/Avg90/Avg180/Avg365对比」→「BSR Current/Avg90/Drops30/Drops90对比」(chartCatalog.ts:56),实构未动
chartCatalog.ts:56+KeepaSingleCharts.tsx:341生效
AC-EL-SRC-KS-033当前价/List Price/竞争价格阈值对比柱图(横)三价对比keepa-single-price-threshold 目录项;price_new/list_price/buy_box 横柱(currency)(构建 KeepaSingleCharts.tsx 352-362)chartCatalog.ts:57+KeepaSingleCharts.tsx:352生效
AC-EL-SRC-KS-034BuyBox价→FBA费→佣金→毛利瀑布图瀑布价费毛利keepa-single-cost-waterfall 目录项;题称含尺寸重量, 实构 BuyBox−FBA费−佣金→毛利(构建 KeepaSingleCharts.tsx 363-376)。

2026-10-22 图题对齐:目录题「包装尺寸、重量、FBA费、佣金、成本瀑布图」→「BuyBox价→FBA费→佣金→毛利瀑布图」(chartCatalog.ts:58),实构未动
chartCatalog.ts:58+KeepaSingleCharts.tsx:363生效
AC-EL-SRC-KS-035图片/视频/A+/Features/变体数量内容资产图空态卡恒无数据keepa-single-content-assets 目录项;无构建器(:377 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 377)
chartCatalog.ts:62+KeepaSingleCharts.tsx:377废止
AC-EL-SRC-KS-036每日评分 × 评论数散点评分×评论keepa-single-daily-rating-review 目录项;rating×reviews 单点散点(构建 KeepaSingleCharts.tsx 378-382)chartCatalog.ts:59+KeepaSingleCharts.tsx:378生效
AC-EL-SRC-KS-037每日排名 BSR线图BSR 单点keepa-single-daily-bsr 目录项;bsr_current 单点 invert(构建 KeepaSingleCharts.tsx 383-387)chartCatalog.ts:60+KeepaSingleCharts.tsx:383生效
AC-EL-SRC-KS-038每日 BSR × 近月购买量档位散点BSR×月销档keepa-single-daily-bsr-sold 目录项;bsr_current×monthly_sold 散点 xInvert(构建 KeepaSingleCharts.tsx 388-392)chartCatalog.ts:61+KeepaSingleCharts.tsx:388生效
AC-EL-SRC-KS-039近月购买量档位历史线图月销档单点keepa-single-monthly-sold-history 目录项;monthly_sold 单点线(构建 KeepaSingleCharts.tsx 393-397)chartCatalog.ts:62+KeepaSingleCharts.tsx:393生效
AC-EL-SRC-KP-001新品价格分布柱图price_new 分桶keepa-pool-new-price-distribution 目录项;桶界 [0,10,20,30,50,80,120,200], 空桶剔除(构建 KeepaPoolCharts.tsx 53-61)chartCatalog.ts:66+KeepaPoolCharts.tsx:53生效
AC-EL-SRC-KP-002品牌/父体价格箱线图箱线品牌价箱线keepa-pool-brand-parent-price-boxplot 目录项;按 brand 聚 price_new, top12 品牌(构建 KeepaPoolCharts.tsx 62-75)chartCatalog.ts:67+KeepaPoolCharts.tsx:62生效
AC-EL-SRC-KP-003近月购买量档位分布柱图月销档分桶keepa-pool-monthly-sold-distribution 目录项;桶界 [0,100,300,1000,3000,10000,30000](构建 KeepaPoolCharts.tsx 76-84)chartCatalog.ts:68+KeepaPoolCharts.tsx:76生效
AC-EL-SRC-KP-004BSR分布柱图(横)BSR 分桶keepa-pool-bsr-distribution 目录项;桶界 [0,1000,5000,20000,80000,200000,500000](构建 KeepaPoolCharts.tsx 85-93)chartCatalog.ts:69+KeepaPoolCharts.tsx:85生效
AC-EL-SRC-KP-005评论数分布柱图reviews 分桶keepa-pool-reviews-distribution 目录项;桶界 [0,10,50,200,1000,5000,20000](构建 KeepaPoolCharts.tsx 94-102)chartCatalog.ts:70+KeepaPoolCharts.tsx:94生效
AC-EL-SRC-KP-006评分分布柱图评分分桶keepa-pool-rating-distribution 目录项;rating×10 桶界 30-48, 标签回除 10(3.0-4.8)(构建 KeepaPoolCharts.tsx 103-111)chartCatalog.ts:71+KeepaPoolCharts.tsx:103生效
AC-EL-SRC-KP-007报价数量分布柱图offers 分桶keepa-pool-offer-distribution 目录项;total_offers 桶界 [0,1,3,5,10,20,50](构建 KeepaPoolCharts.tsx 112-120)chartCatalog.ts:72+KeepaPoolCharts.tsx:112生效
AC-EL-SRC-KP-008FBA/FBM/Amazon报价结构环形三和环形keepa-pool-fulfilment-structure 目录项;offer_fba/offer_fbm 总和+自营计数(求和口径, 非互斥)(构建 KeepaPoolCharts.tsx 121-133)chartCatalog.ts:73+KeepaPoolCharts.tsx:121生效
AC-EL-SRC-KP-009BuyBox类型分布环形(%)三类互斥keepa-pool-buybox-type 目录项;自营/FBA 三方/FBM 三方 百分比(构建 KeepaPoolCharts.tsx 134-149)chartCatalog.ts:74+KeepaPoolCharts.tsx:134生效
AC-EL-SRC-KP-010BuyBox自营锁定程度分布环形(%)自营占比keepa-pool-amazon-lock 目录项;buy_box_is_amazon 计数/总数(构建 KeepaPoolCharts.tsx 150-160)chartCatalog.ts:75+KeepaPoolCharts.tsx:150生效
AC-EL-SRC-KP-011品牌ASIN数量分布柱图(横)品牌 top12keepa-pool-brand-count 目录项;按 brand 计数降序 top12(缺品牌记「未返回」)(构建 KeepaPoolCharts.tsx 161-168)chartCatalog.ts:76+KeepaPoolCharts.tsx:161生效
AC-EL-SRC-KP-012制造商ASIN数量分布柱图(横)厂商 top12keepa-pool-manufacturer-count 目录项;按 manufacturer 计数降序 top12(构建 KeepaPoolCharts.tsx 169-176)chartCatalog.ts:77+KeepaPoolCharts.tsx:169生效
AC-EL-SRC-KP-013父体与子体数量分布柱图子体分桶keepa-pool-parent-count 目录项;按 parent_asin 聚合, 桶 1/3/5/10/20 子体(构建 KeepaPoolCharts.tsx 177-187)chartCatalog.ts:78+KeepaPoolCharts.tsx:177生效
AC-EL-SRC-KP-014类目树矩形图树图类目计数keepa-pool-category-treemap 目录项;sales_rank_reference‖root_category 计数 treemap(构建 KeepaPoolCharts.tsx 188-195)chartCatalog.ts:79+KeepaPoolCharts.tsx:188生效
AC-EL-SRC-KP-015价格×购买量档位散点图散点价×月销档keepa-pool-price-sold 目录项;price_new×monthly_sold, 点=ASIN(构建 KeepaPoolCharts.tsx 196-203)chartCatalog.ts:80+KeepaPoolCharts.tsx:196生效
AC-EL-SRC-KP-016BSR×购买量档位散点图散点BSR×月销档keepa-pool-bsr-sold 目录项;bsr_current×monthly_sold, xInvert(构建 KeepaPoolCharts.tsx 204-211)chartCatalog.ts:81+KeepaPoolCharts.tsx:204生效
AC-EL-SRC-KP-017评论数×购买量档位散点图散点评论×月销档keepa-pool-reviews-sold 目录项;reviews×monthly_sold(构建 KeepaPoolCharts.tsx 212-219)chartCatalog.ts:82+KeepaPoolCharts.tsx:212生效
AC-EL-SRC-KP-018价格×BSR散点图散点价×BSRkeepa-pool-price-bsr 目录项;price_new×bsr_current, yInvert(构建 KeepaPoolCharts.tsx 220-227)chartCatalog.ts:83+KeepaPoolCharts.tsx:220生效
AC-EL-SRC-KP-019评分×购买量档位散点图散点评分×月销档keepa-pool-rating-sold 目录项;rating×monthly_sold(构建 KeepaPoolCharts.tsx 228-235)chartCatalog.ts:84+KeepaPoolCharts.tsx:228生效
AC-EL-SRC-KP-020FBA费/佣金/毛利空间对比柱图(横)毛利空间keepa-pool-fee-headroom 目录项;buy_box−fba_pick_pack_fee−佣金, top12 ASIN(currency)(构建 KeepaPoolCharts.tsx 236-248)chartCatalog.ts:85+KeepaPoolCharts.tsx:236生效
AC-EL-SRC-KP-021缺货率×BuyBox锁定×报价结构矩阵热力3 指标矩阵keepa-pool-oos-buybox-offers 目录项;top12 ASIN × [缺货30,BB自营,总报价](构建 KeepaPoolCharts.tsx 249-260)chartCatalog.ts:86+KeepaPoolCharts.tsx:249生效
AC-EL-SRC-KP-022ASIN×6字段覆盖热力图(Top12)热力覆盖 0/1keepa-pool-coverage-freshness 目录项;题称新鲜度, 实构=6 字段覆盖 0/1(bsr/price/rating/reviews/offers/monthly_sold), 无时间维(构建 KeepaPoolCharts.tsx 261-276)。

2026-10-22 图题对齐:目录题「ASIN×字段覆盖×数据新鲜度热力图」→「ASIN×6字段覆盖热力图(Top12)」(chartCatalog.ts:87),实构未动
chartCatalog.ts:87+KeepaPoolCharts.tsx:261生效
AC-EL-SRC-JT-001SFR×同参考类目Top3 BSR中位数双轴线SFR×BSR 中位joint-sfr-bsr 目录项;SFR 序列 × 每月 Top3 asin bsr_current 中位, 双轴双 invert(构建 JointCharts.tsx :84-105,fieldMap :85-89;死数组 sfrVsKeepa :67-74 不在此图路径。

2026-10-22:死数组已删除,行号平移为构建 :76-97、fieldMap :77-81)
chartCatalog.ts:91+JointCharts.tsx:76生效
AC-EL-SRC-JT-002SFR×Top3购买量档位中位数双轴线SFR×月销中位joint-sfr-sold 目录项;同上, field=monthly_sold(构建 JointCharts.tsx 76-104)chartCatalog.ts:92+JointCharts.tsx:76生效
AC-EL-SRC-JT-003SFR×Top3价格中位数双轴线SFR×价中位joint-sfr-price 目录项;field=price_new(构建 JointCharts.tsx 76-104)chartCatalog.ts:93+JointCharts.tsx:76生效
AC-EL-SRC-JT-004SFR×Top3报价数量双轴线SFR×报价中位joint-sfr-offers 目录项;field=total_offers(构建 JointCharts.tsx 76-104)chartCatalog.ts:94+JointCharts.tsx:76生效
AC-EL-SRC-JT-005SFR×Top3评论数中位双轴线实构存量joint-sfr-review-growth 目录项;题称评论增长, fieldMap 用 reviews 存量中位(非差值)(构建 JointCharts.tsx 76-104)。

2026-10-22 图题对齐:目录题「SFR×Top3评论增长」→「SFR×Top3评论数中位」(chartCatalog.ts:95),实构未动
chartCatalog.ts:95+JointCharts.tsx:76生效
AC-EL-SRC-JT-006SFR×Top3缺货率双轴线SFR×缺货中位joint-sfr-oos 目录项;field=oos_amazon_30(构建 JointCharts.tsx 76-104)chartCatalog.ts:96+JointCharts.tsx:76生效
AC-EL-SRC-JT-007Top1点击份额×同ASIN BSR散点份额×BSRjoint-top1-click-bsr 目录项;asin_1_click_share×该 ASIN bsr_current, yInvert(构建 JointCharts.tsx 98-120)chartCatalog.ts:97+JointCharts.tsx:98生效
AC-EL-SRC-JT-008Top1成交份额×同ASIN BSR散点份额×BSRjoint-top1-conversion-bsr 目录项;asin_1_conv_share×bsr_current(构建 JointCharts.tsx 113-135)chartCatalog.ts:98+JointCharts.tsx:113生效
AC-EL-SRC-JT-009Top1点击份额×同ASIN价格散点实构点击joint-top1-share-price 目录项;题称点击/成交两系, 实构仅点击系渲染(成交点集计算未用)(构建 JointCharts.tsx 128-151)。

2026-10-22 图题对齐:目录题「Top1点击/成交份额×同ASIN价格」→「Top1点击份额×同ASIN价格」(chartCatalog.ts:99),实构未动;ptsConv 死计算已删(渲染不变)
chartCatalog.ts:99+JointCharts.tsx:128生效
AC-EL-SRC-JT-010Top3点击集中度×品牌数散点集中×品牌数joint-concentration-structure 目录项;top3_click_share×当月 Top3 去重品牌数, y 实构仅品牌数(题称含父体数)(构建 JointCharts.tsx 143-166)。

2026-10-22 图题对齐:目录题「Top3点击集中度×品牌数/父体数」→「Top3点击集中度×品牌数」(chartCatalog.ts:100),实构未动
chartCatalog.ts:100+JointCharts.tsx:143生效
AC-EL-SRC-JT-011点击份额×BSR散点全池散点joint-click-bsr 目录项;rotation click_share×bsr_current(构建 JointCharts.tsx 158-178)chartCatalog.ts:101+JointCharts.tsx:158生效
AC-EL-SRC-JT-012成交份额×BSR散点全池散点joint-conversion-bsr 目录项;conv_share×bsr_current(构建 JointCharts.tsx 158-178)chartCatalog.ts:102+JointCharts.tsx:158生效
AC-EL-SRC-JT-013点击份额×购买量档位散点全池散点joint-click-sold 目录项;click_share×monthly_sold(构建 JointCharts.tsx 170-190)chartCatalog.ts:103+JointCharts.tsx:170生效
AC-EL-SRC-JT-014成交份额×购买量档位散点全池散点joint-conversion-sold 目录项;conv_share×monthly_sold(构建 JointCharts.tsx 170-190)chartCatalog.ts:104+JointCharts.tsx:170生效
AC-EL-SRC-JT-015点击份额×价格散点全池散点joint-click-price 目录项;click_share×price_new(yCurrency)(构建 JointCharts.tsx 182-202)chartCatalog.ts:105+JointCharts.tsx:182生效
AC-EL-SRC-JT-016成交份额×价格散点全池散点joint-conversion-price 目录项;conv_share×price_new(构建 JointCharts.tsx 182-202)chartCatalog.ts:106+JointCharts.tsx:182生效
AC-EL-SRC-JT-017点击-成交份额差×评论数散点差×评论joint-gap-reviews 目录项;click−conv 差×reviews(构建 JointCharts.tsx 194-215)chartCatalog.ts:107+JointCharts.tsx:194生效
AC-EL-SRC-JT-018点击-成交份额差×评分散点差×评分joint-gap-rating 目录项;click−conv 差×rating(构建 JointCharts.tsx 207-228)chartCatalog.ts:108+JointCharts.tsx:207生效
AC-EL-SRC-JT-019ABA份额×BuyBox持有结构堆叠(%)份额×持有joint-share-buybox 目录项;(自营数/3)×top3_click_share 三系百分比堆叠(构建 JointCharts.tsx 220-253)chartCatalog.ts:109+JointCharts.tsx:220生效
AC-EL-SRC-JT-020ABA份额×缺货率双轴线份额×缺货joint-share-oos 目录项;top3 份额 × 当月 Top3 oos30 中位(构建 JointCharts.tsx 245-266)chartCatalog.ts:110+JointCharts.tsx:245生效
AC-EL-SRC-JT-021ABA份额变化×价格变化双轴线相邻月差joint-share-change-price 目录项;top3 份额差 × price_new 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:111+JointCharts.tsx:258生效
AC-EL-SRC-JT-022ABA份额变化×BSR变化双轴线相邻月差joint-share-change-bsr 目录项;bsr_current 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:112+JointCharts.tsx:258生效
AC-EL-SRC-JT-023ABA份额变化×购买量档位变化双轴线相邻月差joint-share-change-sold 目录项;monthly_sold 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:113+JointCharts.tsx:258生效
AC-EL-SRC-JT-024ABA份额变化×评论增长双轴线相邻月差joint-share-change-reviews 目录项;reviews 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:114+JointCharts.tsx:258生效
AC-EL-SRC-JT-025ABA份额变化×报价数量变化双轴线相邻月差joint-share-change-offers 目录项;total_offers 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:115+JointCharts.tsx:258生效
AC-EL-SRC-JT-026ASIN进入Top3前后事件图事件图进入事件joint-entry-event 目录项;first_period 进入标记; last≠first 加「最后上榜」(构建 JointCharts.tsx 292-314)chartCatalog.ts:116+JointCharts.tsx:292生效
AC-EL-SRC-JT-027ASIN退出Top3前后事件图事件图退出事件joint-exit-event 目录项;last_period≠末月 → 退出事件(构建 JointCharts.tsx 306-323)chartCatalog.ts:117+JointCharts.tsx:306生效
AC-EL-SRC-JT-028促销/降价/BuyBox换手叠加ABA份额双轴线BuyBox 近似joint-promotion-overlay 目录项;无促销数据, 用当月自营 BuyBox 计数近似(:324 注释)(构建 JointCharts.tsx 315-335)chartCatalog.ts:118+JointCharts.tsx:315生效
AC-EL-SRC-JT-029月份间Top1/2/3席位流转桑基图桑基席位流转joint-slot-sankey 目录项;相邻月席位变化; 反向边防环+links≤80 上限(构建 JointCharts.tsx 327-368)chartCatalog.ts:119+JointCharts.tsx:327生效
AC-EL-SRC-JT-030选定月份ASIN证据矩阵热力末月证据joint-evidence-matrix 目录项;末个 available 月 Top≤10 ASIN × 7 字段(BSR/月销/价格/评分×100/评论/FBA/FBM)(构建 JointCharts.tsx 360-389)chartCatalog.ts:120+JointCharts.tsx:360生效
AC-EL-SRC-JT-031ABA×Keepa相关性与领先滞后矩阵热力lag 相关系数joint-correlation-lag 目录项;5 字段 × lag0/1/2 皮尔逊 r, n≥3 才算(构建 JointCharts.tsx 381-420)chartCatalog.ts:121+JointCharts.tsx:381生效
AC-EL-SRC-JT-032ABA月份×Keepa观察时间×字段覆盖热力图热力覆盖数joint-observation-coverage 目录项;月份 × rot≤10 ASIN 的 5 字段覆盖数(0-5)(构建 JointCharts.tsx 412-440)chartCatalog.ts:122+JointCharts.tsx:412生效
AC-EL-SRC-JT-033品牌Top3席位分布与垄断度环形席位加权joint-brand-seat-share 目录项;按 brand 累加 appearances, top12(构建 JointCharts.tsx 432-451)chartCatalog.ts:123+JointCharts.tsx:432生效
AC-EL-SRC-JT-034品牌×月份Top3席位堆叠堆叠品牌×月joint-brand-month-stack 目录项;top12 品牌每月 Top3 席位计数堆叠(构建 JointCharts.tsx 443-464)chartCatalog.ts:124+JointCharts.tsx:443生效

§11.40 站外推广子组件列级(/offsitepromotion · AC-EL-OFC 系列,源码 web/app/offsitepromotion/{InboxTab,OverviewTab,SegmentsTab,ResourcesTab,RedditTab,ProjectsTab,LibraryTab,TemplatesTab,MailboxesTab,SendTasksTab,TasksTab}.tsx)

§11.37 面板级 65 条(OFF-001..065)之列级深化:11 子组件+InboxTab 面板内部逐元素建档——每列一条(表头原文+渲染口径)、每端点一条(方法+路径+载荷/响应字段)、每交互元素一条;行号以 2026-10-22 源码为准(LibraryTab 405/TemplatesTab 266/MailboxesTab 264/SendTasksTab 245/TasksTab 333 行,含末空行口径)。两个建档 fork(cw-off1=139:INB63/OVR14/SEG21/RES20/RDT21;cw-off2=307:PRJ64/LIB59/TPL34/MBX30/SND39/TSK81)+ 独立只读校对 fork 核验。OFF-053/064 挂账据此清账。

§11.40 站外推广子组件·列级/元素级·收件工作台 InboxTab(/offsitepromotion · AC-EL-OFC-INB 系列,源码 web/app/offsitepromotion/InboxTab.tsx)

收件工作台=待处理队列卡+会话弹层+规则弹层三块(容器 :80/:178-184/:319-323);队列数据 GET /api/promotion/inbox(:65,chips 查询串+page+page_size=20),存在未处理件时 15s 轮询(:70-75);会话/档案/模板 thread/kol-profile/email-templates 三 GET(:146/:148/:154)+ 认领/改类/标已处理/原箱回复四 POST(:209/:218/:221/:170);规则包 CRUD 四端点(:288/:297/:307/:315)。分类标签映射 CLS_LABELS(:34-37)、色调 CLS_TONE(:38-41)为标签/徽章统一事实源。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-INB-001待处理回复卡头容器队列卡标题h2「待处理回复」+sub「IMAP 每 10 分钟拉取 · 规则引擎自动分类 · 复核/认领/回复」;InboxTab.tsx:82InboxTab.tsx:82 读源断言标题与 sub 文案逐字生效
AC-EL-OFC-INB-002待处理队列加载端点队列列表数据源GET /api/promotion/inbox?{chip.q}&page={page}&page_size=20→{total,items};chip 切换或翻页即重载;存在 !handled 件时 setInterval 15s 轮询(worker 每 10 分钟拉收信);InboxTab.tsx:64-69,70-75InboxTab.tsx:65 读源断言查询串拼装与 page_size=20、:73 轮询 15000ms生效
AC-EL-OFC-INB-003分类中文标签映射标签分类码→中文CLS_LABELS:dsn=退信/agree=同意合作/sample=索要样品/quote=索要报价/decline=拒绝合作/irrelevant=无关/manual_review=待人工;未知码原样显示;InboxTab.tsx:34-37InboxTab.tsx:34-37 读源比对 7 组映射生效
AC-EL-OFC-INB-004分类徽章色调映射标签分类徽章配色CLS_TONE:dsn=bad/agree·sample·quote=ok/decline·manual_review=warn/irrelevant=dim;InboxTab.tsx:38-41InboxTab.tsx:38-41 读源比对色调表生效
AC-EL-OFC-INB-005队列筛选 chip 组选择器9 枚单选筛选CHIPS 逐项:待人工 classified=manual_review&handled=0、未匹配 matched=0&handled=0、同意合作 classified=agree&handled=0、索要样品 classified=sample&handled=0、索要报价 classified=quote&handled=0、拒绝合作 classified=decline&handled=0、退信 classified=dsn、无关 classified=irrelevant、全部 q="";选中态 class on,切换重置回第 1 页;InboxTab.tsx:42-52,84-87InboxTab.tsx:42-52 读源比对 9 项 label+q 逐字生效
AC-EL-OFC-INB-006分类规则入口按钮按钮打开规则弹层「分类规则」ghost sm 按钮→setRulesOpen(true) 渲染 RulesModal;InboxTab.tsx:89InboxTab.tsx:89 读源断言按钮文案与开关行为生效
AC-EL-OFC-INB-007队列列·发件人列表头「发件人」单元格 m.from,空显「—」;InboxTab.tsx:94,101InboxTab.tsx:94,101 读源断言表头原文与空值兜底生效
AC-EL-OFC-INB-008队列列·主题列表头「主题」单元格 m.subject,空显「(无主题)」;InboxTab.tsx:94,102InboxTab.tsx:94,102 读源断言表头与空值文案生效
AC-EL-OFC-INB-009队列列·分类列表头「分类」badge 类名=CLS_TONE[classified_as]||dim,文本=CLS_LABELS[classified_as]||原码;InboxTab.tsx:94,103-104InboxTab.tsx:103-104 读源断言双 fallback 链生效
AC-EL-OFC-INB-010队列列·置信度列表头「置信度」num 列,confidence!=null 显 toFixed(2) 两位小数,否则「—」;InboxTab.tsx:94,105InboxTab.tsx:105 读源断言 toFixed(2) 与空值生效
AC-EL-OFC-INB-011队列列·达人列表头「达人」三级显示:kol_name → kol_id 显「#id」→ badge warn「未匹配」;InboxTab.tsx:94,106-107InboxTab.tsx:106-107 读源断言三级 fallback生效
AC-EL-OFC-INB-012队列列·时间列表头「时间」received_at 截前 16 位、T 换空格(YYYY-MM-DD HH:mm),空显「—」;InboxTab.tsx:94,108InboxTab.tsx:108 读源断言 slice(0,16)+replace生效
AC-EL-OFC-INB-013队列列·状态列表头「状态」handled 显「已处理」否则「待处理」;未处理整行 fontWeight 600 加粗;InboxTab.tsx:94,100,109InboxTab.tsx:100,109 读源断言文案与加粗条件生效
AC-EL-OFC-INB-014队列行选中按钮行点击开会话tr onClick=setId 选中行背景 var(--bg2,#f6f7f9)、cursor pointer;选中后渲染 ThreadPanel;InboxTab.tsx:98-100,127InboxTab.tsx:98-99 读源断言选中样式与 setSel生效
AC-EL-OFC-INB-015队列空态空态队列为空行items 空数组时 colSpan 7 居中行「队列为空(worker 每 10 分钟拉取未读邮件,未匹配/置信度不足的会进「待人工」)」;InboxTab.tsx:112-115InboxTab.tsx:113-114 读源断言空态文案逐字生效
AC-EL-OFC-INB-016队列加载态空态加载占位行items==null 时 colSpan 7 居中「加载中…」;InboxTab.tsx:116InboxTab.tsx:116 读源断言加载占位生效
AC-EL-OFC-INB-017队列分页计数标签pager 计数「共 {int(total)} 封 · 第 {page} / {pages} 页」,pages=ceil(total/20) 下限 1;InboxTab.tsx:77,120-121InboxTab.tsx:77,121 读源断言计数式生效
AC-EL-OFC-INB-018队列翻页按钮按钮上一页/下一页page≤1 禁用上一页、page≥pages 禁用下一页;InboxTab.tsx:122-123InboxTab.tsx:122-123 读源断言双侧 disabled 边界生效
AC-EL-OFC-INB-019会话弹层容器容器ThreadPanel 弹层fixed 遮罩 rgba(16,20,26,.45) 点遮罩关闭(内层 stopPropagation);卡宽 min(1100px,96vw) 双栏 1fr+250px(会话/回复左、档案右);标题「会话视图」+sub「邮件 #{mid} · 全部往来挂达人档案」;InboxTab.tsx:178-186InboxTab.tsx:179-186 读源断言遮罩关闭与双栏结构生效
AC-EL-OFC-INB-020会话线程加载端点thread 数据源GET /api/promotion/inbox/{mid}/thread→{kol_id,items};InboxTab.tsx:145-152InboxTab.tsx:146 读源断言路径与响应字段生效
AC-EL-OFC-INB-021达人档案加载端点profile 数据源GET /api/promotion/inbox/kol/{kol_id}/profile,仅 thread 响应 kol_id 非空时请求,失败置 null 不报错;InboxTab.tsx:147-149InboxTab.tsx:147-149 读源断言条件请求与静默失败生效
AC-EL-OFC-INB-022模板列表加载端点回复模板下拉源GET /api/promotion/email-templates→{items}(弹层挂载时一次),失败静默;InboxTab.tsx:153-155InboxTab.tsx:154 读源断言路径与静默 catch生效
AC-EL-OFC-INB-023会话气泡流容器往来消息列表direction=out 右对齐底色 var(--ok-bg,#e8f5ee),其余左对齐 var(--bg2,#f1f3f6);气泡头行=「我方/发件人 · 时间 · 分类中文」;主体主题+正文(pre-wrap);空线程显「无记录」;InboxTab.tsx:187-201InboxTab.tsx:188-200 读源断言双底色与头行拼接生效
AC-EL-OFC-INB-024认领达人输入输入未匹配认领框条件渲染 data.kol_id==null;input placeholder「认领达人ID」maxWidth 130;InboxTab.tsx:203-207InboxTab.tsx:203-207 读源断言条件与 placeholder生效
AC-EL-OFC-INB-025认领按钮按钮绑定达人「认领」busy 或 ID 空白禁用;成功 toast「已执行」并刷新线程+队列;InboxTab.tsx:208-209InboxTab.tsx:208-209 读源断言 disabled 条件生效
AC-EL-OFC-INB-026认领提交端点claim 通道POST /api/promotion/inbox/{mid}/claim body {kol_id:Number(claimId)};InboxTab.tsx:209InboxTab.tsx:209 读源断言路径与数值化载荷生效
AC-EL-OFC-INB-027复核改类选择器选择器改类下拉首项「复核改类…」(值空)+CLS_LABELS 全 7 类选项;InboxTab.tsx:213-216InboxTab.tsx:213-216 读源断言 8 项选项生效
AC-EL-OFC-INB-028改类并结单按钮按钮提交改类「改类并结单」busy 或未选类禁用,成功后清空选择;InboxTab.tsx:217-219InboxTab.tsx:217-219 读源断言 disabled 与 setCls("")生效
AC-EL-OFC-INB-029改类提交端点classify 通道POST /api/promotion/inbox/{mid}/classify body {classified_as:cls};InboxTab.tsx:218InboxTab.tsx:218 读源断言路径与载荷生效
AC-EL-OFC-INB-030标已处理按钮按钮人工结单「标已处理」ghost sm,仅 busy 禁用;InboxTab.tsx:220-221InboxTab.tsx:220-221 读源断言文案与禁用条件生效
AC-EL-OFC-INB-031标已处理提交端点handled 通道POST /api/promotion/inbox/{mid}/handled body {handled:true};InboxTab.tsx:221InboxTab.tsx:221 读源断言路径与载荷生效
AC-EL-OFC-INB-032从原箱回复卡容器回复表单卡内嵌卡 h2「从原箱回复」,含模板下拉+主题输入+正文 textarea+发送/关闭;InboxTab.tsx:224-242InboxTab.tsx:224-242 读源断言卡结构与标题生效
AC-EL-OFC-INB-033回复模板选择器选择器模板/手写首项「手写」(值空)+email-templates 全列 name;选模板后正文 placeholder 变「选模板后发送时按达人变量渲染」;InboxTab.tsx:227-230,235InboxTab.tsx:227-230 读源断言选项来源与首项生效
AC-EL-OFC-INB-034回复主题输入输入邮件主题placeholder「主题(空=Re: 原主题)」,提交时 trim;InboxTab.tsx:231-232,171InboxTab.tsx:231 读源断言 placeholder 与空语义生效
AC-EL-OFC-INB-035回复正文输入输入textarea 正文minHeight 90,placeholder 手写态「回复正文…」;空正文提交被拦「正文不能为空」;InboxTab.tsx:234-236,167InboxTab.tsx:234-236 读源断言 placeholder 与前置校验生效
AC-EL-OFC-INB-036发送回复按钮按钮原箱发送「发送回复」busy 显「发送中…」;busy 或正文空禁用;成功 toast「已从原箱回复」并清空主题/正文、刷新;InboxTab.tsx:237-239,173InboxTab.tsx:238-239 读源断言 busy 文案与清空行为生效
AC-EL-OFC-INB-037回复提交端点reply 通道POST /api/promotion/inbox/{mid}/reply body {template_id:tplId?Number:null, subject:trim, body};InboxTab.tsx:166-176InboxTab.tsx:170-172 读源断言路径与三字段载荷生效
AC-EL-OFC-INB-038会话关闭按钮按钮关 ThreadPanel「关闭」ghost sm→onClose 清选中;InboxTab.tsx:240InboxTab.tsx:240 读源断言关闭行为生效
AC-EL-OFC-INB-039达人档案侧栏容器右侧档案栏标题「达人档案」;profile 空显「未匹配邮件无档案;认领后显示。」;InboxTab.tsx:245-272InboxTab.tsx:246,271 读源断言标题与空档案文案生效
AC-EL-OFC-INB-040档案·名/平台/粉丝标签档案头name 加粗 + platform,subscribers 非空追加「 · N 粉」(int 千分位);InboxTab.tsx:249-252InboxTab.tsx:249-252 读源断言拼接式生效
AC-EL-OFC-INB-041档案·邮箱/抑制标签联系方式行email||「无邮箱」,suppression=true 追加「 · 已抑制」;InboxTab.tsx:253-254InboxTab.tsx:253-254 读源断言兜底与抑制后缀生效
AC-EL-OFC-INB-042档案·回复状态/触达标签触达摘要行「回复状态:{reply_status||—} · 最近触达 {last_contacted_at 前 10 位||—}」;InboxTab.tsx:255-257InboxTab.tsx:256 读源断言文案式生效
AC-EL-OFC-INB-043档案·标签徽章标签tags 徽章列tags 前 12 枚 badge dim(字号 11),空显「无标签」;InboxTab.tsx:258-262InboxTab.tsx:259-261 读源断言 slice(0,12) 与空态生效
AC-EL-OFC-INB-044档案·发送历史标签历史任务列表标题「发送历史」;逐行「{task_name||任务#id} · {status} · {sent_at 前 10 位}」,sent_at 空省略;空显「无」;InboxTab.tsx:263-269InboxTab.tsx:264-268 读源断言行式与空态生效
AC-EL-OFC-INB-045规则包列表加载端点规则表数据源GET /api/promotion/classify-rules→{items},失败 toast 报错;InboxTab.tsx:287-291InboxTab.tsx:288 读源断言路径生效
AC-EL-OFC-INB-046规则列·优先级列表头「优先级」右对齐 num,数值原样;数字越小越先匹配;InboxTab.tsx:327,331InboxTab.tsx:327,331 读源断言表头与对齐生效
AC-EL-OFC-INB-047规则列·分类列表头「分类」badge 同队列分类列(CLS_TONE/CLS_LABELS+原码 fallback);InboxTab.tsx:327,332-333InboxTab.tsx:332-333 读源断言复用映射生效
AC-EL-OFC-INB-048规则列·类型列表头「类型」kind=regex 显「正则」否则「关键词」;InboxTab.tsx:327,334InboxTab.tsx:334 读源断言二值映射生效
AC-EL-OFC-INB-049规则列·词/正则列表头「词 / 正则」pattern 文本 maxWidth 260、title 悬浮全文;InboxTab.tsx:327,335InboxTab.tsx:335 读源断言 title 属性生效
AC-EL-OFC-INB-050规则列·状态列表头「状态」enabled 显「启用」否则「停用」;InboxTab.tsx:327,336InboxTab.tsx:336 读源断言二值文案生效
AC-EL-OFC-INB-051规则列·操作列表头「操作」启停切换按钮(文本随 enabled「停用/启用」)+「删除」按钮;InboxTab.tsx:327,337-340InboxTab.tsx:338-339 读源断言双按钮与切换文案生效
AC-EL-OFC-INB-052规则新增提交端点建规则通道POST /api/promotion/classify-rules body {priority:Number||100, classified_as, kind, pattern:trim, enabled:true};pattern 空被拦「词或正则不能为空」;InboxTab.tsx:293-304InboxTab.tsx:294-300 读源断言载荷与前置校验生效
AC-EL-OFC-INB-053规则·优先级输入输入新增优先级number 输入默认「100」,title「数字越小越先匹配」maxWidth 80;InboxTab.tsx:281,348-349InboxTab.tsx:348-349 读源断言默认值与 title生效
AC-EL-OFC-INB-054规则·分类选择器选择器新增分类6 选项:同意合作/索要样品/索要报价/拒绝合作/无关/退信(无 manual_review;规则匹配口径「无命中进『待人工』」见 :324);InboxTab.tsx:350-353InboxTab.tsx:351-352 读源断言 6 键枚举生效
AC-EL-OFC-INB-055规则·类型选择器选择器关键词/正则二选项 keyword=关键词/regex=正则;InboxTab.tsx:354-357InboxTab.tsx:355-356 读源断言二值生效
AC-EL-OFC-INB-056规则·pattern 输入输入词/正则输入placeholder「关键词或正则(正则须能编译)」;InboxTab.tsx:358-359InboxTab.tsx:359 读源断言 placeholder 逐字生效
AC-EL-OFC-INB-057规则·新增按钮按钮提交建规则「新增」busy 禁用,成功 toast「规则已加」并清空 pattern 刷新表;InboxTab.tsx:360,301InboxTab.tsx:360 读源断言文案与刷新链生效
AC-EL-OFC-INB-058规则启停提交端点改规则通道PUT /api/promotion/classify-rules/{id} body 全量 {priority, classified_as, kind, pattern, enabled:!原值};InboxTab.tsx:305-313InboxTab.tsx:307-310 读源断言全量载荷与翻转生效
AC-EL-OFC-INB-059规则启停按钮按钮启停切换文本随 enabled 显「停用/启用」ghost sm;InboxTab.tsx:338InboxTab.tsx:338 读源断言切换文案生效
AC-EL-OFC-INB-060规则删除提交端点删规则通道DELETE /api/promotion/classify-rules/{rid}(无 body),成功 toast「已删除」;InboxTab.tsx:314-317InboxTab.tsx:315 读源断言 DELETE 与无载荷生效
AC-EL-OFC-INB-061规则删除按钮按钮行内删除「删除」ghost sm,无二次确认(直接 DELETE);InboxTab.tsx:339InboxTab.tsx:339 读源断言无确认直删生效
AC-EL-OFC-INB-062规则加载态空态规则表占位items==null 时 colSpan 6「加载中…」;InboxTab.tsx:343InboxTab.tsx:343 读源断言占位生效
AC-EL-OFC-INB-063规则关闭按钮按钮关规则弹层「关闭」ghost sm→onClose;规则弹层卡宽 min(760px,94vw);InboxTab.tsx:322-323,361InboxTab.tsx:361 读源断言关闭行为生效

§11.40 站外推广子组件·列级/元素级·总览 OverviewTab(/offsitepromotion · AC-EL-OFC-OVR 系列,源码 web/app/offsitepromotion/OverviewTab.tsx)

总览=7 KPI 卡+渠道分布条形+两张说明卡;数字唯一源 GET /api/promotion/kol-stats(:32,邮箱三层口径:rows_total 含抑制/unique_emails 去重/personal_emails 扣公共角色邮箱),facets 自 kol-library?suppression=all&page_size=1(:30),渠道字典计数自 channel-dict(:34);未知/未上线一律显「—」不以 0 充数(:6 注释约束)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-OVR-001facets 加载端点渠道/类目 facet 源GET /api/promotion/kol-library?suppression=all&page_size=1 只取 facets;OverviewTab.tsx:29-31OverviewTab.tsx:30-31 读源断言仅取 facets生效
AC-EL-OFC-OVR-002统计加载端点KPI 数字唯一源GET /api/promotion/kol-stats→Stats 9 字段(rows_total/rows_with_email/unique_emails/role_emails/personal_emails/deal_kol_rows/deal_kol_emails/deal_channel_sites/deal_reddit_posters);OverviewTab.tsx:32-33,16-21OverviewTab.tsx:32-33 读源断言 9 字段消费生效
AC-EL-OFC-OVR-003渠道字典加载端点字典登记数GET /api/promotion/channel-dict 取 items.length,失败静默(脚注显「—」);OverviewTab.tsx:34-35OverviewTab.tsx:34-35 读源断言 length 与静默生效
AC-EL-OFC-OVR-004错误条容器API 失败提示err 非空显 div.error role=alert;OverviewTab.tsx:47OverviewTab.tsx:47 读源断言条件渲染生效
AC-EL-OFC-OVR-005KPI·达人总数标签库规模卡k-value=int(rows_total),未载显「—」;k-foot「租户达人库 · 含抑制名单」;OverviewTab.tsx:49-53OverviewTab.tsx:50-52 读源断言取值与脚注生效
AC-EL-OFC-OVR-006KPI·唯一收件邮箱标签去重邮箱卡值=unique_emails;foot「带邮箱记录 N 行 · 去重 P%」,P=round((1−unique/rows_with_email)×100)(分母 0 显「—」);OverviewTab.tsx:54-58,40-41OverviewTab.tsx:57,40-41 读源断言去重式与零分母兜底生效
AC-EL-OFC-OVR-007KPI·个人邮箱标签有效外联量卡值=personal_emails;foot「扣除公共/角色邮箱 N(info@/press@/noreply@ 等,占 Q%)」,Q=round(role/unique×100);OverviewTab.tsx:59-63,42-43OverviewTab.tsx:62,42-43 读源断言占比式生效
AC-EL-OFC-OVR-008KPI·Deal 资源标签deal 邮箱卡值=deal_kol_emails;foot「达人库 deal 类 N 行 · deal站 N · Reddit poster N」三子数;OverviewTab.tsx:64-68OverviewTab.tsx:66-67 读源断言三子数来源生效
AC-EL-OFC-OVR-009KPI·覆盖渠道标签平台数卡值=facets.platforms.length;foot「字典登记 N 项」(channel-dict 计数);OverviewTab.tsx:69-73OverviewTab.tsx:71-72 读源断言双来源生效
AC-EL-OFC-OVR-010KPI·自定义类目标签类目数卡值=categories.length;foot「已打标 Σcount 人次」;OverviewTab.tsx:74-78OverviewTab.tsx:76-77 读源断言 reduce 求和生效
AC-EL-OFC-OVR-011KPI·外联漏斗占位标签未上线卡值恒「—」(fontSize 19);foot「发送/回复/意向 P2 邮件基建投用后接入」;OverviewTab.tsx:79-83OverviewTab.tsx:80-82 读源断言恒「—」不上 0生效
AC-EL-OFC-OVR-012达人渠道分布条形图表Top12 CSS 条形h2「达人渠道分布」sub「Top 12 · 租户达人库现场聚合」;逐行 label||value/条宽 round(count/maxCount×100)% 下限 3/int(count);facets 空显「加载中…」、零行显「暂无数据」;CSS div 实现非 ECharts;OverviewTab.tsx:86-103,38-39OverviewTab.tsx:91-99 读源断言条宽式与下限 3生效
AC-EL-OFC-OVR-013Deal 资源怎么找卡容器三口径指引h2「Deal 资源怎么找」sub「三处口径 · 分别进入对应 tab 筛选」;正文 ①达人库 tab ②渠道库 ③Reddit 专库 三条路径文案;OverviewTab.tsx:105-112OverviewTab.tsx:107-111 读源断言三路径文案逐字生效
AC-EL-OFC-OVR-014待上线模块卡容器P2/P3 范围声明h2「待上线模块」;正文声明邮件外联/收件工作台/邮箱设置=P2 代码已就绪待投用、自动跟进与归因=P3、上线前显「—」不以 0 充数;OverviewTab.tsx:114-120OverviewTab.tsx:116-119 读源断言范围声明生效

§11.40 站外推广子组件·列级/元素级·分群 SegmentsTab(/offsitepromotion · AC-EL-OFC-SEG 系列,源码 web/app/offsitepromotion/SegmentsTab.tsx)

分群=筛选条件→POST 存 kol_id 快照;条件键与 kol-library 筛选同名(platforms/countries/cat_ids/contact/fmin/fmax,:4);facet 源 kol-library?page=1&page_size=1(:60);h2 sub「达人 ID 快照 · 发送时仍实时查 suppression + 30 天冷却」(:92)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-SEG-001分群列表加载端点分群表数据源GET /api/promotion/segments→{items},失败写入 error 条;SegmentsTab.tsx:53-58SegmentsTab.tsx:54-56 读源断言路径与错误通路生效
AC-EL-OFC-SEG-002分群 facet 加载端点条件 chip 源GET /api/promotion/kol-library?page=1&page_size=1 只取 facets,失败静默;SegmentsTab.tsx:59-62SegmentsTab.tsx:60-61 读源断言仅 facets生效
AC-EL-OFC-SEG-003分群名输入输入新建分群名placeholder「分群名」maxWidth 160,空名提交被拦「分群名必填」;SegmentsTab.tsx:95,67SegmentsTab.tsx:95 读源断言 placeholder 与必填生效
AC-EL-OFC-SEG-004渠道 chip 多选按钮platforms 条件facets.platforms 前 20 枚圆角 chip,文本「{label}({count})」,点击 toggle 选中态 on;SegmentsTab.tsx:96-102SegmentsTab.tsx:97-100 读源断言 slice(0,20) 与 toggle生效
AC-EL-OFC-SEG-005国家 chip 多选按钮countries 条件facets.countries 前 30 枚 chip,空值显「(空)」;SegmentsTab.tsx:104-111SegmentsTab.tsx:107-110 读源断言 slice(0,30) 与空值标签生效
AC-EL-OFC-SEG-006类目 chip 多选按钮cat_ids 条件facets.categories 全量 chip「{name}({count})」;SegmentsTab.tsx:112-116SegmentsTab.tsx:112-116 读源断言全量渲染生效
AC-EL-OFC-SEG-007联系方式选择器选择器contact 条件默认 email;选项「联系方式不限」+4 项:有邮箱/IM(无邮箱)/社交(无邮箱)/仅官网/无联系方式(CONTACT_LABELS);SegmentsTab.tsx:48,120-123,20-23SegmentsTab.tsx:120-123 读源断言默认值与 5 选项生效
AC-EL-OFC-SEG-008粉丝下限输入输入fmin 条件number 输入 placeholder「粉丝下限」maxWidth 110,空不进 criteria;SegmentsTab.tsx:124,75SegmentsTab.tsx:124 读源断言 placeholder 与可选生效
AC-EL-OFC-SEG-009粉丝上限输入输入fmax 条件number 输入 placeholder「粉丝上限」maxWidth 110;SegmentsTab.tsx:125,76SegmentsTab.tsx:125 读源断言 placeholder生效
AC-EL-OFC-SEG-010建分群按钮按钮提交创建「按条件建分群」busy 显「创建中…」;成功 toast「分群已创建:N 位达人」并清名刷新+onChanged 回调;SegmentsTab.tsx:126,79-80SegmentsTab.tsx:126,79-80 读源断言 busy 文案与回调链生效
AC-EL-OFC-SEG-011建分群提交端点创建通道POST /api/promotion/segments body {name:trim, criteria};criteria 仅收非空键:platforms/countries/cat_ids 逗号串、contact、fmin/fmax 数值(:70-76)→响应 {id,kol_count};SegmentsTab.tsx:66-82SegmentsTab.tsx:70-78 读源断言条件组装与响应消费生效
AC-EL-OFC-SEG-012成员口径说明标签建群脚注「成员 = 当前条件下有任一联系方式的达人;无邮箱者在发送时自动跳过」;SegmentsTab.tsx:127SegmentsTab.tsx:127 读源断言脚注逐字生效
AC-EL-OFC-SEG-013分群列·分群列表头「分群」单元格 name 加粗;SegmentsTab.tsx:132,136SegmentsTab.tsx:132,136 读源断言表头与样式生效
AC-EL-OFC-SEG-014分群列·筛选条件列表头「筛选条件」criteriaSummary(:25-36):渠道/国家/类目 #id/源类目/标签/联系式标签/粉丝≥≤ 空格点接,全空显「空条件(全库)」;SegmentsTab.tsx:132,137SegmentsTab.tsx:137,25-36 读源断言摘要式与全库文案生效
AC-EL-OFC-SEG-015分群列·成员数列表头「成员数」右对齐 num 显 member_n(快照人数)而非 kol_count(建群时点数);SegmentsTab.tsx:132,138SegmentsTab.tsx:138 读源断言取 member_n生效
AC-EL-OFC-SEG-016分群列·创建时间列表头「创建时间」created_at 原样;SegmentsTab.tsx:132,139SegmentsTab.tsx:139 读源断言原样显示生效
AC-EL-OFC-SEG-017分群列·操作列表头「操作」「删除」ghost sm 按钮;SegmentsTab.tsx:132,140SegmentsTab.tsx:140 读源断言按钮生效
AC-EL-OFC-SEG-018删除分群按钮按钮危险确认删除useConfirm 危险框「删除分群」「「{名}」?引用它的发送任务将无法取人。」确认才发;成功 toast「已删除」;SegmentsTab.tsx:84-88SegmentsTab.tsx:85 读源断言确认文案与 danger生效
AC-EL-OFC-SEG-019删除分群提交端点删除通道DELETE /api/promotion/segments/{sid}(无 body)+onChanged 回调;SegmentsTab.tsx:86SegmentsTab.tsx:86 读源断言 DELETE 与回调生效
AC-EL-OFC-SEG-020分群空态空态暂无分群行items 空数组 colSpan 5「暂无分群」;SegmentsTab.tsx:143SegmentsTab.tsx:143 读源断言空态文案生效
AC-EL-OFC-SEG-021分群加载态空态加载占位行items==null colSpan 5「加载中…」;SegmentsTab.tsx:144SegmentsTab.tsx:144 读源断言占位生效

§11.40 站外推广子组件·列级/元素级·资源 ResourcesTab(/offsitepromotion · AC-EL-OFC-RES 系列,源码 web/app/offsitepromotion/ResourcesTab.tsx,导出名 ResourcesPanel)

全部资源=渠道站+达人合库浏览;数据 GET /api/promotion/resources?rtype&platform&category&country&q&page&page_size=20(:30-32)带 facets 三组;列表按粉丝降序(h2 sub 声明 :46);筛选变更即重载且重置回第 1 页。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-RES-001资源列表加载端点合库数据源GET /api/promotion/resources 七参数(rtype/platform/category/country/q/page/page_size=20),平台/类目/国家/q 均 encodeURIComponent;失败置 null 显 Spinner;ResourcesTab.tsx:28-35ResourcesTab.tsx:30-33 读源断言参数拼装生效
AC-EL-OFC-RES-002资源卡头计数标签h2 动态总数「全部资源」sub「渠道站 + 达人 · 共 {int(total)} 条 · 按粉丝降序」,未载 total=undefined 显 0;ResourcesTab.tsx:46ResourcesTab.tsx:46 读源断言计数式生效
AC-EL-OFC-RES-003类型 tab 组选择器rtype 三选全部("")/渠道站(channel)/达人(kol),选中 on,切换回第 1 页;ResourcesTab.tsx:48-51ResourcesTab.tsx:48-51 读源断言三值生效
AC-EL-OFC-RES-004平台选择器选择器platform 筛选首项「全部平台」+facets.platforms「{value}({count})」,「(空)」值映射回 "";ResourcesTab.tsx:52-55ResourcesTab.tsx:54 读源断言空值映射生效
AC-EL-OFC-RES-005类目选择器选择器category 筛选首项「全部类目」+facets.categories,同空值映射;ResourcesTab.tsx:56-59ResourcesTab.tsx:58 读源断言选项源生效
AC-EL-OFC-RES-006国家选择器选择器country 筛选首项「全部国家」+facets.countries,同空值映射;ResourcesTab.tsx:60-63ResourcesTab.tsx:62 读源断言选项源生效
AC-EL-OFC-RES-007搜索输入输入q 名称/邮箱placeholder「搜索名称 / 邮箱」maxWidth 220,输入即筛(无防抖)且回第 1 页;ResourcesTab.tsx:64-65ResourcesTab.tsx:64-65 读源断言即时筛选生效
AC-EL-OFC-RES-008重置按钮按钮清全部筛选「重置」→rtype/platform/category/country/q 全清+回第 1 页;ResourcesTab.tsx:40-42,66ResourcesTab.tsx:41,66 读源断言五态清零生效
AC-EL-OFC-RES-009加载态空态Spinnerdata==null 显 Spinner 组件(每次筛选变更先置 null);ResourcesTab.tsx:29,69ResourcesTab.tsx:29,69 读源断言先清后载生效
AC-EL-OFC-RES-010无匹配空态空态EmptyStateitems 空显 EmptyState title「无匹配资源」hint「调整筛选条件」;ResourcesTab.tsx:70ResourcesTab.tsx:70 读源断言双文案生效
AC-EL-OFC-RES-011资源列·资源列表头「资源」name 单行省略 maxWidth 240;source_url 非空渲染 a 外链(新窗 noreferrer 品牌色)否则纯文本;ResourcesTab.tsx:75,81-83ResourcesTab.tsx:81-83 读源断言条件外链生效
AC-EL-OFC-RES-012资源列·类型列表头「类型」chip:rtype=kol 显「达人」(默认色)否则「渠道站」(dim);ResourcesTab.tsx:75,84ResourcesTab.tsx:84 读源断言二值与配色生效
AC-EL-OFC-RES-013资源列·平台列表头「平台」muted 显 platform,空「—」;ResourcesTab.tsx:75,85ResourcesTab.tsx:85 读源断言空值兜底生效
AC-EL-OFC-RES-014资源列·类目列表头「类目」t2 单行省略 maxWidth 140,空「—」;ResourcesTab.tsx:75,86ResourcesTab.tsx:86 读源断言省略与兜底生效
AC-EL-OFC-RES-015资源列·国家列表头「国家」muted 显 country,空「—」;ResourcesTab.tsx:75,87ResourcesTab.tsx:87 读源断言兜底生效
AC-EL-OFC-RES-016资源列·粉丝列表头「粉丝」右对齐 num;fmtK=followers!=null?toLocaleString("en-US")(千分位):「—」;ResourcesTab.tsx:75,88,37ResourcesTab.tsx:88,37 读源断言千分位与空值生效
AC-EL-OFC-RES-017资源列·活跃度列表头「活跃度」右对齐 num muted,activity!=null 显原值否则「—」;ResourcesTab.tsx:75,89ResourcesTab.tsx:89 读源断言空值兜底生效
AC-EL-OFC-RES-018资源列·联系方式列表头「联系方式」contact 含 @ 显 mailto 链接(取逗号前首个 trim)否则纯文本,空「—」;单行省略 maxWidth 200;ResourcesTab.tsx:75,90-92ResourcesTab.tsx:91 读源断言 mailto 取首地址生效
AC-EL-OFC-RES-019资源分页计数标签pager 计数「共 {int(total)} 条 · 第 {data.page} / {pages} 页」(当前页取响应 page);ResourcesTab.tsx:97-98ResourcesTab.tsx:98 读源断言响应页号消费生效
AC-EL-OFC-RES-020资源翻页按钮按钮上一页/下一页page≤1/page≥pages 双侧禁用;ResourcesTab.tsx:99-100ResourcesTab.tsx:99-100 读源断言边界禁用生效

§11.40 站外推广子组件·列级/元素级·Reddit 专库 RedditTab(/offsitepromotion · AC-EL-OFC-RDT 系列,源码 web/app/offsitepromotion/RedditTab.tsx)

Reddit 专库=919 万 reddit 达人只读浏览(:3 注释),不进达人库筛选/打标,触达=点达人名跳 Reddit 主页站内私信;数据 GET /api/promotion/kol-reddit(:37,参数 country/raw_cat/fmin/fmax/q/sort/page/page_size=20,fmin/fmax 空补 "0");昵称搜索为提交制(search→query,:71-72)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-RDT-001Reddit 列表加载端点专库数据源GET /api/promotion/kol-reddit?country&raw_cat&fmin&fmax&q&sort&page&page_size=20(URLSearchParams,fmin/fmax 空串补"0")→{total,page,page_size,items,facets,note};失败写 error 条;RedditTab.tsx:32-41RedditTab.tsx:33-39 读源断言参数表与补 0生效
AC-EL-OFC-RDT-002专库卡头计数标签h2 动态总数「Reddit 专库」sub「共 {int(total)} 位达人 · 仅站内联系方式,只读浏览」;RedditTab.tsx:53RedditTab.tsx:53 读源断言计数式逐字生效
AC-EL-OFC-RDT-003只读口径说明容器库定位文案说明段:Reddit 达人只有站内触达(私信/评论)无邮箱/IM/社交,单独成库不进筛选打标体系,点达人名跳主页发起私信;RedditTab.tsx:54-57RedditTab.tsx:55-57 读源断言口径文案生效
AC-EL-OFC-RDT-004错误条容器API 失败提示err 非空显 div.error role=alert;RedditTab.tsx:51RedditTab.tsx:51 读源断言条件渲染生效
AC-EL-OFC-RDT-005国家选择器选择器country 筛选首项「国家不限」+facets.countries「{value}({count})」;RedditTab.tsx:59-62RedditTab.tsx:60-61 读源断言选项源生效
AC-EL-OFC-RDT-006类目选择器选择器raw_cat 筛选首项「类目不限」+facets.raw_categories;RedditTab.tsx:63-66RedditTab.tsx:64-65 读源断言 facet 键名生效
AC-EL-OFC-RDT-007粉丝下限输入输入fmin 筛选number placeholder「粉丝下限」maxWidth 110,变更即筛回第 1 页;RedditTab.tsx:67-68RedditTab.tsx:67-68 读源断言即时筛选生效
AC-EL-OFC-RDT-008粉丝上限输入输入fmax 筛选number placeholder「粉丝上限」maxWidth 110;RedditTab.tsx:69-70RedditTab.tsx:69-70 读源断言即时筛选生效
AC-EL-OFC-RDT-009昵称搜索输入输入search 暂存框placeholder「昵称搜索」maxWidth 220;仅提交(form onSubmit)才写入 query 触发查询,输入本身不触发;RedditTab.tsx:71-73RedditTab.tsx:72-73 读源断言提交制搜索生效
AC-EL-OFC-RDT-010排序选择器选择器sort 二选followers=按粉丝数(默认)/name=按昵称;RedditTab.tsx:28,74-76RedditTab.tsx:28,75 读源断言默认值生效
AC-EL-OFC-RDT-011搜索按钮按钮提交搜索type=submit「搜索」→回第 1 页+query=search;RedditTab.tsx:72,77RedditTab.tsx:77 读源断言提交行为生效
AC-EL-OFC-RDT-012重置筛选按钮按钮清全部条件「重置筛选」→country/rawCat/fmin/fmax/search/query 全清+回第 1 页(sort 保留);RedditTab.tsx:43-46,109RedditTab.tsx:44-45 读源断言清空范围与 sort 不清生效
AC-EL-OFC-RDT-013Reddit 列·达人列表头「达人」name 渲染 a 外链 r.url(新窗 noreferrer 品牌色)——触达入口;RedditTab.tsx:89,94-96RedditTab.tsx:95 读源断言外链指向 r.url生效
AC-EL-OFC-RDT-014Reddit 列·粉丝列表头「粉丝」右对齐 num,subs!=null 显 int 千分位否则「—」;RedditTab.tsx:89,97RedditTab.tsx:97 读源断言千分位与空值生效
AC-EL-OFC-RDT-015Reddit 列·国家列表头「国家」muted 显 country,空「—」;RedditTab.tsx:89,98RedditTab.tsx:98 读源断言兜底生效
AC-EL-OFC-RDT-016Reddit 列·类目列表头「类目」muted 显 category,空「—」;RedditTab.tsx:89,99RedditTab.tsx:99 读源断言兜底生效
AC-EL-OFC-RDT-017Reddit 列·语言列表头「语言」muted 显 language,空「—」;RedditTab.tsx:89,100RedditTab.tsx:100 读源断言兜底生效
AC-EL-OFC-RDT-018Reddit 列·活跃度列表头「活跃度」右对齐 num,activity!=null 显原值否则「—」;RedditTab.tsx:89,101RedditTab.tsx:101 读源断言兜底生效
AC-EL-OFC-RDT-019Reddit 空态空态无匹配行items 空 colSpan 6「无匹配达人」padding 28;RedditTab.tsx:104RedditTab.tsx:104 读源断言空态文案生效
AC-EL-OFC-RDT-020Reddit 加载态空态加载占位!data && !err 显「加载中…」;RedditTab.tsx:83RedditTab.tsx:83 读源断言双条件占位生效
AC-EL-OFC-RDT-021Reddit 分页按钮计数+翻页「共 {int(total)} 条 · 第 {data.page} / {pages} 页」+上一页/下一页(page≤1/page≥pages 禁用);RedditTab.tsx:108-113RedditTab.tsx:110-112 读源断言计数与双侧禁用生效

OFF 列级·推广项目(/offsitepromotion 🚀推广项目 · AC-EL-OFC-PRJ 系列 64 条,源码 web/app/offsitepromotion/ProjectsTab.tsx 374 行)

ProjectsPanel(列表 :23-78)+ NewProjectForm(:81-112)+ ProjectDetail 达人工作台(:115-231)+ AddKols 勾选面板(:234-291)+ ContentEditor 文案抽屉(:294-374);面板级归属见 AC-EL-OFF-057,本批为面板内部逐元素/逐列。PK 状态五态 pending/ai_generated/edited/sent/ignored(PK_STATUS :18,中文 STATUS_LABEL :19-21)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-PRJ-001GET /api/promotion/projects端点项目列表加载挂载即拉(useEffect :34);响应 {items:Project[]};失败置空数组(:32)不报错读源 ProjectsTab.tsx:31-34生效
AC-EL-OFC-PRJ-002DELETE /api/promotion/projects/{id}端点删除项目危险确认 :37「该项目及其下所有达人关联与文案将一并删除。」;成功 toast「已删除」回列表重拉(:38-39)读源 ProjectsTab.tsx:36-40生效
AC-EL-OFC-PRJ-003POST /api/promotion/projects端点新建项目载荷 {name,product_link,discount_code,product_desc} 全 trim(:91);name 空前置拒绝 :88「项目名必填」读源 ProjectsTab.tsx:87-95生效
AC-EL-OFC-PRJ-004GET /api/promotion/projects/{id}/kols端点项目达人分页列表六参数 platform/contact_type/status/q/page/page_size=20(:129);响应 {total,items:Pk[]};任一筛选变化重查(依赖数组 :131);回第 1 页=各控件 onChange setPage(1) :174-186读源 ProjectsTab.tsx:127-132生效
AC-EL-OFC-PRJ-005POST /api/promotion/project-kols/{pkid}/status端点行内状态流转载荷 {status};行内下拉触发(:207-212);成功重拉列表(:134-137)读源 ProjectsTab.tsx:134-137生效
AC-EL-OFC-PRJ-006POST /api/promotion/projects/{id}/email/batch-send端点批量发送confirm :139「对项目内所有「有邮箱」达人批量发送?(SMTP 修复前会先落日志 pending)」;空 body;响应 {queued,note} → toast「已入队 N 封」(:141-142)读源 ProjectsTab.tsx:138-144生效
AC-EL-OFC-PRJ-007GET /api/promotion/projects/{id}/export端点导出 CSV响应 {filename,csv};前端 BOM+Blob 触发下载(:148-151);toast「已导出」读源 ProjectsTab.tsx:145-153生效
AC-EL-OFC-PRJ-008GET /api/promotion/kol?kind=channel&q=端点加入达人数据源AddKols 面板拉全局渠道库(:242);响应 items {id,name,platform,subs,email};失败置空(:243)读源 ProjectsTab.tsx:240-245生效
AC-EL-OFC-PRJ-009POST /api/promotion/projects/{id}/kols/add端点勾选加入项目载荷 {kol_ids:[...]}(:256);响应 {added} → toast「已加入 N 位」;零选拒绝 :253「先勾选达人」读源 ProjectsTab.tsx:252-260生效
AC-EL-OFC-PRJ-010GET /api/promotion/project-kols/{pk_id}/content端点文案抽屉加载响应 {content};编辑态初值 manual_* 优先回退 AI 字段(:306-308);失败仅停 loading(:310)读源 ProjectsTab.tsx:302-311生效
AC-EL-OFC-PRJ-011PUT /api/promotion/project-kols/{pk_id}/manual端点手工文案保存载荷 {manual_email,manual_long_reply,manual_short_reply}(:315);成功 toast「已保存」关闭抽屉读源 ProjectsTab.tsx:313-318生效
AC-EL-OFC-PRJ-012「+ 新建项目」按钮按钮打开新建表单tabs 行右侧(:50);点击置 showNew 渲染 NewProjectForm(:52)读源 ProjectsTab.tsx:50-52生效
AC-EL-OFC-PRJ-013「还没有项目」空态空态列表空提示EmptyState title「还没有项目」hint「点「新建项目」开始第一个推广外联」(:55);仅 projects.length===0读源 ProjectsTab.tsx:54-55生效
AC-EL-OFC-PRJ-014「项目」列列项目表第 1 列名称可点进详情(cursor:pointer :62);product_link 副行 ellipsis 280 单行截断(:63)读源 ProjectsTab.tsx:58,62-63生效
AC-EL-OFC-PRJ-015「折扣码」列列项目表第 2 列muted 文本;空显「—」(:64)读源 ProjectsTab.tsx:58,64生效
AC-EL-OFC-PRJ-016「状态」列(项目表)列项目表第 3 列chip 原文回显 p.status(无中文映射,:65)读源 ProjectsTab.tsx:58,65生效
AC-EL-OFC-PRJ-017「达人数」列列项目表第 4 列int(kol_count) 千分位右对齐(:66)读源 ProjectsTab.tsx:58,66生效
AC-EL-OFC-PRJ-018「已发送」列列项目表第 5 列int(sent_count) 千分位右对齐(:67)读源 ProjectsTab.tsx:58,67生效
AC-EL-OFC-PRJ-019「创建时间」列列项目表第 6 列created_at 原文 t2 样式(:68)读源 ProjectsTab.tsx:58,68生效
AC-EL-OFC-PRJ-020「操作」列(项目表)按钮项目表第 7 列「打开 →」按钮进详情(:69);表头为空 th(:58)读源 ProjectsTab.tsx:58,69生效
AC-EL-OFC-PRJ-021「项目名 *」输入输入新建表单字段必填(:88「项目名必填」);placeholder「如:机械键盘 Q4 黑五推广」(:101)读源 ProjectsTab.tsx:88,101生效
AC-EL-OFC-PRJ-022「折扣码」输入(新建)输入新建表单字段placeholder「如:BF30」(:102);可空读源 ProjectsTab.tsx:102生效
AC-EL-OFC-PRJ-023「产品链接」输入输入新建表单字段跨两列(:103);placeholder「https://amazon.com/dp/...」读源 ProjectsTab.tsx:103生效
AC-EL-OFC-PRJ-024「产品描述」输入输入新建表单字段textarea minHeight 70(:104);placeholder「卖点 / 目标人群 / 合作诉求」读源 ProjectsTab.tsx:104生效
AC-EL-OFC-PRJ-025「创建/取消」按钮按钮新建表单提交busy 期间禁用文案「创建中…」(:107);取消关表单(:108)读源 ProjectsTab.tsx:106-109生效
AC-EL-OFC-PRJ-026「← 项目列表」按钮按钮详情返回onBack 回列表并重拉(:160,:42 回调)读源 ProjectsTab.tsx:42,160生效
AC-EL-OFC-PRJ-027折扣码 chip标签详情页头标识条件 project.discount_code 非空才显(:162)读源 ProjectsTab.tsx:162生效
AC-EL-OFC-PRJ-028「+ 加入达人」按钮按钮打开勾选面板置 showAdd 渲染 AddKols(:164,:170)读源 ProjectsTab.tsx:164,170生效
AC-EL-OFC-PRJ-029「⬇ 导出 Excel」按钮按钮CSV 导出doExport(:145-153);文件名/内容全由端点返回读源 ProjectsTab.tsx:145-153,165生效
AC-EL-OFC-PRJ-030「✉ 批量发送」按钮按钮批量外联confirm 文案见 PRJ-006(:139);主样式 tab on(:166)读源 ProjectsTab.tsx:138-144,166生效
AC-EL-OFC-PRJ-031「删除项目」按钮按钮危险操作danger 色(:167);确认链路 PRJ-002读源 ProjectsTab.tsx:36-40,167生效
AC-EL-OFC-PRJ-032「搜索名称 / 邮箱」输入输入详情筛选·搜索即时 onChange 置 q 并回第 1 页(:174-175);请求参数见 PRJ-004读源 ProjectsTab.tsx:174-175生效
AC-EL-OFC-PRJ-033「全部平台」选择器选择器详情筛选·平台10 固定选项 youtube/tiktok/telegram/bluesky/website/instagram/x/facebook/deal_community/forum(:178);空=全部读源 ProjectsTab.tsx:176-179生效
AC-EL-OFC-PRJ-034「联系类型」选择器选择器详情筛选·联系类型has_email「有邮箱」/no_email「无邮箱」/空不限(:180-184)读源 ProjectsTab.tsx:180-184生效
AC-EL-OFC-PRJ-035「全部状态」选择器选择器详情筛选·状态PK_STATUS 五态中文(STATUS_LABEL :19-21:待处理/AI已生成/已编辑/已发送/已忽略)(:185-188)读源 ProjectsTab.tsx:18-21,185-188生效
AC-EL-OFC-PRJ-036「共 N 位达人」标签标签详情计数int(total)(:190);total 来自 PRJ-004 响应读源 ProjectsTab.tsx:117,190生效
AC-EL-OFC-PRJ-037「暂无达人」空态空态达人表空提示hint「点「加入达人」从达人库勾选,或调整筛选」(:194)读源 ProjectsTab.tsx:193-194生效
AC-EL-OFC-PRJ-038「达人」列(明细表)列达人表第 1 列名称 ellipsis 200 单行截断(:201)读源 ProjectsTab.tsx:197,201生效
AC-EL-OFC-PRJ-039「平台」列列达人表第 2 列muted 原文(:202)读源 ProjectsTab.tsx:197,202生效
AC-EL-OFC-PRJ-040「粉丝」列列达人表第 3 列fmtK 千分位,null 显「—」(:203;fmtK :155)读源 ProjectsTab.tsx:155,203生效
AC-EL-OFC-PRJ-041「国家/类目」列列达人表第 4 列countries join「·」+ categories 前 2 项,空「—」(:204)读源 ProjectsTab.tsx:197,204生效
AC-EL-OFC-PRJ-042「邮箱」列链接达人表第 5 列email 存在显 mailto 链接,否则 muted「无」(:205)读源 ProjectsTab.tsx:197,205生效
AC-EL-OFC-PRJ-043「匹配分」列列达人表第 6 列match_score 原值右对齐,null 显「—」(:206)读源 ProjectsTab.tsx:197,206生效
AC-EL-OFC-PRJ-044「状态」列(达人表)选择器达人表第 7 列行内 select 五态即改即存(:207-212,写端点 PRJ-005)读源 ProjectsTab.tsx:207-212生效
AC-EL-OFC-PRJ-045「文案」列按钮达人表第 8 列按钮文案按 contact_type 二态「邮件」/「社区回复」(:213);打开 ContentEditor读源 ProjectsTab.tsx:213,228生效
AC-EL-OFC-PRJ-046达人表分页器按钮明细分页total>20 才显;「x / y」y=ceil(total/20)(:219-225);越界禁用读源 ProjectsTab.tsx:219-225生效
AC-EL-OFC-PRJ-047「从达人库勾选加入」标题标签AddKols 面板头h2 + sub「已选 {sel.size} 位」实时联动(:264)读源 ProjectsTab.tsx:264生效
AC-EL-OFC-PRJ-048「搜索名称 / 邮箱」输入(勾选)输入勾选面板搜索即时重查(:266-267,:240-244)读源 ProjectsTab.tsx:240-245,266生效
AC-EL-OFC-PRJ-049「加入所选(N)/取消」按钮按钮勾选提交busy「加入中…」禁用(:269);取消关面板(:270)读源 ProjectsTab.tsx:252-260,269-270生效
AC-EL-OFC-PRJ-050勾选列(勾选表)列勾选表第 1 列行点击 toggle+选中行背景 accent-soft(:278);checkbox stopPropagation 防双触发(:279)读源 ProjectsTab.tsx:247-251,278-279生效
AC-EL-OFC-PRJ-051「达人」列(勾选表)列勾选表第 2 列strong 名称(:280)读源 ProjectsTab.tsx:275,280生效
AC-EL-OFC-PRJ-052「平台」列(勾选表)列勾选表第 3 列muted(:281)读源 ProjectsTab.tsx:275,281生效
AC-EL-OFC-PRJ-053「粉丝」列(勾选表)列勾选表第 4 列千分位,空显「—」(:282)读源 ProjectsTab.tsx:275,282生效
AC-EL-OFC-PRJ-054「邮箱」列(勾选表)列勾选表第 5 列原文,空显「—」(:283)读源 ProjectsTab.tsx:275,283生效
AC-EL-OFC-PRJ-055文案抽屉容器容器右侧滑出抽屉fixed 全屏遮罩+右侧 560px(maxWidth 92vw)面板(:321-323);遮罩点击关闭(:322)读源 ProjectsTab.tsx:320-323生效
AC-EL-OFC-PRJ-056抽屉头标识标签达人上下文达人名+「{platform} · {email 或 无邮箱 · 社区回复}」(:326-327)读源 ProjectsTab.tsx:324-331生效
AC-EL-OFC-PRJ-057「⚠ 站点风控提醒」卡标签风控提示条件 c.platform_risk_note 非空(:336);warn-soft 底 pre-wrap 展示(:337-340)读源 ProjectsTab.tsx:336-341生效
AC-EL-OFC-PRJ-058「邮件主题」只读输入输入邮件模式字段readOnly 回显 c.email_subject(:344-346);placeholder「(AI 生成后显示)」读源 ProjectsTab.tsx:344-346生效
AC-EL-OFC-PRJ-059「邮件正文(可编辑)」输入输入邮件模式字段textarea minHeight 260(:347-349);初值 manual_email||email_content(:306)读源 ProjectsTab.tsx:306,347-349生效
AC-EL-OFC-PRJ-060「💡 编辑提示」标签标签编辑建议条件 c.email_edit_tips(:350)读源 ProjectsTab.tsx:350生效
AC-EL-OFC-PRJ-061「长版深度评论(可编辑)」输入输入社区模式字段contact_type≠has_email 时渲染(:352-360);textarea minHeight 160;初值 manual_long_reply||community_long_reply(:307)读源 ProjectsTab.tsx:307,354-356生效
AC-EL-OFC-PRJ-062「短版简评(可编辑)」输入输入社区模式字段textarea minHeight 80(:357-359);初值 manual_short_reply||community_short_reply(:308)读源 ProjectsTab.tsx:308,357-359生效
AC-EL-OFC-PRJ-063「保存/取消」按钮(抽屉)按钮文案保存保存走 PUT manual(PRJ-011)成功关闭并重拉(:313-318,:363)读源 ProjectsTab.tsx:313-318,362-365生效
AC-EL-OFC-PRJ-064抽屉底注标签口径声明「文案由外部离线 AI 生成后导入,此处仅编辑。Deal 社区只导出文案,需人工到对应社区发布,系统不自动发帖。」(:366-368)读源 ProjectsTab.tsx:366-368生效

OFF 列级·达人库(/offsitepromotion 达人库 · AC-EL-OFC-LIB 系列 59 条,源码 web/app/offsitepromotion/LibraryTab.tsx 405 行)

LibraryTab 主列表(:34-244)+ FilterRow 多选筛选行组件(:246-277)+ CatManager 类目管理弹窗(:279-338)+ DictManager 渠道字典弹窗(:340-404);面板级归属见 AC-EL-OFF-048。筛选选项全部来自 API facets 注册表事实,前端不硬编码清单(:3-4 注释)。回复状态六态中文 REPLY_LABELS(:29-32)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-LIB-001GET /api/promotion/kol-library端点主列表加载14 参数 URLSearchParams(:61-64):platforms/countries/cat_ids/raw_cats/tags/contact/suppression/reply_status/fmin/fmax/q/sort/page/page_size=20;响应 {total,page,page_size,items,facets}(:27);失败 setErr(:68)读源 LibraryTab.tsx:59-70生效
AC-EL-OFC-LIB-002POST /api/promotion/kol-categories/batch端点批量打标/移除载荷 {kol_ids, add:[], remove:[]}(:103-104);响应 {added,removed} → toast;成功清勾选并刷新 facets(:105-107)读源 LibraryTab.tsx:99-108生效
AC-EL-OFC-LIB-003GET /api/promotion/categories端点类目管理列表CatManager 挂载拉取(:287-290);失败静默读源 LibraryTab.tsx:287-290生效
AC-EL-OFC-LIB-004POST /api/promotion/categories端点新增类目载荷 {name,sort}(:296);name 空拒绝 :293「类目名必填」;成功后列表+facets 双刷新(:297)读源 LibraryTab.tsx:292-299生效
AC-EL-OFC-LIB-005DELETE /api/promotion/categories/{id}端点删除类目危险确认 :301「「{n}」?达人与该类目的映射将一并移除。」;成功双刷新(:302-303)读源 LibraryTab.tsx:300-304生效
AC-EL-OFC-LIB-006GET /api/promotion/channel-dict端点渠道字典列表DictManager 挂载拉取(:348-351);失败静默读源 LibraryTab.tsx:348-351生效
AC-EL-OFC-LIB-007POST /api/promotion/channel-dict端点新增渠道载荷 {value,label||value,sort:999}(:357);value 空拒绝 :354「value 必填(小写字母/数字)」读源 LibraryTab.tsx:353-360生效
AC-EL-OFC-LIB-008PUT /api/promotion/channel-dict/{id}端点渠道启停载荷 {is_active:!active}(:362);成功重拉(:363)读源 LibraryTab.tsx:361-364生效
AC-EL-OFC-LIB-009DELETE /api/promotion/channel-dict/{id}端点删除字典项危险确认 :366「「{v}」?已入库达人数据不受影响。」(:365-369)读源 LibraryTab.tsx:365-369生效
AC-EL-OFC-LIB-010错误横幅空态请求失败反馈error role=alert(:115);仅 kol-library 请求失败 setErr(:68)读源 LibraryTab.tsx:68,115生效
AC-EL-OFC-LIB-011「达人库」标题标签面板头h2 + sub「多选筛选 · 共 {int(total)} 位达人 · suppression 默认隐藏」(:117)读源 LibraryTab.tsx:117生效
AC-EL-OFC-LIB-012FilterRow 多选行组件容器筛选行骨架label+pill 组(:246-277);maxHeight 92 滚动(:268);B8 修复(:254-255):always 行空时不整行消失、空态给指引读源 LibraryTab.tsx:246-277生效
AC-EL-OFC-LIB-013「渠道」筛选行选择器平台多选选项=facets.platforms「{label}({count})」(:118);label 映射见渠道字典读源 LibraryTab.tsx:118生效
AC-EL-OFC-LIB-014「国家」筛选行选择器国家多选facets.countries 前 40 个(:119);空值显「(空)」读源 LibraryTab.tsx:119生效
AC-EL-OFC-LIB-015「自定义类目」筛选行选择器租户类目多选always 行(:120);空态 hint「暂无自定义类目 — 点下方「类目管理」新增」;值=类目 id 字符串读源 LibraryTab.tsx:120,254-263生效
AC-EL-OFC-LIB-016「源类目」筛选行选择器源类目多选facets.raw_categories 前 30 个(:121);空值显「(空)」读源 LibraryTab.tsx:121生效
AC-EL-OFC-LIB-017「标签」筛选行选择器标签多选选项=facets.tags 全量(:122)读源 LibraryTab.tsx:122生效
AC-EL-OFC-LIB-018「联系方式」选择器选择器联系方式互斥分类五选项各带 facets.contact 计数(:124-133);title :125「主联系方式互斥分类:按 邮箱 > IM > 社交 > 官网 优先级归入最高一类」读源 LibraryTab.tsx:124-133生效
AC-EL-OFC-LIB-019suppression 选择器选择器抑制名单过滤hide(默认)/only「仅看抑制名单」/all 三态(:134-136)读源 LibraryTab.tsx:44,134-136生效
AC-EL-OFC-LIB-020「回复状态」选择器选择器回复过滤REPLY_LABELS 六态:同意/索样/询价/拒绝/退信/无关(:29-32,:137-140)读源 LibraryTab.tsx:29-32,137-140生效
AC-EL-OFC-LIB-021「粉丝下限/上限」输入输入粉丝区间过滤两个 number(:141-144);空传 0(:63);变更回第 1 页读源 LibraryTab.tsx:63,141-144生效
AC-EL-OFC-LIB-022搜索表单输入名称/邮箱搜索input「达人名 / 邮箱」+submit「搜索」(:145-152);submit 才置 query+回第 1 页(:146)防抖语义读源 LibraryTab.tsx:145-152生效
AC-EL-OFC-LIB-023排序选择器选择器列表排序followers(默认)/recent「按最近触达」/name 三项(:50,:148-150)读源 LibraryTab.tsx:50,148-150生效
AC-EL-OFC-LIB-024「重置筛选」按钮按钮清空筛选清全部 11 项筛选态回第 1 页(:73-77,:155)读源 LibraryTab.tsx:73-77,155生效
AC-EL-OFC-LIB-025「类目管理」按钮按钮开类目弹窗置 mgr="cats"(:156,:240 渲染)读源 LibraryTab.tsx:156,240生效
AC-EL-OFC-LIB-026「渠道字典」按钮按钮开字典弹窗置 mgr="dict"(:157,:241 渲染)读源 LibraryTab.tsx:157,241生效
AC-EL-OFC-LIB-027批量操作卡容器勾选后批量栏条件 selKols.length>0(:161);brand 边框;sub「已勾选 {N} 位达人(本页全选切换: 表头复选框)」(:163)读源 LibraryTab.tsx:161-173生效
AC-EL-OFC-LIB-028批量类目选择器选择器批量目标类目选项=facets.categories「{name}({count})」(:165-168)读源 LibraryTab.tsx:165-168生效
AC-EL-OFC-LIB-029「打标/移除标记」按钮按钮批量写操作batchTag add/remove(:169-170,:99-108);零选或未选类目拒绝 :100「先勾选达人并选择类目」读源 LibraryTab.tsx:99-108,169-170生效
AC-EL-OFC-LIB-030表头勾选列列主表第 1 列全选=本页 every(allChecked :111,:182-183);勾选仅本页集合读源 LibraryTab.tsx:111,182-183生效
AC-EL-OFC-LIB-031行勾选列列行选择checkbox 逐行增删 selKols(:190-191)读源 LibraryTab.tsx:190-191生效
AC-EL-OFC-LIB-032「达人」列链接主表第 2 列url 存在时名称外链新窗 noreferrer(:193);bio ellipsis+title 全文(:194-197);「最高播放 N」条件 max_views(:198)读源 LibraryTab.tsx:192-199生效
AC-EL-OFC-LIB-033「渠道」列列主表第 3 列platLabel 字典映射(:84-88)回退原值/「—」(:200)读源 LibraryTab.tsx:84-88,200生效
AC-EL-OFC-LIB-034「粉丝」列列主表第 4 列int(subs) 千分位右对齐,null「—」(:201)读源 LibraryTab.tsx:201生效
AC-EL-OFC-LIB-035「国家」列列主表第 5 列前 3 个+「+N」溢出标记;title=全列表逗号连接(:202)读源 LibraryTab.tsx:202生效
AC-EL-OFC-LIB-036「类目」列列主表第 6 列源类目 dim badge 前 3+「+N」(:204-207)+自定义 chip cat_ids(catName id→名映射 :79-83,:208-210);双空「—」(:211)读源 LibraryTab.tsx:79-83,203-212生效
AC-EL-OFC-LIB-037「标签」列列主表第 7 列tags 逐个 dim badge,空「—」(:213)读源 LibraryTab.tsx:213生效
AC-EL-OFC-LIB-038「负责人」列列主表第 8 列owner 原文,空「—」(:214)读源 LibraryTab.tsx:214生效
AC-EL-OFC-LIB-039「最近触达」列列主表第 9 列last_contacted_at 原文,空「—」(:215)读源 LibraryTab.tsx:215生效
AC-EL-OFC-LIB-040「回复」列列主表第 10 列REPLY_LABELS badge 回退原值;空「—」(:216)读源 LibraryTab.tsx:29-32,216生效
AC-EL-OFC-LIB-041「联系方式」列列主表第 11 列邮箱/IM/社交/官网四行逐条件 badge+值 ellipsis+title 全文(:217-223);四皆空「—」(:222)读源 LibraryTab.tsx:217-223生效
AC-EL-OFC-LIB-042「状态」列列主表第 12 列suppression? badge bad「已抑制」: badge ok「正常」(:224)读源 LibraryTab.tsx:224生效
AC-EL-OFC-LIB-043「无匹配达人」空态空态主表空行colSpan 12 居中(:227)读源 LibraryTab.tsx:227生效
AC-EL-OFC-LIB-044主表分页器按钮列表分页「共 {total} 条 · 第 {page} / {pages} 页」pages=ceil(total/20)(:110,:231-235);越界禁用读源 LibraryTab.tsx:110,231-235生效
AC-EL-OFC-LIB-045类目管理弹窗容器容器模态框460px 模态(:306-309);h2「类目管理」sub「自定义类目(租户级注册表)」(:310);遮罩点击关闭(:308)读源 LibraryTab.tsx:306-310生效
AC-EL-OFC-LIB-046「新类目名/排序」输入输入类目新增行name+number sort(:312-313);sort 初值 "0"(:284);提交「新增」(:314)读源 LibraryTab.tsx:283-284,311-315生效
AC-EL-OFC-LIB-047「类目」列(类目表)列类目表第 1 列strong 名称(:322)读源 LibraryTab.tsx:318,322生效
AC-EL-OFC-LIB-048「排序」列列类目表第 2 列sort 数值右对齐(:323)读源 LibraryTab.tsx:318,323生效
AC-EL-OFC-LIB-049「达人数」列列类目表第 3 列int(kol_count) 千分位(:324)读源 LibraryTab.tsx:318,324生效
AC-EL-OFC-LIB-050「操作」列(类目表)按钮类目表第 4 列「删除」按钮(:325)→危险确认(LIB-005)读源 LibraryTab.tsx:318,325生效
AC-EL-OFC-LIB-051「暂无自定义类目」空态空态类目表空行colSpan 4 居中(:328)读源 LibraryTab.tsx:328生效
AC-EL-OFC-LIB-052渠道字典弹窗容器容器模态框520px 模态(:371-374);h2「渠道字典」sub「注册表事实:插行即生效,筛选器自动出现」(:375);遮罩点击关闭(:372)读源 LibraryTab.tsx:371-375生效
AC-EL-OFC-LIB-053「value/显示名」输入输入字典新增行value 必填小写字母/数字(:354,:377);label 空回退 value(:357,:378);提交「新增」(:379)读源 LibraryTab.tsx:353-360,376-380生效
AC-EL-OFC-LIB-054「value」列(字典表)列字典表第 1 列sku 样式原文(:387)读源 LibraryTab.tsx:383,387生效
AC-EL-OFC-LIB-055「显示名」列列字典表第 2 列label 原文(:388)读源 LibraryTab.tsx:383,388生效
AC-EL-OFC-LIB-056「达人」列(字典表)列字典表第 3 列int(kol_count) 千分位(:389)读源 LibraryTab.tsx:383,389生效
AC-EL-OFC-LIB-057「启用」列按钮字典表第 4 列badge 按钮 ok「启用」/dim「停用」点击切换(:390-391)→PUT(LIB-008)读源 LibraryTab.tsx:361-364,390-391生效
AC-EL-OFC-LIB-058「操作」列(字典表)按钮字典表第 5 列「删除」按钮(:392)→危险确认(LIB-009)读源 LibraryTab.tsx:383,392生效
AC-EL-OFC-LIB-059「加载中…」占位空态主表加载态!data 且 !err 时 muted 文案(:176);首次加载可见读源 LibraryTab.tsx:176生效

OFF 列级·邮件模板(/offsitepromotion 邮件模板 · AC-EL-OFC-TPL 系列 34 条,源码 web/app/offsitepromotion/TemplatesTab.tsx 266 行)

TemplatesTab 列表(:33-111)+ TplEditor 编辑器(:113-265);面板级归属见 AC-EL-OFF-050。变量渲染口径在 API 一份实现、前端只做插入与展示(:3-4 注释);变量中文标签 VAR_LABELS 七变量(:24-27)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-TPL-001GET /api/promotion/email-templates端点列表加载四参数 lang/category/status/q(:45-46);响应 {items,facets{langs,categories},variables}(:14-18);失败静默读源 TemplatesTab.tsx:44-48生效
AC-EL-OFC-TPL-002DELETE /api/promotion/email-templates/{id}端点删除模板危险确认 :51「「{name}」?」;删除正在编辑项时同步关编辑器(:54)读源 TemplatesTab.tsx:50-56生效
AC-EL-OFC-TPL-003PUT /api/promotion/email-templates/{tid}端点编辑保存载荷 {name,lang,subject,body,category,status}(:156,:159)读源 TemplatesTab.tsx:152-168生效
AC-EL-OFC-TPL-004POST /api/promotion/email-templates端点新建保存同载荷(:161);响应 {id} 并 setId(:162-163),保存后可继续预览读源 TemplatesTab.tsx:159-164生效
AC-EL-OFC-TPL-005POST /api/promotion/email-templates/{tid}/preview端点实时预览载荷 {kol_id||null,product,discount_code,my_name}(:175-177);响应 {kol{name,platform,countries},subject,body,missing[],unknown[]}(:19-22)读源 TemplatesTab.tsx:170-180生效
AC-EL-OFC-TPL-006「邮件模板」标题标签面板头h2 + sub「共 {items.length} 个 · 变量白名单渲染 · 发送时逐收件人生成」(:61);N=当前筛选返回条数(无分页参数/分页器,全量渲染 :45-46,:77-99)读源 TemplatesTab.tsx:61生效
AC-EL-OFC-TPL-007「全部语言」选择器选择器语言筛选选项=facets.langs「{value}({count})」空值显「(空)」(:63-66)读源 TemplatesTab.tsx:63-66生效
AC-EL-OFC-TPL-008「全部分类」选择器选择器分类筛选选项=facets.categories(:67-70)读源 TemplatesTab.tsx:67-70生效
AC-EL-OFC-TPL-009「全部状态」选择器选择器状态筛选draft「草稿」/active「启用」两项(:71-73)读源 TemplatesTab.tsx:71-73生效
AC-EL-OFC-TPL-010「模板名搜索」输入输入名称搜索即时 q 联动重查(:74,:45)读源 TemplatesTab.tsx:44-48,74生效
AC-EL-OFC-TPL-011「新建模板」按钮按钮开编辑器setEditing("new")(:75);编辑器 key="new"(:103)读源 TemplatesTab.tsx:75,102-108生效
AC-EL-OFC-TPL-012「模板名」列列列表第 1 列strong 名称(:83)读源 TemplatesTab.tsx:79,83生效
AC-EL-OFC-TPL-013「语言」列列列表第 2 列lang 原文,空「—」(:84)读源 TemplatesTab.tsx:79,84生效
AC-EL-OFC-TPL-014「分类」列列列表第 3 列category 原文,空「—」(:85)读源 TemplatesTab.tsx:79,85生效
AC-EL-OFC-TPL-015「主题」列列列表第 4 列subject ellipsis 320 单行,空「—」(:86)读源 TemplatesTab.tsx:79,86生效
AC-EL-OFC-TPL-016「状态」列列列表第 5 列badge active=ok「启用」/其余 dim「草稿」(:87)读源 TemplatesTab.tsx:79,87生效
AC-EL-OFC-TPL-017「更新」列列列表第 6 列updated_at muted(:88)读源 TemplatesTab.tsx:79,88生效
AC-EL-OFC-TPL-018「操作」列按钮列表第 7 列「编辑」开编辑器/「删除」危险确认(:90-91)读源 TemplatesTab.tsx:79,89-92生效
AC-EL-OFC-TPL-019「暂无模板」空态空态列表空行「暂无模板,点「新建模板」开始」colSpan 7(:95-97)读源 TemplatesTab.tsx:95-97生效
AC-EL-OFC-TPL-020编辑器标题标签编辑器头「编辑模板 #{id}」/「新建模板」二态(:184);sub「变量在发送时逐收件人替换;缺失变量的收件人将被跳过并记录原因」(:185)读源 TemplatesTab.tsx:184-185生效
AC-EL-OFC-TPL-021「模板名」输入(编辑器)输入编辑器字段必填 :153「模板名必填」(:190)读源 TemplatesTab.tsx:152-153,190生效
AC-EL-OFC-TPL-022语言选择器(编辑器)选择器编辑器字段固定 6 语种 en/de/fr/es/it/ja(:192);新建默认 en(:122)读源 TemplatesTab.tsx:122,191-193生效
AC-EL-OFC-TPL-023「分类」输入(编辑器)输入编辑器字段自由文本(:194)读源 TemplatesTab.tsx:194生效
AC-EL-OFC-TPL-024状态选择器(编辑器)选择器编辑器字段draft/active,新建默认 draft(:124,:195-197)读源 TemplatesTab.tsx:124,195-197生效
AC-EL-OFC-TPL-025「主题」输入(编辑器)输入编辑器字段placeholder「Collab with {{channel_name}}?」(:204);focus 记录 lastField=subject(:202)供变量插入定位读源 TemplatesTab.tsx:199-205生效
AC-EL-OFC-TPL-026「正文」输入(编辑器)输入编辑器字段textarea minHeight 260(:210-213);新建默认初值「Hi {{first_name}}, …」(:126);focus 记录 lastField=body读源 TemplatesTab.tsx:126,206-214生效
AC-EL-OFC-TPL-027「插入变量」按钮组按钮变量插入variables 来自 API(:105,回退 VAR_LABELS keys :24-27);insertVar 按 lastField 在光标处插入 {{var}}(:137-150);按钮显中文 VAR_LABELS 回退原值(:220)读源 TemplatesTab.tsx:24-27,137-150,215-223生效
AC-EL-OFC-TPL-028「关闭/保存/保存并预览」按钮按钮编辑器提交保存→TPL-003/004;保存并预览先 save 再调 preview(:170-171,:224-228)读源 TemplatesTab.tsx:170-180,224-228生效
AC-EL-OFC-TPL-029「实时预览」卡标签预览区头h3「实时预览」sub「抽真实达人渲染」(:232)读源 TemplatesTab.tsx:231-232生效
AC-EL-OFC-TPL-030「产品名/折扣码/署名」输入输入预览参数默认 Zipforce 新品/KOL15/Anna(:129-131,:234-238)读源 TemplatesTab.tsx:129-131,234-238生效
AC-EL-OFC-TPL-031「指定达人 ID」输入输入预览收件人number;placeholder「指定达人 ID(留空随机抽一位有邮箱的达人)」(:239-240)读源 TemplatesTab.tsx:239-240生效
AC-EL-OFC-TPL-032「生成预览」按钮按钮预览触发preview()(:241,:170-180)读源 TemplatesTab.tsx:170-180,241生效
AC-EL-OFC-TPL-033预览结果区标签渲染反馈样例达人行(:245-247);missing「模板未使用(或缺失值)」+unknown 红「非白名单变量(发送时保留原样)」warn badge(:248-252);主题+正文渲染框(:254-257)读源 TemplatesTab.tsx:243-258生效
AC-EL-OFC-TPL-034未预览提示空态预览初始态「填好变量参数后点「生成预览」;未保存过的模板会先存为草稿再渲染。」(:260)读源 TemplatesTab.tsx:260生效

OFF 列级·邮箱设置(/offsitepromotion 邮箱设置 · AC-EL-OFC-MBX 系列 30 条,源码 web/app/offsitepromotion/MailboxesTab.tsx 264 行)

MailboxesTab 列表+编辑卡(:50-263);面板级归属见 AC-EL-OFF-054。R7 边界:平台只存储/测试/轮发/监控,不自动开箱不代购(:3-5 注释);密码 write-only——编辑留空=保留原凭据,任何接口不回明文(:4-5);健康徽标来自 health jsonb(:5)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-MBX-001GET /api/promotion/mailboxes端点列表加载响应 {total,items:Mb[]}(:61);Mb 含 has_smtp_pass/has_imap_pass 布尔而非明文(:21-22);失败静默读源 MailboxesTab.tsx:60-63生效
AC-EL-OFC-MBX-002POST /api/promotion/mailboxes端点新增邮箱载荷=form 全量 15 字段(:85,Form :28-33)读源 MailboxesTab.tsx:80-94生效
AC-EL-OFC-MBX-003PUT /api/promotion/mailboxes/{id}端点编辑邮箱编辑预填密码置空(:72-73)→留空=保留原凭据;toast 条件「已保存(凭据已更新)」当任一密码非空(:89)读源 MailboxesTab.tsx:68-77,80-94生效
AC-EL-OFC-MBX-004POST /api/promotion/mailboxes/{id}/test端点连通测试响应 TestResp {ok,smtp{ok,ms,error},imap{ok,ms,error,inbox_count}}(:23-27,:99);toast「连通测试通过」/「测试未通过, 见行内详情」(:101)读源 MailboxesTab.tsx:96-105生效
AC-EL-OFC-MBX-005DELETE /api/promotion/mailboxes/{id}端点删除邮箱危险确认 :108「「{email}」?关联发送任务将无法再用该箱。」读源 MailboxesTab.tsx:107-113生效
AC-EL-OFC-MBX-006「邮箱设置」标题标签面板头h2 + sub「共 {items.length} 个 · 运营人工录入企业邮箱 SMTP/IMAP(R7: 平台只存储/测试/轮发/监控,不自动开箱)」(:125)读源 MailboxesTab.tsx:125生效
AC-EL-OFC-MBX-007「新增邮箱」按钮+密码口径提示按钮新增入口openNew 重置 EMPTY 表单(:65-67,:127);旁注「密码 Fernet 加密落库且永不回显 · 新箱预热期建议 ≤20 封/日(R1)」(:128-130)读源 MailboxesTab.tsx:65-67,126-131生效
AC-EL-OFC-MBX-008「邮箱」列列列表第 1 列email strong+条件「 · {display_name}」muted(:144)读源 MailboxesTab.tsx:134,144生效
AC-EL-OFC-MBX-009「状态」列列列表第 2 列STATUS_BADGE 四态(:45-48):active ok「正常」/warming warn「预热中」/paused dim「已暂停」/quota_exceeded dim「达上限」;未知回退 dim(:141)读源 MailboxesTab.tsx:45-48,141,145生效
AC-EL-OFC-MBX-010「SMTP」列列列表第 3 列「{host}:{port} {SSL|STARTTLS}」(:146)读源 MailboxesTab.tsx:134,146生效
AC-EL-OFC-MBX-011「IMAP」列列列表第 4 列「{host}:{port}」(:147)读源 MailboxesTab.tsx:134,147生效
AC-EL-OFC-MBX-012「日上限」列列列表第 5 列daily_send_limit 原值(:148)读源 MailboxesTab.tsx:134,148生效
AC-EL-OFC-MBX-013「连通测试」列列列表第 6 列三层回显:本次结果 ✓{ms}ms/✗{err} 双行+「收件箱 {N} 封」(:149-156,leg :115-120);否则 health.last_test_*「上次通过/失败 · {时间}」(:157-161);否则「未测试」(:161)读源 MailboxesTab.tsx:115-120,149-162生效
AC-EL-OFC-MBX-014「最近拉信」列列列表第 7 列last_pull_at slice(5,16),空「—」(:163)读源 MailboxesTab.tsx:134,163生效
AC-EL-OFC-MBX-015「备注」列列列表第 8 列note 原文 maxWidth 160,空「—」(:164)读源 MailboxesTab.tsx:134,164生效
AC-EL-OFC-MBX-016「操作」列按钮列表第 9 列「测试」(testing 中禁用显「测试中…」)/「编辑」/「删除」danger(:166-170)读源 MailboxesTab.tsx:134,165-171生效
AC-EL-OFC-MBX-017「尚无邮箱」空态空态列表空行「尚无邮箱——录入企业邮箱的 SMTP/IMAP 参数后即可用于发送任务与收信」colSpan 9(:175-179)读源 MailboxesTab.tsx:175-179生效
AC-EL-OFC-MBX-018编辑卡标题标签编辑器头「新增邮箱」/「编辑 {email}」二态;sub 二态「录入后先「测试」验证参数」/「密码留空 = 保留原凭据(不预填明文)」(:187-188)读源 MailboxesTab.tsx:186-188生效
AC-EL-OFC-MBX-019「邮箱地址/发件显示名」输入输入基础字段email(保存必填之一)+display_name 可空(:190-195)读源 MailboxesTab.tsx:189-196生效
AC-EL-OFC-MBX-020「SMTP 服务器」输入输入SMTP 字段placeholder「smtp.company.com」(:199-201);保存必填之一读源 MailboxesTab.tsx:198-201,253-254生效
AC-EL-OFC-MBX-021「SMTP 端口/加密」输入选择器SMTP 字段端口 number 默认 465(:37);加密「SSL(465 隐式)」/「STARTTLS(587)」(:205-210)读源 MailboxesTab.tsx:37,202-210生效
AC-EL-OFC-MBX-022「SMTP 登录名」输入输入SMTP 字段placeholder 动态=邮箱地址(:211-213);「空=邮箱地址」读源 MailboxesTab.tsx:211-213生效
AC-EL-OFC-MBX-023「SMTP 密码」输入输入SMTP 凭据type=password 占位「••••••••」(:214-216);编辑态 label 加「(留空不改)」;新建必填读源 MailboxesTab.tsx:214-216,253-254生效
AC-EL-OFC-MBX-024「IMAP 服务器」输入输入IMAP 字段placeholder「imap.company.com」(:220-222);保存必填之一读源 MailboxesTab.tsx:219-222,253-254生效
AC-EL-OFC-MBX-025「IMAP 端口/加密」输入选择器IMAP 字段端口默认 993(:38);加密「SSL(993)」/「不加密(不建议)」(:223-231)读源 MailboxesTab.tsx:38,223-231生效
AC-EL-OFC-MBX-026「IMAP 登录名/密码」输入输入IMAP 凭据同 SMTP 口径:登录名空=邮箱地址、密码 write-only 编辑留空不改(:232-237)读源 MailboxesTab.tsx:232-237生效
AC-EL-OFC-MBX-027「日发送上限」输入输入配额字段number 默认 20(:39);label「日发送上限(新箱预热 ≤20)」(:240-242)读源 MailboxesTab.tsx:39,239-242生效
AC-EL-OFC-MBX-028状态选择器(编辑卡)选择器邮箱状态四态 warming(默认 :39)/active/paused/quota_exceeded(:243-247)读源 MailboxesTab.tsx:39,243-247生效
AC-EL-OFC-MBX-029「备注」输入(编辑卡)输入备注字段placeholder「预热批次/负责人等」(:248-250)读源 MailboxesTab.tsx:248-250生效
AC-EL-OFC-MBX-030「保存/取消」按钮按钮编辑提交禁用条件(:253-254):!email||!smtp_host||!imap_host||(新建且缺任一密码);busy「保存中…」读源 MailboxesTab.tsx:252-258生效

OFF 列级·发送任务(/offsitepromotion 邮件外联 · AC-EL-OFC-SND 系列 39 条,源码 web/app/offsitepromotion/SendTasksTab.tsx 245 行)

SendTasksTab 新建表单+任务列表(:31-202)+ TaskLogs 日志弹窗(:204-244);面板级归属见 AC-EL-OFF-052(与 SegmentsTab 同屏=「邮件外联」页签)。状态机 draft/scheduled/sending/paused/done/failed(:4 注释);发送中任务 15s 轮询(:71-76)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-SND-001GET /api/promotion/send-tasks端点任务列表加载响应 {items:Task[]}(:50);失败 setErr(:52);15s 轮询复用此调用(:72-76)读源 SendTasksTab.tsx:49-54,72-76生效
AC-EL-OFC-SND-002GET /api/promotion/email-templates(下拉)端点模板下拉源默认选 status=active 首个否则第一个(:56-59)读源 SendTasksTab.tsx:55-62生效
AC-EL-OFC-SND-003GET /api/promotion/mailboxes(下拉)端点邮箱池数据源拉全量供池 pills(:61,:135-146)读源 SendTasksTab.tsx:61,135-146生效
AC-EL-OFC-SND-004GET /api/promotion/segments端点分群下拉源segVer 变化触发刷新(建/删分群联动 :63-70);选中项消失回退首项(:67)读源 SendTasksTab.tsx:63-70生效
AC-EL-OFC-SND-005POST /api/promotion/send-tasks端点创建任务载荷 {name,template_id,segment_id,mailbox_ids,per_hour_per_mailbox||20,schedule_at||""}(:83-87);排程 toast「任务已排程,到期自动开跑」否则「任务已创建,worker 每分钟轮发」(:88)读源 SendTasksTab.tsx:78-91生效
AC-EL-OFC-SND-006POST /api/promotion/send-tasks/{tid}/{action}端点状态动作action∈launch/pause/resume(:95);toast 已发起/已暂停/已恢复读源 SendTasksTab.tsx:93-99生效
AC-EL-OFC-SND-007DELETE /api/promotion/send-tasks/{tid}端点删除任务危险确认 :102「「{n}」?其发送明细将一并删除。」读源 SendTasksTab.tsx:101-105生效
AC-EL-OFC-SND-008GET /api/promotion/send-tasks/{tid}/logs端点发送日志page&page_size=50(:208);响应 {total,page,items{kol_id,name,send_status,skip_reason,message_id,sent_at}}(:205)读源 SendTasksTab.tsx:204-211生效
AC-EL-OFC-SND-009错误横幅空态请求失败反馈error role=alert(:115);仅 send-tasks 列表失败 setErr读源 SendTasksTab.tsx:52,115生效
AC-EL-OFC-SND-010「新建发送任务」标题标签表单卡头h2 + sub「模板 × 分群 × 邮箱池 · 单箱每小时限速 · 30 天冷却去重」(:117)读源 SendTasksTab.tsx:117生效
AC-EL-OFC-SND-011「任务名」输入输入表单字段必填 :79「任务名必填」(:119)读源 SendTasksTab.tsx:78-80,119生效
AC-EL-OFC-SND-012「选择模板…」选择器选择器表单字段草稿项带「(草稿)」后缀(:120-123)读源 SendTasksTab.tsx:120-123生效
AC-EL-OFC-SND-013「选择分群…」选择器选择器表单字段选项「{name}({N}人)」int(member_n)(:124-127);必选 :80读源 SendTasksTab.tsx:80,124-127生效
AC-EL-OFC-SND-014「每箱每小时」输入输入限速字段number 默认 20;title「每个邮箱每小时最多发几封」(:128-129)读源 SendTasksTab.tsx:128-129生效
AC-EL-OFC-SND-015排程输入输入排程字段datetime-local;title「留空 = 立即开始」(:130-131)读源 SendTasksTab.tsx:130-131生效
AC-EL-OFC-SND-016「创建任务」按钮按钮表单提交busy「创建中…」禁用(:132)读源 SendTasksTab.tsx:132生效
AC-EL-OFC-SND-017邮箱池说明标签标签池口径「邮箱池(不选 = 全部启用邮箱,共 {N} 个可用)」N=active 计数(:135)读源 SendTasksTab.tsx:134-135生效
AC-EL-OFC-SND-018邮箱池 pills选择器池多选逐箱 pill 多选 toggle(:137-146);非 active opacity .45+title「({status} 不可用)」;title 含日上限读源 SendTasksTab.tsx:136-147生效
AC-EL-OFC-SND-019空池提示空态无邮箱警示「暂无邮箱——先到「邮箱设置」录入 SMTP/IMAP,空池任务会被标失败」(:147)读源 SendTasksTab.tsx:147生效
AC-EL-OFC-SND-020「发送任务」标题标签列表卡头h2 + sub「共 {int(items.length)} 条」(:153)读源 SendTasksTab.tsx:153生效
AC-EL-OFC-SND-021「任务」列列列表第 1 列name strong+note 红色副行(条件 t.note,:163-166)读源 SendTasksTab.tsx:156,163-166生效
AC-EL-OFC-SND-022「模板 / 分群」列列列表第 2 列「{template_name} / {segment_name}」(:167)读源 SendTasksTab.tsx:156,167生效
AC-EL-OFC-SND-023「邮箱池」列列列表第 3 列mailbox_ids.length 或「全部」(:168)读源 SendTasksTab.tsx:156,168生效
AC-EL-OFC-SND-024「每箱时速」列列列表第 4 列per_hour_per_mailbox 右对齐(:169)读源 SendTasksTab.tsx:156,169生效
AC-EL-OFC-SND-025「排程」列列列表第 5 列schedule_at 空「立即」(:170)读源 SendTasksTab.tsx:156,170生效
AC-EL-OFC-SND-026「状态」列列列表第 6 列六态 badge(LABELS :20-22 / TONE :23-25:draft dim/scheduled warn/sending ok/paused warn/done ok/failed bad);未知回退 dim+原值(:171)读源 SendTasksTab.tsx:20-25,171生效
AC-EL-OFC-SND-027「进度」列列列表第 7 列statsText「发 {sent} · 跳 {skipped} · 败 {failed}」(:107-111);三值全空显「—」(:109);stats 由 worker 每 tick 回写读源 SendTasksTab.tsx:107-111,172生效
AC-EL-OFC-SND-028「创建」列列列表第 8 列created_at muted(:173)读源 SendTasksTab.tsx:156,173生效
AC-EL-OFC-SND-029「操作」列按钮列表第 9 列状态机:sending→「暂停」;paused→「恢复」;非 done→「发起」(:175-181);「日志」恒显(:182);删除仅 status∉{sending,scheduled}(:183-185)读源 SendTasksTab.tsx:174-186生效
AC-EL-OFC-SND-030列表空/加载态空态列表占位「暂无任务」/「加载中…」colSpan 9 二态(:189-190)读源 SendTasksTab.tsx:189-190生效
AC-EL-OFC-SND-031发送规则底注标签口径声明「发送规则:suppression 优先跳过 · 同一达人 30 天冷却 · (任务,达人) 去重 · 单箱达日上限/时上限自动切箱 · 全池达限挂起到下窗口。」(:194-196)读源 SendTasksTab.tsx:194-196生效
AC-EL-OFC-SND-032sending 轮询标签进度刷新口径存在 sending 任务时 setInterval 15s 重拉(:72-76);注释「stats 由 worker 每 tick 回写」(:71)读源 SendTasksTab.tsx:71-76生效
AC-EL-OFC-SND-033「发送日志」弹窗标题标签日志弹窗头h2 + sub「任务 #{tid} · 共 {total} 条」(:217);680px 模态遮罩关闭(:214-216)读源 SendTasksTab.tsx:213-217生效
AC-EL-OFC-SND-034「达人」列(日志表)列日志表第 1 列name 空回退「#{kol_id}」(:224)读源 SendTasksTab.tsx:220,224生效
AC-EL-OFC-SND-035「状态」列(日志表)列日志表第 2 列LOG_LABELS 六态(:26-29:待发/已发/跳过·抑制/跳过·冷却/跳过·无邮箱/失败);badge sent ok/failed bad/其余 dim(:225-226)读源 SendTasksTab.tsx:26-29,225-226生效
AC-EL-OFC-SND-036「原因」列列日志表第 3 列skip_reason maxWidth 260+title 全文,空「—」(:227)读源 SendTasksTab.tsx:220,227生效
AC-EL-OFC-SND-037「时间」列列日志表第 4 列sent_at 空「—」(:228)读源 SendTasksTab.tsx:220,228生效
AC-EL-OFC-SND-038「尚无发送记录」空态空态日志表空行「尚无发送记录(worker 每分钟跑一次)」colSpan 4(:231)读源 SendTasksTab.tsx:231生效
AC-EL-OFC-SND-039日志分页器按钮日志分页「第 {page} / {pages} 页」pages=ceil(total/50)(:211,:235-239);越界禁用;「关闭」按钮读源 SendTasksTab.tsx:211,235-240生效

OFF 列级·任务与 KOL 面板(/offsitepromotion ✅任务/📣KOL · AC-EL-OFC-TSK 系列 81 条,源码 web/app/offsitepromotion/TasksTab.tsx 333 行)

TasksTab.tsx 含四组件:SubOrdersSection 投稿/投放回读(:22-72)+ TasksPanel 任务面板(:74-167)+ KolPanel KOL 三库+分析(:169-283)+ KolAnalysis 四分析卡(:286-332);面板级归属见 AC-EL-OFF-055/056。任务四态 STATUSES/TONE(:12-13);外联五态 OUTREACH(:14)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-TSK-001GET /api/promotion/submissions端点投稿回读响应 {items:Sub[]}(:27);失败置空(:27)读源 TasksTab.tsx:26-30生效
AC-EL-OFC-TSK-002GET /api/promotion/orders端点投放申请回读响应 {items:POrder[]}(:28);失败置空读源 TasksTab.tsx:26-30生效
AC-EL-OFC-TSK-003POST /api/promotion/orders/{oid}/approve端点审批动作载荷 {action:approve|reject}(:32);toast 已批准/已拒绝;服务端护栏见 OFF-046读源 TasksTab.tsx:31-34生效
AC-EL-OFC-TSK-004GET /api/promotion/tasks端点任务列表加载响应 {items,stats{pending,blocked,in_progress}}(:82);失败回退零值读源 TasksTab.tsx:81-84生效
AC-EL-OFC-TSK-005POST /api/promotion/tasks/{id}/status端点任务状态流转载荷 {status}(:87);成功重拉读源 TasksTab.tsx:86-89生效
AC-EL-OFC-TSK-006POST /api/promotion/tasks端点新增任务载荷 {action,product_key}(:93);action 空前端拦截(:91)读源 TasksTab.tsx:90-96生效
AC-EL-OFC-TSK-007DELETE /api/promotion/tasks/{id}端点删除任务useConfirm「删除该任务?」danger confirmText「删除」(:98);失败静默无 toast读源 TasksTab.tsx:97-100生效
AC-EL-OFC-TSK-008GET /api/promotion/kol端点KOL 三库检索kind/channel|site|high + q + platform(:179-181);响应 {items,counts,platforms}读源 TasksTab.tsx:178-183生效
AC-EL-OFC-TSK-009POST /api/promotion/kol/{kind}/{kid}/outreach端点外联状态写载荷 {outreach_status}(:186);site/high 行内下拉触发;kind=channel 服务端 400 见 OFF-061读源 TasksTab.tsx:185-188生效
AC-EL-OFC-TSK-010GET /api/promotion/kol-analysis端点分析四表响应 {platform,tiers,categories,countries} 四行集(:291);失败回退四空数组(:292)读源 TasksTab.tsx:288-293生效
AC-EL-OFC-TSK-011KPI 三卡标签任务计数待办任务/进行中/被卡任务(:106-110);blocked 红字 var(--danger);数值=stats(TSK-004)读源 TasksTab.tsx:104-110生效
AC-EL-OFC-TSK-012「⏭ 下一步动作(你现在该做什么)」清单容器置顶 SOP条件 pinned.length>0(:102,:111);条目 action 加粗+note muted(:117);非 done 显「✓ 完成」、done 显 badge ok「已完成」(:118-119)读源 TasksTab.tsx:102,111-124生效
AC-EL-OFC-TSK-013新增任务输入行输入快速添加「产品(可选)」+「新任务:要做什么…」Enter 提交(:128-130)+「+ 添加」(:131)读源 TasksTab.tsx:127-132生效
AC-EL-OFC-TSK-014「产品」列(任务表)列任务表第 1 列sku 样式,空「—」(:142)读源 TasksTab.tsx:138,142生效
AC-EL-OFC-TSK-015「动作」列列任务表第 2 列action+note 副行 t2(:143)读源 TasksTab.tsx:138,143生效
AC-EL-OFC-TSK-016「负责人」列列任务表第 3 列assigned_to 空「—」(:144)读源 TasksTab.tsx:138,144生效
AC-EL-OFC-TSK-017「状态」列(任务表)选择器任务表第 4 列行内 select STATUSES 四态(:12,:146-149:待办/进行中/被卡/完成);写端点 TSK-005读源 TasksTab.tsx:12,146-149生效
AC-EL-OFC-TSK-018「操作」列(任务表)按钮任务表第 5 列「完成」(非 done,:153)+「删」danger(:154);表头空 th(:138)读源 TasksTab.tsx:138,151-156生效
AC-EL-OFC-TSK-019「暂无任务」空态空态任务表空提示hint「上方添加;置顶清单为运营 SOP。」(:134)读源 TasksTab.tsx:133-134生效
AC-EL-OFC-TSK-020「投稿记录」标题标签投稿卡头h2 + sub「渠道投稿提交回执 · 新→旧 100 条」(:39)读源 TasksTab.tsx:38-39生效
AC-EL-OFC-TSK-021「时间」列(投稿表)列投稿表第 1 列s.at muted(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-022「产品」列(投稿表)列投稿表第 2 列s.product(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-023「渠道」列(投稿表)列投稿表第 3 列s.channel(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-024「结果」列列投稿表第 4 列s.result 空「—」(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-025「订单」列列投稿表第 5 列s.orders 空「—」右对齐(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-026「备注」列(投稿表)列投稿表第 6 列s.note 空「—」muted(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-027「暂无投稿记录」空态空态投稿表空提示hint「渠道行「投稿」弹窗提交后在此显示」(:40)读源 TasksTab.tsx:40生效
AC-EL-OFC-TSK-028「投放申请」标题标签投放卡头h2 + sub「下单弹窗提交 · pending 状态管理员可批」(:51)读源 TasksTab.tsx:50-51生效
AC-EL-OFC-TSK-029「时间」列(投放表)列投放表第 1 列o.at muted(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-030「产品」列(投放表)列投放表第 2 列o.product(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-031「渠道」列(投放表)列投放表第 3 列o.channel(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-032「金额」列列投放表第 4 列「{amount} {currency}」原币展示不折算(:57)读源 TasksTab.tsx:54,57生效
AC-EL-OFC-TSK-033「状态」列(投放表)列投放表第 5 列badge:approved ok「已批准」/rejected bad「已拒绝」/其余 warn「待审批」(st :35,:58)读源 TasksTab.tsx:35,54,58生效
AC-EL-OFC-TSK-034「备注」列(投放表)列投放表第 6 列o.note 空「—」(:59)读源 TasksTab.tsx:54,59生效
AC-EL-OFC-TSK-035「操作」列(投放表)按钮投放表第 7 列pending 显「批准」「拒绝」两按钮(:60-64),其余 muted「—」(:65);端点 TSK-003读源 TasksTab.tsx:54,60-65生效
AC-EL-OFC-TSK-036「暂无投放申请」空态空态投放表空提示hint「渠道行「下单」弹窗提交后在此显示」(:52)读源 TasksTab.tsx:52生效
AC-EL-OFC-TSK-037KOL 四页签选择器库切换KOL 渠道/测评站/高优清单(带 counts 千分位计数 :195-197)/📊 数据分析(:198);单选切 kind读源 TasksTab.tsx:194-199生效
AC-EL-OFC-TSK-038「全部平台」选择器(KOL)选择器渠道库过滤仅 kind=channel 显示(:200-205);选项「(空)」映射 value=""(:203);来自响应 platforms facets读源 TasksTab.tsx:200-205生效
AC-EL-OFC-TSK-039「搜索名称 / 邮箱 / 域名」输入输入KOL 搜索Enter 触发 load(:207-208)读源 TasksTab.tsx:207-208生效
AC-EL-OFC-TSK-040「频道」列(channel 表)列渠道表第 1 列名称 ellipsis 240(:222)读源 TasksTab.tsx:218,222生效
AC-EL-OFC-TSK-041「平台」列(channel 表)列渠道表第 2 列muted(:223)读源 TasksTab.tsx:218,223生效
AC-EL-OFC-TSK-042「订阅」列列渠道表第 3 列fmtK 千分位空「—」(:189,:224)读源 TasksTab.tsx:189,218,224生效
AC-EL-OFC-TSK-043「最高播放」列列渠道表第 4 列fmtK 千分位 muted(:225)读源 TasksTab.tsx:218,225生效
AC-EL-OFC-TSK-044「地区/类目」列列渠道表第 5 列arrS 数组 join「·」非数组原值空「—」(:190,:226)读源 TasksTab.tsx:190,218,226生效
AC-EL-OFC-TSK-045「联系」列(channel 表)链接渠道表第 6 列email→mailto 链接;无 email 有 url→外链新窗「链接」;皆无「—」(:228-230)读源 TasksTab.tsx:218,227-231生效
AC-EL-OFC-TSK-046「站点」列(site 表)链接测评站表第 1 列https://{domain} 外链新窗+name 副行(:242)读源 TasksTab.tsx:238,242生效
AC-EL-OFC-TSK-047「类目」列(site 表)列测评站表第 2 列category 空「—」(:243)读源 TasksTab.tsx:238,243生效
AC-EL-OFC-TSK-048「优先级」列列测评站表第 3 列★×min(3,priority),空「—」(:244)读源 TasksTab.tsx:238,244生效
AC-EL-OFC-TSK-049「联系」列(site 表)链接测评站表第 4 列emails→原文;否则 contact→外链「联系页」;皆无「—」(:245)读源 TasksTab.tsx:238,245生效
AC-EL-OFC-TSK-050「外联状态」列(site 表)选择器测评站表第 5 列行内 select OUTREACH 五态英文原值(:14,:247-251);默认 pending;写端点 TSK-009读源 TasksTab.tsx:14,246-252生效
AC-EL-OFC-TSK-051「频道」列(high 表)列高优表第 1 列name+platform 副行(:263)读源 TasksTab.tsx:259,263生效
AC-EL-OFC-TSK-052「主类目」列列高优表第 2 列category 空「—」(:264)读源 TasksTab.tsx:259,264生效
AC-EL-OFC-TSK-053「联系」列(high 表)链接高优表第 3 列email→mailto,无「—」(:265)读源 TasksTab.tsx:259,265生效
AC-EL-OFC-TSK-054「外联状态」列(high 表)选择器高优表第 4 列同 OUTREACH select(:267-271)读源 TasksTab.tsx:259,266-272生效
AC-EL-OFC-TSK-055「无匹配」空态空态KOL 表空提示EmptyState title「无匹配」(:213)读源 TasksTab.tsx:213生效
AC-EL-OFC-TSK-056KOL 底注标签同步口径声明「资源库同步自公司 KOL 库(增量:粉丝数/邮箱等自动更新,你标的外联状态不会被覆盖);联系邮箱可直接点击发信。」(:279)读源 TasksTab.tsx:279生效
AC-EL-OFC-TSK-057分析四卡共用 DataTable容器表格骨架mk() 统一构造(:295-309):列带 sortValue/csv/filter(文本列 text/数值列 num);caliber 口径条「站外推广分析表口径:数量=个/件|数据源=promotion_* 推广渠道库(只读库更新)|按平台/层级/类目/国家分组统计。」(:306);loading/empty「无数据」内置读源 TasksTab.tsx:294-309生效
AC-EL-OFC-TSK-058「平台效果分析」表图表分析卡 1h2 sub「互动率 = (均赞+均评)/均播 · 100K+ 占比按订阅」(:313);7 列 平台/KOL 数/平均粉丝/总粉丝/平均播放/互动率%/100K+ 占比%(:314-315);行集=d.platform读源 TasksTab.tsx:312-316生效
AC-EL-OFC-TSK-059「粉丝量级性价比」表图表分析卡 25 列 量级/KOL 数/平均粉丝/平均播放/平均最高播放(:319-320);行集=d.tiers读源 TasksTab.tsx:317-321生效
AC-EL-OFC-TSK-060「品类分布」表图表分析卡 34 列 品类/KOL 数/平均粉丝/平均播放(:324);行集=d.categories读源 TasksTab.tsx:322-325生效
AC-EL-OFC-TSK-061「国家分布」表图表分析卡 44 列 国家/KOL 数/平均粉丝/平均播放(:328);行集=d.countries读源 TasksTab.tsx:326-329生效
AC-EL-OFC-TSK-062「平台」列(平台效果分析)列分析卡 1 第 1 列平台名 text 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-063「KOL数」列(平台效果分析)列分析卡 1 第 2 列数值 num 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-064「平均粉丝」列(平台效果分析)列分析卡 1 第 3 列数值 num 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-065「总粉丝」列(平台效果分析)列分析卡 1 第 4 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-066「平均播放」列(平台效果分析)列分析卡 1 第 5 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-067「互动率%」列(平台效果分析)列分析卡 1 第 6 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-068「100K+占比%」列(平台效果分析)列分析卡 1 第 7 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-069「量级」列(粉丝量级性价比)列分析卡 2 第 1 列粉丝量级档 text 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-070「KOL数」列(粉丝量级性价比)列分析卡 2 第 2 列数值 num 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-071「平均粉丝」列(粉丝量级性价比)列分析卡 2 第 3 列数值 num 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-072「平均播放」列(粉丝量级性价比)列分析卡 2 第 4 列数值 num 列(:320);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-073「平均最高播放」列(粉丝量级性价比)列分析卡 2 第 5 列数值 num 列(:320);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-074「品类」列(品类分布)列分析卡 3 第 1 列类目 text 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-075「KOL数」列(品类分布)列分析卡 3 第 2 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-076「平均粉丝」列(品类分布)列分析卡 3 第 3 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-077「平均播放」列(品类分布)列分析卡 3 第 4 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-078「国家」列(国家分布)列分析卡 4 第 1 列国家码 text 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-079「KOL数」列(国家分布)列分析卡 4 第 2 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-080「平均粉丝」列(国家分布)列分析卡 4 第 3 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-081「平均播放」列(国家分布)列分析卡 4 第 4 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效

§12 尺子↔注册表对账·全指标一一对应施工清单(2026-10-25 用户令「做呗」立册)

定谳回顾(架构三层,2026-10-22 拍板「最根本解」+2026-10-25 用户重申):① audit-base=尺子(人读全量标准:所有接口/所有公式/所有列级,最细颗粒度);② 注册表+视图=机器真源(metric_calibers 25 行+audit schema 10 视图+endpoint_registry 215 行+brands_source.source_map+TenantInfo.brand_colors——公式当初议过放 REST API 层,定谳弃之:API 是消费端不是真源,门禁/worker/MCP 不走 HTTP 取公式,放 API 层=真理藏在 N 个消费者之一里,物理上防不了第二份;DB 是所有进程唯一共享下层,视图单实现让第二份口径 SQL 没有入口);③ 一切消费端派生(api 11 router+advisor/core/sync_source/metrics、门禁 7 脚本、MCP、web 2 文件——20 个文件实证在读注册表;REST API 的正确角色=分发面,如 /api/metric-thresholds)。
对账结论(§1–§10 共 63 条+PEND 2 行,批F 收口后 2026-10-25 复点):✅ 一一对应 26 条(三高危口径族全绿:CAL-01/02/03/04/05/06/09/11/15/16/18、FIN-01/04、PIPE-05、SEC-04、UI-07、ADS-02、ADS-04 调参层、OPS-07、PEND-01 分摊、KPI 门禁消费端)|◐ 部分 8 条(主体在册余参数/语义锚)|✗ 缺 0 条(批A 清零;§12 建表时 PEND-01 误记待拍板系陈账,实已 2026-10-24 拍板闭卷)|— 纪律/流程型 31 条(无数值参数,批B 仅加互引锚;FIN-02 批E 转数值型)。面级缺口(批C/批D 已闭):§11 引用核对已机器化(批D R6,悬空 0+抽检 39/40);接口面=audit-base §12 接口全量册 400 端点入尺(批C);余=§12 全量册 67 行无 §11 锚端点(noonops 写面/finance 明细/internal/MCP,§11 未逐条描述,补锚挂账)。
尺子条目标准要点注册表视图消费端(派生实证)状态施工批次
AC-CAL-01净利 net_profit(amz)id17v_amz_net_profit_monthlyfinance.py summary/kpi-wall、caliber_recon、dashboard_audit✅ 一一对应—
AC-CAL-02有效订单 orders/orders_allid4(exclude_status 单源)v_amz_orders_dailydashboard/finance/matrix+门禁 20 处派生+four_layer(10-25 起)✅ 一一对应—
AC-CAL-03Noon 广告归因分层id2(聚合)+id18/19(SKU)v_noon_ad_spend_daily+v_noon_ad_sku_daily/monthlyads.py/finance/brandboard/mcp✅ 一一对应—
AC-CAL-04Amazon 广告归因id1+id25v_amz_ad_spend_daily+v_amz_ad_spend_sku_dailyads.py/dashboard✅ 一一对应—
AC-CAL-05Noon 本币折 USDid6(pegged)+id13(fx_daily)—(fxd 函数)全金额消费端✅ 一一对应—
AC-CAL-06ACOS 健康线/BID_CALCid16(health_line ✅)+id26(bid_calc 公式语义锚 ✅)—core.health_line()+/api/metric-thresholds 下发;BID_CALC 参数族全 ads_rule_config(grp=advisor)派生✅ 一一对应批A 已落 2026-10-25:id26 注册(公式+8 参数 defaults+护栏 [0.01,200]+免噪音门),advisor.py 零改动(参数本已 DB 驱动)
AC-CAL-07fm 三方对账口径(语义型)—finance monthly+caliber_recon B 组◐ 部分批B:语义行+互引锚
AC-CAL-08回款层口径id8(settle_abnormal>14d)—sync_source 回款异常◐ 部分批B:锚补全
AC-CAL-09汇率源(两层同查)id13—core fx 派生(rules_ads 兜底已并)✅ 一一对应—
AC-CAL-10SKU 宇宙=sku_mappingid3(cost_rmb)—层端血缘过滤 EXISTS◐ 部分批B:宇宙规则语义行
AC-CAL-11品牌归属 brand_fixid30(brand_fix 语义锚 ✅)—api/clean_audit.py SPECIAL_TABLES 三路单实现(brand_fix/campaign_brand_fix/fees_brand_fix)✅ 一一对应批A 已落 2026-10-25:id30 注册(sku_col×3 映射+精确命中才纠正+多数投票+账号宪法键+zf 行×onno 订单两路防双计)
AC-CAL-12noon SKU 月表币种id19(关联)v_noon_ad_sku_monthlyfinance monthly◐ 部分批B:币种语义锚
AC-CAL-13矩阵幽灵维(禁硬编码)——matrix dimensions DISTINCT— 纪律/流程型批B 锚
AC-CAL-14口径级联三处被级联方已注册—流程纪律(P2a 教训)◐ 部分批B:级联清单锚
AC-CAL-15口径视图族单实现id1/2/4/5/17/18/19/2510 视图全8 消费文件+MCP+门禁✅ 一一对应—(速览层即映射表)
AC-CAL-16Noon 有效件=units−cancelledid5(尾列 units_valid)v_noon_orders_dailynoon KPI✅ 一一对应—
AC-CAL-17展示页禁公式(原值直读)——rankings 端点— 纪律/流程型—(本条标准即「无公式」)
AC-CAL-18仓储费对账(报表⊗专表)id27(storage_fee_recon 数值真源 ✅)—审计时对账复算(暂无常驻脚本;未来建门禁须派生 id27 禁内联)✅ 一一对应批A 已落 2026-10-25:id27 注册(fee_month−1+税差 JP10/SA15/AE5+±1USD 平阈+trueup 挂行+LTSF/Vine 不掺+P2-15 不混入)
AC-FIN-01summary net_basis+top/lossid17 关联v_amz_net_profit_monthlyfinance.py✅ 一一对应—
AC-FIN-02净利率红旗>50%id34(flag_ratio 0.5 真源先行 ✅)—复盘检查(未来复盘门禁须派生 id34 禁再发明)✅ 一一对应批E 已落 2026-10-25:id34 注册(0.5+连续月基+口径嫌疑→人工复核;无常驻消费端=真源先行)
AC-FIN-03monthly 读 fm 侧id21/22(basis)—finance monthly+basis 标签◐ 部分批B:fm 口径锚
AC-FIN-04SKU P&L ad 列id1/18/19视图族finance product-pl✅ 一一对应—
AC-FIN-05服务费链路——worker ingest(zf 2026-09=−728.73 锚)— 纪律/流程型批B 锚
AC-ADS-01深度分析(分列/北京锚)id2+id16+id35(tz 双锚/窗规则 ✅)视图族ads.py✅ 一一对应批E 已落 2026-10-25:id35 注册(Riyadh/Shanghai+from/to 精确优先);_noon_tz/_daywin/5 处 SQL 内嵌 tz 全部派生化
AC-ADS-02停更告警 stale_days(as-built 7d)id28(ads_staleness 数值真源 ✅)—api/tasks.py ads_staleness_alarm 派生 id28(回退冻结锚 7;批A 改引,内联字面量清零)✅ 一一对应批A 已落 2026-10-25:id28 注册(7d+Amazon 两表 as-built);audit-base 条目同刻改写收敛——原文「Noon 表+26h/11d」系 P1-2 设计稿≠as-built(第二份口径即缺陷);onno CSV 断供改由晨检第 6 面覆盖
AC-ADS-03导入即拒链——ads_imports 创建期校验— 纪律/流程型—
AC-ADS-04广告规则引擎调参层(分层真源)id36(ads_rules_engine 键目录 60 键 ✅)+id26(BID_CALC 基准)—advisor.py+rules_ads.py 读 ads_rule_config;ruler_recon R8 键集/基准/镜像三核执法✅ 一一对应批F 已落 2026-10-25:调参层只存 per-brand 覆盖(键 ⊆ id36 目录;值=基准的行应删);新键须先迁移入册
AC-KPI-01KPI 卡 desc/脚注必标——dashboard_audit 断言— 纪律/流程型—
AC-KPI-02今日页对账id4 派生(10-25 起)—four_layer 面2— 纪律/流程型—(门禁即消费端)
AC-KPI-03merged-kpi 双模——dashboard— 纪律/流程型—
AC-PIPE-01清洗三去重恒等式——clean_audit— 纪律/流程型批B 锚
AC-PIPE-02原子交换 swap——clean 层— 纪律/流程型—
AC-PIPE-03RLS 三件套——DDL 审计 SQL— 纪律/流程型—
AC-PIPE-04staging 最细键——DDL 比对— 纪律/流程型—
AC-PIPE-05动态规格注册表brands_source.source_map(另一注册表实体,机器源已立)—动态 spec 生成✅ 一一对应—
AC-PIPE-06docker exec 必带 -i——操作规程— 纪律/流程型—
AC-SEC-01数据浏览器双拦——db router— 纪律/流程型—
AC-SEC-02源库字典租户域——dictionary router— 纪律/流程型—
AC-SEC-03上传面白名单id33(三上传面 ✅)—上传端点✅ 一一对应批E 已落 2026-10-25:id33 注册(collab 15 类/50MB+ads 导入 3 类/50MB+listing 10MB);三消费端 caliber_filters 派生+冻结锚回退
AC-SEC-04端点快照 202→215endpoint_registry(215 行,机器源已立)—audit_nodes 第四道门✅ 一一对应批C:与 §11/尺子互引
AC-SEC-05停用租户断流——采集/摄取/清洗— 纪律/流程型—
AC-SEC-06特权通道强制层——P1-3 强制层— 纪律/流程型—
AC-GATE-01caliber_recon 跨层对账读注册表派生视图族caliber_recon— 纪律/流程型—(对账机器本身)
AC-GATE-02四道门禁——门禁族— 纪律/流程型—
AC-GATE-03四层审计 06:35id4 派生(10-25 起)—four_layer_audit— 纪律/流程型—
AC-GATE-04e2e 串行律——过程纪律— 纪律/流程型—
AC-GATE-05门禁夜跑五门——crontab 19:10— 纪律/流程型—
AC-GATE-06浏览器跨会话互斥——过程纪律— 纪律/流程型—
AC-GATE-07门禁三租户覆盖——四门禁三租户— 纪律/流程型—
AC-UI-01口径说明元素id17 等文案源—frontend_e2e 断言— 纪律/流程型—
AC-UI-02NoonTab 品牌参数——e2e 断言— 纪律/流程型—
AC-UI-03Settings 凭据面——e2e 断言— 纪律/流程型—
AC-UI-04768 布局——e2e 视口断言— 纪律/流程型—
AC-UI-05含首尾标注/400——探针— 纪律/流程型—
AC-UI-06ASN 校验正则id32(pattern 真源 ✅)—接口复测✅ 一一对应批E 已落 2026-10-25:id32 注册;noonops.py _asn_ok 改派生(冻结锚回退)
AC-UI-07品牌色级联brand_colors 注册表(TenantInfo 机器源已立)—brandColor()✅ 一一对应—
AC-OPS-01部署窗口——过程纪律— 纪律/流程型—
AC-OPS-02部署顺序——部署记录— 纪律/流程型—
AC-OPS-03回滚锚点——锚点台账— 纪律/流程型—
AC-OPS-04git 纪律——过程纪律— 纪律/流程型—
AC-OPS-05发布面两页分工——diff 审查— 纪律/流程型—
AC-OPS-06破坏性 SQL 挂起——pending-db-ops 台账— 纪律/流程型—
AC-OPS-07mercury 保留 5 份id29(offsite_backup_keep 拍板值登记 ✅)—mercury prune_offsite_backups.sh(外部脚本无 DB 直连——调整保留数先改注册行再人工同步脚本)✅ 一一对应批A 已落 2026-10-25:id29 注册(keep_per_series=5+04:40 UTC 日档+五系列+盘 79%→76% 记录)
AC-PEND-01(已拍板闭卷)id31(svc_fee_allocation 分摊语义锚 ✅)—api/sync_source.py _SVC_BRANCH_CONSIGN(A① 2026-10-24 单实现:按销售额分品牌+一份基数+尾差归宿主)✅ 一一对应批A 补录 2026-10-25(迁移 129):§12 建表时误记「仍待拍板」系陈账——AC-PEND-01 已 2026-10-24 拍板闭卷、消费端已单实现,本批补语义锚对齐
AC-PEND-02views 单实现(本文档的母令)———— 纪律/流程型—

§12.1 施工分批(每批=注册先行→消费端改派生→门禁对账→本表随修随换)

  • 批A 数值参数补注册(✗5+◐候选):✅ 已落 2026-10-25(9.44 台账,迁移 128+129,id26–31) 五项全清+批A 补录 PEND-01(id31,§12 建表「仍待拍板」系陈账,实已 2026-10-24 拍板闭卷);ADS-02 as-built=7d 单阈值(原文 26h/11d 双阈值系 P1-2 设计稿≠代码实况,条目同刻改写收敛);候选四项(FIN-02/SEC-03/UI-06/ADS-01)归批E 内联清零统一处置。
  • 批B 一一对应机器锚:✅ 已落 2026-10-25(9.45 台账,迁移 130–132) metric_calibers 加 audit_base_ref 列(31 行全回填,§1–§10 AC-* 级 24 行/§11 EL 级 7 行,131 精确化 6 行到条目级);audit-base 条目反向挂 reg:idN 锚(57 核心+13 EL+CAL-06 补 id16);as-built:endpoint_registry 不加尺子引用列(端点↔尺子面由批C §12 全量册承担);门禁 tools/ruler_recon.py R1–R4(存在/存在/恒等/零漏锚)首跑抓 2 处不恒等即修——立哨即抓=校验面有效。
  • 批C 接口全量册:✅ 已落 2026-10-25(9.46 台账) audit-base 立「§12 接口全量册」——as-built:机器源=live /api/openapi.json(认证拉取)×endpoint_registry,347 路由路径/400 method×path 端点逐行入册(方法|路径|路由域|作用|尺子锚|注册表六列);独立校对 fork:C1 行完整性/C2 注册表标注/C4 HTML 完整性 PASS,C3 抓浅前缀锚 51 处(剥前缀回退锚到错误条目)→ 锚规则收敛为路径精确匹配({参数}归一),67 行诚实无锚(noonops 写面/finance 明细/internal/MCP,§11 未逐条描述,补锚挂账);live GET 漂移=0(15 未入册 GET 全命中 exclude 豁免)、registry-only=0。
  • 批D §11 公式逐条核对:✅ 已落 2026-10-25(9.47 台账) 机器面:2624 条 §11 条目引用零悬空(视图跨三库实存/端点在册);R6 门禁化(§11 引用核入 ruler_recon);语义面:分层抽检 40 条 → 39 相符 · 1 实锤缺陷即修(AC-EL-SRC-03「16 站」实况 15 站,IN 已删而数字未随改——状态随修随换违背,同刻纠正);附观察:条目内代码行号指针随版本漂移(语义全符),行号类引用宜加「约」。
  • 批E 消费端残余内联清零:✅ 已落 2026-10-25(9.48 台账,迁移 134+135) id32–35 入册(asn_input/upload_limits/net_margin_flag/ads_time_window)+消费端五处改 caliber_filters 派生(noonops ASN 正则、collab/ads/listing 三上传面、ads 时区锚 _noon_tz/_daywin+5 处 SQL 内嵌 tz 字面量);R5 内联清零门禁(INLINE_CONTRACTS 6 契约)+夜跑第 6 门 ruler_recon 接入;R3 立哨再抓 2 处(id2/id16 ref 补 AC-ADS-01+多值锚格式归一数字型)。
  • 批F 分层真源+调参层纪律:✅ 已落 2026-10-25(9.49 台账,迁移 136) 用户拍板「做」:metric_calibers=口径层(定义/公式/基准)/ads_rule_config=调参层(只存 per-brand 覆盖,键 ⊆ id36 目录,值=基准的行应删);视图保持烘焙+R7 烘焙恒等门禁;id26 defaults 键名对齐 advisor 实名+recut_days 补册(值零变化)+id16 scale_up_link+id36 调参层键目录 60 键(AC-ADS-04 新增)+metric_calibers_id_seq 修复;消费端 advisor(BID_DEF/BID_GUARD)+clean_audit(brand_fix sku_col 三面)改派生;R5 契约 6→19+新 R7(视图烘焙逐比较位恒等,自咬双向验证)+新 R8(键目录/BID 基准/镜像三核);部署 09:27 UTC 六门全绿。
纪律(沿既有拍板):每批部署避开 19–22 UTC/整半点/02:00;数值批先 audit-base 条目后代码(AC-CAL-14 级联);独立复算后采纳;本表状态随修随换、正文只增不删。

附 · audit-base 版本日志全文收档(v1–v5.15,2026-10-21→2026-10-24)

audit-base.html 按用户 2026-10-24 裁定改为纯标准库——只载标准/规范/要求,不载任何记录;其页尾变更记录链(v1–v5.15 全 16177 字符)整体迁出,原文全文存档于下:


变更记录:v1 2026-10-21 初版 54 条(口径13 / 财务5 / 广告3 / KPI3 / 管道6 / 权限6 / 门禁4 / UI6 / 运维6 / 待拍板2)+ 根本纪律3 · 建立动因:净利口径二轮收口 + 用户令"每一个功能、每一个元素、口径等单独做一个验收标准"。验证工具:tools/caliber_recon.py(新增)、既有四道门禁。
v2 2026-10-21(#33/P3-5 修复验证轮):AC-UI-03/04/05 待修→生效(Settings tab 作用域渲染 + 768 溢出归零 + 含首尾标注,探针 PASS);新增 AC-UI-07 品牌色级联;计数 55 条 / 53 生效 / 0 待修。
v3 2026-10-22(P2a 口径级联补齐轮):新增 AC-CAL-14 口径级联三处缺一不可(注册表先行→全部读面→门禁基准;当日 final 门禁后禁部署不补跑)+ AC-GATE-05 门禁夜跑五门(P1-13/P1-3,19:10 UTC,SMTP 降级兜底禁假成功)+ AC-GATE-06 浏览器门禁跨会话互斥(爬虫事故教训,档案=audit.html 10.4);剔取消两/三变体字面量并存披露(实测仅 'Canceled'×2670 行为等价,统一归 AC-PEND-02);计数 58 条 / 56 生效 / 0 待修 / 2 待拍板。
v4 启动 2026-10-22(用户令:每一页所有元素的描述与定义,全量最细颗粒度):立 §11 逐页元素标准 AC-EL-<页>-<序号>,44 路由 + AppShell + 19 共享组件全量入表,逐页从源码实证生成;首批=业务数字面(首页/today/orders/finance/ads/sourcing)。
v4.1 2026-10-22 首页金标落地:AC-EL-HOME 结构 49 条(工具栏4/报警5/KPI5/合并视图保留7/图表墙12/区块头空态4/Noon 两表级+列11/自定义模块1)+ 图型逐条 AC-EL-HOME-A80…/N22…(脚本自 dashboard.py charts spec 机械提取,标准=端点逐字一致)+ AC-EL-SKU 主表 25 条;KpiDeck ⓘ 口径说明表 5 处文案过时挂 AC-EL-HOME-14 待修(AC-CAL-02 违背,UI 文案=口径的一部分)。


v4.2 2026-10-22 首批续落:§11.4 TODAY 32 / §11.5 ORDER 26 / §11.6 FIN 64 / §11.7 NOON 42 共 164 条(源码实证,建档·待验);HOME 清单行补登 v4.1 落档计数(49+图型+25,生效·1待修);新记待核 5 项——FIN kpi-wall 分市场表 th17 vs td18 列头错位候选、FIN Noon 深度表「39 列」文案 vs NOON_SPEC 44 项、FIN「有效订单」双实现(前端 orders−canceled vs aord FILTER,归 AC-PEND-02 统一)、NOON 评论「757 条」写死文案、NOON 流量表营收列未随行标币种(AC-CAL-05 披露缺口);FIN 六张大表列级条目与 ADS/SRC 下一批续入。
v4.3 2026-10-22 首批六页全量落库:§11.8 SRC 82 条(71 生效 / 11 待核=5 图表墙逐图+6 外部 tab 组件内部元素另册)+ §11.9 ADS 169 条(159 生效 / 9 待核=晨报·建议·监测·dayparting·noon keywords/recommendations 源表+add_target 端点+noonfees / 1 待深化=CustomModules 归 AC-EL-CMP);修正 v4.2 批次误将 HOME 计数写入 /ads 清单行(已复核对无行级影响)。
v4.4 2026-10-22:§11.7 NOON 依校对报告修复 5 处转档缺陷——3 处待核内容恢复并标 p-warn(评论「757 条」写死文案不随采集扩窗、流量表营收列未随行标币种)、#023 补回 AC-CAL-12 本币分列引用、#019 fee_cov 竖线错位修复、#003 端点笔误更正 /api/noon/summary;本节 42 条经三方核对(清单→转档→diff 校对)转 39 生效 + 3 待核。。
v4.5 2026-10-22:§11.4/§11.5 校对通过(ORDER 零缺失零凭空;TODAY 缺 1 已补 T-001 数据日锚规则=max(purchase_date)/max(order_placed_at::date) 对齐订单最大日+fittingirls 案例溯源;另修 ORDER-018 status_cn||status 回退表达式截断、杂字符 f 清理),58 条转生效;§11.6 FIN/§11.8 SRC/§11.9 ADS 校对进行中。
v4.6 2026-10-22:§11.6 FIN 校对通过(64/64 完整,缺失 0 / 截断 0 / 凭空 0;口径引用 AC-CAL-01/02/05/06/07/08/12 与 10 条页级拍板溯源全在场;057 管道符转全角属规范化),62 条转生效 + 2 条标 p-warn 待核(019 kpi-wall th17 vs td18 列头错位候选挂浏览器 DOM 验收、031 「39 列」文案 vs NOON_SPEC 44 项挂文案-代码核对),待核③有效订单双实现归口 AC-PEND-02 保留于表后注记。
v4.7 2026-10-22:§11.9 ADS 校对通过——169/169 全齐 ID 连续,9 处待核(009/019/045/046/111/137/141/143/145)全部 p-warn 在位,NOON 型管道错位 0 命中,口径引用 AC-CAL-03/04/05/06 与写操作九层护栏/BID_CALC 等特征串全在,丢失 0 凭空 0;维持 159 生效 / 9 待核 / 1 待深化。
v4.8 2026-10-22:§11.8 SRC 校对通过——82/82 全齐,11 项待核(5 图表墙逐图 + 6 外部 tab 组件)全部 p-warn 且另册注记在位,4 条全局注记保留,管道符转义无误(无 §11.7 型错位),md 计数锚点全在,「同上」规范化为交叉引用属改进;维持 71 生效 / 11 待核。已知排版差异:各节 ID 位数不一(HOME/SRC 两位 vs TODAY/ORDER/FIN/NOON/ADS 三位),ID 全局唯一不受影响,仅记录不统一。
v4.9 2026-10-22:AC-EL-HOME-14(KpiDeck ⓘ 口径说明表)5 处过时文案修复上线——代码 KpiDeck.tsx 5 spot 对齐 AC-CAL-02,快照 backups/KpiDeck-pre-kpifix-20261022.tsx;部署链=基线 e2e ALL PASS(201) → docker compose build+up web(31f9b5812522,04:1x UTC 避开 19-22 广告档/整半点/02:00)→ 部署后 e2e ALL PASS(0 FAIL) → 公网新 chunk 字节验证;pill 待修→生效。§11 首批六页 591 条全部落档收口(唯一待修项清零)。
v5.0 2026-10-22 §11 批次二全量落库:§11.10–§11.28 共 19 节 1015 条(STL24/SET43/BIL24/BKF33/DB31/DIC20/DOC23/ACC24/TEAM44/AI17/PIPE48/BRD+BRDN68/ONB+OFB44/AUTH55/REDIR+HLP+LEGAL86/SHELL16/CMP55/FIN-C173/SRC六tab187),七路并行源码实证 + 七路独立 diff 校对,抓出并修正转档/编造缺陷 40+ 处(重者:BIL-004 静默吞错表述、STL-011 编造行链接、FIN-C057..100 行号等差编造→改区间引、CMP-039 BrandBoard EN 映射未接线、SHELL-012 抽屉断点 768→980、AUTH-002 形态张冠李戴);状态 1004 生效 / 6 待核 / 3 待修 / 1 待拍板 / 1 待深化——待修三条(C003/C008 分市场表 17 th vs 18 td 列错位、C049 「39 列」文案 vs NOON_SPEC 44 项)坐实 v4.2 所记 FIN 待核①②,升待修;LEGAL-022 价格分歧坐实(条款页 Growth $149 vs billing.py growth=199、条款 Enterprise 无价 vs 499)待拍板以哪侧为准;OFB-011 /srv/offboarding 归档去向仍挂账。清单表 19 行 + AppShell/组件 2 行翻「已建 v5.0」,/finance、/sourcing 行增深化注记。§11 累计 1606 条。快照 backups/audit-base-pre-v5-20261022.tgz。
v5.1 2026-10-22(批次三收官·九路由全量入 §11.29–§11.37):LOG51(物流 ASN)/LST159(Listings)/RANK84(排名)/PRD40(产品)/INV57(库存台账)/MAP47(SKU 映射表)/PO76(采购单)/PRJ64(项目)/OFF65(站外促销)共 643 条;状态 637 生效 / 2 待核(LOG-028 燕文管道承诺句、LST-063 dead-branch)/ 1 待修(LST-062 Impex 子页仍用旧 Impex 端点 vs Content API upsert)/ 1 未上线保留(LST-140)/ 2 待建(OFF InboxTab 组件未上线)。校对=四路独立只读 fork 源码 diff:b3-f3 23 处缺陷已修(20 处行号漂移 + RANK-082 仅 noon 源带 try/except 兜底 + RANK-074 样本上限 N≤150 非 300 + RANK-042 UK→GB 归一仅榜单/历史两处、markets 端点无归一)、b3-f4 6 处已修(PO-004/006、OFF-049/050/057/064)、b3-f2 3 处已修(LST-131 noon 任务表列数 8→7 实证 7 列、LST-042 autoBind 取词链补全、LST-147 FilesTab 卡头文案补登;132 个行号引用零漂移)、b3-f1 11 处已修(LOG-004/005/006 KPI 卡面标签「在途/累计签收/阶段超时」+foot 两数并列非相加、LOG-011 跳过子句条件渲染、LOG-024 stepper 实 15 段、LOG-027 无 Esc 监听、LOG-031 型号目录漏 Luna Neo、INV-008 _MP_NORM 13 国非 17、INV-038 dtype=PO 供应商分支=死代码永不渲染、INV-030 状态文案、PRD-028 国家缺省回退「?」);INV-040 待核转生效(台账引擎三行为实证:移动加权平均 services.py:113-150、单事务幂等 inv.py:186-194、净额反向冲销 inv.py:248-269)。更正 v5.0 两处清单翻牌错误:/offsitepromotion 当时误翻「24 条」实为零条目,现按 §11.37 实计更正;/privacy·/terms·/feishu 漏翻补正(§11.24 LEGAL 41 条:40 生效 / 1 待核 LEGAL-022 条款页与 billing.py 价格分歧仍待拍板)。九行清单翻「已建 v5.1」,§11 累计 2249 条,44 路由+AppShell+共享组件全量建档完毕。快照 backups/audit-base-pre-v51-20261022.tgz。
v5.1a 2026-10-22:LEGAL-022 价格分歧拍板落地(用户拍板以 billing.py 为准)——条款页 Growth $149→$199、Enterprise 定制→$499(terms/page.tsx:20),web 镜像重建上线(47/47 页编译),线上 /terms 与 BILLING_PLANS 双侧核验一致,frontend_e2e 门禁 ALL PASS(日志 tools/_gate_terms_price_20261022_frontend_e2e.log),LEGAL-022 待核转生效,/privacy·/terms·/feishu 清单行改 41 条全生效;分歧实证记录保留于条目定义列作审计痕迹。快照 backups/audit-base-legal022-20261022.tgz。

v5.1b(2026-10-22)SRC 待核清理 + 当日修复补记:① SRC-77/78/79/80/81/82 待核→生效——「内部元素另册」条件已由 §11.28(W/V/S/D/F/X 六系列 187 条)满足;SRC-82 端点归属实证=专列 router api/routers/verdicts.py。图表墙逐图另册(SRC-17/18/19/20/52)仍未建,保持待核;§11.6 清单行改 82 条(77 生效 / 5 待核)。② 补记同日早前四处换绿(证据在各条定义列+门禁日志):LOG-028 补用户确认记录(仍待核)、FIN-C-003/C-008 补「在途 Pending」表头、LST-062/063 Impex→Content API+死分支删、FIN-C-049 39→44 列。快照 backups/audit-base-src6-20261022.tgz。

v5.1c(2026-10-22)ADS 9 条待核源表核验换绿(独立只读 fork 逐行读 handler,行号零漂移):ADS-009 晨报五源表/ADS-019 ads_advice/ADS-045+046 ads_campaign_monitor+7 天窗 23:10 UTC/ADS-111 sales_hourly+cleaned_noon_orders/ADS-137+141+145 noon_data.py 品牌schema 采集表三组——待核句全部替换为实表名+行号;ADS-143 特记:UI「待通道」仍准确(add_target 一键通道故意 400),但加词执行端点已实证投产=exec_rec_accept:785(accept/{recId},经建议队列 add_keyword 决策调用)。noon 三端点共注 tenant_noon_schemas 隔离路由(ISO-01)。/ads 清单行改 169 条(168 生效 / 1 待深化)。全库待核 21→12(余=SRC 图表墙 5·逐图另册未建、NOON 3·写死文案待拍板、STL-024/BKF-014·实现在他层、PIPE-029·判定归属待拍板、LOG-028·等燕文管道)。快照 backups/audit-base-ads9-20261022.tgz。

v5.1d(2026-10-22)STL-024/BKF-014 他层实现核验换绿(只读 fork 逐行读同步层与 worker):STL-024=sync_source.py 起点三品牌分列推导/has_finance 双视图+onno settled 微差注记/is_abnormal 统一 14 天未回款;BKF-014=Redis 租户信号量 limit=1/DELETE+ON CONFLICT 幂等回写/public.backfill_snapshots JSONB 快照表。待核 12→10(余:SRC 图表墙 5·另册在建、NOON 3+PIPE-029·代码修复中、LOG-028·等燕文)。快照 backups/audit-base-stlbkf-20261022.tgz。

v5.2 2026-10-22 §11 图表墙逐图另册落库(SRC-17..20/52 全部换绿,/sourcing 全页收官):§11.38 ABA/Explore 墙 58 条(AB 20+EC 38)+ §11.39 Keepa 单 ASIN/池级/ABA×Keepa 联合 95 条(KS 39+KP 22+JT 34)= 153 条,目录驱动循环卡逐项展开,图题与 chartCatalog 逐字、行号全核。作者×2 + 独立只读校对 fork:cw-a 零缺陷原样入册;cw-b 4 组行号级缺陷(KS-007..013 验证列/定义列引区 + JT-001 构建区间混包死数组)16 处替换修毕入册。SRC-20 计数更正 32→34(chartCatalog counts 注释过时)。随册记录的产品文案缺陷候选(待拍板,均已在定义列留证):7 处图题与实构不一致(KS-025/032/034、KP-022、JT-005/009/010)、KS 5 张恒空卡、JointCharts 死数组 sfrVsKeepa:67-74、chartCatalog.ts 头注「113 张/留下一轮」过时(实 115 张全已渲染)。/sourcing 清单行 82 条全生效+153 条另册,§11 累计 2402 条。全库待核 10→5(余:NOON 3+PIPE-029 代码修复待门禁换绿、LOG-028 等燕文)。快照 backups/audit-base-pre-v52-20261022.tgz。

v5.2a 2026-10-22 NOON×3+PIPE-029 代码修复上线换绿(web 镜像重建 47/47 页,探针 tools/_probe_noon_pipe_20261022.py PASS + frontend_e2e ALL PASS 日志 _gate_noon3_pipe_20261022_frontend_e2e.log):NOON-33/39 评论脚注写死「757 条」→{total} 动态绑定(随采集扩窗自动变化);NOON-41 流量表聚合键 sku→市场|SKU+新增市场列+营收 AED/SAR 后缀,顺带修复「全部」页签 AED+SAR 跨币种直接相加真缺陷(比原披露更重一级,违反本币不可跨币种相加惯例),跨币种排序近似继续按 AC-CAL-05 披露;PIPE-029 巡检脚注改文承认物流船票/推广渠道 90/270 天宽阈值判定(行为不动,SKU 映射/广告活动 NULL 截至日不判定半句经 collab.py:246 实证为真)。/noon 清单行 42 条全生效;/pipeline 行「46 条全生效」随 PIPE-029 换绿自动变准。全库待核 5→1(仅 LOG-028 等燕文 API 管道接通回验)。快照 backups/audit-base-noon-pipe-20261022.tgz。

v5.3(2026-10-22)图表墙产品文案缺陷全清 + OFB-011 对账闭环(用户令「其它的都修完」):chartCatalog 7 处图题对齐实构——KS-025「30/90天缺货次数对比」/KS-032「BSR Current/Avg90/Drops30/Drops90对比」/KS-034「BuyBox价→FBA费→佣金→毛利瀑布图」/KP-022「ASIN×6字段覆盖热力图(Top12)」/JT-005「SFR×Top3评论数中位」/JT-009「Top1点击份额×同ASIN价格」/JT-010「Top3点击集中度×品牌数」(条目元素列随改、定义列留更正记录);5 张恒空卡撤卡(KS-014/016/017/023/035 生效→废止,目录项删除卡不再渲染);JointCharts 死数组 sfrVsKeepa(:67-74) 与 JT-009 ptsConv 死计算删除;chartCatalog 头注/counts 修正(110 张=AB20/KS34/KP22/JT34);§11.38/§11.39 全册 chartCatalog/JointCharts 行号随删行重算(目录删 5 行+头注+1、JointCharts 删 9 行,逐条 id↔行号闭环校验);§11.39 引言 95→90、/sourcing 另册行 153→148(143 生效/5 废止)。部署 web 镜像,产物断言(新题 7 串在场、旧题 7 串+5 旧 id 缺席)+frontend_e2e ALL PASS(tools/_gate_v53_charts_20261022_frontend_e2e.log)。OFB-011 归档去向换绿:留存=清除后再留 90 天已实现(#63 2026-10-10 拍板),/srv/offboarding 不存在=零注销常态,2026-10-18 挂账系未对账重复挂账。全库生效 2193→2189(-5 撤卡 +1 OFB),待核仍 1(LOG-028)。快照 backups/audit-base-pre-v53-20261022.tgz。

v5.3a(2026-10-22)v5.3 后核验补正:①7 处「图题对齐」更正记录内的新行号被通用重算二次平移,修回实位 49/56/58/87/95/99/100(验证列行号不受影响,其仅单次平移);②AC-EL-FIN-019/031 两行系早间修复后漏翻的陈旧待核——「在途 Pending」表头(page.tsx:729)与「44 列深度表」文案(page.tsx:966)均已在线上并有当日门禁日志(_gate_fin_th_20261022 / _gate_lst3_fin49_20261022),补翻换绿。至此全库待核=1(仅 LOG-028 等燕文 API 管道)、待拍板=0、待建=OFF 子组件列级(§11.40 建制中)。快照 backups/audit-base-v53a-fix-20261022.tgz。

v5.4(2026-10-22)§11.40 站外推广子组件列级 446 条入册:cw-off1(INB63/OVR14/SEG21/RES20/RDT21)+cw-off2(PRJ64/LIB59/TPL34/MBX30/SND39/TSK81),11 子组件+InboxTab 逐列/逐端点/逐交互元素;独立校对 fork 核验后入册;OFF-053/064 待建挂账清账换绿,/offsitepromotion 清单行=65 面板+446 列级。§11 累计(精确口径=§11 表格行数)2280→2726 条(+446);历史「2402/2848」系含变更记录与引言重复引用的宽松口径,v5.4 起以表格行数为准(另更正 v5.3 /sourcing 另册行笔误:图表墙 153 条=148 生效+5 废止,撤卡行按只增不删保留在册)。全库待核=1(LOG-028)、待拍板=0、待建=0。快照 backups/audit-base-pre-v54-20261022.tgz。

v5.5(2026-10-22)AC-CAL-15 一期落地换绿(views 单实现):6 视图族上线(迁移 114+115,security_invoker 保 RLS,三租户穿视图隔离实测);B1 finance summary/B2 dashboard KPI 广告面/B3 dashboard_audit 基准换读视图;caliber_recon 增 V 检查(视图 vs 独立复算)成三角验收(独立复算↔视图↔API,三租户 Δ=0.00);D5 修(dashboard_audit amz_base 混拼→3拼);metric_calibers id=1/4 换源+id=17 net_profit 新增+id=2/5 注记;部署 15:12 UTC 非整/半点窗内合规。快照 backups/audit-base-pre-cal15flip-20261022.tgz。

v5.6(2026-10-22)AC-CAL-15 二期 B4:noon 族消费端换源 + D1 修复:DDL 116 双视图列尾扩列(v_noon_ad_spend_daily+=sales_local/views/clicks、v_noon_orders_daily+=units);零差三实证(负值0/国家域{SA,AE}/16290 行)+视图 grain 甄别(跨 onno/zipforce 双品牌组 Δ2=全局 DISTINCT 消费端不迁);17 消费端换源(dashboard/dashboard_audit/finance/ai/brandboard)+ai amz 守卫并集收编;D1=noon-pnl All USD 行漏减广告真缺陷已修(gp/np 补减 ad_total),D9 ×(1+VAT) 维持在案;metric_calibers id=2/5 注记扩列与甄别(权威源待 B4d/B5 后统一换)。部署 16:11/16:14 UTC,pad_cond 列名事故当轮 pen_tests 捕获修复;门禁 7 项全过(唯一 FAIL=在案 X2 16G 外部项)。快照 backups/audit-base-pre-cal15v56-20261022.tgz。

v5.7(2026-10-22)AC-CAL-15 二期 B4d:ads.py 聚合面换源 + atc 扩列(DDL 117):v_noon_ad_spend_daily 列尾追加 atc(sum(atc),实证 10969/16290=67% 有数非死列);ads.py 三处换视图(data_through noon 臂 / 活动监控 src 日粒本币七列 / DISTINCT country),SKU/campaign 维三处留 B5、EXISTS 归集层两处豁免、amz 无守卫臂非零差禁迁在案。零差:src 新旧拼法 295 天七列 Δ=0。部署 22:07 UTC(出 19-22 广告档、非整/半点);门禁 7 项全过(唯一 FAIL=在案 X2 16G 外部项);线上 ads_analysis/ads_charts 200 且 atc 在载荷。快照 backups/audit-base-pre-v57-20261022.tgz。

v5.8(2026-10-22)AC-CAL-15 二期 B5:SKU 粒度视图族(DDL 118 三视图 + 消费端 10 处):台账先行甄别(sku_attr vs daily 两源不可互掺 77/1046 组漂移在案、[daily_total] 混入 SKU 维面 3 处=B5b 候选、id=1 陈旧空SKU句实证清障);v_amz_ad_spend_sku_daily(66383 行)/v_noon_ad_sku_daily(20805)/v_noon_ad_sku_monthly(882)+ GRANT;metric_calibers id=18/19 新增、id=1 注记+b_emptysku_ruling;消费端 finance 9 处+ads 1 处零差换源(kpi-wall/full/product-pl/profit-matrix/noon-pnl/noon-sku/monthly/platform campaigns);首部署三端 500(SELECT 列名未跟)当轮捕获修复=换源必查 SELECT 列表;豁免登记:onno 源库页 amz 臂(源系统面)/P&L 归集 LATERAL/finest 导出面/summary _SKU 平摊。B5b([daily_total] 修复+campaign 源漂移)与 B6(mcp/reports D12)留下批。门禁 7 项全过(唯一 FAIL=在案 X2 16G)。快照 backups/audit-base-pre-v58-20261022.tgz。

v5.9(2026-10-22)AC-CAL-15 二期 B5b:'[daily_total]' 混入 SKU/campaign 维面缺陷修复 + campaign 源漂移对齐:缺陷 4 处(ads charts top_src 30d 窗首行伪 SKU 21298.25→20 行真 SKU;finance onno campaigns/skus 8→7 活动无哨兵与广告平台同口径;两处 monthly 计数列换 id=18 逐月/逐国计数)+残余收编 2 处零差(platform skus 面/brandboard onno 广告)+:106 伪候选甄别不办(ADT-01 路由已隔离、换源反而破 totals/引双计,登记豁免);B5a 潜伏缺陷(campaigns 面 report_date 窗口列名)暴露修复,带窗/无窗双形态回归;CTE 聚合列别名教训入册。部署 23:16/23:19/23:20 UTC;门禁 7 项全过(唯一 FAIL=在案 X2 16G)。快照 backups/audit-base-pre-v59-20261022.tgz。

v5.10(2026-10-22)AC-CAL-15 二期 B6:mcp/reports 域换源 + id=2/5 权威源收官:mars-db MCP 全瘫修复(mcp_read 3 GRANT——RLS 策略内嵌子查询授权,brands_source 列级防 ads_creds 泄露)+TENANT_BY_BRAND onno 1→2+ad_performance noon 臂换 id=18(onno 哨兵 1015.68 本币消除+遮蔽月补齐 4 真活动;zf 哨兵组 49604.18 SAR 消除 97→96 组,与 B5b 同构);D12 新鲜度判定=分析面 30d 窗+2h 采集滞后不敏感+视图零附加滞后;豁免登记 6 类(行级/覆盖元数据/状态集差异/无守卫并集/fee-coverage/mcp 标量面);metric_calibers id=2/5 权威源统一换视图(聚合面消费端 B4/B4d/B5 全迁后收尾);metrics.noon_ads_union 孤本删除待拍板;5 个 mars-mcp 旧进程需重启方生效(未擅杀)。快照 backups/audit-base-pre-v510-20261022.tgz。 23:55 UTC 用户令「重启」已执行(不重启 tmux):23 个 mars-mcp stdio 子进程(各 Claude 会话各一,10-12..10-22 启动,含本会话)全数 TERM 换血;tmux 会话 12 个与 claude 父进程 22 个本体未动。一次性 JSON-RPC 实例(mcp_read)实测 ad_performance(onno,noon,90d)=4 真活动无哨兵、与 psql 仿真逐位一致——id=18 口径已在服务面生效。 2026-10-23 00:02 UTC 用户拍板「可以删」:metrics.noon_ads_union 零调用孤本已删(api/metrics.py 函数 26 行+MEASURES 头注与 audit_nodes.py:116 两处引用同步改写;全仓 grep 含动态派发零调用方实证;历史已保存于 registry id=2 与本库 v5.5-v5.10;备份 backups/code-2026-10-23-noon-ads-union-del/)。部署 00:02 UTC 合规窗,md5 宿主=容器、容器内零残留。门禁 7 项(tools/_gate_uniondel_*_20261023.log):EXIT=0×6+dashboard_audit FAIL 1=在案 X2 16G;pipe_audit FAIL 1=fittingirls/GB 断流告警(翻日 gap=4 阈值触发,实证 raw 层各国已采至 2026-10-23、GB 为 12 天 7 单小市场自然无单,采集通道正常,与本次删除无关)。AC-PEND 类孤本挂账清零:本条后 noon 广告费/销售口径代码层仅存视图单一实现。快照 backups/audit-base-pre-uniondel-20261023.tgz。

v5.11(2026-10-23)AC-GATE-07 立:门禁三租户覆盖(round2 P2-28/P2-29 销项):dashboard_audit 三件套C(fg RLS 三面+8.3/8.4 fg 臂,192+→198+ 项,唯一 FAIL 仍在案 X2 16G);frontend_e2e 第 21 节(fg 独立 context 登录+品牌看板双页,ALL PASS);chart_value :39 陈旧注记更正(fg.env 在册,无参本就遍历三租户);audit_nodes 整体三租户化=重构级挂下批。纯 tools 层无部署。快照 backups/audit-base-pre-gate7-20261023.tgz。

v5.12(2026-10-23)#62 audit_nodes 三租户化:AC-GATE-07 残余缺口清零:第四道门单租户(t1)→三租户同面探测(凭据目录遍历/tenant_id 库内单源/AB·NR·SO·promotion 基准 tid 参数化/promotion_orders 补租户过滤);空态规则与 NULL 吞没修复 3 处+finance months[0] 月轴数据驱动重锚(onno 4 个月面);终验三租户 ALL PASS(zf 32/onno 31/fg 29+3 双侧空,断言总量 32→92,节点面 3054→8794);迁移 109 tenant_scope 202 行→all;快照 code-20261023-pre-t62-tools.tar.gz。纯 tools+登记层,无应用部署。

v5.13(2026-10-24)AC-CAL-15 结构化重排(只增不删):条目单元格新增「速览导航层」——标准恒则 4 条/as-built 视图族 9 枚清单表(视图×粒度×口径×caliber id×DDL)/公共属性/口径分派(两源不可互掺)/豁免类目速查/换源批次索引(一期→B4→B4d→B5a→B5b→B6)/余量;逐批详录原文零改动保留于分隔线后。纯排版层,无代码/DDL/部署。快照 backups/audit-base-pre-cal15struct-20261024.tgz。

v5.13a(2026-10-24)AC-CAL-15 详录区排版收整(用户复看「还是很乱」):详录原文只增不删地分行——批级头(一期落地/B4/B4d/B5/B5a/B5b/B6 落地与甄别登记 9 处)双换行、子头(`某头:`形 30 处)单换行、3 处视图定义行、行内强调(如「不迁」)保持行内;同时把 22 处遗留 `**…**` markdown 星号渣归一为真 加粗(星号此前在浏览器渲染为字面字符)。文字内容零改动,仅标记与换行;tag-balance 与改前逐位一致(存量 16/27)。快照 backups/audit-base-pre-cal15detail-20261024.tgz。

v5.13b(2026-10-24)全库长条目分行(用户令「audit-base 也照这个模式把长条目都分行」):CAL-15 之外全库照 v5.13a 同规收整——子头(`某头:`/`某头——`形且前文句末标点)插单换行 50 处、日期头(`2026-…:`形 45 处)升双换行;文字内容零改动,仅标记与换行;tag-balance 与改前逐位一致(存量 16/27)。快照 backups/audit-base-pre-reflow-20261024.tgz。

v5.14(2026-10-24)本库变更纪律改立(用户令「audit-base.html 是最终标准,不需要只增不减」):废除本库「只增不删」纪律——标准文本可直接改写/合并/收敛为当前有效形态,历史沿革归 audit.html(档案仍只增不删)与本页版本日志;ID 永不复用不变。页首纪律 callout、AC-CAL-15 速览层定位语、详录分隔线标注、AC-OPS-05 发布面行四处同步改写。纯纪律层,无代码/DDL/部署。

v5.15(2026-10-24)AC-CAL-15 详录收编删除(用户问「为什么保留」):按 v5.14 最终标准纪律,将分隔线后 19,411 字符逐批详录连排原文整体移除——批次史已存页尾版本日志 v5.5–v5.10,审计叙事在 audit.html §10,标准本体=速览导航层;单元格留一行落地史索引指针。条目定义/验证方法/状态三列语义零变化,仅过程叙事出库(全文快照 backups/audit-base-pre-cal15collapse-20261024.tgz)。tag-balance 改前后逐位一致。