# API定义模块

## 📋 文件结构
```
api/desc/
├── photography.api      # 主API文件(聚合)
├── auth.api            # 认证接口
├── photo.api           # 照片接口
├── category.api        # 分类接口
├── user.api            # 用户接口
└── frontend/           # 前端专用接口
    ├── auth.api        # 前端认证
    └── public.api      # 公开接口
```

## 🚀 开发流程
1. **新增接口**: 编辑对应.api文件
2. **生成代码**: `make generate-api`
3. **实现逻辑**: 在internal/logic/对应目录

## 🎯 文件作用
| 文件 | 用途 | 对应功能 |
|---|---|---|
| `auth.api` | 登录/注册 | JWT认证 |
| `photo.api` | 照片CRUD | 上传/管理 |
| `category.api` | 分类管理 | 相册分类 |
| `frontend/auth.api` | 前端登录 | 用户认证 |
| `frontend/public.api` | 公开接口 | 无需认证 |

## ⚙️ 生成命令
```bash
# 生成所有API代码
goctl api go -api api/desc/photography.api -dir ./

# 生成单个模块
goctl api go -api api/desc/photo.api -dir ./internal/handler/photo
```