---
sync_policy: engine_only
---
# {{ModuleName}} 模块

> 自动生成于 {{date}}

## 概述

{{ModuleName}} 模块提供 {{moduleNameLower}} 的增删改查功能。

## 文件结构

```
src/pages/{{ModuleName}}/
├── Page.tsx          # 主页面组件
├── Form.tsx          # 表单组件
├── List.tsx          # 列表组件
├── service.ts        # API 调用层
├── types.ts          # 类型定义
└── use{{ModuleName}}.ts  # 数据 Hook
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | {{basePath}} | 查询列表（分页） |
| GET | {{basePath}}/:id | 查询详情 |
| POST | {{basePath}} | 创建 |
| PUT | {{basePath}}/:id | 更新 |
| DELETE | {{basePath}}/:id | 删除 |

## 使用示例

```tsx
import { {{ModuleName}}Page } from './pages/{{ModuleName}}/Page';

// 在路由中注册
<Route path="/{{module_name}}" element={<{{ModuleName}}Page />} />
```

## 注意事项

- 列表使用服务端分页，默认每页 20 条
- 表单提交前会进行前端校验
- 删除操作有二次确认弹窗