huangting/th-hotel-simple
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e6fbd7a111ff880297109b1974723a797bcef4cb
th-hotel-simple/PROJECT_STATE.md
andy e6fbd7a111 实现M002 V4持久化基线
2026-07-19 00:12:40 +07:00

4.5 KiB
Raw Blame History

TH Hotel Simple 项目当前状态

项 内容
最近更新 2026-07-18
当前分支 feature/huangting
当前阶段 M002 V4 入站基线、多卡模型与持久化基线并行
当前重点 M002 V4 CP3 表结构和 Repository 基线已落地，后续准备做 V4 入站写入新模型

1. 当前 Checkpoint

  • 名称：M002-V4-CP3-order-task-card-repository-baseline
  • 状态：Done，已新增 V4 订单任务表、任务卡表、来源通知表、Entity、Mapper、Repository 和 Repository 集成测试；已覆盖 order_context_index 稳定排序、非 event 卡 source_event_index=0 和 event 卡 index 校验。
  • 目标：在 CP1 入站解析和 CP2 多卡模型设计之后，落地 V4 订单任务、多卡和 S10 来源通知的持久化基线。
  • 边界：不改 SuperAgent 入站写入逻辑；不实现 V4 前端查询接口、卡片确认 / 复核 / S10 ack 接口；不做 OPERA / OHIP、不做前端页面、不做历史数据迁移。

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 来源通知表结构与 Repository 基线。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，应优先进入 M002-V4-CP4：将 SuperAgent V4 入站结果写入新模型，真正创建 SourceMessage 展示卡、Basic Information 卡、业务卡和 S10 来源通知。
  • 后续新增重要功能时，优先在 docs/project/requirements/ 或未来 docs/specs/ 中形成 Spec，再实现代码。
  • M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化，再单独开前后端 checkpoint。

6. 文档同步提醒

每次 Feature 完成后检查：

  • Domain 是否需要更新。
  • Architecture 是否需要更新。
  • Workflow 是否需要更新。
  • ADR 是否需要新增。
  • Spec 或需求文档是否需要更新状态。
  • PROJECT_STATE.md 是否需要更新。
  • 接口、安全、权限、审计和酒店隔离文档是否需要同步。

如果没有文档变化，明确说明：

No documentation changes required.