63 lines
4.9 KiB
Markdown
63 lines
4.9 KiB
Markdown
# TH Hotel Simple 项目当前状态
|
||
|
||
| 项 | 内容 |
|
||
| --- | --- |
|
||
| 最近更新 | 2026-07-19 |
|
||
| 当前分支 | `feature/huangting` |
|
||
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验和订单详情时间线补齐并行 |
|
||
| 当前重点 | M002 V4 已在旧订单详情接口补齐 `v4_order_tasks[]` 订单任务时间线，保留旧 `tasks[]` 兼容；后续准备做 V4 前端页面或真实目录 / PMS lookup |
|
||
|
||
## 1. 当前 Checkpoint
|
||
|
||
- 名称：`M002-V4-order-detail-timeline-completion-v1`
|
||
- 状态：Done，已在 `GET /api/reservation/orders/{orderId}` 响应中新增 V4 `v4_order_tasks[]` 订单任务时间线，保留旧 `tasks[]` 兼容，并按订单酒店过滤 V4 数据。
|
||
- 目标：让订单详情页在旧 V2/V3 任务时间线之外，可以看到同订单下 V4 order task 摘要、卡片数量、来源邮件安全摘要和最新活动时间。
|
||
- 边界：本轮不做前端页面、不做真实 OPERA / OHIP、不做普通任务切换订单、不废弃旧 V2/V3 接口、不接真实目录 lookup。
|
||
|
||
## 2. 当前优先级
|
||
|
||
1. 先把 AI-NSES 的入口文档落地，让新 Agent 不依赖聊天记录也能理解项目。
|
||
2. 保持 `docs/project/README.md`、`CONTEXT.md`、`PROJECT_STATE.md` 三个入口之间一致。
|
||
3. 后续开发继续以当前有效的 M002 V4 字段契约、M002 V4 CP2 多卡模型设计、M002 V3 / P0.1 历史实现说明、字段控件契约、SuperAgent 契约和安全边界文档为准。
|
||
|
||
## 3. 已确认事实
|
||
|
||
- 本项目是前后端分离项目，根目录使用 `client/` 和 `server/`，不是 AI-NSES 示例里的通用 `src/` 单目录结构。
|
||
- 可复用规范放在 `docs/import/reusable/`，当前项目专属文档放在 `docs/project/`。
|
||
- AgentBus 是消息入口适配器，SuperAgent 是外部 AI / Agent 能力提供方，二者不能直接成为业务事实来源。
|
||
- 后端时间点按 UTC 存储和返回，页面再按酒店或用户时区展示。
|
||
- 新增 MySQL 表默认要求 `utf8mb4_bin`，避免外部 opaque id、Token、状态码和业务代码被大小写不敏感比较误判。
|
||
|
||
## 4. Known Issues
|
||
|
||
- 现有历史文档暂不按 AI-NSES 目录大搬迁，先通过索引和采用说明建立映射关系。
|
||
- `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 已完成入站写入新模型；M002 V4 CP5 已完成前端查询接口并补齐订单详情 `v4_order_tasks[]` 时间线；M002 V4 CP6 已完成普通卡片确认和 S10/S99 来源通知 ack；M002 V4 CP7 已完成 `REVIEW_REQUIRED` 卡复核解阻和复核场景订单归属确认；M002 V4 CP8 已完成固定种子目录校验、V4 卡片 `fields[]` 字段白名单、确认写入白名单收口和嵌套业务字段目录校验。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，应优先进入 V4 前端页面接入 checkpoint，或进入真实目录 / PMS lookup / OPERA 映射前置设计 checkpoint。
|
||
- 后续新增重要功能时，优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec，再实现代码。
|
||
- M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化，再单独开前后端 checkpoint。
|
||
|
||
## 6. 文档同步提醒
|
||
|
||
每次 Feature 完成后检查：
|
||
|
||
- Domain 是否需要更新。
|
||
- Architecture 是否需要更新。
|
||
- Workflow 是否需要更新。
|
||
- ADR 是否需要新增。
|
||
- Spec 或需求文档是否需要更新状态。
|
||
- `PROJECT_STATE.md` 是否需要更新。
|
||
- 接口、安全、权限、审计和酒店隔离文档是否需要同步。
|
||
|
||
如果没有文档变化，明确说明：
|
||
|
||
```text
|
||
No documentation changes required.
|
||
```
|