diff --git a/.task/feature-adminzone-plugin-sections.md b/.task/feature-adminzone-plugin-sections.md index 705f12cc..78d5df5b 100644 --- a/.task/feature-adminzone-plugin-sections.md +++ b/.task/feature-adminzone-plugin-sections.md @@ -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)。 ## 阶段评审 diff --git a/modules/backend b/modules/backend index 9aa51e52..a80d3c33 160000 --- a/modules/backend +++ b/modules/backend @@ -1 +1 @@ -Subproject commit 9aa51e52505e5b43d57a72d261ab192f43461e38 +Subproject commit a80d3c335977b9731ea71e186cce2f90493dfbb2 diff --git a/modules/frontend b/modules/frontend index 01b853fd..c1225bb8 160000 --- a/modules/frontend +++ b/modules/frontend @@ -1 +1 @@ -Subproject commit 01b853fd0ecd4d24df929b9405d0ab9baa5bc408 +Subproject commit c1225bb8803f3dcbcb7341b76bb069677a24af25