Neo
b25308c3f4
## P1 数据库基础 - zqyy_app: 创建 auth/biz schema、FDW 连接 etl_feiqiu - etl_feiqiu: 创建 app schema RLS 视图、商品库存预警表 - 清理 assistant_abolish 残留数据 ## P2 ETL/DWS 扩展 - 新增 DWS 助教订单贡献度表 (dws.assistant_order_contribution) - 新增 assistant_order_contribution_task 任务及 RLS 视图 - member_consumption 增加充值字段、assistant_daily 增加处罚字段 - 更新 ODS/DWD/DWS 任务文档及业务规则文档 - 更新 consistency_checker、flow_runner、task_registry 等核心模块 ## P3 小程序鉴权系统 - 新增 xcx_auth 路由/schema（微信登录 + JWT） - 新增 wechat/role/matching/application 服务层 - zqyy_app 鉴权表迁移 + 角色权限种子数据 - auth/dependencies.py 支持小程序 JWT 鉴权 ## 文档与审计 - 新增 DOCUMENTATION-MAP 文档导航 - 新增 7 份 BD_Manual 数据库变更文档 - 更新 DDL 基线快照（etl_feiqiu 6 schema + zqyy_app auth） - 新增全栈集成审计记录、部署检查清单更新 - 新增 BACKLOG 路线图、FDW→Core 迁移计划 ## Kiro 工程化 - 新增 5 个 Spec（P1/P2/P3/全栈集成/核心业务） - 新增审计自动化脚本（agent_on_stop/build_audit_context/compliance_prescan） - 新增 6 个 Hook（合规检查/会话日志/提交审计等） - 新增 doc-map steering 文件 ## 运维与测试 - 新增 ops 脚本：迁移验证/API 健康检查/ETL 监控/集成报告 - 新增属性测试：test_dws_contribution / test_auth_system - 清理过期 export 报告文件 - 更新 .gitignore 排除规则
12 KiB
12 KiB
数据依赖矩阵（页面 → 数据表映射）
生成日期：2026-02-23 基于 PRD 审阅 Q&A 两轮结果 + 真实数据库现状
图例
| 标记 | 含义 |
|---|---|
| ✅ | 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 |
📱 新建 |
| AI 消费习惯分析 | 应用 3 返回结果缓存 | 📱🤖⏰ |
| 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 |
✅ 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 |
📱 新建 |
| AI 消费习惯分析 | 应用 3 缓存 | 📱🤖⏰ |
| 生日信息 | zqyy_app.biz.notes（type=birthday） |
📱 新建 |
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 |
📱 新建 |
| 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 区分） |
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 |
员工扩展维度（工号、头像、职级、分组等），用于用户申请人员匹配 |