第三次版本迭代更新

README.md

@@ -1,4 +1,4 @@
-# 酒店员工端 H5
+# 员工端 H5
 
 Vue 3 + Vite + TypeScript + Vant 的移动端员工工作台。当前包含 mock 数据，可直接预览完整流程。
 
@@ -45,13 +45,13 @@ cp .env.example .env.local
 | `.env.test` | 测试环境打包配置 |
 | `.env.production` | 生产环境打包配置 |
 
-测试环境目前默认使用本地已确认网关：
+测试环境和生产环境推荐使用同源代理：
 
 ```bash
-VITE_API_BASE_URL=http://192.168.3.211:9999
+VITE_API_BASE_URL=
 ```
 
-生产环境如果 H5 和网关同域部署，`VITE_API_BASE_URL` 可以保持为空；如果不是同域部署，需要改成生产网关域名。
+部署时由 Nginx 把 `/auth`、`/admin`、`/hotelStaff`、`/hotelBiz` 等接口前缀反向代理到后端网关。只有在确认后端网关允许跨域时，才建议把 `VITE_API_BASE_URL` 改成完整网关域名。
 
 ## 页面
 
@@ -66,6 +66,11 @@ VITE_API_BASE_URL=http://192.168.3.211:9999
 - `/events/create`：发布事件。
 - `/mine`：我的。
 
+## 文档
+
+- [H5页面规划.md](./H5页面规划.md)：页面结构、核心流程和 MVP 范围。
+- [docs/frontend-practices.md](./docs/frontend-practices.md)：接口接入、移动端兼容、扫码核销和部署经验。
+
 ## 校验
 
 ```bash