From 11f1638eefb51f081b9a4cc17ae797bd417b2f62 Mon Sep 17 00:00:00 2001 From: Peanut Date: Wed, 24 Jun 2026 22:17:06 +0800 Subject: [PATCH] =?UTF-8?q?docs=EF=BC=9A=E6=B7=BB=E5=8A=A0=E5=BC=BA?= =?UTF-8?q?=E5=88=B6=E8=A7=84=E5=88=99=EF=BC=8C=E7=A6=81=E6=AD=A2=E6=9C=AC?= =?UTF-8?q?=E5=9C=B0=E5=90=8E=E7=AB=AF=E9=AA=8C=E6=94=B6=EF=BC=8C=E5=BF=85?= =?UTF-8?q?=E9=A1=BB=E4=BD=BF=E7=94=A8=20deploy.py=20=E9=83=A8=E7=BD=B2?= =?UTF-8?q?=E5=88=B0=E6=9C=8D=E5=8A=A1=E5=99=A8=E9=AA=8C=E6=94=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 55 ++++++++++++++++++++++++++++++++++++++++++------------- CLAUDE.md | 55 ++++++++++++++++++++++++++++++++++++++++++------------- 2 files changed, 84 insertions(+), 26 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 08368ec..98688b5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 面板查看） +- 业务功能按预期工作 +- 只有验收通过才算任务完成 --- diff --git a/CLAUDE.md b/CLAUDE.md index f985151..404244b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 面板查看） +- 业务功能按预期工作 +- 只有验收通过才算任务完成 ---