09db05c448
- 移动42个文档文件到 docs/ 目录 - 更新 .gitignore 允许 docs/ 下的 .md 文件 - 删除根目录下的重复文档文件 📁 文档分类： - StockDetailPanel 重构文档（3个） - PostHog 集成文档（6个） - 系统架构和API文档（33个） 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
150 lines
3.4 KiB
Markdown
150 lines
3.4 KiB
Markdown
# PostHog 快速测试清单
|
||
|
||
**测试模式：** 控制台 Debug 模式（暂无 Cloud 上报）
|
||
|
||
**应用地址：** http://localhost:3000
|
||
|
||
**控制台：** 按 F12 打开
|
||
|
||
---
|
||
|
||
## ✅ 初始化检查
|
||
|
||
启动应用后，控制台应显示：
|
||
|
||
```
|
||
✅ PostHog initialized successfully
|
||
📊 PostHog Analytics initialized
|
||
⚠️ PostHog API key not found. Analytics will be disabled.
|
||
```
|
||
|
||
✅ **状态：** 正常（仅控制台模式）
|
||
|
||
---
|
||
|
||
## 📋 事件测试清单
|
||
|
||
### 1. 页面浏览事件（5项）
|
||
|
||
| 操作 | 预期事件 | 状态 |
|
||
|------|---------|------|
|
||
| 访问首页 | `$pageview` | [ ] |
|
||
| 访问社区页面 | `community_page_viewed` | [ ] |
|
||
| 访问个股中心 | `stock_overview_page_viewed` | [ ] |
|
||
| 访问概念中心 | `concept_page_viewed` | [ ] |
|
||
| 访问涨停分析 | `limit_analyse_page_viewed` | [ ] |
|
||
|
||
**控制台输出示例：**
|
||
```javascript
|
||
📍 Event tracked: community_page_viewed
|
||
timestamp: "2025-01-15T10:30:00.000Z"
|
||
page_path: "/community"
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 社区页面事件（6项）
|
||
|
||
| 操作 | 预期事件 | 状态 |
|
||
|------|---------|------|
|
||
| 点击搜索框 | `search_initiated` | [ ] |
|
||
| 输入关键词搜索 | `search_query_submitted` | [ ] |
|
||
| 应用筛选器 | `filter_applied` | [ ] |
|
||
| 点击帖子 | `post_clicked` | [ ] |
|
||
| 点击评论 | `comment_clicked` | [ ] |
|
||
| 查看用户资料 | `user_profile_viewed` | [ ] |
|
||
|
||
**控制台输出示例：**
|
||
```javascript
|
||
📍 Event tracked: search_initiated
|
||
context: "community"
|
||
|
||
📍 Event tracked: search_query_submitted
|
||
query: "科技"
|
||
category: "community"
|
||
```
|
||
|
||
---
|
||
|
||
### 3. 个股中心事件（4项）
|
||
|
||
| 操作 | 预期事件 | 状态 |
|
||
|------|---------|------|
|
||
| 搜索股票 | `stock_searched` | [ ] |
|
||
| 点击概念 | `concept_clicked` | [ ] |
|
||
| 点击概念下的股票 | `concept_stock_clicked` | [ ] |
|
||
| 点击热力图股票 | `heatmap_stock_clicked` | [ ] |
|
||
|
||
---
|
||
|
||
### 4. 概念中心事件（5项）
|
||
|
||
| 操作 | 预期事件 | 状态 |
|
||
|------|---------|------|
|
||
| 查看概念列表 | `concept_list_viewed` | [ ] |
|
||
| 切换排序 | `sort_changed` | [ ] |
|
||
| 点击概念 | `concept_clicked` | [ ] |
|
||
| 打开时间线 Modal | `concept_detail_viewed` | [ ] |
|
||
| 点击新闻/报告 | `news_clicked` / `report_clicked` | [ ] |
|
||
|
||
---
|
||
|
||
### 5. 涨停分析事件（6项）
|
||
|
||
| 操作 | 预期事件 | 状态 |
|
||
|------|---------|------|
|
||
| 进入页面 | `limit_analyse_page_viewed` | [ ] |
|
||
| 选择日期 | `date_selected` | [ ] |
|
||
| 查看每日统计 | `daily_stats_viewed` | [ ] |
|
||
| 展开/收起板块 | `sector_toggled` | [ ] |
|
||
| 点击板块 | `sector_clicked` | [ ] |
|
||
| 点击涨停股票 | `limit_stock_clicked` | [ ] |
|
||
|
||
---
|
||
|
||
## 🎯 测试技巧
|
||
|
||
### 控制台过滤
|
||
|
||
如果日志太多，可以过滤：
|
||
1. 在控制台顶部的过滤框输入：`Event tracked`
|
||
2. 只显示事件追踪日志
|
||
|
||
### 查看详细信息
|
||
|
||
每个事件日志都可以展开：
|
||
1. 点击日志左侧的箭头 ▶️
|
||
2. 查看完整的事件属性
|
||
|
||
### 清除日志
|
||
|
||
- 点击控制台左上角的 🚫 图标清除所有日志
|
||
|
||
---
|
||
|
||
## ✅ 测试完成后
|
||
|
||
### 记录结果
|
||
|
||
- 通过的测试项：___/26
|
||
- 失败的测试项：___
|
||
- 发现的问题：___
|
||
|
||
### 下一步
|
||
|
||
1. **等待真实 API Key**
|
||
- 管理员提供 PostHog API Key
|
||
- 配置到 `.env.local`
|
||
- 重启应用
|
||
|
||
2. **测试 Cloud 上报**
|
||
- 重复上述测试
|
||
- 在 PostHog Dashboard 查看 Live Events
|
||
- 验证数据完整性
|
||
|
||
---
|
||
|
||
**测试日期：** _________
|
||
**测试人：** _________
|
||
**环境：** 本地开发（控制台模式）
|