完善M002 V4多卡领域模型设计

This commit is contained in:
andy
2026-07-18 23:50:35 +07:00
parent 3ecbf7eea8
commit 3d9055dd6b
8 changed files with 750 additions and 20 deletions

View File

@@ -4,21 +4,21 @@
| --- | --- |
| 最近更新 | 2026-07-18 |
| 当前分支 | `feature/huangting` |
| 当前阶段 | M002 V4 入站基线与业务能力迭代并行 |
| 当前重点 | SuperAgent V4 回调入站解析修正版、现有任务链路过渡适配和后续 V4 多卡模型规划 |
| 当前阶段 | M002 V4 入站基线与多卡模型设计并行 |
| 当前重点 | M002 V4 CP2 订单任务与多卡领域模型设计决策已闭合,后续准备进入 V4 表结构和 Repository 落地 |
## 1. 当前 Checkpoint
- 名称:`M002-V4-CP1-agent-callback-intake-baseline`
- 状态Done已完成后端入站解析基线、review 修复、测试和文档同步
- 目标:按 2026-07-18 V4 Agent 回调字段契约接收 `source_message + order_contexts[] + message_events[]`,完成入站解析、基础校验、路由适配和 adapter error 最小落库
- 边界:不做完整 V4 多卡领域模型、不做 OPERA / OHIP、不做前端页面、不做历史数据迁移。
- 名称:`M002-V4-CP2-order-task-card-domain-model`
- 状态Done已完成设计文档并补齐 7 项业务决策,尚未写 Java、Flyway、接口或前端代码
- 目标:在 CP1 入站解析基线之后,明确 V4 订单任务、SourceMessage 邮件展示卡、Basic Information 独立卡、业务卡、状态、表结构草案、接口草案和后续开发 checkpoint
- 边界:只做文档设计;不做 OPERA / OHIP、不做前端页面、不做历史数据迁移。
## 2. 当前优先级
1. 先把 AI-NSES 的入口文档落地,让新 Agent 不依赖聊天记录也能理解项目。
2. 保持 `docs/project/README.md``CONTEXT.md``PROJECT_STATE.md` 三个入口之间一致。
3. 后续开发继续以当前有效的 M002 V4 字段契约、M002 V3 / P0.1 历史实现说明、字段控件契约、SuperAgent 契约和安全边界文档为准。
3. 后续开发继续以当前有效的 M002 V4 字段契约、M002 V4 CP2 多卡模型设计、M002 V3 / P0.1 历史实现说明、字段控件契约、SuperAgent 契约和安全边界文档为准。
## 3. 已确认事实
@@ -34,11 +34,12 @@
- `docs/import/` 下按日期导入的资料是输入材料,不等同于当前权威开发契约;当前开发应优先看 `docs/project/README.md` 标记为当前有效或权威契约的文档。
- 后续每完成一个 Feature 或 Checkpoint需要更新本文件避免项目状态继续沉淀在聊天记录里。
- M010 Rooming List Excel 生成后端 CP1 和前端 V1 已实现:前端 `/reservation/rooming-lists/new` 上传来源名单和手工字段,后端同步生成 `.xlsx` 直接下载,第一版不落库、不上传 OSS。
- M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配Basic Information 独立卡、V4 订单任务多卡模型和 V4 前端页面仍未完成。
- M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配;M002 V4 CP2 已完成订单任务与多卡领域模型设计。Basic Information 独立卡、V4 订单任务多卡表结构、查询 / 写接口和 V4 前端页面仍未完成代码实现
- M002 V4 CP2 已确认V4 工作台统一列表草案为 `/api/reservation/workbench-items`,业务订单任务接口新开 `/api/reservation/order-tasks/**`S10 来源通知详情草案为 `/api/reservation/source-notifications/{notificationId}`S10 使用来源通知模型,不再挂隐藏技术订单;`FIT + BOOKING_CODE` 不建 ACTIVE 唯一约束匹配多条进人工复核Basic Information 必须先确认Account / Market / Source 第一版使用固定种子数据;旧 V2/V3 任务详情和草稿确认接口后续可逐步废弃。
## 5. Next Steps
- 后续如继续做 M002 V4应优先规划订单任务 + 多卡领域模型、Basic Information 独立卡、前端 V4 页面模型和目录校验能力
- 后续如继续做 M002 V4应优先进入 `M002-V4-CP3`:新增 V4 订单任务表、V4 任务卡表、V4 来源通知表、Entity、Mapper、Repository 和基础测试
- 后续新增重要功能时,优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec再实现代码。
- M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化,再单独开前后端 checkpoint。