TakeoutSaaS.AdminApi/Document/11_SystemTodo.md

TODO Roadmap

当前列表为原 11 号文档中的待办事项，已迁移到此处并统一以复选框形式标记。若无特殊说明，均尚未完成。

1. 配置与基础设施（高优）

• Development/Production 数据库连接与 Secret 落地（Staging 暂不需要）。
• Redis 服务部署完毕并记录配置。
• RabbitMQ 服务部署完毕并记录配置。
• COS 密钥配置补录完毕。
• OSS 密钥配置补录完毕（已忽略，待采购后再补录）。
• SMS 平台密钥配置补录完毕（已忽略，待采购后再补录）。
• WeChat Mini 程序密钥配置补录完毕（AppID：wx30f91e6afe79f405，AppSecret：64324a7f604245301066ba7c3add488e，已同步到 admin/mini 配置并登记更新人）。
• PostgreSQL 基础实例部署完毕并记录配置。
• Postgres/Redis 接入文档 + IaC/脚本补齐（见 Document/infra/postgres_redis.md 与 deploy/postgres|redis）。
• RabbitMQ/Redis/Hangfire storage scripts available (see deploy/postgres and deploy/redis).
• admin/mini/user/gateway 网关域名、证书、CORS 列表整理完成。(忽略，暂时不用完成)
• Hangfire Dashboard 启用并新增 Admin 角色验证/网关白名单。(忽略，暂时不用完成)

2. 数据与迁移（高优）

• App/Identity/Dictionary/Hangfire 四个 DbContext 均生成初始 Migration 并成功 update database。
• 商户/门店/商品/订单/支付/配送等实体与仓储实现完成，提供 CRUD + 查询。
• 系统参数、默认租户、管理员账号、基础字典的种子脚本可重复执行。

3. 稳定性与质量

• Dictionary/Identity/Storage/Sms/Messaging/Scheduler 的 xUnit+FluentAssertions 单元测试框架搭建。
• WebApplicationFactory + Testcontainers 拉起 Postgres/Redis/RabbitMQ 的集成测试模板。
• .editorconfig、.globalconfig、Roslyn 分析器配置仓库通用规则并启用 CI 检查。

4. 安全与合规

• RBAC 权限、租户隔离、用户/权限洞察 API 完整演示并在 Swagger 中提供示例。
• 登录/刷新流程增加 IP 校验、租户隔离、验证码/频率限制。
• 登录/权限/敏感操作日志可追溯，提供查询接口或 Kibana Saved Search。
• Secret Store/KeyVault/KMS 管理敏感配置，禁止密钥写入 Git/数据库明文。

5. 观测与运维

• TraceId 贯通，并在 Serilog 中输出 Console/File/ELK 三种目标。
• Prometheus exporter 暴露关键指标，/health 探针与告警规则同步推送。
• PostgreSQL 全量/增量备份脚本及一次真实恢复演练报告。

6. 业务能力补全

• 商户/门店/菜品 API 完成并在 MQ 中投递上架/支付成功事件。
• 配送对接 API 支持下单/取消/查询并完成签名验签中间件。
• 小程序端商品浏览、下单、支付、评价、图片直传等 API 可闭环跑通。

7. 前后台 UI 对接

• Admin UI 通过 OpenAPI 生成或手写界面，接入 Hangfire Dashboard/MQ 监控只读模式。
• 小程序端完成登录、菜单浏览、下单、支付、物流轨迹、素材直传闭环。

8. CI/CD 与发布

• CI/CD 流水线覆盖构建、发布、静态扫描、数据库迁移。
• Dev/Staging/Prod 多环境配置矩阵 + 基础设施 IaC 脚本。
• 版本与发布说明模板整理并在仓库中提供示例。

9. 文档与知识库

• 接口文档、领域模型、关键约束使用 Markdown 或 API Portal 完整记录。
• 运行手册包含部署步骤、资源拓扑、故障排查手册。
• 安全合规模板覆盖数据分级、密钥管理、审计流程并形成可复用表格。