mayiming/hldrCenter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修改api结构

Browse Source
This commit is contained in:
马懿铭
2025-11-01 23:38:51 +08:00
parent c2db98cd76
commit 6351539237
21 changed files with 0 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

136
server/api/social/social_service/social_service.api Normal file
View File

@@ -0,0 +1,136 @@
// 通用基础响应结构（不含泛型，兼容Goctl）
type BaseResp {
Code int `json:"code"` // 状态码：0成功，非0失败
Msg string `json:"message"` // 提示信息
}
// 社会服务实体结构（与表字段对应）
type SocialService {
Id int64 `json:"id"` // 主键ID
Title string `json:"title"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
PublishTime string `json:"publish_time"` // 发布时间（格式：yyyy-MM-dd HH:mm:ss）
UpdateTime string `json:"update_time"` // 最后更改时间（格式：yyyy-MM-dd HH:mm:ss）
}
// 创建社会服务 - 请求参数
type CreateSocialServiceReq {
Title string `json:"title" validate:"required"` // 标题（必填）
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 创建社会服务 - 响应参数（嵌套数据，无泛型）
type CreateSocialServiceResp {
Code int `json:"code"`
Msg string `json:"message"`
Data CreateSocialServiceData `json:"data,omitempty"`
}
type CreateSocialServiceData {
Id int64 `json:"id"` // 新增记录的ID
}
// 获取社会服务列表 - 请求参数
type ListSocialServiceReq {
Page int `json:"page" form:"page" validate:"min=1"` // 页码（默认1）
PageSize int `json:"page_size" form:"page_size" validate:"min=1,max=100"` // 每页条数（默认10，最大100）
}
// 获取社会服务列表 - 响应参数（嵌套数据，无泛型）
type ListSocialServiceResp {
Code int `json:"code"`
Msg string `json:"message"`
Data ListSocialServiceData `json:"data,omitempty"`
}
type ListSocialServiceData {
Total int64 `json:"total"` // 总条数
List []SocialService `json:"list"` // 列表数据
}
// 获取社会服务详情 - 请求参数（路径参数）
type GetSocialServiceReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务ID（必填）
}
// 获取社会服务详情 - 响应参数（嵌套数据，无泛型）
type GetSocialServiceResp {
Code int `json:"code"`
Msg string `json:"message"`
Data SocialService `json:"data,omitempty"`
}
// 更新社会服务 - 请求参数
type UpdateSocialServiceReq {
Id int64 `json:"-" path:"id" validate:"min=1"` // 社会服务ID（路径参数，必填）
Title string `json:"title,omitempty"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 更新社会服务 - 响应参数（基础响应，无额外数据）
type UpdateSocialServiceResp {
Code int `json:"code"`
Msg string `json:"message"`
}
// 删除社会服务 - 请求参数（路径参数）
type DeleteSocialServiceReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务ID（必填）
}
// 删除社会服务 - 响应参数（基础响应，无额外数据）
type DeleteSocialServiceResp {
Code int `json:"code"`
Msg string `json:"message"`
}
@server (
group: socialService
prefix: /api/social-service // 统一前缀，接口路径无需重复
)
service social_service_api {
// 创建社会服务
@handler CreateSocialServiceHandler
post / (CreateSocialServiceReq) returns (CreateSocialServiceResp)
// 获取社会服务列表
@handler ListSocialServiceHandler
get /list (ListSocialServiceReq) returns (ListSocialServiceResp)
// 获取社会服务详情
@handler GetSocialServiceHandler
get /:id (GetSocialServiceReq) returns (GetSocialServiceResp)
// 更新社会服务
@handler UpdateSocialServiceHandler
put /:id (UpdateSocialServiceReq) returns (UpdateSocialServiceResp)
// 删除社会服务
@handler DeleteSocialServiceHandler
delete /:id (DeleteSocialServiceReq) returns (DeleteSocialServiceResp)
}

136
server/api/social/socical_service_governmentprogram/social_service_governmentprogram.api Normal file
View File

@@ -0,0 +1,136 @@
// 通用基础响应结构（不含泛型，兼容Goctl）
type BaseResp {
Code int `json:"code"` // 状态码：0成功，非0失败
Msg string `json:"message"` // 提示信息
}
// 社会服务政府项目实体结构（与表字段对应）
type SocialServiceGovernmentProgram {
Id int64 `json:"id"` // 主键ID
Title string `json:"title"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
PublishTime string `json:"publish_time"` // 发布时间（格式：yyyy-MM-dd HH:mm:ss）
UpdateTime string `json:"update_time"` // 最后更改时间（格式：yyyy-MM-dd HH:mm:ss）
}
// 创建社会服务政府项目 - 请求参数
type CreateSocialServiceGovernmentProgramReq {
Title string `json:"title" validate:"required"` // 标题（必填）
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 创建社会服务政府项目 - 响应参数（嵌套数据，无泛型）
type CreateSocialServiceGovernmentProgramResp {
Code int `json:"code"`
Msg string `json:"message"`
Data CreateSocialServiceGovernmentProgramData `json:"data,omitempty"`
}
type CreateSocialServiceGovernmentProgramData {
Id int64 `json:"id"` // 新增记录的ID
}
// 获取社会服务政府项目列表 - 请求参数
type ListSocialServiceGovernmentProgramReq {
Page int `json:"page" form:"page" validate:"min=1"` // 页码（默认1）
PageSize int `json:"page_size" form:"page_size" validate:"min=1,max=100"` // 每页条数（默认10，最大100）
}
// 获取社会服务政府项目列表 - 响应参数（嵌套数据，无泛型）
type ListSocialServiceGovernmentProgramResp {
Code int `json:"code"`
Msg string `json:"message"`
Data ListSocialServiceGovernmentProgramData `json:"data,omitempty"`
}
type ListSocialServiceGovernmentProgramData {
Total int64 `json:"total"` // 总条数
List []SocialServiceGovernmentProgram `json:"list"` // 列表数据
}
// 获取社会服务政府项目详情 - 请求参数（路径参数）
type GetSocialServiceGovernmentProgramReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务政府项目ID（必填）
}
// 获取社会服务政府项目详情 - 响应参数（嵌套数据，无泛型）
type GetSocialServiceGovernmentProgramResp {
Code int `json:"code"`
Msg string `json:"message"`
Data SocialServiceGovernmentProgram `json:"data,omitempty"`
}
// 更新社会服务政府项目 - 请求参数
type UpdateSocialServiceGovernmentProgramReq {
Id int64 `json:"-" path:"id" validate:"min=1"` // 社会服务政府项目ID（路径参数，必填）
Title string `json:"title,omitempty"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 更新社会服务政府项目 - 响应参数（基础响应，无额外数据）
type UpdateSocialServiceGovernmentProgramResp {
Code int `json:"code"`
Msg string `json:"message"`
}
// 删除社会服务政府项目 - 请求参数（路径参数）
type DeleteSocialServiceGovernmentProgramReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务政府项目ID（必填）
}
// 删除社会服务政府项目 - 响应参数（基础响应，无额外数据）
type DeleteSocialServiceGovernmentProgramResp {
Code int `json:"code"`
Msg string `json:"message"`
}
@server (
group: socialServiceGovernmentProgram
prefix: /api/social-service/government-program // 统一前缀，区分政府项目相关接口
)
service social_service_governmentprogram_api {
// 创建社会服务政府项目
@handler CreateSocialServiceGovernmentProgramHandler
post / (CreateSocialServiceGovernmentProgramReq) returns (CreateSocialServiceGovernmentProgramResp)
// 获取社会服务政府项目列表
@handler ListSocialServiceGovernmentProgramHandler
get /list (ListSocialServiceGovernmentProgramReq) returns (ListSocialServiceGovernmentProgramResp)
// 获取社会服务政府项目详情
@handler GetSocialServiceGovernmentProgramHandler
get /:id (GetSocialServiceGovernmentProgramReq) returns (GetSocialServiceGovernmentProgramResp)
// 更新社会服务政府项目
@handler UpdateSocialServiceGovernmentProgramHandler
put /:id (UpdateSocialServiceGovernmentProgramReq) returns (UpdateSocialServiceGovernmentProgramResp)
// 删除社会服务政府项目
@handler DeleteSocialServiceGovernmentProgramHandler
delete /:id (DeleteSocialServiceGovernmentProgramReq) returns (DeleteSocialServiceGovernmentProgramResp)
}

136
server/api/social/socical_service_internship/social_service_internship.api Normal file
View File

@@ -0,0 +1,136 @@
// 通用基础响应结构（不含泛型，兼容Goctl）
type BaseResp {
Code int `json:"code"` // 状态码：0成功，非0失败
Msg string `json:"message"` // 提示信息
}
// 社会服务实习实体结构（与表字段对应）
type SocialServiceInternship {
Id int64 `json:"id"` // 主键ID
Title string `json:"title"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
PublishTime string `json:"publish_time"` // 发布时间（格式：yyyy-MM-dd HH:mm:ss）
UpdateTime string `json:"update_time"` // 最后更改时间（格式：yyyy-MM-dd HH:mm:ss）
}
// 创建社会服务实习 - 请求参数
type CreateSocialServiceInternshipReq {
Title string `json:"title" validate:"required"` // 标题（必填）
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 创建社会服务实习 - 响应参数（嵌套数据，无泛型）
type CreateSocialServiceInternshipResp {
Code int `json:"code"`
Msg string `json:"message"`
Data CreateSocialServiceInternshipData `json:"data,omitempty"`
}
type CreateSocialServiceInternshipData {
Id int64 `json:"id"` // 新增记录的ID
}
// 获取社会服务实习列表 - 请求参数
type ListSocialServiceInternshipReq {
Page int `json:"page" form:"page" validate:"min=1"` // 页码（默认1）
PageSize int `json:"page_size" form:"page_size" validate:"min=1,max=100"` // 每页条数（默认10，最大100）
}
// 获取社会服务实习列表 - 响应参数（嵌套数据，无泛型）
type ListSocialServiceInternshipResp {
Code int `json:"code"`
Msg string `json:"message"`
Data ListSocialServiceInternshipData `json:"data,omitempty"`
}
type ListSocialServiceInternshipData {
Total int64 `json:"total"` // 总条数
List []SocialServiceInternship `json:"list"` // 列表数据
}
// 获取社会服务实习详情 - 请求参数（路径参数）
type GetSocialServiceInternshipReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务实习ID（必填）
}
// 获取社会服务实习详情 - 响应参数（嵌套数据，无泛型）
type GetSocialServiceInternshipResp {
Code int `json:"code"`
Msg string `json:"message"`
Data SocialServiceInternship `json:"data,omitempty"`
}
// 更新社会服务实习 - 请求参数
type UpdateSocialServiceInternshipReq {
Id int64 `json:"-" path:"id" validate:"min=1"` // 社会服务实习ID（路径参数，必填）
Title string `json:"title,omitempty"` // 标题
Subtitle string `json:"subtitle,omitempty"` // 副标题
CoverUrl string `json:"cover_url,omitempty"` // 封面图片URL
Intro string `json:"intro,omitempty"` // 简介（纯文字）
Content string `json:"content,omitempty"` // 内容（Markdown格式）
ImageEditors string `json:"image_editors,omitempty"` // 图片编辑者名单（逗号分隔）
TextEditors string `json:"text_editors,omitempty"` // 文字编辑者名单（逗号分隔）
ChiefEditor string `json:"chief_editor,omitempty"` // 总编辑
Proofreaders string `json:"proofreaders,omitempty"` // 校对者名单（逗号分隔）
Reviewers string `json:"reviewers,omitempty"` // 审核者名单（逗号分隔）
}
// 更新社会服务实习 - 响应参数（基础响应，无额外数据）
type UpdateSocialServiceInternshipResp {
Code int `json:"code"`
Msg string `json:"message"`
}
// 删除社会服务实习 - 请求参数（路径参数）
type DeleteSocialServiceInternshipReq {
Id int64 `json:"id" path:"id" validate:"min=1"` // 社会服务实习ID（必填）
}
// 删除社会服务实习 - 响应参数（基础响应，无额外数据）
type DeleteSocialServiceInternshipResp {
Code int `json:"code"`
Msg string `json:"message"`
}
@server (
group: socialServiceInternship
prefix: /api/social-service/internship // 统一前缀，区分实习相关接口
)
service social_service_internship_api {
// 创建社会服务实习
@handler CreateSocialServiceInternshipHandler
post / (CreateSocialServiceInternshipReq) returns (CreateSocialServiceInternshipResp)
// 获取社会服务实习列表
@handler ListSocialServiceInternshipHandler
get /list (ListSocialServiceInternshipReq) returns (ListSocialServiceInternshipResp)
// 获取社会服务实习详情
@handler GetSocialServiceInternshipHandler
get /:id (GetSocialServiceInternshipReq) returns (GetSocialServiceInternshipResp)
// 更新社会服务实习
@handler UpdateSocialServiceInternshipHandler
put /:id (UpdateSocialServiceInternshipReq) returns (UpdateSocialServiceInternshipResp)
// 删除社会服务实习
@handler DeleteSocialServiceInternshipHandler
delete /:id (DeleteSocialServiceInternshipReq) returns (DeleteSocialServiceInternshipResp)
}