feat: 完成API接口隔离设计和定义
Some checks failed
部署管理后台 / 🧪 测试和构建 (push) Failing after 1m5s
部署管理后台 / 🔒 安全扫描 (push) Has been skipped
部署前端网站 / 🧪 测试和构建 (push) Failing after 2m0s
部署管理后台 / 🚀 部署到生产环境 (push) Has been skipped
部署后端服务 / 🚀 构建并部署 (push) Has been skipped
部署后端服务 / 🧪 测试后端 (push) Failing after 3m15s
部署前端网站 / 🚀 部署到生产环境 (push) Has been skipped
部署管理后台 / 🔄 回滚部署 (push) Has been skipped
部署后端服务 / 🔄 回滚部署 (push) Has been skipped
Some checks failed
部署管理后台 / 🧪 测试和构建 (push) Failing after 1m5s
部署管理后台 / 🔒 安全扫描 (push) Has been skipped
部署前端网站 / 🧪 测试和构建 (push) Failing after 2m0s
部署管理后台 / 🚀 部署到生产环境 (push) Has been skipped
部署后端服务 / 🚀 构建并部署 (push) Has been skipped
部署后端服务 / 🧪 测试后端 (push) Failing after 3m15s
部署前端网站 / 🚀 部署到生产环境 (push) Has been skipped
部署管理后台 / 🔄 回滚部署 (push) Has been skipped
部署后端服务 / 🔄 回滚部署 (push) Has been skipped
🚀 主要功能: - 创建前端公共展示API (/api/v1/public/*) - 创建前端用户认证API (/api/v1/auth/*) - 创建管理后台完整API (/admin/*) - 实现双重认证体系设计 📋 新增文件: - api/desc/frontend/public.api - 前端公共接口定义 - api/desc/frontend/auth.api - 前端认证接口定义 - api/desc/admin.api - 管理后台主入口 - api/desc/admin/auth.api - 管理员认证接口 - api/desc/admin/users.api - 用户管理接口 - api/desc/admin/photos.api - 照片管理接口 - api/desc/admin/categories.api - 分类管理接口 - api/desc/admin/dashboard.api - 仪表板统计接口 🔧 更新文件: - api/desc/common.api - 扩展类型定义支持前端和管理后台 - api/desc/photography.api - 更新为前端主入口 - etc/photographyapi-api.yaml - 修复中间件配置 📚 文档: - docs/API_SEPARATION_DESIGN.md - 接口隔离设计方案 - docs/API_REFACTORING_TASKS.md - 详细任务规划 - docs/COMPLETED_TASKS_ARCHIVE.md - 已完成任务归档 ✨ 特性亮点: - 前端和管理后台权限完全隔离 - 优化的数据结构去除敏感信息 - 完整的CRUD和统计功能 - 支持批量操作和高级筛选 - 详细的仪表板分析功能
This commit is contained in:
109
backend/api/desc/frontend/auth.api
Normal file
109
backend/api/desc/frontend/auth.api
Normal file
@ -0,0 +1,109 @@
|
||||
syntax = "v1"
|
||||
|
||||
import "common.api"
|
||||
|
||||
// 前端用户认证接口 - 轻量级认证
|
||||
|
||||
// 前端用户登录请求
|
||||
type FrontendLoginRequest {
|
||||
Username string `json:"username" validate:"required"`
|
||||
Password string `json:"password" validate:"required"`
|
||||
}
|
||||
|
||||
// 前端用户登录响应
|
||||
type FrontendLoginResponse {
|
||||
BaseResponse
|
||||
Data FrontendLoginData `json:"data"`
|
||||
}
|
||||
|
||||
type FrontendLoginData {
|
||||
Token string `json:"token"`
|
||||
User FrontendUser `json:"user"`
|
||||
}
|
||||
|
||||
// 前端用户注册请求
|
||||
type FrontendRegisterRequest {
|
||||
Username string `json:"username" validate:"required"`
|
||||
Email string `json:"email" validate:"required,email"`
|
||||
Password string `json:"password" validate:"required,min=6"`
|
||||
}
|
||||
|
||||
// 前端用户注册响应
|
||||
type FrontendRegisterResponse {
|
||||
BaseResponse
|
||||
Data FrontendUser `json:"data"`
|
||||
}
|
||||
|
||||
// 前端用户信息响应
|
||||
type FrontendProfileResponse {
|
||||
BaseResponse
|
||||
Data FrontendUser `json:"data"`
|
||||
}
|
||||
|
||||
// 前端用户更新请求
|
||||
type UpdateFrontendProfileRequest {
|
||||
Username string `json:"username,optional"`
|
||||
Email string `json:"email,optional"`
|
||||
Avatar string `json:"avatar,optional"`
|
||||
}
|
||||
|
||||
// 前端用户更新响应
|
||||
type UpdateFrontendProfileResponse {
|
||||
BaseResponse
|
||||
Data FrontendUser `json:"data"`
|
||||
}
|
||||
|
||||
// 前端用户修改密码请求
|
||||
type ChangeFrontendPasswordRequest {
|
||||
OldPassword string `json:"old_password" validate:"required"`
|
||||
NewPassword string `json:"new_password" validate:"required,min=6"`
|
||||
}
|
||||
|
||||
// 前端用户修改密码响应
|
||||
type ChangeFrontendPasswordResponse {
|
||||
BaseResponse
|
||||
}
|
||||
|
||||
// 前端用户登出响应
|
||||
type FrontendLogoutResponse {
|
||||
BaseResponse
|
||||
}
|
||||
|
||||
// 前端认证接口组
|
||||
@server(
|
||||
group: auth
|
||||
prefix: /api/v1/auth
|
||||
)
|
||||
service photography-api {
|
||||
@doc "前端用户登录"
|
||||
@handler frontendLogin
|
||||
post /login (FrontendLoginRequest) returns (FrontendLoginResponse)
|
||||
|
||||
@doc "前端用户注册"
|
||||
@handler frontendRegister
|
||||
post /register (FrontendRegisterRequest) returns (FrontendRegisterResponse)
|
||||
|
||||
@doc "前端用户登出"
|
||||
@handler frontendLogout
|
||||
post /logout returns (FrontendLogoutResponse)
|
||||
}
|
||||
|
||||
// 前端用户认证接口组 - 需要认证
|
||||
@server(
|
||||
group: auth
|
||||
prefix: /api/v1/auth
|
||||
jwt: Auth
|
||||
)
|
||||
service photography-api {
|
||||
@doc "获取前端用户信息"
|
||||
@handler getFrontendProfile
|
||||
get /profile returns (FrontendProfileResponse)
|
||||
|
||||
@doc "更新前端用户信息"
|
||||
@handler updateFrontendProfile
|
||||
put /profile (UpdateFrontendProfileRequest) returns (UpdateFrontendProfileResponse)
|
||||
|
||||
@doc "修改前端用户密码"
|
||||
@handler changeFrontendPassword
|
||||
post /change-password (ChangeFrontendPasswordRequest) returns (ChangeFrontendPasswordResponse)
|
||||
}
|
||||
Reference in New Issue
Block a user