# 工作台 / 今日 / 财务 三页面最细颗粒度审计报告

**日期**: 2026-09-26 · **轮次**: 第三十二轮 · **审计人**: Claude (GLM)
**范围**: web/app/page.tsx(工作台681行) + web/app/today/page.tsx(今日440行) + web/app/finance/page.tsx(财务1407行)
+ 后端 api/routers/dashboard.py(1716行) + api/routers/finance.py(1450行)，全量逐行通读
**方法**: 四层追查(rawdata→cleandata→api→web) + 代码定位 + **真实DB/登录取数实证**（不许猜·数据存在性先查再说）
**实证手段**: DB 直查 7 组 SQL + 双租户(zipforce/onno)登录 API 探针 8 次

---

## 一、结论总览

| 级别 | 数量 | 一句话 |
|---|---|---|
| P0 资损级 | **0** | 无。核心营收/订单数字跨页完全一致 |
| P1 口径错误(数字错·用户可见) | **6** | onno 广告双计/口径分裂 ×3、财务时间选择器两处失效、成本源分裂(两牌成本=0) |
| P2 功能缺陷(部分失真) | **4** | sku-sales 重复行、今日 Noon 订单=件数、今日"全平台"仅 Amazon、Noon 净利虚高无脚注 |
| P3 小口径/潜伏风险 | **10** | 年度广告硬编码、FX 前后端重复定义、LIMIT 1 不确定取行等 |
| 已排除嫌疑(验证无误) | **8** | 详见第五节 |

---

## 二、P1 发现（口径错误·数字错·用户可见）

### P1-1 工作台趋势图 onno 广告双计 3.18 倍
- **位置**: api/routers/dashboard.py:191-196（trend 日线 union）
- **代码**: 趋势图 union 是 `sku_daily(无 onno 排除) UNION ALL amz_daily`，而 KPI 卡的 union（150-154 行）有 `AND brand<>'onno'` 防护。
- **数据**: onno 在 `cleaned_ads_sku_daily` 有全历史 1496 行（2026-07-31~09-25，近30天 spend 1510），`cleaned_amazon_ads_daily` 另有 onno 近30天 693 —— 两表都装着 onno 的**不同**广告数据。
- **API 实测**（onno 租户，2026-08-27~09-25 同窗口）:
  - KPI 卡 ad_spend = **693.38**（有防护 ✓）
  - 趋势图 ad_spend 逐日求和 = **2203.15**（无防护 = 1510+693）
  - **同一页面同一窗口，卡与图差 3.18×**
- **用户视角**: onno 品牌视图下"近30天广告"卡片显示 $693，下方趋势图广告柱线肉眼可见远超卡片总额。

### P1-2 工作台选国家后 SKU Top15 同样双计
- **位置**: dashboard.py:216-223（top15 union），同样缺 `brand<>'onno'`。
- **影响**: onno 租户选国家后，SKU Top15 表中 onno SKU 广告花费=两表相加，翻倍虚高；且 advertised_sku 与 sku 双来源可能同名 SKU 出双行。

### P1-3 财务页 Amazon 广告全线口径与工作台矛盾（onno 差 1.38×）
- **位置**: finance.py 四处 ads CTE 全部只读 `cleaned_ads_sku_daily`，不带 union：
  kpi-wall(285,344) · full(556) · product-pl(766) · profit-matrix(1017)
- **拍板口径**（工作台已执行）: `sku_daily(brand<>'onno') UNION ALL amz_daily`——onno 以 amz_daily 为准。
- **API 实测**（onno 租户，2026-08 同月同牌）:
  - 工作台 onno 2026-08 ad_spend = **2986.21**（amz_daily 口径）
  - 财务 full onno 2026-08 ad = **4130.04**（sku_daily 口径）
  - **同月同牌跨页差 1.38×**，ACOS/TACOS/毛利(毛利=结算净额−广告)全部随之失真
- **波及**: 财务页 KPI 墙、品牌×月度矩阵、产品损益、盈利矩阵四个 tab 的 onno 行。

### P1-4 财务主接口 month 参数完全无效（时间选择器形同虚设）
- **位置**: finance.py finance_full 签名收 `month` 但 SQL 只用 `year`（577-581 六组参数均为 year）。
- **API 实测**: `/api/finance/full` vs `?month=2026-08` → 返回 **31 行全部月份矩阵，逐字节相同**。
- **用户视角**: 财务页选"本月/上月/近3月/近12月"→ 品牌×月度矩阵/趋势图/费用结构/年度对比仍显示**全部历史月份**；仅 kpi-wall(CumTables) 正确响应 month。ProfitHero 环比窗口随之错位。

### P1-5 财务 KPI 墙 Noon 三行不受时间过滤（全历史数）
- **位置**: finance.py:391-405 kpi-wall Noon 段 SQL 只有 brand 过滤，**无 mon/year/month 条件**。
- **API 实测**: `?month=2026-08` vs `?month=2026-01` → Noon 行**完全相同**（AE orders=12961、units=18900、net_proceeds=970550 AED——全历史累计）。
- **用户视角**: 无论选哪个月份，Noon KPI 墙恒显示全历史数；与旁边正确过滤的 Amazon 行并列，极易误读。

### P1-6 成本源分裂：full/product-pl 的 fg+onno Amazon 采购成本=0 → 净利虚高
- **位置**: finance/full(577) 与 product-pl(780) 的 cost CTE 都是 `sku_mapping取product_name → JOIN cleaned_noon_procurement_cost 取 cost_rmb`。
- **数据**: `cleaned_noon_procurement_cost` **只有 zipforce 28 行**；而 `sku_mapping(platform='Amazon')` 有 cost_rmb 的行：fg **839**/973、onno 26/26、zf 155/155。
- **对照**: kpi-wall Amazon 成本(348-356)用的是 `sku_mapping.cost_rmb`（三牌全覆盖）——**同一页两套成本源**。
- **后果**: 财务页"品牌×月度矩阵/盈利总览/产品损益"的 fg、onno 行采购成本恒为 0 → **净利润=毛利，虚高**；kpi-wall 卡片却有成本——页内自相矛盾。
- **连带**: kpi-wall Noon 成本(400)同 JOIN procurement_cost → **onno Noon 成本=0**，onno Noon 净利=毛利（zf Noon 28 行有成本正常）。

---

## 三、P2 发现（功能缺陷·部分失真）

### P2-1 sku-sales（工作台 SKU 销量卡）重复行：同一 SKU 出 3 行
- **位置**: dashboard.py:1688-1713 `sales_daily JOIN sku_mapping ON brand+sku`，无 country/platform 限定、不去重不聚合。
- **数据**: sku_mapping 存在 **55 对** (brand,sku) 重复——多为**合法**的跨国行（如 ZF230T0MEB: Noon SA + Noon AE；EU-2305-jh-3xl: Amazon FR + Amazon UK）。
- **API 实测**: ZF435T0EUB 返回 **3 行、各 35 件/各 $261.24**（DB 真实 35 件）→ 表格同 SKU 重复 3 行，列合计/分页虚胖 3×。
- **附带**: `sales_daily` 本身**无 platform/country 列**（sync_mercury._sales_sql: brand,sku,day,units,revenue,ad_spend,ad_sales）——卡头"每平台"维度名不副实；onno 230 行=其 Amazon 侧（不可区分）。

### P2-2 今日页 Noon"订单数"实为件数
- **位置**: dashboard.py /api/today noon 分支 `count(*)` 直取（件级行），而工作台 KPI deck(680-686) 用 `count(DISTINCT order_nr)`。
- **实测**: 最新数据日 noon item 行=3 vs distinct 订单=2（1.5×）；多件订单越多偏差越大。
- **跨页**: 今日页 Noon 订单数与工作台 KPI Noon 订单数口径不一致。

### P2-3 今日页"全部平台"实为仅 Amazon
- **位置**: today/page.tsx:134/233 —— `platform==='noon'` 渲染 Noon 块，`platform!=='noon'`（含全平台""）渲染 Amazon 块。
- **后果**: 默认"全部平台"视图只显示 Amazon 数据，无 Noon 也无"仅含 Amazon"标注；分品牌表也只是 Amazon 品牌。

### P2-4 Noon 净利虚高无脚注（对比工作台的 cov_note 机制）
- 工作台 KPI deck 有 `fee_cov<99.9% → "费用覆盖X%(结算滞后未到,利润偏高)"` 脚注机制（dashboard.py:647）；
  财务页 Noon 成本=0（P1-6 连带）+ KPI 墙全历史（P1-5）叠加，**无任何口径脚注**提示净利不可比。违反"无数据显式无数据不显示误导性数"精神。

---

## 四、P3 发现（小口径/潜伏风险）

| # | 位置 | 问题 | 现状影响 |
|---|---|---|---|
| P3-1 | finance.py:491 | kpi-wall 年度广告硬编码 `a.day >= '2026-01-01'`，忽略 year 参数 | 两广告表最早 2026-04-26/07-31，**当前无影响**；2027 年起选 2026 年度会混入 2027 数据 |
| P3-2 | page.tsx:264 | 前端 `NOON_FX={SA:3.75,AE:3.6725}` 与后端 core._noon_usd 重复定义 | 汇率调整须改两处，漂移风险 |
| P3-3 | finance.py:577 等 | cost LATERAL `LIMIT 1` 无 ORDER BY，跨国重复映射行取行不确定 | 同 SKU 各国 cost 通常相同，实际影响≈0 |
| P3-4 | finance.py 多处 | cost LATERAL `sku_list LIKE m.sku||'%'` 前缀匹配 | **实测 0 对前缀碰撞**（同牌无互为前缀 SKU），纯潜伏风险；另多 SKU 订单成本只按第一个 SKU 单价×总件数（近似口径） |
| P3-5 | dashboard.py:65-66 | filters `max_day` 只查 Amazon 订单表 | 纯 Noon 品牌拿不到 max_day，今日页回退浏览器本地日期 |
| P3-6 | dashboard.py:1345 | 今日 by_sku 件数均摊用 `(_ic or 1)`，与全站 `coalesce(nullif(items_count,0),sku_list长度,1)` 回退链不一致 | items_count=0 的多 SKU 单偏差小 |
| P3-7 | page.tsx 工作台 | winDays 预设 wFrom 用 `toISOString()`（UTC）算，后端 _period_win 用 bj_today() | 北京 0-8 点显示窗口标签差一天（仅标签，数据仍以后端为准） |
| P3-8 | finance/page.tsx:528 | ProfitHero 无条件渲染 Amazon 口径（platform=noon 时顶部"盈利总览"仍是 Amazon 数据） | 有平台选择器在旁，误读风险中等 |
| P3-9 | finance.py full Noon 段 | Noon 广告月表 pl_monthly vs 日表 ads_daily 近2月差 43/30676≈**0.14%**（月切边界） | 数额可忽略；口径上月表已退役(F2-6)财务侧未同步说明 |
| P3-10 | page.tsx | MergedOverview 成死代码（"全部平台"已下架）+ merged-kpi 仍用 finance_monthly(已知漏 onno) | 不可达路径，纯技术债 |

---

## 五、已排除嫌疑（实证无误）

1. **_NOON_CCY 未定义 NameError** → 排除：finance.py:1212 有定义（onno 段内）。
2. **fmt.int(null) 显示误导 0** → 排除：`v == null ? "—"`，undefined 也命中，全站空值→"—"。
3. **sales_hourly 时区** → 排除：sync_mercury `AT TIME ZONE 'Asia/Shanghai'` 翻日+取时，确为北京小时，今日页标注正确。
4. **sku_mapping 前缀碰撞致成本误配** → 排除：实测 0 对。
5. **跨页核心一致性** → **通过**：dashboard/kpi 与 finance/full 同月同牌完全一致（2026-08 zipforce: orders=294, revenue=$4214.24，逐位相同）。
6. **四维隔离（租户/品牌）** → **通过**：zipforce 登录态下 onno 品牌数据被 RLS+brand_scope 完全挡住（ad_spend=0 佐证）；换 onno 租户才可见。
7. **Noon 广告 pl_monthly 与 ads_daily 数额分裂** → 基本排除：近2月差 0.14%（见 P3-9）。
8. **年度广告硬编码当下影响** → 排除：无 2026 前数据（降级为 P3-1 潜伏）。

---

## 六、三页逐页小结

### 工作台（page.tsx + dashboard.py）
- **数据流**: filters→kpi(_amz_kpi/_noon_kpi)→charts→kpi-deck→merged-kpi(死)→sku-sales，四层清晰；订单级单遍聚合+Pending 脚注/cov_note/4849 修复/半月对全月噪音注记等此前拍板口径均已落实。
- **主要问题**: P1-1/2（onno 双计两处）、P2-1（sku-sales 重复行+假平台维度）、P3-2/5/7。
- **功能逻辑**: 平台 tab 仅 Amazon/Noon（全部平台已下架✓）；winDays/自定义窗口、品牌×国家联动、SKU 卡 CSV 导出（page_size=200 循环）均正常；无数据路径覆盖 6 处。

### 今日（today/page.tsx + /api/today）
- **数据流**: 每2小时增量 SP-API 采集→只读展示，60s 自动刷新+手动刷新，数据血缘脚注完整（含时区声明，与实现相符）。
- **主要问题**: P2-2（Noon 订单=件数）、P2-3（全平台=仅Amazon）、P3-6。
- **功能逻辑**: 国家选择器在"全平台"下禁用（先选平台）✓防跨平台误混；hour×country 堆叠图/合计行列/昨日虚线/SKU TOP20 均摊/分品牌含 Pending 提示——逻辑正确；delta() prev=0→"—" ✓；空值→"—" ✓。

### 财务（finance/page.tsx + finance.py）
- **数据流**: summary/sku-product/settlement/noon-summary/kpi-wall/full/product-pl/noon-sku/monthly/profit-matrix/onno/noon-pnl 12 端点；源表直读(2026-09-18 拍板)落实，monthly 保留三方对账。
- **主要问题**: P1-3/4/5/6（全线最重）、P2-4、P3-1/3/4/8/9。
- **功能逻辑**: 平台选择器只影响 CumTables/Noon 块（hero 不随之切换 P3-8）；矩阵热图/钻取/分维度、Noon 深表(38+5列)、月度对账、产品损益分页排序功能完整；unmapped_sku_count 警示→/mapping 引导 ✓；口径 footer 详尽但未覆盖上述 P1 缺口。

---

## 七、修复建议（**待拍板，未动任何代码**）

| 批 | 内容 | 改动面 | 风险 |
|---|---|---|---|
| A | onno 广告统一口径：dashboard 趋势图+Top15 补 `brand<>'onno'`；finance 四处 ads CTE 换 guarded union（P1-1/2/3） | dashboard.py 2处 + finance.py 4处 SQL | 低（对齐已拍板口径）；api 需 rebuild+force-recreate |
| B | full 的 month 参数生效 + kpi-wall Noon 段补 mon 过滤（P1-4/5） | finance.py 2段 SQL + 前端无需动 | 低；注意前端矩阵卡自带年份下拉的联动语义 |
| C | 成本源统一为 sku_mapping.cost_rmb（与 kpi-wall 一致）或补 procurement_cost 覆盖（P1-6） | finance.py 2处 cost CTE | 中：需先对 zf 28 行两源数额抽样对比再定方向 |
| D | sku-sales JOIN 去重聚合 + 今日 Noon 改 DISTINCT order_nr + 全平台标注/合并（P2-1/2/3） | dashboard.py 2处 + today 页文案 | 低 |
| E | P3 清单按顺手修（FX 单源化、max_day 兼 noon、LIMIT 1 加 ORDER BY 等） | 零散 | 低 |

> 审计属只读，以上均未实施。每批改后须四道回归门全绿 + 双视口截图自检存档。
