# 项目待办总览（Backlog）

> 最后更新：2026-02-24
> 本文档汇总项目中所有已识别的待办事项，按子系统和优先级分类。
> 来源：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 → 通用基类 |

---

## 五、后端待办（P2 — 上线后迭代）

来源：`docs/deployment/LAUNCH-CHECKLIST.md` 第七阶段

| 状态 | 项目 | 说明 |
|------|------|------|
| 🔲 | 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` |

---

## 维护说明

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