# 项目待办总览（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` 中设置 |

---

## 维护说明

本文档为项目待办的单一汇总入口。新增待办时：
1. 先在对应的来源文档中记录（LAUNCH-CHECKLIST、SPEC、字段审计报告等）
2. 同步更新本文档对应分类
3. 完成后标记 ✅ 并注明日期
