feat: 完成API接口隔离设计和定义

🚀 主要功能:
- 创建前端公共展示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和统计功能
- 支持批量操作和高级筛选
- 详细的仪表板分析功能

backend/api/desc/frontend/auth.api

@@ -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)
+}

backend/api/desc/frontend/public.api

@@ -0,0 +1,117 @@
+syntax = "v1"
+
+import "common.api"
+
+// 前端公共展示接口 - 无需认证
+
+// 获取照片列表请求
+type GetPublicPhotoListRequest {
+    PageRequest
+    CategoryId int64  `form:"category_id,optional"`
+    Keyword    string `form:"keyword,optional"`
+    Sort       string `form:"sort,optional,default=created_at_desc"` // created_at_desc, created_at_asc, title_asc, title_desc
+}
+
+// 获取照片列表响应
+type GetPublicPhotoListResponse {
+    BaseResponse
+    Data PublicPhotoListData `json:"data"`
+}
+
+type PublicPhotoListData {
+    PageResponse
+    Photos []PublicPhoto `json:"photos"`
+}
+
+// 获取照片详情请求
+type GetPublicPhotoRequest {
+    Id int64 `path:"id"`
+}
+
+// 获取照片详情响应
+type GetPublicPhotoResponse {
+    BaseResponse
+    Data PublicPhoto `json:"data"`
+}
+
+// 获取精选照片响应
+type GetFeaturedPhotosResponse {
+    BaseResponse
+    Data []PublicPhoto `json:"data"`
+}
+
+// 获取最新照片请求
+type GetRecentPhotosRequest {
+    Limit int `form:"limit,optional,default=12"`
+}
+
+// 获取最新照片响应
+type GetRecentPhotosResponse {
+    BaseResponse
+    Data []PublicPhoto `json:"data"`
+}
+
+// 获取分类列表响应
+type GetPublicCategoryListResponse {
+    BaseResponse
+    Data []PublicCategory `json:"data"`
+}
+
+// 获取分类详情请求
+type GetPublicCategoryRequest {
+    Id int64 `path:"id"`
+}
+
+// 获取分类详情响应
+type GetPublicCategoryResponse {
+    BaseResponse
+    Data PublicCategoryWithPhotos `json:"data"`
+}
+
+// 获取分类下的照片请求
+type GetCategoryPhotosRequest {
+    Id int64 `path:"id"`
+    PageRequest
+    Sort string `form:"sort,optional,default=created_at_desc"`
+}
+
+// 获取分类下的照片响应
+type GetCategoryPhotosResponse {
+    BaseResponse
+    Data PublicPhotoListData `json:"data"`
+}
+
+// 前端公共接口组 - 无需认证
+@server(
+    group: public
+    prefix: /api/v1/public
+)
+service photography-api {
+    @doc "获取照片列表"
+    @handler getPublicPhotoList
+    get /photos (GetPublicPhotoListRequest) returns (GetPublicPhotoListResponse)
+    
+    @doc "获取照片详情"
+    @handler getPublicPhoto
+    get /photos/:id (GetPublicPhotoRequest) returns (GetPublicPhotoResponse)
+    
+    @doc "获取精选照片"
+    @handler getFeaturedPhotos
+    get /photos/featured returns (GetFeaturedPhotosResponse)
+    
+    @doc "获取最新照片"
+    @handler getRecentPhotos
+    get /photos/recent (GetRecentPhotosRequest) returns (GetRecentPhotosResponse)
+    
+    @doc "获取分类列表"
+    @handler getPublicCategoryList
+    get /categories returns (GetPublicCategoryListResponse)
+    
+    @doc "获取分类详情"
+    @handler getPublicCategory
+    get /categories/:id (GetPublicCategoryRequest) returns (GetPublicCategoryResponse)
+    
+    @doc "获取分类下的照片"
+    @handler getCategoryPhotos
+    get /categories/:id/photos (GetCategoryPhotosRequest) returns (GetCategoryPhotosResponse)
+}