{
  "openapi": "3.0.3",
  "info": {
    "title": "爱尔思综合管理系统 API",
    "version": "1.0.0",
    "description": "# 爱尔思综合管理系统 REST API 文档\n\n本文档描述爱尔思综合管理系统的所有REST API端点，包括请求参数、响应格式和错误处理。\n\n## 认证方式\n\n系统使用JWT Token进行认证：\n\n1. 调用 `/api/auth/login` 获取Token\n2. 在后续请求的Header中添加：`Authorization: Bearer <token>`\n3. Token有效期为24小时，可通过 `/api/auth/refresh` 刷新\n\n## 通用响应格式\n\n### 成功响应\n```json\n{\n    \"success\": true,\n    \"data\": {},\n    \"message\": \"操作成功\"\n}\n```\n\n### 错误响应\n```json\n{\n    \"success\": false,\n    \"error\": {\n        \"code\": \"ERROR_CODE\",\n        \"message\": \"错误描述\",\n        \"details\": {}\n    }\n}\n```\n\n## 错误代码\n\n| 代码 | 说明 | HTTP状态码 |\n|------|------|-----------|\n| AUTH_001 | 认证失败 | 401 |\n| AUTH_002 | Token过期 | 401 |\n| AUTH_003 | 权限不足 | 403 |\n| VALID_001 | 参数验证失败 | 400 |\n| DB_001 | 数据库错误 | 500 |\n| BIZ_001 | 业务逻辑错误 | 400 |\n\n## 数据范围权限\n\n系统支持三种数据范围：\n- **all**: 查看所有数据\n- **dept**: 仅查看本部门数据\n- **self**: 仅查看本人创建的数据\n\n数据范围由用户角色权限决定，API会自动应用过滤。\n\n## 分页参数\n\n列表查询支持分页：\n- `page`: 页码（从1开始）\n- `page_size`: 每页记录数（默认20，最大100）\n\n注意：部分列表接口默认 `page_size=9999` 以配合前端 DataTable 客户端分页。\n\n## 排序参数\n\n列表查询支持排序：\n- `ordering`: 排序字段（如：`created_at`）\n- 降序排序：在字段前加 `-`（如：`-created_at`）\n\n## 多数据库架构\n\n系统使用多数据库架构：\n- **default** 数据库：用户、角色、权限、部门、工作流定义等核心模型\n- **tenant** 数据库：所有业务数据（销售、采购、库存、生产、质量等）\n\n业务模型查询统一使用 `.using('tenant')`，事务使用 `@transaction.atomic(using='tenant')`。\n\n## 审批工作流\n\n业务单据（销售合同/订单/发货/退货、采购申请/订单/合同/付款、生产计划/BOM/工艺/工单/维保/停机、质量异常等）\n通过 `WorkflowEngine.submit(business_type, business_id, ...)` 提交审批，由 `ModuleWorkflowConfig` 配置\n对应模块使用的工作流定义。\n\n## 业务类型对照\n\n| business_type | 说明 |\n|---|---|\n| sales_contract | 销售合同 |\n| sales_order | 销售订单 |\n| sales_shipment | 销售发货 |\n| sales_return | 销售退货 |\n| sales_opportunity | 销售商机 |\n| sales_quotation | 销售报价 |\n| purchase_request | 采购申请 |\n| purchase_order | 采购订单 |\n| purchase_contract | 采购合同 |\n| purchase_payment | 采购付款 |\n| purchase_return | 采购退货 |\n| production_plan | 生产计划 |\n| production_work_order | 生产工单 |\n| bom_change | BOM变更 |\n| routing_change | 工艺变更 |\n| equipment_maintenance | 设备维保 |\n| equipment_downtime | 设备停机 |\n| quality_exception | 质量异常 |\n",
    "contact": {
      "name": "R&D Management System",
      "email": "support@example.com"
    },
    "license": {
      "name": "Proprietary"
    }
  },
  "servers": [
    {
      "url": "/",
      "description": "相对路径（与部署域名拼接）"
    }
  ],
  "tags": [
    {
      "name": "Authentication",
      "description": "用户认证与授权"
    },
    {
      "name": "Users",
      "description": "用户管理"
    },
    {
      "name": "Departments",
      "description": "部门管理"
    },
    {
      "name": "Roles",
      "description": "角色管理"
    },
    {
      "name": "Permissions",
      "description": "权限管理"
    },
    {
      "name": "Branches",
      "description": "分支机构和分公司管理"
    },
    {
      "name": "Notifications",
      "description": "通知消息"
    },
    {
      "name": "Attendance",
      "description": "考勤打卡"
    },
    {
      "name": "BankAccounts",
      "description": "银行账户"
    },
    {
      "name": "Approval",
      "description": "审批工作流定义与配置"
    },
    {
      "name": "ApprovalEngine",
      "description": "审批流程引擎（提交/审批/驳回/转办）"
    },
    {
      "name": "ApprovalAdmin",
      "description": "审批管理后台操作"
    },
    {
      "name": "Projects",
      "description": "研发项目管理"
    },
    {
      "name": "Tasks",
      "description": "项目任务管理"
    },
    {
      "name": "Milestones",
      "description": "项目里程碑"
    },
    {
      "name": "Sales",
      "description": "销售订单与客户管理"
    },
    {
      "name": "SalesExtended",
      "description": "销售扩展（发货/退货/回款/批次/联系人）"
    },
    {
      "name": "SalesCRM",
      "description": "销售CRM（客户360、商机、报价、合同、回款、对账、分析）"
    },
    {
      "name": "Purchasing",
      "description": "采购管理（供应商/询价/订单/合同/付款/发票/退货/渠道）"
    },
    {
      "name": "Inventory",
      "description": "库存管理（物料/仓库/出入库/调拨/盘点/预警/跨账本）"
    },
    {
      "name": "MES",
      "description": "制造执行系统（计划/BOM/工艺/工作中心/工单/报工/质量/设备/维保/停机/批次/消耗）"
    },
    {
      "name": "Quality",
      "description": "质量管理（系统模板/计划/要求/证据/APQP/FMEA/控制计划/PPAP/审核/NCR/CAPA/MSA/SPC）"
    },
    {
      "name": "Office",
      "description": "办公管理（公告/日程/办公用品/印章/申请/资产/费用/薪资/物流/人事）"
    },
    {
      "name": "Documents",
      "description": "技术文档管理"
    },
    {
      "name": "Drawings",
      "description": "图纸管理与借阅"
    },
    {
      "name": "Training",
      "description": "培训管理"
    },
    {
      "name": "Meetings",
      "description": "会议纪要管理"
    },
    {
      "name": "Experiments",
      "description": "实验标准与向导体系"
    },
    {
      "name": "SRM",
      "description": "供应商关系管理（准入/资质/考核/绩效/收货/对账/价格库/招投标）"
    },
    {
      "name": "Portal",
      "description": "供应商门户"
    },
    {
      "name": "SOP",
      "description": "标准作业流程（工艺路线/SOP文档/BOM）"
    },
    {
      "name": "Product",
      "description": "产品类别与物料管理"
    },
    {
      "name": "WorkOrders",
      "description": "通用工单（跨部门派工/SLA）"
    },
    {
      "name": "Todos",
      "description": "待办事项"
    },
    {
      "name": "Categories",
      "description": "分类管理（通用分类组与选项）"
    },
    {
      "name": "Performance",
      "description": "性能监控"
    },
    {
      "name": "SystemConfig",
      "description": "系统配置"
    }
  ],
  "paths": {
    "/api/auth/login": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "用户登录",
        "description": "通过用户名密码获取JWT Token",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "username": "testuser",
                "password": "******"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "登录成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "登录成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
                  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
                  "expires_in": 86400
                }
              }
            }
          },
          "400": {
            "description": "用户名或密码错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "用户名或密码错误"
                  }
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/api/auth/logout": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "用户登出",
        "responses": {
          "200": {
            "description": "登出成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "登出成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/refresh": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "刷新Token",
        "description": "使用refresh_token获取新的access_token",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "refresh_token": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "刷新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "刷新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "token": "...",
                  "expires_in": 86400
                }
              }
            }
          },
          "401": {
            "description": "未认证或Token无效",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "未认证或Token无效"
                  }
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/api/auth/me": {
      "get": {
        "tags": [
          "Authentication"
        ],
        "summary": "获取当前用户信息",
        "responses": {
          "200": {
            "description": "当前用户信息",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "当前用户信息"
                    },
                    "data": {
                      "$ref": "#/components/schemas/User"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未认证或Token无效",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "未认证或Token无效"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/current-user/": {
      "get": {
        "tags": [
          "Authentication"
        ],
        "summary": "获取当前用户（别名）",
        "responses": {
          "200": {
            "description": "当前用户信息",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "当前用户信息"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未认证或Token无效",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "未认证或Token无效"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/users/": {
      "get": {
        "tags": [
          "Authentication"
        ],
        "summary": "列出用户（简化）",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "列出用户",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "创建用户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "$ref": "#/components/schemas/User"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "参数错误"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/statistics": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户统计",
        "responses": {
          "200": {
            "description": "用户统计信息",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "用户统计信息"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/roles/available": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "可用角色列表",
        "responses": {
          "200": {
            "description": "可用角色",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "可用角色"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "获取用户详情",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "用户详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "用户详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/User"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/update/": {
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "更新用户",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserCreate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "$ref": "#/components/schemas/User"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/delete/": {
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "删除用户",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/reset-password/": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "重置用户密码",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "new_password": "******"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "密码已重置",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "密码已重置"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/departments/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户所属部门",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Department"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/departments/assign/": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "分配用户部门",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "department_ids": [
                  "uuid-1",
                  "uuid-2"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "分配成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "分配成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/departments/<uuid:dept_id>/remove/": {
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "移除用户部门",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "移除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "移除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/departments/<uuid:dept_id>/set-primary/": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "设置主部门",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "设置成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "设置成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/roles/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户角色",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Role"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/roles/assign/": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "分配用户角色",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "role_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "分配成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "分配成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/roles/<uuid:role_id>/remove/": {
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "移除用户角色",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "role_id",
            "in": "path",
            "description": "角色ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "移除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "移除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/permissions/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户权限列表",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "用户权限",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "用户权限"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/department-ids/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户部门ID列表",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "部门ID列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "部门ID列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/<uuid:user_id>/primary-department/": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "用户主部门",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "主部门",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "主部门"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/tree/": {
      "get": {
        "tags": [
          "Departments"
        ],
        "summary": "部门树",
        "responses": {
          "200": {
            "description": "部门树结构",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "部门树结构"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments": {
      "get": {
        "tags": [
          "Departments"
        ],
        "summary": "列出部门",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Department"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Departments"
        ],
        "summary": "创建部门",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Department"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Department"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/create/": {
      "post": {
        "tags": [
          "Departments"
        ],
        "summary": "创建部门（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Department"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/<uuid:dept_id>/": {
      "get": {
        "tags": [
          "Departments"
        ],
        "summary": "部门详情",
        "parameters": [
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "部门详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "部门详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Department"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/<uuid:dept_id>/update/": {
      "put": {
        "tags": [
          "Departments"
        ],
        "summary": "更新部门",
        "parameters": [
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Department"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/<uuid:dept_id>/delete/": {
      "delete": {
        "tags": [
          "Departments"
        ],
        "summary": "删除部门",
        "parameters": [
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/departments/<uuid:dept_id>/users/": {
      "get": {
        "tags": [
          "Departments"
        ],
        "summary": "部门下用户",
        "parameters": [
          {
            "name": "dept_id",
            "in": "path",
            "description": "部门ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/roles": {
      "get": {
        "tags": [
          "Roles"
        ],
        "summary": "列出角色",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Role"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/roles/<uuid:role_id>/": {
      "get": {
        "tags": [
          "Roles"
        ],
        "summary": "角色详情",
        "parameters": [
          {
            "name": "role_id",
            "in": "path",
            "description": "角色ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "角色详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "角色详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Role"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/roles/<uuid:role_id>/permissions/": {
      "get": {
        "tags": [
          "Roles"
        ],
        "summary": "角色权限列表",
        "parameters": [
          {
            "name": "role_id",
            "in": "path",
            "description": "角色ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "角色权限",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "角色权限"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/permissions/check/": {
      "post": {
        "tags": [
          "Permissions"
        ],
        "summary": "检查权限",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "user_id": "uuid",
                "permission_code": "sales.view"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "权限检查结果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "权限检查结果"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "has_permission": true
                }
              }
            }
          }
        }
      }
    },
    "/api/permissions": {
      "get": {
        "tags": [
          "Permissions"
        ],
        "summary": "列出权限",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Permission"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/permissions/assign/": {
      "post": {
        "tags": [
          "Permissions"
        ],
        "summary": "分配权限",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "role_id": "uuid",
                "permission_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "分配成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "分配成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/permissions/fields/": {
      "post": {
        "tags": [
          "Permissions"
        ],
        "summary": "创建字段权限",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/permissions/modules/": {
      "get": {
        "tags": [
          "Permissions"
        ],
        "summary": "模块列表",
        "responses": {
          "200": {
            "description": "模块列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "模块列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "列出分支机构",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Branch"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/create": {
      "post": {
        "tags": [
          "Branches"
        ],
        "summary": "创建分支机构",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/my": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "我的分支机构",
        "responses": {
          "200": {
            "description": "我的分支机构",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "我的分支机构"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/stats/sales": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "分支机构销售统计",
        "responses": {
          "200": {
            "description": "销售统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "销售统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/stats/purchasing": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "分支机构采购统计",
        "responses": {
          "200": {
            "description": "采购统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "采购统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/stats/summary": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "全部分支机构汇总",
        "responses": {
          "200": {
            "description": "汇总统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "汇总统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "分支机构详情",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/update": {
      "put": {
        "tags": [
          "Branches"
        ],
        "summary": "更新分支机构",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/activate": {
      "post": {
        "tags": [
          "Branches"
        ],
        "summary": "激活分支机构",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "激活成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "激活成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/switch": {
      "post": {
        "tags": [
          "Branches"
        ],
        "summary": "切换当前分支机构",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "切换成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "切换成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/members": {
      "get": {
        "tags": [
          "Branches"
        ],
        "summary": "分支机构成员",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/members/add": {
      "post": {
        "tags": [
          "Branches"
        ],
        "summary": "添加成员",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "user_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/branches/<str:branch_id>/members/<str:user_id>/remove": {
      "delete": {
        "tags": [
          "Branches"
        ],
        "summary": "移除成员",
        "parameters": [
          {
            "name": "branch_id",
            "in": "path",
            "description": "分支机构ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "移除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "移除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/notifications": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "通知列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Notification"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/notifications/mark-read/": {
      "post": {
        "tags": [
          "Notifications"
        ],
        "summary": "标记通知已读",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "notification_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "标记成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "标记成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/notifications/unread-count/": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "未读通知数",
        "responses": {
          "200": {
            "description": "未读数",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "未读数"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "count": 5
                }
              }
            }
          }
        }
      }
    },
    "/api/notifications/send/": {
      "post": {
        "tags": [
          "Notifications"
        ],
        "summary": "发送通知",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "发送成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "发送成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/notifications/delete/": {
      "delete": {
        "tags": [
          "Notifications"
        ],
        "summary": "删除通知",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "notification_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/attendance": {
      "get": {
        "tags": [
          "Attendance"
        ],
        "summary": "考勤记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attendance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/attendance/check-in/": {
      "post": {
        "tags": [
          "Attendance"
        ],
        "summary": "上班打卡",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "latitude": 30.0,
                "longitude": 120.0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "打卡成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "打卡成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/attendance/check-out/": {
      "post": {
        "tags": [
          "Attendance"
        ],
        "summary": "下班打卡",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "latitude": 30.0,
                "longitude": 120.0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "打卡成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "打卡成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/bank-accounts": {
      "get": {
        "tags": [
          "BankAccounts"
        ],
        "summary": "银行账户列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BankAccount"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/bank-accounts/<uuid:account_id>/": {
      "get": {
        "tags": [
          "BankAccounts"
        ],
        "summary": "银行账户详情",
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "description": "账户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "账户详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "账户详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/bank-accounts/<uuid:account_id>/set-default/": {
      "post": {
        "tags": [
          "BankAccounts"
        ],
        "summary": "设为默认账户",
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "description": "账户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "设置成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "设置成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "列出工作流定义",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/WorkflowDefinition"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "创建工作流定义",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowDefinition"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/business-types/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "业务类型列表",
        "responses": {
          "200": {
            "description": "业务类型列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "业务类型列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/module-configs/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "模块工作流配置列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ModuleWorkflowConfig"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/module-configs/<str:module_name>/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "获取模块工作流配置",
        "parameters": [
          {
            "name": "module_name",
            "in": "path",
            "description": "模块名",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "配置详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "配置详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/module-configs/<str:module_name>/update/": {
      "put": {
        "tags": [
          "Approval"
        ],
        "summary": "更新模块工作流配置",
        "parameters": [
          {
            "name": "module_name",
            "in": "path",
            "description": "模块名",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/available-modules/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "可用模块列表",
        "responses": {
          "200": {
            "description": "可用模块",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "可用模块"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/transfer/": {
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "转办审批",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_id": "uuid",
                "to_user_id": "uuid",
                "reason": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "转办成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "转办成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/batch-transfer/": {
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "批量转办",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_ids": [
                  "uuid-1"
                ],
                "to_user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "批量转办成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "批量转办成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/pending-approvals/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "我的待审批列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalInstance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/transfer-history/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "全部转办历史",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalTransfer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/steps/<str:step_id>/transfer-history/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "步骤转办历史",
        "parameters": [
          {
            "name": "step_id",
            "in": "path",
            "description": "步骤ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalTransfer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "工作流详情",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "工作流详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "工作流详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/update/": {
      "put": {
        "tags": [
          "Approval"
        ],
        "summary": "更新工作流",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowDefinition"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/toggle/": {
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "启用/禁用工作流",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "切换成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "切换成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/delete/": {
      "delete": {
        "tags": [
          "Approval"
        ],
        "summary": "删除工作流",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/structure/": {
      "get": {
        "tags": [
          "Approval"
        ],
        "summary": "工作流结构（节点+连线）",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "工作流结构",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "工作流结构"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/nodes/": {
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "添加工作流节点",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowNode"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/nodes/<str:node_id>/delete/": {
      "delete": {
        "tags": [
          "Approval"
        ],
        "summary": "删除工作流节点",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "node_id",
            "in": "path",
            "description": "节点ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/<str:workflow_id>/links/": {
      "post": {
        "tags": [
          "Approval"
        ],
        "summary": "添加节点连线",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "description": "工作流ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowNodeLink"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/submit/": {
      "post": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "提交审批",
        "description": "根据 business_type 查找 ModuleWorkflowConfig 并创建审批实例",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "business_type": "sales_contract",
                "business_id": "uuid",
                "submitter_id": "uuid",
                "title": "审批标题",
                "content": "审批内容"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "提交成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "提交成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "instance_id": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/pending/": {
      "get": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "待审批列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalInstance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/<str:instance_id>/approve/": {
      "post": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "审批通过",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "审批实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "comment": "同意"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "审批通过",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "审批通过"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/<str:instance_id>/reject/": {
      "post": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "审批驳回",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "审批实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "comment": "不同意"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已驳回",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已驳回"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/<str:instance_id>/return/": {
      "post": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "退回上一步",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "审批实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "comment": "需修改"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已退回",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已退回"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/<str:instance_id>/transfer/": {
      "post": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "转办",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "审批实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "to_user_id": "uuid",
                "comment": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "转办成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "转办成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/approval/<str:instance_id>/history/": {
      "get": {
        "tags": [
          "ApprovalEngine"
        ],
        "summary": "审批历史",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "审批实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalHistory"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/instances/": {
      "get": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "审批实例列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalInstance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/instances/switch-workflow/": {
      "post": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "切换审批实例工作流",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "instance_id": "uuid",
                "workflow_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "切换成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "切换成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/instances/<str:instance_id>/": {
      "get": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "审批实例详情",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "实例详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "实例详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/instances/<str:instance_id>/operations-history/": {
      "get": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "实例操作历史",
        "parameters": [
          {
            "name": "instance_id",
            "in": "path",
            "description": "实例ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalHistory"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/steps/manual-approve/": {
      "post": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "手工通过步骤",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_id": "uuid",
                "comment": "管理员通过"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已通过",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已通过"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/steps/skip/": {
      "post": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "跳过步骤",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_id": "uuid",
                "reason": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已跳过",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已跳过"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/steps/return/": {
      "post": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "退回到指定步骤",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_id": "uuid",
                "return_to_step_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已退回",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已退回"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/workflows/admin/steps/countersign/": {
      "post": {
        "tags": [
          "ApprovalAdmin"
        ],
        "summary": "加签",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "step_id": "uuid",
                "user_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "加签成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "加签成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "列出项目",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Project"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Projects"
        ],
        "summary": "创建项目",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Project"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Project"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/<uuid:project_id>/": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "获取项目详情",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "项目详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "项目详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Project"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Projects"
        ],
        "summary": "更新项目",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Project"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Projects"
        ],
        "summary": "删除项目",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/<uuid:project_id>/tasks/": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "项目下的任务",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Task"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/<uuid:project_id>/members/": {
      "post": {
        "tags": [
          "Projects"
        ],
        "summary": "添加项目成员",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "user_id": "uuid",
                "role": "member"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/<uuid:project_id>/members/list/": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "项目成员列表",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/projects/<uuid:project_id>/members/<uuid:user_id>/": {
      "delete": {
        "tags": [
          "Projects"
        ],
        "summary": "移除项目成员",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "项目ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "移除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "移除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "列出任务",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Task"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "创建任务",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Task"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Task"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "任务详情",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "任务详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "任务详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Task"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "资源不存在",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "success": false,
                  "error": {
                    "code": "BIZ_001",
                    "message": "资源不存在"
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Tasks"
        ],
        "summary": "更新任务",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Task"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Tasks"
        ],
        "summary": "删除任务",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/complete/": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "完成任务",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "任务已完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "任务已完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/comments/": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "添加任务评论",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "content": "评论内容"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "评论已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "评论已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/dependencies/": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "设置任务依赖",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "depends_on": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "依赖已设置",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "依赖已设置"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/attachments/": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "任务附件列表",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/<uuid:task_id>/attachments/upload/": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "上传任务附件",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/tasks/attachments/<uuid:attachment_id>/": {
      "delete": {
        "tags": [
          "Tasks"
        ],
        "summary": "删除任务附件",
        "parameters": [
          {
            "name": "attachment_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/milestones/": {
      "get": {
        "tags": [
          "Milestones"
        ],
        "summary": "列出里程碑",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Milestone"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Milestones"
        ],
        "summary": "创建里程碑",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Milestone"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/milestones/<uuid:milestone_id>/": {
      "get": {
        "tags": [
          "Milestones"
        ],
        "summary": "里程碑详情",
        "parameters": [
          {
            "name": "milestone_id",
            "in": "path",
            "description": "里程碑ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "里程碑详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "里程碑详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Milestones"
        ],
        "summary": "更新里程碑",
        "parameters": [
          {
            "name": "milestone_id",
            "in": "path",
            "description": "里程碑ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Milestone"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Milestones"
        ],
        "summary": "删除里程碑",
        "parameters": [
          {
            "name": "milestone_id",
            "in": "path",
            "description": "里程碑ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/milestones/<uuid:milestone_id>/complete/": {
      "post": {
        "tags": [
          "Milestones"
        ],
        "summary": "完成里程碑",
        "parameters": [
          {
            "name": "milestone_id",
            "in": "path",
            "description": "里程碑ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "里程碑已完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "里程碑已完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/customers": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "列出客户",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Customer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建客户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Customer"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/customers/create": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建客户（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Customer"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/customers/<str:customer_id>": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "客户详情",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "客户详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "客户详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Customer"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/customers/<str:customer_id>/update": {
      "put": {
        "tags": [
          "Sales"
        ],
        "summary": "更新客户",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Customer"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/opportunities": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "商机列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Opportunity"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/opportunities/create": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建商机",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Opportunity"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/opportunities/<str:opportunity_id>/stage": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "更新商机阶段",
        "parameters": [
          {
            "name": "opportunity_id",
            "in": "path",
            "description": "商机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "stage": "negotiation"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "阶段已更新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "阶段已更新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/quotations/create": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建报价单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Quotation"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/quotations/<str:quotation_id>": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "报价单详情",
        "parameters": [
          {
            "name": "quotation_id",
            "in": "path",
            "description": "报价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "报价单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报价单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/contracts/create": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建销售合同",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contract"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/contracts/<str:contract_id>/submit-approval": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "提交合同审批",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/orders": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "销售订单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalesOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建销售订单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalesOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/orders/create": {
      "post": {
        "tags": [
          "Sales"
        ],
        "summary": "创建销售订单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalesOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/orders/<str:order_id>": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "销售订单详情",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "订单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "订单详情"
                    },
                    "data": {
                      "$ref": "#/components/schemas/SalesOrder"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Sales"
        ],
        "summary": "更新销售订单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalesOrder"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/orders/<str:order_id>/update": {
      "put": {
        "tags": [
          "Sales"
        ],
        "summary": "更新销售订单（别名）",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalesOrder"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/reports/performance": {
      "get": {
        "tags": [
          "Sales"
        ],
        "summary": "销售业绩报表",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "description": "开始日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "结束日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "业绩报表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "业绩报表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/contacts/customer": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "客户联系人列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contact"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/contacts/customer/<str:customer_id>": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "指定客户的联系人",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contact"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/contacts/local": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "本地联系人列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contact"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/contacts/create": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建联系人（统一）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/contacts/create-local": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建本地联系人",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/shipments": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "发货单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Shipment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/shipments/create": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建发货单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Shipment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/shipments/<str:shipment_id>": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "发货单详情",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "发货单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "发货单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/shipments/<str:shipment_id>/submit-approval": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "提交发货审批",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/shipments/<str:shipment_id>/confirm-delivery": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "确认送达签收",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "签收成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "签收成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/returns": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "退货列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Return"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/returns/create": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建退货单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Return"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/returns/<str:return_id>": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "退货详情",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "退货详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "退货详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/returns/<str:return_id>/status": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "更新退货状态",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "状态已更新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "状态已更新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/payments": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "回款列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Payment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/payments/create": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建回款记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Payment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/payments/overdue": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "逾期回款",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Payment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/payments/<str:payment_id>": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "回款详情",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "回款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "回款详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "回款详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/payments/<str:payment_id>/confirm": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "确认回款到账",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "回款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "amount": 1000,
                "payment_date": "2026-07-05"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "确认成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "确认成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/batches": {
      "get": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "发货批次列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Batch"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/batches/create": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "创建发货批次",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Batch"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/extended/batches/<str:batch_id>/mark-shipped": {
      "post": {
        "tags": [
          "SalesExtended"
        ],
        "summary": "标记批次已发货",
        "parameters": [
          {
            "name": "batch_id",
            "in": "path",
            "description": "批次ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "标记成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "标记成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新客户CRM信息",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Customer"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/transfer": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "转移客户",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "to_user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "转移成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "转移成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/360": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户360度视图",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "客户360视图",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "客户360视图"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/stats": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户统计",
        "responses": {
          "200": {
            "description": "客户统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "客户统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "联系人列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contact"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建联系人",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts/<str:contact_id>": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新联系人",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "description": "联系人ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts/<str:contact_id>/detail": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "联系人详情",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "description": "联系人ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "联系人详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "联系人详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts/<str:contact_id>/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除联系人",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "description": "联系人ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contacts/<str:contact_id>/set-primary": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "设为主要联系人",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "description": "联系人ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "设置成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "设置成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/follow-ups": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "跟进记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/FollowUp"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/follow-ups/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建跟进记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FollowUp"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/follow-ups/upcoming": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "即将到来的跟进",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/FollowUp"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/products": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "产品列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Product"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/products/search": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "搜索产品",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "关键字",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Product"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/products/stats": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "产品统计",
        "responses": {
          "200": {
            "description": "产品统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "产品统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/products/<str:item_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "产品详情",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "产品ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "产品详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "产品详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/products/<str:item_id>/price": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "设置产品价格",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "产品ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "price": 100.0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "价格已设置",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "价格已设置"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/kanban": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "商机看板",
        "responses": {
          "200": {
            "description": "看板数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "看板数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/<str:opportunity_id>/move": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "移动商机阶段",
        "parameters": [
          {
            "name": "opportunity_id",
            "in": "path",
            "description": "商机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "to_stage": "negotiation"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已移动",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已移动"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/pipeline": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售管道汇总",
        "responses": {
          "200": {
            "description": "管道汇总",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "管道汇总"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建商机",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Opportunity"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/list": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "商机列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Opportunity"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/<str:opportunity_id>/detail": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "商机详情",
        "parameters": [
          {
            "name": "opportunity_id",
            "in": "path",
            "description": "商机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "商机详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "商机详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/<str:opportunity_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新商机",
        "parameters": [
          {
            "name": "opportunity_id",
            "in": "path",
            "description": "商机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Opportunity"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/<str:opportunity_id>/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除商机",
        "parameters": [
          {
            "name": "opportunity_id",
            "in": "path",
            "description": "商机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/opportunities/stats": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "商机统计",
        "responses": {
          "200": {
            "description": "商机统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "商机统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/quotations": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "报价单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Quotation"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/quotations/<str:quotation_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "报价单详情",
        "parameters": [
          {
            "name": "quotation_id",
            "in": "path",
            "description": "报价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "报价单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报价单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/quotations/<str:quotation_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新报价单",
        "parameters": [
          {
            "name": "quotation_id",
            "in": "path",
            "description": "报价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Quotation"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/quotations/<str:quotation_id>/convert": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "报价单转合同",
        "parameters": [
          {
            "name": "quotation_id",
            "in": "path",
            "description": "报价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "转换成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "转换成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contracts": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "合同列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contract"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contracts/<str:contract_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "合同详情",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "合同详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "合同详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/contracts/<str:contract_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新合同",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contract"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/orders": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "订单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalesOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/orders/<str:order_id>/status": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新订单状态",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "confirmed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "状态已更新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "状态已更新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/payment-plans": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "回款计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PaymentPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/payment-plans/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建回款计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaymentPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/payment-plans/<str:plan_id>/record": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "记录计划回款",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "amount": 1000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "记录成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "记录成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/payment-plans/summary": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "回款计划汇总",
        "responses": {
          "200": {
            "description": "汇总",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "汇总"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/invoices": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "发票列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Invoice"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/invoices/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建发票",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Invoice"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/invoices/<str:invoice_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "发票详情",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "发票详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "发票详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/invoices/<str:invoice_id>/verify": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "审核发票",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "审核完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "审核完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "工作报告列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/WorkReport"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建工作报告",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkReport"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/stats": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "报告统计",
        "responses": {
          "200": {
            "description": "统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/<str:report_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "报告详情",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报告ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "报告详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报告详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/<str:report_id>/submit": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "提交报告",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报告ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/<str:report_id>/review": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "审阅报告",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报告ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved",
                "comment": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审阅",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审阅"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reports/<str:report_id>/comment": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "添加报告评论",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报告ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "content": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "评论已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "评论已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/dashboard": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "分析仪表盘",
        "responses": {
          "200": {
            "description": "仪表盘数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "仪表盘数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/funnel": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售漏斗",
        "responses": {
          "200": {
            "description": "漏斗数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "漏斗数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/ranking": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售排名",
        "responses": {
          "200": {
            "description": "排名",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "排名"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/customers": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户分析",
        "responses": {
          "200": {
            "description": "客户分析",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "客户分析"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/forecast": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售预测",
        "responses": {
          "200": {
            "description": "预测数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "预测数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/analytics/revenue-trend": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "收入趋势",
        "responses": {
          "200": {
            "description": "趋势",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "趋势"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/overview": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "经理概览",
        "responses": {
          "200": {
            "description": "经理概览",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "经理概览"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/performance": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "团队绩效",
        "responses": {
          "200": {
            "description": "绩效",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "绩效"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/pending": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "待处理事项",
        "responses": {
          "200": {
            "description": "待处理",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "待处理"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/ranking": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "团队排名",
        "responses": {
          "200": {
            "description": "排名",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "排名"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/targets": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售目标",
        "responses": {
          "200": {
            "description": "目标",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "目标"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/manager/activities": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "团队活动",
        "responses": {
          "200": {
            "description": "活动",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "活动"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建销售团队",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/list": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "团队列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalesTeam"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/my": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "我的团队",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalesTeam"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/supervised": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "我管理的团队",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalesTeam"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/<str:team_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "团队详情",
        "parameters": [
          {
            "name": "team_id",
            "in": "path",
            "description": "团队ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "团队详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "团队详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/<str:team_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新团队",
        "parameters": [
          {
            "name": "team_id",
            "in": "path",
            "description": "团队ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/<str:team_id>/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除团队",
        "parameters": [
          {
            "name": "team_id",
            "in": "path",
            "description": "团队ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/<str:team_id>/members/add": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "添加团队成员",
        "parameters": [
          {
            "name": "team_id",
            "in": "path",
            "description": "团队ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "user_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/teams/<str:team_id>/members/<str:user_id>/remove": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "移除团队成员",
        "parameters": [
          {
            "name": "team_id",
            "in": "path",
            "description": "团队ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "移除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "移除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/attachments/upload": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "上传附件",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/attachments": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "附件列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/attachments/<str:attachment_id>/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除附件",
        "parameters": [
          {
            "name": "attachment_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/attachments/<str:attachment_id>/archive": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "归档附件",
        "parameters": [
          {
            "name": "attachment_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已归档",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已归档"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/credit-notes/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建贷项通知单",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/credit-notes": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "贷项通知单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CreditNote"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/credit-notes/<str:credit_note_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "贷项通知单详情",
        "parameters": [
          {
            "name": "credit_note_id",
            "in": "path",
            "description": "贷项ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/credit-notes/<str:credit_note_id>/execute": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "执行贷项通知单",
        "parameters": [
          {
            "name": "credit_note_id",
            "in": "path",
            "description": "贷项ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已执行",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已执行"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建对账单",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "对账单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Reconciliation"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/available-docs": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "可对账单据",
        "responses": {
          "200": {
            "description": "可对账单据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "可对账单据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "对账单详情",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新对账单",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/confirm": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "确认对账单",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/auto-generate": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "自动生成对账明细",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已生成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已生成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/items": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "对账明细列表",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ReconciliationItem"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/items/add": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "添加对账明细",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/items/<str:item_id>/match": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "匹配对账明细",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "path",
            "description": "明细ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已匹配",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已匹配"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/reconciliations/<str:reconciliation_id>/items/<str:item_id>/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除对账明细",
        "parameters": [
          {
            "name": "reconciliation_id",
            "in": "path",
            "description": "对账单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "path",
            "description": "明细ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/collections/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建催收记录",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/collections": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "催收记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Collection"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/collections/detect-overdue": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "检测逾期",
        "responses": {
          "200": {
            "description": "检测完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "检测完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/order-changes/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建订单变更",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/order-changes": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "订单变更列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/OrderChange"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/order-changes/<str:change_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "订单变更详情",
        "parameters": [
          {
            "name": "change_id",
            "in": "path",
            "description": "变更ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/order-changes/<str:change_id>/execute": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "执行订单变更",
        "parameters": [
          {
            "name": "change_id",
            "in": "path",
            "description": "变更ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已执行",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已执行"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/delivery-exceptions/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建发货异常",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/delivery-exceptions": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "发货异常列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/DeliveryException"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/delivery-exceptions/<str:exception_id>/resolve": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "解决发货异常",
        "parameters": [
          {
            "name": "exception_id",
            "in": "path",
            "description": "异常ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已解决",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已解决"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receivable-ledgers": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "应收账单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ReceivableLedger"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receivable-ledgers/<str:contract_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "应收账单详情",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receivable-ledgers/<str:contract_id>/refresh": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "刷新应收账单",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已刷新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已刷新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "发货单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Shipment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建发货单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Shipment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/<str:shipment_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "发货单详情",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/<str:shipment_id>/qrcode": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "重新生成发货二维码",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "二维码已生成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "二维码已生成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/<str:shipment_id>/boxes/add": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "添加箱数",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "添加成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "添加成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/<str:shipment_id>/boxes/delete": {
      "delete": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "删除箱数",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/shipping-notes/<str:shipment_id>/boxes/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新箱数",
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "description": "发货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/qrcode-preview": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "二维码预览",
        "parameters": [
          {
            "name": "data",
            "in": "query",
            "description": "二维码数据",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "预览",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "预览"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receipt-notes/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建收货单",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receipt-notes": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "收货单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ReceiptNote"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receipt-notes/<str:receipt_note_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "收货单详情",
        "parameters": [
          {
            "name": "receipt_note_id",
            "in": "path",
            "description": "收货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/receipt-notes/<str:receipt_note_id>/confirm": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "确认收货",
        "parameters": [
          {
            "name": "receipt_note_id",
            "in": "path",
            "description": "收货单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/returns": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "退货列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Return"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/returns/create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "创建退货单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Return"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/returns/<str:return_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "退货详情",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/returns/<str:return_id>/process": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "处理退货",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已处理",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已处理"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customer-shipping-templates": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户发货模板列表",
        "responses": {
          "200": {
            "description": "模板列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "模板列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customer-shipping-templates/<str:customer_id>": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户发货模板详情",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "模板详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "模板详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/shipping-contacts": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户发货联系人",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "发货联系人",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "发货联系人"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/shipping-addresses": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "客户发货地址",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "发货地址",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "发货地址"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/contacts/quick-create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "快速创建客户联系人",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/customers/<str:customer_id>/addresses/quick-create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "快速创建客户地址",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "description": "客户ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/local-contacts": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "本地联系人列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contact"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/local-contacts/quick-create": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "快速创建本地联系人",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/approval/init": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "初始化销售审批工作流",
        "responses": {
          "200": {
            "description": "初始化成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "初始化成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/approval/pending": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售待审批列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ApprovalInstance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/approval/submit/<str:doc_type>/<str:doc_id>": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "提交销售审批",
        "parameters": [
          {
            "name": "doc_type",
            "in": "path",
            "description": "单据类型",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "doc_id",
            "in": "path",
            "description": "单据ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/roles/init": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "初始化销售角色",
        "responses": {
          "200": {
            "description": "初始化成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "初始化成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/team": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "销售团队",
        "responses": {
          "200": {
            "description": "团队",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "团队"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/stages/list": {
      "get": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "商机阶段列表",
        "responses": {
          "200": {
            "description": "阶段列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "阶段列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/stages/init": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "初始化商机阶段",
        "responses": {
          "200": {
            "description": "初始化成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "初始化成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/stages/<str:stage_id>/update": {
      "put": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "更新商机阶段",
        "parameters": [
          {
            "name": "stage_id",
            "in": "path",
            "description": "阶段ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sales/crm/records/<str:record_type>/<str:record_id>/team": {
      "post": {
        "tags": [
          "SalesCRM"
        ],
        "summary": "设置记录归属团队",
        "parameters": [
          {
            "name": "record_type",
            "in": "path",
            "description": "记录类型",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "team_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "设置成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "设置成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/suppliers": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "供应商列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Supplier"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建供应商",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Supplier"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/suppliers/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建供应商（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Supplier"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/suppliers/<str:supplier_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "供应商详情",
        "parameters": [
          {
            "name": "supplier_id",
            "in": "path",
            "description": "供应商ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "供应商详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "供应商详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/suppliers/<str:supplier_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新供应商",
        "parameters": [
          {
            "name": "supplier_id",
            "in": "path",
            "description": "供应商ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Supplier"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/suppliers/<str:supplier_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除供应商",
        "parameters": [
          {
            "name": "supplier_id",
            "in": "path",
            "description": "供应商ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "询价单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Inquiry"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建询价单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Inquiry"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/compare": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "比价",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "query",
            "description": "询价单ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "比价结果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "比价结果"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/<str:inquiry_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "询价单详情",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "询价单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "询价单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/<str:inquiry_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新询价单",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Inquiry"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/<str:inquiry_id>/close": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "关闭询价单",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已关闭",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已关闭"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/<str:inquiry_id>/quotations/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "添加报价",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Quotation"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/inquiries/<str:inquiry_id>/quotations/<str:quotation_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除报价",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "quotation_id",
            "in": "path",
            "description": "报价ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购申请列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PurchaseRequest"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建采购申请",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests/<str:request_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购申请详情",
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests/<str:request_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新采购申请",
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests/<str:request_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除采购申请",
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/requests/<str:request_id>/submit-approval": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "提交采购申请审批",
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购订单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PurchaseOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建采购订单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建采购订单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders/<str:order_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购订单详情",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "订单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "订单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders/<str:order_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新采购订单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseOrder"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders/<str:order_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除采购订单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/orders/<str:order_id>/submit-approval": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "提交采购订单审批",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购合同列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contract"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建采购合同",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contract"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/<str:contract_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "合同详情",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/<str:contract_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新合同",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Contract"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/<str:contract_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除合同",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/<str:contract_id>/submit-approval": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "提交合同审批",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/contracts/<str:contract_id>/sign": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "签署合同",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已签署",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已签署"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "付款申请列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Payment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建付款申请",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Payment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/<str:payment_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "付款申请详情",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/<str:payment_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新付款申请",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Payment"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/<str:payment_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除付款申请",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/<str:payment_id>/submit-approval": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "提交付款审批",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/payments/<str:payment_id>/confirm": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "确认付款",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "发票列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Invoice"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建发票",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Invoice"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices/<str:invoice_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "发票详情",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices/<str:invoice_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新发票",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Invoice"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices/<str:invoice_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除发票",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/invoices/<str:invoice_id>/verify": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "发票校验（三单匹配）",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "校验完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "校验完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购退货列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Return"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建退货单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Return"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns/<str:return_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "退货详情",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns/<str:return_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新退货单",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Return"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns/<str:return_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除退货单",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/returns/<str:return_id>/submit-approval": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "提交退货审批",
        "parameters": [
          {
            "name": "return_id",
            "in": "path",
            "description": "退货ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/channels": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购渠道列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Channel"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/channels/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建采购渠道",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Channel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/channels/<str:channel_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "渠道详情",
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "description": "渠道ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/channels/<str:channel_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新渠道",
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "description": "渠道ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Channel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/channels/<str:channel_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除渠道",
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "description": "渠道ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/materials": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "物料列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Material"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "价格库列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Price"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices/statistics": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "价格统计",
        "responses": {
          "200": {
            "description": "价格统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "价格统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices/create": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "创建价格记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Price"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices/<str:price_id>": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "价格详情",
        "parameters": [
          {
            "name": "price_id",
            "in": "path",
            "description": "价格ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices/<str:price_id>/update": {
      "put": {
        "tags": [
          "Purchasing"
        ],
        "summary": "更新价格",
        "parameters": [
          {
            "name": "price_id",
            "in": "path",
            "description": "价格ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Price"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/prices/<str:price_id>/delete": {
      "delete": {
        "tags": [
          "Purchasing"
        ],
        "summary": "删除价格",
        "parameters": [
          {
            "name": "price_id",
            "in": "path",
            "description": "价格ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/purchasing/reports/statistics": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "采购统计",
        "responses": {
          "200": {
            "description": "采购统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "采购统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/materials": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "物料列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Material"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/warehouses": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "仓库列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Warehouse"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/warehouses/<uuid:warehouse_id>": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "仓库详情",
        "parameters": [
          {
            "name": "warehouse_id",
            "in": "path",
            "description": "仓库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "仓库详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "仓库详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stocks/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "库存列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Stock"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stock": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "库存查询（别名）",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "库存",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "库存"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/inbound/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "入库列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Inbound"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/inbound": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建入库单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Inbound"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/inbound/create": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建入库单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Inbound"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/inbound/<uuid:inbound_id>/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "入库详情",
        "parameters": [
          {
            "name": "inbound_id",
            "in": "path",
            "description": "入库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "入库详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "入库详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/inbound/<uuid:inbound_id>/confirm/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "确认入库",
        "parameters": [
          {
            "name": "inbound_id",
            "in": "path",
            "description": "入库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "出库列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Outbound"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建出库单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Outbound"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound/create": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建出库单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Outbound"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound/<uuid:outbound_id>/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "出库详情",
        "parameters": [
          {
            "name": "outbound_id",
            "in": "path",
            "description": "出库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "出库详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "出库详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound/<uuid:outbound_id>/confirm/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "确认出库",
        "parameters": [
          {
            "name": "outbound_id",
            "in": "path",
            "description": "出库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/outbound/<uuid:outbound_id>/cancel/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "取消出库",
        "parameters": [
          {
            "name": "outbound_id",
            "in": "path",
            "description": "出库ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已取消",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已取消"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/transfer/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "调拨列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Transfer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/transfer": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建调拨单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Transfer"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/transfer/create": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建调拨单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Transfer"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/transfer/<uuid:transfer_id>/confirm/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "确认调拨",
        "parameters": [
          {
            "name": "transfer_id",
            "in": "path",
            "description": "调拨ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stocktaking/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "盘点列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Stocktaking"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stocktaking": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建盘点单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Stocktaking"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stocktaking/create": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "创建盘点单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Stocktaking"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/stocktaking/<uuid:stocktaking_id>/confirm/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "确认盘点",
        "parameters": [
          {
            "name": "stocktaking_id",
            "in": "path",
            "description": "盘点ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/alerts/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "预警列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Alert"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/alerts": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "预警列表（别名）",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Alert"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/alerts/<uuid:alert_id>/resolve/": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "解决预警",
        "parameters": [
          {
            "name": "alert_id",
            "in": "path",
            "description": "预警ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已解决",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已解决"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/transactions/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "流水列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Transaction"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/reports/ledger": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "台账报表",
        "parameters": [
          {
            "name": "material_id",
            "in": "query",
            "description": "物料ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "开始日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "结束日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "台账报表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "台账报表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/cross-ledger/stocks/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "跨账本库存查询",
        "parameters": [
          {
            "name": "material_id",
            "in": "query",
            "description": "物料ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "跨账本库存",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "跨账本库存"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/inventory/cross-ledger/summary/": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "跨账本汇总",
        "responses": {
          "200": {
            "description": "跨账本汇总",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "跨账本汇总"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/dashboard/summary": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "仪表盘汇总",
        "responses": {
          "200": {
            "description": "仪表盘汇总",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "仪表盘汇总"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/production": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "生产报表",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "description": "开始日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "结束日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "生产报表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "生产报表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/capacity": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "产能分析",
        "responses": {
          "200": {
            "description": "产能分析",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "产能分析"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "生产计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProductionPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建生产计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "生产计划详情",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "计划详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "计划详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新生产计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionPlan"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除生产计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交计划审批",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>/release": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "下达计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已下达",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已下达"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/plans/<str:plan_id>/close": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "关闭计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已关闭",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已关闭"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "BOM列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BOM"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建BOM",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BOM"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms/<str:bom_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "BOM详情",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "BOM详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "BOM详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms/<str:bom_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新BOM",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BOM"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms/<str:bom_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除BOM",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/boms/<str:bom_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交BOM审批",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工艺路线列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Routing"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建工艺路线",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Routing"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings/<str:routing_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工艺路线详情",
        "parameters": [
          {
            "name": "routing_id",
            "in": "path",
            "description": "工艺ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "工艺详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "工艺详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings/<str:routing_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新工艺路线",
        "parameters": [
          {
            "name": "routing_id",
            "in": "path",
            "description": "工艺ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Routing"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings/<str:routing_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除工艺路线",
        "parameters": [
          {
            "name": "routing_id",
            "in": "path",
            "description": "工艺ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/routings/<str:routing_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交工艺变更审批",
        "parameters": [
          {
            "name": "routing_id",
            "in": "path",
            "description": "工艺ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-centers": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工作中心列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/WorkCenter"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-centers/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建工作中心",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkCenter"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-centers/<str:center_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工作中心详情",
        "parameters": [
          {
            "name": "center_id",
            "in": "path",
            "description": "工作中心ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-centers/<str:center_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新工作中心",
        "parameters": [
          {
            "name": "center_id",
            "in": "path",
            "description": "工作中心ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkCenter"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-centers/<str:center_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除工作中心",
        "parameters": [
          {
            "name": "center_id",
            "in": "path",
            "description": "工作中心ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/WorkOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建工单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工单详情",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "工单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "工单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新工单",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkOrder"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除工单",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交工单审批",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/release": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "下达工单",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已下达",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已下达"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/start": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "开工",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已开工",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已开工"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/pause": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "暂停工单",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已暂停",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已暂停"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/complete": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "完工",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已完工",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已完工"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/work-orders/<str:work_order_id>/close": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "结算工单",
        "parameters": [
          {
            "name": "work_order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已结算",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已结算"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "报工列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProductionReport"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建报工",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionReport"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/<str:report_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "报工详情",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报工ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "报工详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报工详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/<str:report_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新报工",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报工ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionReport"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/<str:report_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除报工",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报工ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/reports/<str:report_id>/confirm": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "确认报工",
        "parameters": [
          {
            "name": "report_id",
            "in": "path",
            "description": "报工ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工序质量列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/QualityInspection"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建工序质量检验",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualityInspection"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality/<str:inspection_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "工序质量详情",
        "parameters": [
          {
            "name": "inspection_id",
            "in": "path",
            "description": "检验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality/<str:inspection_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新工序质量",
        "parameters": [
          {
            "name": "inspection_id",
            "in": "path",
            "description": "检验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualityInspection"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality/<str:inspection_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除工序质量",
        "parameters": [
          {
            "name": "inspection_id",
            "in": "path",
            "description": "检验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/quality/<str:inspection_id>/submit-exception": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交质量异常审批",
        "parameters": [
          {
            "name": "inspection_id",
            "in": "path",
            "description": "检验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/equipment": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "设备列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Equipment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/equipment/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建设备",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Equipment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/equipment/<str:equipment_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "设备详情",
        "parameters": [
          {
            "name": "equipment_id",
            "in": "path",
            "description": "设备ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/equipment/<str:equipment_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新设备",
        "parameters": [
          {
            "name": "equipment_id",
            "in": "path",
            "description": "设备ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Equipment"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/equipment/<str:equipment_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除设备",
        "parameters": [
          {
            "name": "equipment_id",
            "in": "path",
            "description": "设备ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "维保列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Maintenance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建维保",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Maintenance"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/<str:maintenance_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "维保详情",
        "parameters": [
          {
            "name": "maintenance_id",
            "in": "path",
            "description": "维保ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/<str:maintenance_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新维保",
        "parameters": [
          {
            "name": "maintenance_id",
            "in": "path",
            "description": "维保ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Maintenance"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/<str:maintenance_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除维保",
        "parameters": [
          {
            "name": "maintenance_id",
            "in": "path",
            "description": "维保ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/<str:maintenance_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交维保审批",
        "parameters": [
          {
            "name": "maintenance_id",
            "in": "path",
            "description": "维保ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/maintenance/<str:maintenance_id>/complete": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "完成维保",
        "parameters": [
          {
            "name": "maintenance_id",
            "in": "path",
            "description": "维保ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "停机记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Downtime"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建停机记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Downtime"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "停机详情",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新停机",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Downtime"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除停机",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>/submit-approval": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "提交停机审批",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>/resolve": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "解决停机",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已解决",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已解决"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/downtime/<str:downtime_id>/confirm": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "确认停机",
        "parameters": [
          {
            "name": "downtime_id",
            "in": "path",
            "description": "停机ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "批次列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProductionLot"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建批次",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionLot"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/<str:lot_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "批次详情",
        "parameters": [
          {
            "name": "lot_id",
            "in": "path",
            "description": "批次ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/<str:lot_id>/update": {
      "put": {
        "tags": [
          "MES"
        ],
        "summary": "更新批次",
        "parameters": [
          {
            "name": "lot_id",
            "in": "path",
            "description": "批次ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductionLot"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/<str:lot_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除批次",
        "parameters": [
          {
            "name": "lot_id",
            "in": "path",
            "description": "批次ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/<str:lot_id>/split": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "拆分批次",
        "parameters": [
          {
            "name": "lot_id",
            "in": "path",
            "description": "批次ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "quantities": [
                  50,
                  30
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已拆分",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已拆分"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/lots/trace": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "批次追溯",
        "parameters": [
          {
            "name": "lot_id",
            "in": "query",
            "description": "批次ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "direction",
            "in": "query",
            "description": "forward/backward",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "追溯结果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "追溯结果"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/consumption": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "物料消耗列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Consumption"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/consumption/create": {
      "post": {
        "tags": [
          "MES"
        ],
        "summary": "创建物料消耗",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Consumption"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/consumption/<str:consumption_id>": {
      "get": {
        "tags": [
          "MES"
        ],
        "summary": "消耗详情",
        "parameters": [
          {
            "name": "consumption_id",
            "in": "path",
            "description": "消耗ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/mes/consumption/<str:consumption_id>/delete": {
      "delete": {
        "tags": [
          "MES"
        ],
        "summary": "删除消耗",
        "parameters": [
          {
            "name": "consumption_id",
            "in": "path",
            "description": "消耗ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/dashboard": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "质量仪表盘",
        "responses": {
          "200": {
            "description": "仪表盘数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "仪表盘数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "体系模板列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/QualitySystemTemplate"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建体系模板",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualitySystemTemplate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems/generate-iatf": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "生成IATF模板",
        "responses": {
          "200": {
            "description": "生成成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "生成成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems/<str:template_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "体系模板详情",
        "parameters": [
          {
            "name": "template_id",
            "in": "path",
            "description": "模板ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems/<str:template_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新体系模板",
        "parameters": [
          {
            "name": "template_id",
            "in": "path",
            "description": "模板ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualitySystemTemplate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/systems/<str:template_id>/delete": {
      "delete": {
        "tags": [
          "Quality"
        ],
        "summary": "删除体系模板",
        "parameters": [
          {
            "name": "template_id",
            "in": "path",
            "description": "模板ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/clauses": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "条款列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/QualityClause"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/clauses/<str:clause_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新条款",
        "parameters": [
          {
            "name": "clause_id",
            "in": "path",
            "description": "条款ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualityClause"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "质量计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/QualityPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建质量计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualityPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/create-from-template": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "从模板创建质量计划",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "template_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/<str:plan_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "质量计划详情",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/<str:plan_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新质量计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QualityPlan"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/<str:plan_id>/delete": {
      "delete": {
        "tags": [
          "Quality"
        ],
        "summary": "删除质量计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/<str:plan_id>/compliance": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "合规率",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "合规率",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "合规率"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/plans/<str:plan_id>/matrix": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "证据矩阵",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "证据矩阵",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "证据矩阵"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/requirements": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "要求列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/QualityRequirement"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/requirements/<str:requirement_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新要求状态",
        "parameters": [
          {
            "name": "requirement_id",
            "in": "path",
            "description": "要求ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "compliant"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/requirements/<str:requirement_id>/evidences": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "要求下的证据列表",
        "parameters": [
          {
            "name": "requirement_id",
            "in": "path",
            "description": "要求ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Evidence"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/requirements/<str:requirement_id>/upload": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "上传证据",
        "parameters": [
          {
            "name": "requirement_id",
            "in": "path",
            "description": "要求ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/evidences/<str:evidence_id>/review": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "审核证据",
        "parameters": [
          {
            "name": "evidence_id",
            "in": "path",
            "description": "证据ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved",
                "comment": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审核",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审核"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/evidences/<str:evidence_id>/delete": {
      "delete": {
        "tags": [
          "Quality"
        ],
        "summary": "删除证据",
        "parameters": [
          {
            "name": "evidence_id",
            "in": "path",
            "description": "证据ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "APQP计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/APQPPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建APQP计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/APQPPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp/<str:apqp_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "APQP计划详情",
        "parameters": [
          {
            "name": "apqp_id",
            "in": "path",
            "description": "APQP ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp/<str:apqp_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新APQP计划",
        "parameters": [
          {
            "name": "apqp_id",
            "in": "path",
            "description": "APQP ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/APQPPlan"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp/<str:apqp_id>/advance": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "推进APQP阶段",
        "parameters": [
          {
            "name": "apqp_id",
            "in": "path",
            "description": "APQP ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已推进",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已推进"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/apqp/deliverables/<str:deliverable_id>": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新APQP交付物",
        "parameters": [
          {
            "name": "deliverable_id",
            "in": "path",
            "description": "交付物ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "FMEA列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/FMEA"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建FMEA",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FMEA"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/<str:fmea_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "FMEA详情",
        "parameters": [
          {
            "name": "fmea_id",
            "in": "path",
            "description": "FMEA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/<str:fmea_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新FMEA",
        "parameters": [
          {
            "name": "fmea_id",
            "in": "path",
            "description": "FMEA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FMEA"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/<str:fmea_id>/delete": {
      "delete": {
        "tags": [
          "Quality"
        ],
        "summary": "删除FMEA",
        "parameters": [
          {
            "name": "fmea_id",
            "in": "path",
            "description": "FMEA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/<str:fmea_id>/lines": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "添加FMEA行",
        "parameters": [
          {
            "name": "fmea_id",
            "in": "path",
            "description": "FMEA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/<str:fmea_id>/link-control-plan": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "关联FMEA到控制计划",
        "parameters": [
          {
            "name": "fmea_id",
            "in": "path",
            "description": "FMEA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "control_plan_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已关联",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已关联"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/fmea/lines/<str:line_id>": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新FMEA行",
        "parameters": [
          {
            "name": "line_id",
            "in": "path",
            "description": "行ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/control-plans": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "控制计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ControlPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/control-plans/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建控制计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/control-plans/<str:control_plan_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "控制计划详情",
        "parameters": [
          {
            "name": "control_plan_id",
            "in": "path",
            "description": "控制计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/control-plans/<str:control_plan_id>/items": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "添加控制计划项",
        "parameters": [
          {
            "name": "control_plan_id",
            "in": "path",
            "description": "控制计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/control-plans/items/<str:item_id>": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新控制计划项",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "项ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ppap": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "PPAP提交列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PPAP"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ppap/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建PPAP提交",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PPAP"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ppap/<str:submission_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "PPAP提交详情",
        "parameters": [
          {
            "name": "submission_id",
            "in": "path",
            "description": "提交ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ppap/<str:submission_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新PPAP提交",
        "parameters": [
          {
            "name": "submission_id",
            "in": "path",
            "description": "提交ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PPAP"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ppap/elements/<str:element_id>": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新PPAP元素",
        "parameters": [
          {
            "name": "element_id",
            "in": "path",
            "description": "元素ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "审核列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Audit"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建审核",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Audit"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits/<str:audit_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "审核详情",
        "parameters": [
          {
            "name": "audit_id",
            "in": "path",
            "description": "审核ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits/<str:audit_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新审核",
        "parameters": [
          {
            "name": "audit_id",
            "in": "path",
            "description": "审核ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Audit"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits/<str:audit_id>/findings": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "添加审核发现",
        "parameters": [
          {
            "name": "audit_id",
            "in": "path",
            "description": "审核ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已添加",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已添加"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/audits/findings/<str:finding_id>": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新审核发现状态",
        "parameters": [
          {
            "name": "finding_id",
            "in": "path",
            "description": "发现ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "closed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ncr": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "不合格品列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/NCR"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ncr/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建不合格品",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NCR"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ncr/<str:ncr_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "不合格品详情",
        "parameters": [
          {
            "name": "ncr_id",
            "in": "path",
            "description": "NCR ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/ncr/<str:ncr_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新不合格品",
        "parameters": [
          {
            "name": "ncr_id",
            "in": "path",
            "description": "NCR ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NCR"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "CAPA列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CAPA"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建CAPA",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CAPA"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa/<str:capa_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "CAPA详情",
        "parameters": [
          {
            "name": "capa_id",
            "in": "path",
            "description": "CAPA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa/<str:capa_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新CAPA",
        "parameters": [
          {
            "name": "capa_id",
            "in": "path",
            "description": "CAPA ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CAPA"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa/link-ncr": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "关联NCR到CAPA",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "capa_id": "uuid",
                "ncr_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已关联",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已关联"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/capa/link-finding": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "关联审核发现到CAPA",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "capa_id": "uuid",
                "finding_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已关联",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已关联"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/msa": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "MSA研究列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/MSA"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/msa/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建MSA研究",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MSA"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/msa/<str:study_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "MSA研究详情",
        "parameters": [
          {
            "name": "study_id",
            "in": "path",
            "description": "研究ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/msa/<str:study_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新MSA研究",
        "parameters": [
          {
            "name": "study_id",
            "in": "path",
            "description": "研究ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MSA"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/spc": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "SPC记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SPC"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/spc/create": {
      "post": {
        "tags": [
          "Quality"
        ],
        "summary": "创建SPC记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SPC"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/spc/<str:record_id>": {
      "get": {
        "tags": [
          "Quality"
        ],
        "summary": "SPC记录详情",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/quality/spc/<str:record_id>/update": {
      "put": {
        "tags": [
          "Quality"
        ],
        "summary": "更新SPC记录",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SPC"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SOPRoute"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线详情",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/nodes/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线节点",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "节点列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "节点列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/nodes/<uuid:node_id>/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线节点详情",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "node_id",
            "in": "path",
            "description": "节点ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "节点详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "节点详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/connections/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线连接",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "连接列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "连接列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/graph/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "工艺路线图形",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "图形数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "图形数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/routes/<uuid:route_id>/submit-approval/": {
      "post": {
        "tags": [
          "SOP"
        ],
        "summary": "提交工艺路线审批",
        "parameters": [
          {
            "name": "route_id",
            "in": "path",
            "description": "路线ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "SOP文档列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SOPDocument"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "SOP文档详情",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/save-version/": {
      "post": {
        "tags": [
          "SOP"
        ],
        "summary": "保存文档版本",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已保存",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已保存"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/versions/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "文档版本列表",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SOPDocumentVersion"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/restore/<uuid:version_id>/": {
      "post": {
        "tags": [
          "SOP"
        ],
        "summary": "恢复文档版本",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "version_id",
            "in": "path",
            "description": "版本ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已恢复",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已恢复"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/attachments/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "文档附件",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/documents/<uuid:doc_id>/submit-approval/": {
      "post": {
        "tags": [
          "SOP"
        ],
        "summary": "提交SOP文档审批",
        "parameters": [
          {
            "name": "doc_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/bom/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "BOM列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BOM"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/bom/<uuid:bom_id>/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "BOM详情",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sop/bom/<uuid:bom_id>/cost/": {
      "get": {
        "tags": [
          "SOP"
        ],
        "summary": "BOM成本",
        "parameters": [
          {
            "name": "bom_id",
            "in": "path",
            "description": "BOM ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成本",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "成本"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/categories/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "产品类别列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProductCategory"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/categories/<uuid:category_id>/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "产品类别详情",
        "parameters": [
          {
            "name": "category_id",
            "in": "path",
            "description": "类别ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/items/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "物料列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Material"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/items/<uuid:item_id>/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "物料详情",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "物料ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/items/<uuid:item_id>/stock/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "物料库存",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "物料ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "库存",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "库存"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/equipment/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "产品设备列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Equipment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/product/equipment/<uuid:equipment_id>/": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "产品设备详情",
        "parameters": [
          {
            "name": "equipment_id",
            "in": "path",
            "description": "设备ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders": {
      "get": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "通用工单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/GenericWorkOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "创建通用工单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericWorkOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/create/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "创建通用工单（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericWorkOrder"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/": {
      "get": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "通用工单详情",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/update/": {
      "put": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "更新通用工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericWorkOrder"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/assign/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "分配工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "assignee_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已分配",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已分配"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/transfer/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "转办工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "to_user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已转办",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已转办"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/reply/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "回复工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "content": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已回复",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已回复"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/escalate/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "升级工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "reason": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已升级",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已升级"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/<uuid:order_id>/rate/": {
      "post": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "评价工单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "工单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "rating": 5,
                "comment": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已评价",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已评价"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/work-orders/reports/sla/": {
      "get": {
        "tags": [
          "WorkOrders"
        ],
        "summary": "SLA统计",
        "responses": {
          "200": {
            "description": "SLA统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "SLA统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/todos": {
      "get": {
        "tags": [
          "Todos"
        ],
        "summary": "待办列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Todo"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Todos"
        ],
        "summary": "创建待办",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Todo"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/todos/create": {
      "post": {
        "tags": [
          "Todos"
        ],
        "summary": "创建待办（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Todo"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/todos/<uuid:todo_id>/update": {
      "put": {
        "tags": [
          "Todos"
        ],
        "summary": "更新待办",
        "parameters": [
          {
            "name": "todo_id",
            "in": "path",
            "description": "待办ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Todo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/todos/<uuid:todo_id>/complete": {
      "post": {
        "tags": [
          "Todos"
        ],
        "summary": "完成待办",
        "parameters": [
          {
            "name": "todo_id",
            "in": "path",
            "description": "待办ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "文档列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Document"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "创建文档",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Document"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/search/": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "文档搜索",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "关键字",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "分类",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Document"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/reports/statistics/": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "文档统计",
        "responses": {
          "200": {
            "description": "文档统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文档统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/<str:document_id>/": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "文档详情",
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "文档详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文档详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Documents"
        ],
        "summary": "更新文档",
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Document"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/<str:document_id>/publish/": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "发布文档",
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已发布",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已发布"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/documents/<str:document_id>/versions/": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "文档版本列表",
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "description": "文档ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/DocumentVersion"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "图纸列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Drawing"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Drawings"
        ],
        "summary": "创建图纸",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Drawing"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/create/": {
      "post": {
        "tags": [
          "Drawings"
        ],
        "summary": "创建图纸（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Drawing"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/search/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "图纸搜索",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "关键字",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Drawing"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/borrow-records/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "借阅记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BorrowRecord"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/statistics/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "图纸统计",
        "responses": {
          "200": {
            "description": "统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "图纸详情",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "图纸详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "图纸详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/update/": {
      "put": {
        "tags": [
          "Drawings"
        ],
        "summary": "更新图纸版本",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Drawing"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/versions/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "图纸版本列表",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/DrawingVersion"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/borrow/": {
      "post": {
        "tags": [
          "Drawings"
        ],
        "summary": "借阅图纸",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "purpose": "生产参考"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已借阅",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已借阅"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/return/": {
      "post": {
        "tags": [
          "Drawings"
        ],
        "summary": "归还图纸",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已归还",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已归还"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/file/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "下载图纸文件",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "文件流",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文件流"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/drawings/<str:drawing_id>/render/": {
      "get": {
        "tags": [
          "Drawings"
        ],
        "summary": "渲染图纸SVG",
        "parameters": [
          {
            "name": "drawing_id",
            "in": "path",
            "description": "图纸ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SVG",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "SVG"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans": {
      "get": {
        "tags": [
          "Training"
        ],
        "summary": "培训计划列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/TrainingPlan"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/create": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "创建培训计划",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrainingPlan"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>": {
      "get": {
        "tags": [
          "Training"
        ],
        "summary": "培训计划详情",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>/update": {
      "put": {
        "tags": [
          "Training"
        ],
        "summary": "更新培训计划",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrainingPlan"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>/attachments": {
      "get": {
        "tags": [
          "Training"
        ],
        "summary": "培训附件列表",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>/attachments/upload": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "上传培训附件",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>/attachments/<uuid:att_id>": {
      "delete": {
        "tags": [
          "Training"
        ],
        "summary": "删除培训附件",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "att_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/plans/<str:plan_id>/attachments/<uuid:att_id>/download": {
      "get": {
        "tags": [
          "Training"
        ],
        "summary": "下载培训附件",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "计划ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "att_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "文件流",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文件流"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/resources": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "创建培训资源",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/enrollments": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "培训报名",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "plan_id": "uuid",
                "user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "报名成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报名成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/attendance": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "记录培训考勤",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "plan_id": "uuid",
                "user_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "考勤已记录",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "考勤已记录"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/evaluations": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "创建培训评价",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/certificates": {
      "post": {
        "tags": [
          "Training"
        ],
        "summary": "发放培训证书",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "已发放",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已发放"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/training/reports/statistics": {
      "get": {
        "tags": [
          "Training"
        ],
        "summary": "培训统计",
        "responses": {
          "200": {
            "description": "统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "会议列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Meeting"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "创建会议",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Meeting"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/create/": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "创建会议（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Meeting"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "会议详情",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "会议详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "会议详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Meetings"
        ],
        "summary": "更新会议",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Meeting"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/attendance/": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "记录会议出席",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "attendee_ids": [
                  "uuid-1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已记录",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已记录"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/minutes/create/": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "创建会议纪要",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "content": "..."
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/minutes/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "获取会议纪要",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "纪要",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "纪要"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/resolutions/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "会议决议列表",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Resolution"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/resolutions/create/": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "创建决议",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Resolution"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/resolutions/<str:resolution_id>/": {
      "put": {
        "tags": [
          "Meetings"
        ],
        "summary": "更新决议状态",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "resolution_id",
            "in": "path",
            "description": "决议ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "completed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/attachments/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "会议附件列表",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/attachments/upload": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "上传会议附件",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/attachments/<uuid:att_id>/": {
      "delete": {
        "tags": [
          "Meetings"
        ],
        "summary": "删除会议附件",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "att_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/<uuid:minute_id>/attachments/<uuid:att_id>/download": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "下载会议附件",
        "parameters": [
          {
            "name": "minute_id",
            "in": "path",
            "description": "会议ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "att_id",
            "in": "path",
            "description": "附件ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "文件流",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文件流"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/meetings/reports/statistics/": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "会议统计",
        "responses": {
          "200": {
            "description": "统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Experiment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/create": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "创建实验",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Experiment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/create-from-wizard": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "从向导创建实验",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "wizard_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/compare": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "对比数据集",
        "parameters": [
          {
            "name": "dataset_ids",
            "in": "query",
            "description": "数据集ID列表",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "对比结果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "对比结果"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/stats": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验仪表盘统计",
        "responses": {
          "200": {
            "description": "统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验标准列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ExperimentStandard"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards/create": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "创建实验标准",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExperimentStandard"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards/template": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "标准模板",
        "responses": {
          "200": {
            "description": "模板",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "模板"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards/<str:standard_id>": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验标准详情",
        "parameters": [
          {
            "name": "standard_id",
            "in": "path",
            "description": "标准ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards/<str:standard_id>/update": {
      "put": {
        "tags": [
          "Experiments"
        ],
        "summary": "更新实验标准",
        "parameters": [
          {
            "name": "standard_id",
            "in": "path",
            "description": "标准ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExperimentStandard"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/standards/<str:standard_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除实验标准",
        "parameters": [
          {
            "name": "standard_id",
            "in": "path",
            "description": "标准ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "向导列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ExperimentWizard"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/create": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "创建向导",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExperimentWizard"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/from-standard": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "从标准创建向导",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "standard_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/<str:wizard_id>": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "向导详情",
        "parameters": [
          {
            "name": "wizard_id",
            "in": "path",
            "description": "向导ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/<str:wizard_id>/steps": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "向导步骤",
        "parameters": [
          {
            "name": "wizard_id",
            "in": "path",
            "description": "向导ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "步骤",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "步骤"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/<str:wizard_id>/update": {
      "put": {
        "tags": [
          "Experiments"
        ],
        "summary": "更新向导",
        "parameters": [
          {
            "name": "wizard_id",
            "in": "path",
            "description": "向导ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExperimentWizard"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/wizards/<str:wizard_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除向导",
        "parameters": [
          {
            "name": "wizard_id",
            "in": "path",
            "description": "向导ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/fitting-results/<str:fitting_id>": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "拟合结果详情",
        "parameters": [
          {
            "name": "fitting_id",
            "in": "path",
            "description": "拟合ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/fitting-results/<str:fitting_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除拟合结果",
        "parameters": [
          {
            "name": "fitting_id",
            "in": "path",
            "description": "拟合ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/datasets/<str:dataset_id>/points": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "数据点列表",
        "parameters": [
          {
            "name": "dataset_id",
            "in": "path",
            "description": "数据集ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/DataPoint"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/datasets/<str:dataset_id>/points/batch": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "批量导入数据点",
        "parameters": [
          {
            "name": "dataset_id",
            "in": "path",
            "description": "数据集ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "points": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已导入",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已导入"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/datasets/<str:dataset_id>/points/import-csv": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "CSV导入数据点",
        "parameters": [
          {
            "name": "dataset_id",
            "in": "path",
            "description": "数据集ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已导入",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已导入"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/datasets/<str:dataset_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除数据集",
        "parameters": [
          {
            "name": "dataset_id",
            "in": "path",
            "description": "数据集ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/files/<str:file_id>/download": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "下载文件",
        "parameters": [
          {
            "name": "file_id",
            "in": "path",
            "description": "文件ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "文件流",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "文件流"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/files/<str:file_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除文件",
        "parameters": [
          {
            "name": "file_id",
            "in": "path",
            "description": "文件ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验详情",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/update": {
      "put": {
        "tags": [
          "Experiments"
        ],
        "summary": "更新实验",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Experiment"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/delete": {
      "delete": {
        "tags": [
          "Experiments"
        ],
        "summary": "删除实验",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/report": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "生成实验报告",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "报告",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "报告"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/validate": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "校验实验",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "校验结果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "校验结果"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/step-records": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "步骤记录列表",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/StepRecord"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/step-records/<int:seq>/update": {
      "put": {
        "tags": [
          "Experiments"
        ],
        "summary": "更新步骤记录",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seq",
            "in": "path",
            "description": "步骤序号",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/datasets": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验数据集列表",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Dataset"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/datasets/create": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "创建数据集",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Dataset"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/files/upload": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "上传实验文件",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/files": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验文件列表",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ExperimentFile"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/fitting/run": {
      "post": {
        "tags": [
          "Experiments"
        ],
        "summary": "运行拟合",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "拟合已启动",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "拟合已启动"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/experiments/<str:experiment_id>/fitting-results": {
      "get": {
        "tags": [
          "Experiments"
        ],
        "summary": "实验拟合结果列表",
        "parameters": [
          {
            "name": "experiment_id",
            "in": "path",
            "description": "实验ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/FittingResult"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/attendance-apply/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "考勤申请列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/AttendanceApply"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/attendance-apply/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建考勤申请",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttendanceApply"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/attendance-apply/<int:app_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批考勤申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/schedules/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "日程列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Schedule"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建日程",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Schedule"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/schedules/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建日程（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Schedule"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/schedules/<int:schedule_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新日程",
        "parameters": [
          {
            "name": "schedule_id",
            "in": "path",
            "description": "日程ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Schedule"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/schedules/<int:schedule_id>/delete/": {
      "delete": {
        "tags": [
          "Office"
        ],
        "summary": "删除日程",
        "parameters": [
          {
            "name": "schedule_id",
            "in": "path",
            "description": "日程ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/announcements/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "公告列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Announcement"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/announcements/<uuid:ann_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "公告详情",
        "parameters": [
          {
            "name": "ann_id",
            "in": "path",
            "description": "公告ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/announcements/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建公告",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Announcement"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/announcements/<uuid:ann_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新公告",
        "parameters": [
          {
            "name": "ann_id",
            "in": "path",
            "description": "公告ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Announcement"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/announcements/<uuid:ann_id>/delete/": {
      "delete": {
        "tags": [
          "Office"
        ],
        "summary": "删除公告",
        "parameters": [
          {
            "name": "ann_id",
            "in": "path",
            "description": "公告ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/supply-categories/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "办公用品分类",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SupplyCategory"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/supply-items/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "办公用品列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SupplyItem"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/supply-apply/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "办公用品申领列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SupplyApply"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/supply-apply/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建办公用品申领",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupplyApply"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/supply-apply/<int:app_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批办公用品申领",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/seal-types/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "印章类型",
        "responses": {
          "200": {
            "description": "印章类型",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "印章类型"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/seal-apply/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "用印申请列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SealApply"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/seal-apply/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建用印申请",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SealApply"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/seal-apply/<int:app_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批用印申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/attendance-stats/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "考勤统计",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "description": "开始日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "结束日期",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "考勤统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "考勤统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/leave-balance/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "假期余额列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/LeaveBalance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/leave-balance/<uuid:balance_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新假期余额",
        "parameters": [
          {
            "name": "balance_id",
            "in": "path",
            "description": "余额ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LeaveBalance"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "通用申请列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/OfficeApplication"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建通用申请",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OfficeApplication"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "通用申请详情",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新通用申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OfficeApplication"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/submit/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "提交申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/complete/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "完成申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/cancel/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "取消申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已取消",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已取消"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/applications/<uuid:app_id>/convert-to-purchase/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "转换为采购申请",
        "parameters": [
          {
            "name": "app_id",
            "in": "path",
            "description": "申请ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已转换",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已转换"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/application-items/<uuid:item_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新申请项",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "description": "项ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/asset-categories/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "资产分类列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/AssetCategory"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建资产分类",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetCategory"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/asset-categories/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建资产分类（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetCategory"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "资产列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Asset"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建资产",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Asset"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "资产详情",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新资产",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Asset"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/bind/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "绑定资产到用户",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已绑定",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已绑定"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/return/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "归还资产",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已归还",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已归还"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/transfer/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "调拨资产",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "to_user_id": "uuid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已调拨",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已调拨"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/repair/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "报修资产",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "reason": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已报修",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已报修"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/repair-complete/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "完成维修",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "维修完成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "维修完成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/scrap/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "报废资产",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已报废",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已报废"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/assets/<uuid:asset_id>/records/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "资产记录列表",
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "description": "资产ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/AssetRecord"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/user-assets/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "当前用户资产",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Asset"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "费用报销列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Expense"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建费用报销",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Expense"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/<uuid:expense_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "费用报销详情",
        "parameters": [
          {
            "name": "expense_id",
            "in": "path",
            "description": "费用ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/<uuid:expense_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新费用报销",
        "parameters": [
          {
            "name": "expense_id",
            "in": "path",
            "description": "费用ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Expense"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/<uuid:expense_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批费用报销",
        "parameters": [
          {
            "name": "expense_id",
            "in": "path",
            "description": "费用ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/expenses/<uuid:expense_id>/pay/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "支付费用报销",
        "parameters": [
          {
            "name": "expense_id",
            "in": "path",
            "description": "费用ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已支付",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已支付"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-templates/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "薪资模板列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalaryTemplate"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-templates/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建薪资模板",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalaryTemplate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-templates/<uuid:template_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新薪资模板",
        "parameters": [
          {
            "name": "template_id",
            "in": "path",
            "description": "模板ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalaryTemplate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "薪资记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SalaryRecord"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-generate/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "生成薪资",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "month": "2026-07"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已生成",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已生成"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/<uuid:record_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "薪资记录详情",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/<uuid:record_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新薪资记录",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SalaryRecord"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/<uuid:record_id>/confirm/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "确认薪资",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/<uuid:record_id>/approve/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "审批薪资",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-records/<uuid:record_id>/pay/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "发放薪资",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已发放",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已发放"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/hr-expenditures/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "人力支出列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/HRExpenditure"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/hr-expenditures/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建人力支出",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HRExpenditure"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/hr-expenditures/<uuid:expenditure_id>/pay/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "支付人力支出",
        "parameters": [
          {
            "name": "expenditure_id",
            "in": "path",
            "description": "支出ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已支付",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已支付"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/salary-stats/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "薪资统计",
        "parameters": [
          {
            "name": "month",
            "in": "query",
            "description": "月份",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "薪资统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "薪资统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/logistics/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "物流记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Logistics"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/logistics/create/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "创建物流记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Logistics"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/logistics/<uuid:record_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "物流记录详情",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/logistics/<uuid:record_id>/update/": {
      "put": {
        "tags": [
          "Office"
        ],
        "summary": "更新物流记录",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Logistics"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/logistics/<uuid:record_id>/status/": {
      "post": {
        "tags": [
          "Office"
        ],
        "summary": "更新物流状态",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "status": "delivered"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已更新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已更新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/personnel/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "人员列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/User"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/personnel/<uuid:user_id>/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "人员详情",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "description": "用户ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/departments/tree/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "部门树（办公模块）",
        "responses": {
          "200": {
            "description": "部门树",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "部门树"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/office/personnel-stats/": {
      "get": {
        "tags": [
          "Office"
        ],
        "summary": "人员统计",
        "responses": {
          "200": {
            "description": "人员统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "人员统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/admission/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "供应商准入列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Admission"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/admission/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建供应商准入",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Admission"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/admission/<uuid:adm_id>/review/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "审批供应商准入",
        "parameters": [
          {
            "name": "adm_id",
            "in": "path",
            "description": "准入ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "action": "approved"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已审批",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已审批"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/qualifications/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "供应商资质列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Qualification"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/qualifications/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建供应商资质",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Qualification"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/assessments/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "供应商考核列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Assessment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/assessments/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建供应商考核",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Assessment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/performance/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "供应商绩效列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/SupplierPerformance"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/performance/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建供应商绩效",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupplierPerformance"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/receiving/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "收货记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/GoodsReceipt"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/receiving/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建收货记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoodsReceipt"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/receiving/<uuid:receipt_id>/confirm/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "确认收货",
        "parameters": [
          {
            "name": "receipt_id",
            "in": "path",
            "description": "收货ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/reconciliation/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "对账记录列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Reconciliation"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/reconciliation/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建对账记录",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Reconciliation"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/prices/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "价格库列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Price"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/bidding/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "招投标项目列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BidProject"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/bidding/create/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "创建招投标项目",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BidProject"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/supplier-levels/": {
      "get": {
        "tags": [
          "SRM"
        ],
        "summary": "供应商等级统计",
        "responses": {
          "200": {
            "description": "等级统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "等级统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/suppliers/<uuid:supplier_id>/level/": {
      "put": {
        "tags": [
          "SRM"
        ],
        "summary": "更新供应商等级",
        "parameters": [
          {
            "name": "supplier_id",
            "in": "path",
            "description": "供应商ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "level": "A"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已更新",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已更新"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/orders/<uuid:order_id>/submit-approval/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "采购订单提交审批",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/contracts/<uuid:contract_id>/submit-approval/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "采购合同提交审批",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/srm/payments/<uuid:payment_id>/submit-approval/": {
      "post": {
        "tags": [
          "SRM"
        ],
        "summary": "付款提交审批",
        "parameters": [
          {
            "name": "payment_id",
            "in": "path",
            "description": "付款ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/login/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "供应商登录",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "username": "supplier1",
                "password": "******"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "登录成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "登录成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "example": {
                  "token": "..."
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/portal/supplier/api/register/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "供应商注册",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Supplier"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "注册成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "注册成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/portal/supplier/api/change-password/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "修改密码",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "old_password": "...",
                "new_password": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "密码已修改",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "密码已修改"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/profile/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "供应商资料",
        "responses": {
          "200": {
            "description": "供应商资料",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "供应商资料"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/profile/update/": {
      "put": {
        "tags": [
          "Portal"
        ],
        "summary": "更新供应商资料",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Supplier"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/dashboard/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "供应商门户首页",
        "responses": {
          "200": {
            "description": "首页数据",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "首页数据"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/orders/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "采购订单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PurchaseOrder"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/orders/<uuid:order_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "采购订单详情",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "订单详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "订单详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/orders/<uuid:order_id>/confirm/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "确认订单",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/orders/<uuid:order_id>/ship/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "发货",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "description": "订单ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "tracking_number": "..."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已发货",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已发货"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/quotations/pending/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "待报价列表",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Inquiry"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/quotations/submitted/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "已提交报价列表",
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Quotation"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/quotations/<uuid:quote_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "报价详情",
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "description": "报价ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/quotations/submit/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "提交报价",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Quotation"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已提交",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已提交"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/inquiries/<uuid:inquiry_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "询价单详情",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "description": "询价ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "询价详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "询价详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/qualifications/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的资质列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Qualification"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/qualifications/upload/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "上传资质",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "上传成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "上传成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/qualifications/<uuid:qual_id>/update/": {
      "put": {
        "tags": [
          "Portal"
        ],
        "summary": "更新资质",
        "parameters": [
          {
            "name": "qual_id",
            "in": "path",
            "description": "资质ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/qualifications/<uuid:qual_id>/delete/": {
      "delete": {
        "tags": [
          "Portal"
        ],
        "summary": "删除资质",
        "parameters": [
          {
            "name": "qual_id",
            "in": "path",
            "description": "资质ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/invoices/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的发票列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Invoice"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/invoices/<uuid:invoice_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "发票详情",
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "description": "发票ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/payments/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的付款记录",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Payment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/reconciliations/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的对账记录",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Reconciliation"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/reconciliations/<uuid:recon_id>/confirm/": {
      "post": {
        "tags": [
          "Portal"
        ],
        "summary": "确认对账",
        "parameters": [
          {
            "name": "recon_id",
            "in": "path",
            "description": "对账ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已确认",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已确认"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/contracts/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的合同列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Contract"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/contracts/<uuid:contract_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "合同详情",
        "parameters": [
          {
            "name": "contract_id",
            "in": "path",
            "description": "合同ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/receipts/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "我的收货单列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/GoodsReceipt"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/portal/supplier/api/receipts/<uuid:receipt_id>/": {
      "get": {
        "tags": [
          "Portal"
        ],
        "summary": "收货单详情",
        "parameters": [
          {
            "name": "receipt_id",
            "in": "path",
            "description": "收货ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/groups/": {
      "get": {
        "tags": [
          "Categories"
        ],
        "summary": "分类组列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CategoryGroup"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Categories"
        ],
        "summary": "创建分类组",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryGroup"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/groups/create/": {
      "post": {
        "tags": [
          "Categories"
        ],
        "summary": "创建分类组（别名）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryGroup"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/groups/<str:code>/": {
      "get": {
        "tags": [
          "Categories"
        ],
        "summary": "分类组详情",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Categories"
        ],
        "summary": "更新分类组",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryGroup"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Categories"
        ],
        "summary": "删除分类组",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/groups/<str:code>/update/": {
      "put": {
        "tags": [
          "Categories"
        ],
        "summary": "更新分类组（别名）",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryGroup"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/groups/<str:code>/delete/": {
      "delete": {
        "tags": [
          "Categories"
        ],
        "summary": "删除分类组（别名）",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/options/": {
      "get": {
        "tags": [
          "Categories"
        ],
        "summary": "分类选项列表",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "每页记录数（默认20，最大100；列表接口常用9999前端分页）",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "default": 20
            }
          },
          {
            "name": "ordering",
            "in": "query",
            "description": "排序字段，降序前加负号（例如 -created_at）",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "关键字搜索",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "列表查询成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 100
                        },
                        "next": {
                          "type": "string",
                          "nullable": true
                        },
                        "previous": {
                          "type": "string",
                          "nullable": true
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CategoryOption"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/options/create/": {
      "post": {
        "tags": [
          "Categories"
        ],
        "summary": "创建分类选项",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryOption"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "创建成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "创建成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/options/<uuid:option_id>/update/": {
      "put": {
        "tags": [
          "Categories"
        ],
        "summary": "更新分类选项",
        "parameters": [
          {
            "name": "option_id",
            "in": "path",
            "description": "选项ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CategoryOption"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "更新成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "更新成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/options/<uuid:option_id>/delete/": {
      "delete": {
        "tags": [
          "Categories"
        ],
        "summary": "删除分类选项",
        "parameters": [
          {
            "name": "option_id",
            "in": "path",
            "description": "选项ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "删除成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "删除成功"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/choices/<str:group_code>/": {
      "get": {
        "tags": [
          "Categories"
        ],
        "summary": "获取分类选项（表单用）",
        "parameters": [
          {
            "name": "group_code",
            "in": "path",
            "description": "分类组编码",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "选项列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "选项列表"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/choices-batch/": {
      "post": {
        "tags": [
          "Categories"
        ],
        "summary": "批量获取分类选项",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "group_codes": [
                  "industry"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "批量选项",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "批量选项"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/categories/bulk-import/": {
      "post": {
        "tags": [
          "Categories"
        ],
        "summary": "批量导入分类",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "items": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "已导入",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已导入"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/summary/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "性能汇总",
        "responses": {
          "200": {
            "description": "汇总",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "汇总"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/endpoints/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "端点指标",
        "responses": {
          "200": {
            "description": "端点指标",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "端点指标"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/endpoints/<path:path>/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "端点详情",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "description": "端点路径",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "端点详情",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "端点详情"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/slow-queries/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "慢查询",
        "responses": {
          "200": {
            "description": "慢查询",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "慢查询"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/database/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "数据库统计",
        "responses": {
          "200": {
            "description": "数据库统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "数据库统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/tables/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "表统计",
        "responses": {
          "200": {
            "description": "表统计",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "表统计"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/indexes/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "索引使用情况",
        "responses": {
          "200": {
            "description": "索引",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "索引"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/index-suggestions/": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "索引建议",
        "responses": {
          "200": {
            "description": "索引建议",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "索引建议"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/performance/clear/": {
      "post": {
        "tags": [
          "Performance"
        ],
        "summary": "清除性能指标",
        "responses": {
          "200": {
            "description": "已清除",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "已清除"
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT Token认证，格式：Bearer <token>"
      }
    },
    "schemas": {
      "SuccessResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": true
          },
          "message": {
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "example": "ERROR_CODE"
              },
              "message": {
                "type": "string",
                "example": "错误描述"
              },
              "details": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "PaginatedResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": true
          },
          "data": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "example": 100
              },
              "next": {
                "type": "string",
                "nullable": true
              },
              "previous": {
                "type": "string",
                "nullable": true
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "UUID": {
        "type": "string",
        "format": "uuid",
        "example": "550e8400-e29b-41d4-a716-446655440000"
      },
      "Timestamp": {
        "type": "string",
        "format": "date-time",
        "example": "2026-07-05T10:00:00Z"
      },
      "Date": {
        "type": "string",
        "format": "date",
        "example": "2026-07-05"
      },
      "EmptyRequest": {
        "type": "object",
        "additionalProperties": true
      },
      "User": {
        "type": "object",
        "description": "用户对象",
        "properties": {
          "user_id": {
            "type": "string",
            "format": "uuid",
            "description": "用户ID"
          },
          "username": {
            "type": "string",
            "description": "用户名"
          },
          "email": {
            "type": "string",
            "description": "邮箱",
            "format": "email"
          },
          "phone": {
            "type": "string",
            "description": "手机号"
          },
          "first_name": {
            "type": "string",
            "description": "姓"
          },
          "last_name": {
            "type": "string",
            "description": "名"
          },
          "display_name": {
            "type": "string",
            "description": "显示名"
          },
          "avatar": {
            "type": "string",
            "description": "头像URL"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          },
          "is_staff": {
            "type": "boolean",
            "description": "是否员工"
          },
          "is_superuser": {
            "type": "boolean",
            "description": "是否超管"
          },
          "date_joined": {
            "type": "string",
            "format": "date-time",
            "description": "注册时间"
          },
          "last_login": {
            "type": "string",
            "format": "date-time",
            "description": "最后登录时间"
          },
          "department_name": {
            "type": "string",
            "description": "主部门名"
          },
          "role_names": {
            "type": "array",
            "items": {
              "type": "string",
              "description": ""
            },
            "description": "角色名列表"
          }
        },
        "additionalProperties": true
      },
      "UserCreate": {
        "type": "object",
        "description": "创建用户请求",
        "properties": {
          "username": {
            "type": "string",
            "description": "用户名"
          },
          "password": {
            "type": "string",
            "description": "密码"
          },
          "email": {
            "type": "string",
            "description": "邮箱"
          },
          "phone": {
            "type": "string",
            "description": "手机号"
          },
          "first_name": {
            "type": "string",
            "description": "姓"
          },
          "last_name": {
            "type": "string",
            "description": "名"
          },
          "department_id": {
            "type": "string",
            "format": "uuid",
            "description": "主部门ID"
          },
          "role_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid",
              "description": ""
            },
            "description": "角色ID列表"
          }
        },
        "additionalProperties": true,
        "required": [
          "username",
          "password"
        ]
      },
      "Department": {
        "type": "object",
        "description": "部门",
        "properties": {
          "department_id": {
            "type": "string",
            "format": "uuid",
            "description": "部门ID"
          },
          "name": {
            "type": "string",
            "description": "部门名称"
          },
          "code": {
            "type": "string",
            "description": "部门编码"
          },
          "parent_id": {
            "type": "string",
            "format": "uuid",
            "description": "上级部门ID"
          },
          "parent_name": {
            "type": "string",
            "description": "上级部门名称"
          },
          "manager_id": {
            "type": "string",
            "format": "uuid",
            "description": "部门经理ID"
          },
          "manager_name": {
            "type": "string",
            "description": "部门经理名"
          },
          "sort_order": {
            "type": "integer",
            "description": "排序"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          },
          "member_count": {
            "type": "integer",
            "description": "成员数"
          }
        },
        "additionalProperties": true
      },
      "Role": {
        "type": "object",
        "description": "角色",
        "properties": {
          "role_id": {
            "type": "string",
            "format": "uuid",
            "description": "角色ID"
          },
          "role_name": {
            "type": "string",
            "description": "角色名称"
          },
          "role_code": {
            "type": "string",
            "description": "角色编码"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "is_system": {
            "type": "boolean",
            "description": "是否系统内置"
          },
          "user_count": {
            "type": "integer",
            "description": "用户数"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "description": "权限列表"
          }
        },
        "additionalProperties": true
      },
      "Permission": {
        "type": "object",
        "description": "权限",
        "properties": {
          "permission_id": {
            "type": "string",
            "format": "uuid",
            "description": "权限ID"
          },
          "permission_code": {
            "type": "string",
            "description": "权限编码"
          },
          "permission_name": {
            "type": "string",
            "description": "权限名称"
          },
          "module": {
            "type": "string",
            "description": "所属模块"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "Branch": {
        "type": "object",
        "description": "分支机构",
        "properties": {
          "branch_id": {
            "type": "string",
            "description": "分支机构ID"
          },
          "branch_name": {
            "type": "string",
            "description": "分支机构名称"
          },
          "branch_code": {
            "type": "string",
            "description": "编码"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          },
          "address": {
            "type": "string",
            "description": "地址"
          },
          "manager_name": {
            "type": "string",
            "description": "负责人"
          },
          "member_count": {
            "type": "integer",
            "description": "成员数"
          }
        },
        "additionalProperties": true
      },
      "Notification": {
        "type": "object",
        "description": "通知消息",
        "properties": {
          "notification_id": {
            "type": "string",
            "format": "uuid",
            "description": "通知ID"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "type": {
            "type": "string",
            "description": "类型"
          },
          "level": {
            "type": "string",
            "description": "级别"
          },
          "is_read": {
            "type": "boolean",
            "description": "是否已读"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "sender_name": {
            "type": "string",
            "description": "发送人"
          },
          "link": {
            "type": "string",
            "description": "跳转链接"
          }
        },
        "additionalProperties": true
      },
      "Attendance": {
        "type": "object",
        "description": "考勤记录",
        "properties": {
          "attendance_id": {
            "type": "string",
            "format": "uuid",
            "description": "考勤ID"
          },
          "user_id": {
            "type": "string",
            "format": "uuid",
            "description": "用户ID"
          },
          "user_name": {
            "type": "string",
            "description": "用户名"
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "考勤日期"
          },
          "check_in_time": {
            "type": "string",
            "format": "date-time",
            "description": "签到时间"
          },
          "check_out_time": {
            "type": "string",
            "format": "date-time",
            "description": "签退时间"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "work_hours": {
            "type": "number",
            "description": "工作时长"
          }
        },
        "additionalProperties": true
      },
      "BankAccount": {
        "type": "object",
        "description": "银行账户",
        "properties": {
          "account_id": {
            "type": "string",
            "format": "uuid",
            "description": "账户ID"
          },
          "bank_name": {
            "type": "string",
            "description": "银行名称"
          },
          "account_name": {
            "type": "string",
            "description": "账户名"
          },
          "account_number": {
            "type": "string",
            "description": "账号"
          },
          "branch_name": {
            "type": "string",
            "description": "支行"
          },
          "is_default": {
            "type": "boolean",
            "description": "是否默认"
          },
          "balance": {
            "type": "number",
            "description": "余额"
          }
        },
        "additionalProperties": true
      },
      "WorkflowDefinition": {
        "type": "object",
        "description": "工作流定义",
        "properties": {
          "workflow_id": {
            "type": "string",
            "description": "工作流ID"
          },
          "name": {
            "type": "string",
            "description": "工作流名称"
          },
          "code": {
            "type": "string",
            "description": "工作流编码"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          },
          "version": {
            "type": "integer",
            "description": "版本"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "WorkflowNode": {
        "type": "object",
        "description": "工作流节点",
        "properties": {
          "node_id": {
            "type": "string",
            "description": "节点ID"
          },
          "workflow_id": {
            "type": "string",
            "description": "工作流ID"
          },
          "node_name": {
            "type": "string",
            "description": "节点名称"
          },
          "node_type": {
            "type": "string",
            "description": "节点类型（start/approve/cc/end）"
          },
          "approver_type": {
            "type": "string",
            "description": "审批人类型"
          },
          "approver_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid",
              "description": ""
            },
            "description": "审批人ID列表"
          },
          "sort_order": {
            "type": "integer",
            "description": "排序"
          }
        },
        "additionalProperties": true
      },
      "WorkflowNodeLink": {
        "type": "object",
        "description": "工作流连线",
        "properties": {
          "link_id": {
            "type": "string",
            "description": "连线ID"
          },
          "source_node_id": {
            "type": "string",
            "description": "源节点ID"
          },
          "target_node_id": {
            "type": "string",
            "description": "目标节点ID"
          },
          "condition": {
            "type": "string",
            "description": "条件表达式"
          }
        },
        "additionalProperties": true
      },
      "ModuleWorkflowConfig": {
        "type": "object",
        "description": "模块工作流配置",
        "properties": {
          "config_id": {
            "type": "string",
            "format": "uuid",
            "description": "配置ID"
          },
          "module_name": {
            "type": "string",
            "description": "模块名（业务类型）"
          },
          "module_label": {
            "type": "string",
            "description": "模块显示名"
          },
          "workflow_id": {
            "type": "string",
            "description": "关联工作流ID"
          },
          "workflow_name": {
            "type": "string",
            "description": "关联工作流名"
          },
          "is_enabled": {
            "type": "boolean",
            "description": "是否启用"
          }
        },
        "additionalProperties": true
      },
      "ApprovalInstance": {
        "type": "object",
        "description": "审批实例",
        "properties": {
          "instance_id": {
            "type": "string",
            "format": "uuid",
            "description": "审批实例ID"
          },
          "workflow_id": {
            "type": "string",
            "description": "工作流ID"
          },
          "business_type": {
            "type": "string",
            "description": "业务类型"
          },
          "business_id": {
            "type": "string",
            "description": "业务对象ID"
          },
          "title": {
            "type": "string",
            "description": "审批标题"
          },
          "content": {
            "type": "string",
            "description": "审批内容"
          },
          "status": {
            "type": "string",
            "description": "状态（pending/approved/rejected/returned/cancelled）"
          },
          "submitter_id": {
            "type": "string",
            "format": "uuid",
            "description": "提交人ID"
          },
          "submitter_name": {
            "type": "string",
            "description": "提交人名"
          },
          "current_step_name": {
            "type": "string",
            "description": "当前步骤名"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "完成时间"
          }
        },
        "additionalProperties": true
      },
      "ApprovalHistory": {
        "type": "object",
        "description": "审批历史",
        "properties": {
          "history_id": {
            "type": "string",
            "format": "uuid",
            "description": "历史ID"
          },
          "instance_id": {
            "type": "string",
            "format": "uuid",
            "description": "审批实例ID"
          },
          "step_name": {
            "type": "string",
            "description": "步骤名"
          },
          "operator_id": {
            "type": "string",
            "format": "uuid",
            "description": "操作人ID"
          },
          "operator_name": {
            "type": "string",
            "description": "操作人名"
          },
          "action": {
            "type": "string",
            "description": "操作（submit/approve/reject/return/transfer/skip）"
          },
          "comment": {
            "type": "string",
            "description": "审批意见"
          },
          "operated_at": {
            "type": "string",
            "format": "date-time",
            "description": "操作时间"
          }
        },
        "additionalProperties": true
      },
      "ApprovalTransfer": {
        "type": "object",
        "description": "审批转办记录",
        "properties": {
          "transfer_id": {
            "type": "string",
            "format": "uuid",
            "description": "转办ID"
          },
          "step_id": {
            "type": "string",
            "format": "uuid",
            "description": "步骤ID"
          },
          "from_user_id": {
            "type": "string",
            "format": "uuid",
            "description": "原审批人ID"
          },
          "from_user_name": {
            "type": "string",
            "description": "原审批人名"
          },
          "to_user_id": {
            "type": "string",
            "format": "uuid",
            "description": "新审批人ID"
          },
          "to_user_name": {
            "type": "string",
            "description": "新审批人名"
          },
          "reason": {
            "type": "string",
            "description": "转办理由"
          },
          "transferred_at": {
            "type": "string",
            "format": "date-time",
            "description": "转办时间"
          }
        },
        "additionalProperties": true
      },
      "Project": {
        "type": "object",
        "description": "研发项目",
        "properties": {
          "project_id": {
            "type": "string",
            "format": "uuid",
            "description": "项目ID"
          },
          "project_name": {
            "type": "string",
            "description": "项目名称"
          },
          "project_code": {
            "type": "string",
            "description": "项目编码"
          },
          "description": {
            "type": "string",
            "description": "项目描述"
          },
          "status": {
            "type": "string",
            "description": "状态（planning/in_progress/completed/cancelled）"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "progress": {
            "type": "integer",
            "description": "进度百分比"
          },
          "manager_id": {
            "type": "string",
            "format": "uuid",
            "description": "项目经理ID"
          },
          "manager_name": {
            "type": "string",
            "description": "项目经理名"
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/User"
            },
            "description": "成员列表"
          },
          "task_count": {
            "type": "integer",
            "description": "任务数"
          },
          "completed_task_count": {
            "type": "integer",
            "description": "已完成任务数"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "Task": {
        "type": "object",
        "description": "项目任务",
        "properties": {
          "task_id": {
            "type": "string",
            "format": "uuid",
            "description": "任务ID"
          },
          "project_id": {
            "type": "string",
            "format": "uuid",
            "description": "所属项目ID"
          },
          "task_name": {
            "type": "string",
            "description": "任务名称"
          },
          "description": {
            "type": "string",
            "description": "任务描述"
          },
          "status": {
            "type": "string",
            "description": "状态（todo/in_progress/completed/cancelled）"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "assignee_id": {
            "type": "string",
            "format": "uuid",
            "description": "负责人ID"
          },
          "assignee_name": {
            "type": "string",
            "description": "负责人名"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "完成时间"
          },
          "dependencies": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid",
              "description": ""
            },
            "description": "依赖任务ID列表"
          },
          "comments": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "content": {
                  "type": "string",
                  "description": ""
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "评论列表"
          }
        },
        "additionalProperties": true
      },
      "Milestone": {
        "type": "object",
        "description": "项目里程碑",
        "properties": {
          "milestone_id": {
            "type": "string",
            "format": "uuid",
            "description": "里程碑ID"
          },
          "project_id": {
            "type": "string",
            "format": "uuid",
            "description": "项目ID"
          },
          "name": {
            "type": "string",
            "description": "里程碑名称"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "is_completed": {
            "type": "boolean",
            "description": "是否已完成"
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "完成时间"
          }
        },
        "additionalProperties": true
      },
      "Attachment": {
        "type": "object",
        "description": "通用附件",
        "properties": {
          "attachment_id": {
            "type": "string",
            "format": "uuid",
            "description": "附件ID"
          },
          "file_name": {
            "type": "string",
            "description": "文件名"
          },
          "file_size": {
            "type": "integer",
            "description": "文件大小（字节）"
          },
          "file_type": {
            "type": "string",
            "description": "文件类型"
          },
          "file_url": {
            "type": "string",
            "description": "下载URL"
          },
          "uploaded_by": {
            "type": "string",
            "description": "上传人"
          },
          "uploaded_at": {
            "type": "string",
            "format": "date-time",
            "description": "上传时间"
          }
        },
        "additionalProperties": true
      },
      "Customer": {
        "type": "object",
        "description": "客户",
        "properties": {
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名称"
          },
          "customer_code": {
            "type": "string",
            "description": "客户编码"
          },
          "customer_type": {
            "type": "string",
            "description": "客户类型"
          },
          "customer_type_display": {
            "type": "string",
            "description": "客户类型显示名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "status_display": {
            "type": "string",
            "description": "状态显示名"
          },
          "contact_person": {
            "type": "string",
            "description": "联系人"
          },
          "contact_phone": {
            "type": "string",
            "description": "联系电话"
          },
          "contact_email": {
            "type": "string",
            "description": "联系邮箱"
          },
          "address": {
            "type": "string",
            "description": "详细地址"
          },
          "province": {
            "type": "string",
            "description": "省"
          },
          "city": {
            "type": "string",
            "description": "市"
          },
          "industry": {
            "type": "string",
            "description": "行业"
          },
          "credit_limit": {
            "type": "number",
            "description": "信用额度"
          },
          "salesperson_name": {
            "type": "string",
            "description": "销售员名"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "SalesOrder": {
        "type": "object",
        "description": "销售订单",
        "properties": {
          "order_id": {
            "type": "string",
            "format": "uuid",
            "description": "订单ID"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "order_name": {
            "type": "string",
            "description": "订单名称"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "salesperson_id": {
            "type": "string",
            "format": "uuid",
            "description": "销售员ID"
          },
          "salesperson_name": {
            "type": "string",
            "description": "销售员名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "status_display": {
            "type": "string",
            "description": "状态显示"
          },
          "order_date": {
            "type": "string",
            "format": "date",
            "description": "下单日期"
          },
          "required_date": {
            "type": "string",
            "format": "date",
            "description": "需求日期"
          },
          "shipping_address": {
            "type": "string",
            "description": "收货地址"
          },
          "shipping_contact": {
            "type": "string",
            "description": "收货人"
          },
          "shipping_phone": {
            "type": "string",
            "description": "收货电话"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "product_name": {
                  "type": "string",
                  "description": "产品名"
                },
                "specification": {
                  "type": "string",
                  "description": "规格"
                },
                "quantity": {
                  "type": "number",
                  "description": "数量"
                },
                "unit": {
                  "type": "string",
                  "description": "单位"
                },
                "unit_price": {
                  "type": "number",
                  "description": "单价"
                },
                "line_total": {
                  "type": "number",
                  "description": "行小计"
                }
              },
              "additionalProperties": true
            },
            "description": "订单明细"
          },
          "subtotal": {
            "type": "number",
            "description": "小计"
          },
          "tax_rate": {
            "type": "number",
            "description": "税率"
          },
          "tax_amount": {
            "type": "number",
            "description": "税额"
          },
          "shipping_cost": {
            "type": "number",
            "description": "运费"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Contact": {
        "type": "object",
        "description": "联系人",
        "properties": {
          "contact_id": {
            "type": "string",
            "format": "uuid",
            "description": "联系人ID"
          },
          "contact_name": {
            "type": "string",
            "description": "联系人姓名"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "position": {
            "type": "string",
            "description": "职位"
          },
          "contact_phone": {
            "type": "string",
            "description": "电话"
          },
          "contact_email": {
            "type": "string",
            "description": "邮箱"
          },
          "is_primary": {
            "type": "boolean",
            "description": "是否主要联系人"
          }
        },
        "additionalProperties": true
      },
      "Opportunity": {
        "type": "object",
        "description": "商机",
        "properties": {
          "opportunity_id": {
            "type": "string",
            "format": "uuid",
            "description": "商机ID"
          },
          "opportunity_name": {
            "type": "string",
            "description": "商机名称"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "stage": {
            "type": "string",
            "description": "阶段"
          },
          "amount": {
            "type": "number",
            "description": "金额"
          },
          "expected_close_date": {
            "type": "string",
            "format": "date",
            "description": "预计成交日期"
          },
          "salesperson_id": {
            "type": "string",
            "format": "uuid",
            "description": "销售员ID"
          },
          "salesperson_name": {
            "type": "string",
            "description": "销售员名"
          },
          "probability": {
            "type": "integer",
            "description": "成交概率(%)"
          },
          "source": {
            "type": "string",
            "description": "商机来源"
          }
        },
        "additionalProperties": true
      },
      "Quotation": {
        "type": "object",
        "description": "报价单",
        "properties": {
          "quotation_id": {
            "type": "string",
            "format": "uuid",
            "description": "报价单ID"
          },
          "quotation_number": {
            "type": "string",
            "description": "报价单号"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "opportunity_id": {
            "type": "string",
            "format": "uuid",
            "description": "商机ID"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "quotation_date": {
            "type": "string",
            "format": "date",
            "description": "报价日期"
          },
          "valid_until": {
            "type": "string",
            "format": "date",
            "description": "有效期至"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Contract": {
        "type": "object",
        "description": "合同",
        "properties": {
          "contract_id": {
            "type": "string",
            "format": "uuid",
            "description": "合同ID"
          },
          "contract_number": {
            "type": "string",
            "description": "合同号"
          },
          "contract_name": {
            "type": "string",
            "description": "合同名称"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "supplier_id": {
            "type": "string",
            "format": "uuid",
            "description": "供应商ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "sign_date": {
            "type": "string",
            "format": "date",
            "description": "签署日期"
          },
          "effective_date": {
            "type": "string",
            "format": "date",
            "description": "生效日期"
          },
          "expiry_date": {
            "type": "string",
            "format": "date",
            "description": "到期日期"
          },
          "total_amount": {
            "type": "number",
            "description": "合同金额"
          },
          "payment_terms": {
            "type": "string",
            "description": "付款条款"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Shipment": {
        "type": "object",
        "description": "发货单",
        "properties": {
          "shipment_id": {
            "type": "string",
            "format": "uuid",
            "description": "发货单ID"
          },
          "shipment_number": {
            "type": "string",
            "description": "发货单号"
          },
          "order_id": {
            "type": "string",
            "format": "uuid",
            "description": "订单ID"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "shipment_date": {
            "type": "string",
            "format": "date",
            "description": "发货日期"
          },
          "logistics_company": {
            "type": "string",
            "description": "物流公司"
          },
          "tracking_number": {
            "type": "string",
            "description": "运单号"
          },
          "shipment_amount": {
            "type": "number",
            "description": "发货金额"
          },
          "recipient_name": {
            "type": "string",
            "description": "收货人"
          },
          "recipient_phone": {
            "type": "string",
            "description": "收货电话"
          },
          "delivery_address": {
            "type": "string",
            "description": "收货地址"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "product_name": {
                  "type": "string",
                  "description": ""
                },
                "shipped_quantity": {
                  "type": "number",
                  "description": ""
                },
                "unit": {
                  "type": "string",
                  "description": ""
                },
                "notes": {
                  "type": "string",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "发货明细"
          },
          "qrcode_data": {
            "type": "string",
            "description": "二维码数据"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Return": {
        "type": "object",
        "description": "退货单",
        "properties": {
          "return_id": {
            "type": "string",
            "format": "uuid",
            "description": "退货单ID"
          },
          "return_number": {
            "type": "string",
            "description": "退货单号"
          },
          "order_number": {
            "type": "string",
            "description": "原订单号"
          },
          "shipment_number": {
            "type": "string",
            "description": "原发货单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "return_date": {
            "type": "string",
            "format": "date",
            "description": "退货日期"
          },
          "return_quantity": {
            "type": "number",
            "description": "退货数量"
          },
          "return_amount": {
            "type": "number",
            "description": "退货金额"
          },
          "return_reason": {
            "type": "string",
            "description": "退货原因"
          },
          "reason_description": {
            "type": "string",
            "description": "原因描述"
          },
          "quality_issue": {
            "type": "string",
            "description": "质量问题"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "contact_name": {
            "type": "string",
            "description": "联系人"
          },
          "contact_phone": {
            "type": "string",
            "description": "联系电话"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "product_code": {
            "type": "string",
            "description": "产品编码"
          },
          "original_quantity": {
            "type": "number",
            "description": "原数量"
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string",
              "description": ""
            },
            "description": "图片URL列表"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Payment": {
        "type": "object",
        "description": "回款/付款记录",
        "properties": {
          "payment_id": {
            "type": "string",
            "format": "uuid",
            "description": "回款/付款ID"
          },
          "payment_number": {
            "type": "string",
            "description": "单号"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "contract_number": {
            "type": "string",
            "description": "合同号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "expected_date": {
            "type": "string",
            "format": "date",
            "description": "预计日期"
          },
          "payment_date": {
            "type": "string",
            "format": "date",
            "description": "实际日期"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "paid_amount": {
            "type": "number",
            "description": "已付金额"
          },
          "remaining_amount": {
            "type": "number",
            "description": "剩余金额"
          },
          "payment_rate": {
            "type": "number",
            "description": "付款比例"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "contact_name": {
            "type": "string",
            "description": "联系人"
          },
          "contact_phone": {
            "type": "string",
            "description": "联系电话"
          },
          "payment_history": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "amount": {
                  "type": "number",
                  "description": ""
                },
                "payment_method": {
                  "type": "string",
                  "description": ""
                },
                "payment_date": {
                  "type": "string",
                  "format": "date",
                  "description": ""
                },
                "notes": {
                  "type": "string",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "付款历史"
          },
          "is_overdue": {
            "type": "boolean",
            "description": "是否逾期"
          },
          "overdue_days": {
            "type": "integer",
            "description": "逾期天数"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Batch": {
        "type": "object",
        "description": "发货批次",
        "properties": {
          "batch_id": {
            "type": "string",
            "format": "uuid",
            "description": "批次ID"
          },
          "batch_number": {
            "type": "string",
            "description": "批次号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "created_date": {
            "type": "string",
            "format": "date",
            "description": "创建日期"
          },
          "shipment_count": {
            "type": "integer",
            "description": "发货单数"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "shipments": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "发货单列表"
          }
        },
        "additionalProperties": true
      },
      "Invoice": {
        "type": "object",
        "description": "发票",
        "properties": {
          "invoice_id": {
            "type": "string",
            "format": "uuid",
            "description": "发票ID"
          },
          "invoice_number": {
            "type": "string",
            "description": "发票号"
          },
          "invoice_type": {
            "type": "string",
            "description": "发票类型"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "invoice_date": {
            "type": "string",
            "format": "date",
            "description": "开票日期"
          },
          "amount": {
            "type": "number",
            "description": "发票金额"
          },
          "tax_amount": {
            "type": "number",
            "description": "税额"
          },
          "total_amount": {
            "type": "number",
            "description": "价税合计"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "PaymentPlan": {
        "type": "object",
        "description": "回款计划",
        "properties": {
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "计划ID"
          },
          "contract_id": {
            "type": "string",
            "format": "uuid",
            "description": "合同ID"
          },
          "plan_date": {
            "type": "string",
            "format": "date",
            "description": "计划日期"
          },
          "planned_amount": {
            "type": "number",
            "description": "计划金额"
          },
          "actual_amount": {
            "type": "number",
            "description": "实际金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "WorkReport": {
        "type": "object",
        "description": "工作报告",
        "properties": {
          "report_id": {
            "type": "string",
            "format": "uuid",
            "description": "报告ID"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "report_type": {
            "type": "string",
            "description": "报告类型"
          },
          "period_start": {
            "type": "string",
            "format": "date",
            "description": "周期开始"
          },
          "period_end": {
            "type": "string",
            "format": "date",
            "description": "周期结束"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "submitter_name": {
            "type": "string",
            "description": "提交人"
          },
          "submitted_at": {
            "type": "string",
            "format": "date-time",
            "description": "提交时间"
          }
        },
        "additionalProperties": true
      },
      "SalesTeam": {
        "type": "object",
        "description": "销售团队",
        "properties": {
          "team_id": {
            "type": "string",
            "format": "uuid",
            "description": "团队ID"
          },
          "team_name": {
            "type": "string",
            "description": "团队名称"
          },
          "leader_id": {
            "type": "string",
            "format": "uuid",
            "description": "团队负责人ID"
          },
          "leader_name": {
            "type": "string",
            "description": "负责人名"
          },
          "member_count": {
            "type": "integer",
            "description": "成员数"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "CreditNote": {
        "type": "object",
        "description": "贷项通知单",
        "properties": {
          "credit_note_id": {
            "type": "string",
            "format": "uuid",
            "description": "贷项ID"
          },
          "credit_note_number": {
            "type": "string",
            "description": "单号"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "amount": {
            "type": "number",
            "description": "金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "reason": {
            "type": "string",
            "description": "原因"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "Reconciliation": {
        "type": "object",
        "description": "对账单",
        "properties": {
          "reconciliation_id": {
            "type": "string",
            "format": "uuid",
            "description": "对账单ID"
          },
          "reconciliation_number": {
            "type": "string",
            "description": "对账单号"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "total_amount": {
            "type": "number",
            "description": "对账总额"
          },
          "matched_amount": {
            "type": "number",
            "description": "已匹配金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReconciliationItem"
            },
            "description": "对账明细"
          }
        },
        "additionalProperties": true
      },
      "ReconciliationItem": {
        "type": "object",
        "description": "对账明细",
        "properties": {
          "item_id": {
            "type": "string",
            "format": "uuid",
            "description": "明细ID"
          },
          "doc_type": {
            "type": "string",
            "description": "单据类型"
          },
          "doc_number": {
            "type": "string",
            "description": "单据号"
          },
          "amount": {
            "type": "number",
            "description": "金额"
          },
          "matched_amount": {
            "type": "number",
            "description": "已匹配金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "Collection": {
        "type": "object",
        "description": "催收记录",
        "properties": {
          "collection_id": {
            "type": "string",
            "format": "uuid",
            "description": "催收ID"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "overdue_amount": {
            "type": "number",
            "description": "逾期金额"
          },
          "overdue_days": {
            "type": "integer",
            "description": "逾期天数"
          },
          "collection_method": {
            "type": "string",
            "description": "催收方式"
          },
          "collection_date": {
            "type": "string",
            "format": "date",
            "description": "催收日期"
          },
          "result": {
            "type": "string",
            "description": "催收结果"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "OrderChange": {
        "type": "object",
        "description": "订单变更",
        "properties": {
          "change_id": {
            "type": "string",
            "format": "uuid",
            "description": "变更ID"
          },
          "order_id": {
            "type": "string",
            "format": "uuid",
            "description": "订单ID"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "change_type": {
            "type": "string",
            "description": "变更类型"
          },
          "reason": {
            "type": "string",
            "description": "变更原因"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "before_data": {
            "type": "object",
            "description": "",
            "properties": {},
            "additionalProperties": true,
            "required": "变更前数据"
          },
          "after_data": {
            "type": "object",
            "description": "",
            "properties": {},
            "additionalProperties": true,
            "required": "变更后数据"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "DeliveryException": {
        "type": "object",
        "description": "发货异常",
        "properties": {
          "exception_id": {
            "type": "string",
            "format": "uuid",
            "description": "异常ID"
          },
          "shipment_id": {
            "type": "string",
            "format": "uuid",
            "description": "发货单ID"
          },
          "shipment_number": {
            "type": "string",
            "description": "发货单号"
          },
          "exception_type": {
            "type": "string",
            "description": "异常类型"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "resolved_at": {
            "type": "string",
            "format": "date-time",
            "description": "解决时间"
          }
        },
        "additionalProperties": true
      },
      "ReceivableLedger": {
        "type": "object",
        "description": "应收账单",
        "properties": {
          "contract_id": {
            "type": "string",
            "format": "uuid",
            "description": "合同ID"
          },
          "contract_number": {
            "type": "string",
            "description": "合同号"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "total_amount": {
            "type": "number",
            "description": "应收金额"
          },
          "received_amount": {
            "type": "number",
            "description": "已收金额"
          },
          "remaining_amount": {
            "type": "number",
            "description": "剩余金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "ReceiptNote": {
        "type": "object",
        "description": "收货单",
        "properties": {
          "receipt_note_id": {
            "type": "string",
            "format": "uuid",
            "description": "收货单ID"
          },
          "receipt_number": {
            "type": "string",
            "description": "收货单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "received_date": {
            "type": "string",
            "format": "date",
            "description": "收货日期"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          }
        },
        "additionalProperties": true
      },
      "FollowUp": {
        "type": "object",
        "description": "客户跟进记录",
        "properties": {
          "follow_up_id": {
            "type": "string",
            "format": "uuid",
            "description": "跟进ID"
          },
          "customer_id": {
            "type": "string",
            "format": "uuid",
            "description": "客户ID"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "follow_up_type": {
            "type": "string",
            "description": "跟进方式"
          },
          "content": {
            "type": "string",
            "description": "跟进内容"
          },
          "next_follow_up_date": {
            "type": "string",
            "format": "date",
            "description": "下次跟进日期"
          },
          "follow_up_by": {
            "type": "string",
            "description": "跟进人"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "跟进时间"
          }
        },
        "additionalProperties": true
      },
      "Product": {
        "type": "object",
        "description": "产品/物料",
        "properties": {
          "item_id": {
            "type": "string",
            "format": "uuid",
            "description": "产品/物料ID"
          },
          "item_code": {
            "type": "string",
            "description": "编码"
          },
          "item_name": {
            "type": "string",
            "description": "名称"
          },
          "specification": {
            "type": "string",
            "description": "规格"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "category_id": {
            "type": "string",
            "format": "uuid",
            "description": "类别ID"
          },
          "category_name": {
            "type": "string",
            "description": "类别名"
          },
          "price": {
            "type": "number",
            "description": "单价"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          }
        },
        "additionalProperties": true
      },
      "Supplier": {
        "type": "object",
        "description": "供应商",
        "properties": {
          "supplier_id": {
            "type": "string",
            "format": "uuid",
            "description": "供应商ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名称"
          },
          "supplier_code": {
            "type": "string",
            "description": "供应商编码"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "contact_person": {
            "type": "string",
            "description": "联系人"
          },
          "contact_phone": {
            "type": "string",
            "description": "联系电话"
          },
          "contact_email": {
            "type": "string",
            "description": "联系邮箱"
          },
          "address": {
            "type": "string",
            "description": "详细地址"
          },
          "province": {
            "type": "string",
            "description": "省"
          },
          "city": {
            "type": "string",
            "description": "市"
          },
          "payment_terms": {
            "type": "string",
            "description": "付款条件"
          },
          "level": {
            "type": "string",
            "description": "供应商等级"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Inquiry": {
        "type": "object",
        "description": "询价单",
        "properties": {
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "description": "询价单ID"
          },
          "inquiry_number": {
            "type": "string",
            "description": "询价单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "inquiry_date": {
            "type": "string",
            "format": "date",
            "description": "询价日期"
          },
          "deadline": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "询价明细"
          },
          "quotations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Quotation"
            },
            "description": "报价列表"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "PurchaseRequest": {
        "type": "object",
        "description": "采购申请",
        "properties": {
          "request_id": {
            "type": "string",
            "format": "uuid",
            "description": "采购申请ID"
          },
          "request_number": {
            "type": "string",
            "description": "申请单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "requester_name": {
            "type": "string",
            "description": "申请人"
          },
          "department_name": {
            "type": "string",
            "description": "申请部门"
          },
          "required_date": {
            "type": "string",
            "format": "date",
            "description": "需求日期"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          },
          "purpose": {
            "type": "string",
            "description": "采购用途"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "PurchaseOrder": {
        "type": "object",
        "description": "采购订单",
        "properties": {
          "order_id": {
            "type": "string",
            "format": "uuid",
            "description": "采购订单ID"
          },
          "order_number": {
            "type": "string",
            "description": "订单号"
          },
          "supplier_id": {
            "type": "string",
            "format": "uuid",
            "description": "供应商ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "order_date": {
            "type": "string",
            "format": "date",
            "description": "下单日期"
          },
          "required_date": {
            "type": "string",
            "format": "date",
            "description": "需求日期"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "product_name": {
                  "type": "string",
                  "description": ""
                },
                "quantity": {
                  "type": "number",
                  "description": ""
                },
                "unit": {
                  "type": "string",
                  "description": ""
                },
                "unit_price": {
                  "type": "number",
                  "description": ""
                },
                "line_total": {
                  "type": "number",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "明细"
          },
          "total_amount": {
            "type": "number",
            "description": "总金额"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Channel": {
        "type": "object",
        "description": "采购渠道",
        "properties": {
          "channel_id": {
            "type": "string",
            "format": "uuid",
            "description": "渠道ID"
          },
          "channel_name": {
            "type": "string",
            "description": "渠道名称"
          },
          "channel_type": {
            "type": "string",
            "description": "渠道类型"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          }
        },
        "additionalProperties": true
      },
      "Material": {
        "type": "object",
        "description": "物料",
        "properties": {
          "material_id": {
            "type": "string",
            "format": "uuid",
            "description": "物料ID"
          },
          "material_code": {
            "type": "string",
            "description": "物料编码"
          },
          "material_name": {
            "type": "string",
            "description": "物料名称"
          },
          "specification": {
            "type": "string",
            "description": "规格"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "category": {
            "type": "string",
            "description": "类别"
          },
          "price": {
            "type": "number",
            "description": "单价"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "Price": {
        "type": "object",
        "description": "价格记录",
        "properties": {
          "price_id": {
            "type": "string",
            "format": "uuid",
            "description": "价格ID"
          },
          "material_id": {
            "type": "string",
            "format": "uuid",
            "description": "物料ID"
          },
          "material_name": {
            "type": "string",
            "description": "物料名"
          },
          "supplier_id": {
            "type": "string",
            "format": "uuid",
            "description": "供应商ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "price": {
            "type": "number",
            "description": "价格"
          },
          "currency": {
            "type": "string",
            "description": "币种"
          },
          "min_quantity": {
            "type": "number",
            "description": "起订量"
          },
          "valid_from": {
            "type": "string",
            "format": "date",
            "description": "生效日期"
          },
          "valid_to": {
            "type": "string",
            "format": "date",
            "description": "失效日期"
          }
        },
        "additionalProperties": true
      },
      "Warehouse": {
        "type": "object",
        "description": "仓库",
        "properties": {
          "warehouse_id": {
            "type": "string",
            "format": "uuid",
            "description": "仓库ID"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库名称"
          },
          "warehouse_code": {
            "type": "string",
            "description": "仓库编码"
          },
          "address": {
            "type": "string",
            "description": "地址"
          },
          "manager_name": {
            "type": "string",
            "description": "负责人"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          }
        },
        "additionalProperties": true
      },
      "Stock": {
        "type": "object",
        "description": "库存",
        "properties": {
          "stock_id": {
            "type": "string",
            "format": "uuid",
            "description": "库存ID"
          },
          "material_id": {
            "type": "string",
            "format": "uuid",
            "description": "物料ID"
          },
          "material_name": {
            "type": "string",
            "description": "物料名"
          },
          "warehouse_id": {
            "type": "string",
            "format": "uuid",
            "description": "仓库ID"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库名"
          },
          "quantity": {
            "type": "number",
            "description": "库存数量"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "safety_stock": {
            "type": "number",
            "description": "安全库存"
          },
          "available_quantity": {
            "type": "number",
            "description": "可用库存"
          }
        },
        "additionalProperties": true
      },
      "Inbound": {
        "type": "object",
        "description": "入库单",
        "properties": {
          "inbound_id": {
            "type": "string",
            "format": "uuid",
            "description": "入库ID"
          },
          "inbound_number": {
            "type": "string",
            "description": "入库单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "inbound_date": {
            "type": "string",
            "format": "date",
            "description": "入库日期"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库"
          },
          "source": {
            "type": "string",
            "description": "来源"
          },
          "total_quantity": {
            "type": "number",
            "description": "总数量"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "入库明细"
          }
        },
        "additionalProperties": true
      },
      "Outbound": {
        "type": "object",
        "description": "出库单",
        "properties": {
          "outbound_id": {
            "type": "string",
            "format": "uuid",
            "description": "出库ID"
          },
          "outbound_number": {
            "type": "string",
            "description": "出库单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "outbound_date": {
            "type": "string",
            "format": "date",
            "description": "出库日期"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库"
          },
          "destination": {
            "type": "string",
            "description": "去向"
          },
          "total_quantity": {
            "type": "number",
            "description": "总数量"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "出库明细"
          }
        },
        "additionalProperties": true
      },
      "Transfer": {
        "type": "object",
        "description": "调拨单",
        "properties": {
          "transfer_id": {
            "type": "string",
            "format": "uuid",
            "description": "调拨ID"
          },
          "transfer_number": {
            "type": "string",
            "description": "调拨单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "transfer_date": {
            "type": "string",
            "format": "date",
            "description": "调拨日期"
          },
          "from_warehouse_name": {
            "type": "string",
            "description": "源仓库"
          },
          "to_warehouse_name": {
            "type": "string",
            "description": "目标仓库"
          },
          "total_quantity": {
            "type": "number",
            "description": "总数量"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "调拨明细"
          }
        },
        "additionalProperties": true
      },
      "Stocktaking": {
        "type": "object",
        "description": "盘点单",
        "properties": {
          "stocktaking_id": {
            "type": "string",
            "format": "uuid",
            "description": "盘点ID"
          },
          "stocktaking_number": {
            "type": "string",
            "description": "盘点单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "stocktaking_date": {
            "type": "string",
            "format": "date",
            "description": "盘点日期"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "盘点明细"
          }
        },
        "additionalProperties": true
      },
      "Alert": {
        "type": "object",
        "description": "库存预警",
        "properties": {
          "alert_id": {
            "type": "string",
            "format": "uuid",
            "description": "预警ID"
          },
          "alert_type": {
            "type": "string",
            "description": "预警类型"
          },
          "material_name": {
            "type": "string",
            "description": "物料名"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库名"
          },
          "current_quantity": {
            "type": "number",
            "description": "当前数量"
          },
          "threshold": {
            "type": "number",
            "description": "阈值"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "Transaction": {
        "type": "object",
        "description": "库存流水",
        "properties": {
          "transaction_id": {
            "type": "string",
            "format": "uuid",
            "description": "流水ID"
          },
          "transaction_type": {
            "type": "string",
            "description": "流水类型（inbound/outbound/transfer/adjust）"
          },
          "material_name": {
            "type": "string",
            "description": "物料名"
          },
          "warehouse_name": {
            "type": "string",
            "description": "仓库名"
          },
          "quantity": {
            "type": "number",
            "description": "数量"
          },
          "balance": {
            "type": "number",
            "description": "余额"
          },
          "transaction_date": {
            "type": "string",
            "format": "date-time",
            "description": "流水时间"
          },
          "reference_number": {
            "type": "string",
            "description": "关联单号"
          },
          "operator_name": {
            "type": "string",
            "description": "操作人"
          }
        },
        "additionalProperties": true
      },
      "ProductionPlan": {
        "type": "object",
        "description": "生产计划",
        "properties": {
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "计划ID"
          },
          "plan_number": {
            "type": "string",
            "description": "计划编号"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "planned_quantity": {
            "type": "number",
            "description": "计划数量"
          },
          "completed_quantity": {
            "type": "number",
            "description": "已完成数量"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          }
        },
        "additionalProperties": true
      },
      "BOM": {
        "type": "object",
        "description": "物料清单",
        "properties": {
          "bom_id": {
            "type": "string",
            "format": "uuid",
            "description": "BOM ID"
          },
          "bom_number": {
            "type": "string",
            "description": "BOM编号"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "material_name": {
                  "type": "string",
                  "description": ""
                },
                "quantity": {
                  "type": "number",
                  "description": ""
                },
                "unit": {
                  "type": "string",
                  "description": ""
                },
                "is_critical": {
                  "type": "boolean",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "BOM明细"
          }
        },
        "additionalProperties": true
      },
      "Routing": {
        "type": "object",
        "description": "工艺路线",
        "properties": {
          "routing_id": {
            "type": "string",
            "format": "uuid",
            "description": "工艺ID"
          },
          "routing_name": {
            "type": "string",
            "description": "工艺名称"
          },
          "routing_code": {
            "type": "string",
            "description": "工艺编码"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "operations": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "sequence": {
                  "type": "integer",
                  "description": ""
                },
                "work_center_name": {
                  "type": "string",
                  "description": ""
                },
                "name": {
                  "type": "string",
                  "description": ""
                },
                "standard_time": {
                  "type": "number",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "工序列表"
          }
        },
        "additionalProperties": true
      },
      "WorkCenter": {
        "type": "object",
        "description": "工作中心",
        "properties": {
          "center_id": {
            "type": "string",
            "format": "uuid",
            "description": "工作中心ID"
          },
          "name": {
            "type": "string",
            "description": "名称"
          },
          "code": {
            "type": "string",
            "description": "编码"
          },
          "capacity": {
            "type": "number",
            "description": "产能"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "location": {
            "type": "string",
            "description": "位置"
          }
        },
        "additionalProperties": true
      },
      "WorkOrder": {
        "type": "object",
        "description": "生产工单",
        "properties": {
          "work_order_id": {
            "type": "string",
            "format": "uuid",
            "description": "工单ID"
          },
          "work_order_number": {
            "type": "string",
            "description": "工单号"
          },
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "计划ID"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "planned_quantity": {
            "type": "number",
            "description": "计划数量"
          },
          "completed_quantity": {
            "type": "number",
            "description": "完工数量"
          },
          "scrapped_quantity": {
            "type": "number",
            "description": "报废数量"
          },
          "status": {
            "type": "string",
            "description": "状态（draft/pending/approved/released/started/paused/completed/closed）"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "计划开始"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "计划结束"
          },
          "actual_start": {
            "type": "string",
            "format": "date-time",
            "description": "实际开始"
          },
          "actual_end": {
            "type": "string",
            "format": "date-time",
            "description": "实际结束"
          },
          "work_center_name": {
            "type": "string",
            "description": "工作中心"
          },
          "assignee_name": {
            "type": "string",
            "description": "负责人"
          }
        },
        "additionalProperties": true
      },
      "ProductionReport": {
        "type": "object",
        "description": "生产报工",
        "properties": {
          "report_id": {
            "type": "string",
            "format": "uuid",
            "description": "报工ID"
          },
          "work_order_id": {
            "type": "string",
            "format": "uuid",
            "description": "工单ID"
          },
          "work_order_number": {
            "type": "string",
            "description": "工单号"
          },
          "operator_name": {
            "type": "string",
            "description": "操作员"
          },
          "reporter_name": {
            "type": "string",
            "description": "报工人"
          },
          "completed_quantity": {
            "type": "number",
            "description": "完工数量"
          },
          "scrapped_quantity": {
            "type": "number",
            "description": "报废数量"
          },
          "work_date": {
            "type": "string",
            "format": "date",
            "description": "工作日期"
          },
          "shift": {
            "type": "string",
            "description": "班次"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "QualityInspection": {
        "type": "object",
        "description": "工序质量检验",
        "properties": {
          "inspection_id": {
            "type": "string",
            "format": "uuid",
            "description": "检验ID"
          },
          "work_order_number": {
            "type": "string",
            "description": "工单号"
          },
          "inspection_type": {
            "type": "string",
            "description": "检验类型"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "sample_quantity": {
            "type": "number",
            "description": "抽样数量"
          },
          "qualified_quantity": {
            "type": "number",
            "description": "合格数量"
          },
          "defect_quantity": {
            "type": "number",
            "description": "不良数量"
          },
          "inspector_name": {
            "type": "string",
            "description": "检验员"
          },
          "inspection_date": {
            "type": "string",
            "format": "date",
            "description": "检验日期"
          },
          "defect_description": {
            "type": "string",
            "description": "不良描述"
          }
        },
        "additionalProperties": true
      },
      "Equipment": {
        "type": "object",
        "description": "设备",
        "properties": {
          "equipment_id": {
            "type": "string",
            "format": "uuid",
            "description": "设备ID"
          },
          "equipment_name": {
            "type": "string",
            "description": "设备名称"
          },
          "equipment_code": {
            "type": "string",
            "description": "设备编码"
          },
          "model": {
            "type": "string",
            "description": "型号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "location": {
            "type": "string",
            "description": "位置"
          },
          "manufacturer": {
            "type": "string",
            "description": "厂家"
          },
          "purchase_date": {
            "type": "string",
            "format": "date",
            "description": "购置日期"
          }
        },
        "additionalProperties": true
      },
      "Maintenance": {
        "type": "object",
        "description": "设备维保",
        "properties": {
          "maintenance_id": {
            "type": "string",
            "format": "uuid",
            "description": "维保ID"
          },
          "maintenance_number": {
            "type": "string",
            "description": "维保单号"
          },
          "equipment_name": {
            "type": "string",
            "description": "设备名"
          },
          "maintenance_type": {
            "type": "string",
            "description": "维保类型"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "planned_date": {
            "type": "string",
            "format": "date",
            "description": "计划日期"
          },
          "completed_date": {
            "type": "string",
            "format": "date",
            "description": "完成日期"
          },
          "cost": {
            "type": "number",
            "description": "费用"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "Downtime": {
        "type": "object",
        "description": "设备停机记录",
        "properties": {
          "downtime_id": {
            "type": "string",
            "format": "uuid",
            "description": "停机ID"
          },
          "downtime_number": {
            "type": "string",
            "description": "停机单号"
          },
          "equipment_name": {
            "type": "string",
            "description": "设备名"
          },
          "work_order_number": {
            "type": "string",
            "description": "工单号"
          },
          "start_time": {
            "type": "string",
            "format": "date-time",
            "description": "开始时间"
          },
          "end_time": {
            "type": "string",
            "format": "date-time",
            "description": "结束时间"
          },
          "duration": {
            "type": "number",
            "description": "时长(分钟)"
          },
          "reason": {
            "type": "string",
            "description": "停机原因"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "ProductionLot": {
        "type": "object",
        "description": "生产批次",
        "properties": {
          "lot_id": {
            "type": "string",
            "format": "uuid",
            "description": "批次ID"
          },
          "lot_number": {
            "type": "string",
            "description": "批次号"
          },
          "work_order_id": {
            "type": "string",
            "format": "uuid",
            "description": "工单ID"
          },
          "parent_lot_id": {
            "type": "string",
            "format": "uuid",
            "description": "父批次ID"
          },
          "quantity": {
            "type": "number",
            "description": "数量"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "Consumption": {
        "type": "object",
        "description": "物料消耗",
        "properties": {
          "consumption_id": {
            "type": "string",
            "format": "uuid",
            "description": "消耗ID"
          },
          "work_order_id": {
            "type": "string",
            "format": "uuid",
            "description": "工单ID"
          },
          "material_name": {
            "type": "string",
            "description": "物料名"
          },
          "quantity": {
            "type": "number",
            "description": "消耗数量"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "consumption_date": {
            "type": "string",
            "format": "date",
            "description": "消耗日期"
          },
          "lot_number": {
            "type": "string",
            "description": "批次号"
          }
        },
        "additionalProperties": true
      },
      "QualitySystemTemplate": {
        "type": "object",
        "description": "质量体系模板",
        "properties": {
          "template_id": {
            "type": "string",
            "format": "uuid",
            "description": "模板ID"
          },
          "name": {
            "type": "string",
            "description": "体系名称"
          },
          "standard": {
            "type": "string",
            "description": "标准（IATF16949/ISO9001等）"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "clauses_count": {
            "type": "integer",
            "description": "条款数"
          }
        },
        "additionalProperties": true
      },
      "QualityClause": {
        "type": "object",
        "description": "体系条款",
        "properties": {
          "clause_id": {
            "type": "string",
            "format": "uuid",
            "description": "条款ID"
          },
          "template_id": {
            "type": "string",
            "format": "uuid",
            "description": "模板ID"
          },
          "clause_number": {
            "type": "string",
            "description": "条款号"
          },
          "title": {
            "type": "string",
            "description": "条款标题"
          },
          "content": {
            "type": "string",
            "description": "条款内容"
          },
          "is_mandatory": {
            "type": "boolean",
            "description": "是否强制"
          }
        },
        "additionalProperties": true
      },
      "QualityPlan": {
        "type": "object",
        "description": "质量计划",
        "properties": {
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "计划ID"
          },
          "plan_name": {
            "type": "string",
            "description": "计划名称"
          },
          "template_id": {
            "type": "string",
            "format": "uuid",
            "description": "模板ID"
          },
          "template_name": {
            "type": "string",
            "description": "模板名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "compliance_rate": {
            "type": "number",
            "description": "合规率"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "owner_name": {
            "type": "string",
            "description": "负责人"
          }
        },
        "additionalProperties": true
      },
      "QualityRequirement": {
        "type": "object",
        "description": "质量要求",
        "properties": {
          "requirement_id": {
            "type": "string",
            "format": "uuid",
            "description": "要求ID"
          },
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "计划ID"
          },
          "clause_number": {
            "type": "string",
            "description": "条款号"
          },
          "title": {
            "type": "string",
            "description": "要求标题"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "status": {
            "type": "string",
            "description": "状态（compliant/non_compliant/pending）"
          },
          "evidence_count": {
            "type": "integer",
            "description": "证据数"
          }
        },
        "additionalProperties": true
      },
      "Evidence": {
        "type": "object",
        "description": "质量证据",
        "properties": {
          "evidence_id": {
            "type": "string",
            "format": "uuid",
            "description": "证据ID"
          },
          "requirement_id": {
            "type": "string",
            "format": "uuid",
            "description": "要求ID"
          },
          "file_name": {
            "type": "string",
            "description": "文件名"
          },
          "file_url": {
            "type": "string",
            "description": "文件URL"
          },
          "evidence_type": {
            "type": "string",
            "description": "证据类型"
          },
          "status": {
            "type": "string",
            "description": "状态（pending/approved/rejected）"
          },
          "uploaded_by": {
            "type": "string",
            "description": "上传人"
          },
          "uploaded_at": {
            "type": "string",
            "format": "date-time",
            "description": "上传时间"
          },
          "review_comment": {
            "type": "string",
            "description": "审核意见"
          }
        },
        "additionalProperties": true
      },
      "APQPPlan": {
        "type": "object",
        "description": "APQP计划",
        "properties": {
          "apqp_id": {
            "type": "string",
            "format": "uuid",
            "description": "APQP ID"
          },
          "project_name": {
            "type": "string",
            "description": "项目名"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "current_phase": {
            "type": "string",
            "description": "当前阶段"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "planned_end_date": {
            "type": "string",
            "format": "date",
            "description": "计划结束"
          },
          "actual_end_date": {
            "type": "string",
            "format": "date",
            "description": "实际结束"
          },
          "deliverables": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "交付物列表"
          }
        },
        "additionalProperties": true
      },
      "FMEA": {
        "type": "object",
        "description": "FMEA",
        "properties": {
          "fmea_id": {
            "type": "string",
            "format": "uuid",
            "description": "FMEA ID"
          },
          "fmea_type": {
            "type": "string",
            "description": "类型（DFMEA/PFMEA）"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "process_name": {
            "type": "string",
            "description": "工序名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "failure_mode": {
                  "type": "string",
                  "description": ""
                },
                "effect": {
                  "type": "string",
                  "description": ""
                },
                "severity": {
                  "type": "integer",
                  "description": ""
                },
                "cause": {
                  "type": "string",
                  "description": ""
                },
                "occurrence": {
                  "type": "integer",
                  "description": ""
                },
                "control": {
                  "type": "string",
                  "description": ""
                },
                "detection": {
                  "type": "integer",
                  "description": ""
                },
                "rpn": {
                  "type": "integer",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "FMEA行"
          }
        },
        "additionalProperties": true
      },
      "ControlPlan": {
        "type": "object",
        "description": "控制计划",
        "properties": {
          "control_plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "控制计划ID"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "process_name": {
            "type": "string",
            "description": "工序名"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "characteristic": {
                  "type": "string",
                  "description": ""
                },
                "specification": {
                  "type": "string",
                  "description": ""
                },
                "method": {
                  "type": "string",
                  "description": ""
                },
                "frequency": {
                  "type": "string",
                  "description": ""
                }
              },
              "additionalProperties": true
            },
            "description": "控制项"
          }
        },
        "additionalProperties": true
      },
      "PPAP": {
        "type": "object",
        "description": "PPAP提交",
        "properties": {
          "submission_id": {
            "type": "string",
            "format": "uuid",
            "description": "PPAP提交ID"
          },
          "submission_level": {
            "type": "string",
            "description": "提交等级"
          },
          "part_name": {
            "type": "string",
            "description": "零件名"
          },
          "part_number": {
            "type": "string",
            "description": "零件号"
          },
          "customer_name": {
            "type": "string",
            "description": "客户名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "submission_date": {
            "type": "string",
            "format": "date",
            "description": "提交日期"
          },
          "elements": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "PPAP元素"
          }
        },
        "additionalProperties": true
      },
      "Audit": {
        "type": "object",
        "description": "审核",
        "properties": {
          "audit_id": {
            "type": "string",
            "format": "uuid",
            "description": "审核ID"
          },
          "audit_type": {
            "type": "string",
            "description": "审核类型（internal/external/supplier）"
          },
          "audit_name": {
            "type": "string",
            "description": "审核名称"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "lead_auditor": {
            "type": "string",
            "description": "主审核员"
          },
          "findings": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "审核发现"
          }
        },
        "additionalProperties": true
      },
      "NCR": {
        "type": "object",
        "description": "不合格品报告",
        "properties": {
          "ncr_id": {
            "type": "string",
            "format": "uuid",
            "description": "NCR ID"
          },
          "ncr_number": {
            "type": "string",
            "description": "NCR编号"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "defect_description": {
            "type": "string",
            "description": "不合格描述"
          },
          "severity": {
            "type": "string",
            "description": "严重程度"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "disposition": {
            "type": "string",
            "description": "处置（rework/scrap/accept/use_as_is）"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "CAPA": {
        "type": "object",
        "description": "CAPA",
        "properties": {
          "capa_id": {
            "type": "string",
            "format": "uuid",
            "description": "CAPA ID"
          },
          "capa_number": {
            "type": "string",
            "description": "CAPA编号"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "type": {
            "type": "string",
            "description": "类型（corrective/preventive）"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "root_cause": {
            "type": "string",
            "description": "根本原因"
          },
          "action_plan": {
            "type": "string",
            "description": "行动计划"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "owner_name": {
            "type": "string",
            "description": "负责人"
          }
        },
        "additionalProperties": true
      },
      "MSA": {
        "type": "object",
        "description": "MSA研究",
        "properties": {
          "study_id": {
            "type": "string",
            "format": "uuid",
            "description": "MSA研究ID"
          },
          "study_type": {
            "type": "string",
            "description": "研究类型（GR&R/_bias/linearity/stability）"
          },
          "gauge_name": {
            "type": "string",
            "description": "量具名"
          },
          "characteristic": {
            "type": "string",
            "description": "特性"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "study_date": {
            "type": "string",
            "format": "date",
            "description": "研究日期"
          },
          "result": {
            "type": "string",
            "description": "结论"
          }
        },
        "additionalProperties": true
      },
      "SPC": {
        "type": "object",
        "description": "SPC记录",
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "description": "SPC记录ID"
          },
          "characteristic": {
            "type": "string",
            "description": "特性"
          },
          "specification": {
            "type": "string",
            "description": "规格"
          },
          "mean": {
            "type": "number",
            "description": "均值"
          },
          "std_dev": {
            "type": "number",
            "description": "标准差"
          },
          "cpk": {
            "type": "number",
            "description": "Cpk"
          },
          "ppk": {
            "type": "number",
            "description": "Ppk"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "record_date": {
            "type": "string",
            "format": "date",
            "description": "记录日期"
          }
        },
        "additionalProperties": true
      },
      "AttendanceApply": {
        "type": "object",
        "description": "考勤申请",
        "properties": {
          "app_id": {
            "type": "integer",
            "description": "申请ID"
          },
          "apply_type": {
            "type": "string",
            "description": "申请类型（leave/overtime/business_trip）"
          },
          "start_time": {
            "type": "string",
            "format": "date-time",
            "description": "开始时间"
          },
          "end_time": {
            "type": "string",
            "format": "date-time",
            "description": "结束时间"
          },
          "duration": {
            "type": "number",
            "description": "时长"
          },
          "reason": {
            "type": "string",
            "description": "事由"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "applicant_name": {
            "type": "string",
            "description": "申请人"
          }
        },
        "additionalProperties": true
      },
      "Schedule": {
        "type": "object",
        "description": "日程",
        "properties": {
          "schedule_id": {
            "type": "integer",
            "description": "日程ID"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "start_time": {
            "type": "string",
            "format": "date-time",
            "description": "开始时间"
          },
          "end_time": {
            "type": "string",
            "format": "date-time",
            "description": "结束时间"
          },
          "location": {
            "type": "string",
            "description": "地点"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "creator_name": {
            "type": "string",
            "description": "创建人"
          }
        },
        "additionalProperties": true
      },
      "Announcement": {
        "type": "object",
        "description": "公告",
        "properties": {
          "ann_id": {
            "type": "string",
            "format": "uuid",
            "description": "公告ID"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "category": {
            "type": "string",
            "description": "分类"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "publish_time": {
            "type": "string",
            "format": "date-time",
            "description": "发布时间"
          },
          "publisher_name": {
            "type": "string",
            "description": "发布人"
          }
        },
        "additionalProperties": true
      },
      "SupplyCategory": {
        "type": "object",
        "description": "办公用品分类",
        "properties": {
          "category_id": {
            "type": "string",
            "format": "uuid",
            "description": "分类ID"
          },
          "category_name": {
            "type": "string",
            "description": "分类名"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "SupplyItem": {
        "type": "object",
        "description": "办公用品",
        "properties": {
          "item_id": {
            "type": "string",
            "format": "uuid",
            "description": "物品ID"
          },
          "item_name": {
            "type": "string",
            "description": "物品名"
          },
          "category_name": {
            "type": "string",
            "description": "分类"
          },
          "unit": {
            "type": "string",
            "description": "单位"
          },
          "stock": {
            "type": "number",
            "description": "库存"
          },
          "price": {
            "type": "number",
            "description": "单价"
          }
        },
        "additionalProperties": true
      },
      "SupplyApply": {
        "type": "object",
        "description": "办公用品申领",
        "properties": {
          "app_id": {
            "type": "integer",
            "description": "申请ID"
          },
          "applicant_name": {
            "type": "string",
            "description": "申请人"
          },
          "apply_date": {
            "type": "string",
            "format": "date",
            "description": "申请日期"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "申领明细"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "purpose": {
            "type": "string",
            "description": "用途"
          }
        },
        "additionalProperties": true
      },
      "SealApply": {
        "type": "object",
        "description": "用印申请",
        "properties": {
          "app_id": {
            "type": "integer",
            "description": "申请ID"
          },
          "seal_type": {
            "type": "string",
            "description": "印章类型"
          },
          "applicant_name": {
            "type": "string",
            "description": "申请人"
          },
          "apply_date": {
            "type": "string",
            "format": "date",
            "description": "申请日期"
          },
          "purpose": {
            "type": "string",
            "description": "用印事由"
          },
          "document_title": {
            "type": "string",
            "description": "文件标题"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "LeaveBalance": {
        "type": "object",
        "description": "假期余额",
        "properties": {
          "balance_id": {
            "type": "string",
            "format": "uuid",
            "description": "余额ID"
          },
          "user_id": {
            "type": "string",
            "format": "uuid",
            "description": "用户ID"
          },
          "user_name": {
            "type": "string",
            "description": "用户名"
          },
          "leave_type": {
            "type": "string",
            "description": "假期类型"
          },
          "total_days": {
            "type": "number",
            "description": "总额度"
          },
          "used_days": {
            "type": "number",
            "description": "已用"
          },
          "remaining_days": {
            "type": "number",
            "description": "剩余"
          },
          "year": {
            "type": "integer",
            "description": "年份"
          }
        },
        "additionalProperties": true
      },
      "OfficeApplication": {
        "type": "object",
        "description": "通用办公申请",
        "properties": {
          "app_id": {
            "type": "string",
            "format": "uuid",
            "description": "申请ID"
          },
          "application_type": {
            "type": "string",
            "description": "申请类型"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "applicant_name": {
            "type": "string",
            "description": "申请人"
          },
          "department_name": {
            "type": "string",
            "description": "部门"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "AssetCategory": {
        "type": "object",
        "description": "资产分类",
        "properties": {
          "category_id": {
            "type": "string",
            "format": "uuid",
            "description": "分类ID"
          },
          "category_name": {
            "type": "string",
            "description": "分类名"
          },
          "code": {
            "type": "string",
            "description": "编码"
          },
          "parent_id": {
            "type": "string",
            "format": "uuid",
            "description": "上级分类ID"
          }
        },
        "additionalProperties": true
      },
      "Asset": {
        "type": "object",
        "description": "固定资产",
        "properties": {
          "asset_id": {
            "type": "string",
            "format": "uuid",
            "description": "资产ID"
          },
          "asset_number": {
            "type": "string",
            "description": "资产编号"
          },
          "asset_name": {
            "type": "string",
            "description": "资产名称"
          },
          "category_name": {
            "type": "string",
            "description": "分类"
          },
          "specification": {
            "type": "string",
            "description": "规格型号"
          },
          "status": {
            "type": "string",
            "description": "状态（idle/in_use/repair/scrap）"
          },
          "user_name": {
            "type": "string",
            "description": "使用人"
          },
          "location": {
            "type": "string",
            "description": "存放位置"
          },
          "purchase_date": {
            "type": "string",
            "format": "date",
            "description": "购置日期"
          },
          "purchase_price": {
            "type": "number",
            "description": "购置价格"
          },
          "depreciation": {
            "type": "number",
            "description": "折旧"
          },
          "net_value": {
            "type": "number",
            "description": "净值"
          }
        },
        "additionalProperties": true
      },
      "AssetRecord": {
        "type": "object",
        "description": "资产记录",
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "description": "记录ID"
          },
          "asset_id": {
            "type": "string",
            "format": "uuid",
            "description": "资产ID"
          },
          "record_type": {
            "type": "string",
            "description": "记录类型（bind/return/transfer/repair/scrap）"
          },
          "operator_name": {
            "type": "string",
            "description": "操作人"
          },
          "operated_at": {
            "type": "string",
            "format": "date-time",
            "description": "操作时间"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "Expense": {
        "type": "object",
        "description": "费用报销",
        "properties": {
          "expense_id": {
            "type": "string",
            "format": "uuid",
            "description": "费用ID"
          },
          "expense_number": {
            "type": "string",
            "description": "报销单号"
          },
          "expense_type": {
            "type": "string",
            "description": "费用类型"
          },
          "amount": {
            "type": "number",
            "description": "金额"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "applicant_name": {
            "type": "string",
            "description": "申请人"
          },
          "department_name": {
            "type": "string",
            "description": "部门"
          },
          "apply_date": {
            "type": "string",
            "format": "date",
            "description": "申请日期"
          },
          "pay_date": {
            "type": "string",
            "format": "date",
            "description": "支付日期"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "SalaryTemplate": {
        "type": "object",
        "description": "薪资模板",
        "properties": {
          "template_id": {
            "type": "string",
            "format": "uuid",
            "description": "模板ID"
          },
          "template_name": {
            "type": "string",
            "description": "模板名"
          },
          "base_salary": {
            "type": "number",
            "description": "基本工资"
          },
          "allowance": {
            "type": "number",
            "description": "津贴"
          },
          "bonus": {
            "type": "number",
            "description": "奖金"
          },
          "deduction": {
            "type": "number",
            "description": "扣款"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "SalaryRecord": {
        "type": "object",
        "description": "薪资记录",
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "description": "记录ID"
          },
          "user_id": {
            "type": "string",
            "format": "uuid",
            "description": "用户ID"
          },
          "user_name": {
            "type": "string",
            "description": "用户名"
          },
          "month": {
            "type": "string",
            "description": "月份"
          },
          "base_salary": {
            "type": "number",
            "description": "基本工资"
          },
          "overtime_pay": {
            "type": "number",
            "description": "加班费"
          },
          "allowance": {
            "type": "number",
            "description": "津贴"
          },
          "bonus": {
            "type": "number",
            "description": "奖金"
          },
          "social_insurance": {
            "type": "number",
            "description": "社保"
          },
          "tax": {
            "type": "number",
            "description": "个税"
          },
          "net_salary": {
            "type": "number",
            "description": "实发工资"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "HRExpenditure": {
        "type": "object",
        "description": "人力支出",
        "properties": {
          "expenditure_id": {
            "type": "string",
            "format": "uuid",
            "description": "支出ID"
          },
          "expenditure_type": {
            "type": "string",
            "description": "支出类型"
          },
          "amount": {
            "type": "number",
            "description": "金额"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "pay_date": {
            "type": "string",
            "format": "date",
            "description": "支付日期"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "Logistics": {
        "type": "object",
        "description": "物流记录",
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "description": "记录ID"
          },
          "logistics_number": {
            "type": "string",
            "description": "物流单号"
          },
          "sender": {
            "type": "string",
            "description": "发件人"
          },
          "recipient": {
            "type": "string",
            "description": "收件人"
          },
          "recipient_address": {
            "type": "string",
            "description": "收件地址"
          },
          "logistics_company": {
            "type": "string",
            "description": "物流公司"
          },
          "tracking_number": {
            "type": "string",
            "description": "运单号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "send_date": {
            "type": "string",
            "format": "date",
            "description": "发出日期"
          },
          "received_date": {
            "type": "string",
            "format": "date",
            "description": "签收日期"
          },
          "cost": {
            "type": "number",
            "description": "费用"
          }
        },
        "additionalProperties": true
      },
      "Document": {
        "type": "object",
        "description": "技术文档",
        "properties": {
          "document_id": {
            "type": "string",
            "format": "uuid",
            "description": "文档ID"
          },
          "document_name": {
            "type": "string",
            "description": "文档名"
          },
          "document_code": {
            "type": "string",
            "description": "文档编号"
          },
          "category": {
            "type": "string",
            "description": "分类"
          },
          "status": {
            "type": "string",
            "description": "状态（draft/published/archived）"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "author_name": {
            "type": "string",
            "description": "作者"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "description": ""
            },
            "description": "标签"
          }
        },
        "additionalProperties": true
      },
      "DocumentVersion": {
        "type": "object",
        "description": "文档版本",
        "properties": {
          "version_id": {
            "type": "string",
            "format": "uuid",
            "description": "版本ID"
          },
          "document_id": {
            "type": "string",
            "format": "uuid",
            "description": "文档ID"
          },
          "version_number": {
            "type": "string",
            "description": "版本号"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "updated_by": {
            "type": "string",
            "description": "更新人"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          },
          "change_log": {
            "type": "string",
            "description": "变更说明"
          }
        },
        "additionalProperties": true
      },
      "Drawing": {
        "type": "object",
        "description": "图纸",
        "properties": {
          "drawing_id": {
            "type": "string",
            "format": "uuid",
            "description": "图纸ID"
          },
          "drawing_number": {
            "type": "string",
            "description": "图号"
          },
          "drawing_name": {
            "type": "string",
            "description": "图纸名"
          },
          "category": {
            "type": "string",
            "description": "分类"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "file_url": {
            "type": "string",
            "description": "文件URL"
          },
          "file_format": {
            "type": "string",
            "description": "文件格式"
          },
          "author_name": {
            "type": "string",
            "description": "作者"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          }
        },
        "additionalProperties": true
      },
      "DrawingVersion": {
        "type": "object",
        "description": "图纸版本",
        "properties": {
          "version_id": {
            "type": "string",
            "format": "uuid",
            "description": "版本ID"
          },
          "drawing_id": {
            "type": "string",
            "format": "uuid",
            "description": "图纸ID"
          },
          "version_number": {
            "type": "string",
            "description": "版本号"
          },
          "file_url": {
            "type": "string",
            "description": "文件URL"
          },
          "updated_by": {
            "type": "string",
            "description": "更新人"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          },
          "change_log": {
            "type": "string",
            "description": "变更说明"
          }
        },
        "additionalProperties": true
      },
      "BorrowRecord": {
        "type": "object",
        "description": "图纸借阅记录",
        "properties": {
          "borrow_id": {
            "type": "string",
            "format": "uuid",
            "description": "借阅ID"
          },
          "drawing_id": {
            "type": "string",
            "format": "uuid",
            "description": "图纸ID"
          },
          "drawing_number": {
            "type": "string",
            "description": "图号"
          },
          "borrower_name": {
            "type": "string",
            "description": "借阅人"
          },
          "borrow_date": {
            "type": "string",
            "format": "date",
            "description": "借阅日期"
          },
          "return_date": {
            "type": "string",
            "format": "date",
            "description": "归还日期"
          },
          "actual_return_date": {
            "type": "string",
            "format": "date",
            "description": "实际归还日期"
          },
          "status": {
            "type": "string",
            "description": "状态（borrowed/returned/overdue）"
          },
          "purpose": {
            "type": "string",
            "description": "借阅目的"
          }
        },
        "additionalProperties": true
      },
      "TrainingPlan": {
        "type": "object",
        "description": "培训计划",
        "properties": {
          "plan_id": {
            "type": "string",
            "format": "uuid",
            "description": "培训计划ID"
          },
          "training_name": {
            "type": "string",
            "description": "培训名称"
          },
          "trainer_name": {
            "type": "string",
            "description": "讲师"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "location": {
            "type": "string",
            "description": "地点"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "capacity": {
            "type": "integer",
            "description": "名额"
          },
          "enrolled_count": {
            "type": "integer",
            "description": "已报名"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "Meeting": {
        "type": "object",
        "description": "会议",
        "properties": {
          "minute_id": {
            "type": "string",
            "format": "uuid",
            "description": "会议ID"
          },
          "meeting_title": {
            "type": "string",
            "description": "会议标题"
          },
          "meeting_date": {
            "type": "string",
            "format": "date",
            "description": "会议日期"
          },
          "start_time": {
            "type": "string",
            "description": "开始时间"
          },
          "end_time": {
            "type": "string",
            "description": "结束时间"
          },
          "location": {
            "type": "string",
            "description": "地点"
          },
          "organizer_name": {
            "type": "string",
            "description": "组织者"
          },
          "attendees": {
            "type": "array",
            "items": {
              "type": "string",
              "description": ""
            },
            "description": "参会人员"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "content": {
            "type": "string",
            "description": "会议内容"
          }
        },
        "additionalProperties": true
      },
      "Resolution": {
        "type": "object",
        "description": "会议决议",
        "properties": {
          "resolution_id": {
            "type": "string",
            "format": "uuid",
            "description": "决议ID"
          },
          "minute_id": {
            "type": "string",
            "format": "uuid",
            "description": "会议ID"
          },
          "title": {
            "type": "string",
            "description": "决议标题"
          },
          "content": {
            "type": "string",
            "description": "决议内容"
          },
          "owner_name": {
            "type": "string",
            "description": "负责人"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "status": {
            "type": "string",
            "description": "状态（pending/in_progress/completed）"
          }
        },
        "additionalProperties": true
      },
      "Experiment": {
        "type": "object",
        "description": "实验",
        "properties": {
          "experiment_id": {
            "type": "string",
            "format": "uuid",
            "description": "实验ID"
          },
          "experiment_name": {
            "type": "string",
            "description": "实验名称"
          },
          "experiment_type": {
            "type": "string",
            "description": "实验类型"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "standard_id": {
            "type": "string",
            "format": "uuid",
            "description": "关联标准ID"
          },
          "wizard_id": {
            "type": "string",
            "format": "uuid",
            "description": "关联向导ID"
          },
          "project_name": {
            "type": "string",
            "description": "项目名"
          },
          "experimenter_name": {
            "type": "string",
            "description": "实验员"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "开始日期"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "结束日期"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "ExperimentStandard": {
        "type": "object",
        "description": "实验标准",
        "properties": {
          "standard_id": {
            "type": "string",
            "format": "uuid",
            "description": "标准ID"
          },
          "standard_name": {
            "type": "string",
            "description": "标准名称"
          },
          "standard_code": {
            "type": "string",
            "description": "标准编号"
          },
          "category": {
            "type": "string",
            "description": "分类"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "parameters": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "参数定义"
          }
        },
        "additionalProperties": true
      },
      "ExperimentWizard": {
        "type": "object",
        "description": "实验向导",
        "properties": {
          "wizard_id": {
            "type": "string",
            "format": "uuid",
            "description": "向导ID"
          },
          "wizard_name": {
            "type": "string",
            "description": "向导名称"
          },
          "standard_id": {
            "type": "string",
            "format": "uuid",
            "description": "关联标准ID"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "steps": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "步骤"
          }
        },
        "additionalProperties": true
      },
      "StepRecord": {
        "type": "object",
        "description": "实验步骤记录",
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "description": "记录ID"
          },
          "experiment_id": {
            "type": "string",
            "format": "uuid",
            "description": "实验ID"
          },
          "sequence": {
            "type": "integer",
            "description": "步骤序号"
          },
          "step_name": {
            "type": "string",
            "description": "步骤名"
          },
          "content": {
            "type": "string",
            "description": "记录内容"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "记录时间"
          }
        },
        "additionalProperties": true
      },
      "Dataset": {
        "type": "object",
        "description": "实验数据集",
        "properties": {
          "dataset_id": {
            "type": "string",
            "format": "uuid",
            "description": "数据集ID"
          },
          "experiment_id": {
            "type": "string",
            "format": "uuid",
            "description": "实验ID"
          },
          "dataset_name": {
            "type": "string",
            "description": "数据集名"
          },
          "data_type": {
            "type": "string",
            "description": "数据类型"
          },
          "point_count": {
            "type": "integer",
            "description": "数据点数"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "DataPoint": {
        "type": "object",
        "description": "数据点",
        "properties": {
          "point_id": {
            "type": "string",
            "format": "uuid",
            "description": "点ID"
          },
          "dataset_id": {
            "type": "string",
            "format": "uuid",
            "description": "数据集ID"
          },
          "x": {
            "type": "number",
            "description": "X值"
          },
          "y": {
            "type": "number",
            "description": "Y值"
          },
          "metadata": {
            "type": "object",
            "description": "",
            "properties": {},
            "additionalProperties": true,
            "required": "元数据"
          }
        },
        "additionalProperties": true
      },
      "ExperimentFile": {
        "type": "object",
        "description": "实验文件",
        "properties": {
          "file_id": {
            "type": "string",
            "format": "uuid",
            "description": "文件ID"
          },
          "experiment_id": {
            "type": "string",
            "format": "uuid",
            "description": "实验ID"
          },
          "file_name": {
            "type": "string",
            "description": "文件名"
          },
          "file_size": {
            "type": "integer",
            "description": "文件大小"
          },
          "file_type": {
            "type": "string",
            "description": "文件类型"
          },
          "file_url": {
            "type": "string",
            "description": "下载URL"
          },
          "uploaded_at": {
            "type": "string",
            "format": "date-time",
            "description": "上传时间"
          }
        },
        "additionalProperties": true
      },
      "FittingResult": {
        "type": "object",
        "description": "拟合结果",
        "properties": {
          "fitting_id": {
            "type": "string",
            "format": "uuid",
            "description": "拟合ID"
          },
          "experiment_id": {
            "type": "string",
            "format": "uuid",
            "description": "实验ID"
          },
          "dataset_id": {
            "type": "string",
            "format": "uuid",
            "description": "数据集ID"
          },
          "model_type": {
            "type": "string",
            "description": "模型类型"
          },
          "parameters": {
            "type": "object",
            "description": "",
            "properties": {},
            "additionalProperties": true,
            "required": "拟合参数"
          },
          "r_square": {
            "type": "number",
            "description": "R²"
          },
          "rmse": {
            "type": "number",
            "description": "RMSE"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          }
        },
        "additionalProperties": true
      },
      "Admission": {
        "type": "object",
        "description": "供应商准入",
        "properties": {
          "adm_id": {
            "type": "string",
            "format": "uuid",
            "description": "准入ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "apply_date": {
            "type": "string",
            "format": "date",
            "description": "申请日期"
          },
          "review_date": {
            "type": "string",
            "format": "date",
            "description": "审核日期"
          },
          "reviewer_name": {
            "type": "string",
            "description": "审核人"
          },
          "materials": {
            "type": "array",
            "items": {
              "type": "string",
              "description": ""
            },
            "description": "供应物料"
          },
          "notes": {
            "type": "string",
            "description": "备注"
          }
        },
        "additionalProperties": true
      },
      "Qualification": {
        "type": "object",
        "description": "供应商资质",
        "properties": {
          "qual_id": {
            "type": "string",
            "format": "uuid",
            "description": "资质ID"
          },
          "supplier_id": {
            "type": "string",
            "format": "uuid",
            "description": "供应商ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "qual_name": {
            "type": "string",
            "description": "资质名称"
          },
          "qual_type": {
            "type": "string",
            "description": "资质类型"
          },
          "file_url": {
            "type": "string",
            "description": "文件URL"
          },
          "valid_from": {
            "type": "string",
            "format": "date",
            "description": "生效日期"
          },
          "valid_to": {
            "type": "string",
            "format": "date",
            "description": "失效日期"
          },
          "status": {
            "type": "string",
            "description": "状态"
          }
        },
        "additionalProperties": true
      },
      "Assessment": {
        "type": "object",
        "description": "供应商考核",
        "properties": {
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "description": "考核ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "period": {
            "type": "string",
            "description": "考核周期"
          },
          "score": {
            "type": "number",
            "description": "总分"
          },
          "grade": {
            "type": "string",
            "description": "等级"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "考核项"
          }
        },
        "additionalProperties": true
      },
      "SupplierPerformance": {
        "type": "object",
        "description": "供应商绩效",
        "properties": {
          "performance_id": {
            "type": "string",
            "format": "uuid",
            "description": "绩效ID"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "period": {
            "type": "string",
            "description": "周期"
          },
          "quality_score": {
            "type": "number",
            "description": "质量分"
          },
          "delivery_score": {
            "type": "number",
            "description": "交付分"
          },
          "price_score": {
            "type": "number",
            "description": "价格分"
          },
          "service_score": {
            "type": "number",
            "description": "服务分"
          },
          "total_score": {
            "type": "number",
            "description": "总分"
          },
          "grade": {
            "type": "string",
            "description": "等级"
          }
        },
        "additionalProperties": true
      },
      "GoodsReceipt": {
        "type": "object",
        "description": "收货记录",
        "properties": {
          "receipt_id": {
            "type": "string",
            "format": "uuid",
            "description": "收货ID"
          },
          "receipt_number": {
            "type": "string",
            "description": "收货单号"
          },
          "order_number": {
            "type": "string",
            "description": "采购订单号"
          },
          "supplier_name": {
            "type": "string",
            "description": "供应商名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "received_date": {
            "type": "string",
            "format": "date",
            "description": "收货日期"
          },
          "total_quantity": {
            "type": "number",
            "description": "收货数量"
          },
          "qualified_quantity": {
            "type": "number",
            "description": "合格数量"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "明细"
          }
        },
        "additionalProperties": true
      },
      "BidProject": {
        "type": "object",
        "description": "招投标项目",
        "properties": {
          "bid_id": {
            "type": "string",
            "format": "uuid",
            "description": "招标ID"
          },
          "bid_name": {
            "type": "string",
            "description": "招标项目名"
          },
          "bid_number": {
            "type": "string",
            "description": "招标编号"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "publish_date": {
            "type": "string",
            "format": "date",
            "description": "发布日期"
          },
          "deadline": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "budget": {
            "type": "number",
            "description": "预算"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "SOPRoute": {
        "type": "object",
        "description": "SOP工艺路线",
        "properties": {
          "route_id": {
            "type": "string",
            "format": "uuid",
            "description": "路线ID"
          },
          "route_name": {
            "type": "string",
            "description": "路线名称"
          },
          "route_code": {
            "type": "string",
            "description": "路线编码"
          },
          "product_name": {
            "type": "string",
            "description": "产品名"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "nodes": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {},
              "additionalProperties": true
            },
            "description": "节点"
          }
        },
        "additionalProperties": true
      },
      "SOPDocument": {
        "type": "object",
        "description": "SOP文档",
        "properties": {
          "doc_id": {
            "type": "string",
            "format": "uuid",
            "description": "文档ID"
          },
          "doc_name": {
            "type": "string",
            "description": "文档名"
          },
          "doc_code": {
            "type": "string",
            "description": "文档编号"
          },
          "route_id": {
            "type": "string",
            "format": "uuid",
            "description": "关联路线ID"
          },
          "version": {
            "type": "string",
            "description": "版本"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          }
        },
        "additionalProperties": true
      },
      "SOPDocumentVersion": {
        "type": "object",
        "description": "SOP文档版本",
        "properties": {
          "version_id": {
            "type": "string",
            "format": "uuid",
            "description": "版本ID"
          },
          "doc_id": {
            "type": "string",
            "format": "uuid",
            "description": "文档ID"
          },
          "version_number": {
            "type": "string",
            "description": "版本号"
          },
          "content": {
            "type": "string",
            "description": "内容"
          },
          "updated_by": {
            "type": "string",
            "description": "更新人"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          }
        },
        "additionalProperties": true
      },
      "ProductCategory": {
        "type": "object",
        "description": "产品类别",
        "properties": {
          "category_id": {
            "type": "string",
            "format": "uuid",
            "description": "类别ID"
          },
          "category_name": {
            "type": "string",
            "description": "类别名"
          },
          "code": {
            "type": "string",
            "description": "编码"
          },
          "parent_id": {
            "type": "string",
            "format": "uuid",
            "description": "上级ID"
          },
          "description": {
            "type": "string",
            "description": "描述"
          }
        },
        "additionalProperties": true
      },
      "GenericWorkOrder": {
        "type": "object",
        "description": "通用工单",
        "properties": {
          "order_id": {
            "type": "string",
            "format": "uuid",
            "description": "工单ID"
          },
          "order_number": {
            "type": "string",
            "description": "工单号"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "status": {
            "type": "string",
            "description": "状态"
          },
          "category": {
            "type": "string",
            "description": "分类"
          },
          "creator_name": {
            "type": "string",
            "description": "创建人"
          },
          "assignee_name": {
            "type": "string",
            "description": "处理人"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "sla_deadline": {
            "type": "string",
            "format": "date-time",
            "description": "SLA截止"
          },
          "rating": {
            "type": "integer",
            "description": "评分"
          }
        },
        "additionalProperties": true
      },
      "Todo": {
        "type": "object",
        "description": "待办事项",
        "properties": {
          "todo_id": {
            "type": "string",
            "format": "uuid",
            "description": "待办ID"
          },
          "title": {
            "type": "string",
            "description": "标题"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "status": {
            "type": "string",
            "description": "状态（pending/completed）"
          },
          "priority": {
            "type": "string",
            "description": "优先级"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "截止日期"
          },
          "creator_name": {
            "type": "string",
            "description": "创建人"
          },
          "assignee_name": {
            "type": "string",
            "description": "负责人"
          },
          "source_type": {
            "type": "string",
            "description": "来源类型"
          },
          "source_id": {
            "type": "string",
            "description": "来源ID"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "完成时间"
          }
        },
        "additionalProperties": true
      },
      "CategoryGroup": {
        "type": "object",
        "description": "分类分组",
        "properties": {
          "group_id": {
            "type": "string",
            "format": "uuid",
            "description": "分组ID"
          },
          "group_code": {
            "type": "string",
            "description": "分组编码"
          },
          "group_name": {
            "type": "string",
            "description": "分组名称"
          },
          "description": {
            "type": "string",
            "description": "描述"
          },
          "option_count": {
            "type": "integer",
            "description": "选项数"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          }
        },
        "additionalProperties": true
      },
      "CategoryOption": {
        "type": "object",
        "description": "分类选项",
        "properties": {
          "option_id": {
            "type": "string",
            "format": "uuid",
            "description": "选项ID"
          },
          "group_code": {
            "type": "string",
            "description": "分组编码"
          },
          "option_value": {
            "type": "string",
            "description": "选项值"
          },
          "option_label": {
            "type": "string",
            "description": "选项标签"
          },
          "sort_order": {
            "type": "integer",
            "description": "排序"
          },
          "is_active": {
            "type": "boolean",
            "description": "是否启用"
          },
          "parent_id": {
            "type": "string",
            "format": "uuid",
            "description": "父选项ID"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ]
}