添加教学案例api和sql

2025-10-31 14:05:39 +08:00
parent 85942becdb
commit b47f3e7143
2 changed files with 95 additions and 0 deletions
--- a/server/api/teaching_case.api
+++ b/server/api/teaching_case.api
@@ -0,0 +1,82 @@
+// 教学案例请求结构体
+type CreateTeachingCaseReq {
+	Title        string `json:"title" validate:"required"` // 案例标题
+	TutorName    string `json:"tutor_name" validate:"required"` // 导师姓名
+	TutorTitle   string `json:"tutor_title"` // 导师头衔
+	StudentNames string `json:"student_names" validate:"required"` // 学生姓名（逗号分隔）
+	Content      string `json:"content" validate:"required"` // 案例内容
+	CoverUrl     string `json:"cover_url"` // 案例封面图URL
+	Sort         int    `json:"sort" default:"0"` // 排序
+}
+
+type UpdateTeachingCaseReq {
+	Id           int    `json:"id" validate:"required"` // 案例ID
+	Title        string `json:"title"` // 案例标题
+	TutorName    string `json:"tutor_name"` // 导师姓名
+	TutorTitle   string `json:"tutor_title"` // 导师头衔
+	StudentNames string `json:"student_names"` // 学生姓名（逗号分隔）
+	Content      string `json:"content"` // 案例内容
+	CoverUrl     string `json:"cover_url"` // 案例封面图URL
+	Sort         int    `json:"sort"` // 排序
+}
+
+type GetTeachingCaseReq {
+	Id int `json:"id" validate:"required" uri:"id"` // 案例ID
+}
+
+type DeleteTeachingCaseReq {
+	Id int `json:"id" validate:"required" uri:"id"` // 案例ID
+}
+
+type ListTeachingCaseReq {
+	Page    int    `json:"page" default:"1"` // 页码
+	Size    int    `json:"size" default:"10"` // 每页数量
+	Keyword string `json:"keyword"` // 搜索关键词（标题/导师姓名）
+	Sort    int    `json:"sort"` // 排序筛选
+}
+
+// 教学案例响应结构体
+type TeachingCaseResp {
+	Id           int    `json:"id"` // 案例ID
+	Title        string `json:"title"` // 案例标题
+	TutorName    string `json:"tutor_name"` // 导师姓名
+	TutorTitle   string `json:"tutor_title"` // 导师头衔
+	StudentNames string `json:"student_names"` // 学生姓名
+	Content      string `json:"content"` // 案例内容
+	CoverUrl     string `json:"cover_url"` // 封面图URL
+	Sort         int    `json:"sort"` // 排序
+	CreateTime   string `json:"create_time"` // 创建时间
+	UpdateTime   string `json:"update_time"` // 更新时间
+}
+
+type ListTeachingCaseResp {
+	Total int64              `json:"total"` // 总条数
+	List  []TeachingCaseResp `json:"list"` // 案例列表
+}
+
+type BaseResp {
+	Code int    `json:"code"` // 状态码（0成功，非0失败）
+	Msg  string `json:"msg"` // 提示信息
+}
+
+@server (
+	group:  teaching_case
+	prefix: /api/teaching-case
+)
+service teaching_case_api {
+	@handler CreateTeachingCaseHandler
+	post /api/teaching-cases (CreateTeachingCaseReq) returns (BaseResp)
+
+	@handler UpdateTeachingCaseHandler
+	put /api/teaching-cases (UpdateTeachingCaseReq) returns (BaseResp)
+
+	@handler GetTeachingCaseHandler
+	get /api/teaching-cases/:id (GetTeachingCaseReq) returns (TeachingCaseResp)
+
+	@handler DeleteTeachingCaseHandler
+	delete /api/teaching-cases/:id (DeleteTeachingCaseReq) returns (BaseResp)
+
+	@handler ListTeachingCaseHandler
+	get /api/teaching-cases (ListTeachingCaseReq) returns (ListTeachingCaseResp)
+}
+