Advance I3 gitlinks and fill in the admin-zone task card

Why: card sections were placeholders; gitlinks point the composite at
backend a80d3c3 / frontend c1225bb (both merged component mains) so
make test validates the shipping combination.
Evidence: make test green in this worktree at these gitlinks (local log
/tmp/i3-make-test.log; CI is authoritative); card edits are SELF.
Impact: task card content + submodule pointers.
Refs: WP3-I3; Backend #165, Frontend #63, RDM #240.
This commit is contained in:
2026-10-12 02:47:35 +00:00
parent 9254f9c29b
commit 43f0603a0c
3 changed files with 18 additions and 12 deletions
+16 -10
View File
@@ -7,33 +7,39 @@
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= 3b6331d5849af411f7571410876d3c72558e577a
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-adminzone-plugin-sections(worktree);分支:feature/adminzone-plugin-sections
- 授权与交付终点:<本次允许的动作与终点;未授权事项写明>
- 授权与交付终点:用户 2026-10-12「继续推进」——覆盖 WP3-I3 完成与合入(含 Backend/Frontend/RDM/Dev 四仓配套 PR);不覆盖高后果操作。
- 交付模式:manual(逐阶段人工评审);明确授权后可记为 authorized-continuous
- 自动推进授权:无;授权范围:无;授权来源:无;授权终点:无;停止条件:无(未授权)
- 当前阶段:需求拆解;当前增量:I1(待定义)
- 当前阶段:实施与自检;当前增量:I3 AdminZone 通用声明分区
- 流程依据:仓库根目录 policy/delivery.md(归档后仍按仓库根目录定位)
## 目标与非目标
<预期结果、受影响入口/模块/契约;明确不做什么。>
目标:基座管理区可承载编译插件声明的展示分区(通用声明机制,AdminZone 不硬编码任何领域):扩展面 2.9.0 新增 `Registry.AddAdminZone`+`AdminZoneSpec`;装载期声明记入注册面摘要,新端点 `GET /api/admin-zone/sections` 展平下发;前端 AdminZone 合并「管理员内置区」与「声明区」,系统管理入口在 isAdmin ∥ 存在声明区时可见;RDM 侧注册 `rdm.audit`(项目追溯与审计)声明,复用 U4 工作台组件。对两类管理员(基座超管 + RDM 域管理员)开放(KTD4);能力由服务端下发、前端只消费不合并角色——分区内数据可见性仍由 rdm.inspect.* 命令面 fail-closed。
非目标:不做分区级基座权限判定/角色合并(声明只携带展示元数据);不做目录插件 manifest 声明通道(后续按需扩展);不改 U4 工作台组件本体;不动 RDM 授权判定(U1 AuthorizeAudit 不变);不新增组件测试框架(组件级覆盖走 e2e 体系,本增量不建)。
## 关联方向与规划
- 适用状态:待核对(无适用规划时说明原因)
- 主记录路径/版本:待核对(路径按仓库根目录定位,归档后不变;只引用唯一正文)
- 对应里程碑:待核对
- 适用状态:适用。`modules/documents/docs/proposals/2026-10-11-rdm-two-trees-trace-audit-integration.md` r1:Entrances 节「RDM 域管理员与基座超管从管理区『项目追溯与审计』进入项目目录,选定项目后复用同一页面」+ KTD4 双层管理员裁定;Base Extension Requests 表「宿主页面展示 RDM 审计入口」。
- 主记录路径/版本:上述提案 r1(U1–U5 已合入;本卡为 WP3 收尾项 I3)。
- 对应里程碑:WP3 收尾。
## 需求分析
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|---|---|---|---|---|---|---|
| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 |
| R1 | 扩展面版本化新增 AddAdminZone/AdminZoneSpec(2.9.0),非法规格 fail-closed | 符合:surface 版本注释与 surface.txt 快照机制既有(2.7.0 AddIntent 先例);pluginRegistry 持摘要指针记录 | 高 | surface 快照测试绿;缺 id/title 拒绝(app 单测) | — | 纳入本增量 |
| R2 | 新端点 GET /api/admin-zone/sections:认证即可、展平、Order→ID 稳定排序、空集返回 [] | 符合:CompiledPlugins 摘要(WP3-I4)已通至 server | 高 | server 单测(排序/未认证 401/空集非 null) | R1 | 纳入本增量 |
| R3 | 前端 AdminZone 合并声明区、入口门控 isAdmin∥有声明、id→内置组件映射、未知 id/图标回退 | 符合:SECTIONS 声明式注册先例;design-guard 棘轮约束样式 | 高 | vitest 全绿 + tsc 干净 + knip 不越限 | R2 | 纳入本增量 |
| R4 | RDM 注册 rdm.audit 声明并推进 backend pin 至 2.9.0 | 符合:RDM 只消费公开扩展面(红线);pin 推进到 backend main(is-ancestor 已核) | 高 | RDM make test 绿 + RDM CI 绿(GATE) | R1 | 纳入本增量 |
| R5 | Dev 组合验证 + 真实部署可见性(genui:无声明区时行为不变;rdm1:分区出现在 /api/admin-zone/sections) | 符合:本机 svc 部署面 | 中 | make test 组合绿(GATE=CI);部署后 curl 记录(SELF) | R1–R4 | 纳入本增量 |
## 方案与计划
- 方案引用:待填写(含对象版本)
- 实施计划引用:待填写(含增量与需求 ID)
- 测试计划引用:待填写(含需求 ID 与验收条件)
- 方案:声明即展示元数据——扩展面只加注册口与规格类型;记录与下发复用 WP3-I4 的注册面摘要通道(applyCompiled→srv.CompiledPlugins);前端按声明 id 映射内置组件(rdm.audit→RdmAuditWorkspace),未知 id 显式占位(版本不匹配可见可诊断);入口门控与 KTD4 一致:内置区仅 isAdmin,声明区全员,区内能力由组件命令面判定。
- 实施计划:Backend(extension.go/surface.txt/compiled.go/server.go + 单测)→ Frontend(contracts/api/store/TaskSidebar/AdminZone)→ RDM(pins bump + plugin.go 声明)→ Dev gitlink → make test → 证据三段 → PR。
- 测试计划:R1/R2 Go 单测;R3 vitest+tsc+knip+design-guard;R4 RDM make test+CI;R5 Dev 组合 make test(CI GATE)+ 部署 curl(SELF)。
## 阶段评审