feat: 累积功能变更 — 聊天集成、租户管理、小程序更新、ETL 增强、迁移脚本

包含多个会话的累积代码变更:
- backend: AI 聊天服务、触发器调度、认证增强、WebSocket、调度器最小间隔
- admin-web: ETL 状态页、任务管理、调度配置、登录优化
- miniprogram: 看板页面、聊天集成、UI 组件、导航更新
- etl: DWS 新任务(finance_area_daily/board_cache)、连接器增强
- tenant-admin: 项目初始化
- db: 19 个迁移脚本(etl_feiqiu 11 + zqyy_app 8)
- packages/shared: 枚举和工具函数更新
- tools: 数据库工具、报表生成、健康检查
- docs: PRD/架构/部署/合约文档更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-06 00:03:48 +08:00
parent 70324d8542
commit 6f8f12314f
515 changed files with 76604 additions and 7456 deletions

View File

@@ -1,6 +1,6 @@
# 项目待办总览Backlog
> 最后更新2026-02-24
> 最后更新2026-03-27
> 本文档汇总项目中所有已识别的待办事项,按子系统和优先级分类。
> 来源LAUNCH-CHECKLIST、SPEC 文档、字段审计报告、PRD、代码注释等。
@@ -129,14 +129,73 @@
| 📋 | 冷数据归档(方案 5 | `ods_taskspec_refactor_proposal.md` 中长期待办 |
| 🔲 | ETL SDK 抽象 | LAUNCH-CHECKLIST 7.4,飞球 Connector → 通用基类 |
### 4.5 未来规划P2
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | ETL 管理可视化 | 通过 Admin-web 查看每个 API → ODS → DWD → DWS 各表、各字段的映射与处理关系;支持各连接器的信息获取与状态监控 |
| 🔲 | 多连接器经验沉淀与准备 | 总结现有飞球 Connector 的开发经验,抽象通用模式,为更多连接器的实现与部署做准备 |
| 🔲 | ETL 本地落盘记录自动清理 | 落到本地 JSON 的 ETL 记录只保留最近 10 条,超出数量自动删除旧记录 |
| 🔲 | 飞球 Connector 变动检测调度 | 由固定调度升级为变动检测模式:每 3 分钟轮询结账记录单是否有更新,有变动时触发相关 API 拉取及各层表刷新 |
---
## 五、后端待办P2 — 上线后迭代)
## 五、AI 模块待办
### 5.1 多门店支持P2
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | App2 财务洞察多门店预生成 | 当前写死门店 `2790685415443269`,需改为从活跃门店列表动态获取 |
| 🔲 | AI 事件触发多门店路由 | ETL 多连接器/多租户重构完成后AI 触发链需支持按门店路由 |
| 🔲 | admin-web AI 监控按门店筛选 | 依赖多门店数据模型 |
### 5.2 消息队列P2
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | ETL → AI 联动升级为消息队列 | 当前方案 AHTTP 内部接口),规模扩大后考虑 PostgreSQL LISTEN/NOTIFY 或 Redis Pub/Sub |
### 5.3 DashScope 知识库接入P2
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | 百炼知识库检索链路 | 当前 8 个 App 纯 Prompt + 数据拼装,未接入 DashScope 知识库 |
---
## 六、租户管理后台待办P1
来源2026-03-24 产品需求
### 6.1 在线编辑能力
> 通用交互模式:支持 Excel 上传 → 解析后以表格交互样式展示 → 支持在线编辑单元格 → 支持新增数据行 → 保存提交。
> 所有"上传"类功能统一升级为此模式。
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | 充值提成在线编辑 | 租户后台可在线编辑助教充值提成配置(当前仅 Excel 上传) |
| 🔲 | 其他上传内容在线编辑 | 所有已有的 Excel 上传功能统一升级为"上传 + 在线编辑"模式 |
### 6.2 工资审核流程
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | 助教工资审核确认 | 每月 1-5 日内,租户后台可审核上月助教应发工资并确认 |
| 🔲 | 工资确认联动小程序 | 工资确认后,小程序前端对应月份去掉"预估收入"字样,显示为"我的收入" |
---
## 七、后端待办P2 — 上线后迭代)
来源:`docs/deployment/LAUNCH-CHECKLIST.md` 第七阶段
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | AI 事件处理器 BudgetTracker 修复 | 启动时报 `ValueError: 必须提供 usage_provider`AI 功能不可用(`app/ai/budget_tracker.py` |
| 🔲 | admin_db_health UnicodeDecodeError | 健康检查页 `psycopg2.connect``utf-8 codec can't decode byte 0xd6`,疑似 Windows 系统编码混入连接参数(`app/routers/admin_db_health.py` |
| 🔲 | 管理员解除禁用账号 | admin-web 租户管理页增加"解除禁用"操作,将 disabled 用户恢复为 new 并重置 rejection_count2026-03-23 需求确认) |
| 🔲 | xlsx 导入/导出 | 上传、解析、校验、落库、错误报告 |
| 🔲 | 运维监控系统 | BS 架构,集成管理后台,取代 bat 脚本 |
| 🔲 | 租户模型 | tenant 层 + RLS Policy DDL |
@@ -146,7 +205,7 @@
---
## 、SPEC 状态总览
## 、SPEC 状态总览
| SPEC | 状态 | 说明 |
|------|------|------|
@@ -166,7 +225,7 @@
---
## 、文档待办
## 、文档待办
| 状态 | 项目 | 位置 |
|------|------|------|
@@ -178,6 +237,18 @@
---
## 十、小程序看板待办P2
### 10.1 财务看板board-finance
| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | 助教分析按区域统计收入 | 当前助教分析板块为全店汇总,需扩展支持按区域筛选时显示该区域的助教收入明细。依赖区域筛选体系重建完成后实施 |
| 🔲 | 各区域各收费项目对比 | 支持跨区域维度对比各收费项目(台费、酒水、包厢费等)的收入数据,帮助店长识别各区域的盈利结构差异 |
| 🔲 | admin-web 强制执行月度任务开关 | TaskConfig 高级选项中增加"强制执行月度任务"复选框,勾选后 CLI 命令注入 `DWS_SALARY_ALLOW_OUT_OF_CYCLE=1`,跳过月初结算期限制。当前需手动在 `.env` 中设置 |
---
## 维护说明
本文档为项目待办的单一汇总入口。新增待办时: