feat: 初始化公网编辑器后端项目

- 配置 Next.js 14 + TypeScript + TailwindCSS - 集成 Supabase (Auth + Storage + Database) - 实现认证 API (login/logout/me) - 实现文件存储 API (upload/list/get/delete) - 实现数据库操作 API (tables/query) - 添加 Supabase 初始化 SQL 脚本 - 添加环境变量配置示例 - 添加项目文档
2026-03-17 01:03:03 +08:00
commit 23b117a3fa
32 changed files with 8446 additions and 0 deletions
@@ -0,0 +1,159 @@
+# 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