openapi: 3.0.0
info:
  title: 系统管理模块API
  version: 1.0.0
  description: 管理与监控最小契约（骨架）

paths:
  /api/v1/admin/settings:
    get:
      summary: 获取系统设置
      tags: [管理]
      security:
        - bearerAuth: []
      responses:
        200:
          description: 成功
    put:
      summary: 更新系统设置（管理员）
      tags: [管理]
      security:
        - bearerAuth: []
      responses:
        200:
          description: 已更新

  /api/v1/admin/health:
    get:
      summary: 健康检查
      tags: [管理]
      responses:
        200:
          description: 健康

  /api/v1/admin/metrics:
    get:
      summary: 系统指标
      tags: [管理]
      security:
        - bearerAuth: []
      responses:
        200:
          description: 成功

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

