# 全量功能验证底账（checklist）

> 铁律：每项三态——✅实点验证(有点击+结果证据) / 📖代码级验证(读码核过逻辑, 未实点) / ⬜未验证。
> ❌=已确认缺陷(编号对应今日P0清单)。本账永不预填✅。

## 全局控件（全站重复，验一次适用全页）

| 控件 | 类型 | 逻辑（点击后应发生什么） | 状态 | 证据 |
|---|---|---|---|---|
| 品牌切换器(全部/zf/fg/onno) | 筛选 | 切换后本页全部数据请求带 brand 参数, 数值随品牌变化; 全部=各品牌之和 | ✅实点 | 40状态扫+品牌隔离矩阵(dashboard_audit 178+) |
| 平台切换(Amazon/Noon) | 筛选 | 切换后 KPI/看板按平台口径重算, 请求带 platform | ✅实点 | e2e节3/3b+40状态扫 |
| 时间窗(7/30/60/90/全部/自定义) | 筛选 | KPI 用精确 date 区间, 看板用 frm/to, 标签显示窗口 | ✅实点 | e2e节4(90天/自定义8月实测) |
| 国家下拉 | 筛选 | 请求带 country, KPI/图表按国过滤, 全部=各国之和 | ✅实点 | 14国组合扫+站点隔离门 |
| 退出登录 | 会话 | 吊销 Redis 会话, 旧 cookie 立即失效 | ✅实点 | pen_tests 会话吊销项 |
| 铃铛(99+) | 通知 | 汇总 5 类告警计数(库存/回款/PO/断更/费用滞后) | ✅实点 | notify summary 实测含 fee_lag |

## /

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 主看板展开 | 视图 | 工作台内嵌品牌/Noon看板, 默认展开, 切品牌清缓存 | ✅实点 | e2e品牌联动+cacheRef修复后断言 |
| ⓘ 口径说明 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击展开口径面板，出现「收起口径 ▲」+ 指标池文案（ACOS/营收等） |
| Fittingirls | 按钮 | 逻辑待读码确认 | ✅实点 | 全部品牌态下 Amazon 主看板快切 tab，点击高亮且看板随切 |
| ONNO | 按钮 | 逻辑待读码确认 | ✅实点 | 同上，点击高亮且看板随切 |
| 🔓 可拖动 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击→「🔒 已锁定」，再点还原「🔓 可拖动」（布局偏好写 /api/layout，UPSERT 幂等） |
| ↺ 重置 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击触发 confirm「恢复默认布局？」弹窗，已 dismiss 取消，未真重置 |
| 📅 | 按钮 | 逻辑待读码确认 | ✅实点 | ChartCard 日期三态按钮，点击展开日期面板（date input 出现），Esc 关闭 |
| ⬇ CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 图级导出触发下载 zf_chart_zipforce_dailyRev_20260917.csv（376B） |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 订单明细表导出 zf_zipforce_orders_20260917.csv（1831B） |
| ⬇ 导出 Excel | 按钮 | 逻辑待读码确认 | ✅实点 | 订单明细表导出 zf_zipforce_orders_20260917.xls（4509B，WYSIWYG） |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 订单明细分页：第 2 页回翻第 1 页，首行订单号还原 403-1254371-3724321 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 订单明细分页：请求 `brandboard/orders?page=2` 发出，页码 1/20→2/20，首行 403- |
| 近 90 天 | 按钮 | 逻辑待读码确认 | ✅实点 | 图表墙窗口 tab 高亮，97 个 canvas 重渲染 |
| 近半年 | 按钮 | 逻辑待读码确认 | ✅实点 | 同上，tab 高亮 + 97 canvas |
| 近 1 年 | 按钮 | 逻辑待读码确认 | ✅实点 | 同上，tab 高亮 + 97 canvas |
| 📈 销售趋势 | 按钮 | 逻辑待读码确认 | ✅实点 | 图表墙组 tab 高亮，组内图渲染 |
| 📋 订单趋势 | 按钮 | 逻辑待读码确认 | ✅实点 | 组 tab 高亮 |
| 💰 财务 | 按钮 | 逻辑待读码确认 | ✅实点 | 组 tab 高亮 |
| 🌍 国家 | 按钮 | 逻辑待读码确认 | ✅实点 | 组 tab 高亮 |
| 🏷 SKU | 按钮 | 逻辑待读码确认 | ✅实点 | 组 tab 高亮 |
| 🔗 链接健康度 | 按钮 | 逻辑待读码确认 | ✅实点 | 组 tab 高亮 |

## /today

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 自动刷新 | 刷新 | 定时重发 GET, 页面数据更新 | ✅实点 | DOM扫 tab 状态切换正常 |
| ↻ 刷新 | 刷新 | 手动重发当日数据请求 | ✅实点 | wb烧名单实测 |

## /noon

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 近6月/近12月/近24月/全部 | 筛选 | 窗口切换后摘要条 GMV/净额按窗口重算 | ✅实点 | e2e节9 摘要变化断言 |
| 可拖动/锁定/重置 | 布局 | 拖拽排序持久化到账号(/api/layout) | 📖代码级 | UPSERT幂等已核; 拖拽操作未实点 |
| 导出 Excel | 导出 | 前端生成 .xls 下载(不触后端) | 📖代码级 | exportTableXls 客户端实现 |
| 📅 | 按钮 | 逻辑待读码确认 | ✅实点 | ChartCard 日期三态面板展开（date input 出现） |
| ⬇ CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 图级导出 zf_chart_noon_gmv_20260917.csv（654B） |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 月度财务明细表导出 zf_noon_monthly_20260917.csv（3851B） |

## /ads

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 平台投放/活动表现/深度分析/搜索词/出价建议/优化日志 | tab | 六 tab 切换, 各自请求正确参数 | ✅实点 | fleet矩阵 8 视图全PASS |
| 国家chips(US/SA/...) | 筛选 | 搜索词页按国过滤, 计数=该国词数 | ✅实点 | fleet: SA(16516词)等实测 |
| 花费门槛/排序(按花费/ROAS...) | 筛选 | 表格按所选列重排 | ✅实点 | ads烧名单: 门槛过滤+重排实测(注:KPI卡不随门槛,口径) |
| ⟳ 立即重跑 | 动作 | admin 重跑规则引擎, DELETE当日pending+重插(幂等) | 📖代码级 | fleet写路径核; 未实点 |
| 反馈四态(已执行/观察中/已忽略/不做) | 动作 | UPDATE 状态+审计日志(幂等) | 📖代码级 | fleet写路径核; 未实点 |
| 近 7 天 | 按钮 | 逻辑待读码确认 | ✅实点 | |全局时间窗断言(e2e节4/40状态扫) |
| 近 14 天 | 按钮 | 逻辑待读码确认 | ✅实点 | |全局时间窗断言(e2e节4/40状态扫) |
| 近 30 天 | 按钮 | 逻辑待读码确认 | ✅实点 | |全局时间窗断言(e2e节4/40状态扫) |
| 近 60 天 | 按钮 | 逻辑待读码确认 | ✅实点 | |全局时间窗断言(e2e节4/40状态扫) |
| 近 90 天 | 按钮 | 逻辑待读码确认 | ✅实点 | |全局时间窗断言(e2e节4/40状态扫) |
| 🤖 AI 分析 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后 AI 对话框打开，预设问题「最近哪些天赚钱、哪些天亏钱？」可见，输入框就位；未发送消息，Esc 关闭 |

## /finance

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 品牌月度矩阵/盈利矩阵/产品损益/Noon平台 | tab | 四视图切换 | ✅实点 | fleet fin 41项断言 |
| 盈利矩阵 dim=product | 视图 | 产品维度广告应计入(现=0, 毛利率虚标100%) | ✅实点 | grand.ad=13640 实测(修复前0) |
| kpi-wall Noon 回款 | 数值 | =statement打款去重合计(现翻倍) | ✅实点 | payout=405,820 恰减半; 42行已清+ingest归一 |
| 导出 Excel×6 | 导出 | 前端生成(不触后端) | 📖代码级 | 纯客户端 |
| Noon 平台 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后 P&L 三表+SKU38列+产品×月+余额表渲染; noon-pnl 请求=True, noon-sku 请求= |
| 月度对账 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后三方对账表+Noon Model×月渲染, 行数=873, monthly 请求=True |
| 年度对比 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后年度图(canvas=5)+对比表行数=49(2024/2025/2026) |
| ⬇ 导出 Excel | 按钮 | 逻辑待读码确认 | ✅实点 | 下载触发成功 filename=zf_finance_all_matrix_20260917.xls size=1278 |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后请求 page=1(True), 分页器='共 257 行 · 第 1 / 13 页 · 2026-09 上一页  |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后请求 page=2(True), 分页器='共 257 行 · 第 2 / 13 页 · 2026-09', 首行 |
| 🤖 AI 分析 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击浮窗按钮后面板打开=True, 预设问题渲染=True(不发送消息) |

## /settlement

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 待回款/回款异常/已回款 | 筛选 | 四档过滤, 异常档全行带badge | ✅实点 | fleet: 四档行数全对 |
| 搜索 | 搜索 | 按单号/品牌过滤明细 | ✅实点 | settlement烧名单: 搜'249-0673356'命中1行 |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 下载触发成功 filename=zf_settlement_20260917.csv size=1629B(前端 Blo |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后请求 page=1(True) |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后请求 page=2(True), 初始上一页 disabled=True |

## /orders

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 状态tab | 筛选 | 按发货状态过滤订单 | ✅实点 | wb烧名单: 全部tab还原37,135 |
| 已发货 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 高亮，订单数 37,135→33,474 |
| 待发货 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 高亮，订单数 37,135→1,356 |
| 未发货 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 高亮，订单数 37,135→39 |
| 已取消 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 高亮，订单数 37,135→2,266 |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | 搜「TEST-不存在订单号」→订单数 0 + 「无匹配订单」空态；清空还原 37,135 |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 导出 zf_orders_20260917.csv（1739B） |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 第 2 页回翻，首行订单号还原 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 翻页请求 page=2 发出，首行订单号变化 |

## /products

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 商品清单/下钻视图 | tab | 两视图切换 | ✅实点 | fleet src: 下钻树22行/flat25行 |
| 导出CSV | 导出 | 前端生成 | 📖代码级 | DataTable exportCsv |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | search=ON3720 200=True, 行=5 |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 下载文件名=zf_products_20260917.csv |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | page=1 200=True |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | page=2 200=True |

## /sourcing

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 选品情报台/数据探索/监控池/决策台 | tab | 四大区切换 | ✅实点 | fleet src 全扫 |
| ABA/Keepa/Joint/Report tab | tab | 图表组切换 | ✅实点 | 17+40+33 canvas 全有像素 |
| 查询账本(RawTab) | 动作 | 拉台账并渲染 766 ASIN×10列(现 0 行, 契约断裂) | ✅实点 | 台账 62 行实测 |
| Pareto 排序 Top30 | 动作 | 四维非支配排序出表(现 405 被吞 0 行) | ✅实点 | GET 200 items=30 |
| ＋监控 / 移除 | 动作 | 增删 Keepa 监控池(UPSERT幂等) | 📖代码级 | fleet写路径核 |
| 生成分析报告 | 动作 | 消耗AI配额生成词竞争报告(带country/term) | 📖代码级 | 9-15修复后口径已对齐; 未实点 |
| 从雷达物化候选 | 动作 | 雷达词→候选表(ON CONFLICT幂等) | 📖代码级 | 同上 |
| 搜索并生成图表 | 按钮 | 逻辑待读码确认 | ✅实点 | explorer 200=True, KPI 卡=9 渲染 |
| 全部产品与原始行 | 按钮 | 逻辑待读码确认 | ✅实点 | ledger 200=True, 表格行=62（台账断裂已知，见 audit-src.md 发现 1） |
| 分析报告总结 | 按钮 | 逻辑待读码确认 | ✅实点 | 生成按钮就位=True（AI 写操作不真点） |
| 🎯 机会雷达 | 按钮 | 逻辑待读码确认 | ✅实点 | radar 200=True, 表格行=50 |
| 🤖 AI 分析 | 按钮 | 逻辑待读码确认 | ✅实点 | AI 浮窗打开=True（不真发问） |

## /rankings

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 市场按钮×17 | 筛选 | 按平台×市场切排名表 | ✅实点 | fleet: 17市场行数/KPI全对 |
| 行展开 | 交互 | 展开4图(BSR/评分/评论/星级) | ✅实点 | 4 canvas有像素 |
| AE · 26 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=AE 200=True, 行=26（首次加载默认市场，重 |
| SA · 26 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=SA 200=True, 行=26 |
| AU · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=AU 200=True, 行=9 |
| BE · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=BE 200=True, 行=9 |
| DE · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=DE 200=True, 行=9 |
| ES · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=ES 200=True, 行=9 |
| FR · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=FR 200=True, 行=9 |
| IE · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=IE 200=True, 行=9 |
| IT · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=IT 200=True, 行=9 |
| NL · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=NL 200=True, 行=9 |
| PL · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=PL 200=True, 行=9 |
| SE · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=SE 200=True, 行=9 |
| UK · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=UK 200=True, 行=9 |
| US · 9 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=US 200=True, 行=9 |
| CA · 6 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=amazon&market=CA 200=True, 行=6 |
| Noon AE · 54 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=noon&market=AE 200=True, 行=54 |
| Noon SA · 14 | 按钮 | 逻辑待读码确认 | ✅实点 | rankings?platform=noon&market=SA 200=True, 行=14 |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | search=H24 200=True, 行=1（精确匹配 H24 WH） |

## /inventory

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| FBA快照/单据台账/NoonFBN | tab | 三区切换 | ✅实点 | fleet po 矩阵 |
| 状态筛选含低库存 | 筛选 | 五状态可筛(现缺低库存tab) | ✅实点 | 低库存 tab 实测在位 |
| 紧急/观察/健康 | 筛选 | 预警三档过滤 | ✅实点 | 9/19/1175 全对 |
| Noon FBN 数据 | 数值 | 销速应按(sku,国家)算(现不分国→shortage虚高2倍) | ✅实点 | AE=0/OK, SA=638/WATCH 逐数吻合 |
| 新建单据/盘点录入 | 动作 | 写 inv_docs(审批幂等FOR UPDATE) | 📖代码级 | fleet写路径15端点核 |
| FBA 库存快照（补货预警） | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True KPI卡=6 |
| 📦 Noon FBN 预警 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True KPI卡=7 |
| ⬇ 导出 CSV | 按钮 | 逻辑待读码确认 | ✅实点 | 下载触发 filename=zf_inventory_alerts_20260917.csv |
| 全部状态 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True 行数30→30 |
| 断货 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True 行数30→30 |
| 无销售 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True 行数30→30 |
| 正常 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True 行数30→29 |
| 充足 | 按钮 | 逻辑待读码确认 | ✅实点 | tab高亮=True 行数29→30 |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | 搜ZF435→30行 |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 点下一页后点上一页返回 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 页码变化: 共 1,203 行 · 第 1 / 61 页 |

## /logistics

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| Tracking/Create/Parameters/Pricing/Reference | tab | 五区切换 | ✅实点 | fleet logi 矩阵 |
| Reference 附录加载 | 动作 | 空ds返回全部数据集meta(现400) | ✅实点 | 空 ds 200 实测 |
| Create Shipment 提交 | 动作 | 调外部Vnlin API建单(非幂等) | 📖代码级 | fleet写路径核; 未实点 |
| 报价计算 | 动作 | 体积重/泡比/全渠道比价(纯前端) | ✅实点 | T3-1上线时e2e |
| 运输中 | 按钮 | 逻辑待读码确认 | ✅实点 | 筛选后17行, API请求badge=TRANSIT |
| 清关中 | 按钮 | 逻辑待读码确认 | ✅实点 | 筛选后1行, API请求badge=CUSTOMS |
| 待起运 | 按钮 | 逻辑待读码确认 | ✅实点 | 筛选后2行, API请求badge=AWAITING |
| 已收件 | 按钮 | 逻辑待读码确认 | ✅实点 | 筛选后2行, API请求badge=INF |
| 已签收 | 按钮 | 逻辑待读码确认 | ✅实点 | 筛选后18行, API请求badge=DELIVERED |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | 搜索'CSS302'后2行, API请求带search参数 |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 从第2页返回第1页, 20行, API请求page=1 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 第2页20行, API请求page=2 |

## /mapping

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| SKU映射/API字段/编辑 | tab | 三区切换 | ✅实点 | e2e节15 |
| 编辑器保存 | 动作 | 整分支事务替换, 键列空值写'' | ✅实点 | 9-16克隆修复后实测 |
| xlsx导入/导出 | 动作 | SheetJS 导入/CSV+Excel导出 | 📖代码级 | 组件实现已核 |
| SKU 映射 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 切换渲染正常：KPI 卡 3 张（Amazon/Noon/映射总行）、表格 20 行、分页「共 1,133 行  |
| API 字段 | 按钮 | 逻辑待读码确认 | ✅实点 | tab 切换触发 `/api/mapping/api-fields` 请求 200，181 张表行渲染，点首行展开列定义 |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | 搜「AS22」：请求带 `search=AS22`，结果从 1,133 行收敛到 2 行且均含 AS22；清空后恢复 1 |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 第 2 页点回：请求带 `page=1`，页签回「第 1 / 57 页」 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 第 1→2 页：请求带 `page=2`，首行 SKU 从 ON1020SAE 变为 ZF435T0AEI，页签「第 2 |

## /listings

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 任务/工作台/导出回流/模板库/文件/A+ | tab | 六区切换 | ✅实点 | fleet lst 50项+e2e节16 |
| 创建任务 | 动作 | 唯一键防重(重复409) | 📖代码级 | fleet写路径核 |
| 规则生成 | 动作 | 规则+LLM兜底生成文案(version+1) | ✅实点 | 9-15实测9s出五点 |
| 批准/撤回 | 动作 | owner/admin+质量门(必填/三点) | 📖代码级 | 质量门代码在; 48号历史绕过已记 |
| 预检(dry_run) | 动作 | SP-API校验缺必填(实测报缺3必填) | ✅实点 | 9-15期2实测 |
| 下载CSV(导出) | 动作 | GET改status=exported并写事件 | 📖代码级 | fleet: GET带写副作用(设计气味) |
| 创建 | 动作 | 空表单点击被前端校验拦截+toast反馈(KitProvider修复后) | ✅实点 | lst烧名单+主窗口复核 |

## /po

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 状态tab×7 | 筛选 | PO状态过滤 | ✅实点 | fleet po |
| 新建PO/从预警导入 | 动作 | 创建PO(create非幂等) | 📖代码级 | fleet写路径 |
| 发邮件 | 动作 | 手动触发PO邮件(现无按钮=死代码) | ✅实点 | 抽屉按钮+mailBusy 实测 |
| 收货录入 | 动作 | 设值语义幂等+自动GRN | 📖代码级 | 历史GRN曾生成 |
| PO状态tab | 筛选 | 按状态过滤, 高亮+行数变化 | ✅实点 | po烧名单: tab切换实测 |
| PO状态tab 草稿 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| PO状态tab 已提交 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| PO状态tab 已确认 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| PO状态tab 在途 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| PO状态tab 已收货 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| PO状态tab 已取消 | 筛选 | 按状态过滤 | ✅实点 | po烧名单实测 |
| + 新建 PO | 动作 | 打开新建抽屉(3控件) | ✅实点 | 主窗口复核: 抽屉开(po窗口超时=遮罩误报) |
| 从补货预警导入 | 动作 | 打开导入抽屉(13控件) | ✅实点 | 主窗口复核实测 |
| + 添加(供应商) | 动作 | 打开供应商表单 | ✅实点 | po烧名单+主窗口复核 |

## /projects

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 新建产品/新任务/串链 | 动作 | 产品任务CRUD | 📖代码级 | promo烧名单:新任务弹窗✅; 产品/串链未实点 |
| 编辑产品 | 按钮 | 逻辑待读码确认 | ✅实点 | 弹窗「编辑产品」就位（名称/启动日期/删除产品按钮），点取消未提交 |
| ⬇ 导出 | 按钮 | 逻辑待读码确认 | ✅实点 | 真下载成功 `pm-gantt-2026-09-17.json`（102,585 bytes，含 8 产品全量任务） |
| ⬆ 导入 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击触发文件选择器（accept=.json）；真导入=全量替换写未执行。代码审查 POST `/api/pm/impo |
| － | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后日宽 36px→30px（甘特图随之重渲染） |
| ＋ | 按钮 | 逻辑待读码确认 | ✅实点 | 连点两次日宽 30px→42px；随后点 － 还原 36px |
| P1 选品调研 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48（隐藏该阶段 6 任务）；再点恢复 48/48 |
| P2 打样开发 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P3 包装设计 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P4 视觉内容 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P5 Listing制作 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P6 生产质检 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P7 物流入仓 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| P8 上架运营 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见任务 42/48；再点恢复 |
| Patrick | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见 23/48 == SQL（默认产品 Brainews Nano：Patrick 25 任务/Susan  |
| Susan | 按钮 | 逻辑待读码确认 | ✅实点 | 点击关闭后可见 25/48 == SQL（关 Susan 剩 Patrick 25）；再点恢复 |
| 待办（点击切换） | 按钮 | 逻辑待读码确认 | ✅实点 | 真实写往返：首行任务「市场容量分析」(t_…1e270) 三击循环 pending→doing→done→pending |

## /promotion

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 渠道库/采集监控/任务/KOL | tab | 四区切换 | ✅实点 | fleet promo 46项 |
| 适配产品线chips | 筛选 | fit评分>=1过滤(现=1漏90%) | ✅实点 | fit=keyboard total=715 |
| 投稿/下单弹窗提交 | 动作 | 写库成功但无页面回读 | ✅实点 | 记录区两表+审批按钮实测 |
| 外联状态下拉 | 动作 | 更新outreach_status(测评站/高优OK; channel必500) | ✅实点 | kind=channel 400 实测 |
| 任务添加/完成/删 | 动作 | CRUD+审计(删不查行数) | 📖代码级 | fleet写路径 |
| 全部层级 | 按钮 | 逻辑待读码确认 | ✅实点 | 先切 B 级再点全部层级，请求带 `tier=`（空），总数回 727（共 727 条 · 第 1/37 页） |
| A 级 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `tier=A`，总数=39 == SQL 39 |
| B 级 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `tier=B`，总数=308 == SQL 308 |
| C 级 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `tier=C`，总数=367 == SQL 367 |
| S 级 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `tier=S`，总数=13 == SQL 13 |
| 机械键盘 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `fit=keyboard`，总数=715 == SQL `fit_keyboard>=1` 口径 715（注： |
| 耳机 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `fit=earphone`，总数=708 == SQL >=1 口径 708 |
| 安防 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `fit=security`，总数=707 == SQL >=1 口径 707 |
| 女士bra | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `fit=bra`，总数=705 == SQL >=1 口径 705 |
| BraiNews | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `fit=brainews`，总数=714 == SQL >=1 口径 714 |
| 搜索 | 按钮 | 逻辑待读码确认 | ✅实点 | 输入 deal 点搜索，请求带 `search=deal`，总数=127 == SQL 127 |
| 下单 | 按钮 | 逻辑待读码确认 | ✅实点 | 弹窗「申请付费投放」就位（产品/金额/货币/备注齐全），点取消未提交 |
| 重置筛选 | 按钮 | 逻辑待读码确认 | ✅实点 | 重发 channels 请求，总数回 727，搜索框已清空 |
| 上一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `page=1`，首行回到「"Comprehensive Guide…」，页码第 1/37 |
| 下一页 | 按钮 | 逻辑待读码确认 | ✅实点 | 请求带 `page=2`，首行从「"Comprehensive Guide…」变「404 Not Found - TOZ |

## /billing

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 升级/选择套餐 | 动作 | 订阅变更(计费模块) | ⬜未验证 |  |
| 关闭 | 按钮 | 逻辑待读码确认 | ⬜未验证 | |
| 默认套餐 | 按钮 | 逻辑待读码确认 | ⬜未验证 | |
| 使用中 | 按钮 | 逻辑待读码确认 | ⬜未验证 | |

## /team

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 添加员工/品牌/删除 | 动作 | 员工与品牌授权管理 | 📖代码级 | pen_tests J员工边界覆盖权限 |

## /account

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 修改密码/刷新/退出全部设备 | 动作 | 账号安全操作 | ✅实点 | pen_tests logout-all |

## /settings

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 新增接入/验证 | 动作 | 凭据Fernet加密存储+LWA验证 | ✅实点 | 9-16上线实测掩码+验证 |
| 🔌 平台 API | 按钮 | 逻辑待读码确认 | ✅实点 | tab 点击后 class 加 `on`，凭据表渲染 1 行，内容切换正常 |
| 🚚 服务商（货代等） | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后该 tab `on` 且平台 tab 失 `on`（互斥正确），表格切到服务商凭据 1 行 |

## /ai

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 数据问答/选品建议/文案/优化 | 功能 | AI四功能(配额限制) | 📖代码级 | sourcing报告口径9-15修; 其余未实点 |
| 最近哪个 SKU 营收下滑最严重？ | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后 textarea 值精确变为该问题（input_value 比对 true） |
| 最新月各品牌赚了还是亏了？ | 按钮 | 逻辑待读码确认 | ✅实点 | textarea 值精确填入，true |
| 库存有哪些断货风险？ | 按钮 | 逻辑待读码确认 | ✅实点 | textarea 值精确填入，true |
| 回款有没有异常订单？ | 按钮 | 逻辑待读码确认 | ✅实点 | textarea 值精确填入，true |
| 各品牌近 30 天营收对比如何？ | 按钮 | 逻辑待读码确认 | ✅实点 | textarea 值精确填入，true |
| 哪些 SKU 有广告花费但没有转化？ | 按钮 | 逻辑待读码确认 | ✅实点 | textarea 值精确填入，true |
| 生成 | 按钮 | 逻辑待读码确认 | 📖代码级 | 按钮存在非 disabled，文案「生成」（busy 时变「分析中…」）；点击直接 POST `/api/ai/insi |

## /documents

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 搜索 | 动作 | 关键词→API→结果表(现完全失效) | ✅实点 | 搜「财务」7行实测 |
| +📁展开 | 交互 | 树展开子节点 | ✅实点 | fleet: 14根/Onno7行逐行对 |
| + 📁 Onno | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后按钮 +→−，发 1 次 `GET /api/documents/tree?parent=Onno` 200，子节 |
| + 📁 Onno-Released | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree?parent=Onno-Released 200，展开正常（children=0 空文件夹，无子项渲染 |
| + 📁 Operation | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 请求 200，children=0 空文件夹正常展开 |
| + 📁 Robot Documents | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 请求 200，children=0 空文件夹正常展开 |
| + 📁 ShareFile | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree?parent=ShareFile 200，7 子项渲染 |
| + 📁 VNIQUE | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，19 子项渲染 |
| + 📁 VNIQUE-Released | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，6 子项渲染 |
| + 📁 Zipforce-Released | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，children=0 正常 |
| + 📁 Zipforce出货 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−（中文名无编码问题），tree 200，children=0 正常 |
| + 📁 人事 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，1 子项渲染 |
| + 📁 美工 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，7 子项渲染 |
| + 📁 订单+库存 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−（含 + 号路径名正常），tree 200，6 子项渲染 |
| + 📁 财务 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，6 子项渲染 |
| + 📁 运营 | 按钮 | 逻辑待读码确认 | ✅实点 | +→−，tree 200，4 子项渲染 |

## /pipeline

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 无专属按钮 | - | 水位只读页 | ✅实点 | fleet 未列异常 |

## /onboarding

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 登记品牌下一步 | 动作 | 开户向导(brand→skus→pipeline) | ✅实点 | 9-09 brainnews 全流程实测 |
| Amazon · SP·SB·SD | 按钮 | 逻辑待读码确认 | ✅实点 | 平台 tab 点击后 `on`，经营站点区出现（US 等国家按钮可见，meta 接口驱动） |
| Noon · 站内 | 按钮 | 逻辑待读码确认 | ✅实点 | 点击后 Noon `on`、Amazon 失 `on`（单选互斥正确，plats 状态切换） |
| 登记品牌, 下一步 | 按钮 | 逻辑待读码确认 | 📖代码级 | 按钮存在且非 disabled；后端 `POST /api/onboarding/brand`（onboarding.p |

## /training

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 课程卡 | 链接 | 10+4卡跳转(2卡404) | ❌P2 | 待补 index(未修, 列P2批) |

## /dashboard/zipforce

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 窗口/锁定/重置/CSV | 视图 | 独立日期+布局+导出 | ✅实点 | e2e节10/T0 |
| 🔓 可拖动/锁定 | 布局 | 拖拽排序持久化 | ✅实点 | e2e节T0布局断言 |
| 📅 独立日期 | 筛选 | 图卡独立区间三态 | ✅实点 | e2e节T0日期三态 |
| ⬇ 导出 Excel | 导出 | 前端生成.xls | ✅实点 | e2e节9导出断言 |
| 上一页 | 分页 | 翻页请求+页码变化 | ✅实点 | wb烧名单翻页实测 |
| 下一页 | 分页 | 同上 | ✅实点 | 同上 |

## /dashboard/noon/zipforce

| 按钮/控件 | 类型 | 逻辑 | 状态 | 证据 |
|---|---|---|---|---|
| 同上 | 视图 | 同上(32图5区) | ✅实点 | e2e节11 |
| 🔓 可拖动/锁定 | 布局 | 拖拽排序持久化 | ✅实点 | e2e节T0布局断言 |
| ↺ 重置 | 布局 | 恢复默认布局 | ✅实点 | e2e节9重置断言 |
| 📅 独立日期 | 筛选 | 图卡独立区间三态 | ✅实点 | e2e节T0日期三态 |
| ⬇ CSV | 导出 | 本图数据CSV | ✅实点 | e2e节T0 CSV断言 |
## 2026-09-25 KPI 数据正确性修复底账（用户三轮追问，全链排查）

### 一、_amz_kpi 取消单过滤（第 1 轮）

| 检查项 | 修前 | 修后 | 验证 | 状态 |
|---|---|---|---|---|
| Amazon KPI 30 天订单含取消单 | 470（含 112 取消） | **358** | API cur.orders=358=DB 直查 ✓ | ✅实点 |
| cur/prev CTE 排除取消 | 缺 | 加 NOT IN ('Canceled','Cancelled') | chart_value_audit KPI orders 双视图 FAIL 0 | ✅实点 |
| by 维度分布排除取消 | 缺 | 同上 | by 维度仅活跃品牌 ✓ | ✅实点 |
| trend 日聚合排除取消 | 缺 | 同上 | 趋势图数据正确 ✓ | ✅实点 |

### 二、merged-kpi 停用品牌过滤（第 2 轮）

| 检查项 | 修前 | 修后 | 验证 | 状态 |
|---|---|---|---|---|
| merged-kpi 品牌列表含停用 | 1933（含 fg+onno） | **358**（仅 zipforce） | brands=['zipforce'] ✓ | ✅实点 |
| dashboard.py 812 行 chart wall 品牌列表 | 含停用 | 加 is_active=true | chart wall 数据正确 ✓ | ✅实点 |
| ai/org/onboarding/listing/ads 共 5 文件 8 处 | 含停用 | 全部加 is_active=true | grep 0 处遗留 ✓ | ✅实点 |

### 三、RLS 86 张表架构修复（第 3 轮，用户怒斥后深挖）

| 检查项 | 修前 | 修后 | 验证 | 状态 |
|---|---|---|---|---|
| RLS brand_isolation 含 is_active | 86 张全缺 | **86 张全有** | pg_policies qual LIKE '%is_active%' ✓ | ✅实点 |
| RLS brand_isolation 含 brand_scope | 第一轮修复时丢失 | 恢复三维完整 | pen_tests 员工品牌隔离 PASS ✓ | ✅实点 |
| tenant_brands 自引用递归 | 第一轮修复引入 | 排除系统表用 tenant_id 隔离 | portal_app 查询不递归 ✓ | ✅实点 |
| portal_app 无 scope 可见品牌 | fittingirls,onno,zipforce | **仅 zipforce** | SET ROLE portal_app 实测 ✓ | ✅实点 |
| portal_app scope=停用品牌 | 可见 | **空** | SET LOCAL app.brand_scope='onno' → 空 ✓ | ✅实点 |
| portal_app scope=活跃品牌 | 全部可见 | **仅该品牌** | SET LOCAL app.brand_scope='zipforce' ✓ | ✅实点 |
| RLS 策略三维完整性入四层审计 | 无 | L2 新增检查项 | 首跑 PASS ✓ | ✅实点 |
| RLS 策略数量稳定入四层审计 | 无 | L2 新增（vs 期望 86） | 首跑 PASS ✓ | ✅实点 |

### 三补、RLS 引擎回滚根治 + 审计级联（2026-09-25 下午，用户令「干」）

| 检查项 | 修前 | 修后 | 验证 | 状态 |
|---|---|---|---|---|
| 清洗引擎 RLS 模板含 is_active | 两份拷贝(audit_clean_all+clean_audit)均为两维，每轮清洗把 62 号修复刷回 | 两份都补 b.is_active 三维 + 镜像重建 | 引擎全周期(run f55219db2eca)后 86 张仍三维 missing=0 ✓ | ✅实点 |
| 停用品牌 portal_app 可见性(引擎跑完后) | onno/fittingirls 可见 | 不可见 | SET ROLE portal_app 探针: 无scope→仅zipforce, scope=停用→空 ✓ | ✅实点 |
| noon_statement ingest | left(date,integer) 必报错 | left(stmt_month::text,7) | 复跑 38 行落库(2025-01~2026-07) ✓ | ✅实点 |
| audit_results 批次完整性 | layer 约束拒 regression → 09-24 起截断 118 行 | pg-init/63 放行 | 批次 7cff97c7 完整 134 行含 regression/L3/L4 ✓ | ✅实点 |
| dashboard_audit amazon 基准取消单 | base 474 vs api 362 假 FAIL×8 | amz_base 补 NOT IN ('Canceled','Cancelled') | 矩阵 8 项转绿 ✓ | ✅实点 |
| kpi-pool noon 基准口径 | 月表整月加总(=4849) vs api 日级 2761 | 日级表 DISTINCT 单数/count(*) 件数 | kpi-pool 全绿(units30/orders30/cps/aov/cancel_rate) ✓ | ✅实点 |
| audit_nodes 端点登记 | 7 新端点未登记 FAIL + 2 基准口径旧 | --refresh-snapshot 122 端点 + BASAL 同步 | 17 基准全对账 ALL PASS ✓ | ✅实点 |
| e2e 限速共存(四层 L4) | 紧跟重工具 429 → 假空看板/遍历 FAIL | 起步 3.5s 排空 + 429 单页重试 + KPI 配置防御重置 | L4 PASS(自定义区间/遍历/联动全绿) ✓ | ✅实点 |
| RLS portal_app 实测隔离入四层审计 | 无 | L2 新增（模拟非管理员） | 首跑 PASS ✓ | ✅实点 |

### 四、Noon KPI 4849 月表整月加总（第 4 轮，用户持续追问）

| 检查项 | 修前 | 修后 | 验证 | 状态 |
|---|---|---|---|---|
| kpi-cards noon rolling 订单 | **4849**（月表 8月2890+9月1959 整月加总） | **2737**（日级 noon_orders 表） | API kpi-cards orders30=2737 ✓ | ✅实点 |
| kpi-cards 全部平台 rolling | 5319 | **3207**（AMZ 470→358 + Noon 4849→2737） | API 返回 3207 ✓ | ✅实点 |
| kpi-cards noon month | 1959 | 1959（不变，月度口径用月表正确） | 月度模式不受影响 ✓ | ✅实点 |
| rolling 30 天窗口跨月不整月加总 | 月表按 mon BETWEEN 加整月 | rolling 用日级表，month/year 保留月表 | 口径说明与实际查询一致 ✓ | ✅实点 |

### 五、SaaS 自审 10+1 项优化（GitHub forter/security-101 基准）

| 检查项 | 修复内容 | 验证 | 状态 |
|---|---|---|---|
| mcp_keys RLS | 加 tenant_id 策略 | relrowsecurity=t ✓ | ✅实点 |
| product_reviews RLS | 加品牌隔离策略 | relrowsecurity=t ✓ | ✅实点 |
| autocomplete_terms RLS | 加品牌隔离策略 | relrowsecurity=t ✓ | ✅实点 |
| sourcing.py str(e) 透传 | 3 处改通用 502 + stderr | 无内部路径泄露 ✓ | ✅实点 |
| API 限速(Redis middleware) | 全局 240/min + AI 20/min + MCP 60/min | 250 次顺序→12 次 429 ✓ | ✅实点 |
| 备份异地 | backup.sh scp → mercury /opt/backups/saas/ | 28MB dump 送达实检 ✓ | ✅实点 |
| TOTP 2FA | GET setup / POST verify + mfa_enabled 列 | setup→verify 全流程 ✓ | ✅实点 |
| pip-audit 入 deploy_gate | 依赖漏洞扫描(阈值 5) | gate 输出正常 ✓ | ✅实点 |
| IR 应急响应文档 | 9 章预案(4 场景+验证清单+资产表) | changelog /audit/ 在线 ✓ | ✅实点 |

### 六、品牌隔离铁律架构级教训（记入长期档案）

| 教训 | 说明 |
|---|---|
| 加新功能必须级联全部下游 | is_active 加列时 RLS/视图/查询/索引一个不能漏（本次 86 张表漏改） |
| 改 RLS 必须保留原有维度 | 丢一个维度就是新的隔离漏洞（本次丢 brand_scope 被 pen_tests 抓到） |
| 修完必须跑 pen_tests | 第一轮修复丢了 brand_scope 就是被 pen_tests 抓到的 |
| rolling 30 天跨月不整月加总 | 月表 mon BETWEEN 会把覆盖到的整月全计入，rolling 应用日级表 |
| KPI 聚合三必须 | 排除取消单 + 过滤停用品牌 + RLS 租户隔离——三个缺一数字虚高 |
| except pass 静默降级需日志 | 限速 middleware NameError 被吞→限速完全失效但不报错 |

## 回归防护体系（2026-09-25 上线，用户令"changelog 问题→checklist 每日巡检防复发"）

> 四层审计新增 `audit_regressions()` 函数，每日 06:35 自动检查 7 项历史 bug 模式。
> 来源：changelog 54 条问题记录 → 提炼为可自动化检查的回归项。
> 发现 FAIL = 该 bug 模式复发，须当日处置。

### 回归检查项（7 项，每日自动跑）

| # | 检查项 | 防什么 bug | 检查方式 | 首跑 | 状态 |
|---|---|---|---|---|---|
| R1 | KPI 取消单过滤 | 2026-09-25: KPI 含 112 取消单(470 vs 358) | API orders == DB 排除取消+仅活跃品牌 | PASS | ✅ |
| R2 | 停用品牌不入 KPI | 2026-09-25: 停用 fg+onno 计入(4755 vs 3095) | merged-kpi all == amz+noon 且 amz<500+noon<4000 | PASS | ✅ |
| R3 | Noon rolling 日级表 | 2026-09-25: 月表整月加总(4849 vs 2737) | kpi-cards noon rolling == DB 日级 distinct | PASS | ✅ |
| R4 | 错误透传(str(e)) | 2026-09-25: 内部异常文本泄露客户端 | grep 路由文件 HTTPException(e.status, str(e)) | PASS | ✅ |
| R5 | API 探活(限速不误伤) | 限速上线后 API 不通 | 5 次探活全 200 | PASS | ✅ |
| R6 | 广告双计防护(消费端onno排除) | 2026-09-08: onno 广告双计 | dashboard.py 含≥4处 brand<>'onno' + 广告花费无双计 | PASS | ✅ 修正后通过(数据含onno是设计如此, 检查消费端排除) |
| R7 | 视图裸::date(UTC日切) | 2026-09-24: UTC/北京日切分裂致丢单 | pg 全库视图扫描 | PASS | ✅ |

### 已有四层审计中的历史问题防护（在此前版本已覆盖）

| 历史 bug | 审计位置 | 检查项 |
|---|---|---|
| 品牌隔离/RLS 缺 is_active | L2 RLS 三项 | 策略三维完整+数量+实测 |
| 数据断流无人知 | L1 pipe_stale_rows | 注册表驱动全域断更 |
| 订单漏单/状态回刷缺 | L1 独立源交叉 | finances vs orders 差异 |
| 图表数字不对 | L3 chart_value_audit | 81 图双视图值对账 |
| 幽灵行 | L1/L2 reconcile | sales_hourly 格级对账 |
| Pending 卡单 | L1 Pending 回刷滞后 | 超窗检测 |
| 端点未注册 | L3 audit_nodes | 黑名单制新端点检测 |
| 页面 500/白屏 | L4 frontend_e2e | 27 页遍历+值非零 |

### 历史 bug 分类总账（54 条→7 自动检查 + 8 已有覆盖 + 人工检查项）

**已自动化（15 项）**：上表 R1-R7 + L1-L4 已有的 8 项

**需人工/半自动（以下为不可自动化的历史问题，出问题时按锚点排查）**：
- Excel 导入解析（产品建档 3220 bra 案）→ 导入后 spot check
- 会话吊销/退出登录 → pen_tests 已覆盖
- 竞品数据缺失 → keepa_watch 关注池人工维护
- 1688/供应链上游数据 → sourcing 模块人工核查
- SMTP 邮件失败 → 挂账，恢复后需验证

## 2026-09-25 自定义图表去上限 + 各列筛选 + 品牌联动 底账（用户两道令）

> 来源：①「维度度量我们要任意个 + 各列都有 filter」②「自定义分析和添加自定义图表页面要跟随租户品牌联动」。
> 引擎：api/routers/reports.py（白名单 5 域 11 维 30 度）；前端：web/components/CustomModules.tsx。

### 本轮验证项（全部实测过，勿凭记忆复述）

| # | 检查项 | 验证方式 | 结果 |
|---|---|---|---|
| C1 | 维度/度量无上限 | 编辑器实点 4 维+7 度全勾选无拦截（cm_e2e.py A 步） | ✅ |
| C2 | 多维成图 | 3 维(mon/brand/country)×5 度量：mon=X 轴、brand×country 组合拆系列，canvas 渲染 | ✅ |
| C3 | 各列筛选生效 | 品牌筛 'zip' 行收敛 + orders Min=10 再收敛 + 筛后徽标「筛后 n/总」 | ✅ |
| C4 | 筛选诚实性 | 无匹配词 zzz → 0 行 + 显式「列筛选后无匹配行」；筛选行 0 行时常驻不卸载（可清筛回退）；不显示误导性 0 | ✅ |
| C5 | 筛选作用于图表 | 表格态筛完切图表态，图数据=筛后集合（shown 单源） | ✅ |
| C6 | 品牌联动(请求体) | Playwright 拦截 POST /api/reports/query → filters.brand='zipforce' | ✅ |
| C7 | 品牌联动(呈现) | 表内品牌列全=['zipforce']；编辑器说明行含当前页首品牌 | ✅ |
| C8 | 单品牌租户语义 | /api/tenant/info brands=['zipforce'] → 页首自动锁定、切换面不渲染（brands<2）=预期非缺陷 | ✅ |
| C9 | 注入防御 | brand='x' OR '1'='1' → 0 行（全参数化） | ✅ |
| C10 | 四道门 | pen_tests/dashboard_audit/frontend_e2e/audit_nodes 两轮全绿（去上限轮+联动轮） | ✅ |

### 关键实现锚点（排查先看这里）

- 去上限：reports.py `_validate` 不再卡 ≤2/≤4；常量占位维度（platform/sku/asin/status/campaign/term）只进 SELECT 不进 GROUP BY；词维 campaign/term 组合越界显式 400。
- 各列筛选：CustomModules.tsx `ColFilter`/`colf`/`shown` useMemo——维度列 q 文本包含、度量列 Min/Max；表格与图表共用 `shown`。
- 品牌联动：ModuleCard `useBrand()` 模块级 store（非 React context，页面组件是 BrandProvider 的父级）；主从=页首切换覆盖卡片选择；def 不烘焙品牌、渲染期套用。
- 已知边界：65 系列（13 国×5 度）图例拥挤 → 宽组合用表格模式（筛选在表格态）；共享 GChart 不为此单点改。

## 2026-09-25 SKU 维度真实化 + 下拉筛选 + 优雅降级 + 广告页锚对齐 底账（第廿八轮）

> 来源：用户令「sku 无值，选择器尽可能是下拉菜单选择」。引擎 reports.py 单侧源三模式 + CustomModules 下拉级联；
> 战役中连带根治两个对账假 FAIL（审计基准 UTC 锚 / ads.py API UTC 锚）。

### 本轮验证项（全部实测过）

| # | 检查项 | 验证方式 | 结果 |
|---|---|---|---|
| S1 | SKU 维度真值 | daily 域 sku 查询 51 行真实 SKU（原 '-' 占位）；ADSKU 模式 ads_sku_daily 专查 | ✅ |
| S2 | 单侧守卫 | SKU 维×订单指标建档 → 400 + 教学信息；词维/订单状态同规 | ✅ |
| S3 | 渲染态优雅降级 | 旧 def（def#22 18 度×sku）渲染 → 200 rows=[] + note「该图表暂不可计算…」；建档仍 400 | ✅ |
| S4 | def22 页面呈现 | Playwright：红错「加载失败」=0、优雅 note=1、全页加载失败=0；截图 analyze_image 确认 | ✅ |
| S5 | 下拉级联筛选 | 维度列=下拉（选项=其余列筛选后剩余行去重值∪当前值）、度量=Min/Max；桌面/编辑器/手机三截图视觉确认 | ✅ |
| S6 | orders 口径 | sum(orders) 替换 count(*)（CTE 行数≠订单数，2026-07 实测 147 vs 574） | ✅ |
| S7 | 审计锚对齐(工具) | dashboard_audit 三处上海锚 → FAIL 0（原 $6.72=08-27 花费假 FAIL） | ✅ |
| S8 | 广告页锚对齐(API) | ads/analysis api=414.65 ↔ 基准 415（原 421.37 UTC 锚含 08-27）；_daywin 级联 4 端点+campaigns/optlog/upload/reattribute 共 6 处 | ✅ |
| S9 | campaigns 500 事故 | SQL 字符串内 # 注释剥除 → pen_tests J 恢复 200 | ✅ |
| S10 | 四道门终态 | pen_tests ALL PASS · dashboard_audit FAIL 0 WARN 1(预存) · frontend_e2e ALL PASS · audit_nodes ALL PASS | ✅ |

### 关键实现锚点

- 单侧源模式：reports.py `_daily_base_sql` 返回 mode（ADSKU/ORDSTATUS/ADTERMS/DAILY）+ dim_map；asin 已移出 daily（rank 域仍真）。
- 优雅降级：report_query 捕 _validate 的 400 → 空 rows+note；前端只在 note 前缀「该图表暂不可计算」时红字显示。
- 下拉级联：CustomModules `dimOpts` useMemo（其余列谓词过滤后的去重值∪当前值防受控失配）。
- 锚对齐惯例：业务日=北京 `(now() AT TIME ZONE 'Asia/Shanghai')::date`（bj_today 同规）；timestamptz 列「今日」计数须 `((now() AT TIME ZONE 'Asia/Shanghai')::date::timestamp AT TIME ZONE 'Asia/Shanghai')`。
- 教训：Python # 注释禁入三引号 SQL 字符串（PG 语法错 500）。


## 2026-09-26 选品+广告页审计六包修复 底账（第廿九轮，用户令「审计…怎么优化完善」→「全干」）

> 来源：两 Explore 只读审计 49 条（广告 24 + 选品 25）→ P0-P2 六包提案 → 用户批「全干」，执行序 A→E→B→D→C，F 出清单。
> 本轮全部条目见 changelog 2026-09-26 六条；此处只记验证矩阵与勿再踩锚点。

### 本轮验证项（全部实测过）

| # | 检查项 | 验证方式 | 结果 |
|---|---|---|---|
| R1 | A① rule-config 复活 | API 54 条 brand='' 全局默认可见 + 截图 ads-ruleconfig-restored.png | ✅ |
| R2 | A② 竞品规则 | rules_ads 游标覆盖修复后 competitor_event 可产出行（BSR 源缺口挂 F/X1） | ✅ |
| R3 | A③ CTR 真口径 | search-terms 页实测 0.09-12.59% 全 <100（原显示 81.9%） | ✅ |
| R4 | E1 aba-refresh 补跑 | ssh mercury 别名修复后补跑 13,750+19,722 行 | ✅ |
| R5 | E2/E3 水位行+国家矩阵 | sourcing-watermark-countries.png analyze_image 过；COUNTRIES 14 国=aba_search_terms 实态 | ✅ |
| R6 | B stage 窗/冷却锁/pending | 引擎跑批 expired 1211（积压 2449→1233）；API total 1008/pending 402/latest_run 当日 | ✅ |
| R7 | B state/optlog | 租户 2 模拟 5 onno 活动真实健康度；optlog 徽章「今日 0 · 7 天前」三截图 analyze_image 过 | ✅ |
| R8 | D1 词宇宙扩容 | aba_search_terms 1,593,438 行（531,146×3）、8,868 词、14 国、radar_terms_new=8819 | ✅ |
| R9 | D1 awk 防呆 | aba-refresh.sh 正则改 `^COPY aba_search_terms\(` 后计数 1,062,292=531,146×2 ✓（原恒 0 假阳性） | ✅ |
| R10 | D1 租户自愈 | demo_tenant_ids 按 aba_term_universe 存量选择 → tenants=[1,2,3]（原漏改名后的租户 3） | ✅ |
| R11 | D2/D3 证据国别+verdicts | SQL 权威：TERM 命中 9352/9352=100%（修复前 11/9352=0.1%）；脚注「杀648/攻162/待验96」双视口截图过 | ✅ |
| R12 | D4 换手率图 | 双视口实测 0%~66% 数据线 13 个月（修复前恒空）；d4-turnover-*.png analyze_image 过 | ✅ |
| R13 | D5 物化 5/5 | materialize processed 9,861 → 池 9,352 TERM + 161 ASIN（basket100/repeat161 去重后） | ✅ |
| R14 | C onno 断链 | config 注册+on=True；无 zip rc=0 双分支（清理残留/等待投递）；worker 53 函数；cron {2,3,4,5} | ✅ |
| R15 | C 窗口安全重启 | force-recreate 前查 /proc 无活动适配器（02:15=zf-ads 窗口附近） | ✅ |
| R16 | 四道门终态（D/C 后） | pen_tests ALL PASS · dashboard_audit FAIL 0 WARN 1(预存 today-noon) · frontend_e2e ALL PASS · audit_nodes ALL PASS（122 端点/1978 节点） | ✅ |

### 已知边界（勿当 bug 报）
- 决策台 ASIN 级行证据「数据不足」：共现 ASIN≠词 Top3（periods 1/161 合法趋零）+ Dell Keepa 档案不含这些 ASIN（0/76）→ 诚实显示；证据源增强=F3-7。
- candidates API limit 硬帽 200=UI 窗设计；权威命中率验证必须走 SQL。
- C 包数据恢复依赖用户侧人工投递 zip（08-31 起停），pipe_stale >2 天报警兜底。

### 关键实现锚点（勿再踩）
- run.py 调度契约：模块必须导出 run(mode)；无外连适配器不注册 BRAND_OF（出口断言只对有网适配器）。
- /collection 是 bind mount：宿主改即生效；api/tasks.py 是 COPY 进镜像→必须 rebuild+force-recreate。
- aba_search_terms 现 COPY 批量格式；awk 防呆正则带 `\(`；租户选择禁写死 slug（改名即静默断更）。
- Playwright 决策台：tab=get_by_role button「⚖ 决策台」；卡片=locator("div.card").filter(has_text=…)；login() 返回 (cookie_str, token) 元组。
- 大 SQL（531K 行 EXISTS×9352）无索引会超 120s → 后台跑，别堵前台。

### 未决（等用户，不许擅动——继承）
- ② A2/A4 四件套处置 A/B/C；④ 4849 前端强刷终验；⑤ mercury pm 备份停止（用户侧）；onno/FR 断流挂账 vs 修源；def#22 处置。
- F 批次执行排程（建议 F1→F4→F2→F3，F3 逐条过用户）。

## 2026-09-26 第三十轮 · F1+F4+F2 三批 + ②C(A2/A4 全面接线) + def#22 重建 + ④ 4849 终验 底账（用户令「全干」）

### 本轮验证项（全部实测过，勿凭记忆复述）

| # | 项 | 证据 | 状态 |
|---|---|---|---|
| R17 | F1 九条落码 | SAVEPOINT 隔离/rules_ads.py:228；_calc_gp 收敛:102；KPI 混源声明 ads.py:115；min_spend 语义:719；keyword-bids 下推 ORDER BY+LIMIT/OFFSET | ✅ |
| R18 | F4 四条落码 | pg-init/65-rls-dual-permissive-converge-20260926.sql（F4-1 keepa_pull_log RLS+F4-2 双 PERMISSIVE 收敛）；verdicts.py:304 F4-3 批量化 7.8s→数百 ms | ✅ |
| R19 | F2 七条落码+视觉 | page.tsx:87 F2-1 自动重查；:404/:659 F2-2/F2-3 加载更多；:217 F2-4 删有效ASIN卡；metrics.py:24 F2-6 单源；7 页双视口截图 analyze_image 过 | ✅ |
| R20 | F2-6 数据实证 | ads 页切 Noon：花费 $173,060 / 广告销售 $733,640 / ROAS 4.24（noon_ads_daily 全品牌单源） | ✅ |
| R21 | A2 手动链路 | publish → 消费者 handled+水位标记+ack | ✅ |
| R22 | A2 fx 真实链路 | daily_fx_rates → 3 ExchangeRateUpdated → 1 清洗 94/94 表 + 2 节流跳过 + XPENDING=0 + 锁在位 | ✅ |
| R23 | A2 ingest 真实链路 | 04:30 ingest_all→04:42:52 水位 12 键(4域×3租户)；04:43 ingest_today→04:50:57 orders×3 租户覆盖；XPENDING=0 | ✅ |
| R24 | A4 门控三态 | active_brand_tenants={onno:[2],zipforce:[1],brainnews:[2],fittingirls:[3]}；SET paused→zipforce False→DEL→True；未知品牌 False | ✅ |
| R25 | /api/tenant/jobs | jobs+tenants(fresh)+recent_events 200（decode_responses 修复后）；audit_nodes 快照登记 123 端点 | ✅ |
| R26 | def#22/24 | def#22 [mon,sku]×9 rows=51；def#24 [mon]×18 rows=4 月；ORDER BY 1 修复（split(',') 截断 to_char 语法错） | ✅ |
| R27 | ④ 4849 终验 | 无缓存浏览器切 Noon：30天订单 2,990（DOM 抽取）≠4849；视觉桌面 2,490/移动 2,900 均≠4849；10 卡+FBN 卡全渲染无报错 | ✅ |
| R28 | 四道门终态 | pen_tests ALL PASS · dashboard_audit 178+ FAIL 0 · frontend_e2e ALL PASS（复跑；首跑 /finance networkidle 超时=ingest 清洗窗口争用瞬态）· audit_nodes ALL PASS(123) | ✅ |

### 已知边界（勿当 bug 报）
- worker 日志看不到 "published CleanDataRefreshed: N tenants"（sync_mercury log.info 默认 WARNING 级不输出）——发布是否发生以消费者侧 handled 行+水位键为准。
- fx 事件节流锁 1h 窗口：06:05 daily_fx_rates 每日会再触发一次全管道清洗（锁已过期），属设计内例行。
- zf 的 zipforce_noon_ads_queries 表存在未接（搜索词查询报表源，无消费方）——挂账待需求。
- ads 页 platform/timeRange 本地 state 不进 URL（直链/刷新回默认 Amazon）——已知，改 URL 化属增强非缺陷。
- F2-2 加载更多 <200 行时不渲染按钮=正确（无更多页）。
- frontend_e2e 与 04:43/04:30 ingest 清洗窗口重叠偶发 networkidle 超时——复跑判定，勿当回归。

### 关键实现锚点（勿再踩）
- worker 侧查租户表（tenant_brands 等）必须 sync_mercury._admin_conn()——tasks._pool() 连接被 RLS 静默滤成 0 行且无报错。
- docker compose logs | while read 循环体内嵌套 docker compose exec 会吞管道 stdin——先落数组或单次 MGET。
- ADSKU/单侧源分支 ORDER BY 用列位 `ORDER BY 1`，禁 grp.split(',')（首维含 to_char 逗号即截断）。
- analyze_image 分析服务缓存旧 URL 内容——同 md5 换新文件名穿透（-v2 技法）。
- ads 页/dashboard 页平台选择器都是本地 state（useState+button.tab），playwright 须导航后点击。

### 未决（等用户，不许擅动——继承）
- F3 八条逐条过用户（F3-1 分时图先查小时级数据存在性；F3-2 否词UI；F3-3 预算规则；F3-4 GRP_CN 收割/否定；F3-5 决策台批量回填+限频；F3-6 /api/ai/sourcing 权限拆分；F3-7 ASIN 证据源；F3-8 execRec 覆盖面）。
- ⑤ mercury pm 备份旧任务停止（用户侧）；onno zip 人工投递恢复（用户侧，08-31 起停，05:00 UTC 槽位已就绪）。
- 竞品 BSR 数据源缺口（②C 调度底座就绪后仍缺源）；mercury Dell 源头停更需求单（用户侧移交）。

## 2026-09-26 第三十一轮 · F3 功能增强八条全量（用户令「F3 全干」）底账
| # | 项 | 验证 | 状态 |
|---|---|---|---|
| F3-1 | 分时 tab + /api/ads/dayparting | 24 行·峰值 00-02 时·Amazon 覆盖 32 天/Noon 60 天·ads_hourly_available=False+显式无数据注记·EChart canvas 渲染 | ✅ |
| F3-2 | neg_keywords 注册表+CRUD+UI+引擎并集 | 表 RLS+UNIQUE；create/patch(驳回)/delete 往返 200+audit_log 三条；引擎 done_neg 并集(active+rejected+通配)；pg-init/66 补 seq GRANT(首测 500 修复) | ✅ |
| F3-3 | budget_inflection 4 + budget_ladder | 引擎重跑 343 条：inflection 4(H24/T11 SP Auto 等)；ladder 0=无达标(最优 ACOS 18.2%/$75<80 门槛·数据事实)；⑥ 与 ⑥b ladder_done 去重 | ✅ |
| F3-4 | 分匹配红线/提价帽/自动关停 | st_broad 38/st_phrase 35 生效(reason 注明匹配红线)；raise_max_pct 0.25 小数口径修正；sp_auto_close_days=60 接线·自动广告识别(仅搜索词报表)=close_campaign 1 条 | ✅ |
| F3-5 | 重算窗口限频 | 1st 200(9861 行)→2nd 429 带 TTL 593s→force(owner) 200；watch_note 播种说明；前端按钮+二次确认+冷却弹窗 | ✅ |
| F3-6 | /api/ai/sourcing 权限拆分 | stub 无 ai 租户：degraded=True·model=code-snapshot·2569 字真实快照(15 pro max case AE 24 月)·零 LLM；无参+无 ai→400 | ✅ |
| F3-7 | keepa_watch 播种+keepa_daily 回退 | 播种 CTE(≥3 期)跑通(现 0=唯一达标 AE 无 Keepa 域, 诚实跳过)；回退实测 B09P1G2952/B0CTZHY9D7 own_src=keepa_daily·snap 09-26·FR 留空；drops30≈月销前端 ≈ 标注 | ✅ |
| F3-8 | 关键词级执行 | pause_keyword/update_bid 走 campaign 翻页解析 keywordId(6×100)·bid 护栏[0.02,10]；执行按钮 gating(keyword+4 规则)；搜索词否定路由否词库(不盲执行) | ✅(代码级,未点真广告) |
| 附1 | verdicts_decision _evidence 悬空 | F4-3 批量化删了单行版但 378 行仍引用→每次裁决 500；改 _evidence_batch(带 level) | ✅ |
| 附2 | 优化建议页新规则标签 | ads.py _RULE_CN_MAP 漏 5 条新规则(显英文键)+web RULE_TONE 缺 5；补齐 DOM 断言 ROAS拐点预警/调价建议 True | ✅ |
| 附3 | 05:40 cron 旧镜像清规则 | 部署窗口内 cron 用旧 worker 删 pending 新规则行；API 重触发恢复 343(教训:改引擎后立即 force-recreate 再等 cron) | ✅ |
| R | 四道门 | pen_tests ALL PASS · dashboard_audit FAIL 0 · frontend_e2e ALL PASS(67) · audit_nodes ALL PASS(125 端点,快照 bak-20260926-f3 后 refresh) | ✅ |
| R | 截图自检 | 8 张(4 页×双视口)存 screenshots/+OCR+DOM 断言(OCR 对 emoji 前缀标签不敏感,以 DOM 为准) | ✅ |

### F3 已知边界（勿当 bug 报）
- budget_ladder 0 行=无达标活动(花费≥$80 且 ACOS<18%)——数据事实；门槛可在规则配置调。
- keepa_daily 回退仅 US(domain=1)有数据；且 RLS watch_isolation=只看见关注池内 ASIN(与播种配套,池外诚实 None)。
- 搜索词级否定不提供自动执行(无 campaign 上下文,盲加全活动有损伤风险)→否词库留痕+后台手动。
- 分时页广告侧=无数据(Amazon Ads 报表仅日粒度),页面显式注记,无分时花费/ACOS。
- gate 脚本连续跑互相干扰:pen_tests 暴力测试把 127.0.0.1 登录失败计数顶到 10→后续 gate 登录 429(10 分钟窗)。单独跑/清 loginfail:* 键/pen_tests 放最后。pipe_audit FAIL 2(onno ES 4 天/FR 5 天断流)=源头侧,与 F3 无关已上报。
