# Robin API

一个基于 Fastify 和 TypeORM 的个人记账 API。

## 功能特性

- 用户认证（注册/登录）
- JWT 认证
- 钱包管理
- 收支记录管理
- Swagger API 文档

## 技术栈

- Fastify
- TypeORM
- MySQL
- TypeScript
- JWT

## 开始使用

### 环境要求

- Node.js >= 16
- MySQL >= 8.0
- Yarn

### 安装

1. 克隆项目

```bash
git clone https://github.com/yourusername/robin-api.git
cd robin-api
```

2. 安装依赖

```bash
yarn install
```

3. 配置环境变量

复制 `.env.example` 文件为 `.env`，并根据你的环境修改配置：

```bash
cp .env.example .env
```

4. 创建数据库

```sql
CREATE DATABASE robin_db;
```

5. 运行开发服务器

```bash
yarn dev
```

### API 文档

启动服务器后，访问 `http://localhost:3000/documentation` 查看 Swagger API 文档。

## API 端点

### 用户

- POST /api/users/register - 用户注册
- POST /api/users/login - 用户登录

### 钱包

- POST /api/wallets - 创建钱包
- GET /api/wallets - 获取所有钱包
- GET /api/wallets/:id - 获取单个钱包
- PUT /api/wallets/:id - 更新钱包
- DELETE /api/wallets/:id - 删除钱包

### 记录

- POST /api/records - 创建记录
- GET /api/records - 获取所有记录
- GET /api/records/:id - 获取单个记录
- PUT /api/records/:id - 更新记录
- DELETE /api/records/:id - 删除记录

## 许可证

MIT