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 由人工或 agentreporter_type提交指派处理人assignee_id
- `close`Bug 已 verified修复生效
- 迭代准出:未关闭 Bug 清零(或明确豁免)。
- `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.
## 框架铁律(不可违反,禁止让 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.pydesign 在 architecture.md 写「基础模块 ahserver 直接复用」,实现偏离设计)。
2. **应用必须有主页 UI**`wwwroot/index.ui` 必须是**完整 bricks widget 树**(顶栏 + 导航菜单 + 主内容区),访问 `/` 渲染出可交互界面。**绝对禁止**占位敷衍(如 index.ui 只写「卡片导航」4 个字)。主页是应用门面,不是 JSON 元信息接口。
## Required Dependencies
### Core Dependencies (Mandatory)