safety-eval-service/docs/openapi/监管端-风险预警中心.openapi.yaml

openapi: 3.0.3
info:
  title: 监管端-风险预警中心 API
  description: |
    重庆市安全评价服务平台 - 监管端「风险预警中心」页面接口。

    - 统一前缀：`/safetyEval/regulator/risk-center`
    - 当前为 Mock 实现，数据存于 Controller 内存
    - 成功响应 `code = "0"`

    **Apifox 导入方式**：项目设置 → 导入数据 → 选择本文件（OpenAPI/Swagger 格式）
  version: 1.0.0
  contact:
    name: safety-eval-service

servers:
  - url: http://localhost:8095
    description: 本地开发
  - url: http://192.168.20.100:30140
    description: 测试网关（100）

tags:
  - name: 监管端-风险预警中心
    description: 风险预警中心页面相关接口

paths:
  /safetyEval/regulator/risk-center/overview:
    get:
      tags:
        - 监管端-风险预警中心
      summary: 页面概览
      description: 加载统计卡片（资质预警、项目预警、待机构反馈、今日闭环）
      operationId: regulatorRiskOverview
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SingleResponseRegulatorRiskOverviewCO'
              example:
                success: true
                code: "0"
                data:
                  stats:
                    - label: 资质预警
                      value: "6"
                      hint: 条件保持、人员比例、属地材料
                    - label: 项目预警
                      value: "7"
                      hint: 进度、人员、告知、勘查、质控
                    - label: 待机构反馈
                      value: "4"
                      hint: 整改说明或证明材料
                    - label: 今日闭环
                      value: "5"
                      hint: 监管复核已完成

  /safetyEval/regulator/risk-center/page:
    get:
      tags:
        - 监管端-风险预警中心
      summary: 分页查询预警消息
      description: |
        风险预警消息列表分页查询，支持关键词与各下拉条件筛选。

        下拉选项：
        - 预警大类：`资质预警` / `项目预警`
        - 预警子类：资质条件保持异常 / 人员比例异常 / 属地材料待核验 / 项目启动超期 / 关键节点超期 / 项目人员异常 / 从业告知异常 / 现场勘查异常 / 过程控制/归档异常
        - 处理阶段：`未处理` / `已发机构` / `待复核` / `已闭环`
      operationId: regulatorRiskPage
      parameters:
        - name: keyword
          in: query
          description: 关键词（机构/项目/人员/预警编号）
          schema:
            type: string
        - name: type
          in: query
          description: 预警大类
          schema:
            type: string
            enum:
              - 资质预警
              - 项目预警
        - name: subtype
          in: query
          description: 预警子类
          schema:
            type: string
            enum:
              - 资质条件保持异常
              - 人员比例异常
              - 属地材料待核验
              - 项目启动超期
              - 关键节点超期
              - 项目人员异常
              - 从业告知异常
              - 现场勘查异常
              - 过程控制/归档异常
        - name: stage
          in: query
          description: 处理阶段
          schema:
            type: string
            enum:
              - 未处理
              - 已发机构
              - 待复核
              - 已闭环
        - $ref: '#/components/parameters/currentParam'
        - $ref: '#/components/parameters/sizeParam'
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageResponseRegulatorRiskMessageCO'
              example:
                success: true
                code: "0"
                total: 7
                data:
                  - id: W-QUAL-2026-012
                    category: 资质预警
                    subtype: 资质条件保持异常
                    riskObject: 重庆渝安风险评估中心
                    sourceFields:
                      - 财务材料.固定资产
                      - 场所核验.建筑面积
                      - 人员库.专职人数
                    content: 固定资产、场所面积、档案室面积和专职人员数量不满足保持条件。
                    stage: 未处理
                    orgStatus: 未发送
                  - id: W-PROJ-2026-021
                    category: 项目预警
                    subtype: 项目启动超期
                    riskObject: 华安化工年度安全现状评价
                    sourceFields:
                      - 客户信息.评价到期日
                      - 项目库.新建时间
                    content: 评价周期已到期 14 天，系统内尚未建立新一轮评价项目。
                    stage: 未处理
                    orgStatus: 未发送

components:
  parameters:
    currentParam:
      name: current
      in: query
      description: 当前页
      schema:
        type: integer
        format: int64
        default: 1
        minimum: 1
    sizeParam:
      name: size
      in: query
      description: 每页条数
      schema:
        type: integer
        format: int64
        default: 10
        minimum: 1

  schemas:
    # ---------- 通用响应 ----------
    SingleResponseError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        code:
          type: string
          example: "404"
        message:
          type: string
        errMessage:
          type: string

    SingleResponseRegulatorRiskOverviewCO:
      type: object
      properties:
        success:
          type: boolean
          example: true
        code:
          type: string
          example: "0"
        message:
          type: string
        errMessage:
          type: string
        data:
          $ref: '#/components/schemas/RegulatorRiskOverviewCO'

    PageResponseRegulatorRiskMessageCO:
      type: object
      properties:
        success:
          type: boolean
          example: true
        code:
          type: string
          example: "0"
        message:
          type: string
        errMessage:
          type: string
        total:
          type: integer
          format: int64
          description: 总条数
          example: 7
        data:
          type: array
          items:
            $ref: '#/components/schemas/RegulatorRiskMessageCO'

    # ---------- 业务模型 ----------
    RegulatorRiskOverviewCO:
      type: object
      description: 页面概览
      properties:
        stats:
          type: array
          description: 统计卡片
          items:
            $ref: '#/components/schemas/StatCardCO'

    StatCardCO:
      type: object
      properties:
        label:
          type: string
          description: 标签
          example: 资质预警
        value:
          type: string
          description: 数值
          example: "6"
        hint:
          type: string
          description: 提示
          example: 条件保持、人员比例、属地材料

    RegulatorRiskMessageCO:
      type: object
      description: 风险预警消息
      properties:
        id:
          type: string
          description: 预警编号
          example: W-QUAL-2026-012
        category:
          type: string
          description: 预警大类
          enum:
            - 资质预警
            - 项目预警
        subtype:
          type: string
          description: 预警子类
          enum:
            - 资质条件保持异常
            - 人员比例异常
            - 属地材料待核验
            - 项目启动超期
            - 关键节点超期
            - 项目人员异常
            - 从业告知异常
            - 现场勘查异常
            - 过程控制/归档异常
        riskObject:
          type: string
          description: 风险对象
          example: 重庆渝安风险评估中心
        sourceFields:
          type: array
          description: 来源字段
          items:
            type: string
        content:
          type: string
          description: 触发内容
        stage:
          type: string
          description: 处理阶段
          enum:
            - 未处理
            - 已发机构
            - 待复核
            - 已闭环
        orgStatus:
          type: string
          description: 机构端状态
          enum:
            - 未发送
            - 机构未读
            - 已提交材料
            - 处理中
            - 已提交说明
            - 整改完成