docs: 将所有文档迁移到 docs/ 目录
- 移动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>
This commit is contained in:
149
docs/QUICK_TEST_CHECKLIST.md
Normal file
149
docs/QUICK_TEST_CHECKLIST.md
Normal file
@@ -0,0 +1,149 @@
|
||||
# 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
|
||||
- 验证数据完整性
|
||||
|
||||
---
|
||||
|
||||
**测试日期:** _________
|
||||
**测试人:** _________
|
||||
**环境:** 本地开发(控制台模式)
|
||||
Reference in New Issue
Block a user