3.5 KiB
3.5 KiB
TH Hotel Simple 项目当前状态
| 项 | 内容 |
|---|---|
| 最近更新 | 2026-07-18 |
| 当前分支 | feature/huangting |
| 当前阶段 | M002 V4 入站基线与业务能力迭代并行 |
| 当前重点 | SuperAgent V4 回调入站解析、现有任务链路过渡适配和后续 V4 多卡模型规划 |
1. 当前 Checkpoint
- 名称：
M002-V4-CP1-agent-callback-intake-baseline - 状态：In Progress，当前后端实现、测试和文档同步中。
- 目标：按 2026-07-18 V4 Agent 回调字段契约接收
source_message + order_contexts[] + message_events[]，完成入站解析、基础校验、路由适配和 adapter error 最小落库。 - 边界：不做完整 V4 多卡领域模型、不做 OPERA / OHIP、不做前端页面、不做历史数据迁移。
2. 当前优先级
- 先把 AI-NSES 的入口文档落地，让新 Agent 不依赖聊天记录也能理解项目。
- 保持
docs/project/README.md、CONTEXT.md、PROJECT_STATE.md三个入口之间一致。 - 后续开发继续以当前有效的 M002 V4 字段契约、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 当前只完成入站解析和现有任务链路过渡适配；Basic Information 独立卡、V4 订单任务多卡模型和 V4 前端页面仍未完成。
5. Next Steps
- Review M002 V4 CP1 入站基线改动。
- 后续如继续做 M002 V4，应优先规划订单任务 + 多卡领域模型、Basic Information 独立卡、前端 V4 页面模型和目录校验能力。
- 后续新增重要功能时，优先在
docs/project/requirements/或未来docs/specs/中形成 Spec，再实现代码。 - M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化，再单独开前后端 checkpoint。
6. 文档同步提醒
每次 Feature 完成后检查：
- Domain 是否需要更新。
- Architecture 是否需要更新。
- Workflow 是否需要更新。
- ADR 是否需要新增。
- Spec 或需求文档是否需要更新状态。
PROJECT_STATE.md是否需要更新。- 接口、安全、权限、审计和酒店隔离文档是否需要同步。
如果没有文档变化，明确说明：
No documentation changes required.