emoon-backend/docs/templates/ai-platform-task-template.md

AI 中台任务拆分模板

每个开发任务开始前先复制本模板。任务描述必须足够具体，让初级工程师不需要重新做模块归属和架构判断。

1. 任务基本信息

项目	内容
任务名称
所属阶段	二期 / 三期 / 技术债 / 其他
业务场景	挂号 / 建档 / 舌诊 / 面诊 / 报告解读 / 随访 / 计费 / 统计 / 其他
负责人
预计交付时间
关联设计文档
关联 ADR

2. 任务目标

用 3-5 句话说明本任务要交付什么，不要写实现细节。

示例：
实现 Agent 会话创建能力。开放平台完成签名鉴权后，通过 AgentChatFacade 创建会话。
会话创建成功后返回 conversationId，并为后续 Dify / DirectLLM 调用建立统一会话上下文。

3. 模块边界

3.1 允许修改

模块	允许修改内容

3.2 禁止修改

模块	禁止原因

3.3 允许依赖

填写允许新增或使用的 Maven 依赖 / 模块依赖。

3.4 禁止依赖

填写本任务明确禁止新增的依赖。

4. 输入输出契约

4.1 入参

字段	类型	必填	来源	说明

4.2 出参

字段	类型	说明

4.3 事件

事件	生产方	消费方	幂等键	说明

5. 核心流程

sequenceDiagram
    participant Caller as 调用方
    participant Facade as Facade/API
    participant App as Application Service
    participant Domain as Domain
    participant Repo as Repository/Mapper

    Caller->>Facade: 提交请求
    Facade->>App: 转换为 Command
    App->>Domain: 执行业务规则
    App->>Repo: 保存状态
    App-->>Facade: 返回结果
    Facade-->>Caller: 返回响应

6. 数据库与状态

6.1 涉及表

表	操作	说明
	insert / update / select / delete

6.2 状态机

当前状态	事件	目标状态	是否允许重试

7. 幂等、事务与一致性

• 幂等键：
• 本地事务边界：
• 是否需要 Outbox：
• 是否需要重试：
• 是否允许最终一致：
• 失败补偿方式：

8. 异常与降级

异常	处理方式	用户响应	是否告警

9. 安全与合规

• 是否涉及患者敏感信息：
• 是否写日志：
• 是否进入 prompt：
• 是否发送第三方系统：
• 脱敏方式：
• 审计记录：

10. 验收标准

• 模块归属符合 docs/ai-platform-engineering-constraints.md。
• 没有新增禁止依赖。
• 关键流程可通过单元测试或集成测试验证。
• 异常分支有测试或手工验证记录。
• PR 自检清单已填写。