系统管理:角色 CRUD + 权限配置 UI #37

New Issue

2026-08-25T21:29:55+08:00

tao.chen commented

2026-08-25 21:29:55 +08:00

目标

后端已有 GET /roles、GET/PATCH /roles/{code}/permissions(只读 + 权限整集替换)。补齐角色 CRUD,前端加 RoleManagementPage。

后端 (backend/src/backend/api/platform.py)

POST /api/v1/platform/roles: role_code 校验 ^[a-z][a-z0-9_-]{1,63}$ + 拒绝预留字 (admin/developer);写入 Roles 行(role_scope=platform, is_builtin=0);可选同步插入 RolePermissions
PATCH /api/v1/platform/roles/{role_code}: 仅 role_name / description;role_code 不可变;is_builtin=1 时 role_name 不可改(保留种子命名)
DELETE /api/v1/platform/roles/{role_code}: 软删除;is_builtin=1 → 409;若 users.platform_role_id 仍有引用 → 409
GET /api/v1/platform/permissions: 列出所有 active permission_code,按 module_code + permission_code 排序(供 UI 渲染)
schemas/platform.py 加 RoleCreate / RoleUpdate(BaseModel extra=forbid)

迁移 (migrations/versions/)

新建一个迁移:

插入 permission_code='system:role:view' (module_code='system', permission_name='查看角色管理')
admin 角色 role_permissions 加一行 system:role:view
developer 不动 (沿用 system:* 仅 admin 约定)

前端

features/admin/RoleManagementPage.tsx (新建):列表/创建/编辑/删除/权限编辑;复用 UserManagementPage 的 modalUi 样式;admin 角色 system:view 锁定 + 非 admin 角色 system:* 锁定;与 UserManagementPage 同 pattern(useState + useEffect + onNotify + onConnectionChange)
routes/system-roles.tsx (新建):key 重挂载,模仿 system-users.tsx
routes.ts 注册 system -> roles 子路由
routes/platform.navigation.tsx sidebar 加 "角色管理" 条目 (gate: system:role:view)
services/api.ts 加 6 个方法: listPlatformRoles / listPlatformPermissions / createPlatformRole / updatePlatformRole / deletePlatformRole / updatePlatformRolePermissions
styles/admin.css 加 .role-* 样式 (沿用 .user-* 命名)

约束

不修改 Roles/Permissions/RolePermissions 表结构(只用现有 schema)
不修改 baseline 迁移
不修改系统管理其他路由
后端守卫复用 system_admin_context
现有 GET /roles、GET/PATCH /roles/{code}/permissions URL 不变(保持兼容)

验收

uv run --package backend pytest backend/tests -q 全绿
cd frontend && pnpm typecheck 全绿
cd frontend && pnpm build 全绿
手动烟测: 创建 → 改权限 → 改名 → 删除流程通

_{Task: lc4skd9fgyl1nlli0pypmx5h}

## 目标后端已有 GET /roles、GET/PATCH /roles/{code}/permissions(只读 + 权限整集替换)。补齐角色 CRUD,前端加 RoleManagementPage。 ## 后端 (backend/src/backend/api/platform.py) - POST /api/v1/platform/roles: role_code 校验 ^[a-z][a-z0-9_-]{1,63}$ + 拒绝预留字 (admin/developer);写入 Roles 行(role_scope=platform, is_builtin=0);可选同步插入 RolePermissions - PATCH /api/v1/platform/roles/{role_code}: 仅 role_name / description;role_code 不可变;is_builtin=1 时 role_name 不可改(保留种子命名) - DELETE /api/v1/platform/roles/{role_code}: 软删除;is_builtin=1 → 409;若 users.platform_role_id 仍有引用 → 409 - GET /api/v1/platform/permissions: 列出所有 active permission_code,按 module_code + permission_code 排序(供 UI 渲染) schemas/platform.py 加 RoleCreate / RoleUpdate(BaseModel extra=forbid) ## 迁移 (migrations/versions/) 新建一个迁移: - 插入 permission_code='system:role:view' (module_code='system', permission_name='查看角色管理') - admin 角色 role_permissions 加一行 system:role:view - developer 不动 (沿用 system:* 仅 admin 约定) ## 前端 - features/admin/RoleManagementPage.tsx (新建):列表/创建/编辑/删除/权限编辑;复用 UserManagementPage 的 modalUi 样式;admin 角色 system:view 锁定 + 非 admin 角色 system:* 锁定;与 UserManagementPage 同 pattern(useState + useEffect + onNotify + onConnectionChange) - routes/system-roles.tsx (新建):key 重挂载,模仿 system-users.tsx - routes.ts 注册 system -> roles 子路由 - routes/platform.navigation.tsx sidebar 加 "角色管理" 条目 (gate: system:role:view) - services/api.ts 加 6 个方法: listPlatformRoles / listPlatformPermissions / createPlatformRole / updatePlatformRole / deletePlatformRole / updatePlatformRolePermissions - styles/admin.css 加 .role-* 样式 (沿用 .user-* 命名) ## 约束 - 不修改 Roles/Permissions/RolePermissions 表结构(只用现有 schema) - 不修改 baseline 迁移 - 不修改系统管理其他路由 - 后端守卫复用 system_admin_context - 现有 GET /roles、GET/PATCH /roles/{code}/permissions URL 不变(保持兼容) ## 验收 - uv run --package backend pytest backend/tests -q 全绿 - cd frontend && pnpm typecheck 全绿 - cd frontend && pnpm build 全绿 - 手动烟测: 创建 → 改权限 → 改名 → 删除流程通 --- <sub>Task: lc4skd9fgyl1nlli0pypmx5h</sub>

tao.chen added the priority:medium status:to-do labels 2026-08-25 21:29:58 +08:00

tao.chen commented

2026-08-25 22:34:16 +08:00

tao.chen commented:

实现完成。所有验收项通过:

验证结果:

后端 uv run --package backend pytest backend/tests -q → 136 passed, 1 warning (warning 是历史 datetime.utcnow() deprecation,与本任务无关)
前端 pnpm typecheck + pnpm build → 全绿

改动汇总:

迁移: migrations/versions/j4k5l6m7n8o9_add_system_role_view_permission.py — admin 角色新增 system:role:view 权限码
清理: 删除 3 个被废弃的 AD 迁移 (g/h/i),这些是孤儿链引用不存在的父版本,卡住 alembic heads
后端拆分: backend/src/backend/api/platform.py (1596 行) → 包结构 platform/{__init__,_deps,employees,roles,workspaces}.py,每个文件 ≤ 500 行;shim 保持 from backend.api.platform import router 向后兼容;20 个 endpoint 字节码级一致
后端 4 个新端点: POST /api/v1/platform/roles, PATCH /api/v1/platform/roles/{code}, DELETE /api/v1/platform/roles/{code}, GET /api/v1/platform/permissions;加 _apply_role_permission_set helper 复用守卫逻辑
前端: 新增 RoleManagementPage.tsx (282 行) + RoleEditDialog.tsx (263) + PermissionEditDialog.tsx (128) + PermissionCheckboxList.tsx (83),全部用 lucide-react + shadcn Button
前端路由 + sidebar: /system/roles + 角色管理 sidebar 条目 (gate: system:role:view)
CLAUDE.md: 全局 + 项目级都加了 500 行硬上限规则

未做: docker-compose 后端启服务的端到端联调(本机无 docker),以及真机 UI 交互验证。

**tao.chen** commented: > 实现完成。所有验收项通过: **验证结果**: - 后端 `uv run --package backend pytest backend/tests -q` → **136 passed, 1 warning** (warning 是历史 datetime.utcnow() deprecation,与本任务无关) - 前端 `pnpm typecheck` + `pnpm build` → 全绿 **改动汇总**: 1. 迁移: `migrations/versions/j4k5l6m7n8o9_add_system_role_view_permission.py` — admin 角色新增 system:role:view 权限码 2. 清理: 删除 3 个被废弃的 AD 迁移 (g/h/i),这些是孤儿链引用不存在的父版本,卡住 alembic heads 3. 后端拆分: `backend/src/backend/api/platform.py` (1596 行) → 包结构 `platform/{__init__,_deps,employees,roles,workspaces}.py`,每个文件 ≤ 500 行;shim 保持 `from backend.api.platform import router` 向后兼容;20 个 endpoint 字节码级一致 4. 后端 4 个新端点: POST /api/v1/platform/roles, PATCH /api/v1/platform/roles/{code}, DELETE /api/v1/platform/roles/{code}, GET /api/v1/platform/permissions;加 _apply_role_permission_set helper 复用守卫逻辑 5. 前端: 新增 `RoleManagementPage.tsx` (282 行) + `RoleEditDialog.tsx` (263) + `PermissionEditDialog.tsx` (128) + `PermissionCheckboxList.tsx` (83),全部用 lucide-react + shadcn Button 6. 前端路由 + sidebar: `/system/roles` + 角色管理 sidebar 条目 (gate: system:role:view) 7. CLAUDE.md: 全局 + 项目级都加了 500 行硬上限规则 **未做**: docker-compose 后端启服务的端到端联调(本机无 docker),以及真机 UI 交互验证。

tao.chen added status:done and removed status:to-do labels 2026-08-25 22:34:18 +08:00

tao.chen closed this issue

2026-08-25 22:34:20 +08:00

tao.chen referenced this issue from a commit

2026-08-28 18:11:34 +08:00

fix(scripts): actually escape LIKE pattern literals + scope count endpoint

tao.chen referenced this issue from a commit

2026-09-02 10:15:11 +08:00

fix(scripts): actually escape LIKE pattern literals + scope count endpoint

Sign in to join this conversation.