# 数据库侧需求单（SaaS → 采集/数据库）— 2026-09-18

**移交对象**：mercury（104.194.81.222）/ venus（104.194.95.213）侧维护人
**提出方**：SaaS（mars）——本文档只定义需求与验收，不含修复动作；SaaS 侧已做的呈现兜底见文末。
**背景**：2026-09-18 SaaS 上线数据库清洗层（audit.cleaned_*），清洗时发现两个源头数据缺口，需数据库侧补数/核查。清洗层已做兜底标记，不影响线上展示。

---

## R1（主修）：补全汇率表 fx_rates（缺 EUR/GBP/SEK/JPY/PLN）

**现象**：
- SaaS 侧 `fx_rates` 只有 3 个币种（AED/RMB/SAR），但 Amazon 订单涉及多币种
- 早期订单（2025-08 起）的 `revenue_usd` 大量为 NULL——ingest222 灌入时 `fx()` 缺这些币种的汇率，折算没做成
- 清洗层只能补 USD=1 / SAR=3.75 / AED=3.6725（fx_rates 里有的 peg 汇率），其余币种无法折算

**当前缺 USD 折算的订单**（amazon_orders，有效订单，revenue_usd IS NULL）：

| 币种 | 单数 | 本地币金额 | fx_rates 有无 |
|---|---|---|---|
| EUR | 1,975 | 33,106.16 | 缺 |
| GBP | 1,313 | 18,613.74 | 缺 |
| SEK | 781 | 198,500.81 | 缺 |
| JPY | 96 | 202,006.00 | 缺 |
| PLN | 6 | 429.94 | 缺 |
| （币种空） | 331 | — | 币种缺失 |

**需求**：
1. `fx_rates` 补全以下币种的 USD 汇率：EUR / GBP / SEK / JPY / PLN（以及任何 amazon_orders.currency 出现过的币种）
2. 汇率来源：mercury 侧 `fx()` 函数用的同一套权威汇率（保持口径一致）
3. 一次性回补：对 `revenue_usd IS NULL` 且币种有汇率的订单，回填 `revenue_usd = local_amount / fx(currency)`（约 5,100 单）

**验收**：
- `SELECT count(*) FROM amazon_orders WHERE revenue_usd IS NULL AND order_status NOT IN ('Canceled','Cancelled') AND currency IN ('EUR','GBP','SEK','JPY','PLN')` → 0
- `fx_rates` 覆盖 amazon_orders 出现过的所有币种

## R2（次修）：核查孤儿费用（order_fees 有费用但无对应订单）

**现象**：
- `order_fees` 有 1,936 条费用记录，但 `amazon_orders` 里没有对应的 `(brand, amazon_order_id)` 订单
- 孤儿费用合计 **39,498 USD**，会导致费用虚高（算了没订单的费用）

**孤儿费用分布**：

| 品牌 | 孤儿条数 | 费用 USD |
|---|---|---|
| zipforce | 932 | 28,703.47 |
| fittingirls | 989 | 10,764.99 |
| onno | 15 | 29.87 |

**样本**（order_fees 有，amazon_orders 无）：
```
zipforce | 026-1536970-6527534 | commission=1.8  fba=3.53
zipforce | 026-3120219-2336339 | commission=2.14 fba=2.52
```

**可能根因**（需数据库侧核查）：
- 订单被删/取消后费用残留
- order_fees 灌入范围比 amazon_orders 大（费用表灌了订单表没灌的）
- 两表灌入时机不一致（费用先灌，订单后灌或漏灌）

**需求**：
1. 核查孤儿费用的来源（是订单漏灌，还是费用多灌）
2. 若是订单漏灌：补灌对应订单到 amazon_orders
3. 若是费用多灌：清理孤儿费用，或在 order_fees 灌入时校验订单存在

**验收**：
- `SELECT count(*) FROM order_fees f WHERE NOT EXISTS (SELECT 1 FROM amazon_orders o WHERE o.brand=f.brand AND o.amazon_order_id=f.amazon_order_id)` → 0（或孤儿有合理解释并标记）

## SaaS 侧已做的兜底（无需数据库配合）

- **清洗层兜底**：缺 USD 的订单用确定汇率（USD/SAR/AED）折算补值，标 `rev_estimated`；缺汇率的标 `no_fx:{币种}` 进 `audit.dirty_data_log`，页面不显示误导性 0
- **孤儿费用标记**：清洗时标 `orphan`，进脏数据清单；接口读清洗表时孤儿费用仍计入（保持与源表一致），但已在脏数据清单标记
- **清洗挂 ingest 自动跑**：源头修复后，ingest222 完成后自动清洗，SaaS 侧无需发版

## R3（新增）：核查 zipforce SE/JP 市场费用异常高

**现象**：
- zipforce SE 市场：852 单，营收 20,954 USD，佣金 30,148 + 尾程 53,526 = 费用 83,675 USD（费用是营收的 4 倍）
- zipforce JP 市场：96 单，营收 1,296 USD，佣金 13,385 + 尾程 16,137 = 费用 29,522 USD（费用是营收的 23 倍）
- 其他市场费用率正常（0.28-0.91），SE/JP 异常（3.99/22.78）

**单均费用对比**：

| 市场 | 订单数 | 营收 | 费用合计 | 单均费用 | 单均营收 |
|---|---|---|---|---|---|
| SE | 852 | 20,954 | 83,675 | 98.21 | 24.59 |
| JP | 96 | 1,296 | 29,522 | 307.52 | 13.50 |
| US | 1,301 | 17,339 | 6,781 | 5.21 | 13.33 |
| GB | 1,513 | 26,340 | 7,326 | 4.84 | 17.41 |

**mercury 侧实证**：SE/JP 费用在 mercury 源库就异常高（SE 佣金 30,270/尾程 54,249；JP 佣金 13,385/尾程 16,137），非 SaaS 侧问题。

**可能根因**（需数据库侧核查）：
- 费用归属错误（别的市场费用算到 SE/JP）
- SE/JP 费用数据被放大（采集/灌入错误）
- SE/JP 市场真的亏损（费用高，需业务确认）

**需求**：核查 SE/JP 市场费用数据来源，确认是归属错误还是真实亏损。

**验收**：SE/JP 市场费用率回归正常范围（<1.5），或确认真实亏损并标记。

## 附：数据查询入口

- 脏数据明细：`audit.dirty_data_log`（issue_type=missing_field/orphan）
- 清洗副本：`audit.cleaned_amazon_orders` / `audit.cleaned_order_fees`
- 清洗报告：https://changelog.zipforcehub.com/audit-clean-2026-09-18.html
