998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
61 lines
1.2 KiB
YAML
61 lines
1.2 KiB
YAML
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
|