pull_request_template.md 2.4 KB

PR 自检清单

1. 本次变更

  • 需求 / 任务编号:
  • 变更类型:
    • 新功能
    • Bug 修复
    • 重构
    • 数据库变更
    • 文档 / 约束
  • 影响模块:
    • emoon-openplatform
    • emoon-admin
    • emoon-infra/emoon-modules-api
    • emoon-infra/emoon-modules
    • emoon-common-*
    • emoon-extend
    • 其他:

2. 架构边界检查

  • 本次代码放在了正确模块,没有为了方便写进入口层或 API 模块。
  • *-api 模块只新增 DTO / VO / enum / event / facade / SPI,没有新增 Mapper、Controller、ServiceImpl、EngineImpl。
  • Controller 只调用 Facade / Application Service,没有直接注入 Mapper。
  • emoon-openplatform 没有新增对 Mapper、具体 Engine 实现、账务实现模块的直接依赖。
  • 没有跨模块直接更新其他模块的数据表。
  • 没有引入新的反向依赖或循环依赖。
  • 如违反工程约束,已补充 ADR:

3. AI 中台专项检查

  • Agent 编排逻辑落在 ai-agent 或当前规划对应模块。
  • 卡片状态和动作逻辑落在 ai-card 或当前规划对应模块。
  • MCP 工具治理逻辑落在 ai-mcp 或当前规划对应模块。
  • 计量逻辑落在 ai-meter 或当前规划对应模块。
  • 账务扣减、退款、冲正逻辑落在 ai-billing 或当前规划对应模块。
  • 合同、套餐、能力包逻辑落在 ai-contract 或当前规划对应模块。
  • 统计报表逻辑落在 ai-operation 或当前规划对应模块。

4. 生产级要求

  • 幂等键设计已说明,重复请求不会产生重复业务结果。
  • 涉及异步流程时,已考虑 Outbox / 重试 / 补偿 / 死信。
  • 涉及计量或账务时,已说明事件状态、价格快照、扣减时机。
  • 涉及医疗敏感数据时,日志、异常、prompt、第三方请求均已脱敏或最小化。
  • 涉及外部系统时,已处理超时、失败、降级、审计。
  • 涉及状态机时,非法状态流转已被阻止。

5. 测试与验证

  • 已补充单元测试。
  • 已补充集成测试或说明无需集成测试的原因。
  • 已覆盖异常分支。
  • 已手工验证核心业务场景。
  • [ ] 已运行命令:

    填写实际运行的命令和结果
    

6. Review 重点

请重点 review: