ctms/backend/app/core/api_permissions.py

"""接口级权限配置

定义系统中所有API端点的权限配置，支持细粒度的接口级权限控制。
"""

from __future__ import annotations

# 接口级权限配置
# 格式: "业务操作名": {配置信息}
API_ENDPOINT_PERMISSIONS = {
    # 参与者管理 (subjects)
    "subjects:create": {
        "module": "subjects",
        "action": "write",
        "description": "创建参与者",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "subjects:list": {
        "module": "subjects",
        "action": "read",
        "description": "查询参与者列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subjects:read": {
        "module": "subjects",
        "action": "read",
        "description": "查询参与者详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subjects:update": {
        "module": "subjects",
        "action": "write",
        "description": "更新参与者",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "subjects:delete": {
        "module": "subjects",
        "action": "write",
        "description": "删除参与者",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    # 访视管理 (visits)
    "visits:create": {
        "module": "subjects",
        "action": "write",
        "description": "创建访视",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    "visits:list": {
        "module": "subjects",
        "action": "read",
        "description": "查询访视列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "visits:update": {
        "module": "subjects",
        "action": "write",
        "description": "更新访视",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    "visits:delete": {
        "module": "subjects",
        "action": "write",
        "description": "删除访视",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    # 参与者AE管理
    "subject_aes:create": {
        "module": "subjects",
        "action": "write",
        "description": "创建参与者AE",
        "default_roles": ["PM", "CRA", "PV", "QA"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    "subject_aes:list": {
        "module": "subjects",
        "action": "read",
        "description": "查询参与者AE列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subject_aes:read": {
        "module": "subjects",
        "action": "read",
        "description": "查询参与者AE详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subject_aes:update": {
        "module": "subjects",
        "action": "write",
        "description": "更新参与者AE",
        "default_roles": ["PM", "CRA", "PV", "QA"],
        "prerequisite_permissions": ["subject_aes:list", "subjects:read", "sites:read"],
    },
    "subject_aes:delete": {
        "module": "subjects",
        "action": "write",
        "description": "删除参与者AE",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["subject_aes:list", "subjects:read", "sites:read"],
    },
    # 合同费用管理 (fees_contracts)
    "fees_contracts:create": {
        "module": "fees",
        "action": "write",
        "description": "创建合同费用",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    "fees_contracts:list": {
        "module": "fees",
        "action": "read",
        "description": "查询合同费用列表",
        "default_roles": ["PM", "CRA", "CTA"],
        "prerequisite_permissions": [],
    },
    "fees_contracts:read": {
        "module": "fees",
        "action": "read",
        "description": "查询合同费用详情",
        "default_roles": ["PM", "CRA", "CTA"],
        "prerequisite_permissions": [],
    },
    "fees_contracts:update": {
        "module": "fees",
        "action": "write",
        "description": "更新合同费用",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    "fees_contracts:delete": {
        "module": "fees",
        "action": "write",
        "description": "删除合同费用",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    # 项目成员管理
    "project_members:create": {
        "module": "project_members",
        "action": "write",
        "description": "添加项目成员",
        "default_roles": ["PM"],
    },
    "project_members:list": {
        "module": "project_members",
        "action": "read",
        "description": "查询项目成员列表",
        "default_roles": ["PM"],
    },
    "project_members:candidates": {
        "module": "project_members",
        "action": "read",
        "description": "查询项目成员候选人",
        "default_roles": ["PM"],
    },
    "project_members:update": {
        "module": "project_members",
        "action": "write",
        "description": "更新项目成员",
        "default_roles": ["PM"],
    },
    "project_members:delete": {
        "module": "project_members",
        "action": "write",
        "description": "删除项目成员",
        "default_roles": ["PM"],
    },
    # 中心管理
    "sites:create": {
        "module": "sites",
        "action": "write",
        "description": "创建中心",
        "default_roles": ["PM"],
    },
    "sites:list": {
        "module": "sites",
        "action": "read",
        "description": "查询中心列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "sites:read": {
        "module": "sites",
        "action": "read",
        "description": "查询中心详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "sites:update": {
        "module": "sites",
        "action": "write",
        "description": "更新中心",
        "default_roles": ["PM"],
    },
    "sites:delete": {
        "module": "sites",
        "action": "write",
        "description": "删除中心",
        "default_roles": ["PM"],
    },
    # 伦理记录管理
    "startup_ethics:create": {
        "module": "startup_ethics",
        "action": "write",
        "description": "创建伦理记录",
        "default_roles": ["PM"],
    },
    "startup_ethics:list": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询伦理记录列表",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_ethics:read": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询伦理记录详情",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_ethics:update": {
        "module": "startup_ethics",
        "action": "write",
        "description": "更新伦理记录",
        "default_roles": ["PM"],
    },
    "startup_ethics:delete": {
        "module": "startup_ethics",
        "action": "write",
        "description": "删除伦理记录",
        "default_roles": ["PM"],
    },
    # 立项记录管理
    "startup_initiation:create": {
        "module": "startup_ethics",
        "action": "write",
        "description": "创建立项记录",
        "default_roles": ["PM"],
    },
    "startup_initiation:list": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询立项记录列表",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_initiation:read": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询立项记录详情",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_initiation:update": {
        "module": "startup_ethics",
        "action": "write",
        "description": "更新立项记录",
        "default_roles": ["PM"],
    },
    "startup_initiation:delete": {
        "module": "startup_ethics",
        "action": "write",
        "description": "删除立项记录",
        "default_roles": ["PM"],
    },
    # 项目概览
    "project_overview:read": {
        "module": "project_overview",
        "action": "read",
        "description": "查询项目概览",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": ["sites:read", "subjects:read"],
    },
    # 监查访视问题
    "monitoring_issues:list": {
        "module": "risk_issues",
        "action": "read",
        "description": "查询监查访视问题列表",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "monitoring_issues:read": {
        "module": "risk_issues",
        "action": "read",
        "description": "查询监查访视问题详情",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "monitoring_issues:create": {
        "module": "risk_issues",
        "action": "write",
        "description": "创建监查访视问题",
        "default_roles": ["PM", "CRA", "PV", "QA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "monitoring_issues:update": {
        "module": "risk_issues",
        "action": "write",
        "description": "更新监查访视问题",
        "default_roles": ["PM", "CRA", "PV", "QA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "monitoring_issues:delete": {
        "module": "risk_issues",
        "action": "write",
        "description": "删除监查访视问题",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    # 药物发货管理
    "drug_shipments:create": {
        "module": "materials",
        "action": "write",
        "description": "创建药物发货",
        "default_roles": ["PM", "CTA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "drug_shipments:list": {
        "module": "materials",
        "action": "read",
        "description": "查询药物发货列表",
        "default_roles": ["PM", "CRA", "CTA"],
        "prerequisite_permissions": [],
    },
    "drug_shipments:read": {
        "module": "materials",
        "action": "read",
        "description": "查询药物发货详情",
        "default_roles": ["PM", "CRA", "CTA"],
        "prerequisite_permissions": [],
    },
    "drug_shipments:update": {
        "module": "materials",
        "action": "write",
        "description": "更新药物发货",
        "default_roles": ["PM", "CTA"],
        "prerequisite_permissions": ["sites:read"],
    },
    "drug_shipments:delete": {
        "module": "materials",
        "action": "write",
        "description": "删除药物发货",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["sites:read"],
    },
    # 参与者PD管理
    "subject_pds:create": {
        "module": "subjects",
        "action": "write",
        "description": "创建参与者PD",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    "subject_pds:list": {
        "module": "subjects",
        "action": "read",
        "description": "查询参与者PD列表",
        "default_roles": ["PM", "CRA", "PV", "QA"],
        "prerequisite_permissions": [],
    },
    "subject_pds:update": {
        "module": "subjects",
        "action": "write",
        "description": "更新参与者PD",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    "subject_pds:delete": {
        "module": "subjects",
        "action": "write",
        "description": "删除参与者PD",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["subjects:read", "sites:read"],
    },
    # 审计日志管理
    "audit_logs:list": {
        "module": "audit_export",
        "action": "read",
        "description": "查询审计日志列表",
        "default_roles": ["PM"],
    },
    "audit_logs:read": {
        "module": "audit_export",
        "action": "read",
        "description": "查询审计日志详情",
        "default_roles": ["PM"],
    },
    "audit_logs:export": {
        "module": "audit_export",
        "action": "read",
        "description": "导出审计日志",
        "default_roles": ["PM"],
    },
    # 注意事项管理
    "precautions:create": {
        "module": "shared_library",
        "action": "write",
        "description": "创建注意事项",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "precautions:list": {
        "module": "shared_library",
        "action": "read",
        "description": "查询注意事项列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "precautions:read": {
        "module": "shared_library",
        "action": "read",
        "description": "查询注意事项详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "precautions:update": {
        "module": "shared_library",
        "action": "write",
        "description": "更新注意事项",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "precautions:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除注意事项",
        "default_roles": ["PM"],
    },
    # 立项配置管理
    "setup_config:read": {
        "module": "setup_config",
        "action": "read",
        "description": "查询立项配置",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "setup_config:update": {
        "module": "setup_config",
        "action": "write",
        "description": "保存立项配置草稿",
        "default_roles": ["PM"],
    },
    "setup_config:publish": {
        "module": "setup_config",
        "action": "write",
        "description": "发布立项配置",
        "default_roles": ["PM"],
    },
    "setup_config:rollback": {
        "module": "setup_config",
        "action": "write",
        "description": "回滚立项配置版本",
        "default_roles": ["PM"],
    },
    "setup_config:delete_version": {
        "module": "setup_config",
        "action": "write",
        "description": "删除立项配置版本",
        "default_roles": ["PM"],
    },
    # 项目里程碑管理
    "project_milestones:read": {
        "module": "project_milestones",
        "action": "read",
        "description": "查询项目里程碑列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "project_milestones:update": {
        "module": "project_milestones",
        "action": "write",
        "description": "更新项目里程碑",
        "default_roles": ["PM"],
    },
    # 启动与授权
    "startup_auth:create": {
        "module": "startup_auth",
        "action": "write",
        "description": "创建启动会或培训授权",
        "default_roles": ["PM"],
    },
    "startup_auth:read": {
        "module": "startup_auth",
        "action": "read",
        "description": "查询启动会或培训授权",
        "default_roles": ["PM", "CRA", "PV", "CTA"],
    },
    "startup_auth:update": {
        "module": "startup_auth",
        "action": "write",
        "description": "更新启动会或培训授权",
        "default_roles": ["PM"],
    },
    "startup_auth:delete": {
        "module": "startup_auth",
        "action": "write",
        "description": "删除培训授权",
        "default_roles": ["PM"],
    },
    # 模块附件管理
    "fees_contracts_attachments:create": {
        "module": "fees",
        "action": "write",
        "description": "上传合同费用附件",
        "default_roles": ["PM"],
    },
    "fees_contracts_attachments:read": {
        "module": "fees",
        "action": "read",
        "description": "查询合同费用附件",
        "default_roles": ["PM", "CRA", "CTA"],
    },
    "fees_contracts_attachments:delete": {
        "module": "fees",
        "action": "write",
        "description": "删除合同费用附件",
        "default_roles": ["PM"],
    },
    "startup_initiation_attachments:create": {
        "module": "startup_ethics",
        "action": "write",
        "description": "上传立项记录附件",
        "default_roles": ["PM"],
    },
    "startup_initiation_attachments:read": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询立项记录附件",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_initiation_attachments:delete": {
        "module": "startup_ethics",
        "action": "write",
        "description": "删除立项记录附件",
        "default_roles": ["PM"],
    },
    "startup_ethics_attachments:create": {
        "module": "startup_ethics",
        "action": "write",
        "description": "上传伦理记录附件",
        "default_roles": ["PM"],
    },
    "startup_ethics_attachments:read": {
        "module": "startup_ethics",
        "action": "read",
        "description": "查询伦理记录附件",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "startup_ethics_attachments:delete": {
        "module": "startup_ethics",
        "action": "write",
        "description": "删除伦理记录附件",
        "default_roles": ["PM"],
    },
    "startup_auth_attachments:create": {
        "module": "startup_auth",
        "action": "write",
        "description": "上传启动授权附件",
        "default_roles": ["PM"],
    },
    "startup_auth_attachments:read": {
        "module": "startup_auth",
        "action": "read",
        "description": "查询启动授权附件",
        "default_roles": ["PM", "CRA", "PV", "CTA"],
    },
    "startup_auth_attachments:delete": {
        "module": "startup_auth",
        "action": "write",
        "description": "删除启动授权附件",
        "default_roles": ["PM"],
    },
    "drug_shipments_attachments:create": {
        "module": "materials",
        "action": "write",
        "description": "上传药物发货附件",
        "default_roles": ["PM", "CTA"],
    },
    "drug_shipments_attachments:read": {
        "module": "materials",
        "action": "read",
        "description": "查询药物发货附件",
        "default_roles": ["PM", "CRA", "CTA"],
    },
    "drug_shipments_attachments:delete": {
        "module": "materials",
        "action": "write",
        "description": "删除药物发货附件",
        "default_roles": ["PM"],
    },
    "precautions_attachments:create": {
        "module": "shared_library",
        "action": "write",
        "description": "上传注意事项附件",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "precautions_attachments:read": {
        "module": "shared_library",
        "action": "read",
        "description": "查询注意事项附件",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "precautions_attachments:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除注意事项附件",
        "default_roles": ["PM"],
    },
    "faq_attachments:create": {
        "module": "shared_library",
        "action": "write",
        "description": "上传FAQ附件",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "faq_attachments:read": {
        "module": "shared_library",
        "action": "read",
        "description": "查询FAQ附件",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "faq_attachments:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除FAQ附件",
        "default_roles": ["PM"],
    },
    # FAQ管理
    "faq:create": {
        "module": "shared_library",
        "action": "write",
        "description": "创建FAQ",
        "default_roles": ["PM"],
    },
    "faq:read": {
        "module": "shared_library",
        "action": "read",
        "description": "查询FAQ",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "faq:update": {
        "module": "shared_library",
        "action": "write",
        "description": "更新FAQ",
        "default_roles": ["PM"],
    },
    "faq:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除FAQ",
        "default_roles": ["PM"],
    },
    # FAQ分类管理
    "faq_category:create": {
        "module": "shared_library",
        "action": "write",
        "description": "创建FAQ分类",
        "default_roles": ["PM"],
    },
    "faq_category:read": {
        "module": "shared_library",
        "action": "read",
        "description": "查询FAQ分类",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "faq_category:update": {
        "module": "shared_library",
        "action": "write",
        "description": "更新FAQ分类",
        "default_roles": ["PM"],
    },
    "faq_category:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除FAQ分类",
        "default_roles": ["PM"],
    },
    # FAQ回复管理
    "faq_reply:create": {
        "module": "shared_library",
        "action": "write",
        "description": "创建FAQ回复",
        "default_roles": ["PM", "CRA", "PV", "QA"],
    },
    "faq_reply:delete": {
        "module": "shared_library",
        "action": "write",
        "description": "删除FAQ回复",
        "default_roles": ["PM"],
    },
    # 病史记录管理
    "subject_histories:create": {
        "module": "subjects",
        "action": "write",
        "description": "创建病史记录",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read"],
    },
    "subject_histories:list": {
        "module": "subjects",
        "action": "read",
        "description": "查询病史记录列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subject_histories:read": {
        "module": "subjects",
        "action": "read",
        "description": "查询病史记录详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
        "prerequisite_permissions": [],
    },
    "subject_histories:update": {
        "module": "subjects",
        "action": "write",
        "description": "更新病史记录",
        "default_roles": ["PM", "CRA"],
        "prerequisite_permissions": ["subjects:read"],
    },
    "subject_histories:delete": {
        "module": "subjects",
        "action": "write",
        "description": "删除病史记录",
        "default_roles": ["PM"],
        "prerequisite_permissions": ["subjects:read"],
    },
    # 物资设备管理
    "material_equipments:create": {
        "module": "materials",
        "action": "write",
        "description": "创建物资设备",
        "default_roles": ["PM", "CRA"],
    },
    "material_equipments:list": {
        "module": "materials",
        "action": "read",
        "description": "查询物资设备列表",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "material_equipments:read": {
        "module": "materials",
        "action": "read",
        "description": "查询物资设备详情",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "material_equipments:update": {
        "module": "materials",
        "action": "write",
        "description": "更新物资设备",
        "default_roles": ["PM", "CRA"],
    },
    "material_equipments:delete": {
        "module": "materials",
        "action": "write",
        "description": "删除物资设备",
        "default_roles": ["PM"],
    },
    # 文档管理
    "documents:create": {
        "module": "documents",
        "action": "write",
        "description": "创建文档",
        "default_roles": ["PM", "CRA"],
    },
    "documents:read": {
        "module": "documents",
        "action": "read",
        "description": "查询文档",
        "default_roles": ["PM", "CRA", "PV", "QA", "CTA"],
    },
    "documents:update": {
        "module": "documents",
        "action": "write",
        "description": "更新文档",
        "default_roles": ["PM", "CRA"],
    },
    "documents:delete": {
        "module": "documents",
        "action": "write",
        "description": "删除文档",
        "default_roles": ["PM"],
    },
}

# 向后兼容：业务操作名到接口级权限的映射
# 用于在接口级权限未配置时，回退到模块级权限
OPERATION_TO_ENDPOINTS: dict[str, dict[str, list[str]]] = {
    "subjects": {
        "read": [
            "subjects:list",
            "subjects:read",
            "subject_aes:list",
            "subject_aes:read",
        ],
        "write": [
            "subjects:create",
            "subjects:update",
            "subjects:delete",
            "subject_aes:create",
            "subject_aes:update",
            "subject_aes:delete",
        ],
    },
    "visits": {
        "read": [
            "visits:list",
        ],
        "write": [
            "visits:create",
            "visits:update",
            "visits:delete",
        ],
    },
    "risk_issues": {
        "read": [
            "monitoring_issues:list",
            "monitoring_issues:read",
        ],
        "write": [
            "monitoring_issues:create",
            "monitoring_issues:update",
            "monitoring_issues:delete",
        ],
    },
    "fees": {
        "read": [
            "fees_contracts:list",
            "fees_contracts:read",
            "fees_contracts_attachments:read",
        ],
        "write": [
            "fees_contracts:create",
            "fees_contracts:update",
            "fees_contracts:delete",
            "fees_contracts_attachments:create",
            "fees_contracts_attachments:delete",
        ],
    },
    "project_members": {
        "read": [
            "project_members:list",
            "project_members:candidates",
        ],
        "write": [
            "project_members:create",
            "project_members:update",
            "project_members:delete",
        ],
    },
    "sites": {
        "read": [
            "sites:list",
            "sites:read",
        ],
        "write": [
            "sites:create",
            "sites:update",
            "sites:delete",
        ],
    },
    "startup_ethics": {
        "read": [
            "startup_ethics:list",
            "startup_ethics:read",
            "startup_initiation:list",
            "startup_initiation:read",
            "startup_ethics_attachments:read",
            "startup_initiation_attachments:read",
        ],
        "write": [
            "startup_ethics:create",
            "startup_ethics:update",
            "startup_ethics:delete",
            "startup_initiation:create",
            "startup_initiation:update",
            "startup_initiation:delete",
            "startup_ethics_attachments:create",
            "startup_ethics_attachments:delete",
            "startup_initiation_attachments:create",
            "startup_initiation_attachments:delete",
        ],
    },
    "startup_auth": {
        "read": [
            "startup_auth:read",
            "startup_auth_attachments:read",
        ],
        "write": [
            "startup_auth:create",
            "startup_auth:update",
            "startup_auth:delete",
            "startup_auth_attachments:create",
            "startup_auth_attachments:delete",
        ],
    },
    "project_overview": {
        "read": [
            "project_overview:read",
        ],
        "write": [],
    },
    "materials": {
        "read": [
            "drug_shipments:list",
            "drug_shipments:read",
            "material_equipments:list",
            "material_equipments:read",
            "drug_shipments_attachments:read",
        ],
        "write": [
            "drug_shipments:create",
            "drug_shipments:update",
            "drug_shipments:delete",
            "material_equipments:create",
            "material_equipments:update",
            "material_equipments:delete",
            "drug_shipments_attachments:create",
            "drug_shipments_attachments:delete",
        ],
    },
    "audit_export": {
        "read": [
            "audit_logs:list",
            "audit_logs:read",
            "audit_logs:export",
        ],
        "write": [],
    },
    "subject_histories": {
        "read": [
            "subject_histories:list",
            "subject_histories:read",
        ],
        "write": [
            "subject_histories:create",
            "subject_histories:update",
            "subject_histories:delete",
        ],
    },
    "documents": {
        "read": [
            "documents:read",
        ],
        "write": [
            "documents:create",
            "documents:update",
            "documents:delete",
        ],
    },
    "project_milestones": {
        "read": [
            "project_milestones:read",
        ],
        "write": [
            "project_milestones:update",
        ],
    },
    "setup_config": {
        "read": [
            "setup_config:read",
        ],
        "write": [
            "setup_config:update",
            "setup_config:publish",
            "setup_config:rollback",
            "setup_config:delete_version",
        ],
    },
    "shared_library": {
        "read": [
            "precautions:list",
            "precautions:read",
            "precautions_attachments:read",
            "faq:read",
            "faq_category:read",
            "faq_attachments:read",
        ],
        "write": [
            "precautions:create",
            "precautions:update",
            "precautions:delete",
            "precautions_attachments:create",
            "precautions_attachments:delete",
            "faq:create",
            "faq:update",
            "faq:delete",
            "faq_category:create",
            "faq_category:update",
            "faq_category:delete",
            "faq_reply:create",
            "faq_reply:delete",
            "faq_attachments:create",
            "faq_attachments:delete",
        ],
    },
}

# 项目级权限角色列表
PROJECT_PERMISSION_ROLES = ["PM", "CRA", "PV", "QA", "CTA"]

# 前置权限映射表（用于权限检查）
# 定义每个操作需要的前置权限
OPERATION_PREREQUISITES: dict[str, list[str]] = {
    # 参与者管理
    "subjects:create": ["sites:read"],
    "subjects:update": ["sites:read"],
    "subjects:delete": ["sites:read"],

    # 访视管理
    "visits:create": ["subjects:read", "sites:read"],
    "visits:update": ["subjects:read", "sites:read"],
    "visits:delete": ["subjects:read", "sites:read"],

    # 参与者AE
    "subject_aes:create": ["subjects:read", "sites:read"],
    "subject_aes:update": ["subject_aes:list", "subjects:read", "sites:read"],
    "subject_aes:delete": ["subject_aes:list", "subjects:read", "sites:read"],

    # 合同费用
    "fees_contracts:create": ["sites:read"],
    "fees_contracts:update": ["sites:read"],
    "fees_contracts:delete": ["sites:read"],

    # 药物发货
    "drug_shipments:create": ["sites:read"],
    "drug_shipments:update": ["sites:read"],
    "drug_shipments:delete": ["sites:read"],

    # 参与者PD
    "subject_pds:create": ["subjects:read", "sites:read"],
    "subject_pds:update": ["subject_pds:list", "subjects:read", "sites:read"],
    "subject_pds:delete": ["subject_pds:list", "subjects:read", "sites:read"],

    # 病史记录
    "subject_histories:create": ["subjects:read"],
    "subject_histories:update": ["subjects:read"],
    "subject_histories:delete": ["subjects:read"],

    # 监查访视问题
    "monitoring_issues:create": ["sites:read"],
    "monitoring_issues:update": ["sites:read"],
    "monitoring_issues:delete": ["sites:read"],
}

# 系统级权限定义
# 描述管理后台各模块操作的权限归属
# PM 角色的系统级权限限定在其所负责的项目范围内
SYSTEM_PERMISSIONS: dict[str, dict] = {
    # 账号管理
    "system:users:list": {
        "module": "system_users",
        "action": "read",
        "description": "查看用户列表",
        "roles": ["ADMIN"],
    },
    "system:users:create": {
        "module": "system_users",
        "action": "create",
        "description": "创建用户",
        "roles": ["ADMIN"],
    },
    "system:users:update": {
        "module": "system_users",
        "action": "update",
        "description": "编辑用户",
        "roles": ["ADMIN"],
    },
    "system:users:disable": {
        "module": "system_users",
        "action": "update",
        "description": "禁用/启用用户",
        "roles": ["ADMIN"],
    },
    "system:users:approve": {
        "module": "system_users",
        "action": "update",
        "description": "审核用户注册",
        "roles": ["ADMIN"],
    },
    # 项目管理
    "system:projects:list": {
        "module": "system_projects",
        "action": "read",
        "description": "查看项目列表",
        "roles": ["ADMIN"],
    },
    "system:projects:create": {
        "module": "system_projects",
        "action": "create",
        "description": "创建项目",
        "roles": ["ADMIN"],
    },
    "system:projects:update": {
        "module": "system_projects",
        "action": "update",
        "description": "编辑项目",
        "roles": ["ADMIN"],
    },
    "system:projects:delete": {
        "module": "system_projects",
        "action": "delete",
        "description": "删除项目",
        "roles": ["ADMIN"],
    },
    "system:projects:lock": {
        "module": "system_projects",
        "action": "update",
        "description": "锁定/解锁项目",
        "roles": ["ADMIN"],
    },
    "system:projects:members": {
        "module": "system_projects",
        "action": "update",
        "description": "管理项目成员",
        "roles": ["ADMIN"],
    },
    "system:projects:sites": {
        "module": "system_projects",
        "action": "update",
        "description": "管理项目中心",
        "roles": ["ADMIN"],
    },
    # 权限管理
    "system:permissions:read": {
        "module": "system_permissions",
        "action": "read",
        "description": "查看系统级权限定义",
        "roles": ["ADMIN", "PM"],
    },
    "system:permissions:project_config": {
        "module": "system_permissions",
        "action": "update",
        "description": "配置项目接口权限",
        "roles": ["ADMIN", "PM"],
    },
    "system:permissions:templates": {
        "module": "system_permissions",
        "action": "update",
        "description": "管理权限模板",
        "roles": ["ADMIN"],
    },
    # 权限监控
    "system:monitoring:metrics": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看权限监控指标",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:cache_stats": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看缓存统计",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:alerts": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看权限告警",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:health": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看权限系统健康状态",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:access_logs": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看权限访问日志",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:trends": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看权限趋势数据",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:reset_metrics": {
        "module": "system_monitoring",
        "action": "update",
        "description": "重置监控指标",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:clear_alerts": {
        "module": "system_monitoring",
        "action": "update",
        "description": "清除告警",
        "roles": ["ADMIN", "PM"],
    },
    "system:monitoring:security_logs": {
        "module": "system_monitoring",
        "action": "read",
        "description": "查看安全访问日志",
        "roles": ["ADMIN"],
    },
    # 审计日志
    "system:audit_logs:read": {
        "module": "system_audit",
        "action": "read",
        "description": "查看审计日志",
        "roles": ["ADMIN"],
    },
    "system:audit_logs:export": {
        "module": "system_audit",
        "action": "export",
        "description": "导出审计日志",
        "roles": ["ADMIN"],
    },
}

# 系统级权限模块标签
SYSTEM_MODULE_LABELS: dict[str, str] = {
    "system_users": "账号管理",
    "system_projects": "项目管理",
    "system_permissions": "权限管理",
    "system_monitoring": "权限监控",
    "system_audit": "审计日志",
}