687c4535f8
P0-1 (limits.go): Allow()方法改为全程使用写锁保护counters map读写，避免RLock写入时的data race P0-2 (ticket_workflow.go+ticket_handler.go): Assign/Resolve/Close操作先查询ticket存在性和状态，返回明确的CS_TICKET_4001/CS_TKT_4002/CS_TICKET_4092/CS_TICKET_4093错误码，handler根据错误前缀路由HTTP状态码 P1-1 (ticket_store.go): 移除GetStats中3处手动rows.Close()，只保留defer Close()
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# 立交桥项目需求文档
|
||
|
||
## 项目状态
|
||
- **当前阶段**：Demo 已完成，正在优化质量重构为生产级产品。
|
||
- **质量标准**：按照上线产品质量要求执行，所有代码必须通过严谨真实的 review 和独立专业的测试验证。
|
||
|
||
## 核心目标
|
||
1. **稳定可靠** — 生产环境下的高可用性与稳定性。
|
||
2. **性能优化** — 响应时间、吞吐量达到上线标准。
|
||
3. **可维护性** — 代码结构清晰，日志完善，监控健全。
|
||
4. **安全合规** — 数据与交易安全符合上线规范。
|
||
5. **可扩展性** — 支持后续功能迭代与模块扩展。
|
||
|
||
## 重构重点
|
||
- 代码质量：消除技术债务，补全单元测试，提升覆盖率。
|
||
- 架构优化：模块解耦，接口规范化，异常处理完善。
|
||
- 运维体系：健康检查、监控告警、灰度发布。
|
||
- 文档完善：API 文档、部署手册、故障排查指南。
|
||
|
||
## 成功标准
|
||
- 单元测试覆盖率 > 80%。
|
||
- 集成测试通过率 100%。
|
||
- 生产环境无 P0 级别故障连续运行超过 30 天。
|
||
- 核心接口平均响应时间 < 200ms (P99)。
|
||
|
||
## 目录结构
|
||
```
|
||
/home/long/project/立交桥/
|
||
├── requirements.md # 本文档
|
||
├── docs/ # 项目文档
|
||
├── gateway/ # 网关层
|
||
├── internal/ # 内部模块
|
||
├── platform-token-runtime/ # Token 运行时
|
||
├── supply-api/ # 供应链 API
|
||
├── tests/ # 测试套件
|
||
├── scripts/ # 部署脚本
|
||
└── sql/ # 数据库脚本
|
||
```
|