修改api结构

server/api/meeting/main_meeting/meeting.api

@@ -0,0 +1,104 @@
+// 公共结构体：会议详情（用于查询响应，包含表中所有字段）
+type MeetingDetail {
+	Id               int64  `json:"id"` // 会议ID（主键）
+	Theme            string `json:"theme"` // 会议主题
+	Subtitle         string `json:"subtitle"` // 会议副标题
+	Intro            string `json:"intro"` // 会议简介（Markdown）
+	CoverUrl         string `json:"cover_url"` // 封面图URL
+	ScheduleImageUrl string `json:"schedule_image_url"` // 日程图URL
+	StartTime        string `json:"start_time"` // 开始时间（格式：YYYY-MM-DD HH:MM:SS）
+	EndTime          string `json:"end_time"` // 结束时间（格式：YYYY-MM-DD HH:MM:SS）
+	CreateTime       string `json:"create_time"` // 创建时间（数据库自动生成）
+	UpdateTime       string `json:"update_time"` // 更新时间（数据库自动生成）
+}
+
+// 1. 创建会议（增）
+type CreateMeetingReq {
+	Theme            string `json:"theme" validate:"required"` // 会议主题（必填）
+	Subtitle         string `json:"subtitle,omitempty"` // 副标题（可选）
+	Intro            string `json:"intro,omitempty"` // 简介（可选）
+	CoverUrl         string `json:"cover_url,omitempty"` // 封面图URL（可选）
+	ScheduleImageUrl string `json:"schedule_image_url,omitempty"` // 日程图URL（可选）
+	StartTime        string `json:"start_time" validate:"required"` // 开始时间（必填，格式同上）
+	EndTime          string `json:"end_time" validate:"required"` // 结束时间（必填）
+}
+
+type CreateMeetingResp {
+	Msg       string `json:"message"` // 操作提示（如："创建成功"）
+	MeetingId int64  `json:"meeting_id"` // 新增会议的ID（创建成功返回）
+}
+
+// 2. 查询单条会议（查-详情）
+type GetMeetingReq {
+	Id int64 `json:"id" path:"id" validate:"required"` // 会议ID（从路径参数获取，必填）
+}
+
+type GetMeetingResp {
+	Msg     string         `json:"message"` // 操作提示
+	Meeting *MeetingDetail `json:"meeting"` // 会议详情（查询成功返回）
+}
+
+// 3. 查询会议列表（查-分页）
+type ListMeetingReq {
+	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）
+}
+
+type ListMeetingResp {
+	Msg      string           `json:"message"` // 操作提示
+	Total    int64            `json:"total"` // 总条数
+	Meetings []*MeetingDetail `json:"meetings"` // 会议列表（当前页数据）
+}
+
+// 4. 更新会议（改）
+type UpdateMeetingReq {
+	Id               int64  `json:"id" validate:"required"` // 会议ID（必填，用于定位要更新的记录）
+	Theme            string `json:"theme,omitempty"` // 会议主题（可选，不填则不更新）
+	Subtitle         string `json:"subtitle,omitempty"` // 副标题（可选）
+	Intro            string `json:"intro,omitempty"` // 简介（可选）
+	CoverUrl         string `json:"cover_url,omitempty"` // 封面图URL（可选）
+	ScheduleImageUrl string `json:"schedule_image_url,omitempty"` // 日程图URL（可选）
+	StartTime        string `json:"start_time,omitempty"` // 开始时间（可选）
+	EndTime          string `json:"end_time,omitempty"` // 结束时间（可选）
+}
+
+type UpdateMeetingResp {
+	Msg string `json:"message"` // 操作提示（如："更新成功"）
+}
+
+// 5. 删除会议（删）
+type DeleteMeetingReq {
+	Id int64 `json:"id" path:"id" validate:"required"` // 会议ID（从路径参数获取，必填）
+}
+
+type DeleteMeetingResp {
+	Msg string `json:"message"` // 操作提示（如："删除成功"）
+}
+
+// 接口服务定义
+@server (
+	group:  meeting // 接口分组：会议相关
+	prefix: /api/meeting
+)
+service meeting-api {
+	// 1. 创建会议（POST请求，提交会议信息）
+	@handler CreateMeetingHandler
+	post /api/meetings (CreateMeetingReq) returns (CreateMeetingResp)
+
+	// 2. 查询单条会议（GET请求，路径带ID）
+	@handler GetMeetingHandler
+	get /api/meetings/:id (GetMeetingReq) returns (GetMeetingResp)
+
+	// 3. 查询会议列表（GET请求，带分页参数）
+	@handler ListMeetingHandler
+	get /api/meetings (ListMeetingReq) returns (ListMeetingResp)
+
+	// 4. 更新会议（PUT请求，全量/部分更新）
+	@handler UpdateMeetingHandler
+	put /api/meetings (UpdateMeetingReq) returns (UpdateMeetingResp)
+
+	// 5. 删除会议（DELETE请求，路径带ID）
+	@handler DeleteMeetingHandler
+	delete /api/meetings/:id (DeleteMeetingReq) returns (DeleteMeetingResp)
+}
+

server/api/meeting/meeting_speaker/meeting_speaker.api

@@ -0,0 +1,105 @@
+// 嘉宾详情结构体（包含表中所有字段，用于查询响应）
+type SpeakerDetail {
+	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 {
+	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 {
+	Msg       string `json:"message"` // 操作提示（如："嘉宾创建成功"）
+	SpeakerId int64  `json:"speaker_id"` // 新增嘉宾的ID
+}
+
+// 请求参数：通过嘉宾ID查询详情
+type GetSpeakerReq {
+	Id int64 `path:"id" validate:"required,min=1"` // 嘉宾ID（从路径参数获取，必填）
+}
+
+// 响应结果：返回单个嘉宾详情
+type GetSpeakerResp {
+	Msg     string         `json:"message"` // 操作提示
+	Speaker *SpeakerDetail `json:"speaker"` // 嘉宾详情（查询成功返回）
+}
+
+// 请求参数：通过会议ID查询该会议的所有嘉宾（支持排序和分页）
+type ListSpeakersByMeetingReq {
+	MeetingId int64 `path:"meetingId" validate:"required,min=1"` // 会议ID（从路径参数获取，必填）
+	Page      int   `query:"page" validate:"min=1"` // 页码（默认1）
+	PageSize  int   `query:"page_size" validate:"min=1,max=100"` // 每页条数（默认10，最大100）
+}
+
+// 响应结果：返回会议下的嘉宾列表（按sort排序）
+type ListSpeakersByMeetingResp {
+	Msg      string           `json:"message"` // 操作提示
+	Total    int64            `json:"total"` // 该会议下的嘉宾总数
+	Speakers []*SpeakerDetail `json:"speakers"` // 嘉宾列表（当前页数据，按sort升序排列）
+}
+
+// 请求参数：更新嘉宾信息（支持部分字段更新，必填id定位嘉宾）
+type UpdateSpeakerReq {
+	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 {
+	Msg string `json:"message"` // 操作提示（如："嘉宾信息更新成功"）
+}
+
+// 请求参数：通过嘉宾ID进行软删除（更新is_delete=1）
+type DeleteSpeakerReq {
+	Id int64 `path:"id" validate:"required,min=1"` // 嘉宾ID（从路径参数获取，必填）
+}
+
+// 响应结果：删除操作提示
+type DeleteSpeakerResp {
+	Msg string `json:"message"` // 操作提示（如："嘉宾已删除"）
+}
+
+@server (
+	group:  meeting_speaker // 接口分组：会议嘉宾相关
+	prefix: /api/meetingspeaker
+)
+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)
+}
+