th-hotel-simple/PROJECT_STATE.md

TH Hotel Simple 项目当前状态

项	内容
最近更新	2026-07-17
当前分支	feature/huangting
当前阶段	项目文档标准化与业务能力迭代并行
当前重点	按 AI-NSES 建立新 Agent 可快速进入项目的文档入口

1. 当前 Checkpoint

• 名称：checkpoint-docs-ai-native-entry
• 状态：In Progress，等待本次文档改动 Review。
• 目标：新增 AI-NSES 通用标准、模板目录、项目上下文、项目当前状态和本项目采用说明。
• 边界：只改文档，不搬迁历史文档，不删除文档，不改代码。

2. 当前优先级

1. 先把 AI-NSES 的入口文档落地，让新 Agent 不依赖聊天记录也能理解项目。
2. 保持 docs/project/README.md、CONTEXT.md、PROJECT_STATE.md 三个入口之间一致。
3. 后续开发继续以当前有效的 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，需要更新本文件，避免项目状态继续沉淀在聊天记录里。

5. Next Steps

• Review 本次 AI-NSES 文档入口改动。
• 确认通过后，可按后续具体需求继续进入业务开发。
• 后续新增重要功能时，优先在 docs/project/requirements/ 或未来 docs/specs/ 中形成 Spec，再实现代码。

6. 文档同步提醒

每次 Feature 完成后检查：

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

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

No documentation changes required.