# CRUD 接口规范

## ADDED Requirements

### API-001: 分页查询
系统应当提供 `GET /api/{{entity}}` 接口，支持分页查询。

**验收标准:**
- **Given** 数据库中存在 {{entity}} 记录
- **When** 用户请求 `GET /api/{{entity}}?page=1&size=10`
- **Then** 返回分页数据，包含 total、list、page、size

### API-002: 详情查询
系统应当提供 `GET /api/{{entity}}/:id` 接口。

**验收标准:**
- **Given** 存在 ID 为 1 的记录
- **When** 用户请求 `GET /api/{{entity}}/1`
- **Then** 返回该记录详情

### API-003: 新增
系统应当提供 `POST /api/{{entity}}` 接口。

**验收标准:**
- **Given** 用户提供必填字段
- **When** 用户请求 `POST /api/{{entity}}`
- **Then** 创建记录并返回新 ID

### API-004: 修改
系统应当提供 `PUT /api/{{entity}}/:id` 接口。

### API-005: 删除
系统应当提供 `DELETE /api/{{entity}}/:id` 接口（逻辑删除）。