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:
zdl
2025-10-30 14:51:22 +08:00
parent 3a5c1b9d9c
commit 09db05c448
43 changed files with 23850 additions and 0 deletions

View 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
- 验证数据完整性
---
**测试日期:** _________
**测试人:** _________
**环境:** 本地开发(控制台模式)