diff --git a/.task/feature-iam-role-permission-linked-capabilities-perm-ux.md b/.task/feature-iam-role-permission-linked-capabilities-perm-ux.md index 1e86be32..569aca81 100644 --- a/.task/feature-iam-role-permission-linked-capabilities-perm-ux.md +++ b/.task/feature-iam-role-permission-linked-capabilities-perm-ux.md @@ -7,7 +7,9 @@ - 分支类型:child;initiative_id:feature-iam-role-permission-linked-capabilities;root_target:main;immediate_target:feature/iam-role-permission-linked-capabilities;accepting_requirements:false;parent_branch:feature/iam-role-permission-linked-capabilities;parent_head_sha:90317d02a746ea3cd25021561ef40e8cd7498963;parent_pr:无;parent_source:origin - 需求分流:verdict=JOIN;selected_initiative=feature/iam-role-permission-linked-capabilities;requirement_sha256=6eab4bfaa1bb158cd0943427d00264a74059b77b967530dc7d7c32f2f9ada0fa;triage_receipt=/tmp/iam-perm-ux-triage.json;receipt_sha256=3dd33a2bd1a128579bd405339b682acbcd4f96c7b980ebb0941cd5c622ccebb7 -- 授权与交付终点:<本次允许的动作与终点;未授权事项写明> +- 授权与交付终点:按源码外方案 `/tmp/iam-permission-ux-plan-20261019-1dehpj7l/plan.md`(2026-10-19 评审稿,review.md 三项审阅 clean)实施 U1–U6:Backend 权限展示目录与关联预览合同、原子批量写入与读投影;Frontend 分类角色矩阵与单角色聚焦、用户/角色人员配置、项目有效权限说明;真实浏览器验收与组合交付。终点:子任务 PR 合入所属 L1 分支 `feature/iam-role-permission-linked-capabilities`(PR #628),组件 pin 随本任务推进;不部署、不迁移生产数据、不做日常实例采用(C16 保持 NOT_RUN 直至另行授权)。 +- 组件分支策略:Backend 工作分支 `feature/iam-perm-ux-backend`(基于 L1 U1 联动分支 `origin/feature/iam-link-u1-capability-association` @ afb65c5,消费其冻结的 `ProjectCreateLinkedActions`/`LinkedCapabilities` 合同);Frontend 工作分支基于组件 origin/main(6db528d,L1 前端单元尚未启动)。 +- 依赖协调:#628 L1 的 U1(联动 Backend)已完成并推送(afb65c5);L1 U2(单一角色权威)已登记待启动——其 `perms_api.go`/`hostcaps.go` 与本任务 `roles.go`/`role_policy.go` 不同区段,组合冲突由 L1 集成时解决;本任务不重写 L1 已实现的联动规则,只消费。 - 交付模式:goal-first(目标、范围和交付终点一次确认;范围内连续推进) - 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md) - 合入执行:agent(已授权交付范围内,Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入) @@ -15,7 +17,35 @@ ## 目标与非目标 -<预期结果、受影响入口/模块/契约;明确不做什么。> +**目标**(方案 R1–R17,用户验收 C01–C16):管理员无需理解技术权限字段即可看懂角色能做什么;默认业务分类矩阵可同时比较并编辑多个角色(三态控件:不允许/按项目授权/默认允许;系统动作仅允许/不允许);单角色聚焦复用同一草稿;统一预览与原子保存;用户列表显示当前角色并支持单人/多人批量角色分配(服务端目录选择器,不手输账号);复制角色并分配;系统自动处理创建项目联动并解释生效范围;项目有效权限说明。 + +**非目标**:多职位叠加、个人普通权限覆盖、通用权限引擎、审批系统、Excel 导入导出、批量系统管理授权、全库动态匹配选择;账号恢复/凭据管理(原入口);超级管理员保护(#627);成员共享读取语义(L1 U7);生产部署与日常实例采用。 + +## 实施单元(本任务) + +| 单元 | 范围 | 依赖 | +|---|---|---| +| permux-U1 权限展示与关联预览 | Backend `internal/authz/catalog/`、`internal/server/roles.go`、`internal/store/role_policy.go`、`pkg/extension/role_policy.go`:中文分类目录元数据、三态归一化、变更预览(含 #628 关联差异)、缺失/显式拒绝可区分 | L1 U1 合同(已冻结并实现 @ afb65c5) | +| permux-U2 原子批量写入与读投影 | Backend 同上 + `internal/server/account_search.go`:多角色 patch 事务、多用户角色分配事务、复制角色并分配事务;用户目录当前角色投影、角色成员目录 | permux-U1 | +| permux-U3 分类矩阵与单角色聚焦 | Frontend `RolePermissionsPanel.tsx`、`rolePermissions.ts`、`api.ts`、样式与测试 | permux-U1/U2 | +| permux-U4 用户与角色人员配置 | Frontend `AccountUsersPanel.tsx`、`AdminZone.tsx`、`api.ts`、人员选择器与测试 | permux-U2;与 #627 AccountUsersPanel 修改按顺序合并(#627 未动本分支时直接实施) | +| permux-U5 项目有效权限说明 | Frontend `adminRdmSections.tsx` 权限解释区;消费 L1 合同,L1 U3/U7 未组合前显式「联动服务未就绪」,不 mock | permux-U3/U4 + L1 真实规则 | +| permux-U6 真实浏览器验收与交付 | `e2e/iam-role-authority.playwright.ts` 扩充、组合 gitlink、Review/CI/合入(host 主导) | 全部 | + +## 需求分析 + +| ID | 描述 | 验收 | 结论 | +|---|---|---|---| +| R1–R7 | 角色配置:分类矩阵、三态控件、联动预览、中文文案(方案 Requirements — Role Configuration) | C01–C06, C11, C14 | 纳入 permux-U1/U3 | +| R8–R12 | 人员配置:目录检索、多选批量、复制分配、稳定 userId(方案 Requirements — User Configuration) | C07–C10, C14 | 纳入 permux-U2/U4 | +| R13–R17 | 可靠性与验收:原子事务、幂等、固定选择集、可访问性、真实验收(方案 Reliability and Acceptance) | C09, C12, C14, C15 | 纳入 permux-U2/U6 | +| C16 | 日常实例采用 | 运行版本核对 | NOT_RUN(未授权部署),单列记录 | + +## 风险与决策记录 + +- L1 U2(单一角色权威)与本任务均在途:本任务 Backend 基于联动分支 afb65c5,L1 后续单元合入时由 L1 集成解决;两单元文件区段不重叠(其 perms_api/hostcaps,本任务 roles/role_policy/account_search)。 +- 「创建项目→自动关联」运行时联动已在 L1 U1 实现(afb65c5);本任务 U1 的预览/展示直接消费 `catalog.ProjectCreateLinkedActions()` 与 `LinkedCapabilities`,不另建第二套关联规则。 +- L1 U7(成员共享读取)未实现:permux-U5 相关展示显式标注联动服务未就绪,不伪造;验收 C13 由 L1 U7 交付时闭环。 ## Agent 实施收据