document-management/backend/openapi/paths/configuration.yaml

UiDictionaries:
  get:
    operationId: getUiDictionaries
    summary: 查询统一UI展示字典
    description: 返回启动时加载的只读展示标签；不提供配置路径或写操作。
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 完整UI展示字典
        headers:
          X-Request-Id:
            description: 与响应体requestId相同
            schema:
              type: string
              format: uuid
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/UiDictionariesResponse'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

RuntimeConfig:
  get:
    operationId: getRuntimeConfig
    summary: 查询运行时只读配置
    description: 暴露后端.env决定的非敏感开关（如PDF预览引擎）；允许浏览器缓存60秒。
    security: []
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 运行时配置
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/RuntimeConfigResponse'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

LoginBackground:
  get:
    operationId: getLoginBackground
    summary: 查询登录界面自定义背景图
    description: >-
      返回服务端运行目录下的 background.jpg 或 background.png（jpg优先）；
      运行目录不存在背景图文件时返回404，前端回退默认纯色背景。
      接口公开（登录前无凭证可访问），允许浏览器缓存60秒。
    security: []
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 背景图片二进制
        headers:
          X-Request-Id:
            description: 与请求发送的X-Request-Id一致
            schema:
              type: string
              format: uuid
        content:
          image/jpeg:
            schema:
              type: string
              format: binary
          image/png:
            schema:
              type: string
              format: binary
      '404':
        description: 运行目录下不存在背景图文件
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/ErrorResponse'
      '500':
        $ref: '../components/responses.yaml#/InternalError'