Initial commit of akmon project

DUPLICATE_OBJECTS_FIX.md

@@ -0,0 +1,127 @@
+# 数据库重复对象修复说明
+
+## 问题描述
+
+在重新运行 `video_system_database.sql` 时，遇到了 `relation "idx_comments_parent" already exists` 错误。这是因为数据库中已经存在了某些表、索引或其他对象，重复创建会导致错误。
+
+## 修复方案
+
+### 1. 添加 `IF NOT EXISTS` 子句
+
+为所有可能重复的数据库对象添加了 `IF NOT EXISTS` 子句，使脚本可以安全地重复运行：
+
+#### 表创建
+```sql
+CREATE TABLE IF NOT EXISTS ak_video_danmakus (...)
+CREATE TABLE IF NOT EXISTS ak_user_interactions (...)
+CREATE TABLE IF NOT EXISTS ak_content_comments (...)
+-- ... 所有其他表
+```
+
+#### 索引创建
+```sql
+CREATE INDEX IF NOT EXISTS idx_comments_parent ON ak_content_comments(parent_id);
+CREATE INDEX IF NOT EXISTS idx_danmakus_content_time ON ak_video_danmakus(content_id, time_point);
+-- ... 所有其他索引
+```
+
+#### 列添加
+```sql
+ALTER TABLE ak_contents 
+ADD COLUMN IF NOT EXISTS content_type VARCHAR(20) DEFAULT 'article',
+ADD COLUMN IF NOT EXISTS video_url TEXT,
+-- ... 所有其他列
+```
+
+### 2. 修复字段引用错误
+
+#### 弹幕表字段名修正
+- 修正了 RPC 函数中的字段名：`content` → `text`
+- 添加了 `user_name` 字段的自动填充
+
+#### 时长字段引用修正
+- 修正了播放记录函数中的时长字段引用
+- 根据内容类型动态选择 `video_duration` 或 `audio_duration`
+
+### 3. 增强的 RPC 函数
+
+```sql
+-- 弹幕插入函数 - 现在包含用户名自动填充
+CREATE OR REPLACE FUNCTION insert_danmu_with_validation(...)
+
+-- 播放记录函数 - 现在正确处理不同媒体类型的时长
+CREATE OR REPLACE FUNCTION record_play_progress_with_validation(...)
+```
+
+## 现在的优势
+
+### ✅ 幂等性（Idempotent）
+- 脚本可以安全地多次运行
+- 不会因为对象已存在而失败
+- 支持增量更新和重新部署
+
+### ✅ 错误处理
+- 自动处理重复对象创建
+- 提供清晰的错误信息
+- 支持部分失败恢复
+
+### ✅ 向后兼容
+- 保持所有现有功能
+- 不破坏已有数据
+- 支持渐进式迁移
+
+## 使用建议
+
+### 部署流程
+1. **第一次部署**：创建所有新对象
+2. **更新部署**：只创建不存在的对象，跳过已存在的
+3. **修复部署**：可以安全地重新运行整个脚本
+
+### 开发流程
+```bash
+# 可以安全地重复运行
+psql -f video_system_database.sql
+
+# 或者在 Supabase 中直接粘贴执行
+# 不需要担心重复执行问题
+```
+
+### 监控建议
+- 关注 RPC 函数的执行日志
+- 监控数据一致性
+- 验证索引性能
+
+## 测试验证
+
+### 基础功能测试
+```sql
+-- 测试弹幕插入
+SELECT insert_danmu_with_validation(
+    'content-uuid-here'::UUID,
+    '测试弹幕',
+    10.5
+);
+
+-- 测试播放记录
+SELECT record_play_progress_with_validation(
+    'content-uuid-here'::UUID,
+    30.0,
+    5.0
+);
+```
+
+### 重复执行测试
+```sql
+-- 这些命令应该不会报错，即使多次执行
+CREATE INDEX IF NOT EXISTS idx_test ON ak_video_danmakus(id);
+CREATE TABLE IF NOT EXISTS ak_test_table (id UUID);
+```
+
+## 未来扩展
+
+脚本现在具备了良好的可维护性基础：
+- 新增表或索引时记得使用 `IF NOT EXISTS`
+- 新增列时使用 `ADD COLUMN IF NOT EXISTS`
+- RPC 函数使用 `CREATE OR REPLACE FUNCTION`
+
+这确保了系统的稳定性和可扩展性。