zhouchengcheng/ctms
1
1
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity

权限管理界面重构：角色概览、生效管理与编辑权限整合

Browse Source 
【界面优化】
- 移除权限模板列表和角色概览卡片上的"系统预设"标签，视觉上减少噪音
- 将 PermissionTemplateSelector 改为纯展示组件，重命名为"角色权限概览"
- 移除"应用此模板"按钮及预览面板，卡片仅展示各角色权限统计
- 角色描述改为鼠标悬浮 tooltip 显示，节省卡片空间
- 未生效角色以虚线边框 + 降低透明度区分，悬浮提示状态说明

【生效管理】
- Study 模型新增 active_roles JSON 字段，记录项目已生效角色列表
- 新增 /studies/{study_id}/active-roles GET/PUT 接口
- 数据库迁移 20260518_01：studies 表添加 active_roles 列
- 成员管理的项目角色下拉列表仅显示已生效角色，未生效角色不可分配

【模板管理抽屉重构】
- 抽屉改为三标签页：模板列表 / 生效管理 / 编辑权限
- 生效管理：开关控制各角色生效状态，保存后同步后端
- 编辑权限：左右分栏设计，左侧角色列表点击选中，右侧实时展示权限勾选
- 原独立的角色权限编辑抽屉合并至此，角色概览卡片"编辑权限"直接跳转对应标签页

【操作类型标签统一】
- 系统级权限和编辑权限界面的操作类型标签统一使用细分类型
- 操作类型从粗粒度 read/write 细化为 read/create/update/delete/export
- 颜色规范：读取灰色、创建绿色、更新黄色、删除红色、导出无色
- 权限模板管理接口限制为 ADMIN 角色，修复原先权限过宽的问题

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Cheng Zhou
2026-05-19 08:48:07 +08:00
parent 20ce6bccef
commit f8a959b801
15 changed files with 1650 additions and 268 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/app/api/v1/api_permissions.py
+8 -7
View File
@@ -165,16 +165,17 @@ async def get_study_api_permissions(
"""
permissions = await get_api_endpoint_permissions(db, study_id)
# 构建返回格式
# 构建返回格式（get_api_endpoint_permissions 已返回 {role: {key: {"allowed": bool}}}）
result: dict[str, dict[str, dict[str, bool]]] = {}
for role in PROJECT_PERMISSION_ROLES:
if role == "ADMIN":
continue
result[role] = {}
for endpoint_key in API_ENDPOINT_PERMISSIONS.keys():
result[role][endpoint_key] = {
"allowed": permissions.get(role, {}).get(endpoint_key, False)
}
perm = permissions.get(role, {}).get(endpoint_key, {"allowed": False})
# perm 已经是 {"allowed": bool}，直接使用
allowed = perm["allowed"] if isinstance(perm, dict) else bool(perm)
result[role][endpoint_key] = {"allowed": allowed}
return result
@@ -220,8 +221,8 @@ async def update_study_api_permissions(
continue
result[role] = {}
for endpoint_key in API_ENDPOINT_PERMISSIONS.keys():
result[role][endpoint_key] = {
"allowed": permissions.get(role, {}).get(endpoint_key, False)
}
perm = permissions.get(role, {}).get(endpoint_key, {"allowed": False})
allowed = perm["allowed"] if isinstance(perm, dict) else bool(perm)
result[role][endpoint_key] = {"allowed": allowed}
return result
backend/app/api/v1/permission_templates.py
+5 -4
View File
@@ -9,8 +9,9 @@ from fastapi import APIRouter, Depends, HTTPException, status
from fastapi.responses import Response
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.deps import get_current_user, get_db_session, require_study_roles
from app.core.deps import get_current_user, get_db_session, require_roles, require_study_roles
from app.models.permission_template import TemplateType
from app.models.user import UserRole
from app.schemas.permission_template import (
ApplyTemplateRequest,
ApplyTemplateResponse,
@@ -51,7 +52,7 @@ async def list_templates(
async def create_template(
payload: PermissionTemplateCreate,
db: Annotated[AsyncSession, Depends(get_db_session)] = None,
current_user=Depends(get_current_user),
current_user=Depends(require_roles([UserRole.ADMIN.value])),
) -> PermissionTemplateRead:
"""创建权限模板"""
try:
@@ -78,7 +79,7 @@ async def update_template(
template_id: uuid.UUID,
payload: PermissionTemplateUpdate,
db: Annotated[AsyncSession, Depends(get_db_session)] = None,
current_user=Depends(get_current_user),
current_user=Depends(require_roles([UserRole.ADMIN.value])),
) -> PermissionTemplateRead:
"""更新权限模板"""
try:
@@ -92,7 +93,7 @@ async def update_template(
async def delete_template(
template_id: uuid.UUID,
db: Annotated[AsyncSession, Depends(get_db_session)] = None,
current_user=Depends(get_current_user),
current_user=Depends(require_roles([UserRole.ADMIN.value])),
):
"""删除权限模板"""
try:
backend/app/api/v1/router.py
+3 -1
View File
@@ -1,6 +1,6 @@
from fastapi import APIRouter
from app.api.v1 import auth, users, admin_users, studies, sites, members, attachments, audit_logs, dashboard, subjects, visits, aes, finance_dashboard, finance_contracts, fees_contracts, fees_attachments, drug_shipments, material_equipments, project_milestones, startup, knowledge_notes, subject_histories, subject_pds, study_subject_pds, faq_categories, faqs, documents, overview, notifications, monitoring_visit_issues, api_permissions, permission_monitoring, permission_templates
from app.api.v1 import auth, users, admin_users, studies, sites, members, attachments, audit_logs, dashboard, subjects, visits, aes, finance_dashboard, finance_contracts, fees_contracts, fees_attachments, drug_shipments, material_equipments, project_milestones, startup, knowledge_notes, subject_histories, subject_pds, study_subject_pds, faq_categories, faqs, documents, overview, notifications, monitoring_visit_issues, api_permissions, permission_monitoring, permission_templates, system_permissions, study_active_roles
api_router = APIRouter()
@@ -40,3 +40,5 @@ api_router.include_router(documents.router, prefix="", tags=["documents"])
api_router.include_router(permission_monitoring.router)
api_router.include_router(permission_templates.router)
api_router.include_router(permission_templates.study_router, prefix="/studies/{study_id}", tags=["permission-templates"])
api_router.include_router(system_permissions.router)
api_router.include_router(study_active_roles.router, prefix="/studies/{study_id}", tags=["active-roles"])
backend/app/api/v1/study_active_roles.py
+44
View File
@@ -0,0 +1,44 @@
"""项目角色生效管理API"""
from __future__ import annotations
import uuid
from typing import Annotated
from fastapi import APIRouter, Depends, HTTPException, status
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.deps import get_db_session, require_study_roles
from app.models.study import Study
router = APIRouter(prefix="/active-roles", tags=["active-roles"])
@router.get("", summary="获取项目已生效角色列表")
async def get_active_roles(
study_id: uuid.UUID,
_=Depends(require_study_roles(["PM"])),
db: Annotated[AsyncSession, Depends(get_db_session)] = None,
) -> dict:
result = await db.execute(select(Study).where(Study.id == study_id))
study = result.scalar_one_or_none()
if not study:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="项目不存在")
return {"active_roles": study.active_roles or []}
@router.put("", summary="更新项目已生效角色列表")
async def update_active_roles(
study_id: uuid.UUID,
payload: dict,
_=Depends(require_study_roles(["PM"])),
db: Annotated[AsyncSession, Depends(get_db_session)] = None,
) -> dict:
result = await db.execute(select(Study).where(Study.id == study_id))
study = result.scalar_one_or_none()
if not study:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="项目不存在")
study.active_roles = payload.get("active_roles", [])
await db.commit()
return {"active_roles": study.active_roles}
backend/app/api/v1/system_permissions.py
+37
View File
@@ -0,0 +1,37 @@
"""系统级权限查询API"""
from __future__ import annotations
from fastapi import APIRouter, Depends
from app.core.deps import require_roles
from app.core.api_permissions import SYSTEM_PERMISSIONS, SYSTEM_MODULE_LABELS
from app.models.user import UserRole
router = APIRouter(prefix="/system-permissions", tags=["system-permissions"])
@router.get(
"",
summary="获取系统级权限定义",
description="返回管理后台所有系统级操作的权限定义，仅 ADMIN 可访问",
)
async def list_system_permissions(
_=Depends(require_roles([UserRole.ADMIN.value])),
) -> dict:
permissions_list = [
{
"permission_key": key,
"module": config["module"],
"module_label": SYSTEM_MODULE_LABELS.get(config["module"], config["module"]),
"action": config["action"],
"description": config["description"],
"roles": config["roles"],
}
for key, config in SYSTEM_PERMISSIONS.items()
]
return {
"permissions": permissions_list,
"module_labels": SYSTEM_MODULE_LABELS,
}