feat: 完成后端服务核心业务逻辑实现
Some checks failed
部署后端服务 / 🧪 测试后端 (push) Failing after 10m41s
部署后端服务 / 🚀 构建并部署 (push) Has been skipped
部署后端服务 / 🔄 回滚部署 (push) Has been skipped

## 主要功能
-  用户认证模块 (登录/注册/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:
xujiang
2025-07-10 16:12:12 +08:00
parent 39a42695d3
commit 317dc170f9
145 changed files with 3669 additions and 20721 deletions

100
backend/api/desc/photo.api Normal file
View File

@ -0,0 +1,100 @@
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)
}