# 数据依赖矩阵（页面 → 数据表映射）

> 生成日期：2026-02-23
> 基于 PRD 审阅 Q&A 两轮结果 + 真实数据库现状

> **金额口径说明**：本矩阵中涉及"消费金额"的字段，统一使用 `items_sum`（= table_charge_money + goods_money + assistant_pd_money + assistant_cx_money + electricity_money），
> 不使用 `consume_money`（存在三种历史口径混合）。详见 [DWD-DOC 校准文档](../reports/DWD-DOC/README.md)。

---

## 图例

| 标记 | 含义 |
|------|------|
| ✅ | ETL 库已有表，可直接通过 FDW 映射 |
| 🔧 | ETL 库已有表但需扩展字段 |
| 🆕 | 需要新建的 ETL 表（DWS/DWD 层） |
| 📱 | 需要新建的业务库表（`test_zqyy_app`） |
| 🤖 | 需要 AI 应用调用（百炼） |
| ⏰ | 需要后台轮询/触发器机制 |

---

## 一、小程序页面 → 数据源

### task-list.html（任务列表）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 助教任务列表 | `zqyy_app.biz.coach_tasks` | 📱 新建 |
| 任务优先级（max(WBI,NCI)） | `dws.dws_member_winback_index` + `dws.dws_member_newconv_index` | ✅ FDW |
| 客户-助教关系（RS/OS） | `dws.dws_member_assistant_relation_index` | ✅ FDW |
| 客户基本信息 | `dwd.dim_member` | ✅ FDW |
| 助教基本信息 | `dwd.dim_assistant` | ✅ FDW |
| 任务置顶/放弃状态 | `zqyy_app.biz.coach_tasks` | 📱 新建 |
| 绩效计算快照 | `dws.dws_assistant_salary_calc` | ✅ FDW |
| 定档业绩配置 | `dws.cfg_performance_tier` | ✅ FDW |
| 助教等级单价 | `dws.cfg_assistant_level_price` | ✅ FDW |
| 跳档激励展示 | `dws.cfg_performance_tier` + `dws.dws_assistant_salary_calc` | ✅ FDW |
| 定档折算惩罚 | `dws.dws_assistant_daily_detail`（需扩展） | 🔧 扩展 |

### task-detail.html（任务详情）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 任务详情 | `zqyy_app.biz.coach_tasks` | 📱 新建 |
| 客户全信息 | `dwd.dim_member` + `dws.dws_member_consumption_summary` | ✅ FDW |
| 客户-助教亲密度 | `dws.dws_member_assistant_intimacy` | ✅ FDW |
| 近期服务记录 | `dwd.dwd_assistant_service_log` | ✅ FDW |
| 备注列表 | `zqyy_app.biz.notes` | 📱 新建 |
| 备注星星评分（再次服务意愿+再来店可能性） | `zqyy_app.biz.notes`（`rating_service_willingness`、`rating_revisit_likelihood`，各 1-5） | 📱 新建 |
| AI 维客线索 | 应用 3 返回结果缓存 | 📱🤖⏰ |
| 维客线索列表 | `zqyy_app.public.member_retention_clue`（应用3+应用6+人工写入） | 📱 已建 |
| AI 关系分析/任务建议 | 应用 4 返回结果缓存 | 📱🤖⏰ |
| AI 话术参考 | 应用 5 返回结果缓存 | 📱🤖⏰ |
| AI 备注分析 | 应用 6 返回结果（每个备注提交时触发） | 📱🤖 |
| 客户喜好标签（🎱斯🀅🎤） | `dwd.dwd_table_fee_log`（按房间类型统计） | ✅ FDW |

### performance.html（我的绩效）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 收入与业绩档位 | `dws.dws_assistant_salary_calc` | ✅ FDW |
| 服务记录明细 | `dwd.dwd_assistant_service_log` | ✅ FDW |
| 我的新客 | `dws.dws_assistant_customer_stats`（首次服务+次数过滤） | ✅ FDW |
| 我的常客 | `dws.dws_assistant_customer_stats` | ✅ FDW |
| 定档折算惩罚展示 | `dws.dws_assistant_daily_detail`（需扩展） | 🔧 扩展 |

### performance-records.html（业绩明细）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 全部业绩记录 | `dwd.dwd_assistant_service_log` | ✅ FDW |
| 定档折算展示 | `dws.dws_assistant_daily_detail`（需扩展） | 🔧 扩展 |
| 按天/月归总 | 后端聚合查询 | — |

### board-finance.html（财务看板）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 财务日报 | `dws.dws_finance_daily_summary` | ✅ FDW |
| 收入结构 | `dws.dws_finance_income_structure` | ✅ FDW |
| 充值汇总 | `dws.dws_finance_recharge_summary` | ✅ FDW |
| 折扣明细 | `dws.dws_finance_discount_detail` | ✅ FDW |
| 支出汇总 | `dws.dws_finance_expense_summary` | ✅ FDW |
| 平台结算 | `dws.dws_platform_settlement` | ✅ FDW |
| AI 财务洞察 | 应用 2 返回结果缓存 | 📱🤖⏰ |
| 环比数据 | 后端聚合计算 | — |

### board-customer.html（客户看板）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 最应召回（WBI 排序） | `dws.dws_member_winback_index` | ✅ FDW |
| 最大消费潜力（SPI 排序） | `dws.dws_member_spending_power_index` | 🆕 新建 |
| 最高余额 | `dws.dws_member_consumption_summary` | ✅ FDW |
| 最近充值 | `dwd.dwd_recharge_order` | ✅ FDW |
| 最高消费 60 天 | `dws.dws_member_consumption_summary`（基于 `items_sum`，非 `consume_money`） | ✅ FDW |
| 最频繁 60 天 | `dws.dws_member_consumption_summary` | ✅ FDW |
| 最近到店 | `dws.dws_member_visit_detail` | ✅ FDW |
| 最专一（RS 最大值） | `dws.dws_member_assistant_relation_index` | ✅ FDW |
| 客户喜好标签 | `dwd.dwd_table_fee_log` | ✅ FDW |

### board-coach.html（助教看板）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 定档业绩排序 | `dws.dws_assistant_salary_calc` | ✅ FDW |
| 工资排序 | `dws.dws_assistant_salary_calc` | ✅ FDW |
| 高客源储值额 | `dws.dws_member_assistant_relation_index` + `dws.dws_member_consumption_summary` | ✅ FDW |
| 任务完成数 | `zqyy_app.biz.coach_tasks`（统计已完成） | 📱 新建 |
| 助教月度汇总 | `dws.dws_assistant_monthly_summary` | ✅ FDW |

### customer-detail.html（客户详情）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 客户基本信息 | `dwd.dim_member` + `dwd.dim_member_card_account` | ✅ FDW |
| 消费汇总 | `dws.dws_member_consumption_summary` | ✅ FDW |
| 消费记录（台桌结账） | `dwd.dwd_settlement_head` + `dwd.dwd_table_fee_log` | ✅ FDW |
| 消费记录（商城订单） | `dwd.dwd_settlement_head` + `dwd.dwd_store_goods_sale` | ✅ FDW |
| 消费记录（充值） | `dwd.dwd_recharge_order` | ✅ FDW |
| 指数总览（WBI/NCI/SPI） | 各指数表 | ✅🆕 FDW |
| 备注列表 | `zqyy_app.biz.notes` | 📱 新建 |
| 备注星星评分（再次服务意愿+再来店可能性） | `zqyy_app.biz.notes`（`rating_service_willingness`、`rating_revisit_likelihood`，各 1-5） | 📱 新建 |
| AI 维客线索 | 应用 3 缓存 | 📱🤖⏰ |
| 维客线索（含生日等） | `zqyy_app.public.member_retention_clue` | 📱 已建 |

### coach-detail.html（助教详情）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 助教基本信息 | `dwd.dim_assistant` | ✅ FDW |
| 客户数（RS>2） | `dws.dws_member_assistant_relation_index` | ✅ FDW |
| 工龄 | `dwd.dim_assistant.hire_date` | ✅ FDW |
| 备注列表 | `zqyy_app.biz.notes` | 📱 新建 |

### chat.html（AI 对话）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 对话记录 | `zqyy_app.biz.ai_conversations` | 📱 新建 |
| 来源页面上下文 | 前端传入 | — |
| AI 应用 1 调用 | 百炼 API | 🤖 |

### notes.html（备注管理）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 备注列表 | `zqyy_app.biz.notes` | 📱 新建 |

### chat-history.html（对话历史）

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 历史对话列表 | `zqyy_app.biz.ai_conversations` | 📱 新建 |

### login/apply/reviewing 等登录流程页

| 数据需求 | 数据源 | 状态 |
|---------|--------|------|
| 用户信息 | `zqyy_app.auth.users` | 📱 新建（重构现有 public.users） |
| 微信登录 | 微信 API（code2Session） | — |
| 申请记录 | `zqyy_app.auth.user_applications` | 📱 新建 |

---

## 二、租户管理后台 → 数据源

| 功能 | 数据源 | 状态 |
|------|--------|------|
| 用户审核列表 | `zqyy_app.auth.user_applications` + `zqyy_app.auth.users` | 📱 新建 |
| 用户-助教关联建议 | `dwd.dim_assistant`（通过球房ID+手机号匹配）+ `dwd.dim_staff` / `dwd.dim_staff_ex`（员工信息表匹配） | ✅ FDW |
| 球房ID映射 | `zqyy_app.auth.site_code_mapping` | 📱 新建 |
| 维客线索管理 | `zqyy_app.public.member_retention_clue` + `dwd.dim_member`（FDW 客户信息） | 📱 已建 / ✅ FDW |
| Excel 上传-财务支出 | `dws.dws_finance_expense_summary`（或新建 staging 表） | 🔧/📱 |
| Excel 上传-团购收入 | `dws.dws_platform_settlement`（或新建 staging 表） | 🔧/📱 |
| Excel 上传-助教奖罚 | `zqyy_app.biz.salary_adjustments` | 📱 新建 |
| Excel 上传-充值业绩归属 | `dws.dws_assistant_recharge_commission`（或新建 staging 表） | 🔧/📱 |

---

## 三、后台轮询/触发器任务 → 数据源

| 触发器/轮询任务 | 触发条件 | 数据源 | 状态 |
|---------------|---------|--------|------|
| 任务生成器 | 每日 4:00 后首次运行 | 全部指数表 + `coach_tasks` | 📱⏰ |
| 任务状态轮询 | 每小时 | `coach_tasks` + 有效期检查 | 📱⏰ |
| 召回完成检测 | ETL 数据更新后 | `dwd.dwd_assistant_service_log` + `coach_tasks` | ⏰ |
| 数据回溯（备注重分类） | 召回完成时 | `notes`（含星星评分） + `coach_tasks` | 📱⏰ |
| AI 应用 2 财务洞察 | 每日 | 财务 DWS 表 | 🤖⏰ |
| AI 应用 3 维客线索 | 客户新增消费时 | DWD 订单明细 | 🤖⏰ |
| AI 应用 4 关系分析 | 助教参与新结算时 | DWD 订单明细 | 🤖⏰ |
| AI 应用 5 话术 | 应用 4 调用时 | 应用 4 输入+输出 | 🤖⏰ |
| AI 应用 6 备注分析 | 每个备注提交时 | 备注 + 客户信息 | 🤖 |

---

## 四、汇总：需要新建/扩展的数据对象

### ETL 库（`test_etl_feiqiu`）— 新建

| 表名 | Schema | 说明 |
|------|--------|------|
| `dws_member_spending_power_index` | dws | SPI 消费力指数 |
| `dws_assistant_order_contribution` | dws | 助教订单流水四项统计 |
| `app.*`（RLS 视图） | app | 全部 FDW 映射表的 RLS 视图层 |

### ETL 库 — 扩展

| 表名 | 扩展内容 |
|------|---------|
| `dws_member_consumption_summary` | 增加 30/60/90 天充值次数/金额、次均消费 |
| `dws_assistant_daily_detail` | 增加定档折算惩罚字段（penalty_minutes、penalty_reason、is_exempt） |

### 业务库（`test_zqyy_app`）— 新建

| 表名 | Schema | 说明 |
|------|--------|------|
| `users`（重构） | auth | 小程序用户（增加 status、wx_openid、wx_avatar 等） |
| `user_applications` | auth | 用户申请记录 |
| `site_code_mapping` | auth | 球房ID ↔ site_id 映射 |
| `user_assistant_bindng` | auth | 用户-助教绑定关系 |
| `coach_tasks` | biz | 助教任务（类型、优先级、状态、有效期等） |
| `coach_task_history` | biz | 任务变更历史（关闭/新建追溯） |
| `notes` | biz | 统一备注表（type 区分），含星星评分字段（`rating_service_willingness`、`rating_revisit_likelihood`，各 1-5，可空） |
| `ai_conversations` | biz | AI 对话记录 |
| `ai_messages` | biz | AI 对话消息明细 |
| `ai_cache` | biz | AI 应用 2-6 结果缓存 |
| `salary_adjustments` | biz | 助教奖罚明细（Excel 上传） |
| `excel_upload_log` | biz | Excel 上传记录与冲突处理日志 |
| `trigger_jobs` | biz | 触发器/轮询任务配置与执行日志 |

### FDW 映射（`test_zqyy_app.fdw_etl`）

需要映射的 ETL 表（通过 `app` schema RLS 视图）：

| 来源表 | 用途 |
|--------|------|
| `dwd.dim_member` | 客户基本信息 |
| `dwd.dim_assistant` | 助教基本信息 |
| `dwd.dim_member_card_account` | 会员卡余额 |
| `dwd.dim_table` | 台桌信息 |
| `dwd.dwd_settlement_head` | 结算主表 |
| `dwd.dwd_table_fee_log` | 台费明细 |
| `dwd.dwd_assistant_service_log` | 助教服务记录 |
| `dwd.dwd_recharge_order` | 充值订单 |
| `dwd.dwd_store_goods_sale` | 商品销售 |
| `dws.dws_member_consumption_summary` | 客户消费汇总 |
| `dws.dws_member_visit_detail` | 客户到店明细 |
| `dws.dws_member_winback_index` | WBI 指数 |
| `dws.dws_member_newconv_index` | NCI 指数 |
| `dws.dws_member_spending_power_index` | SPI 指数（新建后映射） |
| `dws.dws_member_assistant_relation_index` | RS/OS/MS/ML 指数 |
| `dws.dws_member_assistant_intimacy` | 亲密度 |
| `dws.dws_assistant_daily_detail` | 助教日明细 |
| `dws.dws_assistant_monthly_summary` | 助教月汇总 |
| `dws.dws_assistant_salary_calc` | 薪资计算 |
| `dws.dws_assistant_customer_stats` | 助教客户统计 |
| `dws.dws_assistant_order_contribution` | 助教订单流水（新建后映射） |
| `dws.dws_assistant_finance_analysis` | 助教财务分析 |
| `dws.dws_finance_daily_summary` | 财务日报 |
| `dws.dws_finance_income_structure` | 收入结构 |
| `dws.dws_finance_recharge_summary` | 充值汇总 |
| `dws.dws_finance_discount_detail` | 折扣明细 |
| `dws.dws_finance_expense_summary` | 支出汇总 |
| `dws.dws_platform_settlement` | 平台结算 |
| `dws.dws_assistant_recharge_commission` | 充值业绩归属 |
| `dws.cfg_performance_tier` | 定档配置 |
| `dws.cfg_assistant_level_price` | 助教等级单价 |
| `dws.cfg_bonus_rules` | 奖金规则 |
| `dws.cfg_index_parameters` | 指数参数配置（含 SPI 26 个参数 ✅） |
| `dws.dws_order_summary` | 订单汇总 |

### 新增 FDW 映射（员工信息表）

| 来源表 | 用途 |
|--------|------|
| `dwd.dim_staff` | 员工基础维度（姓名、手机、岗位、在职状态等），用于用户申请人员匹配 |
| `dwd.dim_staff_ex` | 员工扩展维度（工号、头像、职级、分组等），用于用户申请人员匹配 |

---
