root/Neo-ZQYY
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
075caf067f5494e36eb249c659252c210865125e
Neo-ZQYY/docs/prd/specs/00-数据依赖矩阵.md

284 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数据依赖矩阵（页面 → 数据表映射）
> 生成日期：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_recall_index` | 召回指数 |
| `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` | 员工扩展维度（工号、头像、职级、分组等），用于用户申请人员匹配 |
---
Reference in New Issue View Git Blame Copy Permalink