break
315a7de3e4
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 53s
- add-agent-self-recharge-payment-methods 归档为 2026-09-11-add-agent-self-recharge-payment-methods，delta 应用后主规格 agent-funds-commission 完成 1 条 Requirement 改名并新增 4 条 Requirement - 在可达操作索引补充代理自充支付方式配置与付款凭证识别共 3 个端点 - 同步 requirement-evidence.json 与 entry-capability-requirement-matrix.json 证据链 - fix-employee-collection-route-prefix 归档为 2026-09-11-fix-employee-collection-route-prefix 并勾选任务 2.5 门禁：context-health 通过、openspec validate --all 40 passed / 0 failed、doctor healthy
17 lines
3.6 KiB
Markdown
17 lines
3.6 KiB
Markdown
## 1. 路由前缀修复（提交 `ff1362d`，已推送 `origin/Iteration/8-11`）
|
||
|
||
- [x] 1.1 三个注册函数各引入 `router.Group("/<资源前缀>")`，12 处 `Register` 首参由 admin 根路由组改为该 group，`basePath` 与文档路径拼接不变。验证：`git show --numstat ff1362d` 仅 `internal/routes/employee_collection.go`（17 insertions / 12 deletions），且 `grep -c "Register(group"` 为 12。
|
||
- [x] 1.2 确认 `/api/admin` 根级不再有员工代收款路由。验证：离线路由表扫描（真实 `RegisterAdminRoutes` + `openapi.BuildDocHandlers`）缺陷版 10 条根级栈条目 / 7 条不同 method+path 全部消失，路由总数 356 → 358。
|
||
- [x] 1.3 确认同层抢占候选为 0。验证：同方法下先注册的参数路由命中后注册的静态路由，缺陷版 29 条原始命中（按「方法 + 被抢占静态路由」去重 15 条），修复后为 0；另以最小 Fiber 应用证明匹配按注册顺序（参数路由先注册时命中参数路由）。
|
||
- [x] 1.4 确认真实路由可达性。验证：装载真实注册函数与真实 handler 后请求，缺陷版 6 个命名 GET 返回 `400 / 1001 无效的路径ID`、`/api/admin/statistics` 返回 `503 / 2004`；修复版这些路径命中各自处理器（`403 / 1005` 权限拒绝），`/api/admin/statistics` 返回 `404 / 1006`。
|
||
- [x] 1.5 确认契约与鉴权未变。验证：缺陷版、修复版与当前工作区三次 `go run cmd/gendocs/main.go` 产物逐字节相同（md5 `274f45440597aaafb1e168ac266cbb85`，含路径、方法、鉴权标记与描述文本）；`requireEmployeeCollectionConfigAccess` 与 `adminOnly` 的包装位置和数量不变。
|
||
- [x] 1.6 确认未触碰业务实现。验证：`ff1362d` 不包含 handler、application/service、domain、迁移或配置改动。
|
||
|
||
## 2. 本 Change 的门禁与归档
|
||
|
||
- [x] 2.1 变更在无 delta 形态下通过严格校验。验证：在 `/tmp` 的 `openspec/` 副本执行 `openspec validate fix-employee-collection-route-prefix --strict` 通过（输出 `Change 'fix-employee-collection-route-prefix' is valid`）。
|
||
- [x] 2.2 全量校验与既有条目共存。验证：同一副本 `openspec validate --all` 为 42 passed / 0 failed；真实仓库对照为 41 passed / 0 failed（差异仅为副本多出的本 Change）。
|
||
- [x] 2.3 变更不破坏上下文健康门禁。验证：把本 Change 放入仓库快照的 `/tmp` 全量副本（含 `e687a26` 的证据链与可达操作索引）后执行 `zsh ./scripts/context-health.sh`，输出「Context 健康检查通过」、退出码 0。
|
||
- [x] 2.4 落地后在真实仓库运行 `./scripts/context-health.sh` 并确认输出「Context 健康检查通过」；该脚本会重写 `docs/admin-openapi.yaml`，须在并发流水线停止后执行。验证：在真实仓库（`HEAD=7891189`，含 `e687a26` 的证据链与可达操作索引）执行，输出「Context 健康检查通过」、退出码 0；同时 `docs/admin-openapi.yaml` md5 仍为 `274f45440597aaafb1e168ac266cbb85`。
|
||
- [x] 2.5 归档本 Change（`openspec archive`，不改动 `openspec/specs/**` 与 `docs/verification/context-reset/*.json`；归档预演结果见 design 的 Risks）。验证：`openspec archive fix-employee-collection-route-prefix --yes` 将本 Change 移入 `openspec/changes/archive/2026-09-11-fix-employee-collection-route-prefix`；因本 Change 无 delta 且 `.openspec.yaml` 声明 `skip_specs: true`，`openspec/specs/**` 与两个证据 JSON 均无改动；归档后 `./scripts/context-health.sh` 输出「Context 健康检查通过」退出码 0，`openspec validate --all` 为 41 passed / 0 failed，`openspec doctor --json` 为 `healthy = true`。
|