再次提交一下代码

This commit is contained in:
andy
2026-07-17 13:13:47 +07:00
parent f4d86248d4
commit 980a3a2535
41 changed files with 1699 additions and 187 deletions

59
PROJECT_STATE.md Normal file
View File

@@ -0,0 +1,59 @@
# 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` 是否需要更新。
- 接口、安全、权限、审计和酒店隔离文档是否需要同步。
如果没有文档变化,明确说明:
```text
No documentation changes required.
```