{
  "openapi": "3.0.3",
  "info": {
    "title": "SmartPool品牌与授权候选OpenAPI",
    "version": "0.5-candidate",
    "description": "SP-REQUIREMENTS-20261007-DRAFT-v0.3；独立候选修复，TECH/原独立复核未签收，不可开工。纯文件，无DDL/真实HTTP/GUI/Library上传。\n\n全部接口为候选，未部署；用户入口与机器内部端点按操作区分。"
  },
  "paths": {
    "/candidate/v0.5/platform/brand/query": {
      "post": {
        "operationId": "brand.query",
        "summary": "品牌授权列表与类型筛选",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR01",
          "BR08"
        ],
        "x-permission": "platform.read",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        }
      }
    },
    "/candidate/v0.5/platform/brand/detail": {
      "post": {
        "operationId": "brand.detail",
        "summary": "精确品牌详情",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR01",
          "BR02",
          "BR08"
        ],
        "x-permission": "platform.read",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_detailInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_detailResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        }
      }
    },
    "/candidate/v0.5/platform/brand/create": {
      "post": {
        "operationId": "brand.create",
        "summary": "系统生成品牌，默认active",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR01",
          "BR03",
          "BR08"
        ],
        "x-permission": "brand.organization",
        "x-error-codes": [
          "NAME_CONFLICT",
          "INVALID_FILE"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_createInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_createResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        }
      }
    },
    "/candidate/v0.5/platform/brand/update": {
      "post": {
        "operationId": "brand.update",
        "summary": "品牌资料更新，禁止type/ID字段",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR01",
          "BR03",
          "BR08"
        ],
        "x-permission": "brand.organization",
        "x-error-codes": [
          "NAME_CONFLICT",
          "IMMUTABLE_DEPLOYMENT_TYPE"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_updateInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_updateResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        }
      }
    },
    "/candidate/v0.5/platform/brand/lifecycle": {
      "post": {
        "operationId": "brand.lifecycle",
        "summary": "关闭/开启/删除；提交复检全closed/全历史",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR01",
          "BR09"
        ],
        "x-permission": "brand.organization",
        "x-error-codes": [
          "STORE_NOT_CLOSED",
          "HISTORY_PROTECTION"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_lifecycleInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_lifecycleResponse"
                }
              }
            }
          },
          "202": {
            "description": "仅跨服务候选pending操作；不展示业务完成，不授角色/不开始许可",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_lifecycleResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingWriteError"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        }
      }
    },
    "/candidate/v0.5/platform/enterprise/query": {
      "post": {
        "operationId": "enterprise.query",
        "summary": "企业完整度列表与各品牌管理员；不返回证件敏感正文",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR03",
          "BR04"
        ],
        "x-permission": "enterprise.read",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/enterprise_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/enterprise/detail": {
      "post": {
        "operationId": "enterprise.detail",
        "summary": "企业详情及缺档状态",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR03",
          "BR04"
        ],
        "x-permission": "enterprise.read",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/enterprise_detailInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_detailResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "profile.legalIdNumber": "独立证件敏感读取权；无权只掩码，不返回原值",
          "profile.contactPhone": "企业档案读取权、脱敏默认",
          "preset": "预设读权",
          "brandAdministrators": "相应brand关系读权"
        }
      }
    },
    "/candidate/v0.5/platform/enterprise/create": {
      "post": {
        "operationId": "enterprise.create",
        "summary": "企业档案/预设，创建第三步必填；可选关联不覆盖管理员",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR03",
          "BR04",
          "BR06",
          "BR07"
        ],
        "x-permission": "enterprise.profile.write",
        "x-error-codes": [
          "CREDIT_CODE_CONFLICT",
          "PROOF_INVALID",
          "EXISTING_BRAND_ADMIN"
        ],
        "x-write": true,
        "description": "平台用户业务命令→持久协调者操作。新账号/档案/关系均先准备未生效；published才可读新业务版本；未知503必须携原operationId或可按同key resolve，不得新建账号/员工。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/enterprise_createInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_createResponse"
                }
              }
            }
          },
          "202": {
            "description": "operation已持久化但业务未完成；按operationId/key查原结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_createResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingWriteError"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-conditional-validation": [
          "create expectedRevision=0且第三步preset必需；save只允许enterprisePreset或明确brandAdmin一个意图，不能混用",
          "brandId存在时必须expectedBrandRevision与当前读写/link范围",
          "法人proof与管理员proof用途、对象、input版本独立，四事实proof通过且在营",
          "create+brandAdmin不得覆盖已有brandadmin；未选adopt不授brand权",
          "原子业务完成结果或零生效写，pending非成功"
        ],
        "x-result-owner": "platform-coordinator"
      }
    },
    "/candidate/v0.5/platform/enterprise/save": {
      "post": {
        "operationId": "enterprise.save",
        "summary": "企业档案/预设，创建第三步必填；可选关联不覆盖管理员",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR03",
          "BR04",
          "BR06",
          "BR07"
        ],
        "x-permission": "enterprise.profile.write",
        "x-error-codes": [
          "CREDIT_CODE_CONFLICT",
          "PROOF_INVALID",
          "EXISTING_BRAND_ADMIN"
        ],
        "x-write": true,
        "description": "平台用户业务命令→持久协调者操作。新账号/档案/关系均先准备未生效；published才可读新业务版本；未知503必须携原operationId或可按同key resolve，不得新建账号/员工。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/enterprise_saveInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_saveResponse"
                }
              }
            }
          },
          "202": {
            "description": "operation已持久化但业务未完成；按operationId/key查原结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_saveResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingWriteError"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-conditional-validation": [
          "create expectedRevision=0且第三步preset必需；save只允许enterprisePreset或明确brandAdmin一个意图，不能混用",
          "brandId存在时必须expectedBrandRevision与当前读写/link范围",
          "法人proof与管理员proof用途、对象、input版本独立，四事实proof通过且在营",
          "create+brandAdmin不得覆盖已有brandadmin；未选adopt不授brand权",
          "原子业务完成结果或零生效写，pending非成功"
        ],
        "x-result-owner": "platform-coordinator"
      }
    },
    "/candidate/v0.5/platform/enterprise/creditCheck": {
      "post": {
        "operationId": "enterprise.creditCheck",
        "summary": "信用码历史查重不披露占用者",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR03",
          "BR06"
        ],
        "x-permission": "enterprise.profile.write",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/enterprise_creditCheckInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/enterprise_creditCheckResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/brand/linkEnterprise": {
      "post": {
        "operationId": "brand.linkEnterprise",
        "summary": "显式关联；采用preset仅无admin",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR02",
          "BR04"
        ],
        "x-permission": "brand.organization+enterprise.link",
        "x-error-codes": [
          "PRESET_CHANGED",
          "EXISTING_BRAND_ADMIN",
          "EMPLOYEE_PHONE_CONFLICT"
        ],
        "x-write": true,
        "description": "平台用户业务命令→持久协调者操作。新账号/档案/关系均先准备未生效；published才可读新业务版本；未知503必须携原operationId或可按同key resolve，不得新建账号/员工。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brand_linkEnterpriseInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_linkEnterpriseResponse"
                }
              }
            }
          },
          "202": {
            "description": "operation已持久化但业务未完成；按operationId/key查原结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brand_linkEnterpriseResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingWriteError"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-field-permissions": {
          "unactivatedCodeCount": "完整品牌库存读取权；无权省略",
          "administrator": "当前brand关系读权",
          "privateCode": "普通接口不允许明文"
        },
        "x-result-owner": "platform-coordinator"
      }
    },
    "/candidate/v0.5/platform/legacyPassword/reject": {
      "post": {
        "operationId": "legacyPassword.reject",
        "summary": "旧命令一律拒绝；永远不返回成功业务结果",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR05"
        ],
        "x-permission": "禁止所有平台凭据写",
        "x-error-codes": [
          "LEGACY_COMMAND_REJECTED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/legacyPassword_rejectInput"
              }
            }
          }
        },
        "responses": {
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/tag/query": {
      "post": {
        "operationId": "tag.query",
        "summary": "门店标签定义",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR10"
        ],
        "x-permission": "platform.read",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tag_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tag_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/tag/save": {
      "post": {
        "operationId": "tag.save",
        "summary": "标签新增/改名",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR10"
        ],
        "x-permission": "platform.tag.write",
        "x-error-codes": [
          "TAG_NAME_INVALID"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tag_saveInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tag_saveResponse"
                }
              }
            }
          },
          "202": {
            "description": "仅跨服务候选pending操作；不展示业务完成，不授角色/不开始许可",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tag_saveResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/tag/delete": {
      "post": {
        "operationId": "tag.delete",
        "summary": "在用标签不可删除",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR10"
        ],
        "x-permission": "platform.tag.write",
        "x-error-codes": [
          "TAG_IN_USE"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tag_deleteInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tag_deleteResponse"
                }
              }
            }
          },
          "202": {
            "description": "仅跨服务候选pending操作；不展示业务完成，不授角色/不开始许可",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tag_deleteResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/proof/request": {
      "post": {
        "operationId": "proof.request",
        "summary": "法人/管理员关系用途SMS；不签发平台码reveal或私有登录权",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR04",
          "BR06"
        ],
        "x-permission": "证明发起权随用途限定",
        "x-error-codes": [
          "RATE_LIMITED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/proof_requestInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/proof_requestResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/proof/verify": {
      "post": {
        "operationId": "proof.verify",
        "summary": "法人/管理员关系用途证明核验",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR04",
          "BR06"
        ],
        "x-permission": "当前challenge owner",
        "x-error-codes": [
          "OTP_INVALID",
          "PROOF_EXPIRED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/proof_verifyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/proof_verifyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/file/prepare": {
      "post": {
        "operationId": "file.prepare",
        "summary": "按业务场景限制上传票据",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR07"
        ],
        "x-permission": "file.upload",
        "x-error-codes": [
          "FILE_TOO_LARGE",
          "FILE_FORMAT_INVALID"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/file_prepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/file_prepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/file/complete": {
      "post": {
        "operationId": "file.complete",
        "summary": "真实解码及保临时原文件",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR07"
        ],
        "x-permission": "file.upload",
        "x-error-codes": [
          "FILE_DECODE_FAILED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/file_completeInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/file_completeResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/file/view": {
      "post": {
        "operationId": "file.view",
        "summary": "企业证件受控view",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR07"
        ],
        "x-permission": "file.view独立执行权",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/file_viewInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/file_viewResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/file/download": {
      "post": {
        "operationId": "file.download",
        "summary": "企业证件受控download",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR07"
        ],
        "x-permission": "file.download独立执行权",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/file_downloadInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/file_downloadResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/ocr/extract": {
      "post": {
        "operationId": "ocr.extract",
        "summary": "OCR结果不覆盖手改字段",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR06",
          "BR07"
        ],
        "x-permission": "ocr.execute",
        "x-error-codes": [
          "OCR_LIMIT_EXCEEDED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ocr_extractInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ocr_extractResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/public/factor/verify": {
      "post": {
        "operationId": "factor.verify",
        "summary": "Next自动四事实一致且在营门控",
        "tags": [
          "public"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR06"
        ],
        "x-permission": "factor.execute",
        "x-error-codes": [
          "FACTOR_MISMATCH",
          "FACTOR_NOT_ACTIVE",
          "PROVIDER_UNAVAILABLE"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/factor_verifyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/factor_verifyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/privateCode/reveal": {
      "post": {
        "operationId": "privateCode.reveal",
        "summary": "隐藏16字符码受控查看",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "角色待D01，不允许客户端自报",
        "x-error-codes": [
          "PROOF_INVALID",
          "REVEAL_NOT_ALLOWED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/privateCode_revealInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privateCode_revealResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-conditional-validation": [
          "proof由受信平台签发，绑定actor+brand+reveal用途，不接受通用public/loginproof",
          "管理员手机从登记关系服务读取，不接受任意输入手机号",
          "刷新/退出/切品牌/proof失效清页面明文，无浏览器持久化；时长D01待决"
        ]
      }
    },
    "/candidate/v0.5/platform/privatePolicy/save": {
      "post": {
        "operationId": "privatePolicy.save",
        "summary": "IP/域名名单草稿；不等发布批准",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "名单编辑角色待D02",
        "x-error-codes": [
          "POLICY_INVALID"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/privatePolicy_saveInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privatePolicy_saveResponse"
                }
              }
            }
          },
          "202": {
            "description": "仅跨服务候选pending操作；不展示业务完成，不授角色/不开始许可",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privatePolicy_saveResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/privatePolicy/publish": {
      "post": {
        "operationId": "privatePolicy.publish",
        "summary": "候选名单发布/传播",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08",
          "BR09"
        ],
        "x-permission": "审批发布待D02；未决前禁正式使用",
        "x-error-codes": [
          "POLICY_NOT_APPROVED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/privatePolicy_publishInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privatePolicy_publishResponse"
                }
              }
            }
          },
          "202": {
            "description": "仅跨服务候选pending操作；不展示业务完成，不授角色/不开始许可",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privatePolicy_publishResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/deployment/test": {
      "post": {
        "operationId": "deployment.test",
        "summary": "测试成功只切SMS模式，不建立登录",
        "tags": [
          "business"
        ],
        "security": [],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "可信部署上下文+防滥用",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。 未登录业务初始化入口；后端固定平台主机/部署注册，平台M2M另核；失败对外统一验证失败，不枚举码或跨模式品牌。必须返回testContext并绑定请求，修正见后置schema。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/deployment_testInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deployment_testResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/trustedSms/challenge": {
      "post": {
        "operationId": "trustedSms.challenge",
        "summary": "私有OTP不得客户后端代收；公共只发送短信",
        "tags": [
          "platform"
        ],
        "security": [],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "受信平台托管登录、当前品牌登记管理员",
        "x-error-codes": [
          "PHONE_BRAND_MISMATCH",
          "TEST_CONTEXT_EXPIRED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。 仅受信托管challenge/testContext验证流程，不要求已登录会话；固定回调与state/PKCE，业务私有页面不可收集OTP。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trustedSms_challengeInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/trustedSms_challengeResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/trustedSms/verify": {
      "post": {
        "operationId": "trustedSms.verify",
        "summary": "核OTP/品牌关系，短效结果引用而非URL token",
        "tags": [
          "platform"
        ],
        "security": [],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "同一平台托管challenge owner",
        "x-error-codes": [
          "OTP_INVALID",
          "REPLAY_REJECTED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。 仅受信托管challenge/testContext验证流程，不要求已登录会话；固定回调与state/PKCE，业务私有页面不可收集OTP。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trustedSms_verifyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/trustedSms_verifyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/privateReveal/challenge": {
      "post": {
        "operationId": "privateReveal.challenge",
        "summary": "平台从登记且绑定手机发短信，不接受任意手机号",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "专用reveal权+brand范围",
        "x-error-codes": [
          "REVEAL_NOT_ALLOWED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/privateReveal_challengeInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privateReveal_challengeResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/privateReveal/verify": {
      "post": {
        "operationId": "privateReveal.verify",
        "summary": "平台签发本次目标用途证明，登录OTP不可复用",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "专用reveal权+actor/brand/purpose challenge",
        "x-error-codes": [
          "OTP_INVALID",
          "PROOF_EXPIRED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/privateReveal_verifyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/privateReveal_verifyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/platformLogin/callback": {
      "post": {
        "operationId": "platformLogin.callback",
        "summary": "固定回调映射，不自动开户，不新增密码登录步骤",
        "tags": [
          "business"
        ],
        "security": [],
        "x-candidate": true,
        "x-requirements": [
          "BR08"
        ],
        "x-permission": "服务器验证签名/受众/实例证明+映射既有账号",
        "x-error-codes": [
          "ACCOUNT_MAPPING_REQUIRED",
          "REPLAY_REJECTED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。 后端兑换并校验平台单次签名结果；前端引用/state不能单独建立会话。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/platformLogin_callbackInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/platformLogin_callbackResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/deployment/exchange": {
      "post": {
        "operationId": "deployment.exchange",
        "summary": "短效单次部署绑定无store范围/额度",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08",
          "BR09"
        ],
        "x-permission": "受众绑定服务身份+实例持有证明",
        "x-error-codes": [
          "REPLAY_REJECTED",
          "INSTANCE_PROOF_INVALID"
        ],
        "x-write": true,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/deployment_exchangeInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deployment_exchangeResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.authorization",
          "requiredScope": "deployment.exchange",
          "allowedIssuers": [
            "registered-business-deployment"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        }
      }
    },
    "/candidate/v0.5/platform/deployment/check": {
      "post": {
        "operationId": "deployment.check",
        "summary": "请求关联/签名/时序全部通过才更新最后可信核验",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR09"
        ],
        "x-permission": "已注册部署服务身份",
        "x-error-codes": [],
        "x-write": false,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/deployment_checkInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deployment_checkResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.authorization",
          "requiredScope": "deployment.check",
          "allowedIssuers": [
            "registered-business-deployment",
            "registered-public-service",
            "registered-payment-service"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        },
        "x-state-proof-verification": "producer对当前平台状态快照签名；consumer服务器核registered算法/key/issuer、consumer受众、brand/deploy/request/nonce、期限、状态digest/权益、当前单调revision；body不能自报准入。public/payment每个新业务请求实时核屏障，失败unknown拒绝；不得以未过期旧active token覆盖当前inactive。结构/模型不等密码学或故障联调通过。"
      }
    },
    "/candidate/v0.5/platform/securityAudit/query": {
      "post": {
        "operationId": "securityAudit.query",
        "summary": "码/OTP/完整grant/令牌/签名重放材料禁止日志输出",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR08",
          "BR09"
        ],
        "x-permission": "独立安全审计权；非管理员默认拒绝",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/securityAudit_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/securityAudit_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/membership/query": {
      "post": {
        "operationId": "membership.query",
        "summary": "SaaS仅SaaS集合/private仅当前1",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR04",
          "BR08"
        ],
        "x-permission": "当前账号有效品牌关系",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/membership_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/membership_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/product/query": {
      "post": {
        "operationId": "product.query",
        "summary": "共享方案目录与五桶统计",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU01"
        ],
        "x-permission": "platform.read目录scope",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/product_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/product/publish": {
      "post": {
        "operationId": "product.publish",
        "summary": "创建或追加版本保存即开启",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU01"
        ],
        "x-permission": "license.product.configure",
        "x-error-codes": [
          "INVALID_AMOUNT",
          "VERSION_CONFLICT"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/product_publishInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_publishResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/product/lifecycle": {
      "post": {
        "operationId": "product.lifecycle",
        "summary": "版本生命周期及完整历史删除保护",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU01"
        ],
        "x-permission": "license.product.configure",
        "x-error-codes": [
          "HISTORY_PROTECTION"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/product_lifecycleInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_lifecycleResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "202": {
            "description": "删除协调pending，不表示已删/码已作废",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_lifecycleResponse"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-delete-protocol": "action=delete MUST dispatch same product.deleteIntent protocol；close/archive不作废已发码；restore为closed；无完整neverBound或任一held/used/assigned history则拒绝。"
      }
    },
    "/candidate/v0.5/platform/code/generate": {
      "post": {
        "operationId": "code.generate",
        "summary": "R2手填天数/绝对截止冻结发码",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU02"
        ],
        "x-permission": "brand.license.issue",
        "x-error-codes": [
          "INVALID_SERVICE_DURATION",
          "INVALID_TIMESTAMP",
          "DATE_OVERFLOW"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/code_generateInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/code_generateResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/code/assign": {
      "post": {
        "operationId": "code.assign",
        "summary": "分配不开始服务，首期不换店",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU06"
        ],
        "x-permission": "brand.license.allocate+同brand店scope",
        "x-error-codes": [
          "STORE_SCOPE_MISMATCH",
          "CODE_RESERVED",
          "REASSIGNMENT_DISABLED"
        ],
        "x-write": true,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 Idempotency-Key按actor+deployment+operation作用域；同key同payload回原结果，异payload拒绝，当前权限仍重验。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/code_assignInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/code_assignResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/code/candidates": {
      "post": {
        "operationId": "code.candidates",
        "summary": "最小未用未截止未占用候选",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU06"
        ],
        "x-permission": "license.bind+store scope",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/code_candidatesInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/code_candidatesResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/code/inventory": {
      "post": {
        "operationId": "code.inventory",
        "summary": "本部署品牌完整库存",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU06",
          "AU07"
        ],
        "x-permission": "brand.license.inventory独立权",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/code_inventoryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/code_inventoryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/activation/preview": {
      "post": {
        "operationId": "activation.preview",
        "summary": "纯读预览，可信门店上下文，不预留",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU03",
          "AU05"
        ],
        "x-permission": "store.license.activate 或HQ绑定+店scope",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_previewInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_previewResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/activation/accept": {
      "post": {
        "operationId": "activation.accept",
        "summary": "服务端截止前受理并持久双占用",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU03",
          "AU04",
          "AU06"
        ],
        "x-permission": "HQ绑定或既有store activate+店scope",
        "x-error-codes": [
          "REDEEM_DEADLINE_REACHED",
          "ACTIVATION_RESERVED",
          "CODE_USED"
        ],
        "x-write": true,
        "description": "同店请求幂等作用域：deploymentId+storeId+operationKind+Idempotency-Key；actor不是命名空间，仍逐次核当前权限/审计。相同payload回原request；异payload409；另一有权actor同key不能新受理；撤权403但不删原双占用。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_acceptInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_acceptResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-conditional-validation": [
          "可信actor确定deployment/brand；input店ID仅在授权范围",
          "acceptedAt由业务权威事务时钟，acceptedAt<deadline",
          "code未消耗/未作废/未被其他request占用，store无其他heldrequest",
          "同key先查询原payload并重核权限，不因当前deadline拒绝原结果读",
          "Store→CodeGrant固定锁序，Request+双占用同事务，结果未知保持"
        ],
        "x-idempotency-scope": "deploymentId+storeId+operationKind+Idempotency-Key；actor不是命名空间，仍逐次核当前权限/审计",
        "x-operation-record-binding": "business_operation_keys.operation_id/request_id与b_activation_requests唯一映射；唯一(deployment,store,operation,key)一致。"
      }
    },
    "/candidate/v0.5/business/activation/result": {
      "post": {
        "operationId": "activation.result",
        "summary": "跨截止查询原请求，不重新兑换",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU04",
          "AU07"
        ],
        "x-permission": "原brand/deployment/store当前读权",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_resultInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_resultResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/business/activation/reconcile": {
      "post": {
        "operationId": "activation.reconcile",
        "summary": "读取权威证据确证，客户端不传成功时刻",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU04",
          "AU05"
        ],
        "x-permission": "平台核对执行权+目标scope受控服务委托",
        "x-error-codes": [
          "CONFIRMED_EVIDENCE_REQUIRED",
          "RESULT_CONFLICT"
        ],
        "x-write": true,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          },
          {
            "name": "Platform-Delegation",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "description": "签名、受众/actor当前执行权/brand/deployment/store/request/version/payload/nonce绑定的委托证明引用；服务端读取验证DelegationClaims"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_reconcileInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_reconcileResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.activation",
          "requiredScope": "activation.reconcile",
          "allowedIssuers": [
            "platform-service"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        },
        "x-delegation-required": true,
        "x-evidence-source": "从部署预注册trusted-result-authority读取并验签AuthorityEvidence；不接受客户端confirmedOutcome/succeededAt或自由URL；request/code/store/brand/deployment/payloadDigest/acceptedAt必须一致；证据序列单调，冲突409，重放只回原结果。",
        "x-delegation-constraints": {
          "issuer": "platform-delegation-authority",
          "audience": "business.activation",
          "operation": "activation.reconcile",
          "currentActorAuthorizationRequired": true,
          "expiresAndNonceRequired": true,
          "bindings": [
            "brandId",
            "deploymentId",
            "storeId",
            "requestId",
            "requestRevision",
            "payloadDigest"
          ]
        },
        "x-evidence-constraints": {
          "issuerRegistry": "部署预注册registered-result-authority",
          "audience": "business.activation",
          "serverFetchedOnly": true,
          "signatureKeyVersionRequired": true,
          "requestNonceRequired": true,
          "bindings": [
            "brandId",
            "deploymentId",
            "storeId",
            "requestId",
            "codeId",
            "payloadDigest",
            "acceptedAt"
          ]
        }
      }
    },
    "/candidate/v0.5/platform/license/query": {
      "post": {
        "operationId": "license.query",
        "summary": "PLAT05许可台账只读",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU05",
          "AU07"
        ],
        "x-permission": "platform.read+store scope",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/license_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/license_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/license/detail": {
      "post": {
        "operationId": "license.detail",
        "summary": "PLAT06精确记录和证据",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU04",
          "AU05",
          "AU07"
        ],
        "x-permission": "platform.read scopedStore；batch另核fullBrand",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/license_detailInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/license_detailResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/purchase/query": {
      "post": {
        "operationId": "purchase.query",
        "summary": "PLAT17历史冻结采购只读",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU01",
          "AU07"
        ],
        "x-permission": "platform.read+fullBrand/finance",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/purchase_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/purchase_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/activation/query": {
      "post": {
        "operationId": "activation.query",
        "summary": "PLAT19仅成功激活事实",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU05",
          "AU07"
        ],
        "x-permission": "platform.read scopedStore",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/batch/query": {
      "post": {
        "operationId": "batch.query",
        "summary": "PLAT24三来源/别名恰一定位",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU02",
          "AU07"
        ],
        "x-permission": "platform.read+fullBrand",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/batch_queryInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/batch_queryResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/product/versionStores": {
      "post": {
        "operationId": "product.versionStores",
        "summary": "PLAT49历史绑定，不将可见0作删除资格",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "AU01",
          "AU07"
        ],
        "x-permission": "platform.read scopedStore",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/product_versionStoresInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_versionStoresResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/operation/result": {
      "post": {
        "operationId": "operation.result",
        "summary": "跨服务提交pending回查，不冒认成功",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR02",
          "BR03",
          "BR04"
        ],
        "x-permission": "原操作当前目标scope",
        "x-error-codes": [],
        "x-write": false,
        "description": "路径/权限key均TECH候选。服务端由可信身份派生角色和scope，不信任输入。 权限过滤先于查询、计数、分页；未知对象不扩范围。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/operation_resultInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/operation_resultResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true
      }
    },
    "/candidate/v0.5/platform/activation/reconcileRequest": {
      "post": {
        "operationId": "activation.reconcileRequest",
        "summary": "activation.reconcileRequest候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_reconcileRequestInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_reconcileRequestResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-permission": "平台核对执行权+目标brand/deployment/store范围；品牌管理员只查不能核对",
        "x-delegates-to": "activation.reconcile",
        "description": "平台用户入口仅创建持久核对操作；后端读取权威证据并签发目标绑定委托，普通session不能调用business内部确证。"
      }
    },
    "/candidate/v0.5/platform/transaction/platform/prepare": {
      "post": {
        "operationId": "transaction.platform.prepare",
        "summary": "transaction.platform.prepare候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_platform_prepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_platform_prepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.prepare",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/transaction/platform/apply": {
      "post": {
        "operationId": "transaction.platform.apply",
        "summary": "transaction.platform.apply候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_platform_applyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_platform_applyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.apply",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/transaction/platform/abort": {
      "post": {
        "operationId": "transaction.platform.abort",
        "summary": "transaction.platform.abort候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_platform_abortInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_platform_abortResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.abort",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/transaction/platform/status": {
      "post": {
        "operationId": "transaction.platform.status",
        "summary": "transaction.platform.status候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_platform_statusInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_platform_statusResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.status",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/business/transaction/business/prepare": {
      "post": {
        "operationId": "transaction.business.prepare",
        "summary": "transaction.business.prepare候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_business_prepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_business_prepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.transaction",
          "requiredScope": "transaction.prepare",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/business/transaction/business/apply": {
      "post": {
        "operationId": "transaction.business.apply",
        "summary": "transaction.business.apply候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_business_applyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_business_applyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.transaction",
          "requiredScope": "transaction.apply",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/business/transaction/business/abort": {
      "post": {
        "operationId": "transaction.business.abort",
        "summary": "transaction.business.abort候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_business_abortInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_business_abortResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.transaction",
          "requiredScope": "transaction.abort",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/business/transaction/business/status": {
      "post": {
        "operationId": "transaction.business.status",
        "summary": "transaction.business.status候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_business_statusInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_business_statusResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.transaction",
          "requiredScope": "transaction.status",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/public/transaction/public/prepare": {
      "post": {
        "operationId": "transaction.public.prepare",
        "summary": "transaction.public.prepare候选合同",
        "tags": [
          "public"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_public_prepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_public_prepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "public.transaction",
          "requiredScope": "transaction.prepare",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/public/transaction/public/apply": {
      "post": {
        "operationId": "transaction.public.apply",
        "summary": "transaction.public.apply候选合同",
        "tags": [
          "public"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_public_applyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_public_applyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "public.transaction",
          "requiredScope": "transaction.apply",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/public/transaction/public/abort": {
      "post": {
        "operationId": "transaction.public.abort",
        "summary": "transaction.public.abort候选合同",
        "tags": [
          "public"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_public_abortInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_public_abortResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "public.transaction",
          "requiredScope": "transaction.abort",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/public/transaction/public/status": {
      "post": {
        "operationId": "transaction.public.status",
        "summary": "transaction.public.status候选合同",
        "tags": [
          "public"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_public_statusInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_public_statusResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "public.transaction",
          "requiredScope": "transaction.status",
          "allowedIssuers": [
            "platform-coordinator"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "持久intent/receipt/decision/fence；apply仅接受可信commit决定，abort仅接受abort决定；applied-hidden不对业务读开放，过期不自选abort；异digest409；status只读恢复。",
        "x-recovery-epoch-rule": "epoch>参加者已持久epoch时，必须服务器读取可信RecoveryClaim，绑定原operation/payload/不可变decision摘要及newEpoch；升级逻辑fence但不改决定。旧epoch消息409；新worker用claim续接旧decision，而非改签或反转旧决定。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/transaction/recoveryClaim": {
      "post": {
        "operationId": "transaction.recoveryClaim",
        "summary": "transaction.recoveryClaim候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_recoveryClaimInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_recoveryClaimResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.recover",
          "allowedIssuers": [
            "platform-coordinator-worker"
          ],
          "senderProofRequired": true
        },
        "x-protocol": "平台本地CAS递增owner epoch及签名continuation claim；只接续已持久原决定/摘要；未知前态由status原读，不换payload。",
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/transaction/publication": {
      "post": {
        "operationId": "transaction.publication",
        "summary": "transaction.publication候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_publicationInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_publicationResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.barrier",
          "allowedIssuers": [
            "registered-participant"
          ],
          "senderProofRequired": true
        },
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。"
      }
    },
    "/candidate/v0.5/platform/brandAdmin/replace": {
      "post": {
        "operationId": "brandAdmin.replace",
        "summary": "平台受控委托只替品牌关系",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR04",
          "BR05"
        ],
        "x-permission": "platform.brand-admin.set委托执行权",
        "x-error-codes": [
          "EMPLOYEE_PHONE_CONFLICT",
          "PROOF_INVALID"
        ],
        "x-write": true,
        "description": "平台用户业务命令→持久协调者操作。新账号/档案/关系均先准备未生效；published才可读新业务版本；未知503必须携原operationId或可按同key resolve，不得新建账号/员工。",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "保留既有canonical ID；不强制改为UUID"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/brandAdmin_replaceInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brandAdmin_replaceResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingWriteError"
                }
              }
            }
          },
          "202": {
            "description": "operation已持久化但业务未完成；按operationId/key查原结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/brandAdmin_replaceResponse"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-result-owner": "platform-coordinator"
      }
    },
    "/candidate/v0.5/platform/operation/resolve": {
      "post": {
        "operationId": "operation.resolve",
        "summary": "operation.resolve候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/operation_resolveInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/operation_resolveResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-permission": "当前actor目标操作执行/读取权；不返回他brand操作",
        "x-result-owner": "platform-coordinator"
      }
    },
    "/candidate/v0.5/business/grant/prepare": {
      "post": {
        "operationId": "grant.prepare",
        "summary": "grant.prepare候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_prepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_prepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.prepare",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。",
        "x-frozen-grant-set": "持久平台版本头fence/集合核验；重复旧deliver不得加入冻结集合外grant，旧epoch/版本/digest拒绝。unknown history禁止accept/assign/delete；新鲜grant才由可信prepare显式证明never-bound。"
      }
    },
    "/candidate/v0.5/business/grant/deliver": {
      "post": {
        "operationId": "grant.deliver",
        "summary": "grant.deliver候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_deliverInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_deliverResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.deliver",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。",
        "x-frozen-grant-set": "持久平台版本头fence/集合核验；重复旧deliver不得加入冻结集合外grant，旧epoch/版本/digest拒绝。unknown history禁止accept/assign/delete；新鲜grant才由可信prepare显式证明never-bound。"
      }
    },
    "/candidate/v0.5/business/grant/status": {
      "post": {
        "operationId": "grant.status",
        "summary": "grant.status候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_statusInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_statusResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.status",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。"
      }
    },
    "/candidate/v0.5/business/grant/revokePrepare": {
      "post": {
        "operationId": "grant.revokePrepare",
        "summary": "grant.revokePrepare候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_revokePrepareInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_revokePrepareResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.revokePrepare",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。",
        "x-frozen-grant-set": "持久平台版本头fence/集合核验；重复旧deliver不得加入冻结集合外grant，旧epoch/版本/digest拒绝。unknown history禁止accept/assign/delete；新鲜grant才由可信prepare显式证明never-bound。"
      }
    },
    "/candidate/v0.5/business/grant/revokeApply": {
      "post": {
        "operationId": "grant.revokeApply",
        "summary": "grant.revokeApply候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_revokeApplyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_revokeApplyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.revokeApply",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。",
        "x-frozen-grant-set": "持久平台版本头fence/集合核验；重复旧deliver不得加入冻结集合外grant，旧epoch/版本/digest拒绝。unknown history禁止accept/assign/delete；新鲜grant才由可信prepare显式证明never-bound。"
      }
    },
    "/candidate/v0.5/business/grant/revokeAbort": {
      "post": {
        "operationId": "grant.revokeAbort",
        "summary": "grant.revokeAbort候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/grant_revokeAbortInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_revokeAbortResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "business.grant",
          "requiredScope": "grant.revokeAbort",
          "allowedIssuers": [
            "platform-license-authority"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true
        },
        "x-fencing": "受理/分配与撤销准备锁同CodeGrant；prepare先胜则禁止新受理，accept先胜则held或everBound阻止删除；未知不自动释放、不重授旧码。",
        "x-frozen-grant-set": "持久平台版本头fence/集合核验；重复旧deliver不得加入冻结集合外grant，旧epoch/版本/digest拒绝。unknown history禁止accept/assign/delete；新鲜grant才由可信prepare显式证明never-bound。"
      }
    },
    "/candidate/v0.5/platform/product/deleteIntent": {
      "post": {
        "operationId": "product.deleteIntent",
        "summary": "product.deleteIntent候选合同",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-write": true,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/product_deleteIntentInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product_deleteIntentResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "x-permission": "license.product.configure+完整历史判断",
        "x-delete-protocol": "持久delete intent锁版本头阻新签发/授予，取得全部排他grant撤销准备及完整neverBound证明；离线/未知pending或明确拒绝，不依平台投影0删；全决策发布后逻辑delete并作废未用码。",
        "x-frozen-grant-set": "同平台版本头短事务CAS递增lifecycleFence并持久FrozenGrantSet；签发/授予/延迟deliver统一需版本头fence许可。成员包含prepared/delivered及完整发行历史；历史未知拒绝/待核，不推定空。全部成员逐一绑定grantRevision/digest/fence的revoke prepare/apply收据与集合摘要才允许commit/publication，零成员也须完整历史证明。"
      }
    },
    "/candidate/v0.5/business/activation/resolveKey": {
      "post": {
        "operationId": "activation.resolveKey",
        "summary": "activation.resolveKey候选合同",
        "tags": [
          "business"
        ],
        "security": [
          {
            "sessionAuth": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/activation_resolveKeyInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/activation_resolveKeyResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-idempotency-scope": "deploymentId+storeId+operationKind+Idempotency-Key；actor不是命名空间，仍逐次核当前权限/审计",
        "x-permission": "当前brand/deployment/store读取权，不重查兑换截止拒绝原请求读"
      }
    },
    "/candidate/v0.5/platform/transaction/currentPublication": {
      "post": {
        "operationId": "transaction.currentPublication",
        "summary": "按精确实体集合取得当前发布一致快照，旧operation查询不能授权",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-write": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/transaction_currentPublicationInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "查询或完成；data状态决定业务结果",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/transaction_currentPublicationResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "身份/受众/委托/当前执行权或目标范围不合法，零业务写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "IDEMPOTENCY_CONFLICT/RESULT_CONFLICT/VERSION_CONFLICT/FENCE_CONFLICT",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用/状态未明；携operationId/recovery定位，不可盲目新key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.transaction",
          "requiredScope": "transaction.barrier",
          "allowedIssuers": [
            "registered-participant"
          ],
          "senderProofRequired": true
        },
        "x-v04-verification": "签名仅服务器按注册issuer/aud/key/算法核验；所有receipt operation/digest/decision/epoch/version/participant集合必须与持久权威事实相等，结构合法不等验证通过。恢复claim previousEpoch必须等当前fence，newEpoch严格增加；无可信claim拒绝更高epoch，同epoch允许精确幂等重放；participant prepared→applied-hidden→published单调，不得倒退。",
        "x-current-bundle": "平台单一本地快照读取目标集合current指针；只返回精确请求集合，绑定nonce/scope和当前授权版本。各服务只读bundle指定entityRevision/digest隐藏历史版本，不各自读latest；提交在平台CAS重验snapshotRevision/current pointers并取逻辑fence，任何变动409；快照不能复用授权新请求。旧operation published只查历史。"
      }
    },
    "/candidate/v0.5/platform/state/business/barrier": {
      "post": {
        "operationId": "state.business.barrier",
        "summary": "候选逐消费者当前状态屏障",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR09"
        ],
        "x-permission": "已注册部署服务身份",
        "x-error-codes": [],
        "x-write": false,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/state_business_barrierInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/state_business_barrierResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.state",
          "requiredScope": "state.business.barrier",
          "allowedIssuers": [
            "registered-business-service"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        },
        "x-state-proof-verification": "producer对当前平台状态快照签名；consumer服务器核registered算法/key/issuer、consumer受众、brand/deploy/request/nonce、期限、状态digest/权益、当前单调revision；body不能自报准入。public/payment每个新业务请求实时核屏障，失败unknown拒绝；不得以未过期旧active token覆盖当前inactive。结构/模型不等密码学或故障联调通过。"
      }
    },
    "/candidate/v0.5/platform/state/public/barrier": {
      "post": {
        "operationId": "state.public.barrier",
        "summary": "候选逐消费者当前状态屏障",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR09"
        ],
        "x-permission": "已注册部署服务身份",
        "x-error-codes": [],
        "x-write": false,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/state_public_barrierInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/state_public_barrierResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.state",
          "requiredScope": "state.public.barrier",
          "allowedIssuers": [
            "registered-public-service"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        },
        "x-state-proof-verification": "producer对当前平台状态快照签名；consumer服务器核registered算法/key/issuer、consumer受众、brand/deploy/request/nonce、期限、状态digest/权益、当前单调revision；body不能自报准入。public/payment每个新业务请求实时核屏障，失败unknown拒绝；不得以未过期旧active token覆盖当前inactive。结构/模型不等密码学或故障联调通过。"
      }
    },
    "/candidate/v0.5/platform/state/payment/barrier": {
      "post": {
        "operationId": "state.payment.barrier",
        "summary": "候选逐消费者当前状态屏障",
        "tags": [
          "platform"
        ],
        "security": [
          {
            "serviceIdentity": []
          }
        ],
        "x-candidate": true,
        "x-requirements": [
          "BR09"
        ],
        "x-permission": "已注册部署服务身份",
        "x-error-codes": [],
        "x-write": false,
        "description": "机器内部操作，用户会话403；服务签名/算法/iss/aud/exp/nbf/scope/jti及实例持有证明均必核，scope不能靠请求体自报。",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/state_payment_barrierInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权威成功/原结果回放；查询200不表示业务新写",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/state_payment_barrierResponse"
                }
              }
            }
          },
          "400": {
            "description": "INVALID_INPUT/时间或精度不可表达",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "ACTOR_REQUIRED/无效会话",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "PERMISSION_REQUIRED/SCOPE_MISMATCH；不得泄露对象",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "OBJECT_UNAVAILABLE",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "VERSION_CONFLICT/IDEMPOTENCY_CONFLICT/业务冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "业务条件不满足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "依赖不可用；写结果未知须原key查回",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-business-zero-write-on-rejection": true,
        "x-current-permission-rechecked-on-replay": true,
        "x-machine-constraints": {
          "tokenKind": "service",
          "audience": "platform.state",
          "requiredScope": "state.payment.barrier",
          "allowedIssuers": [
            "registered-payment-service"
          ],
          "senderProofRequired": true,
          "tenantDeploymentBinding": true,
          "requireCurrentStatus": true
        },
        "x-state-proof-verification": "producer对当前平台状态快照签名；consumer服务器核registered算法/key/issuer、consumer受众、brand/deploy/request/nonce、期限、状态digest/权益、当前单调revision；body不能自报准入。public/payment每个新业务请求实时核屏障，失败unknown拒绝；不得以未过期旧active token覆盖当前inactive。结构/模型不等密码学或故障联调通过。"
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              },
              "currentRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "code",
              "message",
              "retryable"
            ],
            "additionalProperties": false
          },
          "recovery": {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "requestId": {
                "type": "string",
                "minLength": 1
              },
              "keyScope": {
                "type": "string",
                "minLength": 1
              },
              "resultOwner": {
                "type": "string",
                "enum": [
                  "platform",
                  "business"
                ]
              },
              "safeAction": {
                "type": "string",
                "enum": [
                  "query-original",
                  "retry-same-key",
                  "refresh-preview"
                ]
              }
            },
            "required": [
              "resultOwner",
              "safeAction"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "ok",
          "requestId",
          "error"
        ],
        "additionalProperties": false
      },
      "PageInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "Address": {
        "type": "object",
        "properties": {
          "subject": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          },
          "gcj02": {
            "type": "object",
            "properties": {
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              }
            },
            "required": [
              "latitude",
              "longitude"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "subject"
        ],
        "additionalProperties": false
      },
      "ProofReference": {
        "type": "object",
        "properties": {
          "proofId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "purpose": {
            "type": "string",
            "enum": [
              "legal",
              "administrator",
              "private-code-reveal"
            ]
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "relationRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "proofId",
          "purpose"
        ],
        "additionalProperties": false
      },
      "Brand": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ]
          },
          "deploymentType": {
            "type": "string",
            "enum": [
              "saas",
              "private"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "enterpriseId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "logoFileId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "address": {
            "$ref": "#/components/schemas/Address"
          },
          "storeCount": {
            "type": "integer",
            "minimum": 0
          },
          "unactivatedCodeCount": {
            "type": "integer",
            "minimum": 0
          },
          "administrator": {
            "$ref": "#/components/schemas/Administrator"
          },
          "propagation": {
            "$ref": "#/components/schemas/Propagation"
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "deploymentType",
          "revision"
        ],
        "additionalProperties": false
      },
      "Administrator": {
        "type": "object",
        "properties": {
          "employeeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "maskedPhone": {
            "type": "string"
          },
          "relationRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "employeeId",
          "accountId",
          "name",
          "maskedPhone",
          "relationRevision"
        ],
        "additionalProperties": false
      },
      "Propagation": {
        "type": "object",
        "properties": {
          "eventId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "version": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "acked",
              "retry-failed"
            ]
          },
          "pendingServices": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "eventId",
          "version",
          "status"
        ],
        "additionalProperties": false
      },
      "EnterpriseProfile": {
        "type": "object",
        "properties": {
          "companyName": {
            "type": "string"
          },
          "creditCode": {
            "type": "string"
          },
          "legalName": {
            "type": "string"
          },
          "registeredAddress": {
            "type": "string"
          },
          "registeredCapital": {
            "type": "string"
          },
          "legalIdNumber": {
            "type": "string"
          },
          "legalIdValidity": {
            "type": "string"
          },
          "contactPhone": {
            "type": "string"
          },
          "businessLicenseFileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "legalFrontFileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "legalBackFileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "companyName",
          "creditCode",
          "legalName",
          "registeredAddress",
          "registeredCapital",
          "legalIdNumber",
          "legalIdValidity",
          "contactPhone",
          "businessLicenseFileId",
          "legalFrontFileId",
          "legalBackFileId"
        ],
        "additionalProperties": false
      },
      "Enterprise": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "profile": {
            "$ref": "#/components/schemas/EnterpriseProfile"
          },
          "preset": {
            "$ref": "#/components/schemas/Preset"
          },
          "brandAdministrators": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Administrator"
            }
          }
        },
        "required": [
          "id",
          "name",
          "revision"
        ],
        "additionalProperties": false
      },
      "EnterpriseSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "completeness": {
            "type": "string"
          },
          "readableBrandCount": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "readableStoreCount": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "brandAdministrators": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Administrator"
            }
          }
        },
        "required": [
          "id",
          "name",
          "revision"
        ],
        "additionalProperties": false
      },
      "Preset": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "maskedPhone": {
            "type": "string"
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "accountId",
          "name",
          "maskedPhone",
          "revision"
        ],
        "additionalProperties": false
      },
      "PresetInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "proof": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "expectedPresetRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "name",
          "phone",
          "draftId",
          "proof"
        ],
        "additionalProperties": false
      },
      "OperationResult": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/OperationPending"
          },
          {
            "$ref": "#/components/schemas/OperationPublished"
          },
          {
            "$ref": "#/components/schemas/OperationAborted"
          }
        ],
        "discriminator": {
          "propertyName": "status"
        },
        "description": "只有published为业务完成；commit-decided/applying/recovery-blocked均不能显示完成或释放逻辑锁；不长期持有SQL事务。"
      },
      "ProductSnapshot": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "version": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "trial",
              "formal"
            ]
          },
          "durationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "priceFen": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "currency": {
            "type": "string",
            "enum": [
              "CNY"
            ]
          },
          "unusedValidityDays": {
            "type": "string",
            "nullable": true,
            "pattern": "^[1-9][0-9]*$",
            "description": "null=历史长期；字段缺省=来源未知。不得成为R2生成默认截止"
          }
        },
        "required": [
          "productId",
          "version",
          "name",
          "category",
          "durationDays"
        ],
        "additionalProperties": false
      },
      "ProductVersion": {
        "type": "object",
        "properties": {
          "snapshot": {
            "$ref": "#/components/schemas/ProductSnapshot"
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "saleStatus": {
            "type": "string",
            "enum": [
              "active",
              "closed",
              "archived",
              "deleted"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "snapshot",
          "revision",
          "saleStatus"
        ],
        "additionalProperties": false
      },
      "Code": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "batchId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "productSnapshot": {
            "$ref": "#/components/schemas/ProductSnapshot"
          },
          "serviceDurationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "redeemDeadline": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "availability": {
            "type": "string",
            "enum": [
              "unused",
              "assigned",
              "reserved",
              "used",
              "voided",
              "expired",
              "review"
            ]
          },
          "assignedStoreId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "request": {
            "$ref": "#/components/schemas/ActivationRequest"
          },
          "historyMissingFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "brandId",
          "availability",
          "revision"
        ],
        "additionalProperties": false
      },
      "CandidateCode": {
        "type": "object",
        "properties": {
          "codeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serviceDurationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "redeemDeadline": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "availability": {
            "type": "string",
            "enum": [
              "unused",
              "assigned"
            ]
          }
        },
        "required": [
          "codeId",
          "serviceDurationDays",
          "redeemDeadline",
          "availability"
        ],
        "additionalProperties": false
      },
      "StoreLicense": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "codeId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "validFrom": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "validTo": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "isCurrent": {
            "type": "boolean"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "calculationVersion": {
            "type": "integer",
            "enum": [
              1,
              2
            ]
          },
          "previousLicenseId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "renewalBaseAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "replacedAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "replacedByCodeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "sourceStatus": {
            "type": "string",
            "enum": [
              "recorded",
              "unrecorded",
              "review"
            ]
          },
          "displayStatus": {
            "type": "string"
          },
          "remainingMs": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "id",
          "storeId",
          "validFrom",
          "validTo",
          "isCurrent",
          "capabilities",
          "sourceStatus"
        ],
        "additionalProperties": false
      },
      "ActivationRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/ActivationRequestAccepted"
          },
          {
            "$ref": "#/components/schemas/ActivationRequestUnknown"
          },
          {
            "$ref": "#/components/schemas/ActivationRequestSuccess"
          },
          {
            "$ref": "#/components/schemas/ActivationRequestFailed"
          }
        ],
        "discriminator": {
          "propertyName": "status",
          "mapping": {
            "accepted": "#/components/schemas/ActivationRequestAccepted",
            "unknown": "#/components/schemas/ActivationRequestUnknown",
            "success": "#/components/schemas/ActivationRequestSuccess",
            "failed": "#/components/schemas/ActivationRequestFailed"
          }
        },
        "description": "accepted/unknown必双占用且无成功事实；success必消费+权威成功时/许可/审计；failed必释放自身占用且保旧指针。acceptedAt<deadline及succeededAt>=acceptedAt、许可来源对应由服务端不变量核验。"
      },
      "Batch": {
        "type": "object",
        "properties": {
          "batchId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "batchNumber": {
            "type": "string"
          },
          "displayNumber": {
            "type": "string"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "issuedBy": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "quantity": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "serviceDurationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "redeemDeadline": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "productSnapshot": {
            "$ref": "#/components/schemas/ProductSnapshot"
          }
        },
        "required": [
          "batchId",
          "brandId",
          "issuedAt",
          "quantity",
          "productSnapshot"
        ],
        "additionalProperties": false
      },
      "Purchase": {
        "type": "object",
        "properties": {
          "purchaseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "productSnapshot": {
            "$ref": "#/components/schemas/ProductSnapshot"
          },
          "paymentMethod": {
            "type": "string",
            "enum": [
              "online",
              "offline"
            ]
          },
          "paymentStatus": {
            "type": "string"
          },
          "totalAmountFen": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "quantity": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "issuedQuantity": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "purchaseId",
          "brandId",
          "productSnapshot",
          "paymentMethod",
          "paymentStatus",
          "totalAmountFen",
          "quantity",
          "issuedQuantity"
        ],
        "additionalProperties": false
      },
      "BatchRow": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "rowKind": {
                "type": "string",
                "enum": [
                  "direct"
                ]
              },
              "batch": {
                "$ref": "#/components/schemas/Batch"
              }
            },
            "required": [
              "rowKind",
              "batch"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "rowKind": {
                "type": "string",
                "enum": [
                  "purchase-batch"
                ]
              },
              "batch": {
                "$ref": "#/components/schemas/Batch"
              },
              "purchase": {
                "$ref": "#/components/schemas/Purchase"
              },
              "remainingUnissued": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "rowKind",
              "batch",
              "purchase",
              "remainingUnissued"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "rowKind": {
                "type": "string",
                "enum": [
                  "purchase-without-batch"
                ]
              },
              "purchase": {
                "$ref": "#/components/schemas/Purchase"
              },
              "quantity": {
                "type": "integer",
                "enum": [
                  0
                ]
              },
              "remainingUnissued": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "rowKind",
              "purchase",
              "quantity",
              "remainingUnissued"
            ],
            "additionalProperties": false
          }
        ],
        "discriminator": {
          "propertyName": "rowKind"
        }
      },
      "Audit": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "actorId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "action": {
            "type": "string"
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "targetId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "authorityEvidenceReference": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "id",
          "actorId",
          "action",
          "at",
          "targetId"
        ],
        "additionalProperties": false
      },
      "ActivationFact": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "codeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "licenseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "activatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "validFrom": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "validTo": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "calculationVersion": {
            "type": "integer"
          },
          "previousLicenseId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "renewalBaseAt": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "id",
          "codeId",
          "storeId",
          "licenseId",
          "activatedAt",
          "validFrom",
          "validTo",
          "idempotencyKey"
        ],
        "additionalProperties": false
      },
      "brand_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "deploymentType": {
            "type": "string",
            "enum": [
              "all",
              "saas",
              "private"
            ]
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "brand_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Brand"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brand_detailInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "brandId"
        ],
        "additionalProperties": false
      },
      "brand_detailResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Brand"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brand_createInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "deploymentType": {
            "type": "string",
            "enum": [
              "saas",
              "private"
            ],
            "default": "saas"
          },
          "logoFileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "address": {
            "$ref": "#/components/schemas/Address"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": false
      },
      "brand_createResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Brand"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brand_updateInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "logoFileId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "address": {
            "$ref": "#/components/schemas/Address"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "expectedRevision",
          "name"
        ],
        "additionalProperties": false
      },
      "brand_updateResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Brand"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brand_lifecycleInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "action": {
            "type": "string",
            "enum": [
              "close",
              "open",
              "delete"
            ]
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "action",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "brand_lifecycleResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "brand": {
                "$ref": "#/components/schemas/Brand"
              },
              "operation": {
                "$ref": "#/components/schemas/OperationResult"
              }
            },
            "required": [
              "operation"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "enterprise_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "completeness": {
            "type": "string"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "enterprise_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/EnterpriseSummary"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "enterprise_detailInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "enterpriseId"
        ],
        "additionalProperties": false
      },
      "enterprise_detailResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Enterprise"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "enterprise_createInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "profile": {
            "$ref": "#/components/schemas/EnterpriseProfile"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "factorProofId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "legalProof": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "preset": {
            "$ref": "#/components/schemas/PresetInput"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedBrandRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "adoptPreset": {
            "type": "boolean",
            "default": false
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "profile",
          "draftId",
          "factorProofId",
          "legalProof",
          "preset"
        ],
        "additionalProperties": false
      },
      "enterprise_createResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "enterprise_saveInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "profile": {
            "$ref": "#/components/schemas/EnterpriseProfile"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "factorProofId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "legalProof": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "preset": {
            "$ref": "#/components/schemas/PresetInput"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedBrandRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "adoptPreset": {
            "type": "boolean",
            "default": false
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "enterpriseId",
          "profile",
          "expectedRevision",
          "draftId",
          "factorProofId",
          "legalProof"
        ],
        "additionalProperties": false
      },
      "enterprise_saveResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "enterprise_creditCheckInput": {
        "type": "object",
        "properties": {
          "creditCode": {
            "type": "string"
          },
          "excludeEnterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "creditCode"
        ],
        "additionalProperties": false
      },
      "enterprise_creditCheckResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              }
            },
            "required": [
              "available"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brand_linkEnterpriseInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedOriginalEnterpriseId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          },
          "expectedBrandRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "adoptPreset": {
            "type": "boolean",
            "default": false
          },
          "expectedPresetRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "enterpriseId",
          "expectedOriginalEnterpriseId",
          "expectedBrandRevision"
        ],
        "additionalProperties": false
      },
      "brand_linkEnterpriseResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "brandAdmin_replaceInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "employeeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "proof": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "expectedBrandRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "expectedRelationRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "enterpriseId",
          "name",
          "phone",
          "proof",
          "expectedBrandRevision",
          "expectedRelationRevision"
        ],
        "additionalProperties": false
      },
      "brandAdmin_replaceResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AdminOperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "legacyPassword_rejectInput": {
        "type": "object",
        "properties": {
          "legacyCommand": {
            "type": "string"
          }
        },
        "required": [
          "legacyCommand"
        ],
        "additionalProperties": false
      },
      "legacyPassword_rejectResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "tag_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "tag_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "description": "保留既有canonical ID；不强制改为UUID"
                    },
                    "name": {
                      "type": "string"
                    },
                    "revision": {
                      "type": "string",
                      "pattern": "^[0-9]+$",
                      "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                    },
                    "usageCount": {
                      "type": "string",
                      "pattern": "^[0-9]+$",
                      "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "revision"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "items"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "tag_saveInput": {
        "type": "object",
        "properties": {
          "tagId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "name",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "tag_saveResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "tag_deleteInput": {
        "type": "object",
        "properties": {
          "tagId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "tagId",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "tag_deleteResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "proof_requestInput": {
        "type": "object",
        "properties": {
          "purpose": {
            "type": "string",
            "enum": [
              "legal",
              "administrator"
            ]
          },
          "phone": {
            "type": "string"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "relationRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "purpose",
          "phone"
        ],
        "additionalProperties": false
      },
      "proof_requestResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "challengeId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "maskedPhone": {
                "type": "string"
              }
            },
            "required": [
              "challengeId",
              "expiresAt",
              "maskedPhone"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "proof_verifyInput": {
        "type": "object",
        "properties": {
          "challengeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "otp": {
            "type": "string",
            "pattern": "^[0-9]{6}$"
          }
        },
        "required": [
          "challengeId",
          "otp"
        ],
        "additionalProperties": false
      },
      "proof_verifyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "file_prepareInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "scene": {
            "type": "string",
            "enum": [
              "brand-logo",
              "business-license",
              "legal-front",
              "legal-back"
            ]
          },
          "name": {
            "type": "string"
          },
          "sizeBytes": {
            "type": "integer",
            "minimum": 1
          },
          "mediaType": {
            "type": "string",
            "enum": [
              "image/jpeg",
              "image/png"
            ]
          }
        },
        "required": [
          "scene",
          "name",
          "sizeBytes",
          "mediaType"
        ],
        "additionalProperties": false
      },
      "file_prepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "uploadTicket": {
                "type": "string"
              },
              "policyVersion": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "fileId",
              "uploadTicket",
              "policyVersion"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "file_completeInput": {
        "type": "object",
        "properties": {
          "fileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "ticket": {
            "type": "string"
          }
        },
        "required": [
          "fileId",
          "ticket"
        ],
        "additionalProperties": false
      },
      "file_completeResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "decoded": {
                "type": "boolean"
              },
              "retentionState": {
                "type": "string",
                "enum": [
                  "temporary"
                ]
              }
            },
            "required": [
              "fileId",
              "decoded",
              "retentionState"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "file_viewInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "fileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "enterpriseId",
          "fileId"
        ],
        "additionalProperties": false
      },
      "file_viewResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "accessTicket": {
                "type": "string"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "accessTicket",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "file_downloadInput": {
        "type": "object",
        "properties": {
          "enterpriseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "fileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "enterpriseId",
          "fileId"
        ],
        "additionalProperties": false
      },
      "file_downloadResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "accessTicket": {
                "type": "string"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "accessTicket",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "ocr_extractInput": {
        "type": "object",
        "properties": {
          "fileId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "inputRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "fileId",
          "draftId",
          "inputRevision"
        ],
        "additionalProperties": false
      },
      "ocr_extractResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "requestId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "fields": {
                "type": "object",
                "properties": {
                  "companyName": {
                    "type": "string"
                  },
                  "creditCode": {
                    "type": "string"
                  },
                  "legalName": {
                    "type": "string"
                  },
                  "registeredAddress": {
                    "type": "string"
                  },
                  "registeredCapital": {
                    "type": "string"
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "status": {
                "type": "string"
              }
            },
            "required": [
              "requestId",
              "status"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "factor_verifyInput": {
        "type": "object",
        "properties": {
          "draftId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "inputRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "companyName": {
            "type": "string"
          },
          "creditCode": {
            "type": "string"
          },
          "legalName": {
            "type": "string"
          },
          "legalIdNumber": {
            "type": "string"
          },
          "legalProofId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "draftId",
          "inputRevision",
          "companyName",
          "creditCode",
          "legalName",
          "legalIdNumber",
          "legalProofId"
        ],
        "additionalProperties": false
      },
      "factor_verifyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "requestId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "Code": {
                "type": "string"
              },
              "BizCode": {
                "type": "integer"
              },
              "Status": {
                "type": "integer"
              },
              "factorProofId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "inputRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "requestId",
              "Code",
              "inputRevision"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "privateCode_revealInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "proofId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "proofId",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "privateCode_revealResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "minLength": 16,
                "maxLength": 16
              },
              "displayUntil": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "auditId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              }
            },
            "required": [
              "code",
              "auditId"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "privatePolicy_saveInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "ips": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "brandId",
          "ips",
          "domains",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "privatePolicy_saveResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "privatePolicy_publishInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "draftVersion": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "approvalReference": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "brandId",
          "draftVersion"
        ],
        "additionalProperties": false
      },
      "privatePolicy_publishResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "deployment_testInput": {
        "type": "object",
        "properties": {
          "privateCode": {
            "type": "string",
            "minLength": 16,
            "maxLength": 16
          }
        },
        "required": [
          "privateCode"
        ],
        "additionalProperties": false
      },
      "deployment_testResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "verified": {
                "type": "boolean"
              },
              "nextMode": {
                "type": "string",
                "enum": [
                  "sms"
                ]
              },
              "maskedPhone": {
                "type": "string"
              },
              "testContextId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "verified",
              "testContextId",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "trustedSms_challengeInput": {
        "type": "object",
        "properties": {
          "testContextId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "phone": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "codeChallenge": {
            "type": "string"
          }
        },
        "required": [
          "testContextId",
          "phone",
          "state",
          "codeChallenge"
        ],
        "additionalProperties": false
      },
      "trustedSms_challengeResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "challengeId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "maskedPhone": {
                "type": "string"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "challengeId",
              "maskedPhone",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "trustedSms_verifyInput": {
        "type": "object",
        "properties": {
          "testContextId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "challengeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "otp": {
            "type": "string",
            "pattern": "^[0-9]{6}$"
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "testContextId",
          "challengeId",
          "otp",
          "state"
        ],
        "additionalProperties": false
      },
      "trustedSms_verifyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "oneTimeResultReference": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "oneTimeResultReference",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "privateReveal_challengeInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "brandId"
        ],
        "additionalProperties": false
      },
      "privateReveal_challengeResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "challengeId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "maskedRegisteredPhone": {
                "type": "string"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "challengeId",
              "maskedRegisteredPhone",
              "expiresAt"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "privateReveal_verifyInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "challengeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "otp": {
            "type": "string",
            "pattern": "^[0-9]{6}$"
          }
        },
        "required": [
          "brandId",
          "challengeId",
          "otp"
        ],
        "additionalProperties": false
      },
      "privateReveal_verifyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ProofReference"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "platformLogin_callbackInput": {
        "type": "object",
        "properties": {
          "oneTimeResultReference": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "state": {
            "type": "string"
          },
          "codeVerifier": {
            "type": "string"
          }
        },
        "required": [
          "oneTimeResultReference",
          "state",
          "codeVerifier"
        ],
        "additionalProperties": false
      },
      "platformLogin_callbackResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "sessionEstablished": {
                "type": "boolean"
              },
              "mappingStatus": {
                "type": "string"
              },
              "availableBrands": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "保留既有canonical ID；不强制改为UUID"
                }
              }
            },
            "required": [
              "sessionEstablished",
              "mappingStatus",
              "availableBrands"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "deployment_exchangeInput": {
        "type": "object",
        "properties": {
          "resultReference": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "nonce": {
            "type": "string"
          },
          "requestDigest": {
            "type": "string"
          },
          "instanceProofReference": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "resultReference",
          "nonce",
          "requestDigest",
          "instanceProofReference"
        ],
        "additionalProperties": false
      },
      "deployment_exchangeResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "tenantId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "statusRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "issuedAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "proofValidUntil": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "keyId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "signedProofReference": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              }
            },
            "required": [
              "tenantId",
              "deploymentId",
              "statusRevision",
              "issuedAt",
              "proofValidUntil",
              "keyId",
              "signedProofReference"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "deployment_checkInput": {
        "type": "object",
        "properties": {
          "deploymentId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "nonce": {
            "type": "string"
          },
          "requestDigest": {
            "type": "string"
          },
          "knownStatusRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "challenge": {
            "$ref": "#/components/schemas/StateCheckNonceContext"
          }
        },
        "required": [
          "deploymentId",
          "nonce",
          "requestDigest",
          "knownStatusRevision",
          "challenge"
        ],
        "additionalProperties": false
      },
      "deployment_checkResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "brandStatus": {
                "type": "string",
                "enum": [
                  "active",
                  "inactive"
                ]
              },
              "statusRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "verifiedAt": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "effectiveCapabilities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "signedProofReference": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "signedState": {
                "$ref": "#/components/schemas/SignedPlatformState"
              }
            },
            "required": [
              "brandStatus",
              "statusRevision",
              "verifiedAt",
              "effectiveCapabilities",
              "signedProofReference",
              "signedState"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "securityAudit_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "brandId"
        ],
        "additionalProperties": false
      },
      "securityAudit_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Audit"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "membership_queryInput": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      },
      "membership_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "brandId": {
                      "type": "string",
                      "minLength": 1,
                      "description": "保留既有canonical ID；不强制改为UUID"
                    },
                    "deploymentType": {
                      "type": "string",
                      "enum": [
                        "saas",
                        "private"
                      ]
                    },
                    "employeeId": {
                      "type": "string",
                      "minLength": 1,
                      "description": "保留既有canonical ID；不强制改为UUID"
                    }
                  },
                  "required": [
                    "brandId",
                    "deploymentType",
                    "employeeId"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "items"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "product_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "product_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ProductVersion"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "statusCounts": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                  },
                  "active": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                  },
                  "closed": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                  },
                  "archived": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                  },
                  "deleted": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
                  }
                },
                "required": [
                  "all",
                  "active",
                  "closed",
                  "archived",
                  "deleted"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "product_publishInput": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "trial",
              "formal"
            ]
          },
          "durationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "priceFen": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "currency": {
            "type": "string",
            "enum": [
              "CNY"
            ]
          },
          "unusedValidityDays": {
            "type": "string",
            "nullable": true,
            "pattern": "^[1-9][0-9]*$"
          },
          "expectedVersion": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "name",
          "category",
          "durationDays",
          "priceFen",
          "currency",
          "expectedVersion"
        ],
        "additionalProperties": false
      },
      "product_publishResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ProductVersion"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "product_lifecycleInput": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "productVersion": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "action": {
            "type": "string",
            "enum": [
              "close",
              "open",
              "archive",
              "restore",
              "delete"
            ]
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "productId",
          "productVersion",
          "action",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "product_lifecycleResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "close",
                      "open",
                      "archive",
                      "restore"
                    ]
                  },
                  "product": {
                    "$ref": "#/components/schemas/ProductVersion"
                  },
                  "voidedCount": {
                    "type": "string",
                    "enum": [
                      "0"
                    ]
                  }
                },
                "required": [
                  "action",
                  "product",
                  "voidedCount"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "delete"
                    ]
                  },
                  "operation": {
                    "$ref": "#/components/schemas/OperationResult"
                  }
                },
                "required": [
                  "action",
                  "operation"
                ],
                "additionalProperties": false
              }
            ]
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "code_generateInput": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "productVersion": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "expectedBrandRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "quantity": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "serviceDurationDays": {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "精确正整数十进制字符串；无业务max，服务端严格校验日期计算能力（TECH候选）"
          },
          "redeemDeadline": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          },
          "previewDigest": {
            "type": "string"
          }
        },
        "required": [
          "brandId",
          "productId",
          "productVersion",
          "expectedBrandRevision",
          "quantity",
          "serviceDurationDays",
          "redeemDeadline",
          "previewDigest"
        ],
        "additionalProperties": false
      },
      "code_generateResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "batch": {
                "$ref": "#/components/schemas/Batch"
              },
              "codes": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Code"
                }
              }
            },
            "required": [
              "batch",
              "codes"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "code_assignInput": {
        "type": "object",
        "properties": {
          "codeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedCodeRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "codeId",
          "storeId",
          "expectedCodeRevision"
        ],
        "additionalProperties": false
      },
      "code_assignResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Code"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "code_candidatesInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "storeId"
        ],
        "additionalProperties": false
      },
      "code_candidatesResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CandidateCode"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "code_inventoryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "code_inventoryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Code"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_previewInput": {
        "type": "object",
        "properties": {
          "codeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "codeId"
        ],
        "additionalProperties": false
      },
      "activation_previewResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "codeId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "storeId": {
                "type": "string",
                "minLength": 1,
                "description": "保留既有canonical ID；不强制改为UUID"
              },
              "codeRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "storeRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "currentLicenseId": {
                "type": "string",
                "nullable": true,
                "minLength": 1
              },
              "oldValidTo": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "estimatedValidFrom": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              },
              "estimatedValidTo": {
                "type": "string",
                "format": "date-time",
                "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
              }
            },
            "required": [
              "codeId",
              "storeId",
              "codeRevision",
              "storeRevision",
              "currentLicenseId",
              "estimatedValidFrom",
              "estimatedValidTo"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_acceptInput": {
        "type": "object",
        "properties": {
          "codeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "expectedCodeRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "expectedStoreRevision": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          },
          "expectedCurrentLicenseId": {
            "type": "string",
            "nullable": true,
            "minLength": 1
          }
        },
        "required": [
          "codeId",
          "storeId",
          "expectedCodeRevision",
          "expectedStoreRevision",
          "expectedCurrentLicenseId"
        ],
        "additionalProperties": false
      },
      "activation_acceptResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ActivationRequest"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_resultInput": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "requestId"
        ],
        "additionalProperties": false
      },
      "activation_resultResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ActivationRequest"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_reconcileInput": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "expectedRequestRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "authorityEvidenceReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "requestId",
          "expectedRequestRevision",
          "authorityEvidenceReference"
        ],
        "additionalProperties": false
      },
      "activation_reconcileResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ActivationRequest"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "license_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "storeId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "license_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/StoreLicense"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "license_detailInput": {
        "type": "object",
        "properties": {
          "licenseId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "licenseId"
        ],
        "additionalProperties": false
      },
      "license_detailResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "license": {
                "$ref": "#/components/schemas/StoreLicense"
              },
              "activation": {
                "$ref": "#/components/schemas/ActivationFact"
              },
              "requests": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ActivationRequest"
                }
              },
              "audit": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Audit"
                }
              },
              "batch": {
                "$ref": "#/components/schemas/Batch"
              }
            },
            "required": [
              "license",
              "requests",
              "audit"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "purchase_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "purchase_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Purchase"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "activation_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ActivationFact"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "batch_queryInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "brandId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "batchIdOrAlias": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "batch_queryResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/BatchRow"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "selectedCodes": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Code"
                }
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "product_versionStoresInput": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "cursor": {
            "type": "string"
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "技术建议分页限制，不是业务数量上限"
          },
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "productVersion": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
          }
        },
        "required": [
          "productId",
          "productVersion"
        ],
        "additionalProperties": false
      },
      "product_versionStoresResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/StoreLicense"
                }
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              },
              "visibleTotal": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              },
              "historyScopeNotice": {
                "type": "string"
              }
            },
            "required": [
              "items",
              "visibleTotal"
            ],
            "additionalProperties": false
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "operation_resultInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          }
        },
        "required": [
          "operationId"
        ],
        "additionalProperties": false
      },
      "operation_resultResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "description": "必须带offset；UTC保存，Asia/Shanghai显示；候选毫秒精度，拒绝非精确值"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "DelegationClaims": {
        "type": "object",
        "properties": {
          "issuer": {
            "type": "string",
            "minLength": 1
          },
          "audience": {
            "type": "string",
            "minLength": 1
          },
          "operation": {
            "type": "string",
            "minLength": 1
          },
          "actorId": {
            "type": "string",
            "minLength": 1
          },
          "actorPermissionRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "brandId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "requestRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "nonce": {
            "type": "string",
            "minLength": 1
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "issuer",
          "audience",
          "operation",
          "actorId",
          "actorPermissionRevision",
          "brandId",
          "deploymentId",
          "storeId",
          "requestId",
          "requestRevision",
          "payloadDigest",
          "nonce",
          "expiresAt",
          "keyId",
          "signatureReference"
        ],
        "additionalProperties": false
      },
      "AuthorityEvidenceSuccess": {
        "type": "object",
        "properties": {
          "evidenceId": {
            "type": "string",
            "minLength": 1
          },
          "issuer": {
            "type": "string",
            "minLength": 1
          },
          "audience": {
            "type": "string",
            "minLength": 1
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "brandId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "evidenceRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "nonce": {
            "type": "string",
            "minLength": 1
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          },
          "outcome": {
            "type": "string",
            "enum": [
              "success"
            ]
          },
          "succeededAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "evidenceId",
          "issuer",
          "audience",
          "requestId",
          "codeId",
          "storeId",
          "brandId",
          "deploymentId",
          "payloadDigest",
          "acceptedAt",
          "evidenceRevision",
          "nonce",
          "issuedAt",
          "keyId",
          "signatureReference",
          "outcome",
          "succeededAt"
        ],
        "additionalProperties": false
      },
      "AuthorityEvidenceFailed": {
        "type": "object",
        "properties": {
          "evidenceId": {
            "type": "string",
            "minLength": 1
          },
          "issuer": {
            "type": "string",
            "minLength": 1
          },
          "audience": {
            "type": "string",
            "minLength": 1
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "brandId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "evidenceRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "nonce": {
            "type": "string",
            "minLength": 1
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          },
          "outcome": {
            "type": "string",
            "enum": [
              "failed"
            ]
          },
          "failureReason": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "evidenceId",
          "issuer",
          "audience",
          "requestId",
          "codeId",
          "storeId",
          "brandId",
          "deploymentId",
          "payloadDigest",
          "acceptedAt",
          "evidenceRevision",
          "nonce",
          "issuedAt",
          "keyId",
          "signatureReference",
          "outcome",
          "failureReason"
        ],
        "additionalProperties": false
      },
      "AuthorityEvidence": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/AuthorityEvidenceSuccess"
          },
          {
            "$ref": "#/components/schemas/AuthorityEvidenceFailed"
          }
        ],
        "discriminator": {
          "propertyName": "outcome",
          "mapping": {
            "success": "#/components/schemas/AuthorityEvidenceSuccess",
            "failed": "#/components/schemas/AuthorityEvidenceFailed"
          }
        }
      },
      "activation_reconcileRequestInput": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "expectedRequestRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "authorityEvidenceReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "requestId",
          "expectedRequestRevision",
          "authorityEvidenceReference"
        ],
        "additionalProperties": false
      },
      "activation_reconcileRequestResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "ActivationRequestAccepted": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "accepted"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "both-held"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          }
        },
        "required": [
          "requestId",
          "codeId",
          "storeId",
          "status",
          "acceptedAt",
          "reservationStatus",
          "revision"
        ],
        "additionalProperties": false
      },
      "ActivationRequestUnknown": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "unknown"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "both-held"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          }
        },
        "required": [
          "requestId",
          "codeId",
          "storeId",
          "status",
          "acceptedAt",
          "reservationStatus",
          "revision"
        ],
        "additionalProperties": false
      },
      "ActivationRequestSuccess": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "success"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "consumed"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "succeededAt": {
            "type": "string",
            "format": "date-time"
          },
          "license": {
            "$ref": "#/components/schemas/StoreLicense"
          },
          "auditReference": {
            "type": "string",
            "minLength": 1
          },
          "authorityEvidenceReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "requestId",
          "codeId",
          "storeId",
          "status",
          "acceptedAt",
          "reservationStatus",
          "revision",
          "succeededAt",
          "license",
          "auditReference",
          "authorityEvidenceReference"
        ],
        "additionalProperties": false
      },
      "ActivationRequestFailed": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "failed"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "released"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "failureReason": {
            "type": "string",
            "minLength": 1
          },
          "authorityEvidenceReference": {
            "type": "string",
            "minLength": 1
          },
          "auditReference": {
            "type": "string",
            "minLength": 1
          },
          "retainedCurrentLicenseId": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "requestId",
          "codeId",
          "storeId",
          "status",
          "acceptedAt",
          "reservationStatus",
          "revision",
          "failureReason",
          "authorityEvidenceReference",
          "auditReference",
          "retainedCurrentLicenseId"
        ],
        "additionalProperties": false
      },
      "OperationPending": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "preparing",
              "prepared",
              "commit-decided",
              "applying",
              "abort-decided",
              "recovery-blocked"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "replayed": {
            "type": "boolean"
          },
          "recovery": {
            "type": "object",
            "properties": {
              "owner": {
                "type": "string",
                "enum": [
                  "platform"
                ]
              },
              "queryOperationId": {
                "type": "string",
                "minLength": 1
              },
              "retrySameKey": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            },
            "required": [
              "owner",
              "queryOperationId",
              "retrySameKey"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "operationId",
          "operationKind",
          "status",
          "revision",
          "replayed",
          "recovery"
        ],
        "additionalProperties": false
      },
      "OperationPublished": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "published"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "replayed": {
            "type": "boolean"
          },
          "publicationReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "resultId": {
            "type": "string",
            "minLength": 1
          },
          "administrator": {
            "$ref": "#/components/schemas/Administrator"
          }
        },
        "required": [
          "operationId",
          "operationKind",
          "status",
          "revision",
          "replayed",
          "publicationReceiptReference",
          "resultId"
        ],
        "additionalProperties": false
      },
      "OperationAborted": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "aborted"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "replayed": {
            "type": "boolean"
          },
          "failureReason": {
            "type": "string",
            "minLength": 1
          },
          "abortReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "businessEffectsVisible": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "operationId",
          "operationKind",
          "status",
          "revision",
          "replayed",
          "failureReason",
          "abortReceiptReference",
          "businessEffectsVisible"
        ],
        "additionalProperties": false
      },
      "AdminOperationPublished": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "type": "string",
            "enum": [
              "published"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "replayed": {
            "type": "boolean"
          },
          "publicationReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "resultId": {
            "type": "string",
            "minLength": 1
          },
          "administrator": {
            "$ref": "#/components/schemas/Administrator"
          }
        },
        "required": [
          "operationId",
          "operationKind",
          "status",
          "revision",
          "replayed",
          "publicationReceiptReference",
          "resultId",
          "administrator"
        ],
        "additionalProperties": false
      },
      "AdminOperationResult": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/OperationPending"
          },
          {
            "$ref": "#/components/schemas/AdminOperationPublished"
          },
          {
            "$ref": "#/components/schemas/OperationAborted"
          }
        ],
        "discriminator": {
          "propertyName": "status"
        }
      },
      "OriginalWriteRecoveryById": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "resultOwner": {
            "type": "string",
            "enum": [
              "platform"
            ]
          },
          "safeAction": {
            "type": "string",
            "enum": [
              "query-original"
            ]
          }
        },
        "required": [
          "operationId",
          "resultOwner",
          "safeAction"
        ],
        "additionalProperties": false
      },
      "OriginalWriteRecoveryByKey": {
        "type": "object",
        "properties": {
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1
          },
          "resultOwner": {
            "type": "string",
            "enum": [
              "platform"
            ]
          },
          "safeAction": {
            "type": "string",
            "enum": [
              "query-original",
              "retry-same-key"
            ]
          }
        },
        "required": [
          "operationKind",
          "targetScope",
          "idempotencyKey",
          "resultOwner",
          "safeAction"
        ],
        "additionalProperties": false
      },
      "PendingWriteError": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "requestId": {
            "type": "string",
            "minLength": 1,
            "description": "保留既有canonical ID；不强制改为UUID"
          },
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              },
              "currentRevision": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "PG bigint版本用十进制字符串传输避免JS精度损失（TECH候选）"
              }
            },
            "required": [
              "code",
              "message",
              "retryable"
            ],
            "additionalProperties": false
          },
          "recovery": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/OriginalWriteRecoveryById"
              },
              {
                "$ref": "#/components/schemas/OriginalWriteRecoveryByKey"
              }
            ]
          }
        },
        "required": [
          "ok",
          "requestId",
          "error",
          "recovery"
        ],
        "additionalProperties": false
      },
      "TransactionEnvelope": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "intentDigest": {
            "type": "string",
            "minLength": 1
          },
          "expectedEntityVersions": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "pattern": "^[0-9]+$"
            }
          },
          "actorDelegationReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "operationKind",
          "payloadDigest",
          "coordinatorEpoch",
          "participantId",
          "intentDigest",
          "expectedEntityVersions",
          "actorDelegationReference"
        ],
        "additionalProperties": false
      },
      "PrepareReceipt": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "intentDigest": {
            "type": "string",
            "minLength": 1
          },
          "reservedEntityVersions": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "pattern": "^[0-9]+$"
            }
          },
          "authorizationRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "preparedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "receiptReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "payloadDigest",
          "coordinatorEpoch",
          "intentDigest",
          "reservedEntityVersions",
          "authorizationRevision",
          "preparedRevision",
          "receiptReference"
        ],
        "additionalProperties": false
      },
      "DecisionReceipt": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decision": {
            "type": "string",
            "enum": [
              "commit",
              "abort"
            ]
          },
          "decisionRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "participantReceiptDigests": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "authoritySignatureReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "decision",
          "decisionRevision",
          "coordinatorEpoch",
          "payloadDigest",
          "participantReceiptDigests",
          "authoritySignatureReference"
        ],
        "additionalProperties": false
      },
      "RecoveryClaim": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "previousCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "newCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "payloadDigest": {
                "type": "string",
                "minLength": 1
              },
              "targetScope": {
                "type": "string",
                "minLength": 1
              },
              "claimReceiptReference": {
                "type": "string",
                "minLength": 1
              },
              "authoritySignatureReference": {
                "type": "string",
                "minLength": 1
              },
              "previousState": {
                "type": "string",
                "enum": [
                  "preparing",
                  "prepared"
                ]
              },
              "decision": {
                "type": "string",
                "enum": [
                  "none"
                ]
              },
              "expectedVersions": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/EntityVersionBinding"
                },
                "minItems": 1,
                "uniqueItems": true
              }
            },
            "required": [
              "operationId",
              "previousCoordinatorEpoch",
              "newCoordinatorEpoch",
              "payloadDigest",
              "targetScope",
              "claimReceiptReference",
              "authoritySignatureReference",
              "previousState",
              "decision",
              "expectedVersions"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "previousCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "newCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "payloadDigest": {
                "type": "string",
                "minLength": 1
              },
              "targetScope": {
                "type": "string",
                "minLength": 1
              },
              "claimReceiptReference": {
                "type": "string",
                "minLength": 1
              },
              "authoritySignatureReference": {
                "type": "string",
                "minLength": 1
              },
              "previousState": {
                "type": "string",
                "enum": [
                  "commit-decided",
                  "applying",
                  "published",
                  "recovery-blocked"
                ]
              },
              "decision": {
                "type": "string",
                "enum": [
                  "commit"
                ]
              },
              "previousDecisionRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "decisionDigest": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "operationId",
              "previousCoordinatorEpoch",
              "newCoordinatorEpoch",
              "payloadDigest",
              "targetScope",
              "claimReceiptReference",
              "authoritySignatureReference",
              "previousState",
              "decision",
              "previousDecisionRevision",
              "decisionDigest"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "previousCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "newCoordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "payloadDigest": {
                "type": "string",
                "minLength": 1
              },
              "targetScope": {
                "type": "string",
                "minLength": 1
              },
              "claimReceiptReference": {
                "type": "string",
                "minLength": 1
              },
              "authoritySignatureReference": {
                "type": "string",
                "minLength": 1
              },
              "previousState": {
                "type": "string",
                "enum": [
                  "abort-decided",
                  "aborted"
                ]
              },
              "decision": {
                "type": "string",
                "enum": [
                  "abort"
                ]
              },
              "previousDecisionRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "decisionDigest": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "operationId",
              "previousCoordinatorEpoch",
              "newCoordinatorEpoch",
              "payloadDigest",
              "targetScope",
              "claimReceiptReference",
              "authoritySignatureReference",
              "previousState",
              "decision",
              "previousDecisionRevision",
              "decisionDigest"
            ],
            "additionalProperties": false
          }
        ]
      },
      "ParticipantStatus": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "state": {
            "type": "string",
            "enum": [
              "absent",
              "prepared",
              "applied-hidden",
              "aborted",
              "published"
            ]
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "intentDigest": {
            "type": "string",
            "minLength": 1
          },
          "receiptReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "state",
          "coordinatorEpoch",
          "intentDigest"
        ],
        "additionalProperties": false
      },
      "transaction_platform_prepareInput": {
        "$ref": "#/components/schemas/TransactionEnvelope"
      },
      "transaction_platform_prepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PrepareReceipt"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_platform_applyInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_platform_applyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_platform_abortInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_platform_abortResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_platform_statusInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch"
        ],
        "additionalProperties": false
      },
      "transaction_platform_statusResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_business_prepareInput": {
        "$ref": "#/components/schemas/TransactionEnvelope"
      },
      "transaction_business_prepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PrepareReceipt"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_business_applyInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_business_applyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_business_abortInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_business_abortResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_business_statusInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch"
        ],
        "additionalProperties": false
      },
      "transaction_business_statusResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_public_prepareInput": {
        "$ref": "#/components/schemas/TransactionEnvelope"
      },
      "transaction_public_prepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PrepareReceipt"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_public_applyInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_public_applyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_public_abortInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "transaction_public_abortResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_public_statusInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "recoveryClaimReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "participantId",
          "coordinatorEpoch"
        ],
        "additionalProperties": false
      },
      "transaction_public_statusResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ParticipantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_recoveryClaimInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "expectedCoordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          }
        },
        "required": [
          "operationId",
          "expectedCoordinatorEpoch"
        ],
        "additionalProperties": false
      },
      "transaction_recoveryClaimResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/RecoveryClaim"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "transaction_publicationInput": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "requiredReadRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          }
        },
        "required": [
          "operationId"
        ],
        "additionalProperties": false
      },
      "transaction_publicationResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PublicationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "operation_resolveInput": {
        "type": "object",
        "properties": {
          "operationKind": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationKind",
          "targetScope",
          "idempotencyKey"
        ],
        "additionalProperties": false
      },
      "operation_resolveResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "GrantStatus": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "grantId": {
                "type": "string",
                "minLength": 1
              },
              "codeId": {
                "type": "string",
                "minLength": 1
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1
              },
              "revision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "fenceVersion": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "unknown"
                ]
              },
              "historyKnowledge": {
                "type": "string",
                "enum": [
                  "unknown"
                ]
              },
              "everBound": {
                "type": "boolean",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "historyEvidenceReference": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "assignedStoreId": {
                "type": "string",
                "nullable": true
              },
              "consumedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "voidedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "heldRequestId": {
                "type": "string",
                "nullable": true
              },
              "receiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "grantId",
              "codeId",
              "deploymentId",
              "revision",
              "fenceVersion",
              "state",
              "historyKnowledge",
              "everBound",
              "historyEvidenceReference",
              "assignedStoreId",
              "consumedAt",
              "voidedAt"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "grantId": {
                "type": "string",
                "minLength": 1
              },
              "codeId": {
                "type": "string",
                "minLength": 1
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1
              },
              "revision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "fenceVersion": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "prepared",
                  "active",
                  "revoke-prepared"
                ]
              },
              "historyKnowledge": {
                "type": "string",
                "enum": [
                  "never"
                ]
              },
              "everBound": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "historyEvidenceReference": {
                "type": "string",
                "minLength": 1
              },
              "assignedStoreId": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "consumedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "voidedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "heldRequestId": {
                "type": "string",
                "nullable": true
              },
              "receiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "grantId",
              "codeId",
              "deploymentId",
              "revision",
              "fenceVersion",
              "state",
              "historyKnowledge",
              "everBound",
              "historyEvidenceReference",
              "assignedStoreId",
              "consumedAt",
              "voidedAt"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "grantId": {
                "type": "string",
                "minLength": 1
              },
              "codeId": {
                "type": "string",
                "minLength": 1
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1
              },
              "revision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "fenceVersion": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "prepared",
                  "active"
                ]
              },
              "historyKnowledge": {
                "type": "string",
                "enum": [
                  "ever"
                ]
              },
              "everBound": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "historyEvidenceReference": {
                "type": "string",
                "minLength": 1
              },
              "assignedStoreId": {
                "type": "string",
                "nullable": true
              },
              "consumedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "voidedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "heldRequestId": {
                "type": "string",
                "nullable": true
              },
              "receiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "grantId",
              "codeId",
              "deploymentId",
              "revision",
              "fenceVersion",
              "state",
              "historyKnowledge",
              "everBound",
              "historyEvidenceReference",
              "assignedStoreId",
              "consumedAt",
              "voidedAt"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "grantId": {
                "type": "string",
                "minLength": 1
              },
              "codeId": {
                "type": "string",
                "minLength": 1
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1
              },
              "revision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "fenceVersion": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "revoked"
                ]
              },
              "historyKnowledge": {
                "type": "string",
                "enum": [
                  "never"
                ]
              },
              "everBound": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "historyEvidenceReference": {
                "type": "string",
                "minLength": 1
              },
              "assignedStoreId": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "consumedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "voidedAt": {
                "type": "string",
                "format": "date-time"
              },
              "heldRequestId": {
                "type": "string",
                "nullable": true
              },
              "receiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "grantId",
              "codeId",
              "deploymentId",
              "revision",
              "fenceVersion",
              "state",
              "historyKnowledge",
              "everBound",
              "historyEvidenceReference",
              "assignedStoreId",
              "consumedAt",
              "voidedAt",
              "receiptReference"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "grantId": {
                "type": "string",
                "minLength": 1
              },
              "codeId": {
                "type": "string",
                "minLength": 1
              },
              "deploymentId": {
                "type": "string",
                "minLength": 1
              },
              "revision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "fenceVersion": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "consumed"
                ]
              },
              "historyKnowledge": {
                "type": "string",
                "enum": [
                  "ever"
                ]
              },
              "everBound": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "historyEvidenceReference": {
                "type": "string",
                "minLength": 1
              },
              "assignedStoreId": {
                "type": "string",
                "nullable": true
              },
              "consumedAt": {
                "type": "string",
                "format": "date-time"
              },
              "voidedAt": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "heldRequestId": {
                "type": "string",
                "nullable": true
              },
              "receiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "grantId",
              "codeId",
              "deploymentId",
              "revision",
              "fenceVersion",
              "state",
              "historyKnowledge",
              "everBound",
              "historyEvidenceReference",
              "assignedStoreId",
              "consumedAt",
              "voidedAt"
            ],
            "additionalProperties": false
          }
        ],
        "description": "unknown: everBound=null/historyEvidenceReference=null，旧原始事实保留不推never，阻accept/assign/revoke/delete。never/ever必须权威历史证据；false仅never，true仅ever，不能回退unknown事实覆盖已知。服务核证据及持久grant版本，形状不等权威验证。"
      },
      "grant_prepareInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId",
          "signedGrantReference"
        ],
        "additionalProperties": false
      },
      "grant_prepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "grant_deliverInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId",
          "signedGrantReference"
        ],
        "additionalProperties": false
      },
      "grant_deliverResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "grant_statusInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId"
        ],
        "additionalProperties": false
      },
      "grant_statusResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "grant_revokePrepareInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId"
        ],
        "additionalProperties": false
      },
      "grant_revokePrepareResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "grant_revokeApplyInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "grant_revokeApplyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "grant_revokeAbortInput": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "codeId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "expectedGrantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "fenceVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "decisionReceiptReference": {
            "type": "string",
            "minLength": 1
          },
          "signedGrantReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "grantId",
          "codeId",
          "deploymentId",
          "expectedGrantRevision",
          "fenceVersion",
          "operationId",
          "decisionReceiptReference"
        ],
        "additionalProperties": false
      },
      "grant_revokeAbortResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/GrantStatus"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "product_deleteIntentInput": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "minLength": 1
          },
          "productVersion": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          }
        },
        "required": [
          "productId",
          "productVersion",
          "expectedRevision"
        ],
        "additionalProperties": false
      },
      "product_deleteIntentResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/OperationResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "activation_resolveKeyInput": {
        "type": "object",
        "properties": {
          "storeId": {
            "type": "string",
            "minLength": 1
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "storeId",
          "idempotencyKey"
        ],
        "additionalProperties": false
      },
      "activation_resolveKeyResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ActivationRequest"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "EntityVersionBinding": {
        "type": "object",
        "properties": {
          "entityKind": {
            "type": "string",
            "minLength": 1
          },
          "entityId": {
            "type": "string",
            "minLength": 1
          },
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "entityRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "operationId": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "entityKind",
          "entityId",
          "participantId",
          "entityRevision",
          "payloadDigest",
          "operationId"
        ],
        "additionalProperties": false
      },
      "ParticipantAppliedBinding": {
        "type": "object",
        "properties": {
          "participantId": {
            "type": "string",
            "minLength": 1
          },
          "intentDigest": {
            "type": "string",
            "minLength": 1
          },
          "appliedDigest": {
            "type": "string",
            "minLength": 1
          },
          "appliedReceiptReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "participantId",
          "intentDigest",
          "appliedDigest",
          "appliedReceiptReference"
        ],
        "additionalProperties": false
      },
      "PublicationReceipt": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          },
          "payloadDigest": {
            "type": "string",
            "minLength": 1
          },
          "decisionRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "decisionDigest": {
            "type": "string",
            "minLength": 1
          },
          "coordinatorEpoch": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "publishedRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "entityVersions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EntityVersionBinding"
            },
            "minItems": 1,
            "uniqueItems": true
          },
          "participants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ParticipantAppliedBinding"
            },
            "minItems": 1,
            "uniqueItems": true
          },
          "issuer": {
            "type": "string",
            "enum": [
              "platform-publication-authority"
            ]
          },
          "audience": {
            "type": "string",
            "enum": [
              "registered-participant"
            ]
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "targetScope",
          "payloadDigest",
          "decisionRevision",
          "decisionDigest",
          "coordinatorEpoch",
          "publishedRevision",
          "entityVersions",
          "participants",
          "issuer",
          "audience",
          "keyId",
          "issuedAt",
          "signatureReference"
        ],
        "additionalProperties": false
      },
      "PublicationResult": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "status": {
                "type": "string",
                "enum": [
                  "pending"
                ]
              },
              "coordinatorEpoch": {
                "type": "string",
                "pattern": "^[0-9]+$"
              }
            },
            "required": [
              "operationId",
              "status",
              "coordinatorEpoch"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "status": {
                "type": "string",
                "enum": [
                  "aborted"
                ]
              },
              "decisionRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "decisionDigest": {
                "type": "string",
                "minLength": 1
              },
              "abortReceiptReference": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "operationId",
              "status",
              "decisionRevision",
              "decisionDigest",
              "abortReceiptReference"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operationId": {
                "type": "string",
                "minLength": 1
              },
              "status": {
                "type": "string",
                "enum": [
                  "published"
                ]
              },
              "publicationReceiptReference": {
                "type": "string",
                "minLength": 1
              },
              "participantAppliedDigests": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "minItems": 1,
                "uniqueItems": true
              },
              "publishedRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "receipt": {
                "$ref": "#/components/schemas/PublicationReceipt"
              }
            },
            "required": [
              "operationId",
              "status",
              "publicationReceiptReference",
              "participantAppliedDigests",
              "publishedRevision",
              "receipt"
            ],
            "additionalProperties": false
          }
        ]
      },
      "CurrentPublicationQuery": {
        "type": "object",
        "properties": {
          "targetScope": {
            "type": "string",
            "minLength": 1
          },
          "entities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "entityKind": {
                  "type": "string",
                  "minLength": 1
                },
                "entityId": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "entityKind",
                "entityId"
              ],
              "additionalProperties": false
            },
            "minItems": 1,
            "uniqueItems": true
          },
          "requestNonce": {
            "type": "string",
            "minLength": 1
          },
          "readPurpose": {
            "type": "string",
            "enum": [
              "business-read",
              "authorization",
              "protected-submit"
            ]
          }
        },
        "required": [
          "targetScope",
          "entities",
          "requestNonce",
          "readPurpose"
        ],
        "additionalProperties": false
      },
      "CurrentPublicationBundle": {
        "type": "object",
        "properties": {
          "targetScope": {
            "type": "string",
            "minLength": 1
          },
          "snapshotRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "requestNonce": {
            "type": "string",
            "minLength": 1
          },
          "entityVersions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EntityVersionBinding"
            },
            "minItems": 1,
            "uniqueItems": true
          },
          "publicationReceipts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicationReceipt"
            },
            "minItems": 1,
            "uniqueItems": true
          },
          "issuer": {
            "type": "string",
            "enum": [
              "platform-publication-authority"
            ]
          },
          "audience": {
            "type": "string",
            "enum": [
              "registered-participant"
            ]
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "targetScope",
          "snapshotRevision",
          "requestNonce",
          "entityVersions",
          "publicationReceipts",
          "issuer",
          "audience",
          "keyId",
          "issuedAt",
          "expiresAt",
          "signatureReference"
        ],
        "additionalProperties": false
      },
      "transaction_currentPublicationInput": {
        "$ref": "#/components/schemas/CurrentPublicationQuery"
      },
      "transaction_currentPublicationResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CurrentPublicationBundle"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "GrantSetMember": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "minLength": 1
          },
          "grantRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "grantDigest": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "$ref": "#/components/schemas/GrantStatus"
          }
        },
        "required": [
          "grantId",
          "grantRevision",
          "deploymentId",
          "grantDigest",
          "status"
        ],
        "additionalProperties": false
      },
      "FrozenGrantSet": {
        "type": "object",
        "properties": {
          "operationId": {
            "type": "string",
            "minLength": 1
          },
          "productVersionId": {
            "type": "string",
            "minLength": 1
          },
          "versionRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "lifecycleFence": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GrantSetMember"
            },
            "uniqueItems": true
          },
          "membershipDigest": {
            "type": "string",
            "minLength": 1
          },
          "completeHistoryProofReference": {
            "type": "string",
            "minLength": 1
          },
          "freezeReceiptReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "operationId",
          "productVersionId",
          "versionRevision",
          "lifecycleFence",
          "members",
          "membershipDigest",
          "completeHistoryProofReference",
          "freezeReceiptReference"
        ],
        "additionalProperties": false,
        "description": "成员读取携同版GrantStatus；status ID/revision与member相等服务器必核。unknown可供排查但不得准备删除；全成员never且完整证据才能决定。"
      },
      "StateCheckNonceContext": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "nonce": {
            "type": "string",
            "minLength": 1
          },
          "brandId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "consumer": {
            "type": "string",
            "enum": [
              "business",
              "public",
              "payment"
            ]
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "requestId",
          "nonce",
          "brandId",
          "deploymentId",
          "consumer",
          "issuedAt",
          "expiresAt"
        ],
        "additionalProperties": false
      },
      "SignedPlatformState": {
        "type": "object",
        "properties": {
          "brandId": {
            "type": "string",
            "minLength": 1
          },
          "deploymentId": {
            "type": "string",
            "minLength": 1
          },
          "brandStatus": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ]
          },
          "statusRevision": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "stateDigest": {
            "type": "string",
            "minLength": 1
          },
          "effectiveCapabilities": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "uniqueItems": true
          },
          "challenge": {
            "$ref": "#/components/schemas/StateCheckNonceContext"
          },
          "verifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "issuer": {
            "type": "string",
            "enum": [
              "platform-state-authority"
            ]
          },
          "audience": {
            "type": "string",
            "enum": [
              "business",
              "public",
              "payment"
            ]
          },
          "keyId": {
            "type": "string",
            "minLength": 1
          },
          "signatureReference": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "brandId",
          "deploymentId",
          "brandStatus",
          "statusRevision",
          "stateDigest",
          "effectiveCapabilities",
          "challenge",
          "verifiedAt",
          "issuedAt",
          "expiresAt",
          "issuer",
          "audience",
          "keyId",
          "signatureReference"
        ],
        "additionalProperties": false
      },
      "ConsumerStateBarrierResult": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "permitted"
                ]
              },
              "proof": {
                "$ref": "#/components/schemas/SignedPlatformState"
              },
              "requestId": {
                "type": "string",
                "minLength": 1
              },
              "currentRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              }
            },
            "required": [
              "status",
              "proof",
              "requestId",
              "currentRevision"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "restricted"
                ]
              },
              "proof": {
                "$ref": "#/components/schemas/SignedPlatformState"
              },
              "requestId": {
                "type": "string",
                "minLength": 1
              },
              "currentRevision": {
                "type": "string",
                "pattern": "^[0-9]+$"
              },
              "reason": {
                "type": "string",
                "enum": [
                  "inactive",
                  "capability-denied"
                ]
              }
            },
            "required": [
              "status",
              "proof",
              "requestId",
              "currentRevision",
              "reason"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "unknown"
                ]
              },
              "requestId": {
                "type": "string",
                "minLength": 1
              },
              "reason": {
                "type": "string",
                "enum": [
                  "unavailable",
                  "invalid-proof",
                  "stale-version",
                  "expired-challenge"
                ]
              }
            },
            "required": [
              "status",
              "requestId",
              "reason"
            ],
            "additionalProperties": false
          }
        ]
      },
      "state_business_barrierInput": {
        "type": "object",
        "properties": {
          "challenge": {
            "$ref": "#/components/schemas/StateCheckNonceContext"
          },
          "action": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "challenge",
          "action",
          "targetScope"
        ],
        "additionalProperties": false
      },
      "state_business_barrierResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ConsumerStateBarrierResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "state_public_barrierInput": {
        "type": "object",
        "properties": {
          "challenge": {
            "$ref": "#/components/schemas/StateCheckNonceContext"
          },
          "action": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "challenge",
          "action",
          "targetScope"
        ],
        "additionalProperties": false
      },
      "state_public_barrierResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ConsumerStateBarrierResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      },
      "state_payment_barrierInput": {
        "type": "object",
        "properties": {
          "challenge": {
            "$ref": "#/components/schemas/StateCheckNonceContext"
          },
          "action": {
            "type": "string",
            "minLength": 1
          },
          "targetScope": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "challenge",
          "action",
          "targetScope"
        ],
        "additionalProperties": false
      },
      "state_payment_barrierResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ConsumerStateBarrierResult"
          },
          "requestId": {
            "type": "string",
            "minLength": 1
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "ok",
          "data",
          "requestId",
          "serverTime"
        ],
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "sessionAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "用户可信会话；Blade CSRF/session适配待TECH"
      },
      "serviceIdentity": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "仅预注册服务issuer；严格算法/签名/iss/aud/exp/nbf/jti与sender实例持有证明；不是用户session。"
      }
    }
  },
  "x-status": "TECH_REVIEW_REQUIRED",
  "x-no-execution": true,
  "x-reviewed-fixes": [
    "R01",
    "R02",
    "R03",
    "R04",
    "R05",
    "R07"
  ]
}
