hldrCenter/server/api/course/course_teacher/course_teacher.api

// 教学团队表API定义（适配course_teacher表）
type (
	// 创建教学团队关联请求（无需id，数据库自增生成）
	CreateCourseTeacherReq {
		CourseId  int    `json:"course_id" form:"course_id" validate:"required"` // 关联课程ID（必填，外键）
		TeacherId int    `json:"teacher_id" form:"teacher_id" validate:"required"` // 教师ID（必填，关联用户表）
		Name      string `json:"name" form:"name" validate:"required,max=100"` // 教师姓名（必填，最长100字符）
		Title     string `json:"title" form:"title" validate:"omitempty,max=200"` // 教师头衔（可选，最长200字符）
		Avatar    string `json:"avatar" form:"avatar" validate:"omitempty,max=512"` // 头像URL（可选，最长512字符）
		Intro     string `json:"intro" form:"intro"` // 教师简介（可选，文本）
		Sort      int    `json:"sort" form:"sort" validate:"omitempty,min=0"` // 排序（可选，默认0）
	}
	// 创建教学团队关联响应
	CreateCourseTeacherResp {
		Id      int    `json:"id"` // 新增关联ID
		Message string `json:"message"` // 操作结果信息
	}
	// 查询单个教学团队关联请求（按ID查询）
	GetCourseTeacherReq {
		Id int `json:"id" form:"id" path:"id" validate:"required"` // 关联ID（必填，路径参数）
	}
	// 查询单个教学团队关联响应（返回完整信息）
	GetCourseTeacherResp {
		Id        int    `json:"id"` // 关联ID（主键）
		CourseId  int    `json:"course_id"` // 关联课程ID
		TeacherId int    `json:"teacher_id"` // 教师ID
		Name      string `json:"name"` // 教师姓名
		Title     string `json:"title"` // 教师头衔
		Avatar    string `json:"avatar"` // 头像URL
		Intro     string `json:"intro"` // 教师简介
		Sort      int    `json:"sort"` // 排序
	}
	// 教学团队列表查询请求（支持筛选和分页）
	ListCourseTeacherReq {
		CourseId  int `json:"course_id" form:"course_id" validate:"omitempty"` // 可选筛选：按课程ID查询
		TeacherId int `json:"teacher_id" form:"teacher_id" validate:"omitempty"` // 可选筛选：按教师ID查询
		Page      int `json:"page" form:"page" validate:"required,min=1"` // 页码（必填，从1开始）
		PageSize  int `json:"page_size" form:"page_size" validate:"required,min=1,max=100"` // 每页条数（1-100）
	}
	// 教学团队列表响应
	ListCourseTeacherResp {
		Total    int                    `json:"total"` // 总条数
		List     []GetCourseTeacherResp `json:"list"` // 教学团队列表
		Page     int                    `json:"page"` // 当前页码
		PageSize int                    `json:"page_size"` // 每页条数
	}
	// 更新教学团队关联请求
	UpdateCourseTeacherReq {
		Id        int    `json:"id" form:"id" validate:"required"` // 关联ID（必填）
		CourseId  int    `json:"course_id" form:"course_id" validate:"omitempty"` // 可选更新：课程ID
		TeacherId int    `json:"teacher_id" form:"teacher_id" validate:"omitempty"` // 可选更新：教师ID
		Name      string `json:"name" form:"name" validate:"omitempty,max=100"` // 可选更新：教师姓名
		Title     string `json:"title" form:"title" validate:"omitempty,max=200"` // 可选更新：教师头衔
		Avatar    string `json:"avatar" form:"avatar" validate:"omitempty,max=512"` // 可选更新：头像URL
		Intro     string `json:"intro" form:"intro"` // 可选更新：教师简介
		Sort      int    `json:"sort" form:"sort" validate:"omitempty,min=0"` // 可选更新：排序
	}
	// 更新教学团队关联响应
	UpdateCourseTeacherResp {
		Message string `json:"message"` // 操作结果信息
	}
	// 删除教学团队关联请求
	DeleteCourseTeacherReq {
		Id int `json:"id" form:"id" path:"id" validate:"required"` // 关联ID（必填，路径参数）
	}
	// 删除教学团队关联响应
	DeleteCourseTeacherResp {
		Message string `json:"message"` // 操作结果信息
	}
)

@server (
	group:  course_teacher // 接口分组：教学团队
	prefix: /api/course-teacher // 接口前缀（与模块语义一致）
)
service course_teacher_api { // 服务名称：教学团队API
	@handler CreateCourseTeacherHandler // 创建教学团队关联
	post / (CreateCourseTeacherReq) returns (CreateCourseTeacherResp)

	@handler GetCourseTeacherHandler // 查询单个教学团队关联
	get /:id (GetCourseTeacherReq) returns (GetCourseTeacherResp)

	@handler ListCourseTeacherHandler // 教学团队列表查询（分页/筛选）
	post /list (ListCourseTeacherReq) returns (ListCourseTeacherResp)

	@handler UpdateCourseTeacherHandler // 更新教学团队关联
	put / (UpdateCourseTeacherReq) returns (UpdateCourseTeacherResp)

	@handler DeleteCourseTeacherHandler // 删除教学团队关联
	delete /:id (DeleteCourseTeacherReq) returns (DeleteCourseTeacherResp)
}