# AI 中台任务拆分模板

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

## 1. 任务基本信息

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

## 2. 任务目标

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

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

## 3. 模块边界

### 3.1 允许修改

| 模块 | 允许修改内容 |
| --- | --- |
|  |  |

### 3.2 禁止修改

| 模块 | 禁止原因 |
| --- | --- |
|  |  |

### 3.3 允许依赖

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

### 3.4 禁止依赖

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

## 4. 输入输出契约

### 4.1 入参

| 字段 | 类型 | 必填 | 来源 | 说明 |
| --- | --- | --- | --- | --- |
|  |  |  |  |  |

### 4.2 出参

| 字段 | 类型 | 说明 |
| --- | --- | --- |
|  |  |  |

### 4.3 事件

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

## 5. 核心流程

```mermaid
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 自检清单已填写。