登录注册/数据分析

2026-01-22 21:15:02 +08:00
parent 75fad97d5d
commit fdbee0fa32
41 changed files with 5812 additions and 2102 deletions
--- a/pages/mall/analytics/test/SQL_USAGE_GUIDE.md
+++ b/pages/mall/analytics/test/SQL_USAGE_GUIDE.md
@@ -0,0 +1,304 @@
+# SQL 测试脚本使用指南
+
+本指南说明如何在内网 Supabase 环境中执行测试 SQL 脚本。
+
+## 📋 目录结构
+
+```
+pages/mall/analytics/test/
+├── 01_create_tables.sql      # 创建表结构
+├── 02_insert_test_data.sql   # 插入测试数据
+├── 03_test_queries.sql       # 测试查询
+├── 04_cleanup.sql            # 清理数据
+└── SQL_USAGE_GUIDE.md        # 本指南
+```
+
+## 🚀 执行方式
+
+### 方式 1: 通过 Supabase Dashboard（推荐）
+
+如果您的内网 Supabase 有 Dashboard 界面：
+
+1. **访问 Dashboard**
+   ```
+   http://192.168.1.63:8000
+   或
+   http://192.168.1.63:3000  (Studio 默认端口)
+   ```
+
+2. **登录**
+   - 用户名：`supabase`（根据您的配置）
+   - 密码：`D4ce5p8YBpfYzEoDGZ_7MzehZcWrdCNyDEj_VSUBmOw`
+
+3. **打开 SQL Editor**
+   - 在左侧菜单找到 "SQL Editor" 或 "SQL"
+   - 点击 "New Query"
+
+4. **执行脚本**
+   - 复制 `01_create_tables.sql` 的内容
+   - 粘贴到 SQL Editor
+   - 点击 "Run" 或按 `Ctrl+Enter`
+   - 等待执行完成
+
+5. **依次执行其他脚本**
+   - 执行 `02_insert_test_data.sql`（插入测试数据）
+   - 执行 `03_test_queries.sql`（验证数据，可选）
+
+### 方式 2: 通过 PostgreSQL 客户端（psql）
+
+如果 Dashboard 不可用，可以直接连接 PostgreSQL：
+
+1. **连接数据库**
+   ```bash
+   # 使用 psql 连接
+   psql -h 192.168.1.63 -p 5432 -U postgres -d postgres
+   
+   # 输入密码（根据您的配置）
+   # POSTGRES_PASSWORD=yxyHINygZMLSq9jLddrZQBB-CoyGHSF5DwlwWmbrYXc
+   ```
+
+2. **执行 SQL 文件**
+   ```sql
+   -- 在 psql 中执行
+   \i /path/to/01_create_tables.sql
+   \i /path/to/02_insert_test_data.sql
+   \i /path/to/03_test_queries.sql
+   ```
+
+   或者直接复制粘贴 SQL 内容到 psql 中执行。
+
+### 方式 3: 通过 DBeaver / pgAdmin 等图形工具
+
+1. **创建新连接**
+   - 主机：`192.168.1.63`
+   - 端口：`5432`
+   - 数据库：`postgres`
+   - 用户名：`postgres`
+   - 密码：`yxyHINygZMLSq9jLddrZQBB-CoyGHSF5DwlwWmbrYXc`
+
+2. **执行 SQL**
+   - 打开 SQL 编辑器
+   - 复制 SQL 文件内容
+   - 执行脚本
+
+### 方式 4: 通过 HTTP API（程序化执行）
+
+使用 Supabase REST API 执行 SQL（需要 service_role key）：
+
+```javascript
+// 注意：这种方式需要 Supabase 的 SQL 执行功能
+// 通常不推荐，因为安全风险较高
+const response = await fetch('http://192.168.1.63:8000/rest/v1/rpc/exec_sql', {
+  method: 'POST',
+  headers: {
+    'apikey': 'YOUR_SERVICE_ROLE_KEY',
+    'Authorization': 'Bearer YOUR_SERVICE_ROLE_KEY',
+    'Content-Type': 'application/json'
+  },
+  body: JSON.stringify({
+    sql: 'SELECT * FROM users LIMIT 1;'
+  })
+})
+```
+
+## 📝 执行顺序
+
+**重要：必须按顺序执行！**
+
+1. ✅ **第一步：创建表结构**
+   ```sql
+   -- 执行 01_create_tables.sql
+   -- 这会创建所有需要的表和索引
+   ```
+
+2. ✅ **第二步：插入测试数据**
+   ```sql
+   -- 执行 02_insert_test_data.sql
+   -- 这会插入测试用户、订单、会话等数据
+   ```
+
+3. ✅ **第三步：验证数据（可选）**
+   ```sql
+   -- 执行 03_test_queries.sql
+   -- 验证数据是否正确插入，查看统计信息
+   ```
+
+4. ⚠️ **清理数据（需要时）**
+   ```sql
+   -- 执行 04_cleanup.sql
+   -- 谨慎使用：会删除测试数据
+   ```
+
+## 🔍 验证执行结果
+
+### 检查表是否创建成功
+
+```sql
+-- 查看所有表
+SELECT table_name 
+FROM information_schema.tables 
+WHERE table_schema = 'public'
+ORDER BY table_name;
+
+-- 应该看到：
+-- orders
+-- user_sessions
+-- users
+-- products (可选)
+-- order_items (可选)
+-- page_views (可选)
+```
+
+### 检查数据是否插入成功
+
+```sql
+-- 检查用户数量
+SELECT COUNT(*) FROM users;
+-- 应该返回 8
+
+-- 检查订单数量
+SELECT COUNT(*) FROM orders WHERE created_at >= DATE_TRUNC('day', NOW());
+-- 应该返回 15（今日订单）
+
+-- 检查在线用户
+SELECT COUNT(*) FROM user_sessions 
+WHERE last_active_at >= NOW() - INTERVAL '5 minutes' AND is_active = true;
+-- 应该返回 5
+```
+
+### 检查实时大屏数据
+
+```sql
+-- 执行 03_test_queries.sql 中的综合查询
+-- 应该能看到：
+-- - 实时GMV: 约 3,500 元
+-- - 实时订单: 15 笔
+-- - 在线用户: 5 人
+-- - 转化率: 约 50-80%
+```
+
+## ⚠️ 注意事项
+
+### 1. 权限问题
+
+如果遇到权限错误：
+```sql
+-- 确保 postgres 用户有足够权限
+GRANT ALL PRIVILEGES ON DATABASE postgres TO postgres;
+GRANT ALL PRIVILEGES ON SCHEMA public TO postgres;
+```
+
+### 2. 表已存在
+
+如果表已存在，脚本会使用 `CREATE TABLE IF NOT EXISTS`，不会报错。
+但如果需要重新创建：
+```sql
+-- 先删除表（谨慎操作）
+DROP TABLE IF EXISTS order_items CASCADE;
+DROP TABLE IF EXISTS page_views CASCADE;
+DROP TABLE IF EXISTS user_sessions CASCADE;
+DROP TABLE IF EXISTS orders CASCADE;
+DROP TABLE IF EXISTS users CASCADE;
+DROP TABLE IF EXISTS products CASCADE;
+```
+
+### 3. 时间依赖
+
+测试数据使用 `NOW()` 函数，每次执行都会基于当前时间生成。
+- 今日订单：基于当前日期
+- 昨日订单：当前时间往前推 24 小时
+- 在线用户：最近 5 分钟内有活动
+
+### 4. UUID 冲突
+
+如果重复执行插入脚本，由于使用了 `ON CONFLICT DO NOTHING`，不会产生重复数据。
+但如果需要重新插入，先执行清理脚本。
+
+## 🐛 常见问题
+
+### Q1: 连接被拒绝
+```
+Error: connection refused
+```
+**解决：**
+- 检查 Supabase 服务是否运行
+- 检查防火墙设置
+- 确认端口 5432 是否开放
+
+### Q2: 认证失败
+```
+Error: password authentication failed
+```
+**解决：**
+- 确认密码是否正确：`yxyHINygZMLSq9jLddrZQBB-CoyGHSF5DwlwWmbrYXc`
+- 检查用户名是否为 `postgres`
+
+### Q3: 表已存在错误
+```
+Error: relation "orders" already exists
+```
+**解决：**
+- 脚本已使用 `IF NOT EXISTS`，通常不会报错
+- 如需重新创建，先删除表
+
+### Q4: 权限不足
+```
+Error: permission denied
+```
+**解决：**
+- 使用 postgres 超级用户执行
+- 或授予相应权限
+
+## 📊 执行后的预期结果
+
+执行完所有脚本后，您应该能看到：
+
+1. **数据库表**
+   - 6 个表已创建（orders, user_sessions, users, products, order_items, page_views）
+   - 所有索引已创建
+
+2. **测试数据**
+   - 8 个测试用户
+   - 15 个今日订单
+   - 10 个昨日订单
+   - 5 个在线用户会话
+   - 15 条访问日志
+
+3. **实时大屏显示**
+   - 在数据分析页面应该能看到实时数据
+   - GMV、订单数、在线用户、转化率都有值
+
+## 🔄 重新执行
+
+如果需要重新生成测试数据：
+
+1. **清理数据**
+   ```sql
+   -- 执行 04_cleanup.sql
+   ```
+
+2. **重新插入**
+   ```sql
+   -- 执行 02_insert_test_data.sql
+   ```
+
+## 📞 获取帮助
+
+如果遇到问题：
+
+1. 检查 Supabase 日志
+2. 查看数据库连接状态
+3. 验证配置文件 `ak/config.uts` 是否正确
+4. 使用测试页面验证连接：`/pages/mall/analytics/test/test-connection`
+
+## 🎯 快速开始
+
+**最简单的执行方式：**
+
+1. 打开 Supabase Dashboard（如果有）
+2. 进入 SQL Editor
+3. 复制 `01_create_tables.sql` 内容，执行
+4. 复制 `02_insert_test_data.sql` 内容，执行
+5. 完成！
+
+现在可以开始测试实时大屏功能了！🎉