docs:添加强制规则,禁止本地后端验收,必须使用 deploy.py 部署到服务器验收
This commit is contained in:
@@ -216,24 +216,53 @@ bash deploy-all.sh admin
|
||||
|
||||
---
|
||||
|
||||
## 验证规则(强制)
|
||||
## 服务器端验收强制规则(最高优先级,不可违反)
|
||||
|
||||
**修改任何前后端代码后,必须使用浏览器进行验证**
|
||||
**所有前端功能验收(小程序、用户端 web、管理后台 admin)必须使用服务器上部署的后端服务,禁止使用本地后端服务验收。**
|
||||
|
||||
### 验证步骤
|
||||
### 强制流程
|
||||
|
||||
1. **使用浏览器工具打开对应页面**
|
||||
- 使用 `agent-browser` skill 或 MCP 工具
|
||||
- 前台页面:通常是 `http://localhost:5173` 或项目指定端口
|
||||
- 管理端页面:通常是 `http://localhost:5174` 或项目指定路径
|
||||
修改任意后端代码后,必须按以下顺序操作:
|
||||
|
||||
2. **验证标准**(全部满足才算通过)
|
||||
- ✅ 前端修改已生效
|
||||
- ✅ 页面没有报错
|
||||
- ✅ 可以正常访问
|
||||
- ✅ 浏览器 Console 中没有任何错误
|
||||
1. **编译验证**:本地 `mvn clean install -DskipTests -am` 必须通过,零报错。
|
||||
2. **部署到服务器**:执行 `python deploy.py backend`(或其他对应模块名),确保部署成功、无报错。
|
||||
3. **服务器验收**:在服务器上已部署的应用进行功能验收。
|
||||
|
||||
3. **只有验证通过才算任务完成**
|
||||
### 各前端验收方式
|
||||
|
||||
| 前端 | 验收方式 |
|
||||
|---|---|
|
||||
| 小程序 | 本地 `npm run dev:h5` 启动 H5(`.env.development` 已默认指向 `lifescript.happylifeos.com`),浏览器访问本地 H5 URL,后端请求走服务器 |
|
||||
| 用户端 web | 直接访问服务器 URL(`https://lifescript.happylifeos.com/`)验收 |
|
||||
| 管理后台 admin | 直接访问服务器 URL(`https://lifescript.happylifeos.com/emotion-museum-admin/`)验收 |
|
||||
|
||||
### 禁止行为
|
||||
|
||||
- ❌ 禁止使用 `localhost` / `127.0.0.1` 后端服务做功能验收
|
||||
- ❌ 禁止绕过 `deploy.py` 手动部署
|
||||
- ❌ 禁止在后端编译有报错的情况下部署
|
||||
- ❌ 禁止部署后不验收就认为任务完成
|
||||
|
||||
### 允许的唯一例外
|
||||
|
||||
- ✅ 单元测试 / 集成测试(测试代码可连本地或测试数据库)
|
||||
- ✅ 纯前端样式/UI 调整(不涉及后端接口,可本地启动 H5 自测)
|
||||
- ✅ 后端开发阶段的结构验证(仅 mvn 编译,不部署不验收)
|
||||
|
||||
### deploy.py 模块名速查
|
||||
|
||||
- `backend` — 部署后端到服务器
|
||||
- `frontend` — 部署用户端 web
|
||||
- `admin` — 部署管理后台
|
||||
- `all` — 部署所有服务
|
||||
- `verify` — 验证部署状态
|
||||
|
||||
### 验收通过标准
|
||||
|
||||
- 浏览器 Console 无任何错误
|
||||
- 服务器接口响应正常(Network 面板查看)
|
||||
- 业务功能按预期工作
|
||||
- 只有验收通过才算任务完成
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user