# ZIPFORCE Hub 全站审计总结（2026-09-20 ~ 09-21）

执行：主 agent（playwright 实操 + curl 接口核对 + 源库源头取证）
范围：28 页面全量功能测试 → 缺陷修复 → 数据卫生 → 回归门 → 定时管道收编

---

## 一、测试审计（13 份报告，test-reports/）

| 维度 | 结果 |
|------|------|
| 覆盖 | 28 页面 × 全部 tab × 多品牌 × Amazon/Noon 双平台，10,952 控件存在性 + 关键路径实操 |
| 报告 | 骨架 1 + 详测 12（财务/订单/库存/广告/选品排名/工作台今日/商品PO回款物流/推广项目Listing/Noon建档管道/数据浏览品牌/文档培训飞书/团队账户计费API）|
| 截图 | 270+ 张存档 |
| 结论 | 全部通过；写出 10 条跨页观察项（均已处置，见下）|

测试方法教训（已沉淀）：
- 选品/物流页 tab 是组件内状态——URL 直跳测不到真实行为，必须按用户真实点击路径测（首轮测试因此全部重做）
- 写操作只验证通路与校验拦截（决策理由必填/执行确认串/空态拦截），不向生产写业务脏数据

## 二、缺陷与修复台账（10 项，全部复验）

### 测试发现当日修复（09-21 上午）
| # | 缺陷 | 根因 | 修复 | 复验 |
|---|------|------|------|------|
| 1 | 广告平台投放 KPI 不随时间范围变化 | /api/ads/platform SQL 未用 days 参数（docstring 与实现不符）| 6 处查询补时间过滤 | days=7/30/90/0 返回 1/2/4/6 个月 ✓ |
| 2 | 回款页已回款率显示 0.9%（应 94.3%）| 接口返回 0~1 比例，前端 pct() 直接拼 % | ×100 后格式化 | 94.3% ✓ |
| 3 | frontend_e2e 两处过期选择器 | 财务页 Noon tab 已按需求移除；mapping 编辑入口改按钮 | e2e 同步现状 | ALL PASS ✓ |

### 观察项修复（09-21 下午，用户令"修复所有的问题"）
| # | 问题 | 根因 | 修复 | 复验 |
|---|------|------|------|------|
| 4 | 订单跨品牌双计（83+2 幽灵行）| 对账删除把源侧 SQL 内嵌本地执行必报错→savepoint 连 upsert 回滚，幽灵行从未删过；fg 分支缺排他守卫 | 改用本轮取回键集临时表对账 + fg 补 NOT EXISTS（22,282 单仅 2 重叠，无副作用）| 全量重灌后跨品牌重复 = 0 ✓ |
| 5 | sku_mapping 空 SKU 脏数据并级联三表 | 空 SKU 转空串后仅拦 None | `if not sku_val` 拦截 + 三表空壳清理 | 全部 = 0 ✓ |
| 6 | 物流运单 16 天断更 | 运单表只有 pg-init 一次性种子，**从未有喂入口** | 新增 CSV 导入接口（中英列名+徽章归类+(brand,awb) UPSERT）+ 页面按钮 + 报警纳入"在途 7 天无轨迹" | 幂等实测 ✓（等货代真实报表）|
| 7 | 推广"近 7 日采集=0" | 源库一直在更（1,221 渠道当日更新），SaaS 只有 09-06 一次性快照 | promotion_refresh 日更管道（**SaaS 人工 status/notes 永不覆盖**）| 首跑 2,674 upsert，last_checked=当日 ✓ |
| 8 | 选品/物流 tab 不写 URL | 组件内 useState | 物流页改 useQueryState（选品页本已同步，参数 mtab）| 刷新保持 ✓ |
| 9 | 广告"上月"=近 60 天近似 | 只有滚动窗口 | API `_daywin` 支持 from/to（5 接口，正则校验防注入）+ 前端自然月区间 | 上月=1 个月 $5,661.61 ✓ |
| 10 | 监控池 B0PENTEST01 反复复活 | pen_tests 每轮 listing 导回级联进关注池 | pen_tests 补自清理步骤 | 复跑 ALL PASS 且残留=0 ✓ |

回归中 e2e 还抓出 from_date 空串 500 边界，当场修复（无窗口时不得拼字面量 TRUE 进 WHERE）。

## 三、回归门（每日改动后必跑）

| 门 | 结果 |
|----|------|
| pen_tests | ALL PASS（含自清理闭环）|
| audit_nodes | ALL PASS（快照 113 端点）|
| dashboard_audit | 178+ 项检查 FAIL 0 |
| frontend_e2e | ALL PASS |

## 四、数据卫生终态

| 检查项 | 状态 |
|--------|------|
| 跨品牌重复订单 | 0 |
| 空 SKU（mapping/products/inv_products）| 0 |
| 监控池测试残留 | 0（自清理闭环）|
| 测试残留会话 | 已清理（按 TTL 保留最近 3 个，用户授权后执行）|
| 运单 as_of | 待货代报表上传后自动前移 |

## 五、定时管道全景（注册表驱动）

- 源库主数据 04:30 日更 / 周日 02:00 订单全量对齐（本轮修复的对账删除即挂在此）
- kol-refresh 04:50 + **promotion-refresh 04:55（本轮新建并注册 crontab）**
- Keepa 05:10 / 排名 05:20 / 汇率 06:05 / 广告规则引擎 05:40
- 水位报警 06:15（本轮新增运单在途检查）/ 费用覆盖 06:20 / 源漂移 06:30
- Amazon/Noon 采集：15 分钟级订单 + 6 小时级财务/全量（mars 统一采集器）

## 六、遗留（非代码问题，需业务输入）

1. **飞书日更"待凭据"**：需租户自己的飞书开放平台 App ID/Secret（BYOK，计费页提交）
2. **项目页 8 产品 0% 进度**：任务为初始化模板，需业务录入真实进度
3. **运单数据**：管道就绪，等下一批货代导出报表上传验证
4. 自动化测试建议改用独立测试账号（避免污染 owner 会话/数据）

---
配套：changelog.zipforcehub.com（2026-09-21 全部条目）· test-reports/（13 份报告）· screenshots（过程截图）
