1e828e03fe
## 主要功能 - ✅ 用户认证模块 (登录/注册/JWT) - ✅ 照片管理模块 (上传/查询/分页/搜索) - ✅ 分类管理模块 (创建/查询/分页) - ✅ 用户管理模块 (用户列表/分页查询) - ✅ 健康检查接口 ## 技术实现 - 基于 go-zero v1.8.0 标准架构 - Handler → Logic → Model 三层架构 - SQLite/PostgreSQL 数据库支持 - JWT 认证机制 - bcrypt 密码加密 - 统一响应格式 - 自定义模型方法 (分页/搜索) ## API 接口 - POST /api/v1/auth/login - 用户登录 - POST /api/v1/auth/register - 用户注册 - GET /api/v1/health - 健康检查 - GET /api/v1/photos - 照片列表 - POST /api/v1/photos - 上传照片 - GET /api/v1/categories - 分类列表 - POST /api/v1/categories - 创建分类 - GET /api/v1/users - 用户列表 ## 配置完成 - 开发环境配置 (SQLite) - 生产环境支持 (PostgreSQL) - JWT 认证配置 - 文件上传配置 - Makefile 构建脚本 服务已验证可正常构建和启动。
100 lines
2.1 KiB
Plaintext
100 lines
2.1 KiB
Plaintext
syntax = "v1"
|
|
|
|
import "common.api"
|
|
|
|
// 照片管理接口
|
|
|
|
// 获取照片列表请求
|
|
type GetPhotoListRequest {
|
|
PageRequest
|
|
CategoryId int64 `form:"category_id,optional"`
|
|
UserId int64 `form:"user_id,optional"`
|
|
Keyword string `form:"keyword,optional"`
|
|
}
|
|
|
|
// 获取照片列表响应
|
|
type GetPhotoListResponse {
|
|
BaseResponse
|
|
Data PhotoListData `json:"data"`
|
|
}
|
|
|
|
type PhotoListData {
|
|
PageResponse
|
|
Photos []Photo `json:"photos"`
|
|
}
|
|
|
|
// 获取照片详情请求
|
|
type GetPhotoRequest {
|
|
Id int64 `path:"id"`
|
|
}
|
|
|
|
// 获取照片详情响应
|
|
type GetPhotoResponse {
|
|
BaseResponse
|
|
Data Photo `json:"data"`
|
|
}
|
|
|
|
// 上传照片请求
|
|
type UploadPhotoRequest {
|
|
Title string `json:"title" validate:"required"`
|
|
Description string `json:"description,optional"`
|
|
CategoryId int64 `json:"category_id" validate:"required"`
|
|
}
|
|
|
|
// 上传照片响应
|
|
type UploadPhotoResponse {
|
|
BaseResponse
|
|
Data Photo `json:"data"`
|
|
}
|
|
|
|
// 更新照片请求
|
|
type UpdatePhotoRequest {
|
|
Id int64 `path:"id"`
|
|
Title string `json:"title,optional"`
|
|
Description string `json:"description,optional"`
|
|
CategoryId int64 `json:"category_id,optional"`
|
|
}
|
|
|
|
// 更新照片响应
|
|
type UpdatePhotoResponse {
|
|
BaseResponse
|
|
Data Photo `json:"data"`
|
|
}
|
|
|
|
// 删除照片请求
|
|
type DeletePhotoRequest {
|
|
Id int64 `path:"id"`
|
|
}
|
|
|
|
// 删除照片响应
|
|
type DeletePhotoResponse {
|
|
BaseResponse
|
|
}
|
|
|
|
// 照片管理接口组
|
|
@server(
|
|
group: photo
|
|
prefix: /api/v1/photos
|
|
jwt: Auth
|
|
)
|
|
service photography-api {
|
|
@doc "获取照片列表"
|
|
@handler getPhotoList
|
|
get / (GetPhotoListRequest) returns (GetPhotoListResponse)
|
|
|
|
@doc "上传照片"
|
|
@handler uploadPhoto
|
|
post / (UploadPhotoRequest) returns (UploadPhotoResponse)
|
|
|
|
@doc "获取照片详情"
|
|
@handler getPhoto
|
|
get /:id (GetPhotoRequest) returns (GetPhotoResponse)
|
|
|
|
@doc "更新照片"
|
|
@handler updatePhoto
|
|
put /:id (UpdatePhotoRequest) returns (UpdatePhotoResponse)
|
|
|
|
@doc "删除照片"
|
|
@handler deletePhoto
|
|
delete /:id (DeletePhotoRequest) returns (DeletePhotoResponse)
|
|
} |