接入数据库

pages/mall/analytics/test/README.md

@@ -39,22 +39,14 @@
 
 ### 方式 1: 通过 Supabase Dashboard（推荐）
 
-1. **访问 Dashboard**
-   ```
-   http://192.168.1.63:8000
-   或
-   http://192.168.1.63:3000  (Studio 默认端口)
-   ```
+1. **打开 Supabase Studio / Dashboard**
+   - 请使用你自己的部署地址访问（不要在仓库文档里硬编码地址/账号/密码）。
 
-2. **登录**
-   - 用户名：`supabase`
-   - 密码：`D4ce5p8YBpfYzEoDGZ_7MzehZcWrdCNyDEj_VSUBmOw`
-
-3. **打开 SQL Editor**
+2. **打开 SQL Editor**
    - 在左侧菜单找到 "SQL Editor"
    - 点击 "New Query"
 
-4. **执行脚本**
+3. **执行脚本**
    - 复制 `01_create_tables.sql` 的内容，粘贴并执行
    - 复制 `02_insert_test_data.sql` 的内容，粘贴并执行
    - （可选）复制 `03_test_queries.sql` 的内容，验证数据
@@ -62,10 +54,8 @@
 ### 方式 2: 使用命令行（PostgreSQL）
 
 ```bash
-# 连接到内网 Supabase 数据库
-psql -h 192.168.1.63 -p 5432 -U postgres -d postgres
-
-# 输入密码：yxyHINygZMLSq9jLddrZQBB-CoyGHSF5DwlwWmbrYXc
+# 连接到 Supabase Postgres（参数请按你的环境填写）
+psql -h <DB_HOST> -p <DB_PORT> -U postgres -d postgres
 
 # 执行 SQL 文件（需要完整路径）
 \i D:/datas/hfkj/mall/pages/mall/analytics/test/01_create_tables.sql
@@ -76,17 +66,20 @@ psql -h 192.168.1.63 -p 5432 -U postgres -d postgres
 ### 方式 3: 使用图形工具（DBeaver / pgAdmin）
 
 1. **创建连接**
-   - 主机：`192.168.1.63`
-   - 端口：`5432`
+   - 主机：`<DB_HOST>`
+   - 端口：`<DB_PORT>`
    - 数据库：`postgres`
-   - 用户名：`postgres`
-   - 密码：`yxyHINygZMLSq9jLddrZQBB-CoyGHSF5DwlwWmbrYXc`
+   - 用户名：`postgres`（或你的管理员账号）
+   - 密码：`<DB_PASSWORD>`
 
 2. **执行 SQL**
    - 打开 SQL 编辑器
    - 复制 SQL 文件内容并执行
 
-**详细说明请查看：`SQL_USAGE_GUIDE.md`**
+**详细说明请查看：**
+- **`ANALYTICS_DATA_QUICK_START.md`** - ⭐ **SQL 文件执行顺序指南（必读！）**
+- `SQL_USAGE_GUIDE.md` - SQL 脚本执行详细指南
+- `TEST_DATA_INSERT_GUIDE.md` - 测试数据插入指南（包含 RLS 处理说明）
 
 ## 测试数据说明
 
@@ -111,6 +104,20 @@ psql -h 192.168.1.63 -p 5432 -U postgres -d postgres
 - **今日下单用户数：** 约 8个（从 orders 表去重统计）
 - **预期转化率：** 约 53-80%（根据实际数据计算）
 
+## ⚠️ 重要：RLS（行级安全策略）说明
+
+**所有表已启用 RLS**，插入测试数据时需要注意：
+
+1. **推荐方式**：使用 Supabase Dashboard 的 SQL Editor 执行脚本
+   - Dashboard 默认使用 `service_role` 权限，可以绕过 RLS
+   - 无需额外配置，直接执行即可
+
+2. **命令行方式**：如果使用命令行或脚本执行
+   - 需要临时禁用 RLS（见 `02_insert_test_data.sql` 中的注释说明）
+   - 或使用 `SECURITY DEFINER` 函数（见 `TEST_DATA_INSERT_GUIDE.md`）
+
+3. **详细说明**：请查看 `TEST_DATA_INSERT_GUIDE.md` 获取完整的插入指南
+
 ## 注意事项
 
 1. **时间依赖**
@@ -131,24 +138,14 @@ psql -h 192.168.1.63 -p 5432 -U postgres -d postgres
    - 所有 ID 使用 UUID 格式
    - 测试数据使用了固定的 UUID 便于识别
 
+5. **RLS 权限**
+   - 插入数据后，前端查询需要用户已登录
+   - 测试数据的 `user_id` 需要与登录用户的 `auth.uid()` 匹配才能查询到
+   - 或者使用公开数据（如 `products`、`merchants` 表）
+
 ## 清理测试数据
 
-如果需要清理测试数据，可以执行：
-
-```sql
--- 谨慎操作：清空测试数据
-TRUNCATE TABLE orders, user_sessions, users, order_items, page_views CASCADE;
-```
-
-或者删除特定时间范围的数据：
-
-```sql
--- 删除今日的测试订单
-DELETE FROM orders WHERE created_at >= DATE_TRUNC('day', NOW());
-
--- 删除测试用户会话
-DELETE FROM user_sessions WHERE created_at >= DATE_TRUNC('day', NOW());
-```
+如需清理测试数据，请使用独立的清理脚本（例如 `04_cleanup.sql`）。
 
 ## 验证实时大屏功能