项目待办总览（Backlog）
最后更新：2026-03-27
本文档汇总项目中所有已识别的待办事项，按子系统和优先级分类。
来源：LAUNCH-CHECKLIST、SPEC 文档、字段审计报告、PRD、代码注释等。
阅读指南
- P0 = 不做就上不了线
- P1 = 上线前必须做
- P2 = 可上线后迭代
- ✅ = 已完成
- 🔲 = 待办
- 📋 = 有 SPEC 但未执行
一、小程序上线关键路径（P0）
来源：docs/deployment/LAUNCH-CHECKLIST.md
1.1 基础设施
| 状态 |
项目 |
说明 |
| ✅ |
服务器目录结构 + 仓库克隆 |
20260220 完成 |
| 🔲 |
配置环境变量文件 |
服务器 .env 手动创建 |
| 🔲 |
安装 Python 依赖 |
uv sync --all-packages |
| 🔲 |
运行 setup-server-git.py |
Git 排除规则 |
| 🔲 |
运行 init-server-env.py |
删除排除文件 + 创建 export 目录 |
| 🔲 |
bat 脚本部署到服务器 |
D:\NeoZQYY\scripts\ |
| 🔲 |
确认 Nginx 反代规则 |
测试 8001 / 正式 8000 |
| 🔲 |
SSL 证书自动续期 |
|
| 🔲 |
数据库备份方案 |
pg_dump + Windows 计划任务 |
1.2 微信侧配置
| 状态 |
项目 |
说明 |
| ✅ |
合法域名 + HTTPS |
已配置 |
| 🔲 |
消息推送配置提交验证 |
需服务器后端在线 |
| 🔲 |
用户隐私保护指引 |
微信后台填写 |
| 🔲 |
小程序名称/图标/简介/类目 |
审核必需 |
| 🔲 |
体验成员配置 |
内部测试必需 |
1.3 后端核心功能
| 状态 |
项目 |
说明 |
| 🔲 |
微信登录接口 |
POST /api/auth/wechat_login |
| 🔲 |
权限中间件 |
JWT site_id + role 校验 |
| 🔲 |
至少一个有实际功能的首页 |
审核要求 |
| 🔲 |
密钥配置 |
WX_APP_ID、WX_APP_SECRET、JWT_SECRET_KEY |
1.4 数据库基础设施
| 状态 |
项目 |
说明 |
| 📋 |
miniapp-db-foundation SPEC |
6 个任务全部待执行 |
| 🔲 |
auth/biz Schema 创建 |
SPEC 任务 2 |
| 🔲 |
ETL RLS 视图层（35 张） |
SPEC 任务 1 |
| 🔲 |
FDW 跨库映射 |
SPEC 任务 3 |
| 🔲 |
端到端验证脚本 |
SPEC 任务 5 |
二、安全与审计（P1 — 上线前必须做）
来源：docs/deployment/LAUNCH-CHECKLIST.md 第五阶段
| 状态 |
项目 |
说明 |
| 🔲 |
用户申请/审核流 |
user_application 表 + 审核 API |
| 🔲 |
审计日志 |
audit_log 表 + 审计中间件 |
| 🔲 |
后端结构化日志 |
替代 uvicorn 默认日志 |
| 🔲 |
服务器防火墙确认 |
Tailscale 网卡入站限制 |
| 🔲 |
PostgreSQL 监听确认 |
仅内网/本机 |
| 🔲 |
消息推送切安全模式 |
AES 加解密 |
三、审核准备（P1 — 提交审核前）
来源：docs/deployment/LAUNCH-CHECKLIST.md 第六阶段
| 状态 |
项目 |
说明 |
| 🔲 |
主要页面功能截图 |
|
| 🔲 |
测试账号 |
|
| 🔲 |
类目资质文件 |
营业执照等 |
| 🔲 |
功能介绍文案 |
|
四、ETL 待办
4.1 字段补全（来源：field_review_for_user.md）
| 状态 |
项目 |
优先级 |
说明 |
| 🔲 |
映射错误修复（4 处） |
高 |
site_assistant_id、discount_price 列名、batch_stock_qty、provisional_total_cost |
| 🔲 |
待新增/补映射字段（40 个） |
中 |
分布在 12 张 ODS 表，含 A/B/C 三类 |
| 🔲 |
新建 DWD 表（2 张） |
中 |
dwd_goods_stock_movement（优先）、settlement_ticket（待定） |
| 🔲 |
ODS 配置修改（1 处） |
中 |
goods_stock_summary 改 requires_window=True |
| 🔲 |
ODS 平层化映射修复 |
低 |
table_area_id_list 字段名映射错位 |
4.2 DWS 层待建表
| 状态 |
项目 |
来源 |
| 🔲 |
dws_member_spending_power_index RLS 视图 |
miniapp-db-foundation P2 预留 |
| 🔲 |
dws_assistant_order_contribution |
miniapp-db-foundation P2 预留 |
| 🔲 |
dws_goods_stock_summary（日/周/月粒度） |
dataflow-field-completion SPEC |
4.3 Core 层迁移
| 状态 |
项目 |
来源 |
| 🔲 |
补齐 Core 层维度表字段 |
docs/roadmap/2026-02-24__fdw-dwd-to-core-migration-plan.md |
| 🔲 |
DWD → Core 填充任务 |
同上 |
| 🔲 |
app 视图从 DWD 切换到 Core |
同上 |
4.4 架构优化
| 状态 |
项目 |
来源 |
| 📋 |
冷数据归档（方案 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 拉取及各层表刷新 |
五、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 |
| 🔲 |
后端 API 集成测试 |
|
| 🔲 |
小程序端自动化测试 |
|
| 🔲 |
依赖版本 pin 上限 |
当前 >=0.115 等范围较宽松 |
八、SPEC 状态总览
| SPEC |
状态 |
说明 |
admin-web-console |
✅ 已完成 |
Web 管理后台 |
assistant-abolish-cleanup |
✅ 已完成 |
助教废除链路清理 |
dataflow-field-completion |
✅ 已完成 |
字段补全与联调 |
dataflow-structure-audit |
✅ 已完成 |
数据流结构分析重构 |
dwd-phase1-refactor |
✅ 已完成 |
DWD 第一阶段重构 |
etl-aggregation-fix |
✅ 已完成 |
ETL 聚合修复 |
etl-dws-flow-refactor |
✅ 已完成 |
DWS 流程重构 |
etl-fullstack-integration |
✅ 已完成 |
全栈集成测试 |
etl-pipeline-debug |
✅ 已完成 |
ETL 全链路调试 |
etl-staff-dimension |
✅ 已完成 |
员工维度表 |
ods-dedup-standardize |
✅ 已完成 |
ODS 去重标准化 |
spi-spending-power-index |
✅ 已完成 |
消费力指数 |
miniapp-db-foundation |
📋 待执行 |
小程序数据库基础设施（6 个任务） |
九、文档待办
| 状态 |
项目 |
位置 |
| 🔲 |
ADR（架构决策记录）模板 |
docs/architecture/ |
| 🔲 |
数据字典完善 |
docs/contracts/data_dictionary/ |
| 🔲 |
权限矩阵 |
docs/permission_matrix/ |
| 🔲 |
运维手册 |
docs/ops/ |
| ✅ |
FDW DWD→Core 迁移方案 |
docs/roadmap/2026-02-24__fdw-dwd-to-core-migration-plan.md |
十、小程序看板待办（P2）
10.1 财务看板（board-finance）
| 状态 |
项目 |
说明 |
| 🔲 |
助教分析按区域统计收入 |
当前助教分析板块为全店汇总，需扩展支持按区域筛选时显示该区域的助教收入明细。依赖区域筛选体系重建完成后实施 |
| 🔲 |
各区域各收费项目对比 |
支持跨区域维度对比各收费项目（台费、酒水、包厢费等）的收入数据，帮助店长识别各区域的盈利结构差异 |
| 🔲 |
admin-web 强制执行月度任务开关 |
TaskConfig 高级选项中增加"强制执行月度任务"复选框，勾选后 CLI 命令注入 DWS_SALARY_ALLOW_OUT_OF_CYCLE=1，跳过月初结算期限制。当前需手动在 .env 中设置 |
维护说明
本文档为项目待办的单一汇总入口。新增待办时：
- 先在对应的来源文档中记录（LAUNCH-CHECKLIST、SPEC、字段审计报告等）
- 同步更新本文档对应分类
- 完成后标记 ✅ 并注明日期
Neo
6f8f12314f