# mercury/venus 源头数据需求单（2026-09-23）

> 提出方：ZIPFORCE Hub SaaS（mars 生产）
> 依据铁律：账户/品牌/国家/平台四维数据绝对隔离；源头数据问题出需求单移交
> 状态：待 mercury/venus 侧处理

## 需求 1：fittingirls order_items 采集器 sku 字段失效（P0，已由 SaaS 层临时兜底）

**现象**：venus 侧 fittingirls sales 采集器约 2026-09-17 起，写入
`fittingirls_amazon.fittingirls_amazon_spapi_order_items` 的新行 `sku` 字段全部为空，
实际值落在 `seller_sku` 列（近 2 天 91 行：sku 空 91、seller_sku 有值 91）。

**影响**：SaaS 同步 SQL 以 `i.sku <> ''` 过滤 → fittingirls 的 sales_daily 断供
（mars 侧停在 09-17）。SaaS 已用 `coalesce(nullif(i.sku,''), i.seller_sku)` 兜底恢复，
但以下风险仍在：
- 其他依赖 items.sku 的 mercury 端任务（如果有）同样断供
- 字段映射漂移的根因未明（采集器何时/为何改的），后续别的列可能同样漂移

**请处理**：
1. 检查 venus fg sales 采集器 ~09-17 前后的变更，恢复 sku 字段写入（或确认 seller_sku 为标准字段后统一口径）
2. 排查同采集器其他表的字段映射是否同样漂移（orders 表正常，items 表已实锤）

## 需求 2：zipforce 采集账号表混品牌（P1，SaaS 层已隔离、源头语义待明确）

**现象**：`zipforce_amazon.zipforce_amazon_spapi_orders` 是同一 EU 统一卖家账号的采集表，
内含 `brand='zipforce'`（621 行/60天）与 `brand='onno'`（342 行/60天）两类订单；
`v_onno_orders_unified` 视图则**没有 brand 列**。

**影响**：任何不做 brand 过滤的下游聚合会把 onno 订单计入 zipforce（已发生：
sales_hourly 混品牌，SaaS 已修）。每个新下游都可能再踩一次。

**请处理**：
1. 明确 brand 列的打标机制（按 SKU→品牌映射？谁维护？）并文档化
2. 考虑按品牌拆表或提供按品牌过滤的标准视图（有 brand 列），替代"下游各自记得过滤"的现状
3. v_order_master 视图混品牌同理（SaaS 现靠 NOT EXISTS 拆分，脆弱）

## 需求 3：noon_statement 同步 SQL 类型错误（P2）

**现象**：mercury 端执行 `left(stmt_month, ...)` 报
`function left(date, integer) does not exist`（stmt_month 列类型为 date），
导致 SaaS `ingest_all` 的 noon_statement 域持续失败（今日全量实锤）。

**请处理**：源头 SQL/视图把 stmt_month 转为 text（`to_char`）或提供正确类型；
或授权 SaaS 侧改同步 SQL（当前该分支在 mercury 端执行）。

## 需求 4：onno Amazon 广告采集断更 23 天（P1，监控 agent 首跑发现）

**现象**：`onno_amazon.onno_amazon_ads_daily` 最新 `day` 停在 **2026-08-31**（mercury 端源头即断，
非 SaaS 同步问题）。onno 品牌在 Amazon 端的广告花费/销售数据缺整个 9 月。

**请处理**：检查 venus 侧 onno amazon 广告采集任务 ~08-31 后的中断原因（凭据过期/任务停止/接口报错），
恢复后 SaaS 侧下次全量同步自动补齐。

## 验收口径（SaaS 侧将自动核查）

- 需求 1：`fittingirls_amazon_..._order_items` 近 1 日新增行 `sku` 非空率 100%
- 需求 2：任一按品牌聚合的下游查询在无 brand 过滤时，结果与过滤后一致（即表单品牌化）
- 需求 3：SaaS `ingest_all` 返回值中 `noon_statement` 不再为 error
- 需求 4：`onno_amazon_ads_daily` 最新 day 追平昨日（SaaS 监控 agent 每日水位检查自动覆盖）

---
SaaS 侧联系：本机 mars /opt/six-claude/workspace/saas（sync_mercury.py 为同步契约单点）
