docs(booking): freeze v0.4 contracts and verification path

README.md

@@ -39,6 +39,8 @@ docs/
 
 ## 后端命令
 
+本 checkpoint 固定本地验证基线为 JDK 17（见 `server/.java-version`）。
+
 ```bash
 cd server
 ./mvnw test
@@ -54,6 +56,8 @@ cd server
 
 ## 前端命令
 
+本 checkpoint 固定本地验证基线为 Node 24 与 pnpm 11（见 `client/.node-version` 和 `client/package.json`）。
+
 ```bash
 cd client
 pnpm install
@@ -73,6 +77,18 @@ pnpm build
 - `pnpm lint`：运行 ESLint 检查。
 - `pnpm build`：执行类型检查并构建生产产物。
 
+### 本地安全运行与 BR00 原型
+
+后端默认启用 `local` profile，只使用进程内 H2；本地启动不会连接远程数据库、AgentBus 或 SuperAgent。需要连接开发环境时，必须显式启用 `dev` profile，并由部署环境提供 `TH_HOTEL_DEV_DB_URL`、`TH_HOTEL_DEV_DB_USERNAME`、`TH_HOTEL_DEV_DB_PASSWORD` 三个环境变量；任一缺失会在启动阶段失败。
+
+正式根路由 `http://127.0.0.1:5174/` 是登录/工作台入口，不再承载原型。BR00 原型仅用于开发态人工演示，必须显式开启：
+
+```bash
+VITE_ENABLE_BR00_PROTOTYPE=true pnpm --dir client dev
+```
+
+开启后访问 `http://127.0.0.1:5174/prototype/br00`；任务详情位于 `/prototype/br00/tasks/:taskKey`。原型数据均为虚构内容，只使用 localStorage，不连接正式 API，也不会写入 Opera / PMS。生产构建不会注册这些路由。
+
 本地联调指定后端示例：
 
 ```bash