feat: 完成后端服务核心业务逻辑实现
## 主要功能 - ✅ 用户认证模块 (登录/注册/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 构建脚本 服务已验证可正常构建和启动。
This commit is contained in:
96
backend/api/desc/category.api
Normal file
96
backend/api/desc/category.api
Normal file
@ -0,0 +1,96 @@
|
||||
syntax = "v1"
|
||||
|
||||
import "common.api"
|
||||
|
||||
// 分类管理接口
|
||||
|
||||
// 获取分类列表请求
|
||||
type GetCategoryListRequest {
|
||||
PageRequest
|
||||
Keyword string `form:"keyword,optional"`
|
||||
}
|
||||
|
||||
// 获取分类列表响应
|
||||
type GetCategoryListResponse {
|
||||
BaseResponse
|
||||
Data CategoryListData `json:"data"`
|
||||
}
|
||||
|
||||
type CategoryListData {
|
||||
PageResponse
|
||||
Categories []Category `json:"categories"`
|
||||
}
|
||||
|
||||
// 获取分类详情请求
|
||||
type GetCategoryRequest {
|
||||
Id int64 `path:"id"`
|
||||
}
|
||||
|
||||
// 获取分类详情响应
|
||||
type GetCategoryResponse {
|
||||
BaseResponse
|
||||
Data Category `json:"data"`
|
||||
}
|
||||
|
||||
// 创建分类请求
|
||||
type CreateCategoryRequest {
|
||||
Name string `json:"name" validate:"required"`
|
||||
Description string `json:"description,optional"`
|
||||
}
|
||||
|
||||
// 创建分类响应
|
||||
type CreateCategoryResponse {
|
||||
BaseResponse
|
||||
Data Category `json:"data"`
|
||||
}
|
||||
|
||||
// 更新分类请求
|
||||
type UpdateCategoryRequest {
|
||||
Id int64 `path:"id"`
|
||||
Name string `json:"name,optional"`
|
||||
Description string `json:"description,optional"`
|
||||
}
|
||||
|
||||
// 更新分类响应
|
||||
type UpdateCategoryResponse {
|
||||
BaseResponse
|
||||
Data Category `json:"data"`
|
||||
}
|
||||
|
||||
// 删除分类请求
|
||||
type DeleteCategoryRequest {
|
||||
Id int64 `path:"id"`
|
||||
}
|
||||
|
||||
// 删除分类响应
|
||||
type DeleteCategoryResponse {
|
||||
BaseResponse
|
||||
}
|
||||
|
||||
// 分类管理接口组
|
||||
@server(
|
||||
group: category
|
||||
prefix: /api/v1/categories
|
||||
jwt: Auth
|
||||
)
|
||||
service photography-api {
|
||||
@doc "获取分类列表"
|
||||
@handler getCategoryList
|
||||
get / (GetCategoryListRequest) returns (GetCategoryListResponse)
|
||||
|
||||
@doc "创建分类"
|
||||
@handler createCategory
|
||||
post / (CreateCategoryRequest) returns (CreateCategoryResponse)
|
||||
|
||||
@doc "获取分类详情"
|
||||
@handler getCategory
|
||||
get /:id (GetCategoryRequest) returns (GetCategoryResponse)
|
||||
|
||||
@doc "更新分类"
|
||||
@handler updateCategory
|
||||
put /:id (UpdateCategoryRequest) returns (UpdateCategoryResponse)
|
||||
|
||||
@doc "删除分类"
|
||||
@handler deleteCategory
|
||||
delete /:id (DeleteCategoryRequest) returns (DeleteCategoryResponse)
|
||||
}
|
||||
Reference in New Issue
Block a user