DataOps-platform/docs/architecture/OPENAPI.yaml

openapi: 3.1.0
info:
  title: "DataOps Platform API（当前代码基线）"
  version: "2026-08-09"
  description: "由 scripts/generate_openapi.py 从 app/api/*/routes.py 生成。请求体与响应细节仍以现有专项 API 文档和代码为准。"
x-route-count: 504
servers:
  - url: "http://localhost:15500"
    description: "全本地隔离测试后端"
tags:
  - name: meta_data
    description: "/api/meta"
  - name: data_interface
    description: "/api/interface"
  - name: data_rules
    description: "/api/rules"
  - 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/observability/alerts":
    get:
      tags: [data_factory]
      operationId: data_factory_list_observability_alerts_get
      summary: "list observability alerts"
      x-source: "app/api/data_factory/observability_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/observability/alerts/{alert_uid}/acknowledge-delivery":
    post:
      tags: [data_factory]
      operationId: data_factory_acknowledge_observability_alert_delivery_post
      summary: "acknowledge observability alert delivery"
      x-source: "app/api/data_factory/observability_routes.py"
      parameters:
        - name: alert_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/datafactory/observability/alerts/{alert_uid}/suppress":
    post:
      tags: [data_factory]
      operationId: data_factory_suppress_observability_alert_post
      summary: "suppress observability alert"
      x-source: "app/api/data_factory/observability_routes.py"
      parameters:
        - name: alert_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/datafactory/observability/collect":
    post:
      tags: [data_factory]
      operationId: data_factory_collect_observability_signals_post
      summary: "collect observability signals"
      x-source: "app/api/data_factory/observability_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/observability/incidents":
    get:
      tags: [data_factory]
      operationId: data_factory_list_data_incidents_get
      summary: "list data incidents"
      x-source: "app/api/data_factory/observability_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/observability/incidents/{incident_uid}":
    get:
      tags: [data_factory]
      operationId: data_factory_get_data_incident_get
      summary: "get data incident"
      x-source: "app/api/data_factory/observability_routes.py"
      parameters:
        - name: incident_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/datafactory/observability/incidents/{incident_uid}/close":
    post:
      tags: [data_factory]
      operationId: data_factory_close_data_incident_post
      summary: "close data incident"
      x-source: "app/api/data_factory/observability_routes.py"
      parameters:
        - name: incident_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/datafactory/observability/incidents/{incident_uid}/escalate":
    post:
      tags: [data_factory]
      operationId: data_factory_escalate_data_incident_post
      summary: "escalate data incident"
      x-source: "app/api/data_factory/observability_routes.py"
      parameters:
        - name: incident_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/datafactory/observability/operations/deliveries":
    post:
      tags: [data_factory]
      operationId: data_factory_enqueue_production_delivery_post
      summary: "enqueue production delivery"
      x-source: "app/api/data_factory/observability_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductionDeliveryRequest'
      x-required-permission: "data-observability:operate"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductionDeliveryEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/datafactory/observability/overview":
    get:
      tags: [data_factory]
      operationId: data_factory_get_observability_overview_get
      summary: "get observability overview"
      x-source: "app/api/data_factory/observability_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/observability/slos":
    get:
      tags: [data_factory]
      operationId: data_factory_list_slo_policies_get
      summary: "list slo policies"
      x-source: "app/api/data_factory/observability_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_factory]
      operationId: data_factory_create_slo_policy_post
      summary: "create slo policy"
      x-source: "app/api/data_factory/observability_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/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/governance/applications":
    get:
      tags: [data_service]
      operationId: data_service_list_product_applications_get
      summary: "list product applications"
      x-source: "app/api/data_service/product_governance_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_create_product_application_post
      summary: "create product application"
      x-source: "app/api/data_service/product_governance_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/governance/applications/{application_uid}/fulfill":
    post:
      tags: [data_service]
      operationId: data_service_fulfill_product_application_post
      summary: "fulfill product application"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: application_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/dataservice/governance/applications/{application_uid}/reconcile":
    post:
      tags: [data_service]
      operationId: data_service_reconcile_product_application_post
      summary: "reconcile product application"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: application_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/dataservice/governance/applications/{application_uid}/submit":
    post:
      tags: [data_service]
      operationId: data_service_submit_product_application_post
      summary: "submit product application"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: application_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/dataservice/governance/contracts/{contract_uid}/compatibility":
    post:
      tags: [data_service]
      operationId: data_service_check_product_contract_compatibility_post
      summary: "check product contract compatibility"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: contract_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/dataservice/governance/contracts/{contract_uid}/publish":
    post:
      tags: [data_service]
      operationId: data_service_publish_product_contract_post
      summary: "publish product contract"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: contract_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/dataservice/governance/contracts/{contract_uid}/revisions":
    post:
      tags: [data_service]
      operationId: data_service_revise_product_contract_post
      summary: "revise product contract"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: contract_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/dataservice/governance/contracts/{contract_uid}/terminate":
    post:
      tags: [data_service]
      operationId: data_service_terminate_product_contract_post
      summary: "terminate product contract"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: contract_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/dataservice/governance/dashboard":
    get:
      tags: [data_service]
      operationId: data_service_product_governance_dashboard_get
      summary: "product governance dashboard"
      x-source: "app/api/data_service/product_governance_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/governance/feedback/{feedback_uid}/transition":
    post:
      tags: [data_service]
      operationId: data_service_transition_product_feedback_post
      summary: "transition product feedback"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: feedback_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/dataservice/governance/products":
    get:
      tags: [data_service]
      operationId: data_service_list_governed_products_get
      summary: "list governed products"
      x-source: "app/api/data_service/product_governance_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_governed_product_post
      summary: "register governed product"
      x-source: "app/api/data_service/product_governance_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/governance/products/{product_uid}":
    get:
      tags: [data_service]
      operationId: data_service_get_governed_product_get
      summary: "get governed product"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: product_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/dataservice/governance/products/{product_uid}/certificates":
    post:
      tags: [data_service]
      operationId: data_service_issue_product_certificate_post
      summary: "issue product certificate"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: product_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/dataservice/governance/products/{product_uid}/contracts":
    post:
      tags: [data_service]
      operationId: data_service_create_product_contract_post
      summary: "create product contract"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: product_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/dataservice/governance/products/{product_uid}/feedback":
    post:
      tags: [data_service]
      operationId: data_service_create_product_feedback_post
      summary: "create product feedback"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: product_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/dataservice/governance/products/{product_uid}/transition":
    post:
      tags: [data_service]
      operationId: data_service_transition_governed_product_post
      summary: "transition governed product"
      x-source: "app/api/data_service/product_governance_routes.py"
      parameters:
        - name: product_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/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/connectors/config/validate":
    post:
      tags: [data_source]
      operationId: data_source_connector_config_validate_post
      summary: "connector config validate"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorConfigValidationRequest'
      x-required-permission: "connectors:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorValidationEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/credentials/{credential_uid}/{action}":
    post:
      tags: [data_source]
      operationId: data_source_connector_credential_action_post
      summary: "connector credential action"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: credential_uid
          in: path
          required: true
          schema:
            type: string
        - name: action
          in: path
          required: true
          schema:
            type: string
            enum: [revoke, rotate]
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorCredentialRequest'
      x-required-permission: "connectors:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorCredentialEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/machine/runs":
    post:
      tags: [data_source]
      operationId: data_source_connector_machine_run_post
      summary: "Machine-only run boundary; a human bearer token is never accepted here."
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: X-Connector-Credential
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MachineConnectorRunRequest'
      x-required-permission: "machine-credential"
      responses:
        "201":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorRunResultEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/machine/runs/{idempotency_key}/cancel":
    post:
      tags: [data_source]
      operationId: data_source_connector_machine_run_cancel_post
      summary: "Cancel one bound machine run with a fresh one-time credential."
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: idempotency_key
          in: path
          required: true
          schema:
            type: string
        - name: X-Connector-Credential
          in: header
          required: true
          schema:
            type: string
      x-required-permission: "machine-credential"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/machine/runs/{idempotency_key}/resume":
    post:
      tags: [data_source]
      operationId: data_source_connector_machine_run_resume_post
      summary: "Resume one bound machine run with a fresh one-time credential."
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: idempotency_key
          in: path
          required: true
          schema:
            type: string
        - name: X-Connector-Credential
          in: header
          required: true
          schema:
            type: string
      x-required-permission: "machine-credential"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/manifests":
    get:
      tags: [data_source]
      operationId: data_source_connector_manifests_get
      summary: "connector manifests"
      x-source: "app/api/data_source/routes.py"
      x-required-permission: "connectors:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorManifestEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/principals":
    post:
      tags: [data_source]
      operationId: data_source_connector_principal_create_post
      summary: "connector principal create"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorPrincipalRequest'
      x-required-permission: "connectors:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorPrincipalEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/principals/{principal_uid}/credentials":
    post:
      tags: [data_source]
      operationId: data_source_connector_credential_issue_post
      summary: "connector credential issue"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: principal_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorCredentialRequest'
      x-required-permission: "connectors:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorCredentialEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/runs":
    get:
      tags: [data_source]
      operationId: data_source_connector_runs_list_get
      summary: "connector runs list"
      x-source: "app/api/data_source/routes.py"
      x-required-permission: "connectors:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorRunListEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
    post:
      tags: [data_source]
      operationId: data_source_connector_run_create_post
      summary: "connector run create"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorRunRequest'
      x-required-permission: "connectors:operate"
      responses:
        "201":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorRunResultEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/runs/{idempotency_key}/cancel":
    post:
      tags: [data_source]
      operationId: data_source_connector_run_cancel_post
      summary: "connector run cancel"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: idempotency_key
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "connectors:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorRunRecordEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/runs/{idempotency_key}/resume":
    post:
      tags: [data_source]
      operationId: data_source_connector_run_resume_post
      summary: "connector run resume"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: idempotency_key
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "connectors:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorRunResultEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/source-bindings":
    get:
      tags: [data_source]
      operationId: data_source_connector_source_bindings_list_get
      summary: "connector source bindings list"
      x-source: "app/api/data_source/routes.py"
      x-required-permission: "connectors:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
    post:
      tags: [data_source]
      operationId: data_source_connector_source_binding_approve_post
      summary: "connector source binding approve"
      x-source: "app/api/data_source/routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorSourceBindingRequest'
      x-required-permission: "connectors:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorSourceBindingEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/source-bindings/{binding_uid}/revoke":
    post:
      tags: [data_source]
      operationId: data_source_connector_source_binding_revoke_post
      summary: "connector source binding revoke"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: binding_uid
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "connectors:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/{connector_id}/{version}/compatibility":
    get:
      tags: [data_source]
      operationId: data_source_connector_compatibility_get
      summary: "connector compatibility"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: connector_id
          in: path
          required: true
          schema:
            type: string
        - name: version
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "connectors:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorCompatibilityEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/api/datasource/connectors/{connector_id}/{version}/health":
    post:
      tags: [data_source]
      operationId: data_source_connector_health_post
      summary: "connector health"
      x-source: "app/api/data_source/routes.py"
      parameters:
        - name: connector_id
          in: path
          required: true
          schema:
            type: string
        - name: version
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorHealthRequest'
      x-required-permission: "connectors:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorHealthEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/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/edge/enrollments":
    post:
      tags: [data_source]
      operationId: data_source_edge_create_enrollment_post
      summary: "edge create enrollment"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeEnrollmentRequest'
      x-required-permission: "edge-gateways:manage"
      security:
        - bearerAuth: []
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeEnrollmentEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways":
    get:
      tags: [data_source]
      operationId: data_source_edge_list_gateways_get
      summary: "edge list gateways"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            maximum: 10000
      x-required-permission: "edge-gateways:read"
      security:
        - bearerAuth: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeGatewayListEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/events":
    post:
      tags: [data_source]
      operationId: data_source_edge_accept_event_post
      summary: "edge accept event"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeEventRequest'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeEventAckEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/heartbeat":
    post:
      tags: [data_source]
      operationId: data_source_edge_heartbeat_post
      summary: "edge heartbeat"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeHeartbeatRequest'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/reconcile":
    post:
      tags: [data_source]
      operationId: data_source_edge_reconcile_post
      summary: "edge reconcile"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeReconcileRequest'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeReconcileResponse'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/releases":
    post:
      tags: [data_source]
      operationId: data_source_edge_offer_release_post
      summary: "edge offer release"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeReleaseOfferRequest'
      x-required-permission: "edge-gateways:operate"
      security:
        - bearerAuth: []
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeReleaseEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/releases/ack":
    post:
      tags: [data_source]
      operationId: data_source_edge_ack_release_post
      summary: "edge ack release"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeReleaseAckRequest'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/revoke":
    post:
      tags: [data_source]
      operationId: data_source_edge_revoke_post
      summary: "edge revoke"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "edge-gateways:operate"
      security:
        - bearerAuth: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/rotate":
    post:
      tags: [data_source]
      operationId: data_source_edge_rotate_post
      summary: "edge rotate"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeRotateRequest'
      x-required-permission: "edge-gateways:operate"
      security:
        - bearerAuth: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/tasks/pull":
    post:
      tags: [data_source]
      operationId: data_source_edge_pull_task_post
      summary: "edge pull task"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeMachineBinding'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeTaskPullEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/gateways/{gateway_id}/tasks/{task_id}/outcome":
    post:
      tags: [data_source]
      operationId: data_source_edge_task_outcome_post
      summary: "edge task outcome"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: gateway_id
          in: path
          required: true
          schema:
            type: string
        - name: task_id
          in: path
          required: true
          schema:
            type: string
        - name: X-Edge-Credential
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeTaskOutcomeRequest'
      x-required-permission: "edge-credential+mTLS"
      security:
        - mutualTLS: []
          edgeCredential: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/register":
    post:
      tags: [data_source]
      operationId: data_source_edge_register_post
      summary: "edge register"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: X-Edge-Enrollment
          in: header
          required: true
          schema:
            type: string
            format: password
            writeOnly: true
        - name: X-DataOps-Edge-Client-Verify
          in: header
          required: true
          schema:
            type: string
        - name: X-DataOps-Edge-Client-Cert
          in: header
          required: true
          schema:
            type: string
        - name: X-Edge-Certificate-SHA256
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeRegisterRequest'
      x-required-permission: "one-time-enrollment+mTLS"
      security:
        - mutualTLS: []
          edgeEnrollment: []
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeRegistrationEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/tasks":
    post:
      tags: [data_source]
      operationId: data_source_edge_issue_task_post
      summary: "edge issue task"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgeTaskContract'
      x-required-permission: "edge-gateways:operate"
      security:
        - bearerAuth: []
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/api/datasource/edge/tasks/{task_id}/cancel":
    post:
      tags: [data_source]
      operationId: data_source_edge_cancel_task_post
      summary: "edge cancel task"
      x-source: "app/api/data_source/edge_routes.py"
      x-max-request-bytes: 262144
      x-max-json-depth: 32
      x-max-json-nodes: 5000
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "edge-gateways:operate"
      security:
        - bearerAuth: []
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgeErrorEnvelope'
  "/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: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorGraphRequest'
      x-required-permission: "connectors:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorGraphEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorErrorEnvelope'
  "/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-assets":
    get:
      tags: [data_development]
      operationId: data_development_list_semantic_assets_get
      summary: "list semantic assets"
      x-source: "app/api/data_development/semantic_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_semantic_asset_post
      summary: "create semantic asset"
      x-source: "app/api/data_development/semantic_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/semantic-assets/export":
    get:
      tags: [data_development]
      operationId: data_development_export_semantic_assets_get
      summary: "export semantic assets"
      x-source: "app/api/data_development/semantic_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/semantic-assets/{asset_uid}":
    get:
      tags: [data_development]
      operationId: data_development_get_semantic_asset_get
      summary: "get semantic asset"
      x-source: "app/api/data_development/semantic_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/semantic-assets/{asset_uid}/audits":
    get:
      tags: [data_development]
      operationId: data_development_list_semantic_asset_audits_get
      summary: "list semantic asset audits"
      x-source: "app/api/data_development/semantic_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/semantic-assets/{asset_uid}/publish":
    post:
      tags: [data_development]
      operationId: data_development_publish_semantic_asset_post
      summary: "publish semantic asset"
      x-source: "app/api/data_development/semantic_routes.py"
      parameters:
        - name: asset_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/semantic-assets/{asset_uid}/review":
    post:
      tags: [data_development]
      operationId: data_development_review_semantic_asset_post
      summary: "review semantic asset"
      x-source: "app/api/data_development/semantic_routes.py"
      parameters:
        - name: asset_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/semantic-assets/{asset_uid}/reviews":
    get:
      tags: [data_development]
      operationId: data_development_list_semantic_asset_reviews_get
      summary: "list semantic asset reviews"
      x-source: "app/api/data_development/semantic_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/semantic-assets/{asset_uid}/revisions":
    post:
      tags: [data_development]
      operationId: data_development_revise_semantic_asset_post
      summary: "revise semantic asset"
      x-source: "app/api/data_development/semantic_routes.py"
      parameters:
        - name: asset_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/semantic-assets/{asset_uid}/rollback":
    post:
      tags: [data_development]
      operationId: data_development_rollback_semantic_asset_post
      summary: "rollback semantic asset"
      x-source: "app/api/data_development/semantic_routes.py"
      parameters:
        - name: asset_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/semantic-assets/{asset_uid}/submit":
    post:
      tags: [data_development]
      operationId: data_development_submit_semantic_asset_post
      summary: "submit semantic asset"
      x-source: "app/api/data_development/semantic_routes.py"
      parameters:
        - name: asset_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/semantic-assets/{asset_uid}/versions":
    get:
      tags: [data_development]
      operationId: data_development_list_semantic_asset_versions_get
      summary: "list semantic asset versions"
      x-source: "app/api/data_development/semantic_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/semantic-field-mappings":
    get:
      tags: [data_development]
      operationId: data_development_list_semantic_field_mappings_get
      summary: "list semantic field mappings"
      x-source: "app/api/data_development/semantic_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_semantic_field_mapping_post
      summary: "create semantic field mapping"
      x-source: "app/api/data_development/semantic_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/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/agents":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_list_governed_agents_get
      summary: "list governed agents"
      x-source: "app/api/knowledge_base/agent_governance_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: [knowledge_base]
      operationId: knowledge_base_register_governed_agent_post
      summary: "register governed agent"
      x-source: "app/api/knowledge_base/agent_governance_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/agents/actions":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_list_agent_actions_get
      summary: "list agent actions"
      x-source: "app/api/knowledge_base/agent_governance_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/agents/actions/{request_uid}/complete":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_complete_agent_action_post
      summary: "complete agent action"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: request_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/agents/actions/{request_uid}/reconcile":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_reconcile_agent_action_post
      summary: "reconcile agent action"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: request_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/agents/actions/{request_uid}/replay":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_replay_agent_action_get
      summary: "replay agent action"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: request_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/agents/dashboard":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_agent_governance_dashboard_get
      summary: "agent governance dashboard"
      x-source: "app/api/knowledge_base/agent_governance_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/agents/{agent_uid}":
    get:
      tags: [knowledge_base]
      operationId: knowledge_base_get_governed_agent_get
      summary: "get governed agent"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/actions/authorize":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_authorize_agent_action_post
      summary: "authorize agent action"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/credentials":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_issue_agent_credential_post
      summary: "issue agent credential"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/credentials/revoke":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_revoke_agent_credentials_post
      summary: "revoke agent credentials"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/grants":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_create_agent_tool_grant_post
      summary: "create agent tool grant"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/grants/{grant_uid}/revoke":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_revoke_agent_tool_grant_post
      summary: "revoke agent tool grant"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_uid
          in: path
          required: true
          schema:
            type: string
        - name: grant_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/agents/{agent_uid}/revisions":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_revise_governed_agent_post
      summary: "revise governed agent"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/runtime/control":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_control_runtime_post
      summary: "Execute a recovery/canary change only through an authenticated control claim."
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/runtime/invocations":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_authorize_runtime_invocation_post
      summary: "The only HTTP path that binds Agent credentials to a server identity."
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/agents/{agent_uid}/runtime/invocations/{idempotency_key}/settle":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_settle_runtime_invocation_post
      summary: "settle runtime invocation"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_uid
          in: path
          required: true
          schema:
            type: string
        - name: idempotency_key
          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/agents/{agent_uid}/transition":
    post:
      tags: [knowledge_base]
      operationId: knowledge_base_transition_governed_agent_post
      summary: "transition governed agent"
      x-source: "app/api/knowledge_base/agent_governance_routes.py"
      parameters:
        - name: agent_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/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/active-metadata/assets":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_assets_get
      summary: "list active metadata assets"
      x-source: "app/api/meta_data/active_metadata.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/active-metadata/assets/{asset_uid}/corrections":
    post:
      tags: [meta_data]
      operationId: meta_data_submit_active_metadata_correction_post
      summary: "submit active metadata correction"
      x-source: "app/api/meta_data/active_metadata.py"
      parameters:
        - name: asset_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/meta/active-metadata/corrections":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_corrections_get
      summary: "list active metadata corrections"
      x-source: "app/api/meta_data/active_metadata.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/active-metadata/corrections/{correction_uid}/resolve":
    post:
      tags: [meta_data]
      operationId: meta_data_resolve_active_metadata_correction_post
      summary: "resolve active metadata correction"
      x-source: "app/api/meta_data/active_metadata.py"
      parameters:
        - name: correction_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/meta/active-metadata/plans":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_plans_get
      summary: "list active metadata plans"
      x-source: "app/api/meta_data/active_metadata.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
    post:
      tags: [meta_data]
      operationId: meta_data_create_active_metadata_plan_post
      summary: "create active metadata plan"
      x-source: "app/api/meta_data/active_metadata.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/active-metadata/plans/{plan_uid}/runs":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_runs_get
      summary: "list active metadata runs"
      x-source: "app/api/meta_data/active_metadata.py"
      parameters:
        - name: plan_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: [meta_data]
      operationId: meta_data_execute_active_metadata_plan_post
      summary: "execute active metadata plan"
      x-source: "app/api/meta_data/active_metadata.py"
      parameters:
        - name: plan_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/meta/active-metadata/runs/{run_uid}/changes":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_changes_get
      summary: "list active metadata changes"
      x-source: "app/api/meta_data/active_metadata.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/meta/active-metadata/runs/{run_uid}/health-signals":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_health_get
      summary: "list active metadata health"
      x-source: "app/api/meta_data/active_metadata.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/meta/active-metadata/runs/{run_uid}/lineage":
    get:
      tags: [meta_data]
      operationId: meta_data_list_active_metadata_lineage_get
      summary: "list active metadata lineage"
      x-source: "app/api/meta_data/active_metadata.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/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/domain-templates":
    get:
      tags: [meta_data]
      operationId: meta_data_list_domain_templates_get
      summary: "list domain templates"
      x-source: "app/api/meta_data/domain_templates.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/meta/domain-templates/dry-run":
    post:
      tags: [meta_data]
      operationId: meta_data_dry_run_domain_template_post
      summary: "dry run domain template"
      x-source: "app/api/meta_data/domain_templates.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/domain-templates/import":
    post:
      tags: [meta_data]
      operationId: meta_data_import_domain_template_post
      summary: "import domain template"
      x-source: "app/api/meta_data/domain_templates.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/domain-templates/{template_code}":
    get:
      tags: [meta_data]
      operationId: meta_data_get_domain_template_get
      summary: "get domain template"
      x-source: "app/api/meta_data/domain_templates.py"
      parameters:
        - name: template_code
          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/meta/domain-templates/{template_code}/imports":
    get:
      tags: [meta_data]
      operationId: meta_data_list_domain_template_imports_get
      summary: "list domain template imports"
      x-source: "app/api/meta_data/domain_templates.py"
      parameters:
        - name: template_code
          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/meta/domain-templates/{template_code}/rollback":
    post:
      tags: [meta_data]
      operationId: meta_data_rollback_domain_template_post
      summary: "rollback domain template"
      x-source: "app/api/meta_data/domain_templates.py"
      parameters:
        - name: template_code
          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/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/rules/capabilities":
    get:
      tags: [data_rules]
      operationId: data_rules_capabilities_get
      summary: "capabilities"
      x-source: "app/api/data_rules/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/rules/catalog":
    get:
      tags: [data_rules]
      operationId: data_rules_published_rule_catalog_get
      summary: "published rule catalog"
      x-source: "app/api/data_rules/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/rules/catalog/assets/{asset_type}/{version_id}":
    get:
      tags: [data_rules]
      operationId: data_rules_catalog_asset_get
      summary: "catalog asset"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: asset_type
          in: path
          required: true
          schema:
            type: string
        - name: version_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/rules/catalog/assets/{asset_type}/{version_id}/evidence":
    get:
      tags: [data_rules]
      operationId: data_rules_catalog_asset_evidence_get
      summary: "catalog asset evidence"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: asset_type
          in: path
          required: true
          schema:
            type: string
        - name: version_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/rules/catalog/rule-versions":
    get:
      tags: [data_rules]
      operationId: data_rules_published_rule_catalog_get
      summary: "published rule catalog"
      x-source: "app/api/data_rules/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/rules/deployments":
    get:
      tags: [data_rules]
      operationId: data_rules_list_dataflow_deployments_get
      summary: "list dataflow deployments"
      x-source: "app/api/data_rules/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_rules]
      operationId: data_rules_create_dataflow_deployment_post
      summary: "create dataflow deployment"
      x-source: "app/api/data_rules/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/rules/deployments/candidates":
    get:
      tags: [data_rules]
      operationId: data_rules_list_dataflow_deployment_candidates_get
      summary: "list dataflow deployment candidates"
      x-source: "app/api/data_rules/routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/rules/deployments/{deployment_id}/activate":
    post:
      tags: [data_rules]
      operationId: data_rules_activate_dataflow_deployment_post
      summary: "activate dataflow deployment"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/canary":
    post:
      tags: [data_rules]
      operationId: data_rules_run_dataflow_canary_post
      summary: "run dataflow canary"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/deploy-disabled":
    post:
      tags: [data_rules]
      operationId: data_rules_deploy_dataflow_disabled_post
      summary: "deploy dataflow disabled"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/execute":
    post:
      tags: [data_rules]
      operationId: data_rules_execute_active_dataflow_deployment_post
      summary: "execute active dataflow deployment"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/reconcile-activate":
    post:
      tags: [data_rules]
      operationId: data_rules_reconcile_dataflow_activate_post
      summary: "reconcile dataflow activate"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/reconcile-deploy":
    post:
      tags: [data_rules]
      operationId: data_rules_reconcile_dataflow_deploy_post
      summary: "reconcile dataflow deploy"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/reconcile-execute":
    post:
      tags: [data_rules]
      operationId: data_rules_reconcile_dataflow_execute_post
      summary: "reconcile dataflow execute"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/reconcile-rollback":
    post:
      tags: [data_rules]
      operationId: data_rules_reconcile_dataflow_rollback_post
      summary: "reconcile dataflow rollback"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/deployments/{deployment_id}/rollback":
    post:
      tags: [data_rules]
      operationId: data_rules_rollback_dataflow_deployment_post
      summary: "rollback dataflow deployment"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: deployment_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/rules/execution-plans/{plan_id}/publish":
    post:
      tags: [data_rules]
      operationId: data_rules_publish_physical_plan_post
      summary: "publish physical plan"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: plan_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/rules/execution-plans/{plan_id}/test":
    post:
      tags: [data_rules]
      operationId: data_rules_test_physical_plan_post
      summary: "test physical plan"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: plan_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/rules/execution-plans/{plan_id}/validate":
    post:
      tags: [data_rules]
      operationId: data_rules_validate_physical_plan_post
      summary: "validate physical plan"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: plan_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/rules/interpret":
    post:
      tags: [data_rules]
      operationId: data_rules_interpret_rule_post
      summary: "interpret rule"
      x-source: "app/api/data_rules/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/rules/production-lines/draft-identity":
    post:
      tags: [data_rules]
      operationId: data_rules_create_production_line_draft_identity_post
      summary: "Persist a short-lived, single-use, actor-bound DataFlow reservation."
      x-source: "app/api/data_rules/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/rules/production-lines/resolve":
    post:
      tags: [data_rules]
      operationId: data_rules_resolve_production_line_preview_post
      summary: "resolve production line preview"
      x-source: "app/api/data_rules/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/rules/production-lines/{dataflow_uid}/release":
    post:
      tags: [data_rules]
      operationId: data_rules_release_production_line_post
      summary: "release production line"
      x-source: "app/api/data_rules/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/rules/quality-operations/assets/{asset_uid}/trend":
    get:
      tags: [data_rules]
      operationId: data_rules_get_quality_trend_get
      summary: "get quality trend"
      x-source: "app/api/data_rules/quality_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/rules/quality-operations/execute":
    post:
      tags: [data_rules]
      operationId: data_rules_execute_quality_profile_post
      summary: "execute quality profile"
      x-source: "app/api/data_rules/quality_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/rules/quality-operations/runs":
    get:
      tags: [data_rules]
      operationId: data_rules_list_quality_runs_get
      summary: "list quality runs"
      x-source: "app/api/data_rules/quality_routes.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/rules/quality-operations/runs/{run_uid}":
    get:
      tags: [data_rules]
      operationId: data_rules_get_quality_run_get
      summary: "get quality run"
      x-source: "app/api/data_rules/quality_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/rules/quality-operations/templates":
    get:
      tags: [data_rules]
      operationId: data_rules_list_quality_templates_get
      summary: "list quality templates"
      x-source: "app/api/data_rules/quality_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_rules]
      operationId: data_rules_create_quality_template_post
      summary: "create quality template"
      x-source: "app/api/data_rules/quality_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/rules/quality-operations/templates/{template_uid}/publish":
    post:
      tags: [data_rules]
      operationId: data_rules_publish_quality_template_post
      summary: "publish quality template"
      x-source: "app/api/data_rules/quality_routes.py"
      parameters:
        - name: template_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/rules/quality-operations/templates/{template_uid}/revisions":
    post:
      tags: [data_rules]
      operationId: data_rules_revise_quality_template_post
      summary: "revise quality template"
      x-source: "app/api/data_rules/quality_routes.py"
      parameters:
        - name: template_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/rules/rule-versions":
    post:
      tags: [data_rules]
      operationId: data_rules_create_rule_version_post
      summary: "create rule version"
      x-source: "app/api/data_rules/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/rules/rule-versions/{version_id}/evidence":
    get:
      tags: [data_rules]
      operationId: data_rules_rule_version_evidence_get
      summary: "rule version evidence"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - name: version_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/rules/rule-versions/{version_id}/publish":
    post:
      tags: [data_rules]
      operationId: data_rules_publish_rule_version_post
      summary: "publish rule version"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - 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/rules/rule-versions/{version_id}/test":
    post:
      tags: [data_rules]
      operationId: data_rules_test_rule_version_post
      summary: "test rule version"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - 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/rules/rule-versions/{version_id}/validate":
    post:
      tags: [data_rules]
      operationId: data_rules_validate_rule_version_post
      summary: "validate rule version"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - 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/rules/standard-versions":
    post:
      tags: [data_rules]
      operationId: data_rules_create_standard_version_post
      summary: "create standard version"
      x-source: "app/api/data_rules/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/rules/standard-versions/{version_id}/publish":
    post:
      tags: [data_rules]
      operationId: data_rules_publish_standard_version_post
      summary: "publish standard version"
      x-source: "app/api/data_rules/routes.py"
      parameters:
        - 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/rules/validate":
    post:
      tags: [data_rules]
      operationId: data_rules_validate_asset_post
      summary: "validate asset"
      x-source: "app/api/data_rules/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/bi-ai-catalog/assets/search":
    post:
      tags: [system]
      operationId: system_search_catalog_assets_post
      summary: "search catalog assets"
      x-source: "app/api/system/bi_ai_catalog_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [query, filters]
              properties:
                query:
                  type: string
                filters:
                  type: object
      x-required-permission: "bi-ai-catalog:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/bi-ai-catalog/assets/{external_uid}/impact":
    get:
      tags: [system]
      operationId: system_catalog_asset_impact_get
      summary: "catalog asset impact"
      x-source: "app/api/system/bi_ai_catalog_routes.py"
      parameters:
        - name: external_uid
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "bi-ai-catalog:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/bi-ai-catalog/audit":
    get:
      tags: [system]
      operationId: system_catalog_audit_get
      summary: "catalog audit"
      x-source: "app/api/system/bi_ai_catalog_routes.py"
      x-required-permission: "bi-ai-catalog:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/bi-ai-catalog/local-fixture/sync":
    post:
      tags: [system]
      operationId: system_sync_local_fixture_post
      summary: "sync local fixture"
      x-source: "app/api/system/bi_ai_catalog_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: []
      x-required-permission: "bi-ai-catalog:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          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/governance_audit.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/governance_audit.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/governance_audit.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/governance_audit.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/governance_audit.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/governance_audit.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/identity/audit":
    get:
      tags: [system]
      operationId: system_identity_audit_get
      summary: "identity audit"
      x-source: "app/api/system/enterprise_identity.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/identity/authorize":
    post:
      tags: [system]
      operationId: system_identity_authorize_post
      summary: "identity authorize"
      x-source: "app/api/system/enterprise_identity.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/identity/callback":
    get:
      tags: [system]
      operationId: system_identity_callback_get
      summary: "identity callback"
      x-source: "app/api/system/enterprise_identity.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/identity/claims/dry-run":
    post:
      tags: [system]
      operationId: system_identity_claims_dry_run_post
      summary: "identity claims dry run"
      x-source: "app/api/system/enterprise_identity.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/identity/directory/delta":
    post:
      tags: [system]
      operationId: system_identity_directory_delta_post
      summary: "identity directory delta"
      x-source: "app/api/system/enterprise_identity.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/identity/emergency/requests":
    post:
      tags: [system]
      operationId: system_identity_emergency_request_post
      summary: "identity emergency request"
      x-source: "app/api/system/enterprise_identity.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/identity/emergency/{request_uid}/{action}":
    post:
      tags: [system]
      operationId: system_identity_emergency_action_post
      summary: "identity emergency action"
      x-source: "app/api/system/enterprise_identity.py"
      parameters:
        - name: request_uid
          in: path
          required: true
          schema:
            type: string
        - name: action
          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/identity/exchange":
    post:
      tags: [system]
      operationId: system_identity_exchange_post
      summary: "identity exchange"
      x-source: "app/api/system/enterprise_identity.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/identity/idp-versions":
    get:
      tags: [system]
      operationId: system_identity_idp_versions_get
      summary: "identity idp versions"
      x-source: "app/api/system/enterprise_identity.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_identity_idp_version_create_post
      summary: "identity idp version create"
      x-source: "app/api/system/enterprise_identity.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/identity/idp-versions/{provider_uid}/{version}/{action}":
    post:
      tags: [system]
      operationId: system_identity_idp_action_post
      summary: "identity idp action"
      x-source: "app/api/system/enterprise_identity.py"
      parameters:
        - name: provider_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          in: path
          required: true
          schema:
            type: integer
        - name: action
          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/identity/logout":
    post:
      tags: [system]
      operationId: system_identity_logout_post
      summary: "identity logout"
      x-source: "app/api/system/enterprise_identity.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/identity/providers":
    get:
      tags: [system]
      operationId: system_identity_providers_get
      summary: "identity providers"
      x-source: "app/api/system/enterprise_identity.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/identity/refresh":
    post:
      tags: [system]
      operationId: system_identity_refresh_post
      summary: "identity refresh"
      x-source: "app/api/system/enterprise_identity.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/identity/sessions":
    get:
      tags: [system]
      operationId: system_identity_sessions_get
      summary: "identity sessions"
      x-source: "app/api/system/enterprise_identity.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/identity/sessions/revoke-all":
    post:
      tags: [system]
      operationId: system_identity_session_revoke_all_post
      summary: "identity session revoke all"
      x-source: "app/api/system/enterprise_identity.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/identity/sessions/{session_uid}/revoke":
    post:
      tags: [system]
      operationId: system_identity_session_revoke_post
      summary: "identity session revoke"
      x-source: "app/api/system/enterprise_identity.py"
      parameters:
        - name: session_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/identity/sessions/{session_uid}/risk-terminate":
    post:
      tags: [system]
      operationId: system_identity_session_risk_post
      summary: "identity session risk"
      x-source: "app/api/system/enterprise_identity.py"
      parameters:
        - name: session_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/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/metering/allocation-replay":
    get:
      tags: [system]
      operationId: system_get_metering_allocation_replay_get
      summary: "replay one persisted allocation-rule version"
      x-source: "app/api/system/metering_showback_routes.py"
      parameters:
        - name: window
          in: query
          required: true
          schema:
            type: string
        - name: rule_uid
          in: query
          required: true
          schema:
            type: string
        - name: rule_version
          in: query
          required: true
          schema:
            type: integer
      x-required-permission: "metering:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/metering/allocations":
    post:
      tags: [system]
      operationId: system_publish_metering_allocation_post
      summary: "publish versioned local allocation rule"
      x-source: "app/api/system/metering_showback_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [schema_version, rule_uid, rule_version, effective_start, effective_end, mapping, allocations]
              properties:
                schema_version:
                  type: integer
                rule_uid:
                  type: string
                rule_version:
                  type: integer
                effective_start:
                  type: string
                effective_end:
                  type: string
                mapping:
                  type: object
                  additionalProperties: false
                  required: [department, project, cost_center]
                  properties:
                    department: {type: string}
                    project: {type: string}
                    cost_center: {type: string}
                allocations:
                  type: array
                  minItems: 1
                  maxItems: 32
                  items:
                    type: object
                    additionalProperties: false
                    required: [target, weight_micros]
                    properties:
                      target: {type: string}
                      weight_micros: {type: integer, minimum: 1, maximum: 1000000}
      x-required-permission: "metering:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/metering/budgets":
    post:
      tags: [system]
      operationId: system_evaluate_metering_budget_post
      summary: "persist disabled-provider budget alert evidence"
      x-source: "app/api/system/metering_showback_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [schema_version, budget_uid, window, mapping, limit_micros, threshold_micros]
              properties:
                schema_version:
                  type: integer
                budget_uid:
                  type: string
                window:
                  type: string
                mapping:
                  type: object
                  additionalProperties: false
                  required: [department, project, cost_center]
                  properties:
                    department: {type: string}
                    project: {type: string}
                    cost_center: {type: string}
                limit_micros:
                  type: integer
                threshold_micros:
                  type: integer
      x-required-permission: "metering:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/metering/events":
    post:
      tags: [system]
      operationId: system_record_metering_event_post
      summary: "record local metering event"
      x-source: "app/api/system/metering_showback_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [schema_version, event_uid, event_kind, occurred_at, window_start, window_end, quantity, unit, idempotency_key, evidence, mapping]
              properties:
                schema_version:
                  type: integer
                event_uid:
                  type: string
                event_kind:
                  type: string
                occurred_at:
                  type: string
                window_start:
                  type: string
                window_end:
                  type: string
                quantity:
                  type: string
                unit:
                  type: string
                idempotency_key:
                  type: string
                evidence:
                  type: object
                  additionalProperties: false
                  required: [digest, reference]
                  properties:
                    digest: {type: string}
                    reference: {type: string}
                mapping:
                  type: object
                  additionalProperties: false
                  required: [department, project, cost_center]
                  properties:
                    department: {type: string}
                    project: {type: string}
                    cost_center: {type: string}
      x-required-permission: "metering:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/metering/reconciliation":
    get:
      tags: [system]
      operationId: system_get_metering_reconciliation_get
      summary: "get metering reconciliation"
      x-source: "app/api/system/metering_showback_routes.py"
      parameters:
        - name: window
          in: query
          required: true
          schema:
            type: string
      x-required-permission: "metering:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/metering/showback":
    get:
      tags: [system]
      operationId: system_get_showback_get
      summary: "get local showback"
      x-source: "app/api/system/metering_showback_routes.py"
      parameters:
        - name: window
          in: query
          required: true
          schema:
            type: string
      x-required-permission: "metering:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/plugins/invocations":
    post:
      tags: [system]
      operationId: system_invoke_plugin_fixture_post
      summary: "Invoke only an approved fixed local fixture through the DB gateway."
      x-source: "app/api/system/plugin_platform_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/plugins/local-fixture/validate":
    post:
      tags: [system]
      operationId: system_validate_local_plugin_fixture_post
      summary: "Validate closed metadata only; it never stores or activates a plugin."
      x-source: "app/api/system/plugin_platform_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/plugins/registry":
    post:
      tags: [system]
      operationId: system_register_plugin_fixture_post
      summary: "register plugin fixture"
      x-source: "app/api/system/plugin_platform_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/plugins/{plugin_uid}/{version}/activate":
    post:
      tags: [system]
      operationId: system_activate_plugin_fixture_post
      summary: "activate plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/approvals":
    post:
      tags: [system]
      operationId: system_approve_plugin_fixture_post
      summary: "approve plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/canary":
    post:
      tags: [system]
      operationId: system_canary_plugin_fixture_post
      summary: "canary plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/pause":
    post:
      tags: [system]
      operationId: system_pause_plugin_fixture_post
      summary: "pause plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/recover":
    post:
      tags: [system]
      operationId: system_recover_plugin_fixture_post
      summary: "recover plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/review":
    post:
      tags: [system]
      operationId: system_review_plugin_fixture_post
      summary: "review plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/revoke":
    post:
      tags: [system]
      operationId: system_revoke_plugin_fixture_post
      summary: "revoke plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/plugins/{plugin_uid}/{version}/rollback":
    post:
      tags: [system]
      operationId: system_rollback_plugin_fixture_post
      summary: "rollback plugin fixture"
      x-source: "app/api/system/plugin_platform_routes.py"
      parameters:
        - name: plugin_uid
          in: path
          required: true
          schema:
            type: string
        - name: version
          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/responsibilities/delegations":
    get:
      tags: [system]
      operationId: system_list_responsibility_delegations_get
      summary: "list responsibility delegations"
      x-source: "app/api/system/responsibilities.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_responsibility_delegation_post
      summary: "create responsibility delegation"
      x-source: "app/api/system/responsibilities.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/responsibilities/delegations/expire":
    post:
      tags: [system]
      operationId: system_expire_responsibility_delegations_post
      summary: "expire responsibility delegations"
      x-source: "app/api/system/responsibilities.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/responsibilities/delegations/{delegation_uid}/revoke":
    post:
      tags: [system]
      operationId: system_revoke_responsibility_delegation_post
      summary: "revoke responsibility delegation"
      x-source: "app/api/system/responsibilities.py"
      parameters:
        - name: delegation_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/responsibilities/hierarchy/{resource_type}/{resource_uid}":
    put:
      tags: [system]
      operationId: system_replace_responsibility_parent_put
      summary: "replace responsibility parent"
      x-source: "app/api/system/responsibilities.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/responsibilities/operations":
    get:
      tags: [system]
      operationId: system_responsibility_operations_get
      summary: "responsibility operations"
      x-source: "app/api/system/responsibilities.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/policies":
    get:
      tags: [system]
      operationId: system_list_responsibility_policies_get
      summary: "list responsibility policies"
      x-source: "app/api/system/responsibilities.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_responsibility_policy_post
      summary: "create responsibility policy"
      x-source: "app/api/system/responsibilities.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/responsibilities/policies/{policy_uid}/publish":
    post:
      tags: [system]
      operationId: system_publish_responsibility_policy_post
      summary: "publish responsibility policy"
      x-source: "app/api/system/responsibilities.py"
      parameters:
        - name: policy_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/responsibilities/policies/{policy_uid}/revisions":
    post:
      tags: [system]
      operationId: system_revise_responsibility_policy_post
      summary: "revise responsibility policy"
      x-source: "app/api/system/responsibilities.py"
      parameters:
        - name: policy_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/responsibilities/transfers":
    post:
      tags: [system]
      operationId: system_transfer_departing_responsibility_post
      summary: "transfer departing responsibility"
      x-source: "app/api/system/responsibilities.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/responsibilities/{resource_type}/{resource_uid}":
    get:
      tags: [system]
      operationId: system_get_responsibility_matrix_get
      summary: "get responsibility matrix"
      x-source: "app/api/system/responsibilities.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/responsibilities.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/responsibilities/{resource_type}/{resource_uid}/joint-review/evaluate":
    post:
      tags: [system]
      operationId: system_evaluate_responsibility_joint_review_post
      summary: "evaluate responsibility joint review"
      x-source: "app/api/system/responsibilities.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/responsibilities/{resource_type}/{resource_uid}/resolved":
    get:
      tags: [system]
      operationId: system_resolve_responsibility_get
      summary: "resolve responsibility"
      x-source: "app/api/system/responsibilities.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'
  "/api/system/security-governance/access-decisions":
    get:
      tags: [system]
      operationId: system_security_access_decisions_get
      summary: "security access decisions"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/access-policies":
    get:
      tags: [system]
      operationId: system_security_list_access_policies_get
      summary: "security list access policies"
      x-source: "app/api/system/security_governance.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_security_create_access_policy_post
      summary: "security create access policy"
      x-source: "app/api/system/security_governance.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/security-governance/access/evaluate":
    post:
      tags: [system]
      operationId: system_security_evaluate_access_post
      summary: "security evaluate access"
      x-source: "app/api/system/security_governance.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/security-governance/dashboard":
    get:
      tags: [system]
      operationId: system_security_dashboard_get
      summary: "security dashboard"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/egress":
    get:
      tags: [system]
      operationId: system_security_list_egress_get
      summary: "security list egress"
      x-source: "app/api/system/security_governance.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_security_create_egress_post
      summary: "security create egress"
      x-source: "app/api/system/security_governance.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/security-governance/egress/{request_uid}/reconcile":
    post:
      tags: [system]
      operationId: system_security_reconcile_egress_post
      summary: "security reconcile egress"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: request_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/security-governance/findings":
    get:
      tags: [system]
      operationId: system_security_findings_get
      summary: "security findings"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/findings/{finding_uid}/review":
    post:
      tags: [system]
      operationId: system_security_review_finding_post
      summary: "security review finding"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: finding_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/security-governance/profiles":
    get:
      tags: [system]
      operationId: system_security_list_profiles_get
      summary: "security list profiles"
      x-source: "app/api/system/security_governance.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_security_create_profile_post
      summary: "security create profile"
      x-source: "app/api/system/security_governance.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/security-governance/retention":
    get:
      tags: [system]
      operationId: system_security_list_retention_get
      summary: "security list retention"
      x-source: "app/api/system/security_governance.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_security_create_retention_post
      summary: "security create retention"
      x-source: "app/api/system/security_governance.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/security-governance/retention/candidates":
    get:
      tags: [system]
      operationId: system_security_retention_candidates_get
      summary: "security retention candidates"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/sboms":
    get:
      tags: [system]
      operationId: system_security_list_sboms_get
      summary: "security list sboms"
      x-source: "app/api/system/security_governance.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_security_register_sbom_post
      summary: "security register sbom"
      x-source: "app/api/system/security_governance.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/security-governance/sboms/{sbom_uid}/vulnerabilities":
    post:
      tags: [system]
      operationId: system_security_import_vulnerabilities_post
      summary: "security import vulnerabilities"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: sbom_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/security-governance/scans":
    get:
      tags: [system]
      operationId: system_security_list_scans_get
      summary: "security list scans"
      x-source: "app/api/system/security_governance.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_security_create_scan_post
      summary: "security create scan"
      x-source: "app/api/system/security_governance.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/security-governance/siem/deliveries":
    get:
      tags: [system]
      operationId: system_security_siem_deliveries_get
      summary: "security siem deliveries"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/siem/sinks":
    get:
      tags: [system]
      operationId: system_security_list_siem_sinks_get
      summary: "security list siem sinks"
      x-source: "app/api/system/security_governance.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_security_create_siem_sink_post
      summary: "security create siem sink"
      x-source: "app/api/system/security_governance.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/security-governance/siem/sinks/{sink_uid}/dispatch":
    post:
      tags: [system]
      operationId: system_security_siem_dispatch_post
      summary: "security siem dispatch"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: sink_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/security-governance/vulnerabilities":
    get:
      tags: [system]
      operationId: system_security_vulnerabilities_get
      summary: "security vulnerabilities"
      x-source: "app/api/system/security_governance.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/security-governance/vulnerabilities/{finding_uid}/assign":
    post:
      tags: [system]
      operationId: system_security_assign_vulnerability_post
      summary: "security assign vulnerability"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: finding_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/security-governance/vulnerabilities/{finding_uid}/close":
    post:
      tags: [system]
      operationId: system_security_close_vulnerability_post
      summary: "security close vulnerability"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: finding_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/security-governance/vulnerabilities/{finding_uid}/resolve":
    post:
      tags: [system]
      operationId: system_security_resolve_vulnerability_post
      summary: "security resolve vulnerability"
      x-source: "app/api/system/security_governance.py"
      parameters:
        - name: finding_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/tenant/approvals":
    post:
      tags: [system]
      operationId: system_issue_tenant_lifecycle_approval_post
      summary: "issue tenant lifecycle approval"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [operation, expected_fence, idempotency_key]
              properties:
                operation:
                  type: string
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/audit":
    get:
      tags: [system]
      operationId: system_get_tenant_audit_get
      summary: "get tenant audit"
      x-source: "app/api/system/tenant_routes.py"
      x-required-permission: "identity:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/activate":
    post:
      tags: [system]
      operationId: system_activate_tenant_lifecycle_post
      summary: "activate tenant lifecycle"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/delete":
    post:
      tags: [system]
      operationId: system_delete_tenant_lifecycle_post
      summary: "delete tenant lifecycle"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/deletion-candidate":
    post:
      tags: [system]
      operationId: system_mark_tenant_deletion_candidate_post
      summary: "mark tenant deletion candidate"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/freeze":
    post:
      tags: [system]
      operationId: system_freeze_tenant_lifecycle_post
      summary: "freeze tenant lifecycle"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/recover":
    post:
      tags: [system]
      operationId: system_recover_tenant_lifecycle_post
      summary: "recover tenant lifecycle"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/lifecycle/rollback":
    post:
      tags: [system]
      operationId: system_rollback_tenant_lifecycle_post
      summary: "rollback tenant lifecycle"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [expected_fence, idempotency_key]
              properties:
                expected_fence:
                  type: string
                idempotency_key:
                  type: string
                approval_ref:
                  type: string
                backup_digest:
                  type: string
                retention_seconds:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/manifests":
    get:
      tags: [system]
      operationId: system_get_tenant_manifests_get
      summary: "get tenant manifests"
      x-source: "app/api/system/tenant_routes.py"
      x-required-permission: "identity:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/provisions":
    post:
      tags: [system]
      operationId: system_provision_private_tenant_post
      summary: "provision private tenant"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [idempotency_key]
              properties:
                idempotency_key:
                  type: string
      x-required-permission: "identity:manage"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/quota-claims":
    post:
      tags: [system]
      operationId: system_issue_tenant_quota_claim_post
      summary: "issue tenant quota claim"
      x-source: "app/api/system/tenant_routes.py"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [quota_name, amount, idempotency_key]
              properties:
                quota_name:
                  type: string
                amount:
                  type: string
                  pattern: '^[0-9]+([.][0-9]{1,6})?$'
                idempotency_key:
                  type: string
      x-required-permission: "identity:operate"
      responses:
        "201":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/tenant/status":
    get:
      tags: [system]
      operationId: system_get_tenant_status_get
      summary: "get tenant status"
      x-source: "app/api/system/tenant_routes.py"
      x-required-permission: "identity:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          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/trusted-delivery/controls/capability-approvals":
    post:
      tags: [system]
      operationId: system_trusted_delivery_capability_approval_post
      summary: "trusted delivery capability approval"
      x-source: "app/api/system/trusted_delivery_controls.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/destruction-approvals":
    post:
      tags: [system]
      operationId: system_trusted_delivery_destruction_approval_post
      summary: "trusted delivery destruction approval"
      x-source: "app/api/system/trusted_delivery_controls.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/evidence":
    get:
      tags: [system]
      operationId: system_trusted_delivery_control_evidence_get
      summary: "trusted delivery control evidence"
      x-source: "app/api/system/trusted_delivery_controls.py"
      x-required-permission: "security-governance:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/profiles/activate":
    post:
      tags: [system]
      operationId: system_trusted_delivery_activate_control_profile_post
      summary: "trusted delivery activate control profile"
      x-source: "app/api/system/trusted_delivery_controls.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/profiles/rollback":
    post:
      tags: [system]
      operationId: system_trusted_delivery_rollback_control_profile_post
      summary: "trusted delivery rollback control profile"
      x-source: "app/api/system/trusted_delivery_controls.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/profiles/{profile_id}/active":
    get:
      tags: [system]
      operationId: system_trusted_delivery_active_control_profile_get
      summary: "trusted delivery active control profile"
      x-source: "app/api/system/trusted_delivery_controls.py"
      parameters:
        - name: profile_id
          in: path
          required: true
          schema:
            type: string
      x-required-permission: "security-governance:read"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/controls/release-gates/evaluate":
    post:
      tags: [system]
      operationId: system_trusted_delivery_release_gate_post
      summary: "trusted delivery release gate"
      x-source: "app/api/system/trusted_delivery_controls.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/decisions":
    post:
      tags: [system]
      operationId: system_evaluate_trusted_delivery_post
      summary: "evaluate trusted delivery"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/legal-holds":
    post:
      tags: [system]
      operationId: system_create_trusted_delivery_hold_post
      summary: "create trusted delivery hold"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/legal-holds/release":
    post:
      tags: [system]
      operationId: system_release_trusted_delivery_hold_post
      summary: "release trusted delivery hold"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/policy-versions":
    post:
      tags: [system]
      operationId: system_create_trusted_delivery_policy_post
      summary: "create trusted delivery policy"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/policy-versions/activate":
    post:
      tags: [system]
      operationId: system_activate_trusted_delivery_policy_post
      summary: "activate trusted delivery policy"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/policy-versions/rollback":
    post:
      tags: [system]
      operationId: system_rollback_trusted_delivery_policy_post
      summary: "rollback trusted delivery policy"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/provisions":
    post:
      tags: [system]
      operationId: system_provision_trusted_delivery_post
      summary: "provision trusted delivery"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/reclaim/execute":
    post:
      tags: [system]
      operationId: system_trusted_delivery_reclaim_execute_post
      summary: "trusted delivery reclaim execute"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/reclaim/preview":
    post:
      tags: [system]
      operationId: system_trusted_delivery_reclaim_preview_post
      summary: "trusted delivery reclaim preview"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions":
    post:
      tags: [system]
      operationId: system_create_trusted_delivery_subscription_post
      summary: "create trusted delivery subscription"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/anomalies":
    post:
      tags: [system]
      operationId: system_report_trusted_delivery_subscription_anomaly_post
      summary: "report trusted delivery subscription anomaly"
      x-source: "app/api/system/trusted_delivery.py"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/deliveries/{delivery_uid}/compensate":
    post:
      tags: [system]
      operationId: system_compensate_trusted_delivery_subscription_delivery_post
      summary: "compensate trusted delivery subscription delivery"
      x-source: "app/api/system/trusted_delivery.py"
      parameters:
        - name: delivery_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:manage"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/{subscription_uid}/activate":
    post:
      tags: [system]
      operationId: system_activate_trusted_delivery_subscription_post
      summary: "activate trusted delivery subscription"
      x-source: "app/api/system/trusted_delivery.py"
      parameters:
        - name: subscription_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/{subscription_uid}/pause":
    post:
      tags: [system]
      operationId: system_pause_trusted_delivery_subscription_post
      summary: "pause trusted delivery subscription"
      x-source: "app/api/system/trusted_delivery.py"
      parameters:
        - name: subscription_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/{subscription_uid}/resume":
    post:
      tags: [system]
      operationId: system_resume_trusted_delivery_subscription_post
      summary: "resume trusted delivery subscription"
      x-source: "app/api/system/trusted_delivery.py"
      parameters:
        - name: subscription_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/trusted-delivery/subscriptions/{subscription_uid}/terminate":
    post:
      tags: [system]
      operationId: system_terminate_trusted_delivery_subscription_post
      summary: "terminate trusted delivery subscription"
      x-source: "app/api/system/trusted_delivery.py"
      parameters:
        - name: subscription_uid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      x-required-permission: "security-governance:operate"
      responses:
        "200":
          description: "请求已由当前实现处理"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          headers:
            Cache-Control:
              required: true
              schema: {type: string, const: no-store}
          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/users.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/users.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/users.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/users.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/work-center/dashboard":
    get:
      tags: [system]
      operationId: system_get_work_center_dashboard_get
      summary: "get work center dashboard"
      x-source: "app/api/system/work_center.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/work-center/notifications":
    get:
      tags: [system]
      operationId: system_list_work_center_notifications_get
      summary: "list work center notifications"
      x-source: "app/api/system/work_center.py"
      responses:
        "200":
          description: "请求已由当前实现处理"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
        default:
          description: "错误响应"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEnvelope'
  "/api/system/work-center/notifications/deliver":
    post:
      tags: [system]
      operationId: system_deliver_work_center_notifications_post
      summary: "deliver work center notifications"
      x-source: "app/api/system/work_center.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/work-center/notifications/{notification_uid}/read":
    post:
      tags: [system]
      operationId: system_read_work_center_notification_post
      summary: "read work center notification"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: notification_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/work-center/preferences":
    get:
      tags: [system]
      operationId: system_get_work_center_preferences_get
      summary: "get work center preferences"
      x-source: "app/api/system/work_center.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_replace_work_center_preferences_put
      summary: "replace work center preferences"
      x-source: "app/api/system/work_center.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/work-center/tasks":
    get:
      tags: [system]
      operationId: system_list_work_center_tasks_get
      summary: "list work center tasks"
      x-source: "app/api/system/work_center.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_work_center_task_post
      summary: "create work center task"
      x-source: "app/api/system/work_center.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/work-center/tasks/{task_uid}":
    get:
      tags: [system]
      operationId: system_get_work_center_task_get
      summary: "get work center task"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: task_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/system/work-center/tasks/{task_uid}/attachments":
    post:
      tags: [system]
      operationId: system_add_work_center_attachment_post
      summary: "add work center attachment"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: task_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/work-center/tasks/{task_uid}/comments":
    post:
      tags: [system]
      operationId: system_add_work_center_comment_post
      summary: "add work center comment"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: task_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/work-center/tasks/{task_uid}/{action}":
    post:
      tags: [system]
      operationId: system_operate_work_center_task_post
      summary: "operate work center task"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: task_uid
          in: path
          required: true
          schema:
            type: string
        - name: action
          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/work-center/templates":
    get:
      tags: [system]
      operationId: system_list_work_center_templates_get
      summary: "list work center templates"
      x-source: "app/api/system/work_center.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_work_center_template_post
      summary: "create work center template"
      x-source: "app/api/system/work_center.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/work-center/templates/{template_uid}":
    patch:
      tags: [system]
      operationId: system_revise_work_center_template_patch
      summary: "revise work center template"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: template_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/work-center/timeouts/process":
    post:
      tags: [system]
      operationId: system_process_work_center_timeouts_post
      summary: "process work center timeouts"
      x-source: "app/api/system/work_center.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/work-center/workflows":
    get:
      tags: [system]
      operationId: system_list_work_center_workflows_get
      summary: "list work center workflows"
      x-source: "app/api/system/work_center.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_work_center_workflow_post
      summary: "create work center workflow"
      x-source: "app/api/system/work_center.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/work-center/workflows/{workflow_uid}/publish":
    post:
      tags: [system]
      operationId: system_publish_work_center_workflow_post
      summary: "publish work center workflow"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: workflow_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/work-center/workflows/{workflow_uid}/revisions":
    post:
      tags: [system]
      operationId: system_revise_work_center_workflow_post
      summary: "revise work center workflow"
      x-source: "app/api/system/work_center.py"
      parameters:
        - name: workflow_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/workbench/layout":
    get:
      tags: [system]
      operationId: system_get_workbench_layout_get
      summary: "get workbench layout"
      x-source: "app/api/system/workbench.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/workbench.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/workbench.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
      required: [code, message, data]
      properties:
        code:
          type: integer
        message:
          type: string
        data: {}
        error: {type: object}
    EdgeApiEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object}}
    ProductionDeliveryRequest:
      type: object
      additionalProperties: false
      required: [incident_uid, alert_uid, channel, summary]
      properties: {incident_uid: {type: string, format: uuid}, alert_uid: {type: string, format: uuid}, channel: {type: string, enum: [monitoring, smtp, enterprise_collaboration, on_call, itsm]}, summary: {type: string, minLength: 1, maxLength: 160}}
    ProductionDeliveryRecord:
      type: object
      additionalProperties: false
      required: [uid, incident_uid, alert_uid, channel, status, attempt_count, lease_fence]
      properties: {uid: {type: string, format: uuid}, incident_uid: {type: string, format: uuid}, alert_uid: {type: string, format: uuid}, channel: {type: string, enum: [monitoring, smtp, enterprise_collaboration, on_call, itsm]}, status: {type: string, enum: [pending, processing, delivered, dead_letter, compensated]}, attempt_count: {type: integer, minimum: 0, maximum: 3}, lease_fence: {type: integer, minimum: 0}, next_attempt_at: {type: string, format: date-time}, lease_owner: {type: [string, 'null'], maxLength: 80}, lease_expires_at: {type: [string, 'null'], format: date-time}, last_reason_code: {type: [string, 'null'], maxLength: 64}, compensation_reason_code: {type: [string, 'null'], maxLength: 64}, compensation_receipt_code: {type: [string, 'null'], maxLength: 64}, idempotency_key: {type: string, maxLength: 200}, payload_digest: {type: string, pattern: '^[a-f0-9]{64}$'}, created_at: {type: string, format: date-time}, updated_at: {type: string, format: date-time}}
    ProductionDeliveryEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {const: 200}, message: {type: string}, data: {$ref: '#/components/schemas/ProductionDeliveryRecord'}}
    EdgeErrorEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data, error]
      properties: {code: {type: integer}, message: {type: string}, data: {type: 'null'}, error: {type: object, additionalProperties: false, required: [code], properties: {code: {type: string, maxLength: 80}}}}
    EdgeMachineBinding:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation]
      properties: {environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, generation: {type: integer, minimum: 1}}
    EdgeEnrollmentRequest:
      type: object
      additionalProperties: false
      required: [gateway_name, environment, network_zone, policy_digest, allowed_control_hosts, allowed_proxy_hosts, expected_certificate_sha256]
      properties: {gateway_name: {type: string, minLength: 1, maxLength: 200}, environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, policy_digest: {$ref: '#/components/schemas/Sha256Digest'}, allowed_control_hosts: {$ref: '#/components/schemas/EdgeExactHosts'}, allowed_proxy_hosts: {$ref: '#/components/schemas/EdgeExactHosts'}, expected_certificate_sha256: {$ref: '#/components/schemas/Sha256Digest'}, ttl_seconds: {type: integer, minimum: 60, maximum: 86400}}
    EdgeRegisterRequest:
      type: object
      additionalProperties: false
      required: [gateway_id, environment, network_zone, policy_digest, allowed_control_hosts, allowed_proxy_hosts, version]
      properties: {gateway_id: {type: string, format: uuid}, environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, policy_digest: {$ref: '#/components/schemas/Sha256Digest'}, allowed_control_hosts: {$ref: '#/components/schemas/EdgeExactHosts'}, allowed_proxy_hosts: {$ref: '#/components/schemas/EdgeExactHosts'}, version: {$ref: '#/components/schemas/EdgeAgentVersion'}}
    EdgeHeartbeatRequest:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation, version, safe_summary]
      properties: {environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, generation: {type: integer, minimum: 1}, version: {$ref: '#/components/schemas/EdgeAgentVersion'}, safe_summary: {$ref: '#/components/schemas/EdgeSafeSummary'}}
    EdgeRotateRequest:
      type: object
      additionalProperties: false
      required: [certificate_sha256, request_id]
      properties: {certificate_sha256: {$ref: '#/components/schemas/Sha256Digest'}, request_id: {type: string, minLength: 1, maxLength: 255}}
    Sha256Digest: {type: string, pattern: '^[a-f0-9]{64}$'}
    Ed25519Signature: {type: string, pattern: '^[a-f0-9]{128}$'}
    EdgeExactHosts: {type: array, maxItems: 32, uniqueItems: true, items: {type: string, pattern: '^[a-z0-9][a-z0-9.-]*[a-z0-9]$'}}
    EdgeSafeSummary:
      type: object
      x-max-policy-depth: 12
      maxProperties: 64
      propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}
      additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue12'}
      description: 'Policy-approved bounded metadata/statistics/health/diagnostic fields only; raw rows, SQL, credentials, and local paths are forbidden.'
    EdgeSafeScalar:
      anyOf:
        - {type: string, maxLength: 4096}
        - {type: integer, minimum: -9007199254740991, maximum: 9007199254740991}
        - {type: number, minimum: -1000000000000, maximum: 1000000000000}
        - {type: boolean}
        - {type: 'null'}
    EdgeSafeValue0: {$ref: '#/components/schemas/EdgeSafeScalar'}
    EdgeSafeValue1:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue0'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue0'}}
    EdgeSafeValue2:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue1'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue1'}}
    EdgeSafeValue3:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue2'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue2'}}
    EdgeSafeValue4:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue3'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue3'}}
    EdgeSafeValue5:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue4'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue4'}}
    EdgeSafeValue6:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue5'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue5'}}
    EdgeSafeValue7:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue6'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue6'}}
    EdgeSafeValue8:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue7'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue7'}}
    EdgeSafeValue9:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue8'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue8'}}
    EdgeSafeValue10:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue9'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue9'}}
    EdgeSafeValue11:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue10'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue10'}}
    EdgeSafeValue12:
      anyOf:
        - {$ref: '#/components/schemas/EdgeSafeScalar'}
        - {type: array, maxItems: 100, items: {$ref: '#/components/schemas/EdgeSafeValue11'}}
        - {type: object, maxProperties: 32, propertyNames: {type: string, minLength: 1, maxLength: 80, pattern: '^(?!.*(?:raw|rows?|sql|credential|secret|private|password|token|local_path))[a-z][a-z0-9_]{0,79}$'}, additionalProperties: {$ref: '#/components/schemas/EdgeSafeValue11'}}
    EdgeSafeValue: {$ref: '#/components/schemas/EdgeSafeValue12'}
    EdgeIdentifier: {type: string, minLength: 1, maxLength: 255, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,254}$'}
    EdgeCursor: {type: [string, 'null'], minLength: 1, maxLength: 255, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,254}$'}
    EdgeAgentVersion: {type: string, minLength: 1, maxLength: 80, pattern: '^[A-Za-z0-9][A-Za-z0-9._+-]{0,79}$'}
    EdgeVersion: {type: string, pattern: '^(0|[1-9][0-9]{0,9})\.(0|[1-9][0-9]{0,9})\.(0|[1-9][0-9]{0,9})$'}
    EdgeTaskContract:
      type: object
      additionalProperties: false
      required: [task_id, gateway_id, environment, network_zone, purpose, classification, task_type, contract_version, deadline_at, attempt, idempotency_key, policy_digest]
      properties: {task_id: {$ref: '#/components/schemas/EdgeIdentifier'}, gateway_id: {type: string, format: uuid}, environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, purpose: {type: string, minLength: 1, maxLength: 255}, classification: {type: string, enum: [raw, recent_detail, restricted, desensitized_metadata, statistics, lineage, evidence]}, task_type: {type: string, enum: [collect, profile, quality, lineage, controlled_query]}, contract_version: {const: 1}, deadline_at: {type: string, format: date-time}, attempt: {type: integer, minimum: 1, maximum: 5}, idempotency_key: {$ref: '#/components/schemas/EdgeIdentifier'}, policy_digest: {$ref: '#/components/schemas/Sha256Digest'}}
    EdgeSignedTaskEnvelope:
      type: object
      additionalProperties: false
      required: [task, authority_key_id, signature_algorithm, contract_digest, gateway_id, environment, network_zone, policy_digest, purpose, issued_at, expires_at, signature]
      properties: {task: {$ref: '#/components/schemas/EdgeTaskContract'}, authority_key_id: {type: string}, signature_algorithm: {const: Ed25519}, contract_digest: {$ref: '#/components/schemas/Sha256Digest'}, gateway_id: {type: string}, environment: {type: string}, network_zone: {type: string}, policy_digest: {$ref: '#/components/schemas/Sha256Digest'}, purpose: {type: string}, issued_at: {type: string, format: date-time}, expires_at: {type: string, format: date-time}, signature: {$ref: '#/components/schemas/Ed25519Signature'}}
    EdgeEventContract:
      type: object
      additionalProperties: false
      required: [event_id, task_id, gateway_id, environment, network_zone, purpose, classification, contract_version, occurred_at, attempt, idempotency_key, policy_digest, payload]
      properties: {event_id: {type: string}, task_id: {type: string}, gateway_id: {type: string}, environment: {type: string}, network_zone: {type: string}, purpose: {type: string}, classification: {type: string, enum: [desensitized_metadata, statistics, lineage, evidence, health_summary, diagnostic_summary]}, contract_version: {const: 1}, occurred_at: {type: string, format: date-time}, attempt: {type: integer, minimum: 1, maximum: 5}, idempotency_key: {type: string}, policy_digest: {$ref: '#/components/schemas/Sha256Digest'}, payload: {$ref: '#/components/schemas/EdgeSafeSummary'}}
    EdgeEventRequest:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation, event, lease_token]
      properties: {environment: {type: string}, network_zone: {type: string}, generation: {type: integer, minimum: 1}, event: {$ref: '#/components/schemas/EdgeEventContract'}, lease_token: {type: string, writeOnly: true}}
    EdgeTaskOutcomeRequest:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation, outcome, lease_token, safe_summary]
      properties: {environment: {type: string}, network_zone: {type: string}, generation: {type: integer, minimum: 1}, outcome: {type: string, enum: [completed, failed, cancelled]}, lease_token: {type: string, writeOnly: true}, safe_summary: {$ref: '#/components/schemas/EdgeSafeSummary'}}
    EdgeReconcileRequest:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation]
      properties: {environment: {type: string, enum: [development, staging, production]}, network_zone: {type: string, minLength: 1, maxLength: 120}, generation: {type: integer, minimum: 1}, limit: {type: integer, minimum: 1, maximum: 100}, cancel_cursor: {$ref: '#/components/schemas/EdgeCursor'}, release_cursor: {$ref: '#/components/schemas/EdgeCursor'}}
    EdgeReconcileResponse:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string, maxLength: 200}, data: {type: object, additionalProperties: false, required: [cancelled_task_ids, cancel_next_cursor, release_offers, release_next_cursor, release_baseline], properties: {cancelled_task_ids: {type: array, maxItems: 50, items: {$ref: '#/components/schemas/EdgeIdentifier'}}, cancel_next_cursor: {$ref: '#/components/schemas/EdgeCursor'}, release_offers: {type: array, maxItems: 50, items: {$ref: '#/components/schemas/EdgeReleaseManifest'}}, release_next_cursor: {$ref: '#/components/schemas/EdgeCursor'}, release_baseline: {oneOf: [{$ref: '#/components/schemas/EdgeReleaseManifest'}, {type: 'null'}]}}}}
    EdgeReleaseOfferRequest:
      type: object
      additionalProperties: false
      required: [version, artifact_digest, artifact_name, deadline_at, rollback_version, request_id]
      properties: {version: {$ref: '#/components/schemas/EdgeVersion'}, artifact_digest: {$ref: '#/components/schemas/Sha256Digest'}, artifact_name: {type: string, minLength: 1, maxLength: 255, pattern: '^[^/\\]+$'}, deadline_at: {type: string, format: date-time}, rollback_version: {$ref: '#/components/schemas/EdgeVersion'}, request_id: {$ref: '#/components/schemas/EdgeIdentifier'}}
    EdgeReleaseAckRequest:
      type: object
      additionalProperties: false
      required: [environment, network_zone, generation, release_id, outcome, safe_summary]
      properties: {environment: {type: string}, network_zone: {type: string}, generation: {type: integer, minimum: 1}, release_id: {type: string, format: uuid}, outcome: {type: string, enum: [accepted, installed, failed, rollback]}, safe_summary: {$ref: '#/components/schemas/EdgeSafeSummary'}}
    EdgeReleaseManifest:
      type: object
      additionalProperties: false
      required: [release_id, version, rollback_version, artifact_digest, artifact_name, deadline_at, status, signature_algorithm, key_id, manifest_digest, signature]
      properties: {release_id: {$ref: '#/components/schemas/EdgeIdentifier'}, version: {$ref: '#/components/schemas/EdgeVersion'}, rollback_version: {$ref: '#/components/schemas/EdgeVersion'}, artifact_digest: {$ref: '#/components/schemas/Sha256Digest'}, artifact_name: {type: string, minLength: 1, maxLength: 255, pattern: '^[^/\\]+$'}, deadline_at: {type: string, format: date-time}, status: {type: string, enum: [offered, accepted, failed, installed, rolled_back]}, signature_algorithm: {const: Ed25519}, key_id: {$ref: '#/components/schemas/EdgeIdentifier'}, manifest_digest: {$ref: '#/components/schemas/Sha256Digest'}, signature: {$ref: '#/components/schemas/Ed25519Signature'}}
    EdgeEnrollmentEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [enrollment_id, gateway_id, enrollment_token, expires_in, returned_once], properties: {enrollment_id: {type: string, format: uuid}, gateway_id: {type: string, format: uuid}, enrollment_token: {type: string, writeOnly: true}, expires_in: {type: integer}, returned_once: {const: true}}}}
    EdgeRegistrationEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [gateway_id, generation, certificate_sha256, credential, credential_returned_once], properties: {gateway_id: {type: string, format: uuid}, generation: {type: integer}, certificate_sha256: {$ref: '#/components/schemas/Sha256Digest'}, credential: {type: string, writeOnly: true}, credential_returned_once: {const: true}}}}
    EdgeGatewayListEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [gateways], properties: {gateways: {type: array, maxItems: 100, items: {type: object, description: 'Bounded gateway metadata; credential/token/private key are never included.'}}}}}
    EdgeTaskPullEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {oneOf: [{type: object, additionalProperties: false, required: [task], properties: {task: {type: 'null'}}}, {type: object, additionalProperties: false, required: [task, signed_task_envelope, lease_token, lease_expires_at], properties: {task: {$ref: '#/components/schemas/EdgeTaskContract'}, signed_task_envelope: {$ref: '#/components/schemas/EdgeSignedTaskEnvelope'}, lease_token: {type: string, writeOnly: true}, lease_expires_at: {type: string, format: date-time}}}]}}
    EdgeEventAckEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [event_id, event_digest, remote_lease_digest, received_at, status], properties: {event_id: {type: string}, event_digest: {$ref: '#/components/schemas/Sha256Digest'}, remote_lease_digest: {$ref: '#/components/schemas/Sha256Digest'}, received_at: {type: string, format: date-time}, status: {const: accepted}}}}
    EdgeReleaseEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string, maxLength: 200}, data: {type: object, additionalProperties: false, required: [release_id, status, version, artifact_digest, rollback_version, manifest], properties: {release_id: {type: string, format: uuid}, status: {type: string, enum: [offered, accepted, failed, installed, rolled_back]}, version: {$ref: '#/components/schemas/EdgeVersion'}, artifact_digest: {$ref: '#/components/schemas/Sha256Digest'}, rollback_version: {$ref: '#/components/schemas/EdgeVersion'}, manifest: {$ref: '#/components/schemas/EdgeReleaseManifest'}}}}
    ConnectorConfigValidationRequest:
      type: object
      additionalProperties: false
      required: [connector_id, version, config]
      properties:
        connector_id: {type: string, minLength: 3, maxLength: 64}
        version: {type: string, pattern: '^[0-9]+\.[0-9]+\.[0-9]+'}
        config: {type: object}
    ConnectorRunRequest:
      type: object
      additionalProperties: false
      required: [connector_id, version, source_uid, operation, config, scope, dry_run]
      properties:
        connector_id: {type: string}
        version: {type: string}
        source_uid: {type: string, format: uuid}
        operation: {type: string, enum: [discover, snapshot, incremental, lineage, profile, evidence]}
        config: {type: object}
        scope: {$ref: '#/components/schemas/ConnectorScope'}
        cursor: {type: object}
        checkpoint: {type: object}
        idempotency_key: {type: string, pattern: '^[a-f0-9]{64}$'}
        dry_run: {const: true}
        process_key: {type: string, minLength: 1, maxLength: 300}
    MachineConnectorRunRequest:
      type: object
      additionalProperties: false
      required: [connector_id, version, source_uid, business_domain_uid, environment, process_key, operation, scope]
      properties:
        connector_id: {type: string}
        version: {type: string}
        source_uid: {type: string, format: uuid}
        business_domain_uid: {type: string, format: uuid}
        environment: {type: string, enum: [development, staging, production]}
        process_key: {type: string, minLength: 1, maxLength: 300}
        operation: {type: string, enum: [discover, snapshot, incremental, lineage, profile, evidence]}
        scope: {$ref: '#/components/schemas/ConnectorScope'}
        cursor: {type: object}
        checkpoint: {type: object}
        idempotency_key: {type: string, pattern: '^[a-f0-9]{64}$'}
        dry_run: {type: boolean, default: false}
    ConnectorPrincipalRequest:
      type: object
      additionalProperties: false
      required: [connector_id, version, source_uid, business_domain_uid, environment, operations, scopes]
      properties:
        connector_id: {type: string}
        version: {type: string}
        source_uid: {type: string, format: uuid}
        business_domain_uid: {type: string, format: uuid}
        environment: {type: string, enum: [development, staging, production]}
        operations: {type: array, minItems: 1, uniqueItems: true, items: {type: string}}
        scopes: {$ref: '#/components/schemas/ConnectorScope'}
        source_binding_uid: {type: string, format: uuid}
        source_binding_version: {type: integer, minimum: 1}
    ConnectorSourceBindingRequest:
      type: object
      additionalProperties: false
      required: [connector_id, version, source_uid, business_domain_uid, environment, approved_config]
      properties:
        binding_uid: {type: string, format: uuid}
        connector_id: {type: string}
        version: {type: string}
        source_uid: {type: string, format: uuid}
        business_domain_uid: {type: string, format: uuid}
        environment: {type: string, enum: [development, staging, production]}
        approved_config: {type: object}
    ConnectorScope:
      type: object
      additionalProperties: false
      properties:
        include_schemas: {type: array, uniqueItems: true, items: {type: string, minLength: 1}}
        exclude_schemas: {type: array, uniqueItems: true, items: {type: string, minLength: 1}}
        include_tables: {type: array, uniqueItems: true, items: {type: string, minLength: 1}}
        exclude_tables: {type: array, uniqueItems: true, items: {type: string, minLength: 1}}
    ConnectorHealthRequest:
      type: object
      additionalProperties: false
      required: [config]
      properties: {config: {type: object}}
    ConnectorCredentialRequest:
      type: object
      additionalProperties: false
      properties: {ttl_seconds: {type: integer, minimum: 60, maximum: 900}}
    ConnectorGraphRequest:
      type: object
      additionalProperties: false
      properties: {source_uid: {type: string, format: uuid}, business_domain_uid: {type: string, format: uuid}, process_key: {type: string}, run_uid: {type: string, format: uuid}, limit: {type: integer, minimum: 1, maximum: 1000}}
    ConnectorManifestEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties:
        code: {type: integer}
        message: {type: string}
        data: {type: object, additionalProperties: false, required: [manifests], properties: {manifests: {type: array, items: {$ref: '#/components/schemas/ConnectorManifest'}}}}
    ConnectorManifest:
      type: object
      additionalProperties: false
      required: [connector_id, version, sdk_version, display_name, capabilities, config_schema]
      properties: {connector_id: {type: string}, version: {type: string}, sdk_version: {type: string}, display_name: {type: string}, capabilities: {type: array, items: {type: string}}, config_schema: {type: object}}
    ConnectorOperationResult:
      type: object
      additionalProperties: false
      required: [records, cursor, checkpoint, evidence, status]
      properties: {records: {type: array, items: {type: object}}, cursor: {type: object}, checkpoint: {type: object}, evidence: {type: object}, status: {type: string, enum: [succeeded, dry_run]}}
    ConnectorRunResultEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {$ref: '#/components/schemas/ConnectorOperationResult'}}
    ConnectorRunRecord:
      type: object
      additionalProperties: false
      required: [uid, idempotency_key, connector_id, connector_version, source_uid, operation, status, attempt_count, checkpoint_summary, cursor_summary, dry_run]
      properties: {uid: {type: string, format: uuid}, idempotency_key: {type: string}, connector_id: {type: string}, connector_version: {type: string}, source_uid: {type: string, format: uuid}, principal_uid: {type: [string, 'null'], format: uuid}, business_domain_uid: {type: [string, 'null'], format: uuid}, environment: {type: [string, 'null']}, process_key: {type: [string, 'null']}, operation: {type: string}, status: {type: string}, attempt_count: {type: integer}, checkpoint_summary: {type: object}, cursor_summary: {type: object}, scope: {type: object}, error_category: {type: [string, 'null']}, dry_run: {type: boolean}, created_at: {type: string}, updated_at: {type: string}}
    ConnectorRunRecordEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {$ref: '#/components/schemas/ConnectorRunRecord'}}
    ConnectorRunListEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [runs], properties: {runs: {type: array, items: {$ref: '#/components/schemas/ConnectorRunRecord'}}}}}
    ConnectorValidationEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, required: [valid, config_keys], properties: {valid: {const: true}, config_keys: {type: array, items: {type: string}}}, additionalProperties: false}}
    ConnectorErrorEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data, error]
      properties:
        code: {type: integer}
        message: {type: string}
        data: {type: 'null'}
        error: {type: object, additionalProperties: false, required: [code, category, retryable], properties: {code: {const: CONNECTOR_ERROR}, category: {type: string, enum: [configuration, conflict, authentication, permission, rate_limit, timeout, upstream, contract, cancelled]}, retryable: {type: boolean}}}
    ConnectorHealthEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [status, detail], properties: {status: {type: string}, detail: {type: string}}}}
    ConnectorCompatibilityEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [compatible, connector_version, sdk_version, detail], properties: {compatible: {type: boolean}, connector_version: {type: string}, sdk_version: {type: string}, detail: {type: string}}}}
    ConnectorPrincipalEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [principal_uid], properties: {principal_uid: {type: string, format: uuid}}}}
    ConnectorSourceBindingEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [binding_uid, binding_version, status, rebound_principals], properties: {binding_uid: {type: string, format: uuid}, binding_version: {type: integer, minimum: 1}, status: {const: approved}, rebound_principals: {type: integer, minimum: 0}}}}
    ConnectorCredentialEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {oneOf: [{type: object, additionalProperties: false, required: [credential_uid, credential, expires_in, returned_once], properties: {credential_uid: {type: string, format: uuid}, credential: {type: string, writeOnly: true}, expires_in: {type: integer}, returned_once: {const: true}}}, {type: object, additionalProperties: false, required: [revoked], properties: {revoked: {type: boolean}}}]}}
    ConnectorGraphEnvelope:
      type: object
      additionalProperties: false
      required: [code, message, data]
      properties: {code: {type: integer}, message: {type: string}, data: {type: object, additionalProperties: false, required: [nodes, edges, summary], properties: {nodes: {type: array, items: {type: object, additionalProperties: false, required: [type, key], properties: {type: {type: string, enum: [source, asset, process, business_domain, run]}, key: {type: string}}}}, edges: {type: array, items: {type: object}}, summary: {type: object, additionalProperties: false, required: [node_count, edge_count], properties: {node_count: {type: integer}, edge_count: {type: integer}}}}}}
  securitySchemes:
    mutualTLS:
      type: mutualTLS
    edgeCredential:
      type: apiKey
      in: header
      name: X-Edge-Credential
      description: "One-time-returned edge credential; always combined with mutualTLS certificate proof."
    edgeEnrollment:
      type: apiKey
      in: header
      name: X-Edge-Enrollment
      description: "Single-use enrollment token; always combined with mutualTLS certificate proof."
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: "下一阶段统一认证方案；当前路由尚未全部接入。"