1

docs/prd/specs/P8-miniapp-fe-boards.md

@@ -66,16 +66,18 @@
 
 ### 财务看板数据字段映射（已校准，数据源：DWD-DOC 03-财务全景）
 
-收入结构（settle_type=1，台桌结账）：
+收入结构（settle_type IN (1, 3)，台桌结账 + 商城订单）：
 
 | 收入来源 | DWS 字段 | 占比 | 说明 |
 |----------|----------|-----:|------|
 | 台费 | `table_charge_money` | 56.6% | 按秒计时，台区单价固定 |
 | 助教陪打 | `assistant_pd_money` | 30.6% | 按秒计时，单价按等级 |
 | 商品 | `goods_money` | 10.1% | 酒水食品 |
-| 助教超休 | `assistant_cx_money` | 0.9% | 按课时，190 元/课时 |
+| 助教超休 | `assistant_cx_money` | 0.9%（仅 type=1） | 按课时，190 元/课时；settle_type=3 含 477 笔纯超休订单（cx=245,480），占全口径超休 85%+ |
 | 灯控电费 | `electricity_money` | 0% | 门店未启用，全为 0 |
 
+> ⚠️ settle_type=3（商城订单）中包含大量纯超休/激励课订单，财务看板取数必须 `settle_type IN (1, 3)`，否则严重低估超休收入。
+
 > ⚠️ 消费金额口径：使用 `items_sum`（= tc + goods + pd + cx + electricity），不得使用 `consume_money`（三种历史口径混合）。
 
 充值收入（settle_type=5）：从 `dws_finance_recharge_summary` 读取，充值退款（settle_type=7）需扣除。