openapi: 3.0.0
info:
  title: AI陪练模块API
  version: 1.0.0
  description: 陪练场景与会话的最小契约（骨架）

paths:
  /api/v1/training-scenes:
    get:
      summary: 陪练场景列表
      tags: [陪练]
      security:
        - bearerAuth: []
      responses:
        200:
          description: 成功
    post:
      summary: 创建场景（管理员）
      tags: [陪练]
      security:
        - bearerAuth: []
      responses:
        201:
          description: 已创建

  /api/v1/training/start:
    post:
      summary: 开始陪练
      tags: [陪练]
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [scene_id]
              properties:
                scene_id: { type: integer }
      responses:
        200:
          description: 成功

  /api/v1/training/end:
    post:
      summary: 结束陪练
      tags: [陪练]
      security:
        - bearerAuth: []
      responses:
        200:
          description: 成功

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