From 57af67556bf982827cc3f6fd59e84e215ac90431 Mon Sep 17 00:00:00 2001
From: mayiming <1627832236@qq.com>
Date: Tue, 28 Oct 2025 15:57:14 +0800
Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BC=9A=E8=AE=AE=E6=BC=94?=
 =?UTF-8?q?=E8=AE=B2sql?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 server/api/meeting_spaeker.api | 106 +++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 server/api/meeting_spaeker.api

diff --git a/server/api/meeting_spaeker.api b/server/api/meeting_spaeker.api
new file mode 100644
index 00000000..8b59dd1b
--- /dev/null
+++ b/server/api/meeting_spaeker.api
@@ -0,0 +1,106 @@
+// 嘉宾详情结构体（包含表中所有字段，用于查询响应）
+type SpeakerDetail struct {
+    Id         int64  `json:"id"`          // 嘉宾ID（主键）
+    MeetingId  int64  `json:"meeting_id"`  // 关联会议ID（外键）
+    Name       string `json:"name"`        // 嘉宾姓名
+    Title      string `json:"title"`       // 嘉宾头衔
+    Avatar     string `json:"avatar"`      // 嘉宾头像URL
+    Intro      string `json:"intro"`       // 嘉宾简介
+    Sort       int    `json:"sort"`        // 排序（数字越小越靠前）
+    IsDelete   int    `json:"is_delete"`   // 软删除标识（0-未删，1-已删）
+}
+
+// 请求参数：创建嘉宾时需传入的信息（不含自动生成的id和软删除字段）
+type CreateSpeakerReq struct {
+    MeetingId  int64  `json:"meeting_id" validate:"required,min=1"` // 关联会议ID（必填，需存在对应的会议）
+    Name       string `json:"name" validate:"required,min=1,max=100"` // 嘉宾姓名（必填，长度限制）
+    Title      string `json:"title,omitempty" validate:"max=200"`    // 嘉宾头衔（可选，最长200字）
+    Avatar     string `json:"avatar,omitempty" validate:"max=512"`   // 头像URL（可选，最长512字符）
+    Intro      string `json:"intro,omitempty"`                       // 嘉宾简介（可选，长文本）
+    Sort       int    `json:"sort,omitempty" validate:"min=0"`       // 排序（可选，默认0，非负整数）
+}
+
+// 响应结果：创建成功后返回嘉宾ID
+type CreateSpeakerResp struct {
+    Msg        string `json:"message"`       // 操作提示（如："嘉宾创建成功"）
+    SpeakerId  int64  `json:"speaker_id"`    // 新增嘉宾的ID
+}
+
+// 请求参数：通过嘉宾ID查询详情
+type GetSpeakerReq struct {
+    Id  int64 `json:"id" path:"id" validate:"required,min=1"` // 嘉宾ID（从路径参数获取，必填）
+}
+
+// 响应结果：返回单个嘉宾详情
+type GetSpeakerResp struct {
+    Msg     string        `json:"message"`  // 操作提示
+    Speaker *SpeakerDetail `json:"speaker"` // 嘉宾详情（查询成功返回）
+}
+
+// 请求参数：通过会议ID查询该会议的所有嘉宾（支持排序和分页）
+type ListSpeakersByMeetingReq struct {
+    MeetingId  int64 `json:"meeting_id" path:"meetingId" validate:"required,min=1"` // 会议ID（从路径参数获取，必填）
+    Page       int   `json:"page" query:"page" validate:"min=1"`                    // 页码（默认1）
+    PageSize   int   `json:"page_size" query:"page_size" validate:"min=1,max=100"`  // 每页条数（默认10，最大100）
+}
+
+// 响应结果：返回会议下的嘉宾列表（按sort排序）
+type ListSpeakersByMeetingResp struct {
+    Msg       string          `json:"message"`    // 操作提示
+    Total     int64           `json:"total"`      // 该会议下的嘉宾总数
+    Speakers  []*SpeakerDetail `json:"speakers"`  // 嘉宾列表（当前页数据，按sort升序排列）
+}
+
+// 请求参数：更新嘉宾信息（支持部分字段更新，必填id定位嘉宾）
+type UpdateSpeakerReq struct {
+    Id         int64  `json:"id" validate:"required,min=1"`          // 嘉宾ID（必填，定位要更新的记录）
+    MeetingId  int64  `json:"meeting_id,omitempty" validate:"min=1"` // 关联会议ID（可选，不填则不更新）
+    Name       string `json:"name,omitempty" validate:"min=1,max=100"` // 嘉宾姓名（可选，更新时需非空）
+    Title      string `json:"title,omitempty" validate:"max=200"`     // 嘉宾头衔（可选）
+    Avatar     string `json:"avatar,omitempty" validate:"max=512"`    // 头像URL（可选）
+    Intro      string `json:"intro,omitempty"`                        // 嘉宾简介（可选）
+    Sort       int    `json:"sort,omitempty" validate:"min=0"`        // 排序（可选）
+}
+
+// 响应结果：更新操作提示
+type UpdateSpeakerResp struct {
+    Msg string `json:"message"` // 操作提示（如："嘉宾信息更新成功"）
+}
+
+// 请求参数：通过嘉宾ID进行软删除（更新is_delete=1）
+type DeleteSpeakerReq struct {
+    Id  int64 `json:"id" path:"id" validate:"required,min=1"` // 嘉宾ID（从路径参数获取，必填）
+}
+
+// 响应结果：删除操作提示
+type DeleteSpeakerResp struct {
+    Msg string `json:"message"` // 操作提示（如："嘉宾已删除"）
+}
+
+@server (
+    group: meeting_speaker  // 接口分组：会议嘉宾相关
+)
+service meeting-speaker-api {
+    // 1. 创建嘉宾（POST请求，关联会议ID）
+    @handler CreateSpeakerHandler
+    post /api/speakers (CreateSpeakerReq) returns (CreateSpeakerResp)
+
+    // 2. 查询单个嘉宾（GET请求，路径带嘉宾ID）
+    @handler GetSpeakerHandler
+    get /api/speakers/:id (GetSpeakerReq) returns (GetSpeakerResp)
+
+    // 3. 查询会议下的嘉宾列表（GET请求，路径带会议ID，核心接口）
+    @handler ListSpeakersByMeetingHandler
+    get /api/meetings/:meetingId/speakers (ListSpeakersByMeetingReq) returns (ListSpeakersByMeetingResp)
+
+    // 4. 更新嘉宾信息（PUT请求，支持部分字段更新）
+    @handler UpdateSpeakerHandler
+    put /api/speakers (UpdateSpeakerReq) returns (UpdateSpeakerResp)
+
+    // 5. 软删除嘉宾（DELETE请求，路径带嘉宾ID）
+    @handler DeleteSpeakerHandler
+    delete /api/speakers/:id (DeleteSpeakerReq) returns (DeleteSpeakerResp)
+}
+
+
+