Files
TakeoutSaaS.AdminApi/Document/11_WaitTODO.md
贺爱泽 564c37b71b 1
2025-12-01 09:10:27 +08:00

50 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 下一步 TODO骨架完成后
说明当前骨架已覆盖认证、权限、多租户、存储、短信、MQ、调度、网关等基础能力。下面的清单用于进入“可运行/可上线”的补全与质量阶段,可按优先级推进。
## 1. 配置与基础设施落地(高优)
- 补充真实配置:数据库/Redis/RabbitMQ/对象存储/SMS/WeChat Mini/身份密钥并分环境管理Development/Staging/Production
- 准备基础设施PostgreSQL 主从、Redis哨兵/集群、RabbitMQ、COS/OSS、Hangfire 存储库;完善 docker-compose 与部署说明。
- 网关与服务域名规划:为 admin/mini/user/gateway 配置实际域名、TLS 证书与 CORS 列表。
- Hangfire Dashboard 鉴权:开启并加上 Admin 角色校验或网关白名单。
## 2. 数据与迁移(高优)
- 建立 EF Core Migration 基线并生成数据库App/Identity/Dictionary/Hangfire
- 设计并落地核心业务表(商户/门店/商品/订单/支付/配送等),补齐 Domain 与 Infrastructure 仓储。
- 数据初始化/种子:系统参数、默认租户、管理员、基础字典。
## 3. 质量与测试(高优)
- 单元测试骨架xUnit + FluentAssertionsDictionary、Identity、Storage、Sms、Messaging、Scheduler
- 集成测试基座WebApplicationFactory + TestcontainersPostgres/Redis/RabbitMQ/MinIO 可选)。
- 静态分析:添加 .editorconfig/.globalconfig启用可空警告、风格规则接入 Roslyn 分析器。
## 4. 安全与合规
- 完善鉴权:网关透传与后端校验的租户/用户/权限Swagger 鉴权示例。
- 输入校验与防刷:全局限流策略(按 IP/租户),登录与验证码防刷策略参数化。
- 日志与审计:敏感字段脱敏,登录/权限/管理操作审计日志模型与落库。
- 配置机密:使用 Secret Store/环境变量/KMS 管理密钥,禁止明文提交。
## 5. 可观测性与运维
- 日志链路:统一 TraceId 透传(网关→服务),配置 Serilog 输出Console/File/ELK与留存策略。
- 指标/监控Prometheus exporter、健康检查探针/health、告警规则草案。
- 备份恢复PostgreSQL 全量/增量备份脚本,恢复演练记录。
## 6. 业务功能补全
- 订单/商品/商户等领域建模与应用服务接口实现,结合 MQ 事件发布(订单创建、支付成功等)。
- 配送对接抽象实现(达达/闪送/顺丰同城)占位,提供下单/取消/查询接口与回调验签。
- 小程序端接口补齐:商品浏览、下单、支付、评价、上传图片直传联调。
## 7. 前台/后台 UI 对接
- Admin UI接入 Swagger 导出的 OpenAPI生成或手写管理端界面接入 Hangfire Dashboard/MQ 监控只读访问。
- MiniApp小程序登录流程与错误码文档完善联调上传、下单、支付链路。
## 8. CI/CD 与发布
- 建立流水线:构建/测试/扫描SAST、镜像推送、数据库迁移步骤。
- 多环境部署策略Dev/Staging/Prod 配置隔离,蓝绿或滚动发布方案草拟。
- 版本与变更管理:约定版本号/发布说明模板。
## 9. 文档补全
- 更新接口文档(新增业务 API、错误码、回调规范、模块依赖关系图。
- 运维手册:启动参数、环境变量列表、端口/域名映射、常见故障排查。
- 安全与合规清单:数据分类分级、审计、留存周期。