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:
@@ -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 联动升级为消息队列 | 当前方案 A(HTTP 内部接口),规模扩大后考虑 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_count(2026-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` 中设置 |
|
||||
|
||||
---
|
||||
|
||||
## 维护说明
|
||||
|
||||
本文档为项目待办的单一汇总入口。新增待办时:
|
||||
|
||||
Reference in New Issue
Block a user