adspecs 0.1.12

package/.adspecs/templates/05-/345/220/216/347/253/257/344/273/273/345/212/241/346/270/205/345/215/225/346/250/241/346/235/277.md

@@ -0,0 +1,724 @@
+---
+
+description: "ECP 平台功能实现的 TDD 任务列表模板"
+---
+
+### 修订记录
+
+| 版本号 | 修订日期 | 修订人 | 修订内容 |
+| ------ | -------- | ------ | -------- |
+| v2.0 | 2026-06-13 | AI | ECP 平台专项改造：通用 Python 模板 → ECP Java Maven 三模块 TDD 模板。新增 ECP 任务类型速查表（17 种）、ECP 编码规范检查清单（10 条）、TDD 执行指南（RED→GREEN→REFACTOR）。Phase 1-10 全部替换为 M06-01 销售预测单真实示例（Entity/DTO/DAO/Service/Controller/Feign/枚举/i18n）。格式扩展：新增 `[TDD]` 标记。路径约定替换为 ECP 三模块结构。与 adspecs-tasks skill §ECP 平台编码规范完全对齐 |
+| v1.0 | 2026-06-12 | AI | 初始版本：通用 spec-kit 任务模板（Python 示例），含 Phase 1~5+N、依赖关系、并行策略 |
+
+# 任务清单：[功能名称]
+
+**设计文档来源**：
+- 系统设计文档：`docs/30-system-design/{crm|mom}/[功能名]_system-design.md`（必读，由 `adspecs-plan` 产出，包含 OOA+OOD 13 章节统一设计）
+- PRD 文档：`docs/20-prd/{crm|mom}/[模块]/[需求规格说明书].md`（可选，用户故事验收场景参考）
+- 建表 SQL：`docs/30-system-design/{crm|mom}/[功能名]_schema.sql`（可选，DDL 直接可用）
+
+**前置条件**：
+- 调用 `/adspecs-tasks` 前，必须已完成 `/adspecs-plan` 产出的 `_system-design.md`
+- 系统设计文档必须包含：§1 需求映射、§2 实体+DTO+Ro、§3 数据模型（含 MyBatis XML）、§4 Service 设计、§5 Controller 端点、§6 枚举+校验、§7 异常+消息码、§13 代码结构
+
+**TDD 约定**：本模板遵循 `test-driven-development` skill 的"测试先行"原则——所有实现任务之前必须先有失败的测试任务。模板中的样本任务包含 `[TDD]` 标记的测试任务。
+
+**组织方式**：任务按用户故事分组（设计文档 §1.1.1），以支持每个故事的独立 TDD 实现和独立测试。
+
+---
+
+## 任务格式：`- [ ] [TaskID] [P?] [TDD?] [Story?] 描述 + 精确文件路径`
+
+**格式组成**：
+
+| 元素 | 说明 |
+|------|------|
+| `- [ ]` | Markdown 复选框（始终存在） |
+| `[TaskID]` | 全局递增序号：T001, T002, T003... |
+| `[P]` | 可并行执行标记（操作不同文件，无未完成依赖） |
+| `[TDD]` | 测试任务标记（Service 层单元测试 / Controller 层集成测试），**必须在同故事实现任务之前完成且验证失败** |
+| `[Story]` | 用户故事标签：[US1], [US2]...（对应设计文档 §1.1.1）。Phase 1/2/Final 无此标签 |
+| 描述 + 文件路径 | 明确操作描述 + 从三模块根开始的完整文件路径。多文件任务可分行列出路径 |
+
+**格式示例（ECP）**：
+
+```text
+✅ 正确：
+- [ ] T012 [TDD] [US1] 编写提交预测单 Service 单元测试（含正常+提前期拦截+MOQ警告），测试文件：
+      3103-sales-forecast-application/src/test/java/com/sie/gushen/salesforecast/model/service/impl/ForecastOrderServiceTest.java
+- [ ] T013 [US1] 创建 ForecastOrderEntity（extends BaseEntity<ForecastOrderEntity>, @TableName(`forecast_order`), IdType.ASSIGN_ID），文件：
+      3103-sales-forecast-model/src/main/java/com/sie/gushen/salesforecast/model/entity/ForecastOrderEntity.java
+- [ ] T014 [P] [US1] 创建 ForecastOrderDto（extends ReqeustCommonDataBean, 含 saveForecastOrder/updateForecastOrder 校验分组），文件：
+      3103-sales-forecast-api/src/main/java/com/sie/gushen/salesforecast/api/dto/ForecastOrderDto.java
+
+❌ 错误：
+- [ ] 创建 ForecastOrder 实体（缺少 TaskID + 文件路径 + Story 标签）
+- T001 [US1] 创建 Entity（缺少复选框 + 精确文件路径）
+- [ ] T001 [US1] 创建 Entity（缺少文件路径）
+- [ ] T010 [US1] 实现提交预测单 Service 方法（故事阶段内未先写 [TDD] 测试，违反 TDD 规则）
+- [ ] T020 [TDD] [US1] 测试提交（描述模糊，文件路径缺失）
+```
+
+---
+
+## ECP 三模块路径约定
+
+> 来源：CLAUDE.md §"Repository Overview" + 设计文档 §1.2（模块定位）
+
+ECP 后端采用 Maven 三模块结构，所有文件路径从服务根目录开始：
+
+```
+{port}-{service}/                        # 服务根目录，如 3103-sales-forecast/
+├── {port}-{service}-api/                # 契约层：Feign Client 接口 + DTO
+│   └── src/main/java/com/sie/gushen/{service}/api/
+│       ├── client/                             # @FeignClient 接口
+│       └── dto/                                # DTO（extends ReqeustCommonDataBean，注意平台拼写）
+├── {port}-{service}-model/              # 数据层：Entity + DAO + XML + Ro
+│   ├── src/main/java/com/sie/gushen/{service}/model/
+│   │   ├── entity/                             # Entity（extends BaseEntity<T>）
+│   │   │   └── readonly/                       # Ro（implements Serializable）
+│   │   └── dao/                                # DAO 接口 + MyBatis XML 同包
+│   └── src/main/resources/liquibase/mysql/{service}/   # Liquibase
+└── {port}-{service}-application/         # 实现层：Service + Controller + Config + Consumer + i18n
+    ├── src/main/java/com/sie/gushen/{service}/
+    │   ├── {Service}Application.java            # 启动类（extends CommonApplication）
+    │   ├── api/controller/                      # Controller（extends CommonAbstractService）
+    │   ├── model/service/                       # Service 接口（II{Entity}）+ 实现（extends BaseCommonServer）
+    │   ├── app/consume/                         # Kafka Consumer
+    │   └── infra/
+    │       ├── config/                          # DataSource / MybatisPlus / SpringDoc
+    │       ├── constant/                        # ResponseMsgCode 常量
+    │       ├── enumeration/                     # 枚举类
+    │       ├── interceptor/                     # @CheckToken 拦截器
+    │       └── utils/                           # 工具类
+    └── src/main/resources/config/               # i18n 7 文件
+```
+
+**变量替换**：
+- `{port}`：微服务端口号，如 `3103`
+- `{service}`：服务名（kebab-case），如 `sales-forecast`
+- 包路径中转化为 camelCase：`com.sie.gushen.[camelService]`，如 `com.sie.gushen.salesforecast`
+
+---
+
+## ECP 任务类型速查表
+
+> 每个任务描述中必须包含正确的 ECP 父类/接口/注解。此表同时作为 `adspecs-tasks` skill 生成任务时的文件路径映射。
+
+| 任务类型 | ECP 父类/接口 | 关键注解/约定 | 所在模块 | 文件路径模式 |
+|---------|--------------|-------------|---------|-------------|
+| **Entity** | `extends BaseEntity<Entity>` | `@TableName(``table``)`, `@TableId(type=ASSIGN_ID)`, 所有字段 `@TableField` + `@Schema` | `-model` | `model/entity/XxxEntity.java` |
+| **DTO** | `extends ReqeustCommonDataBean` | 校验分组内部接口（`saveXxx`/`updateXxx`），日期 `@JSONField(format="yyyy-MM-dd HH:mm:ss")`，消息码 `{port}_{table}_{三位序号}` | `-api` | `api/dto/XxxDto.java` |
+| **Ro** | `implements Serializable` | `serialVersionUID`, 手动声明所有字段, `@Schema`, 日期 `@DateTimeFormat @JsonFormat` | `-model` | `model/entity/readonly/XxxRo.java` |
+| **DAO 接口** | `extends BaseCommonDAO_HI<Entity>` | `@Component("xxxDAO")` | `-model` | `model/dao/XxxDAO.java` |
+| **DAO XML** | — | `resultMap` 含所有字段+审计字段, `Base_Column_List`, `WHERE delete_flag=0`, 禁止 QueryWrapper | `-model` | `model/dao/XxxDAO.xml`（同包路径） |
+| **Service 接口** | `extends IBaseCommon<Entity>` | 命名 `II{Entity}`（双I前缀） | `-application` | `model/service/IIXxx.java` |
+| **Service 实现** | `extends BaseCommonServer<Entity>` | `@Component("xxxService")`, `@Autowired`, Save→FastJSON, Update→SpringBeanUtils, 异常在Service抛出 | `-application` | `model/service/impl/XxxService.java` |
+| **Controller** | `extends CommonAbstractService` | `@Tag`, `@RestController`, `@RequestMapping("/xxx")`, 重写 `getBaseCommonServer()`, 所有端点 `@CheckToken` | `-application` | `api/controller/XxxController.java` |
+| **Feign Client** | `@FeignClient` 接口 | 放入 `-api/client/` | `-api` | `api/client/XxxClient.java` |
+| **枚举** | 普通 `enum` | 存储值 `String`, `infra/enumeration/` | `-application` | `infra/enumeration/XxxEnum.java` |
+| **消息码** | `enum ResponseMsgCode` | 格式 `{port}_{table}_{三位序号}`, 字段校验 001~005, 业务异常 006+ | `-application` | `infra/constant/ResponseMsgCode.java` |
+| **Kafka Consumer** | `@Configuration` + `Consumer<String>` Bean | Bean name 必须匹配 YAML 中 `spring.cloud.stream.function.definition` | `-application` | `app/consume/XxxConsumer.java` |
+| **i18n** | 7 个 `.properties` | default/zh_CN/zh_TW/en_US/vi_VN/th_TH/hu_HU，每个文件含该语言实际内容 | `-application` | `resources/config/{port}-{service}-application[_locale].properties` |
+| **Liquibase** | 3 文件 | master.xml → version.xml → DDL.sql | `-model` | `resources/liquibase/mysql/{service}/` |
+| **工具类** | 普通 `class` | Hutool 优先, SLF4J 日志 | `-application` | `infra/utils/XxxUtils.java` |
+| **配置类** | `@Configuration` | DataSourceConfig / MybatisPlusConfig（分页+乐观锁）/ SpringDocConfig | `-application` | `infra/config/XxxConfig.java` |
+| **启动类** | `extends CommonApplication` | `@SpringBootApplication`, `@EnableDiscoveryClient`, `@EnableFeignClients`, `@MapperScan`, `@ComponentScan` | `-application` | `{Service}Application.java` |
+
+---
+
+<!--
+  ============================================================================
+  重要提示：以下任务是**模板示例**，展示了 ECP 平台使用 M06-01 销售预测单的真实类名和路径。
+
+  /adspecs-tasks 命令将根据以下内容替换为实际任务：
+  - 系统设计文档 §1.1.1 中的用户故事（及其优先级 P1、P2...）
+  - 系统设计文档 §2 中的实体/DTO/Ro 清单
+  - 系统设计文档 §3 中的数据模型与 MyBatis 映射
+  - 系统设计文档 §4 中的 Service 方法与业务行为
+  - 系统设计文档 §5 中的 Controller 端点
+  - 系统设计文档 §6 中的枚举定义
+  - 系统设计文档 §7 中的异常与消息码
+  - 系统设计文档 §13 中的完整目录树（~45 文件）
+
+  每个生成的任务必须：
+  - 包含精确的 ECP 三模块文件路径
+  - 遵循 TDD 测试先行顺序（[TDD] 标记的任务在实现任务之前）
+  - 包含正确的 ECP 父类/接口（见 §ECP 任务类型速查表）
+  - 通过 §ECP 编码规范检查清单 的 10 条校验
+  ============================================================================
+-->
+
+---
+
+## Phase 1：环境搭建（共享基础设施）
+
+**目的**：Maven 三模块项目初始化与基础结构搭建
+
+- [ ] T001 创建 Maven 三模块 parent POM（`com.sie.irradiator:sie-irradiator:3.0.2`），定义 `{port}-{service}-api` / `{port}-{service}-model` / `{port}-{service}-application` 三个 module，文件：
+      `{port}-{service}/pom.xml`
+- [ ] T002 [P] 创建 `{port}-{service}-api` 模块 POM + 目录结构（`com/sie/gushen/{service}/api/client/`, `api/dto/`），文件：
+      `{port}-{service}-api/pom.xml`
+- [ ] T003 [P] 创建 `{port}-{service}-model` 模块 POM + 目录结构（`model/entity/`, `model/entity/readonly/`, `model/dao/`），文件：
+      `{port}-{service}-model/pom.xml`
+- [ ] T004 [P] 创建 `{port}-{service}-application` 模块 POM + 目录结构（`api/controller/`, `model/service/impl/`, `infra/config/`, `infra/constant/`, `infra/enumeration/`, `infra/utils/`, `app/consume/`），文件：
+      `{port}-{service}-application/pom.xml`
+- [ ] T005 创建启动类 `{Service}Application`（`extends CommonApplication`，注解 `@SpringBootApplication`（排除 DataSource/HibernateJpa）、`@EnableDiscoveryClient`、`@EnableFeignClients`、`@MapperScan`、`@ComponentScan`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/{Service}Application.java`
+- [ ] T006 [P] 创建 `application.yml` 基础配置（server.port、spring.datasource、mybatis-plus.mapper-locations、spring.cloud.stream 等），文件：
+      `{port}-{service}-application/src/main/resources/application.yml`
+
+**检查点**：Maven 三模块结构就绪，`mvn clean compile` 可通过
+
+---
+
+## Phase 2：基础设施（阻塞性前置依赖）
+
+**目的**：枚举、消息码、数据库 DDL、基础配置等被所有用户故事依赖的底层构件
+
+**⚠️ 关键**：在此阶段完成之前，不得开始任何用户故事的工作
+
+### 2.1 枚举类（所有枚举可并行创建）
+
+- [ ] T007 [P] 创建 `ForecastOrderStatusEnum`（9 状态：DRAFT/SUBMITTED/REJECTED/ACCEPTED/SCHEDULED/PARTIAL_CONVERTED/FULLY_CONVERTED/RELEASED/CANCELLED），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/ForecastOrderStatusEnum.java`
+- [ ] T008 [P] 创建 `ChangeOrderStatusEnum`（5 状态：DRAFT/SUBMITTED/REJECTED/CHANGED/VOIDED），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/ChangeOrderStatusEnum.java`
+- [ ] T009 [P] 创建 `DomesticForeignEnum`（DOMESTIC 内销 / FOREIGN 外销），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/DomesticForeignEnum.java`
+- [ ] T010 [P] 创建 `ProductTypeEnum`（STANDARD 标品 / NON_STANDARD 非标），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/ProductTypeEnum.java`
+- [ ] T011 [P] 创建 `TransferStatusEnum`（PENDING 待转单 / TRANSFERRED 已转单 / RELEASED 已释放），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/TransferStatusEnum.java`
+- [ ] T012 [P] 创建 `QuantityUnitEnum`（KG 公斤 / TON 吨），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/QuantityUnitEnum.java`
+- [ ] T013 [P] 创建 `DeliveryLocationEnum`（SHANGHAI 上海 / CHONGQING 重庆），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/enumeration/DeliveryLocationEnum.java`
+
+### 2.2 消息码与配置
+
+- [ ] T014 创建 `ResponseMsgCode` 枚举常量类（字段校验 001~005 + 业务异常 006~017，消息码格式 `{port}_{table}_{三位序号}`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/constant/ResponseMsgCode.java`
+- [ ] T015 [P] 创建 `MybatisPlusConfig`（分页插件 `PaginationInnerInterceptor` + 乐观锁插件 `OptimisticLockerInnerInterceptor`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/config/MybatisPlusConfig.java`
+- [ ] T016 [P] 创建 `DataSourceConfig`（数据源配置），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/config/DataSourceConfig.java`
+- [ ] T017 [P] 创建 `SpringDocConfig`（API 文档配置），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/config/SpringDocConfig.java`
+- [ ] T018 创建工具类 `ForecastUtils`（强制转FO时间计算：`requiredWarehouseDate - N天`；提报提前期校验：`requiredWarehouseDate >= now + leadTimeDays`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/infra/utils/ForecastUtils.java`
+
+### 2.3 Liquibase 数据库迁移
+
+- [ ] T019 创建 Liquibase `master.xml`（入口文件，引用版本 XML），文件：
+      `{port}-{service}-model/src/main/resources/liquibase/mysql/{service}/master.xml`
+- [ ] T020 创建 Liquibase `v1.0.xml`（版本变更日志，包含 changeSet），文件：
+      `{port}-{service}-model/src/main/resources/liquibase/mysql/{service}/v1.0.xml`
+- [ ] T021 创建 DDL SQL（`forecast_order` 表 35+ 字段 + 6 索引 + `forecast_change_order` 表 20+ 字段 + 3 索引，含全部审计字段），文件：
+      `{port}-{service}-model/src/main/resources/liquibase/mysql/{service}/ddl/DDL_1.0_YYYYMMDD.sql`
+
+**检查点**：基础设施就绪——所有枚举可编译，Liquibase DDL 可执行建表，现在可以并行开始用户故事的 TDD 实现
+
+---
+
+## Phase 3：US-01 — 创建并提报预测单（优先级：P1）🎯 MVP 起点
+
+**目标**：销售人员能针对某客户某物料创建预测单，填写 CTCT 编码（自动回填物料+客户信息）、销售需求量、要求成品入库时间，保存草稿或提交至计划部门评审
+
+**独立测试**：登录销售人员账号 → 输入 CTCT 编码 → 填写需求量 5000kg + 入库时间 +35 天 → 点击提交 → 验证预测单进入"已提交"状态且生成单号
+
+**来源**：设计文档 §1.1.1 US-01, §4.1 行为 1-2, §5.1 端点 1-7, §12.1 TC1, §12.2 TC1
+
+### 用户故事 1 的 TDD 测试（先写，确保失败后再实现）
+
+> ⚠️ **TDD 铁律**：在编写任何实现代码之前，先编写以下测试并验证它们**因功能缺失而失败**。
+
+- [ ] T022 [TDD] [US1] 编写 `ForecastOrderService` 提交预测单测试（正常场景：CTCT 有效，需求量 5000kg，入库时间+35 天 → 状态=已提交，生成单号），测试文件：
+      `{port}-{service}-application/src/test/java/com/sie/gushen/{service}/model/service/impl/ForecastOrderServiceTest.java`
+- [ ] T023 [TDD] [P] [US1] 编写 `ForecastOrderService` 提交预测单异常测试（提报提前期不满足 → 抛出 `GushenRuntimeException("3103_forecast_order_007")`），测试文件：同上
+- [ ] T024 [TDD] [P] [US1] 编写 `ForecastOrderService` 提交预测单边界测试（需求量=MOQ 正常通过；需求量<MOQ 警告但通过；保税手册余量不足 → 抛出异常），测试文件：同上
+- [ ] T025 [TDD] [P] [US1] 编写 `ForecastOrderService` 保存草稿测试（部分字段可空，状态=草稿，单号=null），测试文件：同上
+- [ ] T026 [TDD] [US1] 编写 `ForecastOrderController` 保存/提交端点集成测试（POST `/forecast-order/save` → 200 + 草稿返回；POST `/forecast-order/submit` → 200 + 已提交），测试文件：
+      `{port}-{service}-application/src/test/java/com/sie/gushen/{service}/api/controller/ForecastOrderControllerTest.java`
+
+### 用户故事 1 的实现（测试验证失败后开始）
+
+- [ ] T027 [US1] 创建 `ForecastOrderEntity`（`extends BaseEntity<ForecastOrderEntity>`, `@TableName(``forecast_order``)`, `@TableId(type=ASSIGN_ID)`, 35+ 字段全带 `@TableField` + `@Schema`），文件：
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/entity/ForecastOrderEntity.java`
+- [ ] T028 [P] [US1] 创建 `ForecastOrderDto`（`extends ReqeustCommonDataBean`，含 `saveForecastOrder`/`updateForecastOrder` 校验分组内部接口，日期 `@JSONField(format="yyyy-MM-dd HH:mm:ss")`），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/dto/ForecastOrderDto.java`
+- [ ] T029 [P] [US1] 创建 `ForecastOrderEntityRo`（`implements Serializable` + `serialVersionUID`，手动声明所有 Entity 字段 + 审计字段 + `List<ForecastChangeOrderEntity> forecastChangeOrderList`），文件：
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/entity/readonly/ForecastOrderEntityRo.java`
+- [ ] T030 [US1] 创建 `ForecastOrderDAO` 接口 + `ForecastOrderDAO.xml`（`extends BaseCommonDAO_HI<ForecastOrderEntity>`, `@Component("forecastOrderDAO")`, `BaseResultMap` 含全字段+审计, `Base_Column_List`, `BASE_QUERY_CONDITION` 支持多条件筛选, `findPagination` 含 `WHERE delete_flag=0`），文件：
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/dao/ForecastOrderDAO.java`
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/dao/ForecastOrderDAO.xml`
+- [ ] T031 [US1] 创建 `IIForecastOrder` Service 接口（`extends IBaseCommon<ForecastOrderEntity>`，定义 `saveForecastOrder`/`updateForecastOrder`/`submitForecastOrder`/`findById`/`findPagination` 方法签名），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/model/service/IIForecastOrder.java`
+- [ ] T032 [US1] 实现 `ForecastOrderService`（`extends BaseCommonServer<ForecastOrderEntity>`, `@Component("forecastOrderService")`, `@Autowired ForecastOrderDAO`）：
+  - `saveForecastOrder(dto)`：FastJSON `JSONObject.parseObject(JSONObject.toJSONString(dto), Entity.class)`，设置初始状态 DRAFT，transferredQty=0
+  - `updateForecastOrder(dto)`：校验仅草稿/已驳回可编辑 → Spring `BeanUtils.copyProperties(dto, entity, "createdBy", "creationDate", "versionNum")`
+  - `submitForecastOrder(id)`：BR-01 提报提前期校验（拦截）→ BR-02 MOQ 校验（警告）→ `AutoCodeRuleService.generate` 生成单号 → 状态→已提交 → 计算 forceFoDate
+  - `findById(id)`：含变更单子表列表组装 ForecastOrderEntityRo
+  - `findPagination(dto, pageIndex, pageRows, orderByBean)`：`BeanUtil.beanToMap` → `Condition.getPage` → DAO 分页查询
+  文件：`{port}-{service}-application/src/main/java/com/sie/gushen/{service}/model/service/impl/ForecastOrderService.java`
+- [ ] T033 [US1] 创建 `ForecastOrderController`（`extends CommonAbstractService`, `@Tag`, `@RestController`, `@RequestMapping("/forecast-order")`, 重写 `getBaseCommonServer()`, `@Autowired IIForecastOrder`）：
+  - `GET /get-id` → `forecastOrderService.findById(id)`
+  - `POST /find-pagination` → `forecastOrderService.findPagination(dto, pageIndex, pageRows, orderByBean)`
+  - `POST /save` → 参数空校验 → `forecastOrderService.saveForecastOrder(dto)`
+  - `POST /update` → 参数空校验 → `forecastOrderService.updateForecastOrder(dto)`（仅草稿/已驳回）
+  - `POST /submit` → `forecastOrderService.submitForecastOrder(id)`
+  文件：`{port}-{service}-application/src/main/java/com/sie/gushen/{service}/api/controller/ForecastOrderController.java`
+- [ ] T034 [US1] 创建 `CtctClient` Feign 接口（`@FeignClient`, `GET /p01/ctct/query?ctctCode={code}` → CTCT物料+客户聚合信息），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/client/CtctClient.java`
+
+**检查点**：[TDD] 所有测试由红变绿，用户故事 1 可独立运行：创建草稿 → 填写完整 → 提交 → 生成单号 → 状态=已提交
+
+---
+
+## Phase 4：US-02 — 计划部门评审预测单（优先级：P1）
+
+**目标**：计划部门人员查看已提交的预测单，执行接收（填写计划建议量、答复入库时间、答复意见）或驳回（填写驳回原因）
+
+**独立测试**：登录计划部门人员账号 → 进入待评审列表 → 对一条预测单执行"接收"并填写答复 → 验证状态变更为"计划接收"；对另一条执行"驳回" → 验证状态变更为"已驳回"
+
+**来源**：设计文档 §1.1.1 US-02, §4.1 行为 4-5, §5.1 端点 9-10, §12.1 TC1
+
+### 用户故事 2 的 TDD 测试
+
+- [ ] T035 [TDD] [US2] 编写 `ForecastOrderService` 接收预测单测试（状态=已提交 → 填写答复 → 状态=计划接收，记录 replyTime），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T036 [TDD] [P] [US2] 编写 `ForecastOrderService` 驳回预测单测试（状态=已提交 → 填写驳回原因 → 状态=已驳回），测试文件：同上
+- [ ] T037 [TDD] [P] [US2] 编写 `ForecastOrderService` 评审状态校验测试（非已提交状态 → 抛出 `GushenRuntimeException("3103_forecast_order_013")`），测试文件：同上
+- [ ] T038 [TDD] [US2] 编写 `ForecastOrderController` 接收/驳回端点集成测试（POST `/forecast-order/accept` → 200；POST `/forecast-order/reject` → 200），测试文件：同 ForecastOrderControllerTest.java
+
+### 用户故事 2 的实现
+
+- [ ] T039 [US2] 扩展 `IIForecastOrder` 接口：新增 `acceptForecastOrder(id, dto)` / `rejectForecastOrder(id, dto)` 方法签名
+- [ ] T040 [US2] 扩展 `ForecastOrderService`：
+  - `acceptForecastOrder(id, dto)`：校验状态=已提交 → 设置 planSuggestQty/replyWarehouseDate/replyComment/replyTime → 状态→计划接收
+  - `rejectForecastOrder(id, dto)`：校验状态=已提交 → 设置 replyComment → 状态→已驳回
+- [ ] T041 [US2] 扩展 `ForecastOrderController`：
+  - `POST /accept` → `forecastOrderService.acceptForecastOrder(id, dto)`
+  - `POST /reject` → `forecastOrderService.rejectForecastOrder(id, dto)`
+
+**检查点**：计划部门可接收/驳回预测单，TDD 测试红→绿
+
+---
+
+## Phase 5：US-09 + US-08 — 撤回/取消/删除预测单（优先级：P1+P2）
+
+**目标**：销售人员撤回已提交/计划接收（未排产）的预测单；取消有单号草稿/已驳回预测单；物理删除无单号草稿
+
+**独立测试**：已提交预测单 → 撤回 → 状态=草稿；有单号草稿 → 取消 → 状态=取消；无单号草稿 → 删除 → 物理删除
+
+**来源**：设计文档 §1.1.1 US-08+US-09, §4.1 行为 3+9+10, §5.1 端点 5+7+8, §12.2 TC2
+
+### 用户故事 5 的 TDD 测试
+
+- [ ] T042 [TDD] [US5] 编写撤回预测单测试（已提交→草稿、计划接收未排产→草稿），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T043 [TDD] [P] [US5] 编写撤回阻止测试（已排产→抛出 `GushenRuntimeException("3103_forecast_order_010")`），测试文件：同上
+- [ ] T044 [TDD] [P] [US5] 编写取消/删除测试（有单号草稿→取消终态；无单号草稿→物理删除；有单号不可物理删除→异常），测试文件：同上
+
+### 用户故事 5 的实现
+
+- [ ] T045 [US5] 扩展 `ForecastOrderService`：
+  - `withdrawForecastOrder(id)`：状态=已提交→草稿；状态=计划接收且 scheduleConfirmTime=null→草稿；否则抛异常
+  - `cancelForecastOrder(id)`：状态∈{草稿(有单号), 已驳回}→取消终态
+  - `deleteForecastOrder(id)`：状态=草稿且单号=null→物理删除；否则抛出 `GushenRuntimeException("3103_forecast_order_016")`
+- [ ] T046 [US5] 扩展 `ForecastOrderController`：
+  - `POST /withdraw` → `forecastOrderService.withdrawForecastOrder(id)`
+  - `POST /cancel` → `forecastOrderService.cancelForecastOrder(id)`
+  - `GET /delete` → `forecastOrderService.deleteForecastOrder(id)`
+
+**检查点**：撤回/取消/删除功能正常，TDD 测试红→绿
+
+---
+
+## Phase 6：US-04 — 预测单转履约单（FO）（优先级：P1）
+
+**目标**：销售人员将已排产（全部或部分）预测单数量转为 FO，全部转完自动关闭
+
+**独立测试**：已排产待转单 → 选择 SO 行项目 → 输入转单量 5000kg → 全部转单 → 状态=已全部转单完成
+
+**来源**：设计文档 §1.1.1 US-04, §4.1 行为 7, §5.1 端点 12, §12.1 TC1
+
+### 用户故事 4 的 TDD 测试
+
+- [ ] T047 [TDD] [US4] 编写转 FO 测试（全部转：状态→已全部转单完成+剩余归零；部分转：状态→已部分转单+剩余扣减），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T048 [TDD] [P] [US4] 编写转 FO 异常测试（转单量>剩余→异常、状态非法→异常），测试文件：同上
+- [ ] T049 [TDD] [US4] 编写转 FO 端点集成测试（POST `/forecast-order/transfer-to-fo` → 200），测试文件：同 ForecastOrderControllerTest.java
+
+### 用户故事 4 的实现
+
+- [ ] T050 [P] [US4] 创建 `TransferToFoDto`（`extends ReqeustCommonDataBean`，字段：forecastOrderId + soLineItemId + transferQty），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/dto/TransferToFoDto.java`
+- [ ] T051 [US4] 扩展 `ForecastOrderService.transferToFO(dto)`：校验状态∈{已排产待转单,已部分转单} → 校验转单量≤剩余 → Feign 调用 FO 模块创建 → 更新 transferredQty/remainingQty/状态
+- [ ] T052 [US4] 创建 `FoClient` Feign 接口（`POST /fo/create` → 返回 foOrderNo），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/client/FoClient.java`
+- [ ] T053 [P] [US4] 创建 `SoClient` Feign 接口（SO 行项目查询），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/client/SoClient.java`
+- [ ] T054 [US4] 扩展 `ForecastOrderController`：`POST /transfer-to-fo` → `forecastOrderService.transferToFO(dto)`
+
+**检查点**：转 FO 功能正常，Feign 联调通过，TDD 测试红→绿
+
+---
+
+## Phase 7：US-03 — 查看 APS 排产反馈信息（优先级：P1）
+
+**目标**：APS 系统排产完成后通知本模块（状态→已排产待转单）；销售人员在详情页查看排产进度
+
+**独立测试**：模拟 APS 发送排产确认通知 → 状态变更为"已排产待转单"→ 详情页展示排产进度
+
+**来源**：设计文档 §1.1.1 US-03, §4.1 行为 6, §5.1 端点 11, §9.2 消费事件, §12.1 TC1
+
+### 用户故事 3 的 TDD 测试
+
+- [ ] T055 [TDD] [US3] 编写 APS 排产确认测试（状态=计划接收 → 收到通知 → 状态=已排产待转单，乐观锁校验），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T056 [TDD] [P] [US3] 编写排产确认并发冲突测试（撤回与排产确认竞争 → version_num 冲突 → 后到者拒绝），测试文件：同上
+
+### 用户故事 3 的实现
+
+- [ ] T057 [P] [US3] 创建 `ScheduleConfirmDto`（字段：forecastOrderNo + confirmTime），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/dto/ScheduleConfirmDto.java`
+- [ ] T058 [US3] 扩展 `ForecastOrderService.scheduleConfirm(forecastOrderNo, confirmTime)`：查询 → 校验状态=计划接收 → 乐观锁 version_num → 状态→已排产待转单 → 记录 scheduleConfirmTime
+- [ ] T059 [US3] 扩展 `ForecastOrderController`：`POST /schedule-confirm` → `forecastOrderService.scheduleConfirm(dto.getForecastOrderNo(), dto.getConfirmTime())`
+- [ ] T060 [P] [US3] 创建 `ApsScheduleConfirmConsumer`（如果采用 Kafka 入站，`@Configuration`, `Consumer<String>` Bean，Bean name 匹配 `spring.cloud.stream.function.definition`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/app/consume/ApsScheduleConfirmConsumer.java`
+- [ ] T061 [P] [US3] 创建 `ApsClient` Feign 接口（`GET /aps/schedule/progress?forecastOrderNo={no}` → 排产进度），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/client/ApsClient.java`
+
+**检查点**：APS 排产确认通知 → 状态变更；详情页展示排产进度
+
+---
+
+## Phase 8：US-05 — 通过变更单修改预测单（优先级：P1）
+
+**目标**：对已排产预测单发起变更申请（客户/入库时间/保税手册/释放资源），提交流程审批，审批通过后联动更新预测单字段
+
+**独立测试**：已排产预测单 → 新增变更单填写变更后入库时间 → 提交 → 审批通过 → 验证预测单入库时间联动更新
+
+**来源**：设计文档 §1.1.1 US-05, §4.1 行为 13-18, §5.1 端点 15-23, §12.2 TC4-5
+
+### 用户故事 8 的 TDD 测试
+
+- [ ] T062 [TDD] [US8] 编写变更单新增+审批通过联动测试（库时间变更→预测单入库时间更新；客户变更→客户信息联动；释放资源→需求量扣减+剩余重算），测试文件：
+      `{port}-{service}-application/src/test/java/com/sie/gushen/{service}/model/service/impl/ForecastChangeOrderServiceTest.java`
+- [ ] T063 [TDD] [P] [US8] 编写变更单异常测试（并发控制→异常、CTCT校验失败→异常、非标释放→异常、释放量超限→异常、手册余量不足→异常），测试文件：同上
+- [ ] T064 [TDD] [P] [US8] 编写变更单审批驳回测试（已提交→已驳回；驳回后可重新编辑提交），测试文件：同上
+- [ ] T065 [TDD] [US8] 编写变更单删除/作废测试（草稿→物理删除；已提交→仅可作废不可物理删除），测试文件：同上
+
+### 用户故事 8 的实现
+
+- [ ] T066 [US8] 创建 `ForecastChangeOrderEntity`（`extends BaseEntity<ForecastChangeOrderEntity>`, `@TableName(``forecast_change_order``)`, 20+ 字段含快照字段+变更字段+审批字段），文件：
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/entity/ForecastChangeOrderEntity.java`
+- [ ] T067 [P] [US8] 创建 `ForecastChangeOrderDto`（`extends ReqeustCommonDataBean`，含 `saveForecastChangeOrder`/`updateForecastChangeOrder` 分组，按需填写字段），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/dto/ForecastChangeOrderDto.java`
+- [ ] T068 [P] [US8] 创建 `ApproveDto`（`extends ReqeustCommonDataBean`，字段：changeOrderId + approvalComment），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/dto/ApproveDto.java`
+- [ ] T069 [US8] 创建 `ForecastChangeOrderDAO` 接口 + XML（`extends BaseCommonDAO_HI`, `@Component`, `findListByForecastOrderId` + `findIncompleteByForecastOrderId`，含 `WHERE delete_flag=0`），文件：
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/dao/ForecastChangeOrderDAO.java`
+      `{port}-{service}-model/src/main/java/com/sie/gushen/{service}/model/dao/ForecastChangeOrderDAO.xml`
+- [ ] T070 [US8] 创建 `IIForecastChangeOrder` Service 接口（`extends IBaseCommon<ForecastChangeOrderEntity>`），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/model/service/IIForecastChangeOrder.java`
+- [ ] T071 [US8] 实现 `ForecastChangeOrderService`（`extends BaseCommonServer<ForecastChangeOrderEntity>`, `@Component`）：
+  - `saveForecastChangeOrder(dto)`：BR-10 并发控制 → 自动快照原始预测单信息 → 状态=DRAFT
+  - `submitForecastChangeOrder(id)`：BR-05 CTCT校验 / BR-12 手册余量 / BR-13 释放量≤剩余 / BR-03 非标不可释放 → 生成单号 → 状态=已提交
+  - `approveForecastChangeOrder(id, comment)`：状态=已提交 → **原子操作**：变更单状态+预测单联动更新（入库时间/客户/手册/释放量）
+  - `rejectForecastChangeOrder(id, comment)`：状态=已提交 → 状态=已驳回
+  - `withdrawForecastChangeOrder(id)`：状态=已提交 → 状态=草稿
+  - `voidForecastChangeOrder(id)`：状态∈{草稿,已提交,已驳回} → 状态=已作废
+  - `deleteForecastChangeOrder(id)`：状态∈{草稿,已驳回} → 物理删除
+  文件：`{port}-{service}-application/src/main/java/com/sie/gushen/{service}/model/service/impl/ForecastChangeOrderService.java`
+- [ ] T072 [US8] 创建 `ForecastChangeOrderController`（`extends CommonAbstractService`, `@RequestMapping("/forecast-change-order")`, 9 个端点），文件：
+      `{port}-{service}-application/src/main/java/com/sie/gushen/{service}/api/controller/ForecastChangeOrderController.java`
+- [ ] T073 [P] [US8] 创建 `BondedManualClient` Feign 接口（P03 保税手册查询），文件：
+      `{port}-{service}-api/src/main/java/com/sie/gushen/{service}/api/client/BondedManualClient.java`
+
+**检查点**：变更单全流程通过——新增→提交→审批通过→预测单联动更新，原子操作验证通过
+
+---
+
+## Phase 9：US-06 + US-07 — 多维度概览 + 强制释放（优先级：P2）
+
+**目标**：提供按时间/客户/品种维度的预测单概览视图；定时任务对标品超期未转单自动强制释放
+
+**来源**：设计文档 §1.1.1 US-06+US-07, §4.1 行为 11-12, §5.1 端点 13-14
+
+### 用户故事 9 的 TDD 测试
+
+- [ ] T074 [TDD] [US9] 编写概览聚合查询测试（按时间/客户/品种维度查询 → 返回聚合数据），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T075 [TDD] [P] [US9] 编写强制释放测试（标品+超期+已排产待转单+已转单=0→状态=已释放；已转单>0→状态=已全部转单完成；非标不触发），测试文件：同上
+
+### 用户故事 9 的实现
+
+- [ ] T076 [US9] 扩展 `ForecastOrderDAO.xml`：新增 `findOverview` 聚合查询 SQL（GROUP BY + 聚合函数）
+- [ ] T077 [US9] 扩展 `ForecastOrderService`：
+  - `findOverview(params)`：调用 DAO 聚合查询
+  - `forceRelease()`：查询标品+超期+状态∈{已排产待转单,已部分转单} → 已转单>0→已全部转单完成；已转单=0→已释放
+- [ ] T078 [US9] 扩展 `ForecastOrderController`：
+  - `POST /overview` → `forecastOrderService.findOverview(params)`
+  - `POST /force-release` → `forecastOrderService.forceRelease()`（系统级 Token）
+
+**检查点**：概览视图可用，强制释放定时任务可触发
+
+---
+
+## Phase 10：US-10 — 系统配置管理（优先级：P2）
+
+**目标**：系统管理员配置提报提前期天数（1~365）和强制转FO天数 N（1~90），Redis 缓存加速
+
+**来源**：设计文档 §1.1.1 US-10, §8.1 缓存策略
+
+- [ ] T079 [TDD] [US10] 编写配置读写测试（读取缓存命中 → 返回；写入 → 双写 Redis+DB），测试文件：同 ForecastOrderServiceTest.java
+- [ ] T080 [US10] 扩展 `ForecastOrderService`：`getLeadTimeConfig()` + `updateLeadTimeConfig(days)` / `getForceFoDaysConfig()` + `updateForceFoDaysConfig(days)`（通过 `ServerConfigConmonUtil` + `DawnRedis` 实现）
+- [ ] T081 [US10] 扩展 `ForecastOrderController`：配置管理端点
+
+---
+
+## Final Phase：集成与收尾
+
+**目的**：跨故事的质量保证、国际化、文档与合规验证
+
+### 集成测试
+
+- [ ] T082 [TDD] 编写端到端集成测试（创建→提交→接收→排产确认→转FO 全流程），文件：
+      `{port}-{service}-application/src/test/java/com/sie/gushen/{service}/integration/ForecastOrderE2ETest.java`
+- [ ] T083 [TDD] [P] 编写变更单审批联动端到端测试（变更入库时间→审批→预测单联动），文件：同上
+
+### i18n 国际化（7 文件）
+
+- [ ] T084 [P] 创建 `{port}-{service}-application.properties`（默认中文，Unicode 转义），含所有消息码（字段校验 001~005 + 业务异常 006~017），文件：
+      `{port}-{service}-application/src/main/resources/config/{port}-{service}-application.properties`
+- [ ] T085 [P] 创建 `{port}-{service}-application_zh_CN.properties`（简体中文），文件：同上目录
+- [ ] T086 [P] 创建 `{port}-{service}-application_zh_TW.properties`（繁体中文），文件：同上目录
+- [ ] T087 [P] 创建 `{port}-{service}-application_en_US.properties`（英文），文件：同上目录
+- [ ] T088 [P] 创建 `{port}-{service}-application_vi_VN.properties`（越南语），文件：同上目录
+- [ ] T089 [P] 创建 `{port}-{service}-application_th_TH.properties`（泰语），文件：同上目录
+- [ ] T090 [P] 创建 `{port}-{service}-application_hu_HU.properties`（匈牙利语），文件：同上目录
+
+### 代码评审与安全
+
+- [ ] T091 执行 ECP 编码规范 10 条合规检查（对照 §ECP 编码规范检查清单，逐条确认）
+- [ ] T092 安全清单验证（所有端点 `@CheckToken`、权限矩阵 §5.4 逐项检查、敏感操作二次确认、SQL 注入防范）
+- [ ] T093 代码评审（按 `.adspecs/templates/06-代码评审报告模板.md` 执行）
+
+### 文档与构建
+
+- [ ] T094 `mvn clean -U package` 构建验证（三模块编译通过 + 单元测试全绿）
+- [ ] T095 API 文档完善（SpringDoc 注解 → Swagger UI 可访问，按 `.adspecs/templates/03-系统设计模板.md` 中的 SpringDocConfig 配置）
+
+---
+
+## 依赖关系与执行顺序
+
+### 阶段依赖
+
+| 阶段 | 依赖 | 说明 |
+|------|------|------|
+| Phase 1（环境搭建） | 无 | 可立即开始 |
+| Phase 2（基础设施） | Phase 1 完成 | **阻塞所有用户故事** |
+| Phase 3（US-01 创建提报） | Phase 2 完成 | P1 MVP 起点，US-04/05/08/09 依赖其实体 |
+| Phase 4（US-02 评审） | Phase 2 + Phase 3 实体 | 可独立并行（不同 Service 方法，同一实体） |
+| Phase 5（US-09/08 撤回取消） | Phase 2 + Phase 3 实体 | 可独立并行 |
+| Phase 6（US-04 转FO） | Phase 2 + Phase 3 实体 | 依赖 ForecastOrderEntity |
+| Phase 7（US-03 排产） | Phase 2 + Phase 3 实体 | 可独立并行 |
+| Phase 8（US-05 变更） | Phase 2 + Phase 3 + 子表实体 | 依赖 ForecastOrderEntity + ForecastChangeOrderEntity |
+| Phase 9（US-06/07 概览释放） | Phase 2 + Phase 3 实体 | P2 优先级，可在 P1 完成后开始 |
+| Phase 10（US-10 配置） | Phase 2 | P2 优先级，与 P1 故事独立 |
+| Final Phase | 所有目标用户故事完成 | 集成测试需全功能就绪 |
+
+### 用户故事间依赖
+
+- **US-01（P1）**：Phase 3，创建 ForecastOrderEntity + Service + Controller，是所有 P1 故事的基础。**阻塞：无**
+- **US-02（P1）**：Phase 4，仅新增 Service 方法，可与 US-01 并行（同 Service 类，不同方法）。**阻塞：ForecastOrderEntity 创建完成**
+- **US-09+US-08（P1+P2）**：Phase 5，仅新增 Service 方法，可独立并行。**阻塞：ForecastOrderEntity + Service 基本方法完成**
+- **US-04（P1）**：Phase 6，新增 DTO + Feign Client + Service 方法。**阻塞：ForecastOrderEntity + Service**
+- **US-03（P1）**：Phase 7，新增 DTO + Consumer + Feign Client。**阻塞：ForecastOrderEntity + Service**
+- **US-05（P1）**：Phase 8，新增 Entity + DTO + DAO + Service + Controller，变更量最大。**阻塞：ForecastOrderEntity（主表）**
+- **US-06+US-07（P2）**：Phase 9，P2 可最后实现。**阻塞：P1 故事完成**
+- **US-10（P2）**：Phase 10，P2 独立于业务故事。**阻塞：Phase 2**
+
+### 每个用户故事内部的 TDD 执行顺序
+
+```
+[STOP] 确认 Phase 2 基础设施已就绪
+  ↓
+[TDD] 编写 Service 层单元测试（正常 + 异常 + 边界）→ mvn test → 确认失败 ❌
+  ↓
+[TDD] 编写 Controller 层集成测试 → mvn test → 确认失败 ❌
+  ↓
+创建 Entity（extends BaseEntity, @TableName, @TableField+@Schema, IdType.ASSIGN_ID）
+  ↓
+创建 DTO（extends ReqeustCommonDataBean, 校验分组, @JSONField）
+  ↓
+创建 Ro（implements Serializable, 手动字段, @Schema）
+  ↓
+创建 DAO 接口 + XML（extends BaseCommonDAO_HI, resultMap, Base_Column_List, WHERE delete_flag=0）
+  ↓
+创建 Service 接口 + 实现（Save→FastJSON, Update→SpringBeanUtils, 异常在Service抛出）
+  ↓
+创建 Controller（extends CommonAbstractService, @CheckToken, ResponseData 包装）
+  ↓
+创建 Feign Client（@FeignClient 接口，放入 -api/client/）
+  ↓
+[TDD] 重新运行测试 → mvn test → 全部通过 ✅
+  ↓
+[REFACTOR] 提取公共逻辑、优化命名、清理重复代码 → 保持测试绿
+```
+
+**并行加速**：标记 `[P]` 的 Entity/DTO/Ro/DAO 可同时创建（互不依赖），Service 实现必须在 DAO 完成后。
+
+### 并行机会
+
+- **Phase 2**：所有 7 个枚举类可并行创建（T007~T013）
+- **Phase 2**：Liquibase 3 文件可串行（依赖顺序），但与枚举/配置可并行
+- **Phase 2**：消息码与配置类可并行（T014~T018）
+- **Phase 3**：Entity + DTO + Ro 可并行（T027~T029），Service 接口+DAO 可并行（T030~T031）
+- **跨故事并行**：Phase 3~8 中，US-02/US-03/US-04/US-05/US-09 可在 US-01 Entity 完成后并行推进（各自独立的 Controller 方法或独立子表）
+- **Final Phase**：7 个 i18n 文件可完全并行（T084~T090）
+
+---
+
+## 并行示例：US-01 创建并提报预测单
+
+```bash
+# Step 1: 先编写所有测试（并行）→ 确保失败
+Task T022: "[TDD] 编写提交预测单测试（正常场景）"
+Task T023: "[TDD] 编写提交预测单异常测试（提前期拦截）"
+Task T024: "[TDD] 编写提交预测单边界测试（MOQ/手册余量）"
+Task T025: "[TDD] 编写保存草稿测试"
+Task T026: "[TDD] 编写 Controller 集成测试"
+
+# 所有测试验证失败后 ↓
+
+# Step 2: 并行创建 Entity + DTO + Ro（互不依赖）
+Task T027: "创建 ForecastOrderEntity.java"
+Task T028: "创建 ForecastOrderDto.java"
+Task T029: "创建 ForecastOrderEntityRo.java"
+
+# Step 3: 并行创建 DAO + Service 接口（都依赖 Entity）
+Task T030: "创建 ForecastOrderDAO.java + ForecastOrderDAO.xml"
+Task T031: "创建 IIForecastOrder.java"
+
+# Step 4: Service 实现（依赖 DAO + Service 接口）
+Task T032: "实现 ForecastOrderService.java"
+
+# Step 5: Controller + Feign Client 可并行
+Task T033: "创建 ForecastOrderController.java"
+Task T034: "创建 CtctClient.java"
+
+# 运行测试 → 全部通过 ✅
+```
+
+---
+
+## 实现策略
+
+### MVP 优先（P1 用户故事：US-01 + US-02 + US-09 + US-04 + US-03 + US-05）
+
+1. Phase 1：Maven 三模块环境搭建
+2. Phase 2：基础设施（枚举 + Liquibase + 消息码 + 配置）**← 关键阻塞点**
+3. Phase 3：US-01 创建并提报预测单 **← MVP 核心**
+4. Phase 4：US-02 计划部门评审（并行追加）
+5. Phase 5：US-09+US-08 撤回/取消/删除（并行追加）
+6. Phase 6：US-04 转履约单（FO）（并行追加）
+7. Phase 7：US-03 APS 排产反馈（并行追加）
+8. Phase 8：US-05 变更单修改预测单（并行追加）
+9. **STOP & VALIDATE**：全部 P1 故事端到端测试通过
+10. P1 MVP 就绪 → 部署/演示
+
+### 增量交付
+
+1. Phase 1+2 → 基础就绪
+2. Phase 3 → US-01 可独立测试 → 部署（MVP 最小可交付！）
+3. Phase 4+5+6+7+8 → 逐个追加 P1 故事 → 每个故事独立测试 → 增量部署
+4. Phase 9+10 → P2 故事追加
+5. Final Phase → 集成收尾
+
+### 团队并行策略
+
+1. 团队共同完成 Phase 1+2（环境搭建 + 基础设施）
+2. Phase 2 完成后：
+   - **开发者 A**：Phase 3（US-01 创建提报）**← 最高优先级，产出核心 Entity**
+   - **开发者 B**：Phase 2 的 Liquibase + 配置类
+3. US-01 Entity 完成后：
+   - **开发者 A**：Phase 8（US-05 变更单，子表工作量大）
+   - **开发者 B**：Phase 4+5+6+7（US-02/09/04/03，同一主表 Service 的不同方法）
+4. P1 全部完成 → 开发者 A+B 共同完成 Phase 9+10（P2 故事）+ Final Phase
+
+---
+
+## ECP 编码规范检查清单
+
+> 生成 tasks.md 时必须逐条确认。此清单与 `adspecs-tasks` skill §ECP 平台编码规范完全对齐。
+
+| # | 规范 | 检查项 | 通过 |
+|---|------|--------|------|
+| 1 | **Entity** | `extends BaseEntity<Entity>`, `@TableName(``table``)`, 所有字段 `@TableField` + `@Schema`, `IdType.ASSIGN_ID`，审计字段继承不重复 | ☐ |
+| 2 | **DTO** | `extends ReqeustCommonDataBean`（注意拼写），校验分组内部接口（`save/update`），`@JSONField(format)`，消息码格式 `{port}_{table}_{三位序号}` | ☐ |
+| 3 | **DAO** | `extends BaseCommonDAO_HI<Entity>`, `@Component("xxxDAO")`，XML 同包，`resultMap` 含全字段+审计，所有 SELECT 含 `WHERE delete_flag = 0` | ☐ |
+| 4 | **禁止 QueryWrapper** | 所有 DB 操作通过 MyBatis XML，任务描述中无 QueryWrapper/LambdaQueryWrapper 字样 | ☐ |
+| 5 | **Service** | 接口 `II{Entity}` extends `IBaseCommon<Entity>`，实现 `@Component("xxxService")` extends `BaseCommonServer<Entity>`, Save→FastJSON, Update→SpringBeanUtils | ☐ |
+| 6 | **Controller** | `extends CommonAbstractService`，重写 `getBaseCommonServer()`，`@CheckToken`, `ResponseData<T>` 包装 | ☐ |
+| 7 | **Ro** | `implements Serializable` + `serialVersionUID`，手动字段，`@DateTimeFormat @JsonFormat`，置于 `model/entity/readonly/` | ☐ |
+| 8 | **异常** | 异常在 Service 层抛出，Controller 仅参数空校验，消息码枚举禁止硬编码 | ☐ |
+| 9 | **i18n** | 7 个 `.properties`（default/zh_CN/zh_TW/en_US/vi_VN/th_TH/hu_HU），每个含该语言实际内容 | ☐ |
+| 10 | **注入与工具** | `@Autowired` 注入，FastJSON 序列化，Hutool 优先，SLF4J 日志 | ☐ |
+
+---
+
+## TDD 执行指南
+
+> 本模板任务顺序与 `test-driven-development` skill 的 RED→GREEN→REFACTOR 循环完全对齐。
+
+### RED 阶段：编写测试并验证失败
+
+```bash
+# 1. 按 [TDD] 标记的任务编写测试代码
+# 2. 运行并确认失败
+mvn test -Dtest=ForecastOrderServiceTest
+
+# 预期输出：Tests run: 5, Failures: 5（功能未实现，预期失败）
+# 如果测试通过 → 测试缺陷，修测试
+# 如果测试报错（非失败） → 编译错误/依赖缺失，修环境
+```
+
+### GREEN 阶段：最小代码使测试通过
+
+```
+按 TDD 任务之后的实现任务顺序：
+Entity → DTO → Ro → DAO+XML → Service → Controller → Feign Client
+
+每完成一个实现任务：
+mvn test -Dtest=ForecastOrderServiceTest  # 逐步变绿
+
+Service 实现完成后 → 全部测试应变绿 ✅
+```
+
+### REFACTOR 阶段：清理与优化
+
+```bash
+# 所有测试通过后：
+- 提取重复的校验逻辑到工具类
+- 优化命名（方法名/变量名与业务一致）
+- 添加日志注解（关键操作 @Slf4j）
+- 运行全量测试确认不破坏
+mvn test  # 必须全绿
+```
+
+---
+
+## 注意事项
+
+- `[P]` 任务 = 操作不同文件，无未完成依赖，可并行执行
+- `[TDD]` 任务 = 测试任务，**必须在同故事的实现任务之前编写并通过失败验证**
+- `[Story]` 标签将任务映射到设计文档 §1.1.1 中的具体用户故事，支持全链路追溯
+- **所有文件路径必须精确到三模块**（`{port}-{service}-api/model/application/`）
+- **ECP 编码规范 10 条是硬性约束**，违反任一条 = 任务不合格
+- **Save 用 FastJSON**：`JSONObject.parseObject(JSONObject.toJSONString(dto), Entity.class)`
+- **Update 用 Spring BeanUtils**：`BeanUtils.copyProperties(dto, entity, "createdBy", "creationDate", "versionNum")`
+- **WHERE delete_flag = 0**：所有 MyBatis XML SELECT 语句必须包含
+- **消息码禁止硬编码**：所有异常和校验信息引用 `ResponseMsgCode` 枚举
+- **异常在 Service 层抛出**：Controller 仅做参数空校验返回 `ResponseData.fail()`
+- 每个任务或逻辑分组后建议 git commit
+- 可在任何检查点停下验证故事的独立可用性
+- 避免：模糊任务、同文件冲突、跨故事强耦合、违反 TDD 顺序（实现先于测试）