feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

docs/database/BD_Manual_fdw_etl_setup.md

@@ -34,9 +34,9 @@
 
 ### 导入的外部表
 
-通过 `IMPORT FOREIGN SCHEMA app` 批量导入，外部表与 ETL 库 `app` Schema 中的 RLS 视图一一对应（共 35 张）：
+通过 `IMPORT FOREIGN SCHEMA app` 批量导入，外部表与 ETL 库 `app` Schema 中的 RLS 视图一一对应（共 38 张，2026-03-19 新增 3 张 BOARD 看板视图）：
 - 11 张 DWD 视图：`v_dim_member`、`v_dim_assistant`、`v_dim_member_card_account`、`v_dim_table`、`v_dwd_settlement_head`、`v_dwd_table_fee_log`、`v_dwd_assistant_service_log`、`v_dwd_recharge_order`、`v_dwd_store_goods_sale`、`v_dim_staff`、`v_dim_staff_ex`
-- 24 张 DWS 视图：`v_dws_member_consumption_summary`、`v_dws_member_visit_detail` 等
+- 27 张 DWS 视图（含 4 张 cfg_* 配置表）：`v_dws_member_consumption_summary`、`v_dws_member_visit_detail` 等
 
 ### 权限配置
 
@@ -46,6 +46,23 @@
 
 ---
 
+## 1.1 RNS1.2 接口引用说明（2026-03-19 补充）
+
+RNS1.2（客户与助教接口）通过 `fdw_queries.py` **直连 ETL 库**查询以下 `app.v_*` RLS 视图（不使用 `fdw_etl.*` 外部表，原因：`postgres_fdw` 不传递自定义 GUC 参数到远端连接）：
+
+| 视图 | 引用接口 | 用途 |
+|------|---------|------|
+| `app.v_dim_member` | CUST-1, CUST-2, COACH-1 | 会员信息（nickname, mobile），DQ-6 合规 |
+| `app.v_dim_member_card_account` | CUST-1, COACH-1 | 会员卡余额，DQ-7 合规 |
+| `app.v_dim_assistant` | CUST-1, COACH-1 | 助教基本信息 |
+| `app.v_dwd_assistant_service_log` | CUST-1, CUST-2, COACH-1 | 服务记录明细（`is_delete=0` 废单排除，`ledger_amount` items_sum 口径） |
+| `app.v_dws_assistant_salary_calc` | COACH-1 | 助教绩效/档位/收入 |
+| `app.v_dws_member_assistant_relation_index` | CUST-1, COACH-1 | 会员-助教关系指数 |
+
+> 本次无 FDW 配置变更。所有视图已存在于 ETL 库 `app` schema 中。审计详情见 `docs/audit/changes/2026-03-19__rns12-db-audit.md`。
+
+---
+
 ## 2. 兼容性影响
 
 | 组件 | 影响 |