huangting/th-hotel-simple
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

实现 M002 V4 查询接口

Browse Source
This commit is contained in:
andy
2026-07-19 01:44:32 +07:00
parent 99528b483f
commit dc6c8f48ab
36 changed files with 2213 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
PROJECT_STATE.md
View File

@@ -2,17 +2,17 @@
| 项 | 内容 |
| --- | --- |
| 最近更新 | 2026-07-18 |
| 最近更新 | 2026-07-19 |
| 当前分支 | `feature/huangting` |
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线和入站写入新模型并行 |
| 当前重点 | M002 V4 CP4 已把 SuperAgent V4 入站结果写入 V4 订单任务、多卡和 S10/S99 来源通知模型，后续准备做 V4 查询接口 |
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入和前端查询接口并行 |
| 当前重点 | M002 V4 CP5 已开放 V4 工作台统一列表、订单任务列表 / 详情、S10/S99 来源通知详情查询接口；后续准备做 V4 卡片确认、复核和来源通知 ack 写接口 |
## 1. 当前 Checkpoint
- 名称：`M002-V4-CP4-v4-intake-write-new-model`
- 状态：Done，已在 SuperAgent V4 正式回调中写入 V4 新模型：普通 V4 业务包创建 V4 订单任务、来源邮件展示卡、Basic Information 卡和业务卡；V4 S10/S99 写入来源通知，不再创建隐藏技术订单或旧任务；V4 包级 / event 级契约错误仍只写 AI transition，不创建用户可处理卡。
- 目标：在 CP1 入站解析、CP2 多卡模型设计、CP3 表结构和 Repository 基线之后，让 V4 回调真正落到新订单任务 + 多卡 + 来源通知持久化模型。
- 边界：普通 V4 业务包暂时仍保留旧 V3 任务链路兼容，便于当前前端过渡；不实现 V4 前端查询接口、卡片确认 / 复核 / S10/S99 ack 接口；不做 OPERA / OHIP、不做前端页面、不做历史数据迁移。
- 名称：`M002-V4-CP5-v4-query-interfaces`
- 状态：Done，已实现 `GET /api/reservation/workbench-items`、`GET /api/reservation/order-tasks`、`GET /api/reservation/order-tasks/{orderTaskId}`、`GET /api/reservation/source-notifications/{notificationId}`。
- 目标：让 V4 新模型中的业务订单任务、多卡和 S10/S99 来源通知可以被前端安全查询。
- 边界：CP5 只做查询；不实现 V4 卡片确认 / 复核、S10/S99 ack、订单详情 V4 专属时间线、OPERA / OHIP、前端页面和历史数据迁移。
## 2. 当前优先级
@@ -34,12 +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 当前已完成入站解析和现有任务链路过渡适配；M002 V4 CP2 已完成订单任务与多卡领域模型设计；M002 V4 CP3 已完成 V4 订单任务、多卡和 S10/S99 来源通知表结构与 Repository 基线；M002 V4 CP4 已完成入站写入新模型。V4 查询 / 写接口和 V4 前端页面仍未完成代码实现。
- M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配；M002 V4 CP2 已完成订单任务与多卡领域模型设计；M002 V4 CP3 已完成 V4 订单任务、多卡和 S10/S99 来源通知表结构与 Repository 基线；M002 V4 CP4 已完成入站写入新模型；M002 V4 CP5 已完成前端查询接口。V4 写接口和 V4 前端页面仍未完成代码实现。
- M002 V4 CP2 已确认：V4 工作台统一列表草案为 `/api/reservation/workbench-items`，业务订单任务接口新开 `/api/reservation/order-tasks/**`，S10/S99 来源通知详情草案为 `/api/reservation/source-notifications/{notificationId}`；S10/S99 使用来源通知模型，不再挂隐藏技术订单；`FIT + BOOKING_CODE` 不建 ACTIVE 唯一约束，匹配多条进人工复核；Basic Information 必须先确认；Account / Market / Source 第一版使用固定种子数据；旧 V2/V3 任务详情和草稿确认接口后续可逐步废弃。
## 5. Next Steps
- 后续如继续做 M002 V4，应优先进入 `M002-V4-CP5`：实现 V4 工作台统一列表、订单任务列表 / 详情、S10/S99 来源通知详情等查询接口。
- 后续如继续做 M002 V4，应优先进入 `M002-V4-CP6`：实现 V4 卡片确认、复核解阻、S10/S99 来源通知 ack、审计和 version 并发校验。
- 后续新增重要功能时，优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec，再实现代码。
- M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化，再单独开前后端 checkpoint。