Add single domain gateway routing

ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md

@@ -42,11 +42,34 @@ docker compose -f docker-compose.dev.yml up -d --build backend user-client admin
 
 默认地址：
 
-- 用户端 H5：`http://127.0.0.1:5173/`
-- 管理后台：`http://127.0.0.1:5174/`
-- 后端健康检查：`http://127.0.0.1:8100/api/health`
+- 统一入口：`http://127.0.0.1:8080/`
+- 用户端 H5：`http://127.0.0.1:8080/`
+- 管理后台：`http://127.0.0.1:8080/login`
+- 后端健康检查：`http://127.0.0.1:8080/api/health`
+- 用户端直连调试：`http://127.0.0.1:5173/`
+- 管理后台直连调试：`http://127.0.0.1:5174/login/`
+- 后端直连调试：`http://127.0.0.1:8100/api/health`
 - MySQL：`127.0.0.1:3307`
 
+## 单域名访问
+
+当前编排新增 `gateway` 服务作为统一入口。内网穿透时建议只穿透 `gateway:80`，域名路径分流如下：
+
+```text
+https://qa.huiyushuyuan.cn/        用户端 H5
+https://qa.huiyushuyuan.cn/login   管理后台登录页
+https://qa.huiyushuyuan.cn/api/... 后端 API
+```
+
+`.env` 中推荐配置：
+
+```bash
+FRP_PROXY_NAME=qa-web
+FRP_LOCAL_IP=gateway
+FRP_LOCAL_PORT=80
+FRP_CUSTOM_DOMAINS=qa.huiyushuyuan.cn
+```
+
 ## 开发阶段默认账号
 
 用户端：

ai_knowledge_base_v2/deployment/RELEASE_CHECKLIST.md

@@ -9,7 +9,9 @@
 - [ ] 已替换 `JWT_SECRET_KEY`。
 - [ ] 已确认飞书检索配置。
 - [ ] 已确认模型配置和额度策略。
-- [ ] 已确认前端 API 地址。
+- [ ] 已确认统一入口 `gateway` 可访问。
+- [ ] 已确认前端 API 地址使用同域 `/api`。
+- [ ] 已确认内网穿透指向 `gateway:80`。
 
 ## 发布中
 
@@ -18,11 +20,14 @@
 - [ ] 启动后端服务。
 - [ ] 启动用户端 H5。
 - [ ] 启动管理后台。
-- [ ] 检查后端健康接口。
+- [ ] 启动统一入口 gateway。
+- [ ] 检查 `域名/api/health` 后端健康接口。
 
 ## 发布后
 
 - [ ] 用户端可以登录。
+- [ ] 默认打开域名进入用户端。
+- [ ] `域名/login` 进入管理后台登录页。
 - [ ] 用户端可以创建会话。
 - [ ] 用户端可以提问并收到回答。
 - [ ] 无命中问题返回固定兜底。