# 消息系统脚本索引

本文档列出了所有可用的SQL脚本及其用途，帮助开发者快速找到需要的功能。

## 📋 脚本分类

### 🏗️ 核心部署脚本

| 脚本名称 | 用途 | 适用场景 | 执行顺序 |
|----------|------|----------|----------|
| `deploy_one_click.sql` | 一键部署整个消息系统 | 新项目快速启动 | 1️⃣ |
| `message_system.sql` | 核心数据库表结构 | 手动分步部署 | 1️⃣ |
| `supabase_auth_complete_setup.sql` | 完整用户角色管理系统 | 生产环境 | 2️⃣ |

### 🔐 权限管理脚本

| 脚本名称 | 用途 | 权限模式 | 环境 |
|----------|------|----------|------|
| `dev_open_permissions.sql` | 快速开发权限设置 | 🔓 开放 | 开发/测试 |
| `open_all_message_permissions.sql` | 完整开放权限设置 | 🔓 开放 | 开发/测试 |
| `message_permissions_complete.sql` | 完整生产权限策略 | 🔒 严格 | 生产环境 |
| `restore_normal_permissions.sql` | 从开发模式恢复生产权限 | 🔒 严格 | 生产环境 |
| `permission_manager.sql` | 权限管理器和状态监控 | 🛠️ 管理 | 所有环境 |

### 🔧 修复和维护脚本

| 脚本名称 | 用途 | 使用时机 |
|----------|------|----------|
| `complete_cleanup.sql` | 完整系统清理 | 重新部署前 |
| `quick_fix_triggers.sql` | 修复触发器冲突 | 部署错误时 |
| `quick_fix_policies.sql` | 修复策略冲突 | 部署错误时 |
| `quick_fix_functions.sql` | 修复函数冲突 | 部署错误时 |
| `quick_fix_rls_recursion.sql` | 修复RLS递归错误 | 权限错误时 |

### 📊 数据和测试脚本

| 脚本名称 | 用途 | 数据量 |
|----------|------|--------|
| `insert_test_message_data.sql` | 插入测试数据 | 中等 |
| `generate_message_data.sql` | 生成大量测试数据 | 大量 |
| `test_message_structure.sql` | 测试消息结构 | 验证 |

## 🚀 使用指南

### 新项目部署

```mermaid
graph TD
    A[新项目] --> B[deploy_one_click.sql]
    B --> C[开发模式启用]
    C --> D[开始开发]
    D --> E{准备上线?}
    E -->|是| F[restore_normal_permissions.sql]
    E -->|否| G[继续开发]
    F --> H[生产环境]
```

### 权限模式切换

```mermaid
graph LR
    A[开发模式] -->|deploy_one_click.sql| B[开放权限]
    A -->|dev_open_permissions.sql| B
    B -->|restore_normal_permissions.sql| C[生产权限]
    C -->|permission_manager.sql| D[智能管理]
    D -->|switch_to_dev_mode| B
    D -->|switch_to_prod_mode| C
```

## 📝 常用命令组合

### 快速开始（推荐）

```sql
-- 1. 一键部署
\i deploy_one_click.sql

-- 2. 查看状态
SELECT * FROM public.permission_dashboard;

-- 3. 测试功能
SELECT quick_send('测试消息', '这是一条测试消息');
SELECT * FROM message_stats();
```

### 开发环境设置

```sql
-- 1. 基础结构
\i message_system.sql

-- 2. 开发权限
\i dev_open_permissions.sql

-- 3. 测试数据
\i insert_test_message_data.sql

-- 4. 权限管理器
\i permission_manager.sql
```

### 生产环境部署

```sql
-- 1. 基础结构
\i message_system.sql

-- 2. 用户角色系统
\i supabase_auth_complete_setup.sql

-- 3. 严格权限策略
\i message_permissions_complete.sql

-- 4. 权限管理器
\i permission_manager.sql

-- 5. 验证部署
SELECT * FROM public.check_permission_health();
```

### 权限模式切换

```sql
-- 切换到开发模式
SELECT public.switch_to_dev_mode();

-- 切换到生产模式
SELECT public.switch_to_prod_mode();
\i restore_normal_permissions.sql

-- 查看当前模式
SELECT * FROM public.get_permission_mode();
```

### 故障排除

```sql
-- 清理所有内容重新开始
\i complete_cleanup.sql
\i deploy_one_click.sql

-- 修复特定错误
\i quick_fix_triggers.sql    -- 触发器冲突
\i quick_fix_policies.sql    -- 策略冲突
\i quick_fix_functions.sql   -- 函数冲突
\i quick_fix_rls_recursion.sql -- RLS递归

-- 权限健康检查
SELECT * FROM public.check_permission_health();
```

## 🔍 脚本内容速览

### 核心功能脚本

- **deploy_one_click.sql**: 完整的一键部署解决方案
  - 扩展检查和创建
  - 基础表结构创建
  - 开发权限模式部署
  - 便捷函数创建
  - 部署验证和报告

- **permission_manager.sql**: 智能权限管理系统
  - `get_permission_mode()` - 查看当前权限模式
  - `switch_to_dev_mode()` - 切换到开发模式
  - `switch_to_prod_mode()` - 切换到生产模式
  - `check_permission_health()` - 权限健康检查

### 权限模式脚本

- **dev_open_permissions.sql**: 开发友好的权限设置
  - 自动清理限制性策略
  - 创建全开放权限
  - 提供便捷开发函数

- **restore_normal_permissions.sql**: 生产环境权限恢复
  - 清理开发模式策略
  - 恢复基于角色的权限控制
  - 最小权限原则

## ⚠️ 重要提醒

### 开发模式注意事项

- 🔓 **开发模式权限非常宽松**，所有authenticated用户可以操作所有数据
- ⚠️ **严禁在生产环境使用开发模式**
- 📝 开发完成后记得切换到生产权限模式

### 生产环境最佳实践

- 🔒 始终使用基于角色的权限控制
- 🛡️ 定期运行权限健康检查
- 📊 监控权限使用情况
- 🔄 建立权限变更审核流程

### 脚本执行顺序

1. **首次部署**: `deploy_one_click.sql`
2. **权限管理**: `permission_manager.sql`
3. **模式切换**: 使用管理函数或专用脚本
4. **故障修复**: 按需使用quick_fix_*脚本

## 📞 获取帮助

如果遇到问题，请：

1. 先运行 `SELECT * FROM public.check_permission_health();` 检查系统状态
2. 查看相关脚本的注释和说明
3. 使用 `complete_cleanup.sql` 清理后重新部署
4. 检查Supabase控制台的错误日志

---

**提示**: 建议将本文档保存为书签，方便随时查阅各个脚本的用途和使用方法。