DataOps-platform/docs/architecture/OPENAPI.yaml

openapi: 3.1.0
info:
  title: "DataOps Platform API（当前代码基线）"
  version: "2026-07-16"
  description: "由 scripts/generate_openapi.py 从 app/api/*/routes.py 生成。请求体与响应细节仍以现有专项 API 文档和代码为准。"
x-route-count: 219
servers:
  - url: "http://localhost:15500"
    description: "全本地隔离测试后端"
tags:
  - name: meta_data
    description: "/api/meta"
  - name: data_interface
    description: "/api/interface"
  - name: graph
    description: "/api/graph"
  - name: system
    description: "/api/system"
  - name: data_source
    description: "/api/datasource"
  - name: data_development
    description: "/api/development/v1"
  - name: data_flow
    description: "/api/dataflow"
  - name: business_domain
    description: "/api/bd"
  - name: data_factory
    description: "/api/datafactory"
  - name: data_service
    description: "/api/dataservice"
  - name: knowledge_base
    description: "/api/knowledge"
paths:
  "/api/bd/compose":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_compose_post
      summary: "从已有业务领域中组合创建新的业务领域"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/ddlparse":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_ddl_parse_post
      summary: "解析文件内容，提取数据表定义信息"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/delete":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_delete_post
      summary: "删除业务领域"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/detail":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_detail_post
      summary: "获取业务领域详情"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/download":
    get:
      tags: [business_domain]
      operationId: business_domain_bd_download_get
      summary: "下载业务领域相关文件"
      x-source: "app/api/business_domain/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/graphall":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_graph_all_post
      summary: "获取业务领域完整关系图谱"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/labellist":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_label_list_post
      summary: "获取数据标签列表（用于业务领域关联）"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/list":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_list_post
      summary: "获取业务领域列表"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/save":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_save_post
      summary: "保存业务领域（新建或更新）"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/search":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_search_post
      summary: "搜索业务领域关联的元数据"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/update":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_update_post
      summary: "更新业务领域"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/bd/upload":
    post:
      tags: [business_domain]
      operationId: business_domain_bd_upload_post
      summary: "上传业务领域相关文件"
      x-source: "app/api/business_domain/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/executions":
    get:
      tags: [data_factory]
      operationId: data_factory_get_all_executions_get
      summary: "获取所有执行记录列表"
      x-source: "app/api/data_factory/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/executions/{execution_id}":
    get:
      tags: [data_factory]
      operationId: data_factory_get_execution_get
      summary: "获取执行详情"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: execution_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/health":
    get:
      tags: [data_factory]
      operationId: data_factory_health_check_get
      summary: "检查 n8n 服务连接状态"
      x-source: "app/api/data_factory/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows":
    get:
      tags: [data_factory]
      operationId: data_factory_get_workflows_get
      summary: "获取工作流列表"
      x-source: "app/api/data_factory/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}":
    get:
      tags: [data_factory]
      operationId: data_factory_get_workflow_get
      summary: "获取工作流详情"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}/activate":
    post:
      tags: [data_factory]
      operationId: data_factory_activate_workflow_post
      summary: "激活工作流"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}/deactivate":
    post:
      tags: [data_factory]
      operationId: data_factory_deactivate_workflow_post
      summary: "停用工作流"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}/execute":
    post:
      tags: [data_factory]
      operationId: data_factory_execute_workflow_post
      summary: "触发工作流执行"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}/executions":
    get:
      tags: [data_factory]
      operationId: data_factory_get_workflow_executions_get
      summary: "获取工作流的执行记录列表"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/workflows/{workflow_id}/status":
    get:
      tags: [data_factory]
      operationId: data_factory_get_workflow_status_get
      summary: "获取工作流状态"
      x-source: "app/api/data_factory/routes.py"
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/add-dataflow":
    post:
      tags: [data_flow]
      operationId: data_flow_create_dataflow_post
      summary: "创建新的数据流"
      x-source: "app/api/data_flow/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/delete-dataflow/{dataflow_id}":
    delete:
      tags: [data_flow]
      operationId: data_flow_delete_dataflow_delete
      summary: "删除数据流"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/get-BD-list":
    get:
      tags: [data_flow]
      operationId: data_flow_get_business_domain_list_get
      summary: "获取BusinessDomain节点列表"
      x-source: "app/api/data_flow/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/get-dataflow/{dataflow_id}":
    get:
      tags: [data_flow]
      operationId: data_flow_get_dataflow_get
      summary: "根据ID获取数据流详情"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/get-dataflows-list":
    get:
      tags: [data_flow]
      operationId: data_flow_get_dataflows_get
      summary: "获取数据流列表"
      x-source: "app/api/data_flow/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/get-script/{dataflow_id}":
    get:
      tags: [data_flow]
      operationId: data_flow_get_script_get
      summary: "获取 DataFlow 关联的脚本内容"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/update-dataflow/{dataflow_id}":
    put:
      tags: [data_flow]
      operationId: data_flow_update_dataflow_put
      summary: "更新数据流"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/{dataflow_uid}/workflow-versions":
    get:
      tags: [data_flow]
      operationId: data_flow_get_workflow_versions_get
      summary: "get workflow versions"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_flow]
      operationId: data_flow_add_workflow_version_post
      summary: "add workflow version"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataflow/{dataflow_uid}/workflow-versions/{version_id}/activate":
    post:
      tags: [data_flow]
      operationId: data_flow_activate_workflow_version_post
      summary: "activate workflow version"
      x-source: "app/api/data_flow/routes.py"
      parameters:
        - name: dataflow_uid
          in: path
          required: true
          schema:
            type: string
        - name: version_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/neworder":
    post:
      tags: [data_service]
      operationId: data_service_create_order_post
      summary: "创建数据订单"
      x-source: "app/api/data_service/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orderlist":
    get:
      tags: [data_service]
      operationId: data_service_get_orders_get
      summary: "获取数据订单列表"
      x-source: "app/api/data_service/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/analyze":
    post:
      tags: [data_service]
      operationId: data_service_analyze_order_post
      summary: "分析数据订单（提取实体并检测图谱连通性）"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/approve":
    post:
      tags: [data_service]
      operationId: data_service_approve_order_post
      summary: "审批通过数据订单，并自动生成 BusinessDomain 和 DataFlow 资源"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/complete":
    post:
      tags: [data_service]
      operationId: data_service_complete_order_post
      summary: "标记数据订单为最终完成状态"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/delete":
    put:
      tags: [data_service]
      operationId: data_service_delete_order_put
      summary: "删除数据订单（软删除）"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/detail":
    get:
      tags: [data_service]
      operationId: data_service_get_order_get
      summary: "获取数据订单详情"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/onboard":
    post:
      tags: [data_service]
      operationId: data_service_onboard_order_post
      summary: "数据工厂回调：设置订单为数据产品就绪状态"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/reject":
    post:
      tags: [data_service]
      operationId: data_service_reject_order_post
      summary: "驳回数据订单"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/orders/{order_id}/update":
    put:
      tags: [data_service]
      operationId: data_service_update_order_put
      summary: "更新数据订单（支持修改描述和提取结果）"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: order_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products":
    get:
      tags: [data_service]
      operationId: data_service_get_products_get
      summary: "获取数据产品列表"
      x-source: "app/api/data_service/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_service]
      operationId: data_service_register_product_post
      summary: "手动注册数据产品"
      x-source: "app/api/data_service/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}":
    delete:
      tags: [data_service]
      operationId: data_service_delete_product_delete
      summary: "删除数据产品"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    get:
      tags: [data_service]
      operationId: data_service_get_product_get
      summary: "获取数据产品详情"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}/download":
    get:
      tags: [data_service]
      operationId: data_service_download_product_excel_get
      summary: "下载数据产品数据为Excel文件"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}/lineage-visualization":
    post:
      tags: [data_service]
      operationId: data_service_get_lineage_visualization_post
      summary: "获取数据产品的血缘可视化数据"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}/preview":
    get:
      tags: [data_service]
      operationId: data_service_get_product_preview_get
      summary: "获取数据产品的数据预览（默认200条）"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}/refresh":
    post:
      tags: [data_service]
      operationId: data_service_refresh_product_stats_post
      summary: "刷新数据产品的统计信息"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/dataservice/products/{product_id}/viewed":
    post:
      tags: [data_service]
      operationId: data_service_mark_product_viewed_post
      summary: "标记数据产品为已查看（消除更新提示）"
      x-source: "app/api/data_service/routes.py"
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/conntest":
    post:
      tags: [data_source]
      operationId: data_source_data_source_conn_test_post
      summary: "data source conn test"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/delete":
    post:
      tags: [data_source]
      operationId: data_source_data_source_delete_post
      summary: "data source delete"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/graph":
    post:
      tags: [data_source]
      operationId: data_source_data_source_graph_relationship_post
      summary: "data source graph relationship"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/list":
    post:
      tags: [data_source]
      operationId: data_source_data_source_list_post
      summary: "data source list"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/parse":
    post:
      tags: [data_source]
      operationId: data_source_data_source_connstr_parse_post
      summary: "data source connstr parse"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/pools":
    get:
      tags: [data_source]
      operationId: data_source_data_source_pool_list_get
      summary: "data source pool list"
      x-source: "app/api/data_source/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/save":
    post:
      tags: [data_source]
      operationId: data_source_data_source_save_post
      summary: "data source save"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/valid":
    post:
      tags: [data_source]
      operationId: data_source_data_source_connstr_valid_post
      summary: "data source connstr valid"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/{data_source_uid}/pool":
    get:
      tags: [data_source]
      operationId: data_source_data_source_pool_status_get
      summary: "data source pool status"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: data_source_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datasource/{data_source_uid}/pool/invalidate":
    post:
      tags: [data_source]
      operationId: data_source_data_source_pool_invalidate_post
      summary: "data source pool invalidate"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: data_source_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/candidate-decisions":
    post:
      tags: [data_development]
      operationId: data_development_decide_candidates_post
      summary: "decide candidates"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/data-elements":
    get:
      tags: [data_development]
      operationId: data_development_list_data_elements_get
      summary: "list data elements"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_create_data_element_post
      summary: "create data element"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/data-elements/{element_uid}/transitions":
    post:
      tags: [data_development]
      operationId: data_development_transition_data_element_post
      summary: "transition data element"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: element_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-assets":
    get:
      tags: [data_development]
      operationId: data_development_list_device_assets_get
      summary: "list device assets"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-assets/import":
    post:
      tags: [data_development]
      operationId: data_development_import_device_assets_post
      summary: "import device assets"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-assets/{asset_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_device_asset_get
      summary: "get device asset"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: asset_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-assets/{asset_uid}/versions":
    get:
      tags: [data_development]
      operationId: data_development_list_device_asset_versions_get
      summary: "list device asset versions"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: asset_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates":
    get:
      tags: [data_development]
      operationId: data_development_list_device_entity_candidates_get
      summary: "list device entity candidates"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_submit_device_entity_candidate_post
      summary: "submit device entity candidate"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates/generate":
    post:
      tags: [data_development]
      operationId: data_development_generate_device_entity_candidates_post
      summary: "generate device entity candidates"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates/{candidate_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_device_entity_candidate_get
      summary: "get device entity candidate"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: candidate_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates/{candidate_uid}/merges":
    get:
      tags: [data_development]
      operationId: data_development_list_device_entity_merges_get
      summary: "list device entity merges"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: candidate_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates/{candidate_uid}/review":
    post:
      tags: [data_development]
      operationId: data_development_review_device_entity_candidate_post
      summary: "review device entity candidate"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: candidate_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/candidates/{candidate_uid}/reviews":
    get:
      tags: [data_development]
      operationId: data_development_list_device_entity_reviews_get
      summary: "list device entity reviews"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: candidate_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/merges/{merge_uid}/rollback":
    post:
      tags: [data_development]
      operationId: data_development_rollback_device_entity_merge_post
      summary: "rollback device entity merge"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: merge_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-entities/merges/{merge_uid}/rollbacks":
    get:
      tags: [data_development]
      operationId: data_development_list_device_entity_rollbacks_get
      summary: "list device entity rollbacks"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: merge_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-observability/events":
    get:
      tags: [data_development]
      operationId: data_development_list_device_operational_events_get
      summary: "list device operational events"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-observability/graph":
    get:
      tags: [data_development]
      operationId: data_development_get_device_evidence_graph_get
      summary: "get device evidence graph"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-observability/import":
    post:
      tags: [data_development]
      operationId: data_development_import_device_operational_evidence_post
      summary: "import device operational evidence"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-observability/root-cause":
    get:
      tags: [data_development]
      operationId: data_development_get_device_root_cause_get
      summary: "get device root cause"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/bootstrap":
    post:
      tags: [data_development]
      operationId: data_development_bootstrap_device_quality_post
      summary: "bootstrap device quality"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues":
    get:
      tags: [data_development]
      operationId: data_development_list_quality_issues_get
      summary: "list quality issues"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/assignees":
    get:
      tags: [data_development]
      operationId: data_development_list_quality_issue_assignees_get
      summary: "list quality issue assignees"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/import":
    post:
      tags: [data_development]
      operationId: data_development_import_quality_issues_post
      summary: "import quality issues"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/statistics":
    get:
      tags: [data_development]
      operationId: data_development_get_quality_issue_statistics_get
      summary: "get quality issue statistics"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_quality_issue_get
      summary: "get quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/assign":
    post:
      tags: [data_development]
      operationId: data_development_assign_quality_issue_post
      summary: "assign quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/reopen":
    post:
      tags: [data_development]
      operationId: data_development_reopen_quality_issue_post
      summary: "reopen quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/review":
    post:
      tags: [data_development]
      operationId: data_development_review_quality_issue_post
      summary: "review quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/start":
    post:
      tags: [data_development]
      operationId: data_development_start_quality_issue_post
      summary: "start quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/submit":
    post:
      tags: [data_development]
      operationId: data_development_submit_quality_issue_post
      summary: "submit quality issue"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/issues/{issue_uid}/timeline":
    get:
      tags: [data_development]
      operationId: data_development_get_quality_issue_timeline_get
      summary: "get quality issue timeline"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: issue_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/profile":
    get:
      tags: [data_development]
      operationId: data_development_get_device_quality_profile_get
      summary: "get device quality profile"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/profile/versions":
    get:
      tags: [data_development]
      operationId: data_development_list_device_quality_versions_get
      summary: "list device quality versions"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_revise_device_quality_profile_post
      summary: "revise device quality profile"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/profile/versions/{version_uid}/publish":
    post:
      tags: [data_development]
      operationId: data_development_publish_device_quality_version_post
      summary: "publish device quality version"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: version_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/runs":
    get:
      tags: [data_development]
      operationId: data_development_list_device_quality_runs_get
      summary: "list device quality runs"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_run_device_quality_post
      summary: "run device quality"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/runs/{run_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_device_quality_run_get
      summary: "get device quality run"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: run_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/runs/{run_uid}/asset-scores":
    get:
      tags: [data_development]
      operationId: data_development_list_device_quality_asset_scores_get
      summary: "list device quality asset scores"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: run_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-quality/runs/{run_uid}/violations":
    get:
      tags: [data_development]
      operationId: data_development_list_device_quality_violations_get
      summary: "list device quality violations"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: run_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/bootstrap":
    post:
      tags: [data_development]
      operationId: data_development_bootstrap_device_semantics_post
      summary: "bootstrap device semantics"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes":
    get:
      tags: [data_development]
      operationId: data_development_list_device_semantic_codes_get
      summary: "list device semantic codes"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_create_device_semantic_code_post
      summary: "create device semantic code"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_device_semantic_code_get
      summary: "get device semantic code"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}/review":
    post:
      tags: [data_development]
      operationId: data_development_review_device_semantic_code_post
      summary: "review device semantic code"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}/reviews":
    get:
      tags: [data_development]
      operationId: data_development_list_device_semantic_code_reviews_get
      summary: "list device semantic code reviews"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}/revisions":
    post:
      tags: [data_development]
      operationId: data_development_revise_device_semantic_code_post
      summary: "revise device semantic code"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}/submit":
    post:
      tags: [data_development]
      operationId: data_development_submit_device_semantic_code_post
      summary: "submit device semantic code"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/codes/{code_uid}/versions":
    get:
      tags: [data_development]
      operationId: data_development_list_device_semantic_code_versions_get
      summary: "list device semantic code versions"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: code_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/device-semantics/profile":
    get:
      tags: [data_development]
      operationId: data_development_get_device_semantic_profile_get
      summary: "get device semantic profile"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/evidence/{evidence_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_evidence_get
      summary: "get evidence"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: evidence_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/governance-metrics/details":
    get:
      tags: [data_development]
      operationId: data_development_get_governance_metric_details_get
      summary: "get governance metric details"
      x-source: "app/api/data_development/routes.py"
      x-response-fields: [metric, state, records, page, page_size, total]
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/governance-metrics/summary":
    get:
      tags: [data_development]
      operationId: data_development_get_governance_metric_summary_get
      summary: "get governance metric summary"
      x-source: "app/api/data_development/routes.py"
      x-response-fields: [scope, metrics]
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs":
    get:
      tags: [data_development]
      operationId: data_development_list_ingestion_jobs_get
      summary: "list ingestion jobs"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_create_ingestion_job_post
      summary: "create ingestion job"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_ingestion_job_get
      summary: "get ingestion job"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}/cancel":
    post:
      tags: [data_development]
      operationId: data_development_cancel_ingestion_job_post
      summary: "cancel ingestion job"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}/catalog-snapshots":
    get:
      tags: [data_development]
      operationId: data_development_list_catalog_snapshots_get
      summary: "list catalog snapshots"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}/evidence":
    get:
      tags: [data_development]
      operationId: data_development_list_ingestion_job_evidence_get
      summary: "list ingestion job evidence"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}/execute":
    post:
      tags: [data_development]
      operationId: data_development_execute_ingestion_job_post
      summary: "execute ingestion job"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ingestion-jobs/{job_uid}/retry":
    post:
      tags: [data_development]
      operationId: data_development_retry_ingestion_job_post
      summary: "retry ingestion job"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: job_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies":
    get:
      tags: [data_development]
      operationId: data_development_list_ontologies_get
      summary: "list ontologies"
      x-source: "app/api/data_development/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [data_development]
      operationId: data_development_create_ontology_post
      summary: "create ontology"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/import":
    post:
      tags: [data_development]
      operationId: data_development_import_ontology_post
      summary: "import ontology"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_ontology_get
      summary: "get ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/change-sets/{change_set_uid}/decisions":
    post:
      tags: [data_development]
      operationId: data_development_decide_ontology_change_set_post
      summary: "decide ontology change set"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
        - name: change_set_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/diff":
    get:
      tags: [data_development]
      operationId: data_development_diff_ontology_get
      summary: "diff ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/export":
    get:
      tags: [data_development]
      operationId: data_development_export_ontology_get
      summary: "export ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/graph":
    get:
      tags: [data_development]
      operationId: data_development_get_ontology_graph_get
      summary: "get ontology graph"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    patch:
      tags: [data_development]
      operationId: data_development_save_ontology_graph_patch
      summary: "save ontology graph"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/publish":
    post:
      tags: [data_development]
      operationId: data_development_publish_ontology_post
      summary: "publish ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/rollback":
    post:
      tags: [data_development]
      operationId: data_development_rollback_ontology_post
      summary: "rollback ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/suggestions":
    post:
      tags: [data_development]
      operationId: data_development_generate_ontology_suggestions_post
      summary: "generate ontology suggestions"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/validate":
    post:
      tags: [data_development]
      operationId: data_development_validate_ontology_post
      summary: "validate ontology"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/ontologies/{ontology_uid}/versions":
    get:
      tags: [data_development]
      operationId: data_development_list_ontology_versions_get
      summary: "list ontology versions"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: ontology_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/semantic/properties/{property_uid}":
    get:
      tags: [data_development]
      operationId: data_development_query_semantic_property_get
      summary: "query semantic property"
      x-source: "app/api/data_development/routes.py"
      parameters:
        - name: property_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/development/v1/sources/files":
    post:
      tags: [data_development]
      operationId: data_development_upload_source_file_post
      summary: "upload source file"
      x-source: "app/api/data_development/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/graph/node/create":
    post:
      tags: [graph]
      operationId: graph_create_node_post
      summary: "创建新节点"
      x-source: "app/api/graph/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/graph/query":
    post:
      tags: [graph]
      operationId: graph_query_graph_post
      summary: "执行自定义Cypher查询"
      x-source: "app/api/graph/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/graph/relationship/create":
    post:
      tags: [graph]
      operationId: graph_create_rel_post
      summary: "创建节点间的关系"
      x-source: "app/api/graph/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/graph/subgraph":
    post:
      tags: [graph]
      operationId: graph_get_graph_data_post
      summary: "获取子图数据"
      x-source: "app/api/graph/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/add":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_add_post
      summary: "data label add"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/delete":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_delete_post
      summary: "Delete data label node"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/detail":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_detail_post
      summary: "data label detail"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/dynamic/identify":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_dynamic_identify_post
      summary: "data label dynamic identify"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/graph/all":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_graph_post
      summary: "data label graph"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/label/list":
    post:
      tags: [data_interface]
      operationId: data_interface_data_label_list_post
      summary: "data label list"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/add":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_add_post
      summary: "data standard add"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/code":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_code_post
      summary: "data standard code"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/detail":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_detail_post
      summary: "data standard detail"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/graph/all":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_graph_all_post
      summary: "data standard graph all"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/list":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_list_post
      summary: "data standard list"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/data/standard/update":
    post:
      tags: [data_interface]
      operationId: data_interface_data_standard_update_post
      summary: "data standard update"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/graphall":
    post:
      tags: [data_interface]
      operationId: data_interface_interface_graph_all_post
      summary: "获取完整关系图谱"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/labellist":
    post:
      tags: [data_interface]
      operationId: data_interface_interface_label_list_post
      summary: "获取 DataLabel 列表（支持多条件 category_filter 过滤）"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/interface/metric/label/standard/delete":
    post:
      tags: [data_interface]
      operationId: data_interface_metric_label_standard_delete_post
      summary: "metric label standard delete"
      x-source: "app/api/data_interface/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/audit":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_audit_post
      summary: "admin audit"
      x-source: "app/api/knowledge_base/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/change-sets":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_change_sets_get
      summary: "admin change sets"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/change-sets/{change_set_id}":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_change_set_get
      summary: "admin change set"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: change_set_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/change-sets/{change_set_id}/retry":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_retry_change_set_post
      summary: "admin retry change set"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: change_set_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/change-sets/{change_set_id}/rollback":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_rollback_change_set_post
      summary: "admin rollback change set"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: change_set_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/device-sources":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_device_sources_get
      summary: "admin device sources"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/device-sources/{source_uid}/scope":
    put:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_device_source_scope_put
      summary: "admin device source scope"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: source_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/evaluations":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_evaluations_get
      summary: "admin evaluations"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/query-audits":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_query_audits_get
      summary: "admin query audits"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/retry-projection":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_retry_projection_post
      summary: "admin retry projection"
      x-source: "app/api/knowledge_base/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/admin/sync":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_admin_sync_get
      summary: "admin sync"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/ask":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_ask_post
      summary: "ask"
      x-source: "app/api/knowledge_base/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      x-response-fields: [query_id, mode, answer, answer_status, degraded_components, citations, evidence, freshness_status]
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/capabilities":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_capabilities_get
      summary: "capabilities"
      x-source: "app/api/knowledge_base/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/search":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_search_post
      summary: "search"
      x-source: "app/api/knowledge_base/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/sources/{source_uid}":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_source_get
      summary: "source"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: source_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/knowledge/sources/{source_uid}/versions/{version}":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_source_version_get
      summary: "source version"
      x-source: "app/api/knowledge_base/routes.py"
      parameters:
        - name: source_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/check":
    get:
      tags: [meta_data]
      operationId: meta_data_meta_check_get
      summary: "检查元数据中文名是否已存在"
      x-source: "app/api/meta_data/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/config":
    get:
      tags: [meta_data]
      operationId: meta_data_get_meta_config_get
      summary: "获取元数据配置信息"
      x-source: "app/api/meta_data/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/full/text/query":
    post:
      tags: [meta_data]
      operationId: meta_data_full_text_query_post
      summary: "full text query"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/add":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_add_post
      summary: "新增元数据节点"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/delete":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_delete_post
      summary: "meta node delete"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/edit":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_edit_post
      summary: "meta node edit"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/graph":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_graph_post
      summary: "meta node graph"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/list":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_list_post
      summary: "meta node list"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/node/update":
    post:
      tags: [meta_data]
      operationId: meta_data_meta_node_update_post
      summary: "更新元数据节点"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/resource/display":
    post:
      tags: [meta_data]
      operationId: meta_data_upload_file_display_post
      summary: "upload file display"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/resource/download":
    get:
      tags: [meta_data]
      operationId: meta_data_download_file_get
      summary: "download file"
      x-source: "app/api/meta_data/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/resource/node":
    post:
      tags: [meta_data]
      operationId: meta_data_text_resource_node_post
      summary: "text resource node"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/resource/translate":
    post:
      tags: [meta_data]
      operationId: meta_data_text_resource_translate_post
      summary: "text resource translate"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/resource/upload":
    post:
      tags: [meta_data]
      operationId: meta_data_upload_file_post
      summary: "upload file"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/review/create":
    post:
      tags: [meta_data]
      operationId: meta_data_metadata_review_create_post
      summary: "创建元数据审核记录"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/review/detail":
    get:
      tags: [meta_data]
      operationId: meta_data_metadata_review_detail_get
      summary: "审核记录详情"
      x-source: "app/api/meta_data/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/review/list":
    post:
      tags: [meta_data]
      operationId: meta_data_metadata_review_list_post
      summary: "审核记录列表：疑似冗余/变动"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/review/resolve":
    post:
      tags: [meta_data]
      operationId: meta_data_metadata_review_resolve_post
      summary: "处理审核记录"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/search":
    get:
      tags: [meta_data]
      operationId: meta_data_search_metadata_route_get
      summary: "search metadata route"
      x-source: "app/api/meta_data/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/text/graph":
    post:
      tags: [meta_data]
      operationId: meta_data_create_text_graph_post
      summary: "create text graph"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/unstructure/text/query":
    post:
      tags: [meta_data]
      operationId: meta_data_unstructure_text_query_post
      summary: "unstructure text query"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/unstructured/process":
    post:
      tags: [meta_data]
      operationId: meta_data_processing_unstructured_data_post
      summary: "processing unstructured data"
      x-source: "app/api/meta_data/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/auth/login":
    post:
      tags: [system]
      operationId: system_user_login_post
      summary: "用户登录"
      x-source: "app/api/system/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/auth/me":
    get:
      tags: [system]
      operationId: system_current_user_get
      summary: "current user"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/config":
    get:
      tags: [system]
      operationId: system_system_config_get
      summary: "获取系统配置信息"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/config/validate":
    get:
      tags: [system]
      operationId: system_config_validate_get
      summary: "验证系统配置的有效性"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/governance-audit/coverage":
    get:
      tags: [system]
      operationId: system_governance_audit_coverage_get
      summary: "governance audit coverage"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/governance-audit/events":
    get:
      tags: [system]
      operationId: system_governance_audit_events_get
      summary: "governance audit events"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/governance-audit/seals":
    get:
      tags: [system]
      operationId: system_governance_audit_seals_get
      summary: "governance audit seals"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [system]
      operationId: system_create_governance_audit_seal_post
      summary: "create governance audit seal"
      x-source: "app/api/system/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/governance-audit/seals/{seal_uid}/verify":
    post:
      tags: [system]
      operationId: system_verify_governance_audit_seal_post
      summary: "verify governance audit seal"
      x-source: "app/api/system/routes.py"
      parameters:
        - name: seal_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/governance-audit/security-checks":
    get:
      tags: [system]
      operationId: system_governance_audit_security_checks_get
      summary: "governance audit security checks"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/health":
    get:
      tags: [system]
      operationId: system_health_check_get
      summary: "系统健康状态检查"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/info":
    get:
      tags: [system]
      operationId: system_system_info_get
      summary: "获取系统运行环境信息"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/responsibilities/{resource_type}/{resource_uid}":
    get:
      tags: [system]
      operationId: system_get_responsibility_matrix_get
      summary: "get responsibility matrix"
      x-source: "app/api/system/routes.py"
      parameters:
        - name: resource_type
          in: path
          required: true
          schema:
            type: string
        - name: resource_uid
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    put:
      tags: [system]
      operationId: system_replace_responsibility_matrix_put
      summary: "replace responsibility matrix"
      x-source: "app/api/system/routes.py"
      parameters:
        - name: resource_type
          in: path
          required: true
          schema:
            type: string
        - name: resource_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/translate":
    post:
      tags: [system]
      operationId: system_translate_post
      summary: "翻译节点名称"
      x-source: "app/api/system/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/users":
    get:
      tags: [system]
      operationId: system_list_users_get
      summary: "list users"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [system]
      operationId: system_create_user_post
      summary: "create user"
      x-source: "app/api/system/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/users/{user_id}":
    put:
      tags: [system]
      operationId: system_update_user_put
      summary: "update user"
      x-source: "app/api/system/routes.py"
      parameters:
        - name: user_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/users/{user_id}/roles":
    put:
      tags: [system]
      operationId: system_update_user_roles_put
      summary: "update user roles"
      x-source: "app/api/system/routes.py"
      parameters:
        - name: user_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/workbench/layout":
    get:
      tags: [system]
      operationId: system_get_workbench_layout_get
      summary: "get workbench layout"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    put:
      tags: [system]
      operationId: system_put_workbench_layout_put
      summary: "put workbench layout"
      x-source: "app/api/system/routes.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/workbench/registry":
    get:
      tags: [system]
      operationId: system_workbench_registry_get
      summary: "workbench registry"
      x-source: "app/api/system/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
components:
  schemas:
    ApiEnvelope:
      type: object
      additionalProperties: true
      properties:
        success:
          type: boolean
        code:
          type: integer
        message:
          type: string
        data: {}
        timestamp:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: "下一阶段统一认证方案；当前路由尚未全部接入。"