# Public Editor Backend

公网编辑器后端服务 - 基于 Next.js API + Supabase

## 技术栈

- **Framework:** Next.js 14 (App Router)
- **Language:** TypeScript
- **Database:** Supabase (PostgreSQL)
- **Storage:** Supabase Storage
- **Auth:** Supabase Auth

## 快速开始

### 1. 配置 Supabase

1. 在 [Supabase](https://supabase.com) 创建新项目
2. 获取项目 URL 和 API Keys
3. 复制 `.env.local.example` 到 `.env.local` 并填入配置

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

### 2. 初始化数据库

在 Supabase SQL Editor 中运行 `supabase/init.sql` 脚本：

```sql
-- 复制 supabase/init.sql 的全部内容并执行
```

这将创建：
- `files` 数据表
- Row Level Security 策略
- Storage Bucket 和访问策略

### 3. 安装依赖

```bash
npm install
```

### 4. 启动开发服务器

```bash
npm run dev
```

访问 http://localhost:3000

## API 端点

### 认证

- `POST /api/auth/login` - 用户登录
- `POST /api/auth/logout` - 用户登出
- `GET /api/auth/me` - 获取当前用户信息

### 文件存储

- `GET /api/files` - 获取文件列表
- `POST /api/files/upload` - 上传文件
- `GET /api/files/[id]` - 获取单个文件信息
- `DELETE /api/files/[id]` - 删除文件

### 数据库操作

- `GET /api/database/tables` - 获取所有表
- `POST /api/database/query` - 执行数据库操作

## API 使用示例

### 登录

```bash
curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"password123"}'
```

### 上传文件

```bash
curl -X POST http://localhost:3000/api/files/upload \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/file.pdf"
```

### 获取文件列表

```bash
curl http://localhost:3000/api/files \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### 数据库查询

```bash
curl -X POST http://localhost:3000/api/database/query \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "table": "files",
    "operation": "select",
    "filters": {}
  }'
```

## 环境变量

| 变量名 | 说明 |
|--------|------|
| `NEXT_PUBLIC_SUPABASE_URL` | Supabase 项目 URL |
| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase 匿名 Key |
| `SUPABASE_SERVICE_ROLE_KEY` | Supabase 服务角色 Key |
| `NEXT_PUBLIC_APP_URL` | 应用 URL |

## 安全

- 所有 API 端点都需要认证（除了登录）
- 使用 Supabase Row Level Security 确保用户只能访问自己的数据
- Storage 策略确保用户只能操作自己文件夹中的文件
- 使用 HTTP-only cookies 存储 session

## 部署

### Vercel

1. 连接 GitHub 仓库
2. 添加环境变量
3. 部署

### Docker

```bash
docker build -t public-editor .
docker run -p 3000:3000 --env-file .env.local public-editor
```

## 开发

```bash
# 开发模式
npm run dev

# 构建
npm run build

# 生产模式
npm start

# 代码检查
npm run lint
```

## License

MIT