# 全栈审计 · 最细颗粒度（2026-09-26 · 第三十三轮）

**范围**：全站 39 路由页 × 全部 API 端点 × 129 public 表 + 99 清洗表 × 按钮矩阵 × 图表口径 × 四层穿透（raw→clean→api→web）× 四维隔离 × 模块门控。
**纪律**：只读审计，零代码改动；每条发现 API/DB 实证；分级 P0（资损/跨租户）/P1（口径错致决策错）/P2（口径不统一/误导）/P3（卫生/一致性/潜伏）；修复批次表在文末，用户拍板后执行。
**已审计轮次引用**：29-31 轮（选品+广告）、32 轮（工作台/今日/财务）、G+④A（广告上传链）。这些页面本轮只查跨页联动，不重审。

## 0. 表面全景（FS-0）

### 0.1 导航可达页（AppShell 5 组 30 项）
- **经营**：/(工作台✓32) /today(✓32) /finance(mod:finance✓32) /ads(mod:ads✓G) /sourcing(mod:sourcing✓29) /rankings(基座)
- **运营**：/products(基座) /orders(mod:orders) /inventory(mod:inventory) /po(mod:inventory) /settlement(mod:finance) /logistics(mod:logistics) /promotion(mod:ads) /projects(mod:collab) /listings(mod:listing·t1已关)
- **数据**：/noon(mod:finance) /mapping(基座) /pipeline(基座) /dictionary(基座) /database(adminOnly)
- **协作**：/documents /training /feishu(均mod:collab) /ai(mod:ai)
- **系统**：/team /account /billing /settings(adminOnly)
- 顶栏告警条4类：库存紧急(settlement 同源 _ALERT_CTE) 回款异常(is_abnormal) PO滞留(>7天) 管道断更(pipe_stale_rows)
- 页面量级：全部实页无桩（listings 1137行 最大；feishu 78 最小）

### 0.2 模块门控矩阵（tenant_modules 实测）
- 模块键 9 个：ads/ai/collab/finance/inventory/listing/logistics/orders/sourcing
- t1(zipforce)：listing=**false**（09-26 10:28 UTC 用户关闭，待确认）其余 true
- t2(onno)/t3(fittinggoals)：全 true
- 模块挂载疑点：/promotion 挂 **ads** 模块（推广数据与广告模块打包）；/po 挂 inventory；/settlement+/noon 挂 finance；/rankings+/products+/mapping+/pipeline+/dictionary 基座永久

### 0.3 数据层全景
- public 129 表 / audit 清洗 99 表（audit_clean_all 全镜像策略）
- RLS：业务表全覆盖；**69 表无 RLS**=21 张 cleaned_* 死镜像（0 端点引用，验证过）+ 全局参考表(fx_rates/platforms/marketplaces/tenants/metric_calibers/audit_*/pipe_domains/term_field_map/api_fields_catalog/product_categories/promotion_crawl_stats)
- metric_calibers 注册表现 6 行（ad_spend×2 / cost / orders×2 / fx_pegged）
- 租户：t1=zipforce t2=onno t3=fittinggoals(fittingirls)；DB 服务名 db，用户 saas_admin 库 saas_registry

---

## 1. FS-1 · settlement + orders（资金路径）

### 1.1 /settlement 链路
web/settlement/page.tsx(128行) → GET /api/settlement (finance.py:171, mod=finance) → audit.cleaned_amazon_orders ← sync_mercury.py _ORDERS_UNION 三分支（v_order_master / v_fittingirls_order_finance_detail / v_onno_orders_unified）。

**表面清单**：KPI×4（待回款/回款异常>14天/已回款率/等待天数）；筛选 tab×4（pending/abnormal/settled/all）；搜索（订单号/SKU）；表 9 列（订单号/品牌/国家/发货日期/营收本币+USD/净额USD/回款状态/等待天数/SKU）；CSV 导出；分页 20。

### 🔴 P1-1 days_waiting/is_abnormal 三品牌三种口径，同一列同一阈值同一 KPI
sync_mercury.py 三分支（264-320行）实测：
| 品牌 | days_waiting 起点 | 条件 | is_abnormal 是否看回款 |
|---|---|---|---|
| zipforce | **now()-last_update_date**（数据更新时间！） | Shipped AND NOT has_finance | 看（NOT has_finance）|
| fittingirls | now()-coalesce(shipped_date,order_date) | Shipped AND settlement<>'已回款' | 看 |
| onno | **now()-purchase_date** | 仅 Shipped | **不看 has_finance！** |
DB 实证（cleaned_amazon_orders 全表）：
- onno 异常 526 单中 **281 单 has_finance=true**（口径上已回款）→ 回款异常 KPI 虚高 2.15×（526 vs 真待回款异常 245）；顶栏铃铛 settle_abnormal 同源同虚高（notify.py:26 直接 count(is_abnormal)）
- onno 430 行 settlement_status='待回款' 与 has_finance=true 同行矛盾 → 异常/已回款筛选器与徽标互斥展示
- zf 发货日期列实为 last_update_date（shipped_date 槽位灌的是最后更新时间）；fg 真发货日；onno NULL（前端 purchase_date 兜底）→ 同列三种含义
- 「>14天」阈值对 zf=数据滞留 14 天，对 fg=发货后 14 天，对 onno=下单后 14 天
**建议**：三分支统一为 fg 语义（now()-coalesce(shipped_date,purchase_date) + NOT 已回款），onno shipped_date 缺失用 purchase_date；改后 onno 异常≈245，跨品牌可比。

### P2-1 settlement 前端注记「历史快照，等待天数自导出日固化」表述失实
days_waiting 含 now() 于每次 sync 重算——非固化，是「随每日 sync 增长」；真正的问题是 zf 分支起点错（P1-1）。注记误导用户对数字的理解。

### 1.2 /orders 链路
web/orders/page.tsx(146行) → GET /api/orders (ops.py:83, mod=orders) → 同表同三分支。KPI×5；状态 tab×5（含 Unshipped，实测 zf18/fg2 真实存在）；时间窗×4；搜索；表 10 列；CSV；CustomModules(page="orders") 嵌入。

### P3-1 取消单排除口径：注册表排两种页面排一种
registry#4 exclude ["Canceled","Cancelled"]；ops.py:102/134 仅 `<> 'Canceled'`。当前数据无双 L 变体（实测 3 品牌状态分布），无实际差额——潜伏分歧，amazon 部分区用 Cancelled 拼写，出现即静默双口径。

### P3-2 /api/orders 近 N 天窗口 UTC 日切
ops.py:95 `purchase_date >= current_date - days`，DB 会话 TZ=UTC（实测），而 purchase_date 入库已是北京翻日（sync 264行 AT TIME ZONE 'Asia/Shanghai'）→ 窗口老边随当日时刻漂移最多 1 天。与 2026-09-24「订单链北京翻日」拍板不一致（dashboard.py 同款已修，此处漏网）。建议 `(now() AT TIME ZONE 'Asia/Shanghai')::date - %s`。

### P3-3 onno status_cn 全空（732/732 实测）
onno 分支硬编码 ''（sync 300行）→ 状态徽标显示英文 Shipped/Canceled，zf/fg 显示中文。同一列两种语言。

### P3-4 /orders 有效口径 KPI 在 Canceled tab 下显示误导性 0
filter=已取消时 valid=0 → 营收/件数/客单价 KPI 显示 $0.00/0（aov=rev/valid if valid else 0.0）而非「无数据」。违反无数据铁律的边缘场景。

### P3-5 21 张无 RLS cleaned_* 死镜像
cleaned_purchase_orders/cleaned_inv_*/cleaned_promotion_*/cleaned_sourcing_*/cleaned_pm_*/cleaned_upload_files/cleaned_mcp_keys/cleaned_listing_events 等 21 表无 RLS 且 0 端点引用（grep 实证）。当前无暴露面；但任何未来代码直接查它们=裸跨租户。建议：clean 引擎跳过无消费者表 或 统一补 RLS。

### 1.3 横向核对通过的点（无发现）
- settlement/orders 四维隔离：tenant=RLS(tenant_conn SET app.tenant_id) + brand=显式参数+brand_scope ✓；country/platform 本页不适用
- 模块门控：settlement=finance / orders=orders 与导航声明一致 ✓
- page_size 钳制 1..100 / page>=1 ✓；排序口径与文案一致（等待天数倒序/下单时间倒序）✓
- 空态：无匹配记录/无匹配订单 显式空态 ✓；settled_rate null → "—" ✓
- 本币+USD 双列（fx 锚定汇率口径 registry#6）✓
- notify 铃铛与页面同源同口径（_ALERT_CTE/is_abnormal 共用）✓（口径本身的错见 P1-1）

---

## 2. FS-2 · inventory + po + logistics（完成）

### 2.1 /inventory（FBA tab + DocsTab 单据台账 + NoonTab FBN 预警）
链路：page(259行)+DocsTab(573)+NoonTab(120) → /api/inventory/health · /alert（inventory_po.py, mod=inventory）→ audit.cleaned_inventory_health ← mercury v_inventory_health 每日快照。DocsTab → /api/inv/*（inv.py 13 端点, 单据→过账→移动加权库存→流水全闭环+PO收货自动GRN）。NoonTab → /api/noon-inventory（brandboard.py）。

### 🔴 P2-2 库存国家 chips 计数口径与文案相反：显示=上架行数，文案=有库存 SKU 数
API（inventory_po.py:63-84）by_country.count=该 marketplace 全部在管行（含 0 库存，2026-09-22 用户口径「上架即统计」），`stocked` 字段（真有库存数）返回但**前端从未使用**；而页面说明文字「数字 = 该国 FBA 仓库当前有库存（货件数>0）的 SKU 个数」。实测（两口径并列标注）：**t1 租户视角（探针 09-26）US 上架 21 vs 有库存 4（虚高 5.25×）**；saas_admin 全品牌口径 US 上架 1011 vs 有库存 158（虚高 6.4×）、DE 610/211、全表 8958 行中 6425 行零库存（8958 中 8809 属 fittingirls/t3）。每个租户都实际可见。两修一：chips 显示 stocked，或改文案为「在管（上架）SKU 数」。

### P3-6 补货预警 summary/状态 KPI 不吃国家筛选
- /api/inventory/alert summary 只按 brand 聚合（inventory_po.py:163-165 无 country）→ 国家 chip 选中后「紧急/观察/缺口合计」仍是全量口径，与表内行不一致
- by_status KPI 卡（第 85-93 行注释明示）也无国家条件——KPI 卡与明细在选国家后数字对不上，页面无标注

### P3-7 PO 在途关联不分国家（当前 0 影响潜伏）
_ALERT_CTE po_inbound 按 (brand,sku) 关联 purchase_order_items（inventory_po.py:141-147），无 marketplace 条件 → 同一 SKU 多国在管时各国行重复计入同一 PO 量。实测当前在途 PO 项=0，无实际影响。

### P3-8 → **P2-8** 导出 CSV 5000 行静默截断——实际受害者=t3（fittinggoals）
首载 page_size=10000（API 钳 10000 ✓ 真全量）；导出循环 50 页×100=5000 行上限，超 5000 静默截断。**租户 RLS 视角实测（09-26）**：t1=139 行 / t2=10 行 / **t3=8809 行（fittingirls 品牌，2500 有库存）**→ t3 全量导出只出 5000 行、**静默丢 3809 行（43%）**，无任何提示。（早稿「zipforce 少 3958 行」系误用 saas_admin 全表口径，已更正——全表 8958 不等于单租户可见行。）

### 2.2 /po 采购（413行, mod=inventory）
表面：状态 tab×7（计数）+新建 PO 抽屉+从补货预警导入+供应商 CRUD+状态流转机+收货录入+PDF 盖章+✉发邮件。PO_FLOW={draft→submitted→confirmed→in_transit→received, cancelled 分支}（inventory_po.py:221-223）。notify po_aging=submitted/confirmed/in_transit 且 updated_at<now()-7d 与页面「>7天未推进」一致 ✓。收货→auto_grn_for_po_receive 自动生成入库单过账 ✓（进销存联动）。确认时自动生成盖章 PDF+邮件 ✓。
**通过**：状态机流转校验、删除仅 draft/cancelled、供应商有 PO 拒删、审计日志齐全。

### 2.3 /logistics（758行, mod=logistics）
表面：Tracking tab（状态筛选/搜索/轨迹抽屉）+Create Shipment（Dry-Run/真实下单）+Parameters（地址簿）+Pricing 报价计算器+参考附录（12 数据集 20.6万行 cross-db）。

### 🔴 P2-3 logistics_stats KPI 快照停更：与明细两源两节奏
stats 表单行 brand=zipforce as_of=**2026-09-05**（21 天前）；2026-09-21 加的手动导入只 UPSERT logistics_shipments 明细表，**不刷新 stats** → KPI 卡（总 316/运输中…）永远停在 09-05，与下方列表（上传即新）数字口径分裂。且 onno/fittinggoals 租户因 RLS 品牌隔离看不到 stats 行 → KPI 卡 null（无「公司级归母未接」说明）。

### 🔴 P2-4 Vnlin 真实下单：第二步箱单失败静默成功 + 无幂等护栏
logistics_create（logistics.py:371-）两步外部调用：①doubleClearance/create ②packageBox 箱单。②结果**不校验**（r2j None/失败仍返回 ok:True，box_resp 原样透传）→ 半成交订单在 UI 显示成功。且无幂等键/防重锁（对照 ads execute 有 advisory lock+X-Idempotency-Key）——双击=两笔真实运单。审计日志有 ✓（logistics.create order_id）。另：下单结果不回写 logistics_shipments（需等货代报表上传才可见）P3。

### P3-9 燕文报价 JSON 静态 20 天无「截至」标注
api/data/yamwen_pricing.json mtime=09-06，106 渠道报价单无数据截至时间标注；附录 cross-db 白名单字符校验 ✓（2026-09-17 P0 已修）。

### 2.4 横向通过项
- logistics_shipments/stats RLS=品牌键隔离（tenant_brands 驱动+brand_scope）✓ 非 tenant_id 但等效
- shipments 导入：列名中英别名映射+awb 必列+(brand,awb) UPSERT 幂等 ✓
- inv 单据闭环：6 类单据/移动加权/红冲反向/盘点 → 库存余额-流水双写 ✓ 全程审计
- 补货算法 need=⌈日均×35/90⌉ 缺口=max(0,90线-可售) 与文案一致 ✓；下PO 预填联动 /po?prefill= ✓

## 3. FS-3 · mapping + collab + promotion + rankings

### 3.1 /mapping 链路（基座）
web/mapping/page.tsx → GET /api/mapping + POST /api/mapping/edit（ops.py mapping_edit_save）→ sku_mapping → 级联写 products + inv_products（ON CONFLICT DO NOTHING）。表面：SKU 映射表（搜索/品牌筛选/行内编辑成本售价状态）+ 批量粘贴保存。

**通过**：保存尾部 `audit(t, uid, "mapping.edit.save", ...)` ✓（早前「无审计」嫌疑撤销）；级联三表品牌作用域一致 ✓；_PROFIT_EXPR 系数 0.1471=1/6.7963 与 registry#6 fx_pegged 逐位一致 ✓。
- **P3-12 批量粘贴 rows[:2000] 截断无提示**：超 2000 行静默丢尾。实测各品牌映射行 fittingirls 973 / zipforce 261 / onno 40——均远低于上限，**未触发**，纯潜伏。
- **P3-13 products.cost 副本无对账断言**：保存时级联镜像 sku_mapping.cost，今日抽查 0 不一致（同步正常）；但两表间无任何门断言，未来漂移无报警。
- **P3-14 docstring-代码漂移**：ops.py 模块注释称成本缺失「兜底 0.25」，代码无此逻辑——注释误导后来者。

### 3.2 /collab 组（/projects /documents /training /feishu，mod=collab）
- 上传链（collab.py upload）：UUID 前缀落盘 + 扩展白名单（含 .svg）+ 路径穿越防御（resolve+is_relative_to）+ 原始文件 Content-Disposition: attachment（svg 不内联渲染 → 存储型 XSS 面关闭）✓ 全通过。
- **P3-15 _BLOCKED_TABLES 陈旧**：黑名单列 4 张已不存在的表，且漏 4 张真敏感表（tenant_credentials / mcp_keys / billing_events / subscriptions）。db_table_rows 仅 adminOnly + information_schema 存在性校验 + 参数化查询 → 注入与越权均不可达（「暴露敏感表」嫌疑撤销）；补全黑名单属卫生项。
- /pipeline 采集看板与 source_recon 断流追踪联动 ✓（探针：pipe_stale=1 顶栏可见）。

### 3.3 /promotion（挂 ads 模块）
- promo tasks/channel/order/kol 全部写操作有 `_audit` ✓（「promotion 无审计」嫌疑撤销）；状态机/删除约束同 §2.2 水准。
- **P3-16 POST /api/promotion/submission 唯一无 _audit**：投稿 INSERT 行内自带 submitted_by，但审计日志缺席——与同组其余 5 个写端点不一致。
- 模块语义备忘：推广与广告共用 ads 门（关 ads 连推广一起关，§0.2 已记）。

### 3.4 /rankings（基座）
- 三端点全走 audit.cleaned_rankings_daily + tenant_conn(RLS) + brand 过滤 ✓；快照日期卡（as_of）✓ 显式空态 ✓ 数据源脚注 ✓；2026-09-19 两修（脏市场排序置底/品牌市场过滤）在位 ✓。
- **P3-10 /api/rankings 主表 LIMIT 60 无标注**：市场选择卡显示「208 个站点行」而主表只出 BSR 前 60——实测超限市场 amazon CA 208 / AU 74 / EU 69 / US 67，卡与表数字不一致且无「前 60」说明。

横向通过项：/dictionary（term_field_map 只读）✓；/database（adminOnly）✓；documents/projects/training/feishu 均挂 collab 门 ✓。



## 4. FS-4 · listing + ai

### 4.1 /listings（web 最大页 1137 行，mod=listing；t1 已关→403，t2/t3 可达）
端点 23 个，**23/23 挂 `_mod = require_module("listing")`**（grep 计数实证）；探针实测 t1 `GET /api/listing/meta` → **403 {"module":"listing","reason":"unpurchased"}** 门控生效。模块关闭系用户 09-26 18:28（北京）计费台手动操作（billing.module.toggle），是否有意**待用户确认**（见 §6 挂账）——t1 关闭期间本轮只能静态审+门控实测，深层提交链留待重开后复验。

生命周期链（静态核对）：meta/skus-by-model → specs（单品/按型号）→ tasks（建/列/详情）→ generate（文案生成）→ PUT 编辑 → approve/revert → export → import-results 回导 → events 审计流；PT 绑定链 pt-markets/pt-search/pt-schema/bind-pt → **submit（SP-API 提交）**：submission_id 回写、失败返回 errors[:10] 不落死锁 ✓；batch 批量提交；listing/health 自检。
**通过**：状态机（generate→approve 才可 submit）、revert 可回退、events 全程留痕、SKU 作用域按品牌过滤。

### 4.2 /ai（6 端点：ask/insight/adcopy/sourcing/ads-optimize/page-chat）
- 模块门 5×require_module("ai") + 1×require_module_any("sourcing","ai")（sourcing 选品页复用，合理）✓ 6/6。
- **LLM 边界（四维隔离铁律）**：六端点全走 llm_chat（anthropic/openai 双协议）→ **纯咨询文本返回，零业务表写入** ✓ 无旁路。
- 配额：Redis `aiquota:{slug}:{date}` 按 PLAN_AI_QUOTA 日限（默认 50/日）按租户隔离 ✓；LLM 未配置 → **503 显式「未配置」**（不显示误导性 0，兼容无数据铁律）✓。
- **P3-11 MFA 端点孤儿**：auth.py mfa_enable/mfa_verify/mfa_disable 存在，前端 0 引用（grep 实证）——死代码或未接线功能，二选一处理（接线或摘除）。



## 5. FS-5 · noon + 自定义图表 + 横切实弹探针

### 5.1 /noon（mod=finance；32 轮+④A 已审，本轮只查联动）
- ④A 上传链（xlsx 单日单国整体替换）→ ads 导入管道（ADS_IMPORT_TARGETS 定向同步）→ 重算按钮 ✓（G/④A 批已四门验证）。
- noon KPI 与 /finance noon 段同源同口径（32 轮已验）✓；/api/noon/summary 不吃 search 参数（KPI 全量/表内搜索，行为一致无矛盾）✓。

### 5.2 自定义图表（CustomModules 嵌 5 页：/ /orders /inventory /finance /ads）
- reports.py 白名单引擎：5 域（daily/stock/rank/noon/noon_daily）×38 字段全字典化，用户输入只允许命中 DIMS/METS 白名单 → 无原生 SQL 注入面 ✓。
- daily 域 orders=sum(orders)（2026-09-25 拍板）与 registry#4/#5 口径一致 ✓。
- **P2-5 reports.py 8 端点无模块门**：依赖仅 current_user——ads/finance/inventory 域数据可被关闭对应模块的租户经 /api/reports/query 拉取（自定义图表跨模块泄露，**latent**：当前三租户相关模块全开，无实际受害）。探针：t1 POST daily/spend → HTTP 200 无门执行。修法：按域挂门（daily→orders/ads、stock→inventory、noon→finance、rank→基座）。

### 5.3 横切实弹探针（2026-09-26 · zipforce 租户登录 · 全程只读）
| # | 检查 | 实测 | 判定 |
|---|---|---|---|
| 1 | settlement abnormal | total=848=KPI异常848，待回款 1099 | P1-1 zf 分支 848 单用户可见 |
| 2 | notify 铃铛 | settle_abnormal=848 与页面同源；inv_urgent=0 po_aging=0 pipe_stale=1 | 传导同虚高（随 P1-1 修复自愈） |
| 3 | by_country US | 上架 21 vs 有库存 4 | P2-2 每租户可见 |
| 4 | 库存可见行 | **t1=139 / t2=10 / t3=8809** | P2-8 截断受害者=t3（丢 3809 行） |
| 5 | orders Canceled tab | total=2025，valid=0，revenue=$0.00，aov=$0.00 | P3-4 误导性 0 实锤 |
| 6 | reports/query | HTTP 200（无模块门执行） | P2-5 latent |
| 7 | listing/meta | 403 {"module":"listing","reason":"unpurchased"} | 门控正确（用户关闭，待确认） |
| 8 | logistics stats | as_of=**2026-09-05**（21 天前），total=316 | P2-3 KPI 停更实锤 |

### 5.4 横切通过项（全站复核）
- **模块门覆盖率**：业务端点全挂 require_module*/adminOnly；9 个未认证端点全为合法公开（login/meta/health/billing webhook 等）✓。
- **四维隔离抽查**：settlement/orders/inventory/logistics/rankings/reports 全走 tenant_conn（RLS）+ brand_scope ✓；country/platform 为页内筛选参数非隔离轴（设计如此）✓。
- **无数据铁律抽查**：空态全站显式（「该市场暂无快照」「无匹配记录」…）✓；违例仅两处已立案（P3-4 Canceled $0.00、P2-3 onno/fg 租户 KPI null 无说明）。
- **billing**：webhook 手工 HMAC + compare_digest + 5 分钟重放窗 ✓；module_toggle 审计 ✓。**「黑名单笔误」（09-08 疑似）证伪**：黑名单条目 'fittingirls' 不匹配任何现有 slug（t3 真实 slug='fittinggoals'），三租户当前行为全部正确（t1/t2 内部租户被排除计费、t3 真实客户正常 checkout/降级）→ 无害残留，降为 **P3-17 清理项**。
- 21 张 NORLS 死镜像 0 端点引用（§1 P3-5）→ 无跨租户暴露面 ✓。



## 6. 汇总与修复批次表

### 6.1 覆盖声明
全站 39 路由页（26 实页）× ~243 API 端点（27 router）× 129 public 表 + 99 清洗表；按钮矩阵/图表口径/空态全清单（Explore 双代理机械盘点+本轮逐项实弹）；已审轮次（29-32、G、④A）页面只查跨页联动。**本轮零代码改动**；所有结论 API/DB/探针实证，无一处推断入册。

### 6.2 发现计数
**P0=0 · P1=1 · P2=6 · P3=16**（P2-6/P2-7、P3-8 编号弃用并入重编号）。

| 级 | 编号 | 一句话 | 受害面 |
|---|---|---|---|
| P1 | P1-1 | settlement days_waiting/is_abnormal 三品牌三口径（onno 不看回款→异常虚高 2.15×；zf 起点用 last_update_date；同列三义） | 三租户 KPI/铃铛/筛选全链 |
| P2 | P2-1 | 「历史快照固化」注记失实（随 P1-1 修） | t1/t2/t3 |
| P2 | P2-2 | 库存国家 chips 计数=上架行，文案=有库存（stocked 字段前端未用；US 虚高 5.25×） | 三租户 |
| P2 | P2-3 | logistics_stats KPI 停更 09-05，导入不刷新；onno/fg 租户 stats 不可见无说明 | t1 KPI 停更；t2/t3 无数据 |
| P2 | P2-4 | Vnlin 真实下单第二步箱单失败仍报成功；无幂等（双击=两笔运单） | 开通物流下单的租户 |
| P2 | P2-5 | reports.py 8 端点无模块门（跨模块数据拉取，当前无受害=latent） | 潜伏 |
| P2 | P2-8 | 库存导出 CSV 5000 行上限静默截断——**t3 实测丢 3809 行（43%）** | t3 已触发 |
| P3 | P3-1 | 取消单排除：注册表排两种拼写代码排一种（无双 L 变体，潜伏） | 潜伏 |
| P3 | P3-2 | /api/orders 近 N 天窗口 UTC 日切（北京翻日拍板漏网） | t1 边界日 ±1 天 |
| P3 | P3-3 | onno status_cn 732/732 全空（状态徽标英文） | t2 |
| P3 | P3-4 | Canceled tab KPI 显示 $0.00/0 而非「无数据」（实测 total=2025 valid=0） | 三租户 |
| P3 | P3-5 | 21 张 NORLS 死镜像 0 引用（未来直查=裸跨租户） | 潜伏 |
| P3 | P3-6 | 补货预警 summary/by_status 不吃国家筛选（KPI 与明细对不上） | 选国家时 |
| P3 | P3-7 | po_inbound 关联无 marketplace（在途 PO=0，零影响） | 潜伏 |
| P3 | P3-9 | 燕文报价 JSON 静态 20 天无「截至」标注 | t1 |
| P3 | P3-10 | /rankings 主表 LIMIT 60 无标注（CA 208/AU 74/EU 69/US 67 超限） | 4 市场 |
| P3 | P3-11 | MFA 端点存在前端 0 引用（孤儿） | 卫生 |
| P3 | P3-12 | mapping 批量粘贴 rows[:2000] 截断无提示（现最大 973 未触发） | 潜伏 |
| P3 | P3-13 | products.cost 副本无对账断言（今日 0 不一致） | 潜伏 |
| P3 | P3-14 | ops.py docstring「兜底 0.25」代码未实现（文档漂移） | 卫生 |
| P3 | P3-15 | _BLOCKED_TABLES 陈旧（列 4 张不存在的表、漏 4 张真敏感表；注入不可达已证） | 卫生 |
| P3 | P3-16 | POST /api/promotion/submission 全组唯一无 _audit | 卫生 |
| P3 | P3-17 | billing 黑名单死条目 'fittingirls'（09-08 疑似笔误→本轮证伪无害，三租户行为全正确） | 卫生 |

### 6.3 撤销记录（疑似→实证→撤销，纪律留痕）
RLS 装饰性（实为品牌键等效隔离）／mapping 保存无审计（尾部有 audit）／promotion 无审计（仅 submission 一处缺）／db_table_rows 注入（白名单+存在性校验不可达）／webhook 黑名单笔误致害（死条目无害）／「导出截断 zipforce 已触发」（实为 t3）。

### 6.4 修复批次表（用户拍板执行，批内含验证+双视口截图+四门）
| 批 | 内容 | 改动面 | 风险 |
|---|---|---|---|
| **A · 资金口径统一（P1）** | P1-1 三分支统一为 fg 语义：days_waiting=now()-coalesce(shipped_date, purchase_date)，is_abnormal=Shipped AND NOT 已回款（onno 补看回款；zf 起点改真发货日）；全量重跑 cleaned_amazon_orders；P2-1 注记改真实口径；notify 铃铛自愈；registry 新行 2 条+门断言 | sync_mercury.py + finance.py 注记 + clean 重跑 | 中（重算后 KPI 数字将**变小**——onno 异常 526→~245、zf 848→真发货口径；需预告用户数字变化是修正非掉数） |
| **B · 数据丢失/外部护栏（P2）** | P2-8 导出循环改动态翻页至 total（或单次 page_size=10000）；P2-3 导入后刷新 stats（或 KPI 改实时聚合+as_of 标注）；P2-4 Vnlin packageBox 结果校验失败即报错+幂等键（对齐 ads execute 的 advisory lock 模式） | web inventory export + logistics.py | 低 |
| **C · 口径文案/门控（P2）** | P2-2 **二选一：①chips 改显 stocked ②文案改「在管（上架）SKU 数」**（默认①，因文案现状承诺的就是有库存）；P2-5 reports.py 按域挂 require_module_any | inventory_po.py 前端 + reports.py | 低 |
| **D · P3 清仓（16 项打包）** | P3-1/2/3/4/5/6/7/9/10/11/12/13/14/15/16/17 按上表逐项（多为加标注/补审计/对齐拼写/补断言） | 分散 8 文件 | 低 |

### 6.5 注册表与门断言提案（A/C 批随行）
- **metric_calibers 新行**：`settle_days_waiting`（authoritative=coalesce(shipped_date,purchase_date)，全品牌）／`settle_abnormal`（Shipped AND NOT 已回款，全品牌统一）；`inventory_by_country`（count=上架口径【2026-09-22 拍板】+ stocked 并列返回）；`logistics_stats_policy`（as_of 必须随导入刷新或改实时）。
- **dashboard_audit 检查8 新断言**：notify.settle_abnormal == settlement.abnormal_count（同源不变式）；onno 异常数按新口径复核；by_country chips 与 stocked 展示一致；rankings 页 LIMIT 60 标注存在。

### 6.6 挂账（用户侧待决）
1. **listing 模块关闭是否有意**（09-26 18:28 北京 user_id=1 计费台手动 off）——误触则计费台重开，我不动模块开关。
2. 用户侧清单：onno/ES 断流 4 天·FR 5 天·IT 14 天（venus 源头）；onno 广告 zip 停 08-31（现走应用内上传）；mercury pm 备份停止；X2 采购价 ¥40→¥95 建议。

---
*审计工具：/opt/six-claude/workspace/zipforce-hub/tools/_probe_fs_audit.py（只读探针，可复跑）；报告：/opt/saas/workspace/zipforce-hub/audit-fullstack-2026-09-26.md*

