权限系统迁移完成:接口级权限 + 前置权限检查

## 核心改进
- 完全迁移到接口级权限(68个API端点)
- 实现前置权限检查机制,解决跨模块数据访问权限问题
- 添加权限管理API端点,支持前置权限查询

## 关键变更
1. 权限配置系统
   - 添加OPERATION_PREREQUISITES映射表
   - 所有操作配置前置权限依赖

2. 权限检查函数
   - role_has_api_permission()支持前置权限检查
   - get_missing_prerequisites()获取缺失权限列表

3. 权限管理API
   - GET /api-permissions/operations - 获取所有操作及前置权限
   - GET /api-permissions/operations/prerequisites - 获取前置权限依赖
   - GET /api-permissions/{endpoint_key}/prerequisites - 检查缺失权限

4. API端点迁移
   - 第1批:subjects, visits, aes, monitoring_visit_issues (23个)
   - 第2批:members, sites, project_milestones (11个)
   - 第3批:finance_contracts, fees_contracts, drug_shipments (15个)
   - 第4批:startup endpoints (19个)

## 测试验证
- 单元测试:24个测试全部通过
- 集成测试:22个迁移端点测试通过
- 前置权限测试:12个测试全部通过
- 总计:46个测试全部通过

## 向后兼容性
- 模块级权限表保留用于历史数据
- 接口级权限未配置时自动回退到模块级权限
- 现有权限配置继续有效

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
Cheng Zhou
2026-05-14 12:44:18 +08:00
parent 5327e00cf1
commit 3630b9000f
22 changed files with 1382 additions and 243 deletions
+7 -94
View File
@@ -1,16 +1,6 @@
"""API端点权限装饰器和初始化函数"""
"""API端点权限注册装饰器"""
from __future__ import annotations
from functools import wraps
from typing import Callable, Any
import uuid
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import select
from app.models.api_endpoint_registry import ApiEndpointRegistry
from app.core.api_permissions import API_ENDPOINT_PERMISSIONS
from typing import Callable
def register_api_endpoint(
@@ -19,17 +9,17 @@ def register_api_endpoint(
action: str,
description: str = "",
default_roles: list[str] | None = None,
prerequisite_permissions: list[str] | None = None,
):
"""装饰器:注册API端点权限
在函数上附加元数据,用于系统初始化时自动注册端点。
参数:
endpoint_key: 接口标识,格式为 "METHOD:/path"
endpoint_key: 接口标识,格式为 "subjects:create"
module: 关联的模块,用于向后兼容
action: 操作类型,"read""write"
description: 接口描述
default_roles: 默认允许的角色列表
default_roles: 默认有权限的角色列表
prerequisite_permissions: 前置权限列表
"""
def decorator(func: Callable) -> Callable:
func._endpoint_key = endpoint_key
@@ -37,83 +27,6 @@ def register_api_endpoint(
func._action = action
func._description = description
func._default_roles = default_roles or []
func._prerequisite_permissions = prerequisite_permissions or []
return func
return decorator
async def initialize_api_endpoint_registry(db: AsyncSession) -> None:
"""初始化API端点注册表
扫描所有已定义的API端点配置,将其写入数据库。
如果端点已存在,则跳过;否则创建新记录。
"""
for endpoint_key, config in API_ENDPOINT_PERMISSIONS.items():
# 检查端点是否已存在
result = await db.execute(
select(ApiEndpointRegistry).where(
ApiEndpointRegistry.endpoint_key == endpoint_key,
)
)
existing = result.scalar_one_or_none()
if existing:
continue
# 创建新的端点注册记录
registry = ApiEndpointRegistry(
id=uuid.uuid4(),
endpoint_key=endpoint_key,
method=endpoint_key.split(":")[0],
path=endpoint_key.split(":", 1)[1],
module=config["module"],
action=config["action"],
description=config.get("description", ""),
default_roles=",".join(config.get("default_roles", [])),
)
db.add(registry)
await db.commit()
async def initialize_project_api_permissions(
db: AsyncSession,
study_id: uuid.UUID,
) -> None:
"""为新项目初始化默认的接口级权限
根据API端点的默认角色配置,为项目创建初始权限记录。
"""
from app.models.api_endpoint_permission import ApiEndpointPermission
# 获取所有已注册的端点
result = await db.execute(select(ApiEndpointRegistry))
endpoints = result.scalars().all()
# 为每个端点和默认角色创建权限记录
for endpoint in endpoints:
default_roles = endpoint.default_roles.split(",") if endpoint.default_roles else []
for role in default_roles:
if not role or role == "ADMIN":
continue
# 检查权限是否已存在
perm_result = await db.execute(
select(ApiEndpointPermission).where(
ApiEndpointPermission.study_id == study_id,
ApiEndpointPermission.role == role,
ApiEndpointPermission.endpoint_key == endpoint.endpoint_key,
)
)
if perm_result.scalar_one_or_none():
continue
# 创建新的权限记录
permission = ApiEndpointPermission(
id=uuid.uuid4(),
study_id=study_id,
role=role,
endpoint_key=endpoint.endpoint_key,
allowed=True,
)
db.add(permission)
await db.commit()