权限系统：完成接口级权限系统第6阶段（测试与文档）

## 主要完成内容 ### 1. 接口级权限系统实现 - 新增 ApiEndpointPermission 模型：存储接口级权限配置 - 新增 ApiEndpointRegistry 模型：注册系统中所有API端点 - 实现权限检查优先级：接口级 > 模块级（向后兼容） - 支持细粒度权限控制（METHOD:/path 格式） ### 2. 权限配置系统 - 创建 api_permissions.py：集中管理接口权限配置 - 定义 API_ENDPOINT_PERMISSIONS：所有端点的权限映射 - 定义 MODULE_TO_ENDPOINTS：模块到接口的映射（向后兼容） - 支持默认角色配置和权限继承 ### 3. 权限检查依赖注入 - 新增 require_api_permission()：基于接口的权限检查 - 新增 @register_api_endpoint 装饰器：端点元数据注册 - 集成 FastAPI 依赖注入系统 - 支持权限拒绝时返回 403 Forbidden ### 4. API端点迁移（第1批） - 迁移 subjects 模块：5个端点 - 迁移 risk_issues 模块：3个端点 - 迁移 fees 模块：8个端点 - 迁移 finance_contracts 模块：5个端点 - 共计 21 个端点完成迁移 ### 5. 权限管理API - GET /studies/{study_id}/api-permissions：获取权限矩阵 - PUT /studies/{study_id}/api-permissions：更新权限矩阵 - 支持权限配置的查询和修改 ### 6. 测试与验证 - 单元测试：12 个测试用例，全部通过 - 集成测试：11 个权限管理API测试，全部通过 - 端点测试：22 个已迁移端点测试，全部通过 - 代码覆盖率：87%（超过 80% 目标） - 总计：45 个测试用例，全部通过 ### 7. 文档 - TESTING_SUMMARY.md：详细的测试结果总结 - IMPLEMENTATION_SUMMARY.md：实现细节文档 - TESTING_GUIDE.md：测试指南 ## 技术亮点 1. **向后兼容性**：保留模块级权限，接口级权限优先 2. **灵活的权限配置**：支持默认角色和自定义权限 3. **细粒度控制**：支持跨模块数据访问权限 4. **完整的测试覆盖**：单元测试、集成测试、端点测试 5. **清晰的权限检查流程**：接口级 → 模块级 → 拒绝 ## 下一步工作 - [ ] 第7阶段：迁移第2批模块（members, sites） - [ ] 第8阶段：迁移第3批模块 - [ ] 第9阶段：安全审计 - [ ] 第10阶段：性能测试 - [ ] 第11阶段：文档更新 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-05-13 15:18:02 +08:00
parent a17f4cc522
commit 0cc87210af
59 changed files with 3368 additions and 230 deletions
@@ -0,0 +1,291 @@
+"""接口级权限配置
+
+定义系统中所有API端点的权限配置，支持细粒度的接口级权限控制。
+"""
+
+from __future__ import annotations
+
+# 接口级权限配置
+# 格式: "METHOD:/path": {配置信息}
+API_ENDPOINT_PERMISSIONS = {
+    # 参与者管理 (subjects)
+    "POST:/subjects": {
+        "module": "subjects",
+        "action": "write",
+        "description": "创建参与者",
+        "default_roles": ["PM", "CRA"],
+    },
+    "GET:/subjects": {
+        "module": "subjects",
+        "action": "read",
+        "description": "查询参与者列表",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "GET:/subjects/{id}": {
+        "module": "subjects",
+        "action": "read",
+        "description": "查询参与者详情",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "PATCH:/subjects/{id}": {
+        "module": "subjects",
+        "action": "write",
+        "description": "更新参与者",
+        "default_roles": ["PM", "CRA"],
+    },
+    "DELETE:/subjects/{id}": {
+        "module": "subjects",
+        "action": "write",
+        "description": "删除参与者",
+        "default_roles": ["PM"],
+    },
+    # 访视管理 (visits)
+    "POST:/subjects/{subject_id}/visits": {
+        "module": "subjects",
+        "action": "write",
+        "description": "创建访视",
+        "default_roles": ["PM", "CRA"],
+    },
+    "GET:/subjects/{subject_id}/visits": {
+        "module": "subjects",
+        "action": "read",
+        "description": "查询访视列表",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "GET:/subjects/{subject_id}/visits/{visit_id}": {
+        "module": "subjects",
+        "action": "read",
+        "description": "查询访视详情",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "PATCH:/subjects/{subject_id}/visits/{visit_id}": {
+        "module": "subjects",
+        "action": "write",
+        "description": "更新访视",
+        "default_roles": ["PM", "CRA"],
+    },
+    # 不良事件 (SAE)
+    "POST:/risk-issues": {
+        "module": "risk_issues",
+        "action": "write",
+        "description": "创建不良事件",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW"],
+    },
+    "GET:/risk-issues": {
+        "module": "risk_issues",
+        "action": "read",
+        "description": "查询不良事件列表",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "GET:/risk-issues/{id}": {
+        "module": "risk_issues",
+        "action": "read",
+        "description": "查询不良事件详情",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "PATCH:/risk-issues/{id}": {
+        "module": "risk_issues",
+        "action": "write",
+        "description": "更新不良事件",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW"],
+    },
+    "DELETE:/risk-issues/{id}": {
+        "module": "risk_issues",
+        "action": "write",
+        "description": "删除不良事件",
+        "default_roles": ["PM"],
+    },
+    # 财务合同管理 (finance_contracts)
+    "POST:/finance/contracts": {
+        "module": "fees",
+        "action": "write",
+        "description": "创建财务合同",
+        "default_roles": ["PM"],
+    },
+    "GET:/finance/contracts": {
+        "module": "fees",
+        "action": "read",
+        "description": "查询财务合同列表",
+        "default_roles": ["PM", "CRA", "IMP"],
+    },
+    "GET:/finance/contracts/{id}": {
+        "module": "fees",
+        "action": "read",
+        "description": "查询财务合同详情",
+        "default_roles": ["PM", "CRA", "IMP"],
+    },
+    "PATCH:/finance/contracts/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "更新财务合同",
+        "default_roles": ["PM"],
+    },
+    "DELETE:/finance/contracts/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "删除财务合同",
+        "default_roles": ["PM"],
+    },
+    # 费用管理 (fees)
+    "POST:/fees/contracts": {
+        "module": "fees",
+        "action": "write",
+        "description": "创建费用合同",
+        "default_roles": ["PM"],
+    },
+    "GET:/fees/contracts": {
+        "module": "fees",
+        "action": "read",
+        "description": "查询费用合同列表",
+        "default_roles": ["PM", "CRA", "IMP"],
+    },
+    "GET:/fees/contracts/{id}": {
+        "module": "fees",
+        "action": "read",
+        "description": "查询费用合同详情",
+        "default_roles": ["PM", "CRA", "IMP"],
+    },
+    "PATCH:/fees/contracts/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "更新费用合同",
+        "default_roles": ["PM"],
+    },
+    "DELETE:/fees/contracts/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "删除费用合同",
+        "default_roles": ["PM"],
+    },
+    "POST:/fees/contracts/{id}/payments": {
+        "module": "fees",
+        "action": "write",
+        "description": "创建费用分期",
+        "default_roles": ["PM"],
+    },
+    "PATCH:/fees/payments/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "更新费用分期",
+        "default_roles": ["PM"],
+    },
+    "DELETE:/fees/payments/{id}": {
+        "module": "fees",
+        "action": "write",
+        "description": "删除费用分期",
+        "default_roles": ["PM"],
+    },
+    # 项目成员管理
+    "POST:/project-members": {
+        "module": "project_members",
+        "action": "write",
+        "description": "添加项目成员",
+        "default_roles": ["PM"],
+    },
+    "GET:/project-members": {
+        "module": "project_members",
+        "action": "read",
+        "description": "查询项目成员列表",
+        "default_roles": ["PM"],
+    },
+    "PATCH:/project-members/{id}": {
+        "module": "project_members",
+        "action": "write",
+        "description": "更新项目成员",
+        "default_roles": ["PM"],
+    },
+    # 中心管理
+    "POST:/sites": {
+        "module": "sites",
+        "action": "write",
+        "description": "创建中心",
+        "default_roles": ["PM"],
+    },
+    "GET:/sites": {
+        "module": "sites",
+        "action": "read",
+        "description": "查询中心列表",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "GET:/sites/{id}": {
+        "module": "sites",
+        "action": "read",
+        "description": "查询中心详情",
+        "default_roles": ["PM", "CRA", "PV", "MEDICAL_REVIEW", "IMP", "QA"],
+    },
+    "PATCH:/sites/{id}": {
+        "module": "sites",
+        "action": "write",
+        "description": "更新中心",
+        "default_roles": ["PM"],
+    },
+}
+
+# 向后兼容：模块级权限到接口级权限的映射
+# 用于在接口级权限未配置时，回退到模块级权限
+MODULE_TO_ENDPOINTS: dict[str, dict[str, list[str]]] = {
+    "subjects": {
+        "read": [
+            "GET:/subjects",
+            "GET:/subjects/{id}",
+            "GET:/subjects/{subject_id}/visits",
+            "GET:/subjects/{subject_id}/visits/{visit_id}",
+        ],
+        "write": [
+            "POST:/subjects",
+            "PATCH:/subjects/{id}",
+            "DELETE:/subjects/{id}",
+            "POST:/subjects/{subject_id}/visits",
+            "PATCH:/subjects/{subject_id}/visits/{visit_id}",
+        ],
+    },
+    "risk_issues": {
+        "read": [
+            "GET:/risk-issues",
+            "GET:/risk-issues/{id}",
+        ],
+        "write": [
+            "POST:/risk-issues",
+            "PATCH:/risk-issues/{id}",
+            "DELETE:/risk-issues/{id}",
+        ],
+    },
+    "fees": {
+        "read": [
+            "GET:/fees/contracts",
+            "GET:/fees/contracts/{id}",
+            "GET:/finance/contracts",
+            "GET:/finance/contracts/{id}",
+        ],
+        "write": [
+            "POST:/fees/contracts",
+            "PATCH:/fees/contracts/{id}",
+            "DELETE:/fees/contracts/{id}",
+            "POST:/fees/contracts/{id}/payments",
+            "PATCH:/fees/payments/{id}",
+            "DELETE:/fees/payments/{id}",
+            "POST:/finance/contracts",
+            "PATCH:/finance/contracts/{id}",
+            "DELETE:/finance/contracts/{id}",
+        ],
+    },
+    "project_members": {
+        "read": [
+            "GET:/project-members",
+        ],
+        "write": [
+            "POST:/project-members",
+            "PATCH:/project-members/{id}",
+        ],
+    },
+    "sites": {
+        "read": [
+            "GET:/sites",
+            "GET:/sites/{id}",
+        ],
+        "write": [
+            "POST:/sites",
+            "PATCH:/sites/{id}",
+        ],
+    },
+}