⏳ 历史快照(冻结于 2026-10-05,不再更新)——现行口径(铁律/容器/业务流/数据流/定时任务)以 audit.html 第 0 节 为准;2026-10-14 起的变更记录在 audit.html 第 9 节。页内 mercury/Dell/222 为已退役链路的历史标签(2026-10-18 清零,勿作现行拓扑)。
Audit System

四层审计体系

rawdata → cleandata → api → web · 2026-09-24 立 · 全代码执行零 LLM · 在线状态见 /pipeline 页 · 诞生背景:工作台订单图表 3 天 10 问的终局治理
mercury/venus 源表 → 采集器(mars /collection) → SaaS 业务表 → 清洗层(audit.cleaned_*) → FastAPI 端点 → Next.js 页面  →  审计触点:宿主 crontab 06:35(four_layer_audit) + 部署门 deploy_gate 六门

L1 · rawdata 源头采集 数据进没进、全不全、源头口径对不对

审计项方法实战战绩(2026-09-24)
新鲜度断流每品牌×站点 max(purchase_date);活跃站(近30天≥15单) gap≥4 天 FAILzf SA/AE 断流 14 天、fg PL 断流
授权完整性sellers/v1/marketplaceParticipations 逐 token 实测 vs 采集配置sa/ae 凭证丢失、zf 漏配 6 市场、fg 漏配 NL/IE/PL(+499 单)
独立源交叉finances Shipment 事件 vs orders 表(orders ≥ finances 才健康)fg 29 单状态流转换漏采
状态生命周期Pending/Unshipped 存量 × last_update_date 年龄;成熟周费用覆盖 ≥90%1,388 单卡单、zf 08-17 周覆盖 83%
日切口径timestamptz 禁裸 ::date,必须 AT TIME ZONE 'Asia/Shanghai'fg 视图 UTC 日(两表 diff ±15 根源)
品牌源头隔离混品牌表 brand 判定:mapping 覆盖 + 变体 SKU 前缀剥离amzn.gr.* 误标 2 单

L2 · cleandata 清洗层 清洗是否忠实、标记是否暴露问题而非掩盖

审计项方法实战战绩
行数对账cleaned vs 源表逐品牌×逐表ingest 37,756 → 38,289 行核对
两表一致cleaned_amazon_orders vs cleaned_sales_hourly 近 7 天 diff(取消单口径对齐)fg diff ±15 → ≤2 验收锚
清洗标记趋势is_valid / issues / rev_estimated 计数fg 金额断流期的诊断起点
RLS 完整性每张 cleaned 表 policy = tenant_brands 活跃集pen_tests 常规覆盖

L3 · api 端点层 聚合口径对不对、标题说没说真话

审计项方法实战战绩
逐图值对账chart_value_audit.py:API 输出 vs DB 独立重算,81 图锚点(zipforce+onno 双视图)multiSku 差 1 单、SKU 均摊差 5%、promoPie 恒 0
标题语义锚声称"最近数据日/今日/24小时"的图,系列合计 ≈ SQL 最新单日量09-17 标题撒谎案
加和性不变量全品牌视图 = 各品牌之和 + 沿 country 维monthSettle 覆盖 bug
费用覆盖门成熟周 order_fees 覆盖 ≥90%83% FAIL → 回刷后绿
数值节点快照audit_nodes:101 端点 1605 节点 + BASAL 锚每次部署跑

L4 · web 前端层 用户看到的和 API 给的一致吗、展示误导吗

审计项方法实战战绩
视觉自检双视口截图(1440/375) + 视觉核验,存 changelog screenshots/"数据日"标注、09-24* 星标
联动一致性品牌/国家/时间选择器切换后数据必须响应"切国家看板不变"历史 bug
误导性 0 防护缺数据显示 Pending/—/标注而非 0fg Pending「金额待结算」
e2e 契约frontend_e2e:27 页遍历 + 联动 + 值非零部署门之一

运行载体 零 LLM,全代码

载体内容频率
tools/four_layer_audit.py四层轻量日检 15 项 → audit_results(只追加表)宿主 crontab 06:35 每日
tools/deploy_gate.sh 六门镜像固化 + pen_tests + dashboard_audit + audit_nodes + pipe_audit(L1/L2) + chart_value(L3) + frontend_e2e(L4)每次部署
/api/pipeline/audit最新批次 + 7 天趋势实时读表
/pipeline 页四层区块四层卡片 + 点击展开明细 + 批次/趋势实时

排障复盘锚点("图表不对"再来时按序查):① SaaS 两表 diff ≤2 → ② 费用覆盖门 → ③ SA/AE 增量有单 → ④ mercury 视图定义未被改回 → ⑤ token 授权 vs 配置。