feat(skills): web-application-spec 加框架铁律(入口必须ahserver禁止Flask/http.server + 主页必须有完整index.ui) + bug 加fixed→复测部署门禁(必须先部署测试环境+QC验证)

This commit is contained in:
yumoqing 2026-08-24 15:53:49 +08:00
parent 84cc15dd1d
commit 8164444ab3
2 changed files with 7 additions and 0 deletions

View File

@ -37,6 +37,7 @@ Bug 由人工或 agent(reporter_type)提交,指派处理人(assignee_id
- `close` 前:Bug 已 verified(修复生效)。 - `close` 前:Bug 已 verified(修复生效)。
- 迭代准出:未关闭 Bug 清零(或明确豁免)。 - 迭代准出:未关闭 Bug 清零(或明确豁免)。
- `fix` 附修复说明(fix_description)+ 修复提交(fix_commit)。 - `fix` 附修复说明(fix_description)+ 修复提交(fix_commit)。
- **`fixed` → `verified`(复测)之间必须经过部署 + QC 验证(铁律,2026-08-24 用户定)**:Bug 修复(fix_bug → fixed)后,修复代码**必须先部署到测试环境**(deploy_test 重新部署应用),QC 按 review-deploy 标准验证 `/healthz` 200 真实通过、新代码已生效,**部署验证通过后才派发复测任务给 test**(verify_bug)。禁止「fixed 直接复测」跳过部署——否则 test 对着测试环境的旧代码复测,verify_bug 结果无效。部署未通过 → 回退 develop 修部署问题,不进入复测。
## 五、配套能力(工具) ## 五、配套能力(工具)

View File

@ -19,6 +19,12 @@ This specification defines the standard architecture for web applications built
All web applications must follow this exact structure and configuration pattern. All web applications must follow this exact structure and configuration pattern.
## 框架铁律(不可违反,禁止让 LLM 猜)
1. **应用入口必须用 ahserver**:`app/{应用名}.py` 必须 `from ahserver.webapp import webapp`,末尾 `webapp(init)` 启动。**绝对禁止** Flask / http.server / Django / FastAPI 等任何其它 Web 框架。原因:bricks 的 `.ui` 界面只有 ahserver 的 BricksUIProcessor 能渲染,用 Flask/http.server 会导致模块 `.ui` 界面(DataViewer CRUD 等)无法渲染,根路径 `/` 只剩一段 JSON 元信息——「测试环境界面显示 JSON 就停」的直接根因(2026-08-24 人事项目6 hrs6 实测:develop 用 Flask 写 app/hrs6.py,design 在 architecture.md 写「基础模块 ahserver 直接复用」,实现偏离设计)。
2. **应用必须有主页 UI**:`wwwroot/index.ui` 必须是**完整 bricks widget 树**(顶栏 + 导航菜单 + 主内容区),访问 `/` 渲染出可交互界面。**绝对禁止**占位敷衍(如 index.ui 只写「卡片导航」4 个字)。主页是应用门面,不是 JSON 元信息接口。
## Required Dependencies ## Required Dependencies
### Core Dependencies (Mandatory) ### Core Dependencies (Mandatory)