{
  "openapi": "3.0.3",
  "info": {
    "title": "未来教练 / 冠军模型智能体 API",
    "version": "1.0.0",
    "description": "本地交付版接口合同，覆盖认证、训练中心、问答、运动员、赛事、管理后台、数据治理和导出。"
  },
  "servers": [
    {
      "url": "http://127.0.0.1:8030",
      "description": "本地演示服务"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "tags": [
          "系统健康"
        ],
        "summary": "健康检查",
        "description": "返回服务状态、数据库完整性和核心数据量；权限：public；页面：导入与运维",
        "operationId": "GET_api_health",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/readiness": {
      "get": {
        "tags": [
          "系统健康"
        ],
        "summary": "生产就绪检查",
        "description": "用于 Docker healthcheck 和上线探活，返回 ready/quality_score/checks；权限：public；页面：导入与运维",
        "operationId": "GET_api_readiness",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/deployment/status": {
      "get": {
        "tags": [
          "系统健康"
        ],
        "summary": "部署状态",
        "description": "返回 DB 大小、日志目录、备份目录和部署检查项；权限：public；页面：导入与运维",
        "operationId": "GET_api_deployment_status",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/auth/me": {
      "get": {
        "tags": [
          "认证权限"
        ],
        "summary": "当前用户",
        "description": "返回当前会话用户和权限；权限：public；页面：侧边栏登录",
        "operationId": "GET_api_auth_me",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/auth/demo-users": {
      "get": {
        "tags": [
          "认证权限"
        ],
        "summary": "演示账号",
        "description": "返回演示账号列表和角色；权限：public；页面：侧边栏登录",
        "operationId": "GET_api_auth_demo_users",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/auth/login": {
      "post": {
        "tags": [
          "认证权限"
        ],
        "summary": "登录",
        "description": "用户名密码登录并写入 HttpOnly Cookie；权限：public；页面：侧边栏登录",
        "operationId": "POST_api_auth_login",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/auth/logout": {
      "post": {
        "tags": [
          "认证权限"
        ],
        "summary": "退出",
        "description": "清理当前会话 Cookie；权限：login；页面：侧边栏登录",
        "operationId": "POST_api_auth_logout",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/cache/clear": {
      "post": {
        "tags": [
          "运维"
        ],
        "summary": "清理API缓存",
        "description": "清空短 TTL API 内存缓存，资料更新或验收前可手动刷新。；权限：manager/admin；页面：导入与运维",
        "operationId": "POST_api_cache_clear",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/auth/register": {
      "post": {
        "tags": [
          "认证权限"
        ],
        "summary": "注册普通用户",
        "description": "创建普通用户账号；权限：public；页面：用户中心",
        "operationId": "POST_api_auth_register",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/summary": {
      "get": {
        "tags": [
          "总览展示"
        ],
        "summary": "速度滑冰 MVP 概览",
        "description": "返回早期 MVP 数据概览；权限：public；页面：总览大屏",
        "operationId": "GET_api_summary",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/champions": {
      "get": {
        "tags": [
          "总览展示"
        ],
        "summary": "冠军榜",
        "description": "按年份查询冠军成绩；权限：public；页面：成绩/冠军模型",
        "operationId": "GET_api_champions",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/gap": {
      "get": {
        "tags": [
          "总览展示"
        ],
        "summary": "冠军差距",
        "description": "计算运动员和冠军线差距；权限：public；页面：成绩/冠军模型",
        "operationId": "GET_api_gap",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/champion/benchmark": {
      "get": {
        "tags": [
          "总览展示"
        ],
        "summary": "冠军基准模型",
        "description": "返回速度滑冰冠军线/奖牌线/前八线、目标运动员差距和短道运动员竞赛画像；权限：public；页面：成绩/冠军模型",
        "operationId": "GET_api_champion_benchmark",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "资料搜索",
        "description": "搜索本地资料库；权限：public；页面：资料问答",
        "operationId": "GET_api_search",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/answer": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "资料问答",
        "description": "返回带来源的本地回答；权限：public；页面：资料问答",
        "operationId": "GET_api_answer",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/answer": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "训练中心问答",
        "description": "综合规则/科研/训练/运动员/赛事库回答；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_answer",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/llm/status": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "大模型状态",
        "description": "返回当前 LLM provider 和是否配置；权限：public；页面：资料问答",
        "operationId": "GET_api_tc_llm_status",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/llm/answer": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "LLM 回答",
        "description": "外部模型可用则调用，否则本地回退；权限：public；页面：资料问答",
        "operationId": "GET_api_tc_llm_answer",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/model/governance": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "模型治理",
        "description": "返回本地RAG、DeepSeek、私有化模型的选型、成本、安全和验收策略；权限：public；页面：导入与运维",
        "operationId": "GET_api_model_governance",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/agent/workflow": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "智能体工作流",
        "description": "返回意图识别、权限判断、资料检索、结构化计算、回答审计和验收留痕链路；权限：public；页面：资料问答",
        "operationId": "GET_api_agent_workflow",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/agent/answer-audit": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "回答审计",
        "description": "对单个问题执行意图、来源、结构化数据和风控审计；权限：public；页面：资料问答",
        "operationId": "GET_api_agent_answer_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/agent/answer-audit-batch": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "回答审计批量",
        "description": "返回典型问题回答审计批量结果；权限：public；页面：导入与运维",
        "operationId": "GET_api_agent_answer_audit_batch",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/agent/training-plan": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "结构化训练方案",
        "description": "基于动作库和训练计划结构生成训练方案JSON；权限：public；页面：资料问答",
        "operationId": "GET_api_agent_training_plan",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/answer-policy/audit": {
      "get": {
        "tags": [
          "问答检索"
        ],
        "summary": "混合问答策略验收",
        "description": "返回客户资料优先与模型通识补充的典型问题验收结果；权限：public；页面：导入与运维",
        "operationId": "GET_api_answer_policy_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/summary": {
      "get": {
        "tags": [
          "训练中心"
        ],
        "summary": "训练中心总览",
        "description": "返回规则、科研、训练、运动员、赛事核心统计；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_summary",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/rules": {
      "get": {
        "tags": [
          "训练中心"
        ],
        "summary": "规则检索",
        "description": "搜索冬季项目规则切片；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_rules",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/research": {
      "get": {
        "tags": [
          "训练中心"
        ],
        "summary": "科研检索",
        "description": "搜索科研卡片；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_research",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/training/summary": {
      "get": {
        "tags": [
          "训练计划"
        ],
        "summary": "训练计划摘要",
        "description": "返回训练周期、周次和汇总；权限：public；页面：训练计划编辑",
        "operationId": "GET_api_tc_training_summary",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/training/week": {
      "get": {
        "tags": [
          "训练计划"
        ],
        "summary": "周训练计划",
        "description": "查询某周训练日列表；权限：public；页面：训练计划编辑",
        "operationId": "GET_api_tc_training_week",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/training/day": {
      "get": {
        "tags": [
          "训练计划"
        ],
        "summary": "训练日详情",
        "description": "查询训练日、训练课、训练块和动作明细；权限：public；页面：训练计划编辑",
        "operationId": "GET_api_tc_training_day",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/training/session/save": {
      "post": {
        "tags": [
          "训练计划"
        ],
        "summary": "保存训练课",
        "description": "教练或管理员保存训练课并重建动作明细；权限：coach/admin；页面：训练计划编辑",
        "operationId": "POST_api_tc_training_session_save",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/tc/training/session/submit-review": {
      "post": {
        "tags": [
          "训练计划"
        ],
        "summary": "提交训练审核",
        "description": "提交训练课审核；权限：coach/admin；页面：训练计划编辑",
        "operationId": "POST_api_tc_training_session_submit_review",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/tc/training/reviews": {
      "get": {
        "tags": [
          "训练计划"
        ],
        "summary": "训练审核列表",
        "description": "查询训练审核记录；权限：coach/manager/admin；页面：管理后台",
        "operationId": "GET_api_tc_training_reviews",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/training/session/review": {
      "put": {
        "tags": [
          "训练计划"
        ],
        "summary": "审批训练计划",
        "description": "通过或驳回训练审核；权限：manager/admin；页面：管理后台",
        "operationId": "PUT_api_tc_training_session_review",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/tc/athletes/search": {
      "get": {
        "tags": [
          "运动员"
        ],
        "summary": "运动员搜索",
        "description": "按姓名/国家/状态搜索运动员；权限：public；页面：运动员画像",
        "operationId": "GET_api_tc_athletes_search",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/athlete": {
      "get": {
        "tags": [
          "运动员"
        ],
        "summary": "运动员详情",
        "description": "按角色返回公开画像或敏感体测/伤病/可穿戴字段；权限：role_based；页面：运动员画像",
        "operationId": "GET_api_tc_athlete",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/opponents/compare": {
      "get": {
        "tags": [
          "运动员"
        ],
        "summary": "对手库画像对比",
        "description": "基于短道赛事成绩同组交手记录聚合主要竞争对手；权限：public；页面：运动员画像",
        "operationId": "GET_api_opponents_compare",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/events/search": {
      "get": {
        "tags": [
          "赛事"
        ],
        "summary": "短道赛事搜索",
        "description": "搜索短道成绩全量表；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_events_search",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/events/stats": {
      "get": {
        "tags": [
          "赛事"
        ],
        "summary": "赛事统计",
        "description": "返回短道赛事统计；权限：public；页面：训练中心数据",
        "operationId": "GET_api_tc_events_stats",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/public-sources": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "公开来源库",
        "description": "查询 IOC/ISU/FIS/IBU/WADA/BJSM 等公开来源；权限：public；页面：数据来源与权限",
        "operationId": "GET_api_public_sources",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/source-health/report": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "公开来源在线复核",
        "description": "返回公开来源 URL 在线可达性缓存、HTTP 状态、人工复核动作和风险说明；权限：public；页面：导入与运维",
        "operationId": "GET_api_source_health_report",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/data-dictionary": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "数据字典与血缘",
        "description": "查询业务表、字段说明、来源文件和导入任务；权限：public；页面：导入与运维",
        "operationId": "GET_api_data_dictionary",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/import/validator": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "资料导入模板校验",
        "description": "返回客户后续补资料的模板、必填字段、校验规则、目标表和 dry-run 结果；权限：public；页面：导入与运维",
        "operationId": "GET_api_import_validator",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/data-quality/audit": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "数据质量审计",
        "description": "返回完整性、唯一性、外键、异常值和 FTS 检索索引覆盖审计；权限：public；页面：导入与运维",
        "operationId": "GET_api_data_quality_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/p1/enrichment-report": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "P1数据扩充验收",
        "description": "返回科研卡片100、训练计划260天、动作库160项的达标状态和数据来源；权限：public；页面：导入与运维",
        "operationId": "GET_api_p1_enrichment_report",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/data-lineage/report": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "数据来源追溯报告",
        "description": "返回客户资料、公开来源、模拟数据到表/页面/接口/证据文件的完整链路；权限：public；页面：导入与运维",
        "operationId": "GET_api_data_lineage_report",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/expert-review/rubric": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "专家评审量表",
        "description": "返回规则、科研、训练、数据、研发、安全等专家可评分验收量表；权限：public；页面：导入与运维",
        "operationId": "GET_api_expert_review_rubric",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/customer/data-request-pack": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "客户补数请求单",
        "description": "返回正式上线需客户提供的数据、字段、格式、责任人和校验规则；权限：public；页面：导入与运维",
        "operationId": "GET_api_customer_data_request_pack",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/release/notes": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "交付版本说明",
        "description": "返回版本变更、影响范围、证据文件和交付边界；权限：public；页面：导入与运维",
        "operationId": "GET_api_release_notes",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/coverage/gap-analysis": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "资料覆盖度与缺口雷达",
        "description": "返回客户项目范围、现有资料覆盖、缺口类型和补齐路径；权限：public；页面：导入与运维",
        "operationId": "GET_api_coverage_gap_analysis",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/customer/defense-pack": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "客户答辩包",
        "description": "返回客户常见质疑、标准回答、证据、接口和文件位置；权限：public；页面：导入与运维",
        "operationId": "GET_api_customer_defense_pack",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/customer/executive-summary": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "客户一页式交付摘要",
        "description": "返回交付结论、核心证据、签收角色、剩余生产输入和交付哈希；权限：public；页面：导入与运维",
        "operationId": "GET_api_customer_executive_summary",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/evaluation/qa": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "问答准确性评测集",
        "description": "返回典型问题、预期来源、实际回答、来源命中和评测结论；权限：public；页面：导入与运维",
        "operationId": "GET_api_evaluation_qa",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/production/inputs": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "上线输入台账",
        "description": "返回上线前客户需确认事项、默认处理方案和交付边界；权限：public；页面：导入与运维",
        "operationId": "GET_api_production_inputs",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/acceptance/demo-script": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "客户验收演示脚本",
        "description": "返回验收演示场景、角色、操作步骤、预期结果和证据文件；权限：public；页面：导入与运维",
        "operationId": "GET_api_acceptance_demo_script",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/delivery/manifest": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "交付包清单",
        "description": "返回交付文件、文档、截图、接口包、数据库和压缩包完整性清单；权限：public；页面：导入与运维",
        "operationId": "GET_api_delivery_manifest",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/uat/test-cases": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "UAT验收测试包",
        "description": "返回客户验收测试用例、角色、步骤、预期结果、证据和自动化状态；权限：public；页面：导入与运维",
        "operationId": "GET_api_uat_test_cases",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/quality/report": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "质检报告",
        "description": "返回数据库、权限、导出、文档、上线条件等自动质检；权限：public；页面：导入与运维",
        "operationId": "GET_api_quality_report",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/security/audit": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "安全隐私审计",
        "description": "返回认证、权限、脱敏、密钥、审计和安全头检查项；权限：public；页面：导入与运维",
        "operationId": "GET_api_security_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/ui/ux-audit": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "UI/UX审计",
        "description": "返回页面入口、响应式、空状态、错误态、组件一致性和截图证据检查；权限：public；页面：导入与运维",
        "operationId": "GET_api_ui_ux_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/performance/audit": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "性能容量审计",
        "description": "返回关键查询耗时、静态资源体积、数据库容量和扩容路径；权限：public；页面：导入与运维",
        "operationId": "GET_api_performance_audit",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/risk/register": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "风险登记册",
        "description": "返回剩余风险、责任人、缓解措施、证据和交付阻塞判断；权限：public；页面：导入与运维",
        "operationId": "GET_api_risk_register",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/acceptance/evidence": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "验收证据矩阵",
        "description": "返回客户需求到页面/接口/文件/测试的映射；权限：public；页面：导入与运维",
        "operationId": "GET_api_acceptance_evidence",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/api-catalog": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "API 目录",
        "description": "返回接口目录、OpenAPI/Postman 下载地址和统计；权限：public；页面：导入与运维",
        "operationId": "GET_api_api_catalog",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "OpenAPI 规范",
        "description": "OpenAPI 3.0 JSON，可导入接口平台；权限：public；页面：接口联调",
        "operationId": "GET_openapi_json",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/postman_collection.json": {
      "get": {
        "tags": [
          "数据治理"
        ],
        "summary": "Postman 集合",
        "description": "Postman Collection v2.1 JSON；权限：public；页面：接口联调",
        "operationId": "GET_postman_collection_json",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/export": {
      "get": {
        "tags": [
          "导出"
        ],
        "summary": "导出风险登记",
        "description": "CSV 导出风险、责任人、缓解措施和证据；权限：public；页面：导入与运维",
        "operationId": "GET_api_export",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/user/profile": {
      "get": {
        "tags": [
          "用户中心"
        ],
        "summary": "个人资料",
        "description": "查询当前用户资料；权限：login；页面：用户中心",
        "operationId": "GET_api_user_profile",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "用户中心"
        ],
        "summary": "保存个人资料",
        "description": "保存当前用户资料；权限：login；页面：用户中心",
        "operationId": "POST_api_user_profile",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/user/inquiries": {
      "get": {
        "tags": [
          "用户中心"
        ],
        "summary": "我的咨询",
        "description": "查询当前用户咨询；权限：login；页面：用户中心",
        "operationId": "GET_api_user_inquiries",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "用户中心"
        ],
        "summary": "提交咨询",
        "description": "提交业务咨询；权限：login；页面：用户中心",
        "operationId": "POST_api_user_inquiries",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "用户中心"
        ],
        "summary": "处理咨询",
        "description": "后台处理咨询状态和回复；权限：manager/admin；页面：管理后台",
        "operationId": "PUT_api_user_inquiries",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/help/articles": {
      "get": {
        "tags": [
          "用户中心"
        ],
        "summary": "帮助文章",
        "description": "查询帮助/FAQ/案例；权限：public；页面：用户中心",
        "operationId": "GET_api_help_articles",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/admin/dashboard": {
      "get": {
        "tags": [
          "管理后台"
        ],
        "summary": "后台看板",
        "description": "后台统计和最近咨询；权限：coach/researcher/manager/admin；页面：管理后台",
        "operationId": "GET_api_admin_dashboard",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/admin/users": {
      "get": {
        "tags": [
          "管理后台"
        ],
        "summary": "用户列表",
        "description": "查询用户列表；权限：admin；页面：管理后台",
        "operationId": "GET_api_admin_users",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "管理后台"
        ],
        "summary": "新增用户",
        "description": "创建用户；权限：admin；页面：管理后台",
        "operationId": "POST_api_admin_users",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "管理后台"
        ],
        "summary": "更新用户",
        "description": "更新用户角色、状态或密码；权限：admin；页面：管理后台",
        "operationId": "PUT_api_admin_users",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "管理后台"
        ],
        "summary": "删除用户",
        "description": "删除用户并清理资料/会话；权限：admin；页面：管理后台",
        "operationId": "DELETE_api_admin_users",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/admin/content": {
      "get": {
        "tags": [
          "管理后台"
        ],
        "summary": "内容列表",
        "description": "查询帮助/FAQ/案例内容；权限：manager/admin；页面：管理后台",
        "operationId": "GET_api_admin_content",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "管理后台"
        ],
        "summary": "新增内容",
        "description": "创建内容；权限：manager/admin；页面：管理后台",
        "operationId": "POST_api_admin_content",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "管理后台"
        ],
        "summary": "更新内容",
        "description": "更新内容；权限：manager/admin；页面：管理后台",
        "operationId": "PUT_api_admin_content",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "管理后台"
        ],
        "summary": "删除内容",
        "description": "删除内容；权限：manager/admin；页面：管理后台",
        "operationId": "DELETE_api_admin_content",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/live/streams": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "直播源列表",
        "description": "读取已启用直播源，供播放器无刷新切换；权限：public；页面：视频直播",
        "operationId": "GET_api_live_streams",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/live/sources": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "EasyCVR直播源列表",
        "description": "从服务端同步并返回已启用直播源、真实在线状态和同源播放地址；权限：public；页面：视频直播",
        "operationId": "GET_api_live_sources",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/live/sources/:id": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "直播源详情",
        "description": "返回单个直播源档案；权限：public；页面：视频直播",
        "operationId": "GET_api_live_sources_id",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/live/sources/:id/status": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "直播源实时状态",
        "description": "刷新并返回指定通道在线状态；权限：public；页面：视频直播",
        "operationId": "GET_api_live_sources_id_status",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/live/sources/refresh": {
      "post": {
        "tags": [
          "视频直播"
        ],
        "summary": "刷新直播源",
        "description": "服务端重新读取 EasyCVR 设备、通道、状态和播放地址；权限：public；页面：视频直播",
        "operationId": "POST_api_live_sources_refresh",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/live/sources/:id/refresh": {
      "post": {
        "tags": [
          "视频直播"
        ],
        "summary": "刷新单个直播源",
        "description": "刷新指定 EasyCVR 通道；权限：public；页面：视频直播",
        "operationId": "POST_api_live_sources_id_refresh",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/live/health": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "直播连接健康检查",
        "description": "检查未来教练后端与 EasyCVR 的连接状态；权限：public；页面：视频直播",
        "operationId": "GET_api_live_health",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/admin/live-streams": {
      "get": {
        "tags": [
          "视频直播"
        ],
        "summary": "直播源管理列表",
        "description": "读取全部直播源及启用状态；权限：manager/admin；页面：直播管理",
        "operationId": "GET_api_admin_live_streams",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "视频直播"
        ],
        "summary": "新增直播源",
        "description": "维护名称、分类、拉流地址、封面、启用和排序；权限：manager/admin；页面：直播管理",
        "operationId": "POST_api_admin_live_streams",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "视频直播"
        ],
        "summary": "更新直播源",
        "description": "更新直播源配置；权限：manager/admin；页面：直播管理",
        "operationId": "PUT_api_admin_live_streams",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "视频直播"
        ],
        "summary": "删除直播源",
        "description": "删除指定直播源；权限：manager/admin；页面：直播管理",
        "operationId": "DELETE_api_admin_live_streams",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/admin/config": {
      "get": {
        "tags": [
          "管理后台"
        ],
        "summary": "系统配置",
        "description": "查询配置；权限：manager/admin；页面：管理后台",
        "operationId": "GET_api_admin_config",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      },
      "post": {
        "tags": [
          "管理后台"
        ],
        "summary": "保存配置",
        "description": "保存配置项；权限：admin；页面：管理后台",
        "operationId": "POST_api_admin_config",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "/api/admin/logs": {
      "get": {
        "tags": [
          "管理后台"
        ],
        "summary": "操作日志",
        "description": "查询审计日志；权限：manager/admin；页面：管理后台",
        "operationId": "GET_api_admin_logs",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/tc/ops/status": {
      "get": {
        "tags": [
          "运维"
        ],
        "summary": "运维状态",
        "description": "返回导入任务、审计日志、上线清单和核心计数；权限：public；页面：导入与运维",
        "operationId": "GET_api_tc_ops_status",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    },
    "/api/ops/runbook": {
      "get": {
        "tags": [
          "运维"
        ],
        "summary": "生产运维手册",
        "description": "返回监控、备份、恢复演练、事故响应、SLA 边界和生产动作项；权限：public；页面：导入与运维",
        "operationId": "GET_api_ops_runbook",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "未登录"
          },
          "403": {
            "description": "无权限"
          },
          "500": {
            "description": "服务器错误"
          }
        }
      }
    }
  }
}