feat: 角色卡 demo

wei_ai_app/supabase/README.md

@@ -0,0 +1,120 @@
+# Supabase 数据库初始化指南
+
+本文档说明如何将 SQL 脚本导入到本地 Docker 部署的 Supabase 中。
+
+## 准备工作
+
+确保你的 Supabase Docker 容器正在运行：
+
+```bash
+docker ps --filter "name=supabase"
+```
+
+## 方法一：通过 Supabase Studio (推荐)
+
+1. **打开 Supabase Studio**
+   
+   在浏览器中访问：http://localhost:54323
+   
+   > 注意：如果是通过 Kong 代理，可能是 http://localhost:8000
+
+2. **进入 SQL 编辑器**
+   
+   点击左侧菜单的 **SQL Editor**
+
+3. **执行建表脚本**
+   
+   - 新建一个 Query
+   - 复制 `migrations/001_create_tables.sql` 的内容
+   - 点击 **Run** 执行
+
+4. **执行种子数据脚本**
+   
+   - 新建另一个 Query
+   - 复制 `migrations/002_seed_data.sql` 的内容
+   - 点击 **Run** 执行
+
+5. **创建 Storage Bucket**
+   
+   - 点击左侧菜单的 **Storage**
+   - 点击 **New bucket**
+   - 输入名称：`avatars`
+   - 勾选 **Public bucket**
+   - 点击 **Create bucket**
+
+## 方法二：通过命令行 (psql)
+
+1. **连接到数据库**
+
+```bash
+# 获取数据库连接信息
+docker exec supabase-db env | grep POSTGRES
+
+# 连接数据库 (默认密码在 .env 文件中)
+docker exec -it supabase-db psql -U postgres -d postgres
+```
+
+2. **执行 SQL 脚本**
+
+```bash
+# 从容器外部执行
+cat supabase/migrations/001_create_tables.sql | docker exec -i supabase-db psql -U postgres -d postgres
+cat supabase/migrations/002_seed_data.sql | docker exec -i supabase-db psql -U postgres -d postgres
+```
+
+## 方法三：通过 Supabase API
+
+```bash
+# 设置环境变量
+SUPABASE_URL="http://localhost:8000"
+SERVICE_KEY="你的 service_role key"
+
+# 创建 Storage bucket
+curl -X POST "$SUPABASE_URL/storage/v1/bucket" \
+  -H "Authorization: Bearer $SERVICE_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id": "avatars",
+    "name": "avatars",
+    "public": true,
+    "file_size_limit": 5242880,
+    "allowed_mime_types": ["image/png", "image/jpeg", "image/webp", "image/gif"]
+  }'
+```
+
+## 验证数据
+
+初始化完成后，可以在 Supabase Studio 中验证：
+
+1. **Table Editor** - 查看表结构和数据
+2. **API Docs** - 查看自动生成的 API 文档
+
+### 表结构说明
+
+| 表名 | 说明 |
+|------|------|
+| `categories` | 分类筛选，用于 Discovery 页面 |
+| `tags` | 角色标签 |
+| `characters` | AI 角色信息，包含 AI 配置 |
+| `character_tags` | 角色-标签关联 |
+| `characters_with_tags` | 视图，包含完整的角色信息和标签 |
+
+### 初始数据
+
+- 7 个分类（全部、温柔治愈、主导强势、反差/猎奇、语音陪聊、场景扮演、会员限定）
+- 11 个标签
+- 4 个示例角色（Eva-09, Commander V, Yuki, Secret X）
+
+## 常见问题
+
+### Q: 执行 SQL 时提示权限不足？
+
+确保使用 `postgres` 用户或具有足够权限的用户执行。
+
+### Q: 视图查询返回空数据？
+
+检查 `characters` 表中的 `is_active` 字段是否为 `true`。
+
+### Q: Storage 上传失败？
+
+确保已创建 `avatars` bucket 并设置为公开访问。