# SaaS 系统全量功能测试总览（2026-09-20 ~ 09-21）

执行方式：自动化骨架（playwright 遍历）+ 人工关键路径详测（playwright 实操 + curl 接口核对）
覆盖：28 页面 · 全部 tab · 多品牌切换 · 核心交互（排序/筛选/搜索/编辑/导出/下载/开关）
截图：270+ 张（skeleton 135 + 详测 87+），全部存档 test-reports/

## 报告清单（13 份）

| # | 报告文件 | 覆盖页面 | 结论 |
|---|---------|---------|------|
| 1 | 2026-09-20-saas-test-skeleton.md | 28 页面×多品牌×全部 tab（10,952 控件存在性） | 骨架完成 |
| 2 | 2026-09-20-finance-detailed-test.md | /finance（KPI/分市场公式/Annual Summary/三选择器） | 全部通过 |
| 3 | 2026-09-21-orders-detailed-test.md | /orders（10 关键路径，37,469 订单与 API 一致） | 全部通过 |
| 4 | 2026-09-21-inventory-detailed-test.md | /inventory（8 关键路径） | 全部通过 |
| 5 | 2026-09-21-ads-detailed-test.md | /ads 8 tab×3 品牌×2 平台 | 通过（修复缺陷 1） |
| 6 | 2026-09-21-sourcing-rankings-detailed-test.md | /sourcing 4 视图 + /rankings | 通过 |
| 7 | 2026-09-21-home-today-detailed-test.md | / 工作台 + /today | 通过（from/to 确认已生效、今日无 from/to） |
| 8 | 2026-09-21-products-po-settlement-logistics-detailed-test.md | /products /po /settlement /logistics | 通过（修复缺陷 2） |
| 9 | 2026-09-21-promotion-projects-listings-detailed-test.md | /promotion /projects /listings | 通过 |
| 10 | 2026-09-21-noon-mapping-pipeline-detailed-test.md | /noon /mapping /pipeline | 通过（CSV 导出实测下载成功） |
| 11 | 2026-09-21-database-onboarding-detailed-test.md | /database /onboarding | 通过 |
| 12 | 2026-09-21-documents-training-feishu-detailed-test.md | /documents /training /feishu | 通过 |
| 13 | 2026-09-21-team-account-billing-settings-detailed-test.md | /team /account /billing /settings | 通过 |

## 测试中发现并修复的缺陷（2 个）

| # | 页面 | 现象 | 根因 | 修复 | 复验 |
|---|------|------|------|------|------|
| 1 | 广告·平台投放 | KPI 不随时间范围变化（6 档全同 $15,211） | /api/ads/platform SQL 未使用 days 参数（docstring 与实现不符） | api/routers/ads.py 6 处查询补 day/report_date 过滤，rebuild api | days=7/30/90/0 返回 1/2/4/6 个月；页面"本月"$1,916、"近3月"$12,412 联动 ✓ |
| 2 | 回款 | 已回款率显示 0.9%（应 94.3%） | settled_rate 接口返回 0~1 比例，前端 pct() 直接拼 % | settlement/page.tsx ×100 后格式化，rebuild web | 页面显示 94.3% ✓ |

## 跨页观察项汇总（不阻断，建议排期）

1. **订单跨品牌重复**：订单 202-1913683-9831518 同时在 zipforce(FBA) 与 onno(AFN)——疑似源头跨品牌重复抓取（orders 报告，建议核查采集去重键）。
2. **sku_mapping 脏数据**：首条 SKU 为空字符串（inventory + database 两处复现）。
3. **物流数据滞后**：shipments stats as_of=2026-09-05，16 天未更新，建议核查采集任务。
4. **推广采集停滞**：近 7 日采集=0、数据截至 2026-09-06。
5. **飞书凭据未配**：文档树镜像日更"待凭据"，文档镜像停在 09-06；在计费页提交飞书 App 凭据即可开通。
6. **会话膨胀**：账户安全页 65 个活跃会话（自动化测试残留），建议清理并给 pen_tests 独立账号。
7. **选品/物流 tab 不写 URL**：刷新回默认 tab，功能不受影响。
8. **监控池测试数据**：B0PENTEST01（pen_tests 夹具）可清理。
9. **项目页 8 产品全部 0% 进度**：任务为初始化模板，建议选一个产品录入真实进度试点。
10. **时间映射近似**：广告时间选择器"上月"=近 60 天滚动窗，非自然月。

## 铁律执行情况
- 全部详测通过真实点击路径执行（发现并绕过 2 处"URL ?tab= 不驱动组件内状态"的测试陷阱：选品/物流）。
- 写操作只验证通路与校验拦截（决策理由必填、执行需确认串、PO 空态拦截），不向生产写入业务脏数据。
- 数据缺失一律以页面空态/"暂无数据/数据不足"兜底文案验证，未出现误导性 0。
