权限系统：完成接口级权限系统第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>

backend/app/models/study.py

@@ -1,3 +1,6 @@
+from __future__ import annotations
+from typing import Optional
+
 import uuid
 from datetime import date, datetime
 
@@ -14,27 +17,27 @@ class Study(Base):
     id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
     code: Mapped[str] = mapped_column(String(50), unique=True, nullable=False, index=True)
     name: Mapped[str] = mapped_column(String(200), nullable=False)
-    project_full_name: Mapped[str | None] = mapped_column(String(500), nullable=True)
-    sponsor: Mapped[str | None] = mapped_column(String(200), nullable=True)
-    protocol_no: Mapped[str | None] = mapped_column(String(100), nullable=True)
-    lead_unit: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    principal_investigator: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    main_pm: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    research_analysis: Mapped[str | None] = mapped_column(Text, nullable=True)
-    research_product: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    control_product: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    indication: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    research_population: Mapped[str | None] = mapped_column(String(255), nullable=True)
-    research_design: Mapped[str | None] = mapped_column(Text, nullable=True)
-    plan_start_date: Mapped[date | None] = mapped_column(Date, nullable=True)
-    plan_end_date: Mapped[date | None] = mapped_column(Date, nullable=True)
-    planned_site_count: Mapped[int | None] = mapped_column(Integer, nullable=True)
-    planned_enrollment_count: Mapped[int | None] = mapped_column(Integer, nullable=True)
-    enrollment_monthly_goal_note: Mapped[str | None] = mapped_column(Text, nullable=True)
-    enrollment_stage_breakdown: Mapped[str | None] = mapped_column(Text, nullable=True)
-    phase: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    project_full_name: Mapped[Optional[str]] = mapped_column(String(500), nullable=True)
+    sponsor: Mapped[Optional[str]] = mapped_column(String(200), nullable=True)
+    protocol_no: Mapped[Optional[str]] = mapped_column(String(100), nullable=True)
+    lead_unit: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    principal_investigator: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    main_pm: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    research_analysis: Mapped[Optional[str]] = mapped_column(Text, nullable=True)
+    research_product: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    control_product: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    indication: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    research_population: Mapped[Optional[str]] = mapped_column(String(255), nullable=True)
+    research_design: Mapped[Optional[str]] = mapped_column(Text, nullable=True)
+    plan_start_date: Mapped[Optional[date]] = mapped_column(Date, nullable=True)
+    plan_end_date: Mapped[Optional[date]] = mapped_column(Date, nullable=True)
+    planned_site_count: Mapped[Optional[int]] = mapped_column(Integer, nullable=True)
+    planned_enrollment_count: Mapped[Optional[int]] = mapped_column(Integer, nullable=True)
+    enrollment_monthly_goal_note: Mapped[Optional[str]] = mapped_column(Text, nullable=True)
+    enrollment_stage_breakdown: Mapped[Optional[str]] = mapped_column(Text, nullable=True)
+    phase: Mapped[Optional[str]] = mapped_column(String(50), nullable=True)
     status: Mapped[str] = mapped_column(String(20), nullable=False, default="DRAFT")
     is_locked: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
     visit_schedule: Mapped[list[dict]] = mapped_column(JSON, nullable=False, default=list)
-    created_by: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id"), nullable=True)
+    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id"), nullable=True)
     created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False, server_default=func.now())