# 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. 测试与验证

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

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

## 6. Review 重点

请重点 review：

-