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()
1.6 KiB
1.6 KiB
立交桥项目需求文档
项目状态
- 当前阶段:Demo 已完成,正在优化质量重构为生产级产品。
- 质量标准:按照上线产品质量要求执行,所有代码必须通过严谨真实的 review 和独立专业的测试验证。
核心目标
- 稳定可靠 — 生产环境下的高可用性与稳定性。
- 性能优化 — 响应时间、吞吐量达到上线标准。
- 可维护性 — 代码结构清晰,日志完善,监控健全。
- 安全合规 — 数据与交易安全符合上线规范。
- 可扩展性 — 支持后续功能迭代与模块扩展。
重构重点
- 代码质量:消除技术债务,补全单元测试,提升覆盖率。
- 架构优化:模块解耦,接口规范化,异常处理完善。
- 运维体系:健康检查、监控告警、灰度发布。
- 文档完善: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/ # 数据库脚本