Compare commits
10 Commits
before-rec
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
95f20e3049 | ||
|
|
7cca5e73c0 | ||
|
|
f9ed6c19de | ||
|
|
112fbbd42d | ||
| d4f813d58e | |||
| 05063374c0 | |||
| dac966e2d8 | |||
|
|
3a4dade8ec | ||
|
|
6f81259f8c | ||
|
|
864844a52b |
13
.claude/settings.local.json
Normal file
13
.claude/settings.local.json
Normal file
@@ -0,0 +1,13 @@
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"Bash(npm test:*)",
|
||||
"Bash(xargs ls:*)",
|
||||
"Bash(awk:*)",
|
||||
"Bash(npm start)",
|
||||
"Bash(python3:*)"
|
||||
],
|
||||
"deny": [],
|
||||
"ask": []
|
||||
}
|
||||
}
|
||||
@@ -1,63 +0,0 @@
|
||||
# 部署配置文件
|
||||
# 首次使用请复制此文件为 .env.deploy 并填写真实配置
|
||||
|
||||
# ==================== 服务器配置 ====================
|
||||
# 服务器 IP 或域名
|
||||
SERVER_HOST=your-server-ip-or-domain
|
||||
|
||||
# SSH 用户名
|
||||
SERVER_USER=ubuntu
|
||||
|
||||
# SSH 端口
|
||||
SERVER_PORT=22
|
||||
|
||||
# SSH 密钥路径（留空使用默认 ~/.ssh/id_rsa）
|
||||
SSH_KEY_PATH=
|
||||
|
||||
# ==================== 路径配置 ====================
|
||||
# 服务器上的 Git 仓库路径
|
||||
REMOTE_PROJECT_PATH=/home/ubuntu/vf_react
|
||||
|
||||
# 生产环境部署路径
|
||||
PRODUCTION_PATH=/var/www/valuefrontier.cn
|
||||
|
||||
# 部署备份目录
|
||||
BACKUP_DIR=/home/ubuntu/deployments
|
||||
|
||||
# 部署日志目录
|
||||
LOG_DIR=/home/ubuntu/deploy-logs
|
||||
|
||||
# ==================== Git 配置 ====================
|
||||
# 部署分支
|
||||
DEPLOY_BRANCH=feature
|
||||
|
||||
# ==================== 备份配置 ====================
|
||||
# 保留备份数量
|
||||
KEEP_BACKUPS=5
|
||||
|
||||
# ==================== 企业微信通知配置 ====================
|
||||
# 是否启用企业微信通知 (true/false)
|
||||
ENABLE_WECHAT_NOTIFY=false
|
||||
|
||||
# 企业微信机器人 Webhook URL
|
||||
WECHAT_WEBHOOK_URL=
|
||||
|
||||
# 通知提及的用户（@all 或 手机号/userid）
|
||||
WECHAT_MENTIONED_LIST=
|
||||
|
||||
# ==================== 部署配置 ====================
|
||||
# 是否在部署前运行 npm install (true/false)
|
||||
RUN_NPM_INSTALL=true
|
||||
|
||||
# 是否在部署前运行 npm test (true/false)
|
||||
RUN_NPM_TEST=false
|
||||
|
||||
# 构建命令
|
||||
BUILD_COMMAND=npm run build
|
||||
|
||||
# ==================== 高级配置 ====================
|
||||
# SSH 连接超时时间（秒）
|
||||
SSH_TIMEOUT=30
|
||||
|
||||
# 部署超时时间（秒）
|
||||
DEPLOY_TIMEOUT=600
|
||||
@@ -1,5 +1,5 @@
|
||||
# 开发环境配置（连接真实后端）
|
||||
# 使用方式: npm run start:dev
|
||||
# 使用方式: npm start
|
||||
|
||||
# React 构建优化配置
|
||||
GENERATE_SOURCEMAP=false
|
||||
@@ -18,8 +18,3 @@ REACT_APP_ENABLE_MOCK=false
|
||||
|
||||
# 开发环境标识
|
||||
REACT_APP_ENV=development
|
||||
|
||||
# 性能监控配置
|
||||
REACT_APP_ENABLE_PERFORMANCE_MONITOR=true
|
||||
REACT_APP_ENABLE_PERFORMANCE_PANEL=true
|
||||
REACT_APP_REPORT_TO_POSTHOG=false
|
||||
|
||||
25
.env.mock
25
.env.mock
@@ -1,20 +1,5 @@
|
||||
# ========================================
|
||||
# Mock 测试环境配置
|
||||
# ========================================
|
||||
# 使用方式: npm run start:mock
|
||||
#
|
||||
# 工作原理：
|
||||
# 1. 通过 env-cmd 加载此配置文件
|
||||
# 2. REACT_APP_ENABLE_MOCK=true 会在 src/index.js 中启动 MSW (Mock Service Worker)
|
||||
# 3. MSW 在浏览器层面拦截所有 HTTP 请求
|
||||
# 4. 根据 src/mocks/handlers/* 中定义的规则返回 mock 数据
|
||||
# 5. 未定义 mock 的接口会继续请求真实后端
|
||||
#
|
||||
# 适用场景：
|
||||
# - 前端独立开发，无需后端支持
|
||||
# - 测试特定接口的 UI 表现
|
||||
# - 后端接口未就绪时的快速原型开发
|
||||
# ========================================
|
||||
|
||||
# React 构建优化配置
|
||||
GENERATE_SOURCEMAP=false
|
||||
@@ -25,16 +10,10 @@ IMAGE_INLINE_SIZE_LIMIT=10000
|
||||
NODE_OPTIONS=--max_old_space_size=4096
|
||||
|
||||
# API 配置
|
||||
# Mock 模式下使用空字符串，让请求使用相对路径
|
||||
# MSW 会在浏览器层拦截这些请求，不需要真实的后端地址
|
||||
REACT_APP_API_URL=
|
||||
|
||||
# Socket.IO 连接地址（Mock 模式下连接生产环境）
|
||||
# 注意：WebSocket 不被 MSW 拦截，可以独立配置
|
||||
REACT_APP_SOCKET_URL=https://valuefrontier.cn
|
||||
# Mock 模式下不需要真实的后端地址
|
||||
REACT_APP_API_URL=http://localhost:3000
|
||||
|
||||
# 启用 Mock 数据（核心配置）
|
||||
# 此配置会触发 src/index.js 中的 MSW 初始化
|
||||
REACT_APP_ENABLE_MOCK=true
|
||||
|
||||
# Mock 环境标识
|
||||
|
||||
@@ -1,47 +0,0 @@
|
||||
# ========================================
|
||||
# 生产环境配置
|
||||
# ========================================
|
||||
|
||||
# 环境标识
|
||||
REACT_APP_ENV=production
|
||||
NODE_ENV=production
|
||||
|
||||
# Mock 配置（生产环境禁用 Mock）
|
||||
REACT_APP_ENABLE_MOCK=false
|
||||
|
||||
# 🔧 调试模式（生产环境临时调试用）
|
||||
# 开启后会在全局暴露 window.__DEBUG__
|
||||
REACT_APP_ENABLE_DEBUG=false
|
||||
|
||||
# 后端 API 地址（生产环境）
|
||||
REACT_APP_API_URL=http://49.232.185.254:5001
|
||||
|
||||
# PostHog 分析配置（生产环境）
|
||||
# PostHog API Key（从 PostHog 项目设置中获取）
|
||||
REACT_APP_POSTHOG_KEY=phc_xKlRyG69Bx7hgOdFeCeLUvQWvSjw18ZKFgCwCeYezWF
|
||||
# PostHog API Host（使用 PostHog Cloud）
|
||||
REACT_APP_POSTHOG_HOST=https://app.posthog.com
|
||||
# 启用会话录制（Session Recording）用于回放用户操作、排查问题
|
||||
REACT_APP_ENABLE_SESSION_RECORDING=true
|
||||
|
||||
# React 构建优化配置
|
||||
# 禁用 source map 生成（生产环境不需要，提升打包速度和安全性）
|
||||
GENERATE_SOURCEMAP=false
|
||||
# 跳过预检查（加快启动速度）
|
||||
SKIP_PREFLIGHT_CHECK=true
|
||||
# 禁用 ESLint 检查（生产构建时不需要）
|
||||
DISABLE_ESLINT_PLUGIN=true
|
||||
# TypeScript 编译错误时继续
|
||||
TSC_COMPILE_ON_ERROR=true
|
||||
# 图片内联大小限制
|
||||
IMAGE_INLINE_SIZE_LIMIT=10000
|
||||
# Node.js 内存限制（适用于大型项目）
|
||||
NODE_OPTIONS=--max_old_space_size=4096
|
||||
|
||||
# 性能监控配置（生产环境）
|
||||
# 启用性能监控
|
||||
REACT_APP_ENABLE_PERFORMANCE_MONITOR=true
|
||||
# 禁用性能面板（仅开发环境）
|
||||
REACT_APP_ENABLE_PERFORMANCE_PANEL=false
|
||||
# 启用 PostHog 性能数据上报
|
||||
REACT_APP_REPORT_TO_POSTHOG=true
|
||||
42
.env.test
42
.env.test
@@ -1,42 +0,0 @@
|
||||
# ========================================
|
||||
# 本地测试环境（前后端都在本地）
|
||||
# ========================================
|
||||
# 使用方式: npm run start:test
|
||||
#
|
||||
# 工作原理：
|
||||
# 1. concurrently 同时启动前端和后端
|
||||
# 2. 前端: localhost:3000
|
||||
# 3. 后端: localhost:5001 (python app_2.py)
|
||||
# 4. 数据: 本地数据库
|
||||
#
|
||||
# 适用场景：
|
||||
# - 调试后端代码
|
||||
# - 性能测试
|
||||
# - 离线开发
|
||||
# - 数据库调试
|
||||
# ========================================
|
||||
|
||||
# 环境标识
|
||||
REACT_APP_ENV=test
|
||||
NODE_ENV=development
|
||||
|
||||
# Mock 配置（关闭 MSW）
|
||||
REACT_APP_ENABLE_MOCK=false
|
||||
|
||||
# 后端 API 地址（本地后端）
|
||||
REACT_APP_API_URL=http://localhost:5001
|
||||
|
||||
# PostHog 配置（测试环境）
|
||||
# 留空 = 仅控制台 debug
|
||||
# 填入 Key = 控制台 + PostHog Cloud 双模式
|
||||
REACT_APP_POSTHOG_KEY=
|
||||
REACT_APP_POSTHOG_HOST=https://app.posthog.com
|
||||
REACT_APP_ENABLE_SESSION_RECORDING=false
|
||||
|
||||
# React 构建优化配置
|
||||
GENERATE_SOURCEMAP=true # 测试环境保留 sourcemap 便于调试
|
||||
SKIP_PREFLIGHT_CHECK=true
|
||||
DISABLE_ESLINT_PLUGIN=false # 测试环境开启 ESLint
|
||||
TSC_COMPILE_ON_ERROR=true
|
||||
IMAGE_INLINE_SIZE_LIMIT=10000
|
||||
NODE_OPTIONS=--max_old_space_size=4096
|
||||
92
.eslintrc.js
92
.eslintrc.js
@@ -1,92 +0,0 @@
|
||||
module.exports = {
|
||||
root: true,
|
||||
|
||||
/* 环境配置 */
|
||||
env: {
|
||||
browser: true,
|
||||
es2021: true,
|
||||
node: true,
|
||||
},
|
||||
|
||||
/* 扩展配置 */
|
||||
extends: [
|
||||
'react-app', // Create React App 默认规则
|
||||
'react-app/jest', // Jest 测试规则
|
||||
'eslint:recommended', // ESLint 推荐规则
|
||||
'plugin:react/recommended', // React 推荐规则
|
||||
'plugin:react-hooks/recommended', // React Hooks 规则
|
||||
'plugin:prettier/recommended', // Prettier 集成
|
||||
],
|
||||
|
||||
/* 解析器选项 */
|
||||
parserOptions: {
|
||||
ecmaVersion: 'latest',
|
||||
sourceType: 'module',
|
||||
ecmaFeatures: {
|
||||
jsx: true,
|
||||
},
|
||||
},
|
||||
|
||||
/* 插件 */
|
||||
plugins: ['react', 'react-hooks', 'prettier'],
|
||||
|
||||
/* 规则配置 */
|
||||
rules: {
|
||||
// React
|
||||
'react/react-in-jsx-scope': 'off', // React 17+ 不需要导入 React
|
||||
'react/prop-types': 'off', // 使用 TypeScript 类型检查，不需要 PropTypes
|
||||
'react/display-name': 'off', // 允许匿名组件
|
||||
|
||||
// 通用
|
||||
'no-console': ['warn', { allow: ['warn', 'error'] }], // 仅警告 console.log
|
||||
'no-unused-vars': ['warn', {
|
||||
argsIgnorePattern: '^_', // 忽略以 _ 开头的未使用参数
|
||||
varsIgnorePattern: '^_', // 忽略以 _ 开头的未使用变量
|
||||
}],
|
||||
'prettier/prettier': ['warn', {}, { usePrettierrc: true }], // 使用项目的 Prettier 配置
|
||||
},
|
||||
|
||||
/* 设置 */
|
||||
settings: {
|
||||
react: {
|
||||
version: 'detect', // 自动检测 React 版本
|
||||
},
|
||||
},
|
||||
|
||||
/* TypeScript 文件特殊配置 */
|
||||
overrides: [
|
||||
{
|
||||
files: ['**/*.ts', '**/*.tsx'], // 仅对 TS 文件应用以下配置
|
||||
parser: '@typescript-eslint/parser', // 使用 TypeScript 解析器
|
||||
parserOptions: {
|
||||
project: './tsconfig.json', // 关联 tsconfig.json
|
||||
},
|
||||
extends: [
|
||||
'plugin:@typescript-eslint/recommended', // TypeScript 推荐规则
|
||||
],
|
||||
plugins: ['@typescript-eslint'],
|
||||
rules: {
|
||||
// TypeScript 特定规则
|
||||
'@typescript-eslint/no-explicit-any': 'warn', // 警告使用 any（允许但提示）
|
||||
'@typescript-eslint/explicit-module-boundary-types': 'off', // 不强制导出函数类型
|
||||
'@typescript-eslint/no-unused-vars': ['warn', {
|
||||
argsIgnorePattern: '^_',
|
||||
varsIgnorePattern: '^_',
|
||||
}],
|
||||
'@typescript-eslint/no-non-null-assertion': 'warn', // 警告使用 !（非空断言）
|
||||
|
||||
// 覆盖基础规则（避免与 TS 规则冲突）
|
||||
'no-unused-vars': 'off', // 使用 TS 版本的规则
|
||||
},
|
||||
},
|
||||
],
|
||||
|
||||
/* 忽略文件（与 .eslintignore 等效）*/
|
||||
ignorePatterns: [
|
||||
'node_modules/',
|
||||
'build/',
|
||||
'dist/',
|
||||
'*.config.js',
|
||||
'public/mockServiceWorker.js',
|
||||
],
|
||||
};
|
||||
15
.gitignore
vendored
15
.gitignore
vendored
@@ -35,21 +35,8 @@ pnpm-debug.log*
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# Claude Code 配置
|
||||
.claude/settings.local.json
|
||||
|
||||
# macOS
|
||||
.DS_Store
|
||||
|
||||
# Windows
|
||||
Thumbs.db
|
||||
|
||||
# Documentation
|
||||
*.md
|
||||
!README.md
|
||||
!CLAUDE.md
|
||||
|
||||
# 忽略 docs 目录（开发文档不提交到 Git）
|
||||
docs/
|
||||
|
||||
src/assets/img/original-backup/
|
||||
Thumbs.dbsrc/assets/img/original-backup/
|
||||
|
||||
13
ISSUE_TEMPLATE.md
Normal file
13
ISSUE_TEMPLATE.md
Normal file
@@ -0,0 +1,13 @@
|
||||
<!--
|
||||
IMPORTANT: Please use the following link to create a new issue:
|
||||
|
||||
https://www.creative-tim.com/new-issue/argon-dashboard-chakra-pro
|
||||
|
||||
**If your issue was not created using the app above, it will be closed immediately.**
|
||||
-->
|
||||
|
||||
<!--
|
||||
Love Creative Tim? Do you need Angular, React, Vuejs or HTML? You can visit:
|
||||
👉 https://www.creative-tim.com/bundles
|
||||
👉 https://www.creative-tim.com
|
||||
-->
|
||||
338
TEST_GUIDE.md
Normal file
338
TEST_GUIDE.md
Normal file
@@ -0,0 +1,338 @@
|
||||
# 崩溃修复测试指南
|
||||
|
||||
> 测试时间：2025-10-14
|
||||
> 测试范围：SignInIllustration.js + SignUpIllustration.js
|
||||
> 服务器地址：http://localhost:3000
|
||||
|
||||
---
|
||||
|
||||
## 🎯 测试目标
|
||||
|
||||
验证以下修复是否有效：
|
||||
- ✅ 响应对象崩溃（6处）
|
||||
- ✅ 组件卸载后 setState（6处）
|
||||
- ✅ 定时器内存泄漏（2处）
|
||||
|
||||
---
|
||||
|
||||
## 📋 测试清单
|
||||
|
||||
### ✅ 关键测试（必做）
|
||||
|
||||
#### 1. **网络异常测试** - 验证响应对象修复
|
||||
|
||||
**登录页面 - 发送验证码**
|
||||
```
|
||||
测试步骤：
|
||||
1. 打开 http://localhost:3000/auth/sign-in
|
||||
2. 切换到"验证码登录"模式
|
||||
3. 输入手机号：13800138000
|
||||
4. 打开浏览器开发者工具 (F12) → Network 标签
|
||||
5. 点击 Offline 模拟断网
|
||||
6. 点击"发送验证码"按钮
|
||||
|
||||
预期结果：
|
||||
✅ 显示错误提示："发送验证码失败 - 网络请求失败，请检查网络连接"
|
||||
✅ 页面不崩溃
|
||||
✅ 无 JavaScript 错误
|
||||
|
||||
修复前：
|
||||
❌ 页面白屏崩溃
|
||||
❌ Console 报错：Cannot read property 'json' of null
|
||||
```
|
||||
|
||||
**登录页面 - 微信登录**
|
||||
```
|
||||
测试步骤：
|
||||
1. 在登录页面，保持断网状态
|
||||
2. 点击"扫码登录"按钮
|
||||
|
||||
预期结果：
|
||||
✅ 显示错误提示："获取微信授权失败 - 网络请求失败，请检查网络连接"
|
||||
✅ 页面不崩溃
|
||||
✅ 无 JavaScript 错误
|
||||
```
|
||||
|
||||
**注册页面 - 发送验证码**
|
||||
```
|
||||
测试步骤：
|
||||
1. 打开 http://localhost:3000/auth/sign-up
|
||||
2. 切换到"验证码注册"模式
|
||||
3. 输入手机号：13800138000
|
||||
4. 保持断网状态
|
||||
5. 点击"发送验证码"按钮
|
||||
|
||||
预期结果：
|
||||
✅ 显示错误提示："发送失败 - 网络请求失败..."
|
||||
✅ 页面不崩溃
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### 2. **组件卸载测试** - 验证内存泄漏修复
|
||||
|
||||
**倒计时中离开页面**
|
||||
```
|
||||
测试步骤：
|
||||
1. 恢复网络连接
|
||||
2. 在登录页面输入手机号并发送验证码
|
||||
3. 等待倒计时开始（60秒倒计时）
|
||||
4. 立即点击浏览器后退按钮或切换到其他页面
|
||||
5. 打开 Console 查看是否有警告
|
||||
|
||||
预期结果：
|
||||
✅ 无警告："Can't perform a React state update on an unmounted component"
|
||||
✅ 倒计时定时器正确清理
|
||||
✅ 无内存泄漏
|
||||
|
||||
修复前：
|
||||
❌ Console 警告：Memory leak warning
|
||||
❌ setState 在组件卸载后仍被调用
|
||||
```
|
||||
|
||||
**请求进行中离开页面**
|
||||
```
|
||||
测试步骤：
|
||||
1. 在注册页面填写完整信息
|
||||
2. 点击"注册"按钮
|
||||
3. 在请求响应前（loading 状态）快速刷新页面或关闭标签页
|
||||
4. 打开新标签页查看 Console
|
||||
|
||||
预期结果：
|
||||
✅ 无崩溃
|
||||
✅ 无警告信息
|
||||
✅ 请求被正确取消或忽略
|
||||
```
|
||||
|
||||
**注册成功跳转前离开**
|
||||
```
|
||||
测试步骤：
|
||||
1. 完成注册提交
|
||||
2. 在显示"注册成功"提示后
|
||||
3. 立即关闭标签页（不等待2秒自动跳转）
|
||||
|
||||
预期结果：
|
||||
✅ 无警告
|
||||
✅ navigate 不会在组件卸载后执行
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### 3. **边界情况测试** - 验证数据完整性检查
|
||||
|
||||
**后端返回空响应**
|
||||
```
|
||||
测试步骤（需要模拟后端）：
|
||||
1. 使用 Chrome DevTools → Network → 右键请求 → Edit and Resend
|
||||
2. 修改响应为空对象 {}
|
||||
3. 观察页面反应
|
||||
|
||||
预期结果：
|
||||
✅ 显示错误："服务器响应为空"
|
||||
✅ 不会尝试访问 undefined 属性
|
||||
✅ 页面不崩溃
|
||||
```
|
||||
|
||||
**后端返回 500 错误**
|
||||
```
|
||||
测试步骤：
|
||||
1. 在登录页面点击"扫码登录"
|
||||
2. 如果后端返回 500 错误
|
||||
|
||||
预期结果：
|
||||
✅ 显示错误："获取二维码失败：HTTP 500"
|
||||
✅ 页面不崩溃
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🧪 进阶测试（推荐）
|
||||
|
||||
#### 4. **弱网环境测试**
|
||||
|
||||
**慢速网络模拟**
|
||||
```
|
||||
测试步骤：
|
||||
1. Chrome DevTools → Network → Throttling → Slow 3G
|
||||
2. 尝试发送验证码
|
||||
3. 等待 10 秒（超时时间）
|
||||
|
||||
预期结果：
|
||||
✅ 10秒后显示超时错误
|
||||
✅ 不会无限等待
|
||||
✅ 用户可以重试
|
||||
```
|
||||
|
||||
**丢包模拟**
|
||||
```
|
||||
测试步骤：
|
||||
1. 使用 Chrome DevTools 模拟丢包
|
||||
2. 连续点击"发送验证码"多次
|
||||
|
||||
预期结果：
|
||||
✅ 每次请求都有适当的错误提示
|
||||
✅ 不会因为并发请求而崩溃
|
||||
✅ 按钮在请求期间正确禁用
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### 5. **定时器清理测试**
|
||||
|
||||
**倒计时清理验证**
|
||||
```
|
||||
测试步骤：
|
||||
1. 在登录页面发送验证码
|
||||
2. 等待倒计时到 50 秒
|
||||
3. 快速切换到注册页面
|
||||
4. 再切换回登录页面
|
||||
5. 观察倒计时是否重置
|
||||
|
||||
预期结果：
|
||||
✅ 定时器在页面切换时正确清理
|
||||
✅ 返回登录页面时倒计时重新开始（如果再次发送）
|
||||
✅ 没有多个定时器同时运行
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### 6. **并发请求测试**
|
||||
|
||||
**快速连续点击**
|
||||
```
|
||||
测试步骤：
|
||||
1. 在登录页面输入手机号
|
||||
2. 快速连续点击"发送验证码"按钮 5 次
|
||||
|
||||
预期结果：
|
||||
✅ 只发送一次请求（按钮在请求期间禁用）
|
||||
✅ 不会因为并发而崩溃
|
||||
✅ 正确显示 loading 状态
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 监控指标
|
||||
|
||||
### Console 检查清单
|
||||
|
||||
在测试过程中，打开 Console (F12) 监控以下内容：
|
||||
|
||||
```
|
||||
✅ 无红色错误（Error）
|
||||
✅ 无内存泄漏警告（Memory leak warning）
|
||||
✅ 无 setState 警告（Can't perform a React state update...）
|
||||
✅ 无 undefined 访问错误（Cannot read property of undefined）
|
||||
```
|
||||
|
||||
### Network 检查清单
|
||||
|
||||
打开 Network 标签监控：
|
||||
|
||||
```
|
||||
✅ 请求超时时间：10秒
|
||||
✅ 失败请求有正确的错误处理
|
||||
✅ 没有重复的请求
|
||||
✅ 请求被正确取消（如果页面卸载）
|
||||
```
|
||||
|
||||
### Performance 检查清单
|
||||
|
||||
打开 Performance 标签（可选）：
|
||||
|
||||
```
|
||||
✅ 无内存泄漏（Memory 不会持续增长）
|
||||
✅ 定时器正确清理（Timer count 正确）
|
||||
✅ EventListener 正确清理
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 测试记录表
|
||||
|
||||
请在测试时填写以下表格：
|
||||
|
||||
| 测试项 | 状态 | 问题描述 | 截图 |
|
||||
|--------|------|---------|------|
|
||||
| 登录页 - 断网发送验证码 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 登录页 - 断网微信登录 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 注册页 - 断网发送验证码 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 倒计时中离开页面 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 请求进行中离开页面 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 注册成功跳转前离开 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 后端返回空响应 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 慢速网络超时 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 定时器清理 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
| 并发请求 | ⬜ 通过 / ⬜ 失败 | | |
|
||||
|
||||
---
|
||||
|
||||
## 🐛 如何报告问题
|
||||
|
||||
如果发现问题，请提供：
|
||||
|
||||
1. **测试场景**：具体的测试步骤
|
||||
2. **预期结果**：应该发生什么
|
||||
3. **实际结果**：实际发生了什么
|
||||
4. **Console 错误**：完整的错误信息
|
||||
5. **截图/录屏**：问题的视觉证明
|
||||
6. **环境信息**：
|
||||
- 浏览器版本
|
||||
- 操作系统
|
||||
- 网络状态
|
||||
|
||||
---
|
||||
|
||||
## ✅ 测试完成检查
|
||||
|
||||
测试完成后，确认以下内容：
|
||||
|
||||
```
|
||||
□ 所有关键测试通过
|
||||
□ Console 无错误
|
||||
□ Network 请求正常
|
||||
□ 无内存泄漏警告
|
||||
□ 用户体验流畅
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 快速测试命令
|
||||
|
||||
```bash
|
||||
# 1. 确认服务器运行
|
||||
curl http://localhost:3000
|
||||
|
||||
# 2. 打开浏览器测试
|
||||
open http://localhost:3000/auth/sign-in
|
||||
|
||||
# 3. 查看编译日志
|
||||
tail -f /tmp/react-build.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 测试页面链接
|
||||
|
||||
- **登录页面**: http://localhost:3000/auth/sign-in
|
||||
- **注册页面**: http://localhost:3000/auth/sign-up
|
||||
- **首页**: http://localhost:3000/home
|
||||
|
||||
---
|
||||
|
||||
## 🔧 开发者工具快捷键
|
||||
|
||||
```
|
||||
F12 - 打开开发者工具
|
||||
Ctrl/Cmd+R - 刷新页面
|
||||
Ctrl/Cmd+Shift+R - 强制刷新（清除缓存）
|
||||
Ctrl/Cmd+Shift+C - 元素选择器
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**测试时间**：2025-10-14
|
||||
**预计测试时长**：15-30 分钟
|
||||
**建议测试人员**：开发者 + QA
|
||||
|
||||
祝测试顺利！如发现问题请及时反馈。
|
||||
Binary file not shown.
Binary file not shown.
BIN
__pycache__/config.cpython-311.pyc
Executable file
BIN
__pycache__/config.cpython-311.pyc
Executable file
Binary file not shown.
BIN
__pycache__/wechat_pay.cpython-310.pyc
Normal file
BIN
__pycache__/wechat_pay.cpython-310.pyc
Normal file
Binary file not shown.
BIN
__pycache__/wechat_pay_config.cpython-310.pyc
Normal file
BIN
__pycache__/wechat_pay_config.cpython-310.pyc
Normal file
Binary file not shown.
BIN
about_us.docx
BIN
about_us.docx
Binary file not shown.
45
app/__init__.py
Normal file
45
app/__init__.py
Normal file
@@ -0,0 +1,45 @@
|
||||
from flask import Flask
|
||||
from flask_sqlalchemy import SQLAlchemy
|
||||
|
||||
from flask_cors import CORS
|
||||
from datetime import datetime
|
||||
import pytz
|
||||
import os
|
||||
|
||||
# 创建Flask应用
|
||||
app = Flask(__name__)
|
||||
|
||||
# 配置
|
||||
config_name = os.environ.get('FLASK_ENV', 'development')
|
||||
from config import config
|
||||
app.config.from_object(config[config_name])
|
||||
|
||||
# 初始化扩展
|
||||
db = SQLAlchemy(app)
|
||||
CORS(app, resources={r"/api/*": {"origins": "*"}})
|
||||
|
||||
# 时区设置
|
||||
def beijing_now():
|
||||
"""获取北京时间"""
|
||||
tz = pytz.timezone('Asia/Shanghai')
|
||||
return datetime.now(tz)
|
||||
|
||||
# 导入模型
|
||||
from app.models import *
|
||||
|
||||
# 创建数据库表
|
||||
with app.app_context():
|
||||
db.create_all()
|
||||
|
||||
# 注册路由
|
||||
from app.routes import events, stocks, limitanalyse, calendar, industries
|
||||
|
||||
app.register_blueprint(events.bp)
|
||||
app.register_blueprint(stocks.bp)
|
||||
app.register_blueprint(limitanalyse.bp)
|
||||
app.register_blueprint(calendar.bp)
|
||||
app.register_blueprint(industries.bp)
|
||||
|
||||
if __name__ == '__main__':
|
||||
print("=== Value Frontier React 架构启动 ===")
|
||||
app.run(host='0.0.0.0', port=5001, debug=True)
|
||||
BIN
app/__pycache__/__init__.cpython-310.pyc
Normal file
BIN
app/__pycache__/__init__.cpython-310.pyc
Normal file
Binary file not shown.
BIN
app/__pycache__/__init__.cpython-311.pyc
Normal file
BIN
app/__pycache__/__init__.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/__pycache__/models.cpython-311.pyc
Normal file
BIN
app/__pycache__/models.cpython-311.pyc
Normal file
Binary file not shown.
30
app/extensions.py
Normal file
30
app/extensions.py
Normal file
@@ -0,0 +1,30 @@
|
||||
# app/extensions.py
|
||||
from flask_sqlalchemy import SQLAlchemy
|
||||
from flask_login import LoginManager
|
||||
from flask_compress import Compress
|
||||
from flask_cors import CORS
|
||||
from clickhouse_driver import Client as Cclient
|
||||
from sqlalchemy import create_engine
|
||||
|
||||
# Database instances
|
||||
db = SQLAlchemy()
|
||||
|
||||
# Other extensions
|
||||
login_manager = LoginManager()
|
||||
compress = Compress()
|
||||
cors = CORS()
|
||||
|
||||
# Database engines (如果仍然需要直接使用 engine)
|
||||
engine = create_engine("mysql+pymysql://root:Zzl33818!@111.198.58.126:33060/stock", echo=False)
|
||||
engine_med = create_engine("mysql+pymysql://root:Zzl33818!@111.198.58.126:33060/med", echo=False)
|
||||
engine_2 = create_engine("mysql+pymysql://root:Zzl33818!@111.198.58.126:33060/valuefrontier", echo=False)
|
||||
|
||||
# ClickHouse client factory
|
||||
def get_clickhouse_client():
|
||||
return Cclient(
|
||||
host='111.198.58.126',
|
||||
port=18778,
|
||||
user='default',
|
||||
password='Zzl5588161!',
|
||||
database='stock'
|
||||
)
|
||||
504
app/models.py
Normal file
504
app/models.py
Normal file
@@ -0,0 +1,504 @@
|
||||
from app import db
|
||||
from datetime import datetime
|
||||
import pytz
|
||||
import json
|
||||
|
||||
def beijing_now():
|
||||
"""获取北京时间"""
|
||||
tz = pytz.timezone('Asia/Shanghai')
|
||||
return datetime.now(tz)
|
||||
|
||||
class Post(db.Model):
|
||||
"""帖子模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'), nullable=False)
|
||||
user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
|
||||
|
||||
# 内容
|
||||
title = db.Column(db.String(200)) # 标题(可选)
|
||||
content = db.Column(db.Text, nullable=False) # 内容
|
||||
content_type = db.Column(db.String(20), default='text') # 内容类型:text/rich_text/link
|
||||
|
||||
# 时间
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now, onupdate=beijing_now)
|
||||
|
||||
# 统计
|
||||
likes_count = db.Column(db.Integer, default=0)
|
||||
comments_count = db.Column(db.Integer, default=0)
|
||||
view_count = db.Column(db.Integer, default=0)
|
||||
|
||||
# 状态
|
||||
status = db.Column(db.String(20), default='active') # active/hidden/deleted
|
||||
is_top = db.Column(db.Boolean, default=False) # 是否置顶
|
||||
|
||||
# 关系
|
||||
user = db.relationship('User', backref='posts')
|
||||
likes = db.relationship('PostLike', backref='post', lazy='dynamic')
|
||||
comments = db.relationship('Comment', backref='post', lazy='dynamic')
|
||||
|
||||
class User(db.Model):
|
||||
"""用户模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
|
||||
# 基础账号信息(注册时必填)
|
||||
username = db.Column(db.String(80), unique=True, nullable=False) # 用户名
|
||||
email = db.Column(db.String(120), unique=True, nullable=False) # 邮箱
|
||||
password_hash = db.Column(db.String(128), nullable=False) # 密码哈希
|
||||
email_confirmed = db.Column(db.Boolean, default=False) # 邮箱是否验证
|
||||
|
||||
# 账号状态
|
||||
created_at = db.Column(db.DateTime, default=beijing_now) # 注册时间
|
||||
last_seen = db.Column(db.DateTime, default=beijing_now) # 最后活跃时间
|
||||
status = db.Column(db.String(20), default='active') # 账号状态 active/banned/deleted
|
||||
|
||||
# 个人资料(可选,后续在个人中心完善)
|
||||
nickname = db.Column(db.String(30)) # 社区昵称
|
||||
avatar_url = db.Column(db.String(200)) # 头像URL
|
||||
banner_url = db.Column(db.String(200)) # 个人主页背景图
|
||||
bio = db.Column(db.String(200)) # 个人简介
|
||||
gender = db.Column(db.String(10)) # 性别
|
||||
birth_date = db.Column(db.Date) # 生日
|
||||
location = db.Column(db.String(100)) # 所在地
|
||||
|
||||
# 联系方式(可选)
|
||||
phone = db.Column(db.String(20)) # 手机号
|
||||
wechat_id = db.Column(db.String(80)) # 微信号
|
||||
|
||||
# 实名认证信息(可选)
|
||||
real_name = db.Column(db.String(30)) # 真实姓名
|
||||
id_number = db.Column(db.String(18)) # 身份证号(加密存储)
|
||||
is_verified = db.Column(db.Boolean, default=False) # 是否实名认证
|
||||
verify_time = db.Column(db.DateTime) # 实名认证时间
|
||||
|
||||
# 投资相关信息(可选)
|
||||
trading_experience = db.Column(db.Integer) # 炒股年限
|
||||
investment_style = db.Column(db.String(50)) # 投资风格
|
||||
risk_preference = db.Column(db.String(20)) # 风险偏好
|
||||
investment_amount = db.Column(db.String(20)) # 投资规模
|
||||
preferred_markets = db.Column(db.String(200), default='[]') # 偏好市场 JSON
|
||||
|
||||
# 社区信息(系统自动更新)
|
||||
user_level = db.Column(db.Integer, default=1) # 用户等级
|
||||
reputation_score = db.Column(db.Integer, default=0) # 信用积分
|
||||
contribution_point = db.Column(db.Integer, default=0) # 贡献点数
|
||||
post_count = db.Column(db.Integer, default=0) # 发帖数
|
||||
comment_count = db.Column(db.Integer, default=0) # 评论数
|
||||
follower_count = db.Column(db.Integer, default=0) # 粉丝数
|
||||
following_count = db.Column(db.Integer, default=0) # 关注数
|
||||
|
||||
# 创作者信息(可选)
|
||||
is_creator = db.Column(db.Boolean, default=False) # 是否创作者
|
||||
creator_type = db.Column(db.String(20)) # 创作者类型
|
||||
creator_tags = db.Column(db.String(200), default='[]') # 创作者标签 JSON
|
||||
|
||||
# 系统设置
|
||||
email_notifications = db.Column(db.Boolean, default=True) # 邮件通知
|
||||
sms_notifications = db.Column(db.Boolean, default=False) # 短信通知
|
||||
wechat_notifications = db.Column(db.Boolean, default=False) # 微信通知
|
||||
notification_preferences = db.Column(db.String(500), default='{}') # 通知偏好 JSON
|
||||
privacy_level = db.Column(db.String(20), default='public') # 隐私级别
|
||||
theme_preference = db.Column(db.String(20), default='light') # 主题偏好
|
||||
blocked_keywords = db.Column(db.String(500), default='[]') # 屏蔽关键词 JSON
|
||||
# 手机号验证
|
||||
phone_confirmed = db.Column(db.Boolean, default=False) # 手机是否验证
|
||||
phone_confirm_time = db.Column(db.DateTime) # 手机验证时间
|
||||
|
||||
def __init__(self, username, email=None, password=None, phone=None):
|
||||
self.username = username
|
||||
if email:
|
||||
self.email = email
|
||||
if password:
|
||||
self.set_password(password)
|
||||
if phone:
|
||||
self.phone = phone
|
||||
|
||||
def set_password(self, password):
|
||||
from werkzeug.security import generate_password_hash
|
||||
self.password_hash = generate_password_hash(password)
|
||||
|
||||
def check_password(self, password):
|
||||
from werkzeug.security import check_password_hash
|
||||
return check_password_hash(self.password_hash, password)
|
||||
|
||||
def update_last_seen(self):
|
||||
self.last_seen = beijing_now()
|
||||
db.session.commit()
|
||||
|
||||
def get_preferred_markets(self):
|
||||
try:
|
||||
return json.loads(self.preferred_markets)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
|
||||
def get_blocked_keywords(self):
|
||||
try:
|
||||
return json.loads(self.blocked_keywords)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
|
||||
def get_notification_preferences(self):
|
||||
try:
|
||||
return json.loads(self.notification_preferences)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return {}
|
||||
|
||||
def get_creator_tags(self):
|
||||
try:
|
||||
return json.loads(self.creator_tags)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
|
||||
def set_preferred_markets(self, markets):
|
||||
self.preferred_markets = json.dumps(markets)
|
||||
|
||||
def set_blocked_keywords(self, keywords):
|
||||
self.blocked_keywords = json.dumps(keywords)
|
||||
|
||||
def set_notification_preferences(self, preferences):
|
||||
self.notification_preferences = json.dumps(preferences)
|
||||
|
||||
def set_creator_tags(self, tags):
|
||||
self.creator_tags = json.dumps(tags)
|
||||
|
||||
def to_dict(self):
|
||||
return {
|
||||
'id': self.id,
|
||||
'username': self.username,
|
||||
'email': self.email,
|
||||
'nickname': self.nickname,
|
||||
'avatar_url': self.avatar_url,
|
||||
'bio': self.bio,
|
||||
'created_at': self.created_at.isoformat() if self.created_at else None,
|
||||
'last_seen': self.last_seen.isoformat() if self.last_seen else None,
|
||||
'status': self.status,
|
||||
'user_level': self.user_level,
|
||||
'reputation_score': self.reputation_score,
|
||||
'post_count': self.post_count,
|
||||
'follower_count': self.follower_count,
|
||||
'following_count': self.following_count
|
||||
}
|
||||
|
||||
def __repr__(self):
|
||||
return f'<User {self.username}>'
|
||||
|
||||
class Comment(db.Model):
|
||||
"""评论"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
post_id = db.Column(db.Integer, db.ForeignKey('post.id'), nullable=False)
|
||||
user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
|
||||
content = db.Column(db.Text, nullable=False)
|
||||
parent_id = db.Column(db.Integer, db.ForeignKey('comment.id')) # 父评论ID,用于回复
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
status = db.Column(db.String(20), default='active')
|
||||
|
||||
user = db.relationship('User', backref='comments')
|
||||
replies = db.relationship('Comment', backref=db.backref('parent', remote_side=[id]))
|
||||
|
||||
|
||||
class CommentLike(db.Model):
|
||||
"""评论点赞记录（基于session_id以兼容匿名点赞）"""
|
||||
__tablename__ = 'comment_like'
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
comment_id = db.Column(db.Integer, db.ForeignKey('comment.id'), nullable=False)
|
||||
session_id = db.Column(db.String(100), nullable=False)
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
__table_args__ = (db.UniqueConstraint('comment_id', 'session_id'),)
|
||||
|
||||
class EventFollow(db.Model):
|
||||
"""事件关注"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'), nullable=False)
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
user = db.relationship('User', backref='event_follows')
|
||||
|
||||
__table_args__ = (db.UniqueConstraint('user_id', 'event_id'),)
|
||||
|
||||
class PostLike(db.Model):
|
||||
"""帖子点赞"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
|
||||
post_id = db.Column(db.Integer, db.ForeignKey('post.id'), nullable=False)
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
user = db.relationship('User', backref='post_likes')
|
||||
|
||||
__table_args__ = (db.UniqueConstraint('user_id', 'post_id'),)
|
||||
|
||||
class Event(db.Model):
|
||||
"""事件模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
title = db.Column(db.String(200), nullable=False)
|
||||
description = db.Column(db.Text)
|
||||
|
||||
# 事件类型与状态
|
||||
event_type = db.Column(db.String(50))
|
||||
status = db.Column(db.String(20), default='active')
|
||||
|
||||
# 时间相关
|
||||
start_time = db.Column(db.DateTime, default=beijing_now)
|
||||
end_time = db.Column(db.DateTime)
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
# 热度与统计
|
||||
hot_score = db.Column(db.Float, default=0)
|
||||
view_count = db.Column(db.Integer, default=0)
|
||||
trending_score = db.Column(db.Float, default=0)
|
||||
post_count = db.Column(db.Integer, default=0)
|
||||
follower_count = db.Column(db.Integer, default=0)
|
||||
|
||||
# 关联信息
|
||||
related_industries = db.Column(db.JSON)
|
||||
keywords = db.Column(db.JSON)
|
||||
files = db.Column(db.JSON)
|
||||
importance = db.Column(db.String(20))
|
||||
related_avg_chg = db.Column(db.Float, default=0)
|
||||
related_max_chg = db.Column(db.Float, default=0)
|
||||
related_week_chg = db.Column(db.Float, default=0)
|
||||
|
||||
# 新增字段
|
||||
invest_score = db.Column(db.Integer) # 超预期得分
|
||||
expectation_surprise_score = db.Column(db.Integer)
|
||||
# 创建者信息
|
||||
creator_id = db.Column(db.Integer, db.ForeignKey('user.id'))
|
||||
creator = db.relationship('User', backref='created_events')
|
||||
|
||||
# 关系
|
||||
posts = db.relationship('Post', backref='event', lazy='dynamic')
|
||||
followers = db.relationship('EventFollow', backref='event', lazy='dynamic')
|
||||
related_stocks = db.relationship('RelatedStock', backref='event', lazy='dynamic')
|
||||
historical_events = db.relationship('HistoricalEvent', backref='event', lazy='dynamic')
|
||||
related_data = db.relationship('RelatedData', backref='event', lazy='dynamic')
|
||||
related_concepts = db.relationship('RelatedConcepts', backref='event', lazy='dynamic')
|
||||
|
||||
@property
|
||||
def keywords_list(self):
|
||||
if isinstance(self.keywords, list):
|
||||
return self.keywords
|
||||
elif isinstance(self.keywords, str):
|
||||
try:
|
||||
return json.loads(self.keywords)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
return []
|
||||
|
||||
def set_keywords(self, keywords):
|
||||
if isinstance(keywords, list):
|
||||
self.keywords = keywords
|
||||
elif isinstance(keywords, str):
|
||||
try:
|
||||
self.keywords = json.loads(keywords)
|
||||
except json.JSONDecodeError:
|
||||
self.keywords = [keywords]
|
||||
else:
|
||||
self.keywords = []
|
||||
|
||||
class RelatedStock(db.Model):
|
||||
"""相关标的模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'))
|
||||
stock_code = db.Column(db.String(20)) # 股票代码
|
||||
stock_name = db.Column(db.String(100)) # 股票名称
|
||||
sector = db.Column(db.String(100)) # 关联类型
|
||||
relation_desc = db.Column(db.String(1024)) # 关联原因描述
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now, onupdate=beijing_now)
|
||||
correlation = db.Column(db.Float())
|
||||
momentum = db.Column(db.String(1024)) #动量
|
||||
|
||||
class RelatedData(db.Model):
|
||||
"""关联数据模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'))
|
||||
title = db.Column(db.String(200)) # 数据标题
|
||||
data_type = db.Column(db.String(50)) # 数据类型
|
||||
data_content = db.Column(db.JSON) # 数据内容(JSON格式)
|
||||
description = db.Column(db.Text) # 数据描述
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
class RelatedConcepts(db.Model):
|
||||
"""关联数据模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'))
|
||||
concept_code = db.Column(db.String(20)) # 数据标题
|
||||
concept = db.Column(db.String(100)) # 数据类型
|
||||
reason = db.Column(db.Text) # 数据描述
|
||||
image_paths = db.Column(db.JSON) # 数据内容(JSON格式)
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
@property
|
||||
def image_paths_list(self):
|
||||
if isinstance(self.image_paths, list):
|
||||
return self.image_paths
|
||||
elif isinstance(self.image_paths, str):
|
||||
try:
|
||||
return json.loads(self.image_paths)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
return []
|
||||
|
||||
def set_image_paths(self, image_paths):
|
||||
if isinstance(image_paths, list):
|
||||
self.image_paths = image_paths
|
||||
elif isinstance(image_paths, str):
|
||||
try:
|
||||
self.image_paths = json.loads(image_paths)
|
||||
except json.JSONDecodeError:
|
||||
self.image_paths = [image_paths]
|
||||
else:
|
||||
self.image_paths = []
|
||||
|
||||
def get_first_image_path(self):
|
||||
paths = self.image_paths_list
|
||||
return paths[0] if paths else None
|
||||
|
||||
class EventHotHistory(db.Model):
|
||||
"""事件热度历史记录"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'))
|
||||
score = db.Column(db.Float) # 总分
|
||||
interaction_score = db.Column(db.Float) # 互动分数
|
||||
follow_score = db.Column(db.Float) # 关注度分数
|
||||
view_score = db.Column(db.Float) # 浏览量分数
|
||||
recent_activity_score = db.Column(db.Float) # 最近活跃度分数
|
||||
time_decay = db.Column(db.Float) # 时间衰减因子
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
event = db.relationship('Event', backref='hot_history')
|
||||
|
||||
class EventTransmissionNode(db.Model):
|
||||
"""事件传导节点模型"""
|
||||
__tablename__ = 'event_transmission_nodes'
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'), nullable=False)
|
||||
node_type = db.Column(db.Enum('company', 'industry', 'policy', 'technology',
|
||||
'market', 'event', 'other'), nullable=False)
|
||||
node_name = db.Column(db.String(200), nullable=False)
|
||||
node_description = db.Column(db.Text)
|
||||
importance_score = db.Column(db.Integer, default=50)
|
||||
stock_code = db.Column(db.String(20))
|
||||
is_main_event = db.Column(db.Boolean, default=False)
|
||||
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now, onupdate=beijing_now)
|
||||
|
||||
# Relationships
|
||||
event = db.relationship('Event', backref='transmission_nodes')
|
||||
outgoing_edges = db.relationship('EventTransmissionEdge',
|
||||
foreign_keys='EventTransmissionEdge.from_node_id',
|
||||
backref='from_node', cascade='all, delete-orphan')
|
||||
incoming_edges = db.relationship('EventTransmissionEdge',
|
||||
foreign_keys='EventTransmissionEdge.to_node_id',
|
||||
backref='to_node', cascade='all, delete-orphan')
|
||||
|
||||
__table_args__ = (
|
||||
db.Index('idx_event_node_type', 'event_id', 'node_type'),
|
||||
db.Index('idx_node_name', 'node_name'),
|
||||
)
|
||||
|
||||
class EventTransmissionEdge(db.Model):
|
||||
"""事件传导边模型"""
|
||||
__tablename__ = 'event_transmission_edges'
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'), nullable=False)
|
||||
from_node_id = db.Column(db.Integer, db.ForeignKey('event_transmission_nodes.id'), nullable=False)
|
||||
to_node_id = db.Column(db.Integer, db.ForeignKey('event_transmission_nodes.id'), nullable=False)
|
||||
|
||||
transmission_type = db.Column(db.Enum('supply_chain', 'competition', 'policy',
|
||||
'technology', 'capital_flow', 'expectation',
|
||||
'cyclic_effect', 'other'), nullable=False)
|
||||
transmission_mechanism = db.Column(db.Text)
|
||||
direction = db.Column(db.Enum('positive', 'negative', 'neutral', 'mixed'), default='neutral')
|
||||
strength = db.Column(db.Integer, default=50)
|
||||
impact = db.Column(db.Text)
|
||||
is_circular = db.Column(db.Boolean, default=False)
|
||||
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now, onupdate=beijing_now)
|
||||
|
||||
# Relationship
|
||||
event = db.relationship('Event', backref='transmission_edges')
|
||||
|
||||
__table_args__ = (
|
||||
db.Index('idx_event_edge_type', 'event_id', 'transmission_type'),
|
||||
db.Index('idx_from_to_nodes', 'from_node_id', 'to_node_id'),
|
||||
)
|
||||
|
||||
class EventSankeyFlow(db.Model):
|
||||
"""事件桑基流模型"""
|
||||
__tablename__ = 'event_sankey_flows'
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'), nullable=False)
|
||||
|
||||
# 流的基本信息
|
||||
source_node = db.Column(db.String(200), nullable=False)
|
||||
source_type = db.Column(db.Enum('event', 'policy', 'technology', 'industry',
|
||||
'company', 'product'), nullable=False)
|
||||
source_level = db.Column(db.Integer, nullable=False, default=0)
|
||||
|
||||
target_node = db.Column(db.String(200), nullable=False)
|
||||
target_type = db.Column(db.Enum('policy', 'technology', 'industry',
|
||||
'company', 'product'), nullable=False)
|
||||
target_level = db.Column(db.Integer, nullable=False, default=1)
|
||||
|
||||
# 流量信息
|
||||
flow_value = db.Column(db.Numeric(10, 2), nullable=False)
|
||||
flow_ratio = db.Column(db.Numeric(5, 4), nullable=False)
|
||||
|
||||
# 传导机制
|
||||
transmission_path = db.Column(db.String(500))
|
||||
impact_description = db.Column(db.Text)
|
||||
evidence_strength = db.Column(db.Integer, default=50)
|
||||
|
||||
# 时间戳
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
updated_at = db.Column(db.DateTime, default=beijing_now, onupdate=beijing_now)
|
||||
|
||||
# 关系
|
||||
event = db.relationship('Event', backref='sankey_flows')
|
||||
|
||||
__table_args__ = (
|
||||
db.Index('idx_event_flow', 'event_id'),
|
||||
db.Index('idx_source_target', 'source_node', 'target_node'),
|
||||
)
|
||||
|
||||
class HistoricalEvent(db.Model):
|
||||
"""历史事件模型"""
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
event_id = db.Column(db.Integer, db.ForeignKey('event.id'))
|
||||
title = db.Column(db.String(200))
|
||||
content = db.Column(db.Text)
|
||||
event_date = db.Column(db.DateTime)
|
||||
relevance = db.Column(db.Integer) # 相关性
|
||||
importance = db.Column(db.Integer) # 重要程度
|
||||
related_stock = db.Column(db.JSON) # 保留JSON字段
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
# 新增关系
|
||||
stocks = db.relationship('HistoricalEventStock', backref='historical_event', lazy='dynamic',
|
||||
cascade='all, delete-orphan')
|
||||
|
||||
class HistoricalEventStock(db.Model):
|
||||
"""历史事件相关股票模型"""
|
||||
__tablename__ = 'historical_event_stocks'
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
historical_event_id = db.Column(db.Integer, db.ForeignKey('historical_event.id'), nullable=False)
|
||||
stock_code = db.Column(db.String(20), nullable=False)
|
||||
stock_name = db.Column(db.String(50))
|
||||
relation_desc = db.Column(db.Text)
|
||||
correlation = db.Column(db.Float, default=0.5)
|
||||
sector = db.Column(db.String(100))
|
||||
created_at = db.Column(db.DateTime, default=beijing_now)
|
||||
|
||||
__table_args__ = (
|
||||
db.Index('idx_historical_event_stock', 'historical_event_id', 'stock_code'),
|
||||
)
|
||||
1
app/routes/__init__.py
Normal file
1
app/routes/__init__.py
Normal file
@@ -0,0 +1 @@
|
||||
# 路由包初始化文件
|
||||
BIN
app/routes/__pycache__/__init__.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/__init__.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/routes/__pycache__/calendar.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/calendar.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/routes/__pycache__/events.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/events.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/routes/__pycache__/industries.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/industries.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/routes/__pycache__/limitanalyse.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/limitanalyse.cpython-311.pyc
Normal file
Binary file not shown.
BIN
app/routes/__pycache__/stocks.cpython-311.pyc
Normal file
BIN
app/routes/__pycache__/stocks.cpython-311.pyc
Normal file
Binary file not shown.
121
app/routes/calendar.py
Normal file
121
app/routes/calendar.py
Normal file
@@ -0,0 +1,121 @@
|
||||
from flask import Blueprint, request, jsonify
|
||||
from datetime import datetime, timedelta
|
||||
import json
|
||||
|
||||
bp = Blueprint('calendar', __name__, url_prefix='/api/v1/calendar')
|
||||
|
||||
@bp.route('/event-counts', methods=['GET'])
|
||||
def get_event_counts():
|
||||
"""获取事件数量统计"""
|
||||
try:
|
||||
year = request.args.get('year', '2027')
|
||||
month = request.args.get('month', '10')
|
||||
|
||||
# 模拟事件数量数据
|
||||
event_counts = []
|
||||
for day in range(1, 32):
|
||||
count = (day % 7) + 1 # 模拟每天1-7个事件
|
||||
event_counts.append({
|
||||
'date': f'{year}-{month.zfill(2)}-{day:02d}',
|
||||
'count': count
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': event_counts
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting event counts: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/events', methods=['GET'])
|
||||
def get_calendar_events():
|
||||
"""获取日历事件"""
|
||||
try:
|
||||
year = request.args.get('year', '2027')
|
||||
month = request.args.get('month', '10')
|
||||
event_type = request.args.get('type', 'all')
|
||||
|
||||
# 模拟日历事件数据
|
||||
events = []
|
||||
for day in range(1, 32):
|
||||
for i in range((day % 7) + 1):
|
||||
event = {
|
||||
'id': f'{year}{month.zfill(2)}{day:02d}{i}',
|
||||
'title': f'事件{day}-{i+1}',
|
||||
'date': f'{year}-{month.zfill(2)}-{day:02d}',
|
||||
'type': ['政策', '技术', '产业', '公司'][i % 4],
|
||||
'importance': ['高', '中', '低'][i % 3],
|
||||
'status': 'active'
|
||||
}
|
||||
events.append(event)
|
||||
|
||||
# 根据类型过滤
|
||||
if event_type != 'all':
|
||||
events = [e for e in events if e['type'] == event_type]
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': events
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting calendar events: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/events/<int:event_id>', methods=['GET'])
|
||||
def get_calendar_event_detail(event_id):
|
||||
"""获取日历事件详情"""
|
||||
try:
|
||||
# 模拟事件详情
|
||||
event_detail = {
|
||||
'id': event_id,
|
||||
'title': f'事件{event_id}详情',
|
||||
'description': f'这是事件{event_id}的详细描述',
|
||||
'date': '2027-10-15',
|
||||
'type': '政策',
|
||||
'importance': '高',
|
||||
'status': 'active',
|
||||
'related_stocks': [
|
||||
{'code': '000001', 'name': '股票A'},
|
||||
{'code': '000002', 'name': '股票B'}
|
||||
],
|
||||
'keywords': ['政策', '改革', '创新'],
|
||||
'files': [
|
||||
{'name': '报告.pdf', 'url': '/files/report.pdf'},
|
||||
{'name': '数据.xlsx', 'url': '/files/data.xlsx'}
|
||||
]
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': event_detail
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting calendar event detail: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
def get_event_class(count):
|
||||
"""根据事件数量获取CSS类"""
|
||||
if count == 0:
|
||||
return 'no-events'
|
||||
elif count <= 3:
|
||||
return 'few-events'
|
||||
elif count <= 6:
|
||||
return 'medium-events'
|
||||
else:
|
||||
return 'many-events'
|
||||
|
||||
def parse_json_field(field_value):
|
||||
"""解析JSON字段"""
|
||||
if isinstance(field_value, str):
|
||||
try:
|
||||
return json.loads(field_value)
|
||||
except (json.JSONDecodeError, TypeError):
|
||||
return []
|
||||
elif isinstance(field_value, (list, dict)):
|
||||
return field_value
|
||||
else:
|
||||
return []
|
||||
385
app/routes/events.py
Normal file
385
app/routes/events.py
Normal file
@@ -0,0 +1,385 @@
|
||||
from flask import Blueprint, request, jsonify
|
||||
from app import db
|
||||
from app.models import Event, RelatedStock, RelatedConcepts, HistoricalEvent, EventTransmissionNode, EventTransmissionEdge, EventSankeyFlow
|
||||
from datetime import datetime
|
||||
import json
|
||||
|
||||
bp = Blueprint('events', __name__, url_prefix='/api/events')
|
||||
|
||||
|
||||
|
||||
@bp.route('/<int:event_id>', methods=['GET'])
|
||||
def get_event_detail(event_id):
|
||||
"""获取事件详情"""
|
||||
try:
|
||||
event = Event.query.get(event_id)
|
||||
if not event:
|
||||
return jsonify({'success': False, 'error': '事件不存在'}), 404
|
||||
|
||||
# 获取相关股票
|
||||
related_stocks = RelatedStock.query.filter_by(event_id=event_id).all()
|
||||
stocks_data = []
|
||||
for stock in related_stocks:
|
||||
stocks_data.append({
|
||||
'id': stock.id,
|
||||
'stock_code': stock.stock_code,
|
||||
'stock_name': stock.stock_name,
|
||||
'sector': stock.sector,
|
||||
'relation_desc': stock.relation_desc,
|
||||
'correlation': stock.correlation,
|
||||
'momentum': stock.momentum,
|
||||
'created_at': stock.created_at.isoformat() if stock.created_at else None
|
||||
})
|
||||
|
||||
# 获取相关概念
|
||||
related_concepts = RelatedConcepts.query.filter_by(event_id=event_id).all()
|
||||
concepts_data = []
|
||||
for concept in related_concepts:
|
||||
concepts_data.append({
|
||||
'id': concept.id,
|
||||
'concept_code': concept.concept_code,
|
||||
'concept': concept.concept,
|
||||
'reason': concept.reason,
|
||||
'image_paths': concept.image_paths_list,
|
||||
'created_at': concept.created_at.isoformat() if concept.created_at else None
|
||||
})
|
||||
|
||||
event_data = {
|
||||
'id': event.id,
|
||||
'title': event.title,
|
||||
'description': event.description,
|
||||
'event_type': event.event_type,
|
||||
'status': event.status,
|
||||
'start_time': event.start_time.isoformat() if event.start_time else None,
|
||||
'end_time': event.end_time.isoformat() if event.end_time else None,
|
||||
'created_at': event.created_at.isoformat() if event.created_at else None,
|
||||
'updated_at': event.updated_at.isoformat() if event.updated_at else None,
|
||||
'hot_score': event.hot_score,
|
||||
'view_count': event.view_count,
|
||||
'trending_score': event.trending_score,
|
||||
'post_count': event.post_count,
|
||||
'follower_count': event.follower_count,
|
||||
'related_industries': event.related_industries,
|
||||
'keywords': event.keywords_list,
|
||||
'files': event.files,
|
||||
'importance': event.importance,
|
||||
'related_avg_chg': event.related_avg_chg,
|
||||
'related_max_chg': event.related_max_chg,
|
||||
'related_week_chg': event.related_week_chg,
|
||||
'invest_score': event.invest_score,
|
||||
'expectation_surprise_score': event.expectation_surprise_score,
|
||||
'related_stocks': stocks_data,
|
||||
'related_concepts': concepts_data
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': event_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting event detail: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/stocks', methods=['GET'])
|
||||
def get_related_stocks(event_id):
|
||||
"""获取事件相关股票"""
|
||||
try:
|
||||
stocks = RelatedStock.query.filter_by(event_id=event_id).all()
|
||||
stocks_data = []
|
||||
for stock in stocks:
|
||||
stocks_data.append({
|
||||
'id': stock.id,
|
||||
'stock_code': stock.stock_code,
|
||||
'stock_name': stock.stock_name,
|
||||
'sector': stock.sector,
|
||||
'relation_desc': stock.relation_desc,
|
||||
'correlation': stock.correlation,
|
||||
'momentum': stock.momentum,
|
||||
'created_at': stock.created_at.isoformat() if stock.created_at else None
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': stocks_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting related stocks: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/stocks', methods=['POST'])
|
||||
def add_related_stock(event_id):
|
||||
"""添加相关股票"""
|
||||
try:
|
||||
data = request.get_json()
|
||||
if not data:
|
||||
return jsonify({'success': False, 'error': '请提供数据'}), 400
|
||||
|
||||
# 检查事件是否存在
|
||||
event = Event.query.get(event_id)
|
||||
if not event:
|
||||
return jsonify({'success': False, 'error': '事件不存在'}), 404
|
||||
|
||||
# 创建新的相关股票记录
|
||||
new_stock = RelatedStock(
|
||||
event_id=event_id,
|
||||
stock_code=data['stock_code'],
|
||||
stock_name=data.get('stock_name', ''),
|
||||
sector=data.get('sector', ''),
|
||||
relation_desc=data['relation_desc'],
|
||||
correlation=data.get('correlation', 0.5),
|
||||
momentum=data.get('momentum', '')
|
||||
)
|
||||
|
||||
db.session.add(new_stock)
|
||||
db.session.commit()
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'message': '相关股票添加成功',
|
||||
'data': {
|
||||
'id': new_stock.id,
|
||||
'stock_code': new_stock.stock_code,
|
||||
'stock_name': new_stock.stock_name,
|
||||
'sector': new_stock.sector,
|
||||
'relation_desc': new_stock.relation_desc,
|
||||
'correlation': new_stock.correlation,
|
||||
'momentum': new_stock.momentum
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
db.session.rollback()
|
||||
print(f"Error adding related stock: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/stocks/<int:stock_id>', methods=['DELETE'])
|
||||
def delete_related_stock(stock_id):
|
||||
"""删除相关股票"""
|
||||
try:
|
||||
stock = RelatedStock.query.get(stock_id)
|
||||
if not stock:
|
||||
return jsonify({'success': False, 'error': '相关股票不存在'}), 404
|
||||
|
||||
db.session.delete(stock)
|
||||
db.session.commit()
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'message': '相关股票删除成功'
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
db.session.rollback()
|
||||
print(f"Error deleting related stock: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/concepts', methods=['GET'])
|
||||
def get_related_concepts(event_id):
|
||||
"""获取事件相关概念"""
|
||||
try:
|
||||
concepts = RelatedConcepts.query.filter_by(event_id=event_id).all()
|
||||
concepts_data = []
|
||||
for concept in concepts:
|
||||
concepts_data.append({
|
||||
'id': concept.id,
|
||||
'concept_code': concept.concept_code,
|
||||
'concept': concept.concept,
|
||||
'reason': concept.reason,
|
||||
'image_paths': concept.image_paths_list,
|
||||
'created_at': concept.created_at.isoformat() if concept.created_at else None
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': concepts_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting related concepts: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/historical', methods=['GET'])
|
||||
def get_historical_events(event_id):
|
||||
"""获取历史事件"""
|
||||
try:
|
||||
historical_events = HistoricalEvent.query.filter_by(event_id=event_id).all()
|
||||
events_data = []
|
||||
for event in historical_events:
|
||||
events_data.append({
|
||||
'id': event.id,
|
||||
'title': event.title,
|
||||
'content': event.content,
|
||||
'event_date': event.event_date.isoformat() if event.event_date else None,
|
||||
'relevance': event.relevance,
|
||||
'importance': event.importance,
|
||||
'related_stock': event.related_stock,
|
||||
'created_at': event.created_at.isoformat() if event.created_at else None
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': events_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting historical events: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/expectation-score', methods=['GET'])
|
||||
def get_expectation_score(event_id):
|
||||
"""获取超预期得分"""
|
||||
try:
|
||||
event = Event.query.get(event_id)
|
||||
if not event:
|
||||
return jsonify({'success': False, 'error': '事件不存在'}), 404
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'invest_score': event.invest_score,
|
||||
'expectation_surprise_score': event.expectation_surprise_score
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting expectation score: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/follow', methods=['POST'])
|
||||
def toggle_event_follow(event_id):
|
||||
"""关注/取消关注事件"""
|
||||
try:
|
||||
# 这里需要用户认证，暂时返回成功
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'message': '关注状态更新成功'
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error toggling event follow: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/transmission', methods=['GET'])
|
||||
def get_transmission_chain(event_id):
|
||||
"""获取事件传导链"""
|
||||
try:
|
||||
# 获取传导节点
|
||||
nodes = EventTransmissionNode.query.filter_by(event_id=event_id).all()
|
||||
nodes_data = []
|
||||
for node in nodes:
|
||||
nodes_data.append({
|
||||
'id': node.id,
|
||||
'node_type': node.node_type,
|
||||
'node_name': node.node_name,
|
||||
'node_description': node.node_description,
|
||||
'importance_score': node.importance_score,
|
||||
'stock_code': node.stock_code,
|
||||
'is_main_event': node.is_main_event
|
||||
})
|
||||
|
||||
# 获取传导边
|
||||
edges = EventTransmissionEdge.query.filter_by(event_id=event_id).all()
|
||||
edges_data = []
|
||||
for edge in edges:
|
||||
edges_data.append({
|
||||
'id': edge.id,
|
||||
'from_node_id': edge.from_node_id,
|
||||
'to_node_id': edge.to_node_id,
|
||||
'transmission_type': edge.transmission_type,
|
||||
'transmission_mechanism': edge.transmission_mechanism,
|
||||
'direction': edge.direction,
|
||||
'strength': edge.strength,
|
||||
'impact': edge.impact,
|
||||
'is_circular': edge.is_circular
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'nodes': nodes_data,
|
||||
'edges': edges_data
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting transmission chain: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/sankey-data')
|
||||
def get_event_sankey_data(event_id):
|
||||
"""获取事件桑基图数据"""
|
||||
try:
|
||||
flows = EventSankeyFlow.query.filter_by(event_id=event_id).all()
|
||||
flows_data = []
|
||||
for flow in flows:
|
||||
flows_data.append({
|
||||
'id': flow.id,
|
||||
'source_node': flow.source_node,
|
||||
'source_type': flow.source_type,
|
||||
'source_level': flow.source_level,
|
||||
'target_node': flow.target_node,
|
||||
'target_type': flow.target_type,
|
||||
'target_level': flow.target_level,
|
||||
'flow_value': float(flow.flow_value),
|
||||
'flow_ratio': float(flow.flow_ratio),
|
||||
'transmission_path': flow.transmission_path,
|
||||
'impact_description': flow.impact_description,
|
||||
'evidence_strength': flow.evidence_strength
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': flows_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting sankey data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/chain-analysis')
|
||||
def get_event_chain_analysis(event_id):
|
||||
"""获取事件链分析"""
|
||||
try:
|
||||
# 这里可以添加更复杂的链分析逻辑
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'event_id': event_id,
|
||||
'analysis': '链分析数据'
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting chain analysis: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<int:event_id>/chain-node/<int:node_id>', methods=['GET'])
|
||||
def get_chain_node_detail(event_id, node_id):
|
||||
"""获取链节点详情"""
|
||||
try:
|
||||
node = EventTransmissionNode.query.filter_by(
|
||||
event_id=event_id,
|
||||
id=node_id
|
||||
).first()
|
||||
|
||||
if not node:
|
||||
return jsonify({'success': False, 'error': '节点不存在'}), 404
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'id': node.id,
|
||||
'node_type': node.node_type,
|
||||
'node_name': node.node_name,
|
||||
'node_description': node.node_description,
|
||||
'importance_score': node.importance_score,
|
||||
'stock_code': node.stock_code,
|
||||
'is_main_event': node.is_main_event
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting chain node detail: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
511
app/routes/industries.py
Normal file
511
app/routes/industries.py
Normal file
@@ -0,0 +1,511 @@
|
||||
from flask import Blueprint, request, jsonify
|
||||
import json
|
||||
|
||||
bp = Blueprint('industries', __name__, url_prefix='/api')
|
||||
|
||||
@bp.route('/classifications', methods=['GET'])
|
||||
def get_classifications():
|
||||
"""获取行业分类"""
|
||||
try:
|
||||
# 模拟行业分类数据
|
||||
classifications = [
|
||||
{
|
||||
'id': 1,
|
||||
'name': '申万一级行业',
|
||||
'description': '申万一级行业分类标准',
|
||||
'levels': [
|
||||
{'id': 1, 'name': '农林牧渔'},
|
||||
{'id': 2, 'name': '采掘'},
|
||||
{'id': 3, 'name': '化工'},
|
||||
{'id': 4, 'name': '钢铁'},
|
||||
{'id': 5, 'name': '有色金属'},
|
||||
{'id': 6, 'name': '建筑材料'},
|
||||
{'id': 7, 'name': '建筑装饰'},
|
||||
{'id': 8, 'name': '电气设备'},
|
||||
{'id': 9, 'name': '国防军工'},
|
||||
{'id': 10, 'name': '汽车'},
|
||||
{'id': 11, 'name': '家用电器'},
|
||||
{'id': 12, 'name': '纺织服装'},
|
||||
{'id': 13, 'name': '轻工制造'},
|
||||
{'id': 14, 'name': '医药生物'},
|
||||
{'id': 15, 'name': '公用事业'},
|
||||
{'id': 16, 'name': '交通运输'},
|
||||
{'id': 17, 'name': '房地产'},
|
||||
{'id': 18, 'name': '商业贸易'},
|
||||
{'id': 19, 'name': '休闲服务'},
|
||||
{'id': 20, 'name': '银行'},
|
||||
{'id': 21, 'name': '非银金融'},
|
||||
{'id': 22, 'name': '综合'},
|
||||
{'id': 23, 'name': '计算机'},
|
||||
{'id': 24, 'name': '传媒'},
|
||||
{'id': 25, 'name': '通信'},
|
||||
{'id': 26, 'name': '电子'},
|
||||
{'id': 27, 'name': '机械设备'},
|
||||
{'id': 28, 'name': '食品饮料'}
|
||||
]
|
||||
}
|
||||
]
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': classifications
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting classifications: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/levels', methods=['GET'])
|
||||
def get_industry_levels():
|
||||
"""获取行业层级"""
|
||||
try:
|
||||
classification_id = request.args.get('classification_id', '1')
|
||||
|
||||
# 模拟行业层级数据
|
||||
levels = [
|
||||
{
|
||||
'id': 1,
|
||||
'name': '农林牧渔',
|
||||
'code': '801010',
|
||||
'description': '农业、林业、畜牧业、渔业',
|
||||
'stock_count': 45,
|
||||
'avg_change': 1.2,
|
||||
'total_market_cap': 500000000000,
|
||||
'sub_industries': [
|
||||
{'id': 101, 'name': '种植业', 'stock_count': 20},
|
||||
{'id': 102, 'name': '林业', 'stock_count': 8},
|
||||
{'id': 103, 'name': '畜牧业', 'stock_count': 12},
|
||||
{'id': 104, 'name': '渔业', 'stock_count': 5}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 2,
|
||||
'name': '采掘',
|
||||
'code': '801020',
|
||||
'description': '煤炭、石油、天然气、有色金属矿采选',
|
||||
'stock_count': 38,
|
||||
'avg_change': 0.8,
|
||||
'total_market_cap': 800000000000,
|
||||
'sub_industries': [
|
||||
{'id': 201, 'name': '煤炭开采', 'stock_count': 15},
|
||||
{'id': 202, 'name': '石油开采', 'stock_count': 8},
|
||||
{'id': 203, 'name': '有色金属矿采选', 'stock_count': 15}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 3,
|
||||
'name': '化工',
|
||||
'code': '801030',
|
||||
'description': '化学原料、化学制品、化学纤维',
|
||||
'stock_count': 156,
|
||||
'avg_change': 1.5,
|
||||
'total_market_cap': 1200000000000,
|
||||
'sub_industries': [
|
||||
{'id': 301, 'name': '化学原料', 'stock_count': 45},
|
||||
{'id': 302, 'name': '化学制品', 'stock_count': 78},
|
||||
{'id': 303, 'name': '化学纤维', 'stock_count': 33}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 4,
|
||||
'name': '钢铁',
|
||||
'code': '801040',
|
||||
'description': '钢铁冶炼、钢铁制品',
|
||||
'stock_count': 32,
|
||||
'avg_change': 0.6,
|
||||
'total_market_cap': 600000000000,
|
||||
'sub_industries': [
|
||||
{'id': 401, 'name': '钢铁冶炼', 'stock_count': 18},
|
||||
{'id': 402, 'name': '钢铁制品', 'stock_count': 14}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 5,
|
||||
'name': '有色金属',
|
||||
'code': '801050',
|
||||
'description': '有色金属冶炼、有色金属制品',
|
||||
'stock_count': 67,
|
||||
'avg_change': 1.8,
|
||||
'total_market_cap': 900000000000,
|
||||
'sub_industries': [
|
||||
{'id': 501, 'name': '有色金属冶炼', 'stock_count': 35},
|
||||
{'id': 502, 'name': '有色金属制品', 'stock_count': 32}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 6,
|
||||
'name': '建筑材料',
|
||||
'code': '801060',
|
||||
'description': '水泥、玻璃、陶瓷、其他建材',
|
||||
'stock_count': 89,
|
||||
'avg_change': 1.1,
|
||||
'total_market_cap': 700000000000,
|
||||
'sub_industries': [
|
||||
{'id': 601, 'name': '水泥', 'stock_count': 25},
|
||||
{'id': 602, 'name': '玻璃', 'stock_count': 18},
|
||||
{'id': 603, 'name': '陶瓷', 'stock_count': 12},
|
||||
{'id': 604, 'name': '其他建材', 'stock_count': 34}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 7,
|
||||
'name': '建筑装饰',
|
||||
'code': '801070',
|
||||
'description': '房屋建设、装修装饰、园林工程',
|
||||
'stock_count': 45,
|
||||
'avg_change': 0.9,
|
||||
'total_market_cap': 400000000000,
|
||||
'sub_industries': [
|
||||
{'id': 701, 'name': '房屋建设', 'stock_count': 15},
|
||||
{'id': 702, 'name': '装修装饰', 'stock_count': 20},
|
||||
{'id': 703, 'name': '园林工程', 'stock_count': 10}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 8,
|
||||
'name': '电气设备',
|
||||
'code': '801080',
|
||||
'description': '电机、电气自动化设备、电源设备',
|
||||
'stock_count': 134,
|
||||
'avg_change': 2.1,
|
||||
'total_market_cap': 1500000000000,
|
||||
'sub_industries': [
|
||||
{'id': 801, 'name': '电机', 'stock_count': 25},
|
||||
{'id': 802, 'name': '电气自动化设备', 'stock_count': 45},
|
||||
{'id': 803, 'name': '电源设备', 'stock_count': 64}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 9,
|
||||
'name': '国防军工',
|
||||
'code': '801090',
|
||||
'description': '航天装备、航空装备、地面兵装',
|
||||
'stock_count': 28,
|
||||
'avg_change': 1.6,
|
||||
'total_market_cap': 300000000000,
|
||||
'sub_industries': [
|
||||
{'id': 901, 'name': '航天装备', 'stock_count': 8},
|
||||
{'id': 902, 'name': '航空装备', 'stock_count': 12},
|
||||
{'id': 903, 'name': '地面兵装', 'stock_count': 8}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 10,
|
||||
'name': '汽车',
|
||||
'code': '801100',
|
||||
'description': '汽车整车、汽车零部件',
|
||||
'stock_count': 78,
|
||||
'avg_change': 1.3,
|
||||
'total_market_cap': 1100000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1001, 'name': '汽车整车', 'stock_count': 25},
|
||||
{'id': 1002, 'name': '汽车零部件', 'stock_count': 53}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 11,
|
||||
'name': '家用电器',
|
||||
'code': '801110',
|
||||
'description': '白色家电、小家电、家电零部件',
|
||||
'stock_count': 56,
|
||||
'avg_change': 1.0,
|
||||
'total_market_cap': 800000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1101, 'name': '白色家电', 'stock_count': 20},
|
||||
{'id': 1102, 'name': '小家电', 'stock_count': 18},
|
||||
{'id': 1103, 'name': '家电零部件', 'stock_count': 18}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 12,
|
||||
'name': '纺织服装',
|
||||
'code': '801120',
|
||||
'description': '纺织制造、服装家纺',
|
||||
'stock_count': 67,
|
||||
'avg_change': 0.7,
|
||||
'total_market_cap': 500000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1201, 'name': '纺织制造', 'stock_count': 35},
|
||||
{'id': 1202, 'name': '服装家纺', 'stock_count': 32}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 13,
|
||||
'name': '轻工制造',
|
||||
'code': '801130',
|
||||
'description': '造纸、包装印刷、家用轻工',
|
||||
'stock_count': 89,
|
||||
'avg_change': 0.9,
|
||||
'total_market_cap': 600000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1301, 'name': '造纸', 'stock_count': 25},
|
||||
{'id': 1302, 'name': '包装印刷', 'stock_count': 30},
|
||||
{'id': 1303, 'name': '家用轻工', 'stock_count': 34}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 14,
|
||||
'name': '医药生物',
|
||||
'code': '801140',
|
||||
'description': '化学制药、中药、生物制品、医疗器械',
|
||||
'stock_count': 234,
|
||||
'avg_change': 1.9,
|
||||
'total_market_cap': 2500000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1401, 'name': '化学制药', 'stock_count': 78},
|
||||
{'id': 1402, 'name': '中药', 'stock_count': 45},
|
||||
{'id': 1403, 'name': '生物制品', 'stock_count': 56},
|
||||
{'id': 1404, 'name': '医疗器械', 'stock_count': 55}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 15,
|
||||
'name': '公用事业',
|
||||
'code': '801150',
|
||||
'description': '电力、燃气、水务',
|
||||
'stock_count': 78,
|
||||
'avg_change': 0.5,
|
||||
'total_market_cap': 900000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1501, 'name': '电力', 'stock_count': 45},
|
||||
{'id': 1502, 'name': '燃气', 'stock_count': 18},
|
||||
{'id': 1503, 'name': '水务', 'stock_count': 15}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 16,
|
||||
'name': '交通运输',
|
||||
'code': '801160',
|
||||
'description': '港口、公路、铁路、航空',
|
||||
'stock_count': 67,
|
||||
'avg_change': 0.8,
|
||||
'total_market_cap': 800000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1601, 'name': '港口', 'stock_count': 15},
|
||||
{'id': 1602, 'name': '公路', 'stock_count': 20},
|
||||
{'id': 1603, 'name': '铁路', 'stock_count': 12},
|
||||
{'id': 1604, 'name': '航空', 'stock_count': 20}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 17,
|
||||
'name': '房地产',
|
||||
'code': '801170',
|
||||
'description': '房地产开发、房地产服务',
|
||||
'stock_count': 89,
|
||||
'avg_change': 0.6,
|
||||
'total_market_cap': 1200000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1701, 'name': '房地产开发', 'stock_count': 65},
|
||||
{'id': 1702, 'name': '房地产服务', 'stock_count': 24}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 18,
|
||||
'name': '商业贸易',
|
||||
'code': '801180',
|
||||
'description': '贸易、零售',
|
||||
'stock_count': 78,
|
||||
'avg_change': 0.7,
|
||||
'total_market_cap': 600000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1801, 'name': '贸易', 'stock_count': 35},
|
||||
{'id': 1802, 'name': '零售', 'stock_count': 43}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 19,
|
||||
'name': '休闲服务',
|
||||
'code': '801190',
|
||||
'description': '景点、酒店、旅游综合',
|
||||
'stock_count': 34,
|
||||
'avg_change': 1.2,
|
||||
'total_market_cap': 300000000000,
|
||||
'sub_industries': [
|
||||
{'id': 1901, 'name': '景点', 'stock_count': 12},
|
||||
{'id': 1902, 'name': '酒店', 'stock_count': 15},
|
||||
{'id': 1903, 'name': '旅游综合', 'stock_count': 7}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 20,
|
||||
'name': '银行',
|
||||
'code': '801200',
|
||||
'description': '银行',
|
||||
'stock_count': 28,
|
||||
'avg_change': 0.4,
|
||||
'total_market_cap': 8000000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2001, 'name': '银行', 'stock_count': 28}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 21,
|
||||
'name': '非银金融',
|
||||
'code': '801210',
|
||||
'description': '保险、证券、多元金融',
|
||||
'stock_count': 45,
|
||||
'avg_change': 0.8,
|
||||
'total_market_cap': 2000000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2101, 'name': '保险', 'stock_count': 8},
|
||||
{'id': 2102, 'name': '证券', 'stock_count': 25},
|
||||
{'id': 2103, 'name': '多元金融', 'stock_count': 12}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 22,
|
||||
'name': '综合',
|
||||
'code': '801220',
|
||||
'description': '综合',
|
||||
'stock_count': 23,
|
||||
'avg_change': 0.6,
|
||||
'total_market_cap': 200000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2201, 'name': '综合', 'stock_count': 23}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 23,
|
||||
'name': '计算机',
|
||||
'code': '801230',
|
||||
'description': '计算机设备、计算机应用',
|
||||
'stock_count': 156,
|
||||
'avg_change': 2.3,
|
||||
'total_market_cap': 1800000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2301, 'name': '计算机设备', 'stock_count': 45},
|
||||
{'id': 2302, 'name': '计算机应用', 'stock_count': 111}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 24,
|
||||
'name': '传媒',
|
||||
'code': '801240',
|
||||
'description': '文化传媒、营销传播',
|
||||
'stock_count': 78,
|
||||
'avg_change': 1.4,
|
||||
'total_market_cap': 700000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2401, 'name': '文化传媒', 'stock_count': 45},
|
||||
{'id': 2402, 'name': '营销传播', 'stock_count': 33}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 25,
|
||||
'name': '通信',
|
||||
'code': '801250',
|
||||
'description': '通信设备、通信运营',
|
||||
'stock_count': 45,
|
||||
'avg_change': 1.7,
|
||||
'total_market_cap': 600000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2501, 'name': '通信设备', 'stock_count': 30},
|
||||
{'id': 2502, 'name': '通信运营', 'stock_count': 15}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 26,
|
||||
'name': '电子',
|
||||
'code': '801260',
|
||||
'description': '半导体、电子制造、光学光电子',
|
||||
'stock_count': 178,
|
||||
'avg_change': 2.0,
|
||||
'total_market_cap': 2000000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2601, 'name': '半导体', 'stock_count': 45},
|
||||
{'id': 2602, 'name': '电子制造', 'stock_count': 78},
|
||||
{'id': 2603, 'name': '光学光电子', 'stock_count': 55}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 27,
|
||||
'name': '机械设备',
|
||||
'code': '801270',
|
||||
'description': '通用机械、专用设备、仪器仪表',
|
||||
'stock_count': 234,
|
||||
'avg_change': 1.1,
|
||||
'total_market_cap': 1500000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2701, 'name': '通用机械', 'stock_count': 89},
|
||||
{'id': 2702, 'name': '专用设备', 'stock_count': 98},
|
||||
{'id': 2703, 'name': '仪器仪表', 'stock_count': 47}
|
||||
]
|
||||
},
|
||||
{
|
||||
'id': 28,
|
||||
'name': '食品饮料',
|
||||
'code': '801280',
|
||||
'description': '食品加工、饮料制造',
|
||||
'stock_count': 67,
|
||||
'avg_change': 1.3,
|
||||
'total_market_cap': 1000000000000,
|
||||
'sub_industries': [
|
||||
{'id': 2801, 'name': '食品加工', 'stock_count': 35},
|
||||
{'id': 2802, 'name': '饮料制造', 'stock_count': 32}
|
||||
]
|
||||
}
|
||||
]
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': levels
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting industry levels: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/info', methods=['GET'])
|
||||
def get_industry_info():
|
||||
"""获取行业信息"""
|
||||
try:
|
||||
industry_id = request.args.get('industry_id')
|
||||
|
||||
if not industry_id:
|
||||
return jsonify({'success': False, 'error': '请提供行业ID'}), 400
|
||||
|
||||
# 模拟行业信息
|
||||
industry_info = {
|
||||
'id': industry_id,
|
||||
'name': f'行业{industry_id}',
|
||||
'code': f'801{industry_id.zfill(3)}',
|
||||
'description': f'这是行业{industry_id}的详细描述',
|
||||
'stock_count': 50,
|
||||
'avg_change': 1.5,
|
||||
'total_market_cap': 800000000000,
|
||||
'pe_ratio': 15.6,
|
||||
'pb_ratio': 2.3,
|
||||
'roe': 8.5,
|
||||
'top_stocks': [
|
||||
{'code': '000001', 'name': '龙头股A', 'weight': 0.15},
|
||||
{'code': '000002', 'name': '龙头股B', 'weight': 0.12},
|
||||
{'code': '000003', 'name': '龙头股C', 'weight': 0.10}
|
||||
],
|
||||
'sub_industries': [
|
||||
{'id': 1, 'name': '子行业A', 'stock_count': 20},
|
||||
{'id': 2, 'name': '子行业B', 'stock_count': 18},
|
||||
{'id': 3, 'name': '子行业C', 'stock_count': 12}
|
||||
],
|
||||
'performance': {
|
||||
'daily': 1.5,
|
||||
'weekly': 3.2,
|
||||
'monthly': 8.5,
|
||||
'quarterly': 12.3,
|
||||
'yearly': 25.6
|
||||
},
|
||||
'trend': {
|
||||
'direction': 'up',
|
||||
'strength': 'medium',
|
||||
'duration': '3 months'
|
||||
}
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': industry_info
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting industry info: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
469
app/routes/limitanalyse.py
Normal file
469
app/routes/limitanalyse.py
Normal file
@@ -0,0 +1,469 @@
|
||||
from flask import Blueprint, request, jsonify
|
||||
import pandas as pd
|
||||
import json
|
||||
from datetime import datetime
|
||||
|
||||
bp = Blueprint('limitanalyse', __name__, url_prefix='/api/limit-analyse')
|
||||
|
||||
@bp.route('/available-dates', methods=['GET'])
|
||||
def get_available_dates():
|
||||
"""获取可用日期列表"""
|
||||
try:
|
||||
# 模拟可用日期
|
||||
dates = [
|
||||
'2025-07-16',
|
||||
'2025-07-15',
|
||||
'2025-07-14',
|
||||
'2025-07-11',
|
||||
'2025-07-10'
|
||||
]
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': dates
|
||||
})
|
||||
except Exception as e:
|
||||
print(f"Error getting available dates: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
def load_stock_data(datestr):
|
||||
"""加载股票数据"""
|
||||
try:
|
||||
# 模拟股票数据
|
||||
data = []
|
||||
for i in range(100):
|
||||
data.append({
|
||||
'code': f'00000{i:03d}',
|
||||
'name': f'股票{i}',
|
||||
'price': 10.0 + i * 0.1,
|
||||
'change': (i % 10 - 5) * 0.5,
|
||||
'sector': f'板块{i % 5}',
|
||||
'limit_type': '涨停' if i % 10 == 0 else '正常',
|
||||
'volume': 1000000 + i * 50000,
|
||||
'amount': 10000000 + i * 500000
|
||||
})
|
||||
|
||||
return pd.DataFrame(data)
|
||||
except Exception as e:
|
||||
print(f"Error loading stock data: {e}")
|
||||
return pd.DataFrame()
|
||||
|
||||
@bp.route('/data', methods=['GET'])
|
||||
def get_analysis_data():
|
||||
"""获取分析数据"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 加载数据
|
||||
df = load_stock_data(date)
|
||||
if df.empty:
|
||||
return jsonify({'success': False, 'error': '数据加载失败'}), 500
|
||||
|
||||
# 统计信息
|
||||
total_stocks = len(df)
|
||||
limit_up_stocks = len(df[df['limit_type'] == '涨停'])
|
||||
limit_down_stocks = len(df[df['limit_type'] == '跌停'])
|
||||
|
||||
# 板块统计
|
||||
sector_stats = df.groupby('sector').agg({
|
||||
'code': 'count',
|
||||
'change': 'mean',
|
||||
'volume': 'sum'
|
||||
}).reset_index()
|
||||
|
||||
sector_data = []
|
||||
for _, row in sector_stats.iterrows():
|
||||
sector_data.append({
|
||||
'sector': row['sector'],
|
||||
'stock_count': int(row['code']),
|
||||
'avg_change': round(row['change'], 2),
|
||||
'total_volume': int(row['volume'])
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'date': date,
|
||||
'total_stocks': total_stocks,
|
||||
'limit_up_stocks': limit_up_stocks,
|
||||
'limit_down_stocks': limit_down_stocks,
|
||||
'sector_stats': sector_data
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting analysis data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/sector-data', methods=['GET'])
|
||||
def get_sector_data():
|
||||
"""获取板块数据"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 加载数据
|
||||
df = load_stock_data(date)
|
||||
if df.empty:
|
||||
return jsonify({'success': False, 'error': '数据加载失败'}), 500
|
||||
|
||||
# 板块统计
|
||||
sector_stats = df.groupby('sector').agg({
|
||||
'code': 'count',
|
||||
'change': 'mean',
|
||||
'volume': 'sum',
|
||||
'amount': 'sum'
|
||||
}).reset_index()
|
||||
|
||||
sector_data = []
|
||||
for _, row in sector_stats.iterrows():
|
||||
sector_data.append({
|
||||
'sector': row['sector'],
|
||||
'stock_count': int(row['code']),
|
||||
'avg_change': round(row['change'], 2),
|
||||
'total_volume': int(row['volume']),
|
||||
'total_amount': int(row['amount'])
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': sector_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting sector data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/word-cloud', methods=['GET'])
|
||||
def get_word_cloud_data():
|
||||
"""获取词云数据"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 模拟词云数据
|
||||
word_data = [
|
||||
{'word': '科技', 'value': 100},
|
||||
{'word': '新能源', 'value': 85},
|
||||
{'word': '医药', 'value': 70},
|
||||
{'word': '消费', 'value': 65},
|
||||
{'word': '金融', 'value': 50},
|
||||
{'word': '地产', 'value': 45},
|
||||
{'word': '制造', 'value': 40},
|
||||
{'word': '农业', 'value': 35},
|
||||
{'word': '传媒', 'value': 30},
|
||||
{'word': '环保', 'value': 25}
|
||||
]
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': word_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting word cloud data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/chart-data', methods=['GET'])
|
||||
def get_chart_data():
|
||||
"""获取图表数据"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 模拟图表数据
|
||||
chart_data = {
|
||||
'limit_up_distribution': [
|
||||
{'sector': '科技', 'count': 15},
|
||||
{'sector': '新能源', 'count': 12},
|
||||
{'sector': '医药', 'count': 10},
|
||||
{'sector': '消费', 'count': 8},
|
||||
{'sector': '金融', 'count': 6}
|
||||
],
|
||||
'sector_performance': [
|
||||
{'sector': '科技', 'change': 2.5},
|
||||
{'sector': '新能源', 'change': 1.8},
|
||||
{'sector': '医药', 'change': 1.2},
|
||||
{'sector': '消费', 'change': 0.8},
|
||||
{'sector': '金融', 'change': 0.5}
|
||||
]
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': chart_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting chart data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/stock-details', methods=['GET'])
|
||||
def get_stock_details():
|
||||
"""获取股票详情"""
|
||||
try:
|
||||
code = request.args.get('code')
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
if not code:
|
||||
return jsonify({'success': False, 'error': '请提供股票代码'}), 400
|
||||
|
||||
# 模拟股票详情
|
||||
stock_detail = {
|
||||
'code': code,
|
||||
'name': f'股票{code}',
|
||||
'price': 15.50,
|
||||
'change': 2.5,
|
||||
'sector': '科技',
|
||||
'volume': 1500000,
|
||||
'amount': 23250000,
|
||||
'limit_type': '涨停',
|
||||
'turnover_rate': 3.2,
|
||||
'market_cap': 15500000000
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': stock_detail
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting stock details: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/sector-analysis', methods=['GET'])
|
||||
def get_sector_analysis():
|
||||
"""获取板块分析"""
|
||||
try:
|
||||
sector = request.args.get('sector')
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
if not sector:
|
||||
return jsonify({'success': False, 'error': '请提供板块名称'}), 400
|
||||
|
||||
# 模拟板块分析数据
|
||||
sector_analysis = {
|
||||
'sector': sector,
|
||||
'stock_count': 25,
|
||||
'avg_change': 1.8,
|
||||
'limit_up_count': 8,
|
||||
'limit_down_count': 2,
|
||||
'total_volume': 50000000,
|
||||
'total_amount': 750000000,
|
||||
'top_stocks': [
|
||||
{'code': '000001', 'name': '股票A', 'change': 10.0},
|
||||
{'code': '000002', 'name': '股票B', 'change': 9.5},
|
||||
{'code': '000003', 'name': '股票C', 'change': 8.8}
|
||||
]
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': sector_analysis
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting sector analysis: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/trend-analysis', methods=['GET'])
|
||||
def get_trend_analysis():
|
||||
"""获取趋势分析"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 模拟趋势分析数据
|
||||
trend_data = {
|
||||
'limit_up_trend': [
|
||||
{'date': '2025-07-10', 'count': 45},
|
||||
{'date': '2025-07-11', 'count': 52},
|
||||
{'date': '2025-07-14', 'count': 48},
|
||||
{'date': '2025-07-15', 'count': 55},
|
||||
{'date': '2025-07-16', 'count': 51}
|
||||
],
|
||||
'sector_trend': [
|
||||
{'sector': '科技', 'trend': 'up'},
|
||||
{'sector': '新能源', 'trend': 'up'},
|
||||
{'sector': '医药', 'trend': 'stable'},
|
||||
{'sector': '消费', 'trend': 'down'},
|
||||
{'sector': '金融', 'trend': 'stable'}
|
||||
]
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': trend_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting trend analysis: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/heat-map', methods=['GET'])
|
||||
def get_heat_map_data():
|
||||
"""获取热力图数据"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 模拟热力图数据
|
||||
heat_map_data = []
|
||||
sectors = ['科技', '新能源', '医药', '消费', '金融', '地产', '制造', '农业']
|
||||
|
||||
for i, sector in enumerate(sectors):
|
||||
for j in range(8):
|
||||
heat_map_data.append({
|
||||
'sector': sector,
|
||||
'metric': f'指标{j+1}',
|
||||
'value': (i + j) % 10 + 1
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': heat_map_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting heat map data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/correlation-analysis', methods=['GET'])
|
||||
def get_correlation_analysis():
|
||||
"""获取相关性分析"""
|
||||
try:
|
||||
date = request.args.get('date', '2025-07-16')
|
||||
|
||||
# 模拟相关性分析数据
|
||||
correlation_data = {
|
||||
'sector_correlations': [
|
||||
{'sector1': '科技', 'sector2': '新能源', 'correlation': 0.85},
|
||||
{'sector1': '医药', 'sector2': '消费', 'correlation': 0.72},
|
||||
{'sector1': '金融', 'sector2': '地产', 'correlation': 0.68},
|
||||
{'sector1': '科技', 'sector2': '医药', 'correlation': 0.45},
|
||||
{'sector1': '新能源', 'sector2': '制造', 'correlation': 0.78}
|
||||
],
|
||||
'stock_correlations': [
|
||||
{'stock1': '000001', 'stock2': '000002', 'correlation': 0.92},
|
||||
{'stock1': '000003', 'stock2': '000004', 'correlation': 0.88},
|
||||
{'stock1': '000005', 'stock2': '000006', 'correlation': 0.76}
|
||||
]
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': correlation_data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting correlation analysis: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/export-data', methods=['POST'])
|
||||
def export_data():
|
||||
"""导出数据"""
|
||||
try:
|
||||
data = request.get_json()
|
||||
date = data.get('date', '2025-07-16')
|
||||
export_type = data.get('type', 'excel')
|
||||
|
||||
# 模拟导出
|
||||
filename = f'limit_analyse_{date}.{export_type}'
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'message': '数据导出成功',
|
||||
'data': {
|
||||
'filename': filename,
|
||||
'download_url': f'/downloads/{filename}'
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error exporting data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/high-position-stocks', methods=['GET'])
|
||||
def get_high_position_stocks():
|
||||
"""获取高位股统计数据"""
|
||||
try:
|
||||
date = request.args.get('date', datetime.now().strftime('%Y%m%d'))
|
||||
|
||||
# 模拟高位股数据 - 实际使用时需要连接真实的数据库
|
||||
# 根据用户提供的表结构，查询连续涨停天数较多的股票
|
||||
high_position_stocks = [
|
||||
{
|
||||
'stock_code': '000001',
|
||||
'stock_name': '平安银行',
|
||||
'price': 15.68,
|
||||
'increase_rate': 10.02,
|
||||
'limit_up_days': 5,
|
||||
'continuous_limit_up': 3,
|
||||
'industry': '银行',
|
||||
'turnover_rate': 3.45,
|
||||
'market_cap': 32000000000
|
||||
},
|
||||
{
|
||||
'stock_code': '000002',
|
||||
'stock_name': '万科A',
|
||||
'price': 18.92,
|
||||
'increase_rate': 9.98,
|
||||
'limit_up_days': 4,
|
||||
'continuous_limit_up': 2,
|
||||
'industry': '房地产',
|
||||
'turnover_rate': 5.67,
|
||||
'market_cap': 21000000000
|
||||
},
|
||||
{
|
||||
'stock_code': '600036',
|
||||
'stock_name': '招商银行',
|
||||
'price': 42.15,
|
||||
'increase_rate': 8.45,
|
||||
'limit_up_days': 6,
|
||||
'continuous_limit_up': 4,
|
||||
'industry': '银行',
|
||||
'turnover_rate': 2.89,
|
||||
'market_cap': 105000000000
|
||||
},
|
||||
{
|
||||
'stock_code': '000858',
|
||||
'stock_name': '五粮液',
|
||||
'price': 168.50,
|
||||
'increase_rate': 7.23,
|
||||
'limit_up_days': 3,
|
||||
'continuous_limit_up': 2,
|
||||
'industry': '白酒',
|
||||
'turnover_rate': 1.56,
|
||||
'market_cap': 650000000000
|
||||
},
|
||||
{
|
||||
'stock_code': '002415',
|
||||
'stock_name': '海康威视',
|
||||
'price': 35.68,
|
||||
'increase_rate': 6.89,
|
||||
'limit_up_days': 4,
|
||||
'continuous_limit_up': 3,
|
||||
'industry': '安防',
|
||||
'turnover_rate': 4.12,
|
||||
'market_cap': 33000000000
|
||||
}
|
||||
]
|
||||
|
||||
# 统计信息
|
||||
total_count = len(high_position_stocks)
|
||||
avg_continuous_days = sum(stock['continuous_limit_up'] for stock in high_position_stocks) / total_count if total_count > 0 else 0
|
||||
|
||||
# 按连续涨停天数排序
|
||||
high_position_stocks.sort(key=lambda x: x['continuous_limit_up'], reverse=True)
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': {
|
||||
'stocks': high_position_stocks,
|
||||
'statistics': {
|
||||
'total_count': total_count,
|
||||
'avg_continuous_days': round(avg_continuous_days, 2),
|
||||
'max_continuous_days': max([stock['continuous_limit_up'] for stock in high_position_stocks], default=0),
|
||||
'industry_distribution': {}
|
||||
}
|
||||
}
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting high position stocks: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
241
app/routes/stocks.py
Normal file
241
app/routes/stocks.py
Normal file
@@ -0,0 +1,241 @@
|
||||
from flask import Blueprint, request, jsonify
|
||||
from app import db
|
||||
from clickhouse_driver import Client
|
||||
import pandas as pd
|
||||
from datetime import datetime, timedelta
|
||||
import pytz
|
||||
|
||||
bp = Blueprint('stocks', __name__, url_prefix='/api/stock')
|
||||
|
||||
def get_clickhouse_client():
|
||||
"""获取ClickHouse客户端"""
|
||||
return Client('localhost', port=9000, user='default', password='', database='default')
|
||||
|
||||
@bp.route('/quotes', methods=['GET', 'POST'])
|
||||
def get_stock_quotes():
|
||||
"""获取股票实时报价"""
|
||||
try:
|
||||
if request.method == 'GET':
|
||||
# GET 请求从 URL 参数获取数据
|
||||
codes = request.args.get('codes', '').split(',')
|
||||
event_time_str = request.args.get('event_time')
|
||||
else:
|
||||
# POST 请求从 JSON 获取数据
|
||||
codes = request.json.get('codes', [])
|
||||
event_time_str = request.json.get('event_time')
|
||||
|
||||
if not codes:
|
||||
return jsonify({'success': False, 'error': '请提供股票代码'}), 400
|
||||
|
||||
# 过滤空字符串
|
||||
codes = [code.strip() for code in codes if code.strip()]
|
||||
|
||||
if not codes:
|
||||
return jsonify({'success': False, 'error': '请提供有效的股票代码'}), 400
|
||||
|
||||
# 解析事件时间
|
||||
event_time = None
|
||||
if event_time_str:
|
||||
try:
|
||||
event_time = datetime.fromisoformat(event_time_str.replace('Z', '+00:00'))
|
||||
except ValueError:
|
||||
return jsonify({'success': False, 'error': '事件时间格式错误'}), 400
|
||||
|
||||
# 获取当前时间
|
||||
now = datetime.now(pytz.timezone('Asia/Shanghai'))
|
||||
|
||||
# 如果提供了事件时间，使用事件时间；否则使用当前时间
|
||||
target_time = event_time if event_time else now
|
||||
|
||||
# 获取交易日和交易时间
|
||||
def get_trading_day_and_times(event_datetime):
|
||||
"""获取交易日和交易时间列表"""
|
||||
# 这里简化处理，实际应该查询交易日历
|
||||
trading_day = event_datetime.strftime('%Y-%m-%d')
|
||||
|
||||
# 生成交易时间列表 (9:30-11:30, 13:00-15:00)
|
||||
morning_times = [f"{trading_day} {hour:02d}:{minute:02d}"
|
||||
for hour in range(9, 12)
|
||||
for minute in range(0, 60, 1)
|
||||
if not (hour == 9 and minute < 30) and not (hour == 11 and minute > 30)]
|
||||
|
||||
afternoon_times = [f"{trading_day} {hour:02d}:{minute:02d}"
|
||||
for hour in range(13, 16)
|
||||
for minute in range(0, 60, 1)]
|
||||
|
||||
return trading_day, morning_times + afternoon_times
|
||||
|
||||
trading_day, trading_times = get_trading_day_and_times(target_time)
|
||||
|
||||
# 模拟股票数据
|
||||
results = {}
|
||||
for code in codes:
|
||||
# 这里应该从ClickHouse或其他数据源获取真实数据
|
||||
# 现在使用模拟数据
|
||||
import random
|
||||
base_price = 10.0 + random.random() * 20.0
|
||||
change = (random.random() - 0.5) * 2.0
|
||||
|
||||
results[code] = {
|
||||
'price': round(base_price, 2),
|
||||
'change': round(change, 2),
|
||||
'name': f'股票{code}'
|
||||
}
|
||||
|
||||
return jsonify({
|
||||
'success': True,
|
||||
'data': results
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting stock quotes: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
@bp.route('/<stock_code>/kline')
|
||||
def get_stock_kline(stock_code):
|
||||
"""获取股票K线数据"""
|
||||
try:
|
||||
chart_type = request.args.get('type', 'daily')
|
||||
event_time_str = request.args.get('event_time')
|
||||
|
||||
if not event_time_str:
|
||||
return jsonify({'success': False, 'error': '请提供事件时间'}), 400
|
||||
|
||||
try:
|
||||
event_datetime = datetime.fromisoformat(event_time_str.replace('Z', '+00:00'))
|
||||
except ValueError:
|
||||
return jsonify({'success': False, 'error': '事件时间格式错误'}), 400
|
||||
|
||||
# 获取股票名称（这里简化处理）
|
||||
stock_name = f'股票{stock_code}'
|
||||
|
||||
if chart_type == 'daily':
|
||||
return get_daily_kline(stock_code, event_datetime, stock_name)
|
||||
elif chart_type == 'minute':
|
||||
return get_minute_kline(stock_code, event_datetime, stock_name)
|
||||
elif chart_type == 'timeline':
|
||||
return get_timeline_data(stock_code, event_datetime, stock_name)
|
||||
else:
|
||||
return jsonify({'error': f'Unsupported chart type: {chart_type}'}), 400
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting stock kline: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
def get_daily_kline(stock_code, event_datetime, stock_name):
|
||||
"""获取日K线数据"""
|
||||
try:
|
||||
# 模拟日K线数据
|
||||
data = []
|
||||
base_price = 10.0
|
||||
for i in range(30):
|
||||
date = (event_datetime - timedelta(days=30-i)).strftime('%Y-%m-%d')
|
||||
open_price = base_price + (i * 0.1) + (i % 3 - 1) * 0.5
|
||||
close_price = open_price + (i % 5 - 2) * 0.3
|
||||
high_price = max(open_price, close_price) + 0.2
|
||||
low_price = min(open_price, close_price) - 0.2
|
||||
volume = 1000000 + i * 50000
|
||||
|
||||
data.append({
|
||||
'date': date,
|
||||
'open': round(open_price, 2),
|
||||
'close': round(close_price, 2),
|
||||
'high': round(high_price, 2),
|
||||
'low': round(low_price, 2),
|
||||
'volume': volume
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'code': stock_code,
|
||||
'name': stock_name,
|
||||
'trade_date': event_datetime.strftime('%Y-%m-%d'),
|
||||
'data': data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting daily kline: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
def get_minute_kline(stock_code, event_datetime, stock_name):
|
||||
"""获取分钟K线数据"""
|
||||
try:
|
||||
# 模拟分钟K线数据
|
||||
data = []
|
||||
base_price = 10.0
|
||||
trading_times = []
|
||||
|
||||
# 生成交易时间
|
||||
for hour in range(9, 16):
|
||||
if hour == 12:
|
||||
continue
|
||||
for minute in range(0, 60):
|
||||
if (hour == 9 and minute < 30) or (hour == 11 and minute > 30):
|
||||
continue
|
||||
trading_times.append(f"{hour:02d}:{minute:02d}")
|
||||
|
||||
for i, time in enumerate(trading_times):
|
||||
open_price = base_price + (i * 0.01) + (i % 10 - 5) * 0.02
|
||||
close_price = open_price + (i % 7 - 3) * 0.01
|
||||
high_price = max(open_price, close_price) + 0.01
|
||||
low_price = min(open_price, close_price) - 0.01
|
||||
volume = 50000 + i * 1000
|
||||
|
||||
data.append({
|
||||
'time': time,
|
||||
'open': round(open_price, 2),
|
||||
'close': round(close_price, 2),
|
||||
'high': round(high_price, 2),
|
||||
'low': round(low_price, 2),
|
||||
'volume': volume
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'code': stock_code,
|
||||
'name': stock_name,
|
||||
'trade_date': event_datetime.strftime('%Y-%m-%d'),
|
||||
'data': data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting minute kline: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
|
||||
def get_timeline_data(stock_code, event_datetime, stock_name):
|
||||
"""获取分时图数据"""
|
||||
try:
|
||||
# 模拟分时图数据
|
||||
data = []
|
||||
base_price = 10.0
|
||||
trading_times = []
|
||||
|
||||
# 生成交易时间
|
||||
for hour in range(9, 16):
|
||||
if hour == 12:
|
||||
continue
|
||||
for minute in range(0, 60):
|
||||
if (hour == 9 and minute < 30) or (hour == 11 and minute > 30):
|
||||
continue
|
||||
trading_times.append(f"{hour:02d}:{minute:02d}")
|
||||
|
||||
for i, time in enumerate(trading_times):
|
||||
price = base_price + (i * 0.01) + (i % 10 - 5) * 0.02
|
||||
avg_price = price + (i % 5 - 2) * 0.01
|
||||
volume = 50000 + i * 1000
|
||||
|
||||
data.append({
|
||||
'time': time,
|
||||
'price': round(price, 2),
|
||||
'avg_price': round(avg_price, 2),
|
||||
'volume': volume
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'code': stock_code,
|
||||
'name': stock_name,
|
||||
'trade_date': event_datetime.strftime('%Y-%m-%d'),
|
||||
'data': data
|
||||
})
|
||||
|
||||
except Exception as e:
|
||||
print(f"Error getting timeline data: {e}")
|
||||
return jsonify({'success': False, 'error': str(e)}), 500
|
||||
6352
app_vx_copy1.py
6352
app_vx_copy1.py
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
125
concept_api.py
125
concept_api.py
@@ -22,15 +22,15 @@ openai_client = None
|
||||
mysql_pool = None
|
||||
|
||||
# 配置
|
||||
ES_HOST = 'http://127.0.0.1:9200'
|
||||
OPENAI_BASE_URL = "http://127.0.0.1:8000/v1"
|
||||
ES_HOST = 'http://192.168.1.58:9200'
|
||||
OPENAI_BASE_URL = "http://192.168.1.58:8000/v1"
|
||||
OPENAI_API_KEY = "dummy"
|
||||
EMBEDDING_MODEL = "qwen3-embedding-8b"
|
||||
INDEX_NAME = 'concept_library'
|
||||
|
||||
# MySQL配置
|
||||
MYSQL_CONFIG = {
|
||||
'host': '192.168.1.8',
|
||||
'host': '192.168.1.14',
|
||||
'user': 'root',
|
||||
'password': 'Zzl5588161!',
|
||||
'db': 'stock',
|
||||
@@ -110,7 +110,7 @@ class SearchRequest(BaseModel):
|
||||
semantic_weight: Optional[float] = Field(None, ge=0.0, le=1.0, description="语义搜索权重(0-1)，None表示自动计算")
|
||||
filter_stocks: Optional[List[str]] = Field(None, description="过滤特定股票代码或名称")
|
||||
trade_date: Optional[date] = Field(None, description="交易日期，格式：YYYY-MM-DD，默认返回最新日期数据")
|
||||
sort_by: str = Field("change_pct", description="排序方式: change_pct, _score, stock_count, concept_name, added_date")
|
||||
sort_by: str = Field("change_pct", description="排序方式: change_pct, _score, stock_count, concept_name")
|
||||
use_knn: bool = Field(True, description="是否使用KNN搜索优化语义搜索")
|
||||
|
||||
|
||||
@@ -490,7 +490,7 @@ def build_hybrid_knn_query(
|
||||
"field": "description_embedding",
|
||||
"query_vector": embedding,
|
||||
"k": k,
|
||||
"num_candidates": max(k + 50, min(k * 2, 10000)), # 确保 num_candidates > k，最大 10000
|
||||
"num_candidates": min(k * 2, 500),
|
||||
"boost": semantic_weight
|
||||
}
|
||||
}
|
||||
@@ -548,12 +548,12 @@ async def search_concepts(request: SearchRequest):
|
||||
# 已经在generate_embedding中记录了详细日志，这里只调整语义权重
|
||||
semantic_weight = 0
|
||||
|
||||
# 【关键修改】：如果按涨跌幅或添加日期排序，需要获取更多结果
|
||||
# 【关键修改】：如果按涨跌幅排序，需要获取更多结果
|
||||
effective_search_size = request.search_size
|
||||
if request.sort_by in ["change_pct", "added_date"]:
|
||||
# 按涨跌幅或添加日期排序时，获取更多结果以确保排序准确性
|
||||
if request.sort_by == "change_pct":
|
||||
# 按涨跌幅排序时，获取更多结果以确保排序准确性
|
||||
effective_search_size = min(1000, request.search_size * 10) # 最多获取1000个
|
||||
logger.info(f"Using expanded search size {effective_search_size} for {request.sort_by} sorting")
|
||||
logger.info(f"Using expanded search size {effective_search_size} for change_pct sorting")
|
||||
|
||||
# 构建查询体
|
||||
search_body = {}
|
||||
@@ -591,7 +591,7 @@ async def search_concepts(request: SearchRequest):
|
||||
"field": "description_embedding",
|
||||
"query_vector": embedding,
|
||||
"k": effective_search_size, # 使用有效搜索大小
|
||||
"num_candidates": max(effective_search_size + 50, min(effective_search_size * 2, 10000)) # 确保 num_candidates > k
|
||||
"num_candidates": min(effective_search_size * 2, 1000)
|
||||
},
|
||||
"size": effective_search_size
|
||||
}
|
||||
@@ -721,14 +721,6 @@ async def search_concepts(request: SearchRequest):
|
||||
all_results.sort(key=lambda x: x.stock_count, reverse=True)
|
||||
elif request.sort_by == "concept_name":
|
||||
all_results.sort(key=lambda x: x.concept)
|
||||
elif request.sort_by == "added_date":
|
||||
# 按添加日期排序（降序 - 最新的在前）
|
||||
all_results.sort(
|
||||
key=lambda x: (
|
||||
x.happened_times[0] if x.happened_times and len(x.happened_times) > 0 else '1900-01-01'
|
||||
),
|
||||
reverse=True
|
||||
)
|
||||
# _score排序已经由ES处理
|
||||
|
||||
# 计算分页
|
||||
@@ -1053,16 +1045,7 @@ async def get_concept_price_timeseries(
|
||||
):
|
||||
"""获取概念在指定日期范围内的涨跌幅时间序列数据"""
|
||||
if not mysql_pool:
|
||||
logger.warning(f"[PriceTimeseries] MySQL 连接不可用，返回空时间序列数据")
|
||||
# 返回空时间序列而不是 503 错误
|
||||
return PriceTimeSeriesResponse(
|
||||
concept_id=concept_id,
|
||||
concept_name=concept_id, # 无法查询名称，使用 ID
|
||||
start_date=start_date,
|
||||
end_date=end_date,
|
||||
data_points=0,
|
||||
timeseries=[]
|
||||
)
|
||||
raise HTTPException(status_code=503, detail="数据库连接不可用")
|
||||
|
||||
if start_date > end_date:
|
||||
raise HTTPException(status_code=400, detail="开始日期不能晚于结束日期")
|
||||
@@ -1167,93 +1150,11 @@ async def get_concept_statistics(
|
||||
min_stock_count: int = Query(3, ge=1, description="最少股票数量过滤")
|
||||
):
|
||||
"""获取概念板块统计数据 - 涨幅榜、跌幅榜、活跃榜、波动榜、连涨榜"""
|
||||
|
||||
from datetime import datetime, timedelta
|
||||
|
||||
# 如果 MySQL 不可用，直接返回示例数据（而不是返回 503）
|
||||
if not mysql_pool:
|
||||
logger.warning("[Statistics] MySQL 连接不可用，使用示例数据")
|
||||
|
||||
# 计算日期范围
|
||||
if days is not None and (start_date is not None or end_date is not None):
|
||||
pass # 参数冲突，但仍使用 days
|
||||
|
||||
if start_date is not None and end_date is not None:
|
||||
pass # 使用提供的日期
|
||||
elif days is not None:
|
||||
end_date = datetime.now().date()
|
||||
start_date = end_date - timedelta(days=days)
|
||||
elif start_date is not None:
|
||||
end_date = datetime.now().date()
|
||||
elif end_date is not None:
|
||||
start_date = end_date - timedelta(days=7)
|
||||
else:
|
||||
end_date = datetime.now().date()
|
||||
start_date = end_date - timedelta(days=7)
|
||||
|
||||
# 返回示例数据（与 except 块中相同）
|
||||
fallback_statistics = ConceptStatistics(
|
||||
hot_concepts=[
|
||||
ConceptStatItem(name="小米大模型", change_pct=12.45, stock_count=24, news_count=18),
|
||||
ConceptStatItem(name="人工智能", change_pct=8.76, stock_count=45, news_count=12),
|
||||
ConceptStatItem(name="新能源汽车", change_pct=6.54, stock_count=38, news_count=8),
|
||||
ConceptStatItem(name="芯片概念", change_pct=5.43, stock_count=52, news_count=15),
|
||||
ConceptStatItem(name="生物医药", change_pct=4.21, stock_count=28, news_count=6),
|
||||
],
|
||||
cold_concepts=[
|
||||
ConceptStatItem(name="房地产", change_pct=-5.76, stock_count=33, news_count=5),
|
||||
ConceptStatItem(name="煤炭开采", change_pct=-4.32, stock_count=25, news_count=3),
|
||||
ConceptStatItem(name="钢铁冶炼", change_pct=-3.21, stock_count=28, news_count=4),
|
||||
ConceptStatItem(name="传统零售", change_pct=-2.98, stock_count=19, news_count=2),
|
||||
ConceptStatItem(name="纺织服装", change_pct=-2.45, stock_count=15, news_count=2),
|
||||
],
|
||||
active_concepts=[
|
||||
ConceptStatItem(name="人工智能", news_count=45, report_count=15, total_mentions=60),
|
||||
ConceptStatItem(name="芯片概念", news_count=42, report_count=12, total_mentions=54),
|
||||
ConceptStatItem(name="新能源汽车", news_count=38, report_count=8, total_mentions=46),
|
||||
ConceptStatItem(name="生物医药", news_count=28, report_count=6, total_mentions=34),
|
||||
ConceptStatItem(name="量子科技", news_count=25, report_count=5, total_mentions=30),
|
||||
],
|
||||
volatile_concepts=[
|
||||
ConceptStatItem(name="区块链", volatility=25.6, avg_change=2.1, max_change=15.2),
|
||||
ConceptStatItem(name="元宇宙", volatility=23.8, avg_change=1.8, max_change=13.9),
|
||||
ConceptStatItem(name="虚拟现实", volatility=21.2, avg_change=-0.5, max_change=10.1),
|
||||
ConceptStatItem(name="游戏概念", volatility=19.7, avg_change=3.2, max_change=12.8),
|
||||
ConceptStatItem(name="在线教育", volatility=18.3, avg_change=-1.1, max_change=8.1),
|
||||
],
|
||||
momentum_concepts=[
|
||||
ConceptStatItem(name="数字经济", consecutive_days=6, total_change=19.2, avg_daily=3.2),
|
||||
ConceptStatItem(name="云计算", consecutive_days=5, total_change=16.8, avg_daily=3.36),
|
||||
ConceptStatItem(name="物联网", consecutive_days=4, total_change=13.1, avg_daily=3.28),
|
||||
ConceptStatItem(name="大数据", consecutive_days=4, total_change=12.4, avg_daily=3.1),
|
||||
ConceptStatItem(name="工业互联网", consecutive_days=3, total_change=9.6, avg_daily=3.2),
|
||||
],
|
||||
summary={
|
||||
'total_concepts': 500,
|
||||
'positive_count': 320,
|
||||
'negative_count': 180,
|
||||
'avg_change': 1.8,
|
||||
'update_time': datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
|
||||
'date_range': f"{start_date} 至 {end_date}",
|
||||
'days': (end_date - start_date).days + 1,
|
||||
'start_date': str(start_date),
|
||||
'end_date': str(end_date)
|
||||
}
|
||||
)
|
||||
|
||||
return ConceptStatisticsResponse(
|
||||
success=True,
|
||||
data=fallback_statistics,
|
||||
params={
|
||||
'days': (end_date - start_date).days + 1,
|
||||
'min_stock_count': min_stock_count,
|
||||
'start_date': str(start_date),
|
||||
'end_date': str(end_date)
|
||||
},
|
||||
note="MySQL 连接不可用，使用示例数据"
|
||||
)
|
||||
raise HTTPException(status_code=503, detail="数据库连接不可用")
|
||||
|
||||
try:
|
||||
from datetime import datetime, timedelta
|
||||
import random
|
||||
|
||||
# 参数验证和日期范围计算
|
||||
|
||||
118
craco.config.js
118
craco.config.js
@@ -2,9 +2,6 @@ const path = require('path');
|
||||
const webpack = require('webpack');
|
||||
const { BundleAnalyzerPlugin } = process.env.ANALYZE ? require('webpack-bundle-analyzer') : { BundleAnalyzerPlugin: null };
|
||||
|
||||
// 检查是否为 Mock 模式（与 src/utils/apiConfig.js 保持一致）
|
||||
const isMockMode = () => process.env.REACT_APP_ENABLE_MOCK === 'true';
|
||||
|
||||
module.exports = {
|
||||
webpack: {
|
||||
configure: (webpackConfig, { env, paths }) => {
|
||||
@@ -30,7 +27,7 @@ module.exports = {
|
||||
chunks: 'all',
|
||||
maxInitialRequests: 30,
|
||||
minSize: 20000,
|
||||
maxSize: 512000, // 限制单个 chunk 最大大小（512KB，与 performance.maxAssetSize 一致）
|
||||
maxSize: 244000, // 限制单个 chunk 最大大小（约 244KB）
|
||||
cacheGroups: {
|
||||
// React 核心库单独分离
|
||||
react: {
|
||||
@@ -39,13 +36,6 @@ module.exports = {
|
||||
priority: 30,
|
||||
reuseExistingChunk: true,
|
||||
},
|
||||
// TradingView Lightweight Charts 单独分离（避免被压缩破坏）
|
||||
lightweightCharts: {
|
||||
test: /[\\/]node_modules[\\/]lightweight-charts[\\/]/,
|
||||
name: 'lightweight-charts',
|
||||
priority: 26,
|
||||
reuseExistingChunk: true,
|
||||
},
|
||||
// 大型图表库分离（echarts, d3, apexcharts 等）
|
||||
charts: {
|
||||
test: /[\\/]node_modules[\\/](echarts|echarts-for-react|apexcharts|react-apexcharts|recharts|d3|d3-.*)[\\/]/,
|
||||
@@ -57,7 +47,7 @@ module.exports = {
|
||||
chakraUI: {
|
||||
test: /[\\/]node_modules[\\/](@chakra-ui|@emotion)[\\/]/,
|
||||
name: 'chakra-ui',
|
||||
priority: 23, // 从 22 改为 23，避免与 antd 优先级冲突
|
||||
priority: 22,
|
||||
reuseExistingChunk: true,
|
||||
},
|
||||
// Ant Design
|
||||
@@ -76,7 +66,7 @@ module.exports = {
|
||||
},
|
||||
// 日期/日历库
|
||||
calendar: {
|
||||
test: /[\\/]node_modules[\\/](dayjs|date-fns|@fullcalendar)[\\/]/,
|
||||
test: /[\\/]node_modules[\\/](moment|date-fns|@fullcalendar|react-big-calendar)[\\/]/,
|
||||
name: 'calendar-lib',
|
||||
priority: 18,
|
||||
reuseExistingChunk: true,
|
||||
@@ -103,43 +93,8 @@ module.exports = {
|
||||
moduleIds: 'deterministic',
|
||||
// 最小化配置
|
||||
minimize: true,
|
||||
minimizer: [
|
||||
...webpackConfig.optimization.minimizer,
|
||||
],
|
||||
};
|
||||
|
||||
// 配置 Terser 插件，保留 lightweight-charts 的方法名
|
||||
const TerserPlugin = require('terser-webpack-plugin');
|
||||
webpackConfig.optimization.minimizer = webpackConfig.optimization.minimizer.map(plugin => {
|
||||
if (plugin.constructor.name === 'TerserPlugin') {
|
||||
const originalOptions = plugin.options || {};
|
||||
const originalTerserOptions = originalOptions.terserOptions || {};
|
||||
const originalMangle = originalTerserOptions.mangle || {};
|
||||
|
||||
// 只保留 TerserPlugin 有效的配置项
|
||||
const validOptions = {
|
||||
test: originalOptions.test,
|
||||
include: originalOptions.include,
|
||||
exclude: originalOptions.exclude,
|
||||
extractComments: originalOptions.extractComments,
|
||||
parallel: originalOptions.parallel,
|
||||
minify: originalOptions.minify,
|
||||
terserOptions: {
|
||||
...originalTerserOptions,
|
||||
keep_classnames: /^(IChartApi|ISeriesApi|Re)$/, // 保留 lightweight-charts 的类名
|
||||
keep_fnames: /^(createChart|addLineSeries|addSeries)$/, // 保留关键方法名
|
||||
mangle: {
|
||||
...originalMangle,
|
||||
reserved: ['createChart', 'addLineSeries', 'addSeries', 'IChartApi', 'ISeriesApi'],
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
return new TerserPlugin(validOptions);
|
||||
}
|
||||
return plugin;
|
||||
});
|
||||
|
||||
// 生产环境禁用 source map 以加快构建（可节省 40-60% 时间）
|
||||
webpackConfig.devtool = false;
|
||||
} else {
|
||||
@@ -152,31 +107,14 @@ module.exports = {
|
||||
...webpackConfig.resolve,
|
||||
alias: {
|
||||
...webpackConfig.resolve.alias,
|
||||
// 根目录别名
|
||||
'@': path.resolve(__dirname, 'src'),
|
||||
|
||||
// 功能模块别名（按字母顺序）
|
||||
'@assets': path.resolve(__dirname, 'src/assets'),
|
||||
'@components': path.resolve(__dirname, 'src/components'),
|
||||
'@constants': path.resolve(__dirname, 'src/constants'),
|
||||
'@contexts': path.resolve(__dirname, 'src/contexts'),
|
||||
'@data': path.resolve(__dirname, 'src/data'),
|
||||
'@hooks': path.resolve(__dirname, 'src/hooks'),
|
||||
'@layouts': path.resolve(__dirname, 'src/layouts'),
|
||||
'@lib': path.resolve(__dirname, 'src/lib'),
|
||||
'@mocks': path.resolve(__dirname, 'src/mocks'),
|
||||
'@providers': path.resolve(__dirname, 'src/providers'),
|
||||
'@routes': path.resolve(__dirname, 'src/routes'),
|
||||
'@services': path.resolve(__dirname, 'src/services'),
|
||||
'@store': path.resolve(__dirname, 'src/store'),
|
||||
'@styles': path.resolve(__dirname, 'src/styles'),
|
||||
'@theme': path.resolve(__dirname, 'src/theme'),
|
||||
'@utils': path.resolve(__dirname, 'src/utils'),
|
||||
'@variables': path.resolve(__dirname, 'src/variables'),
|
||||
'@views': path.resolve(__dirname, 'src/views'),
|
||||
'@assets': path.resolve(__dirname, 'src/assets'),
|
||||
'@contexts': path.resolve(__dirname, 'src/contexts'),
|
||||
},
|
||||
// 减少文件扩展名搜索（优先 TypeScript）
|
||||
extensions: ['.ts', '.tsx', '.js', '.jsx', '.json'],
|
||||
// 减少文件扩展名搜索
|
||||
extensions: ['.js', '.jsx', '.json'],
|
||||
// 优化模块查找路径
|
||||
modules: [
|
||||
path.resolve(__dirname, 'src'),
|
||||
@@ -203,8 +141,13 @@ module.exports = {
|
||||
);
|
||||
}
|
||||
|
||||
// Day.js 的语言包非常小（每个约 0.5KB），所以不需要特别忽略
|
||||
// 如果需要优化，可以只导入需要的语言包
|
||||
// 忽略 moment 的语言包（如果项目使用了 moment）
|
||||
webpackConfig.plugins.push(
|
||||
new webpack.IgnorePlugin({
|
||||
resourceRegExp: /^\.\/locale$/,
|
||||
contextRegExp: /moment$/,
|
||||
})
|
||||
);
|
||||
|
||||
// ============== Loader 优化 ==============
|
||||
const babelLoaderRule = webpackConfig.module.rules.find(
|
||||
@@ -276,41 +219,14 @@ module.exports = {
|
||||
devMiddleware: {
|
||||
writeToDisk: false,
|
||||
},
|
||||
|
||||
// 调试日志
|
||||
onListening: (devServer) => {
|
||||
console.log(`[CRACO] Mock Mode: ${isMockMode() ? 'Enabled ✅' : 'Disabled ❌'}`);
|
||||
console.log(`[CRACO] Proxy: ${isMockMode() ? 'Disabled (MSW intercepts)' : 'Enabled (forwarding to backend)'}`);
|
||||
},
|
||||
|
||||
// 代理配置：将 /api 请求代理到后端服务器
|
||||
// 注意：Mock 模式下禁用 /api 和 /concept-api，让 MSW 拦截请求
|
||||
// 但 /bytedesk 始终启用（客服系统不走 Mock）
|
||||
proxy: {
|
||||
'/bytedesk': {
|
||||
target: 'https://valuefrontier.cn', // 统一使用生产环境 Nginx 代理
|
||||
'/api': {
|
||||
target: 'http://49.232.185.254:5001',
|
||||
changeOrigin: true,
|
||||
secure: false, // 开发环境禁用 HTTPS 严格验证
|
||||
secure: false,
|
||||
logLevel: 'debug',
|
||||
ws: true, // 支持 WebSocket
|
||||
// 不使用 pathRewrite，保留 /bytedesk 前缀，让生产 Nginx 处理
|
||||
},
|
||||
// Mock 模式下禁用其他代理
|
||||
...(isMockMode() ? {} : {
|
||||
'/api': {
|
||||
target: 'http://49.232.185.254:5001',
|
||||
changeOrigin: true,
|
||||
secure: false,
|
||||
logLevel: 'debug',
|
||||
},
|
||||
'/concept-api': {
|
||||
target: 'http://49.232.185.254:6801',
|
||||
changeOrigin: true,
|
||||
secure: false,
|
||||
logLevel: 'debug',
|
||||
pathRewrite: { '^/concept-api': '' },
|
||||
},
|
||||
}),
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
@@ -1,381 +0,0 @@
|
||||
# AI Agent 系统部署指南
|
||||
|
||||
## 🎯 系统架构
|
||||
|
||||
### 三阶段流程
|
||||
|
||||
```
|
||||
用户输入
|
||||
↓
|
||||
[阶段1: 计划制定 Planning]
|
||||
- LLM 分析用户需求
|
||||
- 确定需要哪些工具
|
||||
- 制定执行计划（steps）
|
||||
↓
|
||||
[阶段2: 工具执行 Execution]
|
||||
- 按计划顺序调用 MCP 工具
|
||||
- 收集数据
|
||||
- 异常处理和重试
|
||||
↓
|
||||
[阶段3: 结果总结 Summarization]
|
||||
- LLM 综合分析所有数据
|
||||
- 生成自然语言报告
|
||||
↓
|
||||
输出给用户
|
||||
```
|
||||
|
||||
## 📦 文件清单
|
||||
|
||||
### 后端文件
|
||||
|
||||
```
|
||||
mcp_server.py # MCP 工具服务器（已有）
|
||||
mcp_agent_system.py # Agent 系统核心逻辑（新增）
|
||||
mcp_config.py # 配置文件（已有）
|
||||
mcp_database.py # 数据库操作（已有）
|
||||
```
|
||||
|
||||
### 前端文件
|
||||
|
||||
```
|
||||
src/components/ChatBot/
|
||||
├── ChatInterfaceV2.js # 新版聊天界面（漂亮）
|
||||
├── PlanCard.js # 执行计划卡片
|
||||
├── StepResultCard.js # 步骤结果卡片（可折叠）
|
||||
├── ChatInterface.js # 旧版聊天界面（保留）
|
||||
├── MessageBubble.js # 消息气泡组件（保留）
|
||||
└── index.js # 统一导出
|
||||
|
||||
src/views/AgentChat/
|
||||
└── index.js # Agent 聊天页面
|
||||
```
|
||||
|
||||
## 🚀 部署步骤
|
||||
|
||||
### 1. 安装依赖
|
||||
|
||||
```bash
|
||||
# 进入项目目录
|
||||
cd /home/ubuntu/vf_react
|
||||
|
||||
# 安装 OpenAI SDK（支持多个LLM提供商）
|
||||
pip install openai
|
||||
```
|
||||
|
||||
### 2. 获取 LLM API Key
|
||||
|
||||
**推荐：通义千问（便宜且中文能力强）**
|
||||
|
||||
1. 访问 https://dashscope.console.aliyun.com/
|
||||
2. 注册/登录阿里云账号
|
||||
3. 开通 DashScope 服务
|
||||
4. 创建 API Key
|
||||
5. 复制 API Key（格式：`sk-xxx...`）
|
||||
|
||||
**其他选择**：
|
||||
- DeepSeek: https://platform.deepseek.com/ （最便宜）
|
||||
- OpenAI: https://platform.openai.com/ （需要翻墙）
|
||||
|
||||
### 3. 配置环境变量
|
||||
|
||||
```bash
|
||||
# 编辑环境变量
|
||||
sudo nano /etc/environment
|
||||
|
||||
# 添加以下内容（选择一个）
|
||||
# 方式1: 通义千问（推荐）
|
||||
DASHSCOPE_API_KEY="sk-your-key-here"
|
||||
|
||||
# 方式2: DeepSeek（更便宜）
|
||||
DEEPSEEK_API_KEY="sk-your-key-here"
|
||||
|
||||
# 方式3: OpenAI
|
||||
OPENAI_API_KEY="sk-your-key-here"
|
||||
|
||||
# 保存并退出，然后重新加载
|
||||
source /etc/environment
|
||||
|
||||
# 验证环境变量
|
||||
echo $DASHSCOPE_API_KEY
|
||||
```
|
||||
|
||||
### 4. 修改 mcp_server.py
|
||||
|
||||
在文件末尾（`if __name__ == "__main__":` 之前）添加：
|
||||
|
||||
```python
|
||||
# ==================== Agent 端点 ====================
|
||||
|
||||
from mcp_agent_system import MCPAgent, ChatRequest, AgentResponse
|
||||
|
||||
# 创建 Agent 实例
|
||||
agent = MCPAgent(provider="qwen") # 或 "deepseek", "openai"
|
||||
|
||||
@app.post("/agent/chat", response_model=AgentResponse)
|
||||
async def agent_chat(request: ChatRequest):
|
||||
"""智能代理对话端点"""
|
||||
logger.info(f"Agent chat: {request.message}")
|
||||
|
||||
# 获取工具列表和处理器
|
||||
tools = [tool.dict() for tool in TOOLS]
|
||||
|
||||
# 处理查询
|
||||
response = await agent.process_query(
|
||||
user_query=request.message,
|
||||
tools=tools,
|
||||
tool_handlers=TOOL_HANDLERS,
|
||||
)
|
||||
|
||||
return response
|
||||
```
|
||||
|
||||
### 5. 重启 MCP 服务
|
||||
|
||||
```bash
|
||||
# 如果使用 systemd
|
||||
sudo systemctl restart mcp-server
|
||||
|
||||
# 或者手动重启
|
||||
pkill -f mcp_server
|
||||
nohup uvicorn mcp_server:app --host 0.0.0.0 --port 8900 > mcp_server.log 2>&1 &
|
||||
|
||||
# 查看日志
|
||||
tail -f mcp_server.log
|
||||
```
|
||||
|
||||
### 6. 测试 Agent API
|
||||
|
||||
```bash
|
||||
# 测试 Agent 端点
|
||||
curl -X POST http://localhost:8900/agent/chat \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"message": "全面分析贵州茅台这只股票",
|
||||
"conversation_history": []
|
||||
}'
|
||||
|
||||
# 应该返回类似这样的JSON：
|
||||
# {
|
||||
# "success": true,
|
||||
# "message": "根据分析，贵州茅台...",
|
||||
# "plan": {
|
||||
# "goal": "全面分析贵州茅台",
|
||||
# "steps": [...]
|
||||
# },
|
||||
# "step_results": [...],
|
||||
# "metadata": {...}
|
||||
# }
|
||||
```
|
||||
|
||||
### 7. 部署前端
|
||||
|
||||
```bash
|
||||
# 在本地构建
|
||||
npm run build
|
||||
|
||||
# 上传到服务器
|
||||
scp -r build/* ubuntu@your-server:/var/www/valuefrontier.cn/
|
||||
|
||||
# 或者在服务器上构建
|
||||
cd /home/ubuntu/vf_react
|
||||
npm run build
|
||||
sudo cp -r build/* /var/www/valuefrontier.cn/
|
||||
```
|
||||
|
||||
### 8. 重启 Nginx
|
||||
|
||||
```bash
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
## ✅ 验证部署
|
||||
|
||||
### 1. 测试后端 API
|
||||
|
||||
```bash
|
||||
# 测试工具列表
|
||||
curl https://valuefrontier.cn/mcp/tools
|
||||
|
||||
# 测试 Agent
|
||||
curl -X POST https://valuefrontier.cn/mcp/agent/chat \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"message": "今日涨停股票有哪些",
|
||||
"conversation_history": []
|
||||
}'
|
||||
```
|
||||
|
||||
### 2. 测试前端
|
||||
|
||||
1. 访问 https://valuefrontier.cn/agent-chat
|
||||
2. 输入问题："全面分析贵州茅台这只股票"
|
||||
3. 观察：
|
||||
- ✓ 是否显示执行计划卡片
|
||||
- ✓ 是否显示步骤执行过程
|
||||
- ✓ 是否显示最终总结
|
||||
- ✓ 步骤结果卡片是否可折叠
|
||||
|
||||
### 3. 测试用例
|
||||
|
||||
```
|
||||
测试1: 简单查询
|
||||
输入：查询贵州茅台的股票信息
|
||||
预期：调用 get_stock_basic_info，返回基本信息
|
||||
|
||||
测试2: 深度分析（推荐）
|
||||
输入：全面分析贵州茅台这只股票
|
||||
预期：
|
||||
- 步骤1: get_stock_basic_info
|
||||
- 步骤2: get_stock_financial_index
|
||||
- 步骤3: get_stock_trade_data
|
||||
- 步骤4: search_china_news
|
||||
- 步骤5: summarize_with_llm
|
||||
|
||||
测试3: 市场热点
|
||||
输入：今日涨停股票有哪些亮点
|
||||
预期：
|
||||
- 步骤1: search_limit_up_stocks
|
||||
- 步骤2: get_concept_statistics
|
||||
- 步骤3: summarize_with_llm
|
||||
|
||||
测试4: 概念分析
|
||||
输入：新能源概念板块的投资机会
|
||||
预期：
|
||||
- 步骤1: search_concepts（新能源）
|
||||
- 步骤2: search_china_news（新能源）
|
||||
- 步骤3: summarize_with_llm
|
||||
```
|
||||
|
||||
## 🐛 故障排查
|
||||
|
||||
### 问题1: Agent 返回 "Provider not configured"
|
||||
|
||||
**原因**: 环境变量未设置
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 检查环境变量
|
||||
echo $DASHSCOPE_API_KEY
|
||||
|
||||
# 如果为空，重新设置
|
||||
export DASHSCOPE_API_KEY="sk-xxx..."
|
||||
|
||||
# 重启服务
|
||||
sudo systemctl restart mcp-server
|
||||
```
|
||||
|
||||
### 问题2: Agent 返回 JSON 解析错误
|
||||
|
||||
**原因**: LLM 没有返回正确的 JSON 格式
|
||||
|
||||
**解决**: 在 `mcp_agent_system.py` 中已经处理了代码块标记清理，如果还有问题：
|
||||
1. 检查 LLM 的 temperature 参数（建议 0.3）
|
||||
2. 检查 prompt 是否清晰
|
||||
3. 尝试不同的 LLM 提供商
|
||||
|
||||
### 问题3: 前端显示 "查询失败"
|
||||
|
||||
**原因**: 后端 API 未正确配置或 Nginx 代理问题
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 1. 检查 MCP 服务是否运行
|
||||
ps aux | grep mcp_server
|
||||
|
||||
# 2. 检查 Nginx 配置
|
||||
sudo nginx -t
|
||||
|
||||
# 3. 查看错误日志
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
tail -f /home/ubuntu/vf_react/mcp_server.log
|
||||
```
|
||||
|
||||
### 问题4: 执行步骤失败
|
||||
|
||||
**原因**: 某个 MCP 工具调用失败
|
||||
|
||||
**解决**: 查看步骤结果卡片中的错误信息，通常是：
|
||||
- API 超时：增加 timeout
|
||||
- 参数错误：检查工具定义
|
||||
- 数据库连接失败：检查数据库连接
|
||||
|
||||
## 💰 成本估算
|
||||
|
||||
### 使用通义千问（qwen-plus）
|
||||
|
||||
**价格**: ¥0.004/1000 tokens
|
||||
|
||||
**典型对话消耗**:
|
||||
- 简单查询（1步）: ~500 tokens = ¥0.002
|
||||
- 深度分析（5步）: ~3000 tokens = ¥0.012
|
||||
- 平均每次对话: ¥0.005
|
||||
|
||||
**月度成本**（1000次深度分析）:
|
||||
- 1000次 × ¥0.012 = ¥12
|
||||
|
||||
**结论**: 非常便宜！1000次深度分析只需要12元。
|
||||
|
||||
### 使用 DeepSeek（更便宜）
|
||||
|
||||
**价格**: ¥0.001/1000 tokens（比通义千问便宜4倍）
|
||||
|
||||
**月度成本**（1000次深度分析）:
|
||||
- 1000次 × ¥0.003 = ¥3
|
||||
|
||||
## 📊 监控和优化
|
||||
|
||||
### 1. 添加日志监控
|
||||
|
||||
```bash
|
||||
# 实时查看 Agent 日志
|
||||
tail -f mcp_server.log | grep -E "\[Agent\]|\[Planning\]|\[Execution\]|\[Summary\]"
|
||||
```
|
||||
|
||||
### 2. 性能优化建议
|
||||
|
||||
1. **缓存计划**: 相似的问题可以复用执行计划
|
||||
2. **并行执行**: 独立的工具调用可以并行执行
|
||||
3. **流式输出**: 使用 Server-Sent Events 实时返回进度
|
||||
4. **结果缓存**: 相同的工具调用结果可以缓存
|
||||
|
||||
### 3. 添加统计分析
|
||||
|
||||
在 `mcp_server.py` 中添加：
|
||||
|
||||
```python
|
||||
from datetime import datetime
|
||||
import json
|
||||
|
||||
# 记录每次 Agent 调用
|
||||
@app.post("/agent/chat")
|
||||
async def agent_chat(request: ChatRequest):
|
||||
start_time = datetime.now()
|
||||
|
||||
response = await agent.process_query(...)
|
||||
|
||||
duration = (datetime.now() - start_time).total_seconds()
|
||||
|
||||
# 记录到日志
|
||||
logger.info(f"Agent query completed in {duration:.2f}s", extra={
|
||||
"query": request.message,
|
||||
"steps": len(response.plan.steps) if response.plan else 0,
|
||||
"success": response.success,
|
||||
"duration": duration,
|
||||
})
|
||||
|
||||
return response
|
||||
```
|
||||
|
||||
## 🎉 完成！
|
||||
|
||||
现在你的 AI Agent 系统已经部署完成！
|
||||
|
||||
访问 https://valuefrontier.cn/agent-chat 开始使用。
|
||||
|
||||
**特点**:
|
||||
- ✅ 三阶段智能分析（计划-执行-总结）
|
||||
- ✅ 漂亮的UI界面（卡片式展示）
|
||||
- ✅ 步骤结果可折叠查看
|
||||
- ✅ 实时进度反馈
|
||||
- ✅ 异常处理和重试
|
||||
- ✅ 成本低廉（¥3-12/月）
|
||||
@@ -1,415 +0,0 @@
|
||||
# API 接口文档
|
||||
|
||||
本文档记录了项目中所有 API 接口的详细信息。
|
||||
|
||||
## 目录
|
||||
- [认证相关 API](#认证相关-api)
|
||||
- [个人中心相关 API](#个人中心相关-api)
|
||||
- [事件相关 API](#事件相关-api)
|
||||
- [股票相关 API](#股票相关-api)
|
||||
- [公司相关 API](#公司相关-api)
|
||||
- [订阅/支付相关 API](#订阅支付相关-api)
|
||||
|
||||
---
|
||||
|
||||
## 认证相关 API
|
||||
|
||||
### POST /api/auth/send-verification-code
|
||||
发送验证码到手机号或邮箱
|
||||
|
||||
**请求参数**:
|
||||
```json
|
||||
{
|
||||
"credential": "13800138000", // 手机号或邮箱
|
||||
"type": "phone", // 'phone' | 'email'
|
||||
"purpose": "login" // 'login' | 'register'
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"message": "验证码已发送到 13800138000",
|
||||
"dev_code": "123456" // 仅开发环境返回
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应**:
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"error": "发送验证码失败"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ✅ `src/mocks/handlers/auth.js` 行 21-44
|
||||
|
||||
**涉及文件**:
|
||||
- `src/components/Auth/AuthFormContent.js` 行 164-207
|
||||
|
||||
---
|
||||
|
||||
### POST /api/auth/login-with-code
|
||||
使用验证码登录（支持自动注册新用户）
|
||||
|
||||
**请求参数**:
|
||||
```json
|
||||
{
|
||||
"credential": "13800138000",
|
||||
"verification_code": "123456",
|
||||
"login_type": "phone" // 'phone' | 'email'
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"message": "登录成功",
|
||||
"isNewUser": false,
|
||||
"user": {
|
||||
"id": 1,
|
||||
"phone": "13800138000",
|
||||
"nickname": "用户昵称",
|
||||
"email": null,
|
||||
"avatar_url": "https://...",
|
||||
"has_wechat": false
|
||||
},
|
||||
"token": "mock_token_1_1234567890"
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应**:
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"error": "验证码错误"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ✅ `src/mocks/handlers/auth.js` 行 47-115
|
||||
|
||||
**涉及文件**:
|
||||
- `src/components/Auth/AuthFormContent.js` 行 252-327
|
||||
|
||||
**注意事项**:
|
||||
- 后端需要支持自动注册新用户（当用户不存在时）
|
||||
- 前端已添加 `.trim()` 防止空格问题
|
||||
|
||||
---
|
||||
|
||||
### GET /api/auth/session
|
||||
检查当前登录状态
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"isAuthenticated": true,
|
||||
"user": {
|
||||
"id": 1,
|
||||
"phone": "13800138000",
|
||||
"nickname": "用户昵称"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ✅ `src/mocks/handlers/auth.js` 行 269-290
|
||||
|
||||
---
|
||||
|
||||
### POST /api/auth/logout
|
||||
退出登录
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"message": "退出成功"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ✅ `src/mocks/handlers/auth.js` 行 317-329
|
||||
|
||||
---
|
||||
|
||||
## 个人中心相关 API
|
||||
|
||||
### GET /api/account/watchlist
|
||||
获取用户自选股列表
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"stock_code": "000001.SZ",
|
||||
"stock_name": "平安银行",
|
||||
"added_at": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建 `src/mocks/handlers/account.js`
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Dashboard/Center.js` 行 94
|
||||
|
||||
---
|
||||
|
||||
### GET /api/account/watchlist/realtime
|
||||
获取自选股实时行情
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"000001.SZ": {
|
||||
"price": 12.34,
|
||||
"change": 0.56,
|
||||
"change_percent": 4.76,
|
||||
"volume": 123456789
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Dashboard/Center.js` 行 133
|
||||
|
||||
---
|
||||
|
||||
### GET /api/account/events/following
|
||||
获取用户关注的事件列表
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"title": "事件标题",
|
||||
"followed_at": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Dashboard/Center.js` 行 95
|
||||
|
||||
---
|
||||
|
||||
### GET /api/account/events/comments
|
||||
获取用户的事件评论
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"event_id": 123,
|
||||
"content": "评论内容",
|
||||
"created_at": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Dashboard/Center.js` 行 96
|
||||
|
||||
---
|
||||
|
||||
### GET /api/subscription/current
|
||||
获取当前订阅信息
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"plan": "premium",
|
||||
"expires_at": "2025-01-01T00:00:00Z",
|
||||
"auto_renew": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建 `src/mocks/handlers/subscription.js`
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Dashboard/Center.js` 行 97
|
||||
|
||||
---
|
||||
|
||||
## 事件相关 API
|
||||
|
||||
### GET /api/events
|
||||
获取事件列表
|
||||
|
||||
**查询参数**:
|
||||
- `page`: 页码（默认 1）
|
||||
- `per_page`: 每页数量（默认 10）
|
||||
- `sort`: 排序方式 ('new' | 'hot' | 'returns')
|
||||
- `importance`: 重要性筛选 ('all' | 'high' | 'medium' | 'low')
|
||||
- `date_range`: 日期范围
|
||||
- `q`: 搜索关键词
|
||||
- `industry_classification`: 行业分类
|
||||
- `industry_code`: 行业代码
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"events": [
|
||||
{
|
||||
"id": 1,
|
||||
"title": "事件标题",
|
||||
"importance": "high",
|
||||
"created_at": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
],
|
||||
"pagination": {
|
||||
"page": 1,
|
||||
"per_page": 10,
|
||||
"total": 100
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ⚠️ 部分实现（需完善）
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Community/index.js` 行 148
|
||||
|
||||
---
|
||||
|
||||
### GET /api/events/:id
|
||||
获取事件详情
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"id": 1,
|
||||
"title": "事件标题",
|
||||
"content": "事件内容",
|
||||
"importance": "high",
|
||||
"created_at": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
---
|
||||
|
||||
### GET /api/events/:id/stocks
|
||||
获取事件相关股票
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"stock_code": "000001.SZ",
|
||||
"stock_name": "平安银行",
|
||||
"correlation": 0.85
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ✅ `src/mocks/handlers/event.js` 行 12-38
|
||||
|
||||
---
|
||||
|
||||
### GET /api/events/popular-keywords
|
||||
获取热门关键词
|
||||
|
||||
**查询参数**:
|
||||
- `limit`: 返回数量（默认 20）
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"keyword": "人工智能",
|
||||
"count": 123,
|
||||
"trend": "up"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Community/index.js` 行 180
|
||||
|
||||
---
|
||||
|
||||
### GET /api/events/hot
|
||||
获取热点事件
|
||||
|
||||
**查询参数**:
|
||||
- `days`: 天数范围（默认 5）
|
||||
- `limit`: 返回数量（默认 4）
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"title": "热点事件标题",
|
||||
"heat_score": 95.5
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据**: ❌ 待创建
|
||||
|
||||
**涉及文件**:
|
||||
- `src/views/Community/index.js` 行 192
|
||||
|
||||
---
|
||||
|
||||
## 待补充 API
|
||||
|
||||
以下 API 将在重构其他文件时逐步添加：
|
||||
|
||||
- 股票相关 API
|
||||
- 公司相关 API
|
||||
- 订阅/支付相关 API
|
||||
- 用户资料相关 API
|
||||
- 行业分类相关 API
|
||||
|
||||
---
|
||||
|
||||
## 更新日志
|
||||
|
||||
- 2024-XX-XX: 创建文档，记录认证和个人中心相关 API
|
||||
@@ -1,918 +0,0 @@
|
||||
# Bytedesk客服系统 - 前端工程师集成手册
|
||||
|
||||
**版本**: v1.0
|
||||
**最后更新**: 2025-01-07
|
||||
**适用项目**: vf_react
|
||||
**后端服务器**: http://43.143.189.195
|
||||
|
||||
---
|
||||
|
||||
## 📋 目录
|
||||
|
||||
- [1. 集成概述](#1-集成概述)
|
||||
- [2. 快速开始（5分钟集成）](#2-快速开始5分钟集成)
|
||||
- [3. 详细集成步骤](#3-详细集成步骤)
|
||||
- [4. 配置说明](#4-配置说明)
|
||||
- [5. 高级功能](#5-高级功能)
|
||||
- [6. 样式定制](#6-样式定制)
|
||||
- [7. 故障排查](#7-故障排查)
|
||||
- [8. 常见问题FAQ](#8-常见问题faq)
|
||||
- [9. 性能优化](#9-性能优化)
|
||||
- [10. 安全注意事项](#10-安全注意事项)
|
||||
|
||||
---
|
||||
|
||||
## 1. 集成概述
|
||||
|
||||
### 1.1 什么是Bytedesk客服系统？
|
||||
|
||||
Bytedesk是一个开源的在线客服系统，为您的网站提供实时客户服务功能。本手册将指导您将Bytedesk客服Widget集成到vf_react项目中。
|
||||
|
||||
### 1.2 集成架构
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────────────────┐
|
||||
│ vf_react前端项目 │
|
||||
│ ┌────────────────────────────────────────────────────┐ │
|
||||
│ │ App.jsx │ │
|
||||
│ │ ┌──────────────────────────────────────────────┐ │ │
|
||||
│ │ │ BytedeskWidget组件 │ │ │
|
||||
│ │ │ - 动态加载客服脚本 │ │ │
|
||||
│ │ │ - 显示悬浮客服图标 │ │ │
|
||||
│ │ │ - 处理用户交互 │ │ │
|
||||
│ │ └──────────────────────────────────────────────┘ │ │
|
||||
│ └────────────────────────────────────────────────────┘ │
|
||||
└────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
│ HTTP/WebSocket
|
||||
↓
|
||||
┌────────────────────────────────────────────────────────────┐
|
||||
│ Bytedesk后端服务 (43.143.189.195) │
|
||||
│ - API接口: :9003 │
|
||||
│ - WebSocket: :9885 │
|
||||
│ - Nginx反向代理: :80 │
|
||||
└────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 1.3 集成特点
|
||||
|
||||
- ✅ **零侵入**: 不修改vf_react原有代码逻辑
|
||||
- ✅ **即插即用**: 复制文件 + 修改配置即可使用
|
||||
- ✅ **样式隔离**: 使用Shadow DOM，不影响全局样式
|
||||
- ✅ **异步加载**: 不阻塞页面渲染
|
||||
- ✅ **跨页面**: 在所有页面显示客服图标
|
||||
- ✅ **响应式**: 自动适配移动端和PC端
|
||||
|
||||
---
|
||||
|
||||
## 2. 快速开始（5分钟集成）
|
||||
|
||||
### 步骤1: 复制集成文件
|
||||
|
||||
将`bytedesk-integration`文件夹复制到vf_react项目的`src/`目录下：
|
||||
|
||||
```bash
|
||||
# 在vf_react项目根目录执行
|
||||
cd D:\【Git】\vf_react
|
||||
cp -r bytedesk-integration src/
|
||||
```
|
||||
|
||||
文件结构：
|
||||
```
|
||||
vf_react/
|
||||
├── src/
|
||||
│ ├── bytedesk-integration/ # 客服集成文件夹
|
||||
│ │ ├── components/
|
||||
│ │ │ └── BytedeskWidget.jsx # 客服Widget组件
|
||||
│ │ ├── config/
|
||||
│ │ │ └── bytedesk.config.js # 配置文件
|
||||
│ │ ├── App.jsx.example # 集成示例代码
|
||||
│ │ ├── .env.bytedesk.example # 环境变量示例
|
||||
│ │ └── 前端工程师集成手册.md # 本手册
|
||||
│ ├── App.jsx # 您的主App文件
|
||||
│ └── ...
|
||||
└── package.json
|
||||
```
|
||||
|
||||
### 步骤2: 配置环境变量
|
||||
|
||||
复制环境变量模板到项目根目录并配置：
|
||||
|
||||
```bash
|
||||
# 复制模板
|
||||
cp src/bytedesk-integration/.env.bytedesk.example .env.local
|
||||
|
||||
# 编辑配置文件
|
||||
vim .env.local
|
||||
```
|
||||
|
||||
**必需配置项**（在.env.local中）:
|
||||
```bash
|
||||
# Bytedesk服务器地址
|
||||
REACT_APP_BYTEDESK_API_URL=http://43.143.189.195
|
||||
|
||||
# 组织ID（由管理员提供）
|
||||
REACT_APP_BYTEDESK_ORG=df_org_uid
|
||||
|
||||
# 工作组ID（由管理员提供）
|
||||
REACT_APP_BYTEDESK_SID=df_wg_aftersales
|
||||
```
|
||||
|
||||
> **注意**: ORG和SID需要从管理员处获取，或登录后台http://43.143.189.195/admin/查看。
|
||||
|
||||
### 步骤3: 集成到App.jsx
|
||||
|
||||
打开`src/App.jsx`，参考`App.jsx.example`添加以下代码：
|
||||
|
||||
```jsx
|
||||
// 1. 导入组件和配置（在文件顶部添加）
|
||||
import BytedeskWidget from './bytedesk-integration/components/BytedeskWidget';
|
||||
import { getBytedeskConfig } from './bytedesk-integration/config/bytedesk.config';
|
||||
|
||||
function App() {
|
||||
// 2. 获取配置
|
||||
const bytedeskConfig = getBytedeskConfig();
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的原有代码保持不变 */}
|
||||
|
||||
{/* 3. 添加客服Widget（在return的JSX最后添加） */}
|
||||
<BytedeskWidget
|
||||
config={bytedeskConfig}
|
||||
autoLoad={true}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default App;
|
||||
```
|
||||
|
||||
### 步骤4: 启动项目测试
|
||||
|
||||
```bash
|
||||
# 安装依赖（如果需要）
|
||||
npm install
|
||||
|
||||
# 启动开发服务器
|
||||
npm start
|
||||
```
|
||||
|
||||
打开浏览器，您应该在页面右下角看到客服图标（💬）。
|
||||
|
||||
---
|
||||
|
||||
## 3. 详细集成步骤
|
||||
|
||||
### 3.1 文件说明
|
||||
|
||||
#### BytedeskWidget.jsx
|
||||
React组件，负责加载和管理Bytedesk客服Widget。
|
||||
|
||||
**主要功能**:
|
||||
- 动态加载客服脚本（https://www.weiyuai.cn/embed/bytedesk-web.js）
|
||||
- 初始化客服Widget
|
||||
- 生命周期管理（加载、卸载、清理）
|
||||
- 错误处理
|
||||
|
||||
**Props**:
|
||||
```typescript
|
||||
interface BytedeskWidgetProps {
|
||||
config: Object; // 配置对象（必需）
|
||||
autoLoad?: boolean; // 是否自动加载（默认true）
|
||||
onLoad?: (bytedesk) => void; // 加载成功回调
|
||||
onError?: (error) => void; // 加载失败回调
|
||||
}
|
||||
```
|
||||
|
||||
#### bytedesk.config.js
|
||||
配置文件，包含客服系统的所有配置项。
|
||||
|
||||
**主要函数**:
|
||||
- `getBytedeskConfig()`: 获取基础配置
|
||||
- `getBytedeskConfigWithUser(user)`: 获取带用户信息的配置
|
||||
- `shouldShowCustomerService(pathname)`: 判断是否在当前页面显示客服
|
||||
|
||||
### 3.2 集成方式选择
|
||||
|
||||
根据您的需求，选择合适的集成方式：
|
||||
|
||||
#### 方式一: 全局集成（推荐）
|
||||
|
||||
**适用场景**: 所有页面都需要客服功能
|
||||
|
||||
```jsx
|
||||
import BytedeskWidget from './bytedesk-integration/components/BytedeskWidget';
|
||||
import { getBytedeskConfig } from './bytedesk-integration/config/bytedesk.config';
|
||||
|
||||
function App() {
|
||||
const bytedeskConfig = getBytedeskConfig();
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的页面内容 */}
|
||||
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
#### 方式二: 按页面显示
|
||||
|
||||
**适用场景**: 只在特定页面显示客服（如排除登录页、支付页）
|
||||
|
||||
```jsx
|
||||
import { useLocation } from 'react-router-dom';
|
||||
import BytedeskWidget from './bytedesk-integration/components/BytedeskWidget';
|
||||
import { getBytedeskConfig, shouldShowCustomerService } from './bytedesk-integration/config/bytedesk.config';
|
||||
|
||||
function App() {
|
||||
const location = useLocation();
|
||||
const bytedeskConfig = getBytedeskConfig();
|
||||
const showBytedesk = shouldShowCustomerService(location.pathname);
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的页面内容 */}
|
||||
|
||||
{showBytedesk && (
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
自定义页面规则（修改`bytedesk.config.js`）:
|
||||
|
||||
```javascript
|
||||
export const shouldShowCustomerService = (pathname) => {
|
||||
// 在以下页面显示客服
|
||||
const allowedPages = [
|
||||
'/',
|
||||
'/home',
|
||||
'/products',
|
||||
'/pricing',
|
||||
];
|
||||
|
||||
// 在以下页面隐藏客服
|
||||
const blockedPages = [
|
||||
'/login',
|
||||
'/register',
|
||||
'/payment',
|
||||
];
|
||||
|
||||
if (blockedPages.some(page => pathname.startsWith(page))) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return allowedPages.some(page => pathname.startsWith(page));
|
||||
};
|
||||
```
|
||||
|
||||
#### 方式三: 带用户信息集成
|
||||
|
||||
**适用场景**: 需要将登录用户信息传递给客服端
|
||||
|
||||
```jsx
|
||||
import { useContext } from 'react';
|
||||
import BytedeskWidget from './bytedesk-integration/components/BytedeskWidget';
|
||||
import { getBytedeskConfigWithUser } from './bytedesk-integration/config/bytedesk.config';
|
||||
import { AuthContext } from './contexts/AuthContext';
|
||||
|
||||
function App() {
|
||||
const { user } = useContext(AuthContext);
|
||||
const bytedeskConfig = getBytedeskConfigWithUser(user);
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的页面内容 */}
|
||||
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
用户信息格式:
|
||||
```javascript
|
||||
const user = {
|
||||
id: '12345', // 用户ID（必需）
|
||||
name: '张三', // 用户名
|
||||
email: 'user@example.com', // 邮箱
|
||||
mobile: '13800138000', // 手机号
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 配置说明
|
||||
|
||||
### 4.1 环境变量配置
|
||||
|
||||
在`.env.local`文件中配置（项目根目录）:
|
||||
|
||||
```bash
|
||||
# ========== 必需配置 ==========
|
||||
|
||||
# 后端服务地址
|
||||
REACT_APP_BYTEDESK_API_URL=http://43.143.189.195
|
||||
|
||||
# 组织ID
|
||||
REACT_APP_BYTEDESK_ORG=df_org_uid
|
||||
|
||||
# 工作组ID
|
||||
REACT_APP_BYTEDESK_SID=df_wg_aftersales
|
||||
|
||||
# ========== 可选配置 ==========
|
||||
|
||||
# 客服类型 (2=人工客服, 1=机器人)
|
||||
REACT_APP_BYTEDESK_TYPE=2
|
||||
|
||||
# 语言 (zh-cn, en, ja, ko)
|
||||
REACT_APP_BYTEDESK_LOCALE=zh-cn
|
||||
|
||||
# 图标位置 (bottom-right, bottom-left, top-right, top-left)
|
||||
REACT_APP_BYTEDESK_PLACEMENT=bottom-right
|
||||
|
||||
# 图标边距（像素）
|
||||
REACT_APP_BYTEDESK_MARGIN_BOTTOM=20
|
||||
REACT_APP_BYTEDESK_MARGIN_SIDE=20
|
||||
|
||||
# 主题模式 (system, light, dark)
|
||||
REACT_APP_BYTEDESK_THEME_MODE=system
|
||||
|
||||
# 主题色
|
||||
REACT_APP_BYTEDESK_THEME_COLOR=#0066FF
|
||||
|
||||
# 自动弹出（不推荐）
|
||||
REACT_APP_BYTEDESK_AUTO_POPUP=false
|
||||
```
|
||||
|
||||
### 4.2 代码配置
|
||||
|
||||
在`bytedesk.config.js`中直接修改:
|
||||
|
||||
```javascript
|
||||
export const bytedeskConfig = {
|
||||
// API服务地址
|
||||
apiUrl: 'http://43.143.189.195',
|
||||
htmlUrl: 'http://43.143.189.195/chat/',
|
||||
|
||||
// 客服图标位置
|
||||
placement: 'bottom-right',
|
||||
|
||||
// 边距设置
|
||||
marginBottom: 20,
|
||||
marginSide: 20,
|
||||
|
||||
// 自动弹出
|
||||
autoPopup: false,
|
||||
|
||||
// 语言设置
|
||||
locale: 'zh-cn',
|
||||
|
||||
// 客服图标配置
|
||||
bubbleConfig: {
|
||||
show: true,
|
||||
icon: '💬', // 可以使用emoji或图片URL
|
||||
title: '在线客服',
|
||||
subtitle: '点击咨询',
|
||||
},
|
||||
|
||||
// 主题配置
|
||||
theme: {
|
||||
mode: 'system', // light | dark | system
|
||||
backgroundColor: '#0066FF',
|
||||
textColor: '#ffffff',
|
||||
},
|
||||
|
||||
// 聊天配置
|
||||
chatConfig: {
|
||||
org: 'df_org_uid',
|
||||
t: '2', // 2=人工客服, 1=机器人
|
||||
sid: 'df_wg_aftersales',
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 高级功能
|
||||
|
||||
### 5.1 多工作组支持
|
||||
|
||||
根据页面显示不同工作组的客服：
|
||||
|
||||
```javascript
|
||||
// bytedesk.config.js
|
||||
export const getBytedeskConfigByPath = (pathname) => {
|
||||
const config = getBytedeskConfig();
|
||||
|
||||
// 根据路径选择工作组
|
||||
if (pathname.startsWith('/sales')) {
|
||||
return {
|
||||
...config,
|
||||
chatConfig: {
|
||||
...config.chatConfig,
|
||||
sid: 'df_wg_sales', // 销售组
|
||||
},
|
||||
};
|
||||
} else if (pathname.startsWith('/support')) {
|
||||
return {
|
||||
...config,
|
||||
chatConfig: {
|
||||
...config.chatConfig,
|
||||
sid: 'df_wg_support', // 技术支持组
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
return config; // 默认售后组
|
||||
};
|
||||
```
|
||||
|
||||
使用示例:
|
||||
```jsx
|
||||
import { useLocation } from 'react-router-dom';
|
||||
import { getBytedeskConfigByPath } from './bytedesk-integration/config/bytedesk.config';
|
||||
|
||||
function App() {
|
||||
const location = useLocation();
|
||||
const bytedeskConfig = getBytedeskConfigByPath(location.pathname);
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 5.2 条件性显示
|
||||
|
||||
根据用户登录状态或角色显示客服：
|
||||
|
||||
```jsx
|
||||
function App() {
|
||||
const { user } = useContext(AuthContext);
|
||||
const bytedeskConfig = getBytedeskConfig();
|
||||
|
||||
// 只为普通用户显示客服（管理员不显示）
|
||||
const showBytedesk = user && user.role === 'customer';
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{showBytedesk && (
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 5.3 事件回调
|
||||
|
||||
监听客服系统的加载状态：
|
||||
|
||||
```jsx
|
||||
function App() {
|
||||
const bytedeskConfig = getBytedeskConfig();
|
||||
|
||||
const handleLoad = (bytedesk) => {
|
||||
console.log('客服系统加载成功', bytedesk);
|
||||
// 可以在这里执行自定义逻辑
|
||||
// 例如: 发送统计事件
|
||||
};
|
||||
|
||||
const handleError = (error) => {
|
||||
console.error('客服系统加载失败', error);
|
||||
// 可以在这里显示降级方案
|
||||
// 例如: 显示备用联系方式
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
<BytedeskWidget
|
||||
config={bytedeskConfig}
|
||||
autoLoad={true}
|
||||
onLoad={handleLoad}
|
||||
onError={handleError}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 5.4 自定义触发按钮
|
||||
|
||||
隐藏默认图标，使用自定义按钮：
|
||||
|
||||
```jsx
|
||||
import { useState } from 'react';
|
||||
|
||||
function App() {
|
||||
const [showBytedesk, setShowBytedesk] = useState(false);
|
||||
|
||||
// 隐藏默认图标
|
||||
const bytedeskConfig = {
|
||||
...getBytedeskConfig(),
|
||||
bubbleConfig: {
|
||||
show: false, // 隐藏默认图标
|
||||
},
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 自定义按钮 */}
|
||||
<button
|
||||
onClick={() => setShowBytedesk(true)}
|
||||
className="custom-service-btn"
|
||||
>
|
||||
联系客服
|
||||
</button>
|
||||
|
||||
{showBytedesk && (
|
||||
<BytedeskWidget config={bytedeskConfig} autoLoad={true} />
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 样式定制
|
||||
|
||||
### 6.1 修改主题色
|
||||
|
||||
在配置中修改主题色：
|
||||
|
||||
```javascript
|
||||
// bytedesk.config.js
|
||||
theme: {
|
||||
mode: 'light',
|
||||
backgroundColor: '#FF6600', // 您的品牌色
|
||||
textColor: '#ffffff',
|
||||
},
|
||||
```
|
||||
|
||||
### 6.2 修改图标位置
|
||||
|
||||
```javascript
|
||||
// bytedesk.config.js
|
||||
placement: 'bottom-left', // 左下角
|
||||
marginBottom: 30, // 距底部30px
|
||||
marginSide: 30, // 距左侧30px
|
||||
```
|
||||
|
||||
### 6.3 使用自定义图标
|
||||
|
||||
使用图片URL替换emoji:
|
||||
|
||||
```javascript
|
||||
// bytedesk.config.js
|
||||
bubbleConfig: {
|
||||
show: true,
|
||||
icon: 'https://yourdomain.com/images/service-icon.png',
|
||||
title: '在线客服',
|
||||
subtitle: '点击咨询',
|
||||
},
|
||||
```
|
||||
|
||||
### 6.4 样式不冲突
|
||||
|
||||
Bytedesk Widget使用Shadow DOM技术，样式完全隔离，不会影响您的全局CSS。
|
||||
|
||||
---
|
||||
|
||||
## 7. 故障排查
|
||||
|
||||
### 7.1 客服图标不显示
|
||||
|
||||
**可能原因**:
|
||||
1. 环境变量未配置
|
||||
2. 配置文件路径错误
|
||||
3. 后端服务未启动
|
||||
4. 脚本加载失败
|
||||
|
||||
**解决方案**:
|
||||
```bash
|
||||
# 1. 检查.env.local文件是否存在
|
||||
ls -la .env.local
|
||||
|
||||
# 2. 检查环境变量是否加载
|
||||
console.log(process.env.REACT_APP_BYTEDESK_API_URL);
|
||||
|
||||
# 3. 检查后端服务状态
|
||||
curl http://43.143.189.195/api/health
|
||||
|
||||
# 4. 查看浏览器控制台错误
|
||||
# 打开浏览器开发者工具 -> Console标签页
|
||||
```
|
||||
|
||||
### 7.2 连接不上后端
|
||||
|
||||
**检查清单**:
|
||||
```bash
|
||||
# 1. 后端服务是否运行
|
||||
# 联系后端工程师确认docker容器状态
|
||||
|
||||
# 2. 防火墙是否开放
|
||||
# 确认80端口可访问
|
||||
|
||||
# 3. CORS配置
|
||||
# 后端需要在.env.production中添加您的前端地址:
|
||||
# BYTEDESK_CORS_ALLOWED_ORIGINS=http://your-frontend-domain.com
|
||||
```
|
||||
|
||||
### 7.3 ORG或SID错误
|
||||
|
||||
**获取正确配置**:
|
||||
1. 登录管理后台: http://43.143.189.195/admin/
|
||||
2. 导航到"设置" -> "组织信息"，复制`组织UID`
|
||||
3. 导航到"客服管理" -> "工作组"，复制`工作组ID`
|
||||
4. 更新`.env.local`文件
|
||||
5. 重启开发服务器: `npm start`
|
||||
|
||||
### 7.4 开发环境正常，生产环境异常
|
||||
|
||||
**检查清单**:
|
||||
```bash
|
||||
# 1. 确认生产环境的环境变量
|
||||
# 查看构建时的配置
|
||||
|
||||
# 2. 检查CORS配置
|
||||
# 后端需要添加生产域名到CORS白名单
|
||||
|
||||
# 3. 检查HTTPS/HTTP
|
||||
# 如果前端使用HTTPS，后端也应使用HTTPS
|
||||
|
||||
# 4. 查看生产环境日志
|
||||
npm run build
|
||||
# 检查构建产物中的配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 常见问题FAQ
|
||||
|
||||
### Q1: 客服系统会影响页面性能吗？
|
||||
|
||||
**A**: 不会。客服脚本采用异步加载，不会阻塞页面渲染。Widget总大小约50KB（gzip后），首次加载后会被浏览器缓存。
|
||||
|
||||
### Q2: 可以在移动端使用吗？
|
||||
|
||||
**A**: 可以。Bytedesk Widget完全响应式，自动适配移动端和PC端。
|
||||
|
||||
### Q3: 是否支持离线消息？
|
||||
|
||||
**A**: 支持。用户在客服离线时发送的消息会被保存，客服上线后可以查看。
|
||||
|
||||
### Q4: 可以集成到React Native吗？
|
||||
|
||||
**A**: BytedeskWidget是为Web设计的。React Native需要使用Bytedesk的原生SDK（另外提供）。
|
||||
|
||||
### Q5: 如何隐藏特定页面的客服？
|
||||
|
||||
**A**: 使用`shouldShowCustomerService`函数（见3.2节"方式二"）。
|
||||
|
||||
### Q6: 可以同时配置多个工作组吗？
|
||||
|
||||
**A**: 可以。参考5.1节"多工作组支持"。
|
||||
|
||||
### Q7: 用户信息是否安全？
|
||||
|
||||
**A**: 是的。所有通信使用WebSocket加密传输，用户信息不会被第三方获取。建议生产环境使用HTTPS。
|
||||
|
||||
### Q8: 是否需要付费？
|
||||
|
||||
**A**: Bytedesk社区版（当前使用）完全免费，License有效期至2040年12月31日。
|
||||
|
||||
---
|
||||
|
||||
## 9. 性能优化
|
||||
|
||||
### 9.1 按需加载
|
||||
|
||||
只在需要时加载客服系统：
|
||||
|
||||
```jsx
|
||||
import { useState, useEffect } from 'react';
|
||||
|
||||
function App() {
|
||||
const [loadBytedesk, setLoadBytedesk] = useState(false);
|
||||
|
||||
// 延迟5秒加载（页面渲染完成后）
|
||||
useEffect(() => {
|
||||
const timer = setTimeout(() => {
|
||||
setLoadBytedesk(true);
|
||||
}, 5000);
|
||||
|
||||
return () => clearTimeout(timer);
|
||||
}, []);
|
||||
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的页面内容 */}
|
||||
|
||||
{loadBytedesk && (
|
||||
<BytedeskWidget config={getBytedeskConfig()} autoLoad={true} />
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 9.2 Lazy Import
|
||||
|
||||
使用React.lazy延迟导入组件：
|
||||
|
||||
```jsx
|
||||
import { lazy, Suspense } from 'react';
|
||||
|
||||
const BytedeskWidget = lazy(() => import('./bytedesk-integration/components/BytedeskWidget'));
|
||||
|
||||
function App() {
|
||||
return (
|
||||
<div className="App">
|
||||
{/* 您的页面内容 */}
|
||||
|
||||
<Suspense fallback={null}>
|
||||
<BytedeskWidget config={getBytedeskConfig()} autoLoad={true} />
|
||||
</Suspense>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 9.3 缓存优化
|
||||
|
||||
客服脚本会自动被浏览器缓存，无需额外配置。
|
||||
|
||||
---
|
||||
|
||||
## 10. 安全注意事项
|
||||
|
||||
### 10.1 环境变量安全
|
||||
|
||||
```bash
|
||||
# ❌ 错误: 不要在代码中硬编码配置
|
||||
const config = {
|
||||
apiUrl: 'http://43.143.189.195',
|
||||
org: 'df_org_uid',
|
||||
};
|
||||
|
||||
# ✅ 正确: 使用环境变量
|
||||
const config = {
|
||||
apiUrl: process.env.REACT_APP_BYTEDESK_API_URL,
|
||||
org: process.env.REACT_APP_BYTEDESK_ORG,
|
||||
};
|
||||
```
|
||||
|
||||
### 10.2 敏感信息保护
|
||||
|
||||
```javascript
|
||||
// ❌ 不要传递敏感信息
|
||||
const user = {
|
||||
id: '12345',
|
||||
password: 'user-password', // 不要传递密码
|
||||
creditCard: '1234-5678', // 不要传递信用卡
|
||||
};
|
||||
|
||||
// ✅ 只传递必要信息
|
||||
const user = {
|
||||
id: '12345',
|
||||
name: '张三',
|
||||
email: 'user@example.com',
|
||||
};
|
||||
```
|
||||
|
||||
### 10.3 HTTPS使用
|
||||
|
||||
生产环境强烈建议使用HTTPS:
|
||||
|
||||
```bash
|
||||
# 开发环境
|
||||
REACT_APP_BYTEDESK_API_URL=http://43.143.189.195
|
||||
|
||||
# 生产环境
|
||||
REACT_APP_BYTEDESK_API_URL=https://kefu.yourdomain.com
|
||||
```
|
||||
|
||||
### 10.4 内容安全策略（CSP）
|
||||
|
||||
如果您的项目使用CSP，需要允许以下域名：
|
||||
|
||||
```html
|
||||
<meta http-equiv="Content-Security-Policy" content="
|
||||
default-src 'self';
|
||||
script-src 'self' https://www.weiyuai.cn;
|
||||
connect-src 'self' http://43.143.189.195;
|
||||
img-src 'self' data: http://43.143.189.195;
|
||||
"/>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. 获取帮助
|
||||
|
||||
### 11.1 联系方式
|
||||
|
||||
- **技术支持**: 访问 http://43.143.189.195/chat/ 在线咨询
|
||||
- **管理员**: 联系您的项目管理员获取ORG和SID
|
||||
- **后端工程师**: 联系后端团队确认服务器状态
|
||||
|
||||
### 11.2 日志查看
|
||||
|
||||
```javascript
|
||||
// 在浏览器控制台查看Bytedesk日志
|
||||
// 日志前缀为 [Bytedesk]
|
||||
|
||||
// 示例:
|
||||
[Bytedesk] 开始加载客服Widget...
|
||||
[Bytedesk] Widget脚本加载成功
|
||||
[Bytedesk] 初始化Widget
|
||||
[Bytedesk] Widget初始化成功
|
||||
```
|
||||
|
||||
### 11.3 调试技巧
|
||||
|
||||
```javascript
|
||||
// 1. 检查配置是否正确
|
||||
console.log('Bytedesk配置:', getBytedeskConfig());
|
||||
|
||||
// 2. 检查环境变量
|
||||
console.log('API URL:', process.env.REACT_APP_BYTEDESK_API_URL);
|
||||
console.log('ORG:', process.env.REACT_APP_BYTEDESK_ORG);
|
||||
console.log('SID:', process.env.REACT_APP_BYTEDESK_SID);
|
||||
|
||||
// 3. 检查Widget是否加载
|
||||
console.log('BytedeskWeb对象:', window.BytedeskWeb);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 12. 版本历史
|
||||
|
||||
| 版本 | 日期 | 更新内容 |
|
||||
|------|------|---------|
|
||||
| v1.0 | 2025-01-07 | 初始版本，支持基础集成功能 |
|
||||
|
||||
---
|
||||
|
||||
## 13. 附录
|
||||
|
||||
### 13.1 完整配置示例
|
||||
|
||||
```javascript
|
||||
// bytedesk.config.js - 完整配置
|
||||
export const bytedeskConfig = {
|
||||
apiUrl: 'http://43.143.189.195',
|
||||
htmlUrl: 'http://43.143.189.195/chat/',
|
||||
placement: 'bottom-right',
|
||||
marginBottom: 20,
|
||||
marginSide: 20,
|
||||
autoPopup: false,
|
||||
locale: 'zh-cn',
|
||||
bubbleConfig: {
|
||||
show: true,
|
||||
icon: '💬',
|
||||
title: '在线客服',
|
||||
subtitle: '点击咨询',
|
||||
},
|
||||
theme: {
|
||||
mode: 'system',
|
||||
backgroundColor: '#0066FF',
|
||||
textColor: '#ffffff',
|
||||
},
|
||||
chatConfig: {
|
||||
org: 'df_org_uid',
|
||||
t: '2',
|
||||
sid: 'df_wg_aftersales',
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
### 13.2 文件清单
|
||||
|
||||
集成所需的所有文件：
|
||||
|
||||
```
|
||||
bytedesk-integration/
|
||||
├── components/
|
||||
│ └── BytedeskWidget.jsx # React组件（必需）
|
||||
├── config/
|
||||
│ └── bytedesk.config.js # 配置文件（必需）
|
||||
├── App.jsx.example # 集成示例（参考）
|
||||
├── .env.bytedesk.example # 环境变量示例（参考）
|
||||
└── 前端工程师集成手册.md # 本手册（参考）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**祝您集成顺利！**
|
||||
|
||||
如有任何问题，请随时联系技术支持。
|
||||
File diff suppressed because it is too large
Load Diff
1197
docs/Community.md
1197
docs/Community.md
File diff suppressed because it is too large
Load Diff
@@ -1,294 +0,0 @@
|
||||
# 🌙 暗色模式适配 - 测试指南
|
||||
|
||||
## ✅ 完成的修改
|
||||
|
||||
### 修改文件
|
||||
|
||||
1. **`src/constants/notificationTypes.js`** - 添加暗色模式配置
|
||||
2. **`src/components/NotificationContainer/index.js`** - 更新颜色逻辑
|
||||
|
||||
### 新增配置
|
||||
|
||||
为每种通知类型添加了暗色模式专属配置：
|
||||
|
||||
| 配置项 | 亮色值 | 暗色值 | 说明 |
|
||||
|-------|-------|-------|------|
|
||||
| `bg` | `{color}.50` | `rgba(..., 0.15)` | 背景色：15% 透明度 |
|
||||
| `borderColor` | `{color}.400` | `{color}.400` | 边框色：保持一致 |
|
||||
| `iconColor` | `{color}.500` | `{color}.300` | 图标色：降低饱和度 |
|
||||
| `hoverBg` | `{color}.100` | `rgba(..., 0.25)` | Hover背景：25% 透明度 |
|
||||
|
||||
---
|
||||
|
||||
## 🧪 测试步骤
|
||||
|
||||
### 1. 启动应用
|
||||
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
|
||||
### 2. 切换到暗色模式
|
||||
|
||||
#### 方法 A：通过浏览器开发者工具
|
||||
|
||||
1. 打开浏览器开发者工具（F12）
|
||||
2. 切换到 "渲染" 或 "Rendering" 标签
|
||||
3. 找到 "Emulate CSS media feature prefers-color-scheme"
|
||||
4. 选择 "prefers-color-scheme: dark"
|
||||
|
||||
#### 方法 B：系统设置
|
||||
|
||||
1. 将你的操作系统切换到暗色模式
|
||||
2. 刷新页面
|
||||
|
||||
#### 方法 C：Chakra UI Color Mode Toggle
|
||||
|
||||
如果你的应用有主题切换按钮，直接点击切换即可。
|
||||
|
||||
### 3. 触发通知
|
||||
|
||||
**测试通知**：
|
||||
- 使用调试 API 发送测试通知：
|
||||
```javascript
|
||||
// 方式1: 使用调试工具（推荐）
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '测试通知',
|
||||
body: '验证暗色模式下的通知样式'
|
||||
});
|
||||
|
||||
// 方式2: 等待后端真实推送
|
||||
// 确保已连接后端，等待真实事件推送
|
||||
```
|
||||
|
||||
### 4. 验证效果
|
||||
|
||||
检查以下项目：
|
||||
|
||||
#### ✅ 背景色
|
||||
- [ ] **半透明效果**：背景应该是半透明的，能看到底层背景
|
||||
- [ ] **类型区分**：蓝、橙、紫、红、绿应该清晰可辨
|
||||
- [ ] **不刺眼**：不应该有过深的背景色
|
||||
|
||||
#### ✅ 文字颜色
|
||||
- [ ] **主标题**：`gray.100`（浅灰，不是纯白）
|
||||
- [ ] **副文本**：`gray.300`（更淡的灰）
|
||||
- [ ] **元信息**：`gray.500`（中等灰）
|
||||
|
||||
#### ✅ 图标颜色
|
||||
- [ ] 图标应该是 `.300` 色阶（柔和但清晰）
|
||||
- [ ] 不同类型有不同颜色
|
||||
|
||||
#### ✅ 边框
|
||||
- [ ] 边框清晰可见（`.400` 色阶）
|
||||
- [ ] 保持类型区分
|
||||
|
||||
#### ✅ Hover 效果
|
||||
- [ ] 鼠标悬停时背景加深（25% 透明度）
|
||||
- [ ] 有平滑过渡动画
|
||||
|
||||
---
|
||||
|
||||
## 🎨 视觉对比
|
||||
|
||||
### 亮色模式
|
||||
```
|
||||
┌─────────────────────────────────┐
|
||||
│ 🔵 蓝色浅背景 (blue.50) │
|
||||
│ 深色文字 (gray.800) │
|
||||
│ 明亮图标 (blue.500) │
|
||||
│ 边框清晰 (blue.400) │
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 暗色模式（修改后）
|
||||
```
|
||||
┌─────────────────────────────────┐
|
||||
│ 🔵 半透明蓝背景 (15% opacity) │
|
||||
│ 浅灰文字 (gray.100) │
|
||||
│ 柔和图标 (blue.300) │
|
||||
│ 边框可见 (blue.400) │
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 各类型通知配色
|
||||
|
||||
### 公告通知（蓝色）
|
||||
- **亮色**：`blue.50` 背景
|
||||
- **暗色**：`rgba(59, 130, 246, 0.15)` 半透明蓝
|
||||
|
||||
### 股票涨（红色）
|
||||
- **亮色**：`red.50` 背景
|
||||
- **暗色**：`rgba(239, 68, 68, 0.15)` 半透明红
|
||||
|
||||
### 股票跌（绿色）
|
||||
- **亮色**：`green.50` 背景
|
||||
- **暗色**：`rgba(34, 197, 94, 0.15)` 半透明绿
|
||||
|
||||
### 事件动向（橙色）
|
||||
- **亮色**：`orange.50` 背景
|
||||
- **暗色**：`rgba(249, 115, 22, 0.15)` 半透明橙
|
||||
|
||||
### 分析报告（紫色）
|
||||
- **亮色**：`purple.50` 背景
|
||||
- **暗色**：`rgba(168, 85, 247, 0.15)` 半透明紫
|
||||
|
||||
---
|
||||
|
||||
## 🔍 在浏览器控制台测试
|
||||
|
||||
### 手动触发各类型通知
|
||||
|
||||
> **注意**: Mock Socket 已移除，请使用调试工具或真实后端测试。
|
||||
|
||||
```javascript
|
||||
// 使用调试工具测试不同类型的通知
|
||||
// 确保已开启调试模式：REACT_APP_ENABLE_DEBUG=true
|
||||
|
||||
// 测试公告通知
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '测试公告通知',
|
||||
body: '这是暗色模式下的蓝色通知',
|
||||
tag: 'test_announcement',
|
||||
autoClose: 0,
|
||||
});
|
||||
|
||||
// 测试股票上涨（红色）
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '🔴 测试股票上涨',
|
||||
body: '宁德时代 +5.2%',
|
||||
tag: 'test_stock_up',
|
||||
});
|
||||
|
||||
// 测试股票下跌（绿色）
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '🟢 测试股票下跌',
|
||||
body: '比亚迪 -3.8%',
|
||||
tag: 'test_stock_down',
|
||||
});
|
||||
|
||||
// 测试事件动向（橙色）
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '🟠 测试事件动向',
|
||||
body: '央行宣布降准',
|
||||
tag: 'test_event',
|
||||
});
|
||||
|
||||
// 测试分析报告（紫色）
|
||||
window.__DEBUG__.notification.forceNotification({
|
||||
title: '🟣 测试分析报告',
|
||||
body: '医药行业深度报告',
|
||||
tag: 'test_report',
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q: 暗色模式下还是很深？
|
||||
|
||||
**A:** 检查配置是否正确应用：
|
||||
1. 清除浏览器缓存并刷新
|
||||
2. 确认 `notificationTypes.js` 包含 `darkBg` 等配置
|
||||
3. 在控制台查看元素的实际 `background` 值
|
||||
|
||||
### Q: 不同类型看起来都一样？
|
||||
|
||||
**A:** 确认：
|
||||
1. 透明度配置是否生效（应该看到半透明效果）
|
||||
2. 不同类型的 RGB 值是否不同
|
||||
3. 浏览器是否支持 `rgba()` 颜色
|
||||
|
||||
### Q: 文字看不清？
|
||||
|
||||
**A:** 调整文字颜色：
|
||||
- 主标题：`gray.100`（可调整为 `gray.50` 或 `white`）
|
||||
- 如果背景太淡，可以增加透明度（15% → 20%）
|
||||
|
||||
### Q: 如何微调透明度？
|
||||
|
||||
**A:** 在 `notificationTypes.js` 中修改 `rgba()` 的第 4 个参数：
|
||||
```javascript
|
||||
darkBg: 'rgba(59, 130, 246, 0.20)', // 从 0.15 改为 0.20
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 预期效果截图对比
|
||||
|
||||
### 亮色模式下的通知
|
||||
- 背景明亮（.50 色阶）
|
||||
- 文字深色（gray.800）
|
||||
- 图标鲜艳（.500 色阶）
|
||||
|
||||
### 暗色模式下的通知
|
||||
- 背景半透明（15% 透明度）
|
||||
- 文字浅色（gray.100）
|
||||
- 图标柔和（.300 色阶）
|
||||
- **保持类型区分度**
|
||||
|
||||
---
|
||||
|
||||
## 📊 技术参数
|
||||
|
||||
### 透明度参数
|
||||
|
||||
| 状态 | 透明度 | 说明 |
|
||||
|-----|-------|------|
|
||||
| 默认 | 15% | 背景色 |
|
||||
| Hover | 25% | 鼠标悬停 |
|
||||
|
||||
### 色阶选择
|
||||
|
||||
| 元素 | 亮色 | 暗色 | 原因 |
|
||||
|-----|------|------|------|
|
||||
| 背景 | .50 | rgba 15% | 保持通透感 |
|
||||
| 边框 | .400 | .400 | 确保可见 |
|
||||
| 图标 | .500 | .300 | 降低饱和度 |
|
||||
| 文字 | .800 | .100 | 保持对比度 |
|
||||
|
||||
---
|
||||
|
||||
## ✅ 测试检查清单
|
||||
|
||||
- [ ] 亮色模式下通知正常显示
|
||||
- [ ] 暗色模式下通知半透明效果
|
||||
- [ ] 5 种类型（蓝、红、绿、橙、紫）区分清晰
|
||||
- [ ] 文字在暗色背景上可读性良好
|
||||
- [ ] 图标颜色柔和但醒目
|
||||
- [ ] Hover 效果明显
|
||||
- [ ] 边框清晰可见
|
||||
- [ ] 亮色/暗色切换平滑
|
||||
|
||||
---
|
||||
|
||||
## 🚀 如果需要调整
|
||||
|
||||
如果效果不满意，可以调整以下参数：
|
||||
|
||||
### 调整透明度（`notificationTypes.js`）
|
||||
|
||||
```javascript
|
||||
// 增加对比度（背景更明显）
|
||||
darkBg: 'rgba(59, 130, 246, 0.25)', // 15% → 25%
|
||||
|
||||
// 减少对比度（更柔和）
|
||||
darkBg: 'rgba(59, 130, 246, 0.10)', // 15% → 10%
|
||||
```
|
||||
|
||||
### 调整文字颜色（`NotificationContainer/index.js`）
|
||||
|
||||
```javascript
|
||||
// 更亮的文字
|
||||
const textColor = useColorModeValue('gray.800', 'gray.50'); // gray.100 → gray.50
|
||||
|
||||
// 更柔和的文字
|
||||
const textColor = useColorModeValue('gray.800', 'gray.200'); // gray.100 → gray.200
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**测试完成后，请反馈效果！** 🎉
|
||||
@@ -1,648 +0,0 @@
|
||||
# VF React 自动化部署指南
|
||||
|
||||
## 📋 目录
|
||||
|
||||
- [概述](#概述)
|
||||
- [快速开始](#快速开始)
|
||||
- [详细使用说明](#详细使用说明)
|
||||
- [配置说明](#配置说明)
|
||||
- [故障排查](#故障排查)
|
||||
- [FAQ](#faq)
|
||||
|
||||
---
|
||||
|
||||
## 概述
|
||||
|
||||
本项目提供了完整的自动化部署方案，让您可以在本地电脑一键部署到生产环境，无需登录服务器。
|
||||
|
||||
### 核心特性
|
||||
|
||||
- ✅ **本地一键部署** - 运行 `npm run deploy` 即可完成部署
|
||||
- ✅ **智能备份** - 每次部署前自动备份，保留最近 5 个版本
|
||||
- ✅ **快速回滚** - 10 秒内回滚到任意历史版本
|
||||
- ✅ **企业微信通知** - 部署成功/失败实时推送消息
|
||||
- ✅ **安全可靠** - 部署前确认，失败自动回滚
|
||||
- ✅ **详细日志** - 完整记录每次部署过程
|
||||
|
||||
---
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 首次配置（5 分钟）
|
||||
|
||||
运行配置向导，按提示输入配置信息：
|
||||
|
||||
```bash
|
||||
npm run deploy:setup
|
||||
```
|
||||
|
||||
配置向导会询问：
|
||||
- 服务器地址和 SSH 信息
|
||||
- 部署路径配置
|
||||
- 企业微信通知配置（可选）
|
||||
|
||||
配置完成后会自动初始化服务器环境。
|
||||
|
||||
### 2. 日常部署（2-3 分钟）
|
||||
|
||||
```bash
|
||||
npm run deploy
|
||||
```
|
||||
|
||||
执行后会：
|
||||
1. 检查本地代码状态
|
||||
2. 显示部署预览，需要输入 `yes` 确认
|
||||
3. 自动连接服务器
|
||||
4. 拉取代码、构建、部署
|
||||
5. 发送企业微信通知
|
||||
|
||||
### 3. 回滚版本（10 秒）
|
||||
|
||||
回滚到上一个版本：
|
||||
```bash
|
||||
npm run rollback
|
||||
```
|
||||
|
||||
回滚到指定版本：
|
||||
```bash
|
||||
npm run rollback -- 2 # 回滚到前 2 个版本
|
||||
```
|
||||
|
||||
查看可回滚的版本列表：
|
||||
```bash
|
||||
npm run rollback -- list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 详细使用说明
|
||||
|
||||
### 首次配置
|
||||
|
||||
#### 运行配置向导
|
||||
|
||||
```bash
|
||||
npm run deploy:setup
|
||||
```
|
||||
|
||||
#### 配置过程
|
||||
|
||||
**1. 服务器配置**
|
||||
```
|
||||
请输入服务器 IP 或域名: your-server.com
|
||||
请输入 SSH 用户名 [ubuntu]: ubuntu
|
||||
请输入 SSH 端口 [22]: 22
|
||||
检测到 SSH 密钥: ~/.ssh/id_rsa
|
||||
是否使用该密钥? (y/n) [y]: y
|
||||
|
||||
正在测试 SSH 连接...
|
||||
✓ SSH 连接测试成功
|
||||
```
|
||||
|
||||
**2. 部署路径配置**
|
||||
```
|
||||
Git 仓库路径 [/home/ubuntu/vf_react]:
|
||||
生产环境路径 [/var/www/valuefrontier.cn]:
|
||||
备份目录 [/home/ubuntu/deployments]:
|
||||
日志目录 [/home/ubuntu/deploy-logs]:
|
||||
部署分支 [feature]:
|
||||
保留备份数量 [5]:
|
||||
```
|
||||
|
||||
**3. 企业微信通知配置**
|
||||
```
|
||||
是否启用企业微信通知? (y/n) [n]: y
|
||||
请输入企业微信 Webhook URL: https://qyapi.weixin.qq.com/...
|
||||
|
||||
正在测试企业微信通知...
|
||||
✓ 企业微信通知测试成功
|
||||
```
|
||||
|
||||
**4. 初始化服务器**
|
||||
```
|
||||
正在创建服务器目录...
|
||||
✓ 服务器目录创建完成
|
||||
设置脚本执行权限...
|
||||
✓ 服务器环境初始化完成
|
||||
```
|
||||
|
||||
### 部署到生产环境
|
||||
|
||||
#### 执行部署
|
||||
|
||||
```bash
|
||||
npm run deploy
|
||||
```
|
||||
|
||||
#### 部署流程
|
||||
|
||||
**步骤 1: 检查本地代码**
|
||||
```
|
||||
[1/8] 检查本地代码
|
||||
当前分支: feature
|
||||
最新提交: c93f689 - feat: 添加消息推送能力
|
||||
提交作者: qiye
|
||||
✓ 本地代码检查完成
|
||||
```
|
||||
|
||||
**步骤 2: 显示部署预览**
|
||||
```
|
||||
[2/8] 部署预览
|
||||
|
||||
╔════════════════════════════════════════════════════════════════╗
|
||||
║ 部署预览 ║
|
||||
╚════════════════════════════════════════════════════════════════╝
|
||||
|
||||
项目信息:
|
||||
项目名称: vf_react
|
||||
部署环境: 生产环境
|
||||
目标服务器: ubuntu@your-server.com
|
||||
|
||||
代码信息:
|
||||
当前分支: feature
|
||||
提交版本: c93f689
|
||||
提交信息: feat: 添加消息推送能力
|
||||
提交作者: qiye
|
||||
|
||||
部署路径:
|
||||
Git 仓库: /home/ubuntu/vf_react
|
||||
生产目录: /var/www/valuefrontier.cn
|
||||
|
||||
════════════════════════════════════════════════════════════════
|
||||
|
||||
确认部署到生产环境? (yes/no): yes
|
||||
```
|
||||
|
||||
**步骤 3-7: 自动执行部署**
|
||||
```
|
||||
[3/8] 测试 SSH 连接
|
||||
✓ SSH 连接成功
|
||||
|
||||
[4/8] 上传部署脚本
|
||||
✓ 部署脚本上传完成
|
||||
|
||||
[5/8] 执行远程部署
|
||||
|
||||
========================================
|
||||
服务器端部署脚本
|
||||
========================================
|
||||
|
||||
[INFO] 创建必要的目录...
|
||||
[SUCCESS] 目录创建完成
|
||||
[INFO] 检查 Git 仓库...
|
||||
[SUCCESS] Git 仓库检查通过
|
||||
[INFO] 切换到 feature 分支...
|
||||
[SUCCESS] 已在 feature 分支
|
||||
[INFO] 拉取最新代码...
|
||||
[SUCCESS] 代码更新完成
|
||||
[INFO] 安装依赖...
|
||||
[SUCCESS] 依赖检查完成
|
||||
[INFO] 构建项目...
|
||||
[SUCCESS] 构建完成
|
||||
[INFO] 备份当前版本...
|
||||
[SUCCESS] 备份完成: /home/ubuntu/deployments/backup-20250121-143020
|
||||
[INFO] 部署到生产环境...
|
||||
[SUCCESS] 部署完成
|
||||
[INFO] 清理旧备份...
|
||||
[SUCCESS] 旧备份清理完成
|
||||
|
||||
========================================
|
||||
部署成功！
|
||||
========================================
|
||||
提交: c93f689 - feat: 添加消息推送能力
|
||||
备份: /home/ubuntu/deployments/backup-20250121-143020
|
||||
耗时: 2分15秒
|
||||
|
||||
✓ 远程部署完成
|
||||
|
||||
[6/8] 发送部署通知
|
||||
✓ 企业微信通知已发送
|
||||
|
||||
[7/8] 清理临时文件
|
||||
✓ 清理完成
|
||||
|
||||
[8/8] 部署完成
|
||||
|
||||
╔════════════════════════════════════════════════════════════════╗
|
||||
║ 🎉 部署成功！ ║
|
||||
╚════════════════════════════════════════════════════════════════╝
|
||||
|
||||
部署信息:
|
||||
版本: c93f689
|
||||
分支: feature
|
||||
提交: feat: 添加消息推送能力
|
||||
作者: qiye
|
||||
时间: 2025-01-21 14:33:45
|
||||
耗时: 2分15秒
|
||||
|
||||
访问地址:
|
||||
https://valuefrontier.cn
|
||||
```
|
||||
|
||||
### 版本回滚
|
||||
|
||||
#### 查看可回滚的版本
|
||||
|
||||
```bash
|
||||
npm run rollback -- list
|
||||
```
|
||||
|
||||
输出：
|
||||
```
|
||||
可用的备份版本：
|
||||
|
||||
1. backup-20250121-153045 (2025-01-21 15:30:45) [当前版本]
|
||||
2. backup-20250121-150030 (2025-01-21 15:00:30)
|
||||
3. backup-20250121-143020 (2025-01-21 14:30:20)
|
||||
4. backup-20250121-140010 (2025-01-21 14:00:10)
|
||||
5. backup-20250121-133000 (2025-01-21 13:30:00)
|
||||
```
|
||||
|
||||
#### 回滚到上一个版本
|
||||
|
||||
```bash
|
||||
npm run rollback
|
||||
```
|
||||
|
||||
或指定版本：
|
||||
```bash
|
||||
npm run rollback -- 2 # 回滚到第 2 个版本
|
||||
```
|
||||
|
||||
#### 回滚流程
|
||||
|
||||
```
|
||||
╔════════════════════════════════════════════════════════════════╗
|
||||
║ 版本回滚工具 ║
|
||||
╚════════════════════════════════════════════════════════════════╝
|
||||
|
||||
可用的备份版本：
|
||||
1. backup-20250121-153045 (2025-01-21 15:30:45) [当前版本]
|
||||
2. backup-20250121-150030 (2025-01-21 15:00:30)
|
||||
3. backup-20250121-143020 (2025-01-21 14:30:20)
|
||||
|
||||
确认回滚到版本 #2? (yes/no): yes
|
||||
|
||||
[INFO] 正在执行回滚...
|
||||
|
||||
========================================
|
||||
服务器端回滚脚本
|
||||
========================================
|
||||
|
||||
[INFO] 开始回滚到版本 #2...
|
||||
[INFO] 目标版本: backup-20250121-150030
|
||||
[INFO] 清空生产目录: /var/www/valuefrontier.cn
|
||||
[INFO] 恢复备份文件...
|
||||
[SUCCESS] 回滚完成
|
||||
|
||||
========================================
|
||||
回滚成功！
|
||||
========================================
|
||||
目标版本: backup-20250121-150030
|
||||
|
||||
╔════════════════════════════════════════════════════════════════╗
|
||||
║ 🎉 回滚成功！ ║
|
||||
╚════════════════════════════════════════════════════════════════╝
|
||||
|
||||
回滚信息:
|
||||
目标版本: backup-20250121-150030
|
||||
回滚时间: 2025-01-21 15:35:20
|
||||
|
||||
访问地址:
|
||||
https://valuefrontier.cn
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置说明
|
||||
|
||||
### 配置文件位置
|
||||
|
||||
```
|
||||
.env.deploy # 部署配置文件（不提交到 Git）
|
||||
.env.deploy.example # 配置文件示例
|
||||
```
|
||||
|
||||
### 配置项说明
|
||||
|
||||
#### 服务器配置
|
||||
|
||||
```bash
|
||||
# 服务器 IP 或域名
|
||||
SERVER_HOST=your-server.com
|
||||
|
||||
# SSH 用户名
|
||||
SERVER_USER=ubuntu
|
||||
|
||||
# SSH 端口（默认 22）
|
||||
SERVER_PORT=22
|
||||
|
||||
# SSH 密钥路径（留空使用默认 ~/.ssh/id_rsa）
|
||||
SSH_KEY_PATH=
|
||||
```
|
||||
|
||||
#### 路径配置
|
||||
|
||||
```bash
|
||||
# 服务器上的 Git 仓库路径
|
||||
REMOTE_PROJECT_PATH=/home/ubuntu/vf_react
|
||||
|
||||
# 生产环境部署路径
|
||||
PRODUCTION_PATH=/var/www/valuefrontier.cn
|
||||
|
||||
# 部署备份目录
|
||||
BACKUP_DIR=/home/ubuntu/deployments
|
||||
|
||||
# 部署日志目录
|
||||
LOG_DIR=/home/ubuntu/deploy-logs
|
||||
```
|
||||
|
||||
#### Git 配置
|
||||
|
||||
```bash
|
||||
# 部署分支
|
||||
DEPLOY_BRANCH=feature
|
||||
```
|
||||
|
||||
#### 备份配置
|
||||
|
||||
```bash
|
||||
# 保留备份数量（超过会自动删除最旧的）
|
||||
KEEP_BACKUPS=5
|
||||
```
|
||||
|
||||
#### 企业微信通知配置
|
||||
|
||||
```bash
|
||||
# 是否启用企业微信通知
|
||||
ENABLE_WECHAT_NOTIFY=true
|
||||
|
||||
# 企业微信机器人 Webhook URL
|
||||
WECHAT_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxx
|
||||
|
||||
# 通知提及的用户（@all 或手机号/userid，逗号分隔）
|
||||
WECHAT_MENTIONED_LIST=@all
|
||||
```
|
||||
|
||||
#### 部署配置
|
||||
|
||||
```bash
|
||||
# 是否在部署前运行 npm install
|
||||
RUN_NPM_INSTALL=true
|
||||
|
||||
# 是否在部署前运行 npm test
|
||||
RUN_NPM_TEST=false
|
||||
|
||||
# 构建命令
|
||||
BUILD_COMMAND=npm run build
|
||||
```
|
||||
|
||||
### 修改配置
|
||||
|
||||
编辑配置文件：
|
||||
```bash
|
||||
vim .env.deploy
|
||||
```
|
||||
|
||||
或使用编辑器打开 `.env.deploy` 文件。
|
||||
|
||||
---
|
||||
|
||||
## 企业微信通知
|
||||
|
||||
### 配置企业微信机器人
|
||||
|
||||
1. **打开企业微信群聊**
|
||||
2. **添加群机器人**
|
||||
- 点击群设置（右上角 ···）
|
||||
- 选择"群机器人"
|
||||
- 点击"添加机器人"
|
||||
3. **设置机器人信息**
|
||||
- 输入机器人名称（如：部署通知机器人）
|
||||
- 复制 Webhook URL
|
||||
4. **配置到项目**
|
||||
- 将 Webhook URL 粘贴到 `.env.deploy` 文件的 `WECHAT_WEBHOOK_URL` 字段
|
||||
|
||||
### 通知内容
|
||||
|
||||
#### 部署成功通知
|
||||
```
|
||||
【生产环境部署成功】
|
||||
项目：vf_react
|
||||
环境：生产环境
|
||||
分支：feature
|
||||
版本：c93f689
|
||||
提交信息：feat: 添加消息推送能力
|
||||
部署时间：2025-01-21 14:33:45
|
||||
部署耗时：2分15秒
|
||||
操作人：qiye
|
||||
访问地址：https://valuefrontier.cn
|
||||
```
|
||||
|
||||
#### 部署失败通知
|
||||
```
|
||||
【⚠️ 生产环境部署失败】
|
||||
项目：vf_react
|
||||
环境：生产环境
|
||||
分支：feature
|
||||
失败原因：构建失败
|
||||
失败时间：2025-01-21 14:35:20
|
||||
操作人：qiye
|
||||
已自动回滚到上一版本
|
||||
```
|
||||
|
||||
#### 回滚成功通知
|
||||
```
|
||||
【版本回滚成功】
|
||||
项目：vf_react
|
||||
环境：生产环境
|
||||
回滚版本：backup-20250121-150030
|
||||
回滚时间：2025-01-21 15:35:20
|
||||
操作人：qiye
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 故障排查
|
||||
|
||||
### 常见问题
|
||||
|
||||
#### 1. SSH 连接失败
|
||||
|
||||
**错误信息**：
|
||||
```
|
||||
[✗] SSH 连接失败
|
||||
```
|
||||
|
||||
**可能原因**：
|
||||
- 服务器地址、用户名或端口配置错误
|
||||
- SSH 密钥未配置或路径错误
|
||||
- 服务器防火墙阻止连接
|
||||
|
||||
**解决方法**：
|
||||
1. 检查配置文件 `.env.deploy` 中的服务器信息
|
||||
2. 测试 SSH 连接：
|
||||
```bash
|
||||
ssh ubuntu@your-server.com
|
||||
```
|
||||
3. 确认 SSH 密钥已添加到服务器：
|
||||
```bash
|
||||
ssh-copy-id ubuntu@your-server.com
|
||||
```
|
||||
|
||||
#### 2. 构建失败
|
||||
|
||||
**错误信息**：
|
||||
```
|
||||
[ERROR] 构建失败
|
||||
npm run build exited with code 1
|
||||
```
|
||||
|
||||
**可能原因**：
|
||||
- 代码存在语法错误
|
||||
- 依赖包版本不兼容
|
||||
- Node.js 版本不匹配
|
||||
|
||||
**解决方法**：
|
||||
1. 在本地先运行构建测试：
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
2. 检查并修复错误
|
||||
3. 确认服务器 Node.js 版本：
|
||||
```bash
|
||||
ssh ubuntu@your-server.com "node -v"
|
||||
```
|
||||
|
||||
#### 3. 权限不足
|
||||
|
||||
**错误信息**：
|
||||
```
|
||||
[ERROR] 复制文件失败
|
||||
Permission denied
|
||||
```
|
||||
|
||||
**可能原因**：
|
||||
- 对生产目录没有写权限
|
||||
- 需要 sudo 权限
|
||||
|
||||
**解决方法**：
|
||||
1. 检查生产目录权限：
|
||||
```bash
|
||||
ssh ubuntu@your-server.com "ls -ld /var/www/valuefrontier.cn"
|
||||
```
|
||||
2. 修改目录所有者：
|
||||
```bash
|
||||
ssh ubuntu@your-server.com "sudo chown -R ubuntu:ubuntu /var/www/valuefrontier.cn"
|
||||
```
|
||||
|
||||
#### 4. 企业微信通知发送失败
|
||||
|
||||
**错误信息**：
|
||||
```
|
||||
[⚠] 企业微信通知发送失败
|
||||
```
|
||||
|
||||
**可能原因**：
|
||||
- Webhook URL 错误
|
||||
- 网络问题
|
||||
|
||||
**解决方法**：
|
||||
1. 检查 Webhook URL 是否正确
|
||||
2. 手动测试通知：
|
||||
```bash
|
||||
bash scripts/notify-wechat.sh test
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## FAQ
|
||||
|
||||
### Q1: 部署会影响正在访问网站的用户吗？
|
||||
|
||||
A: 部署过程中会有短暂的服务中断（约 1-2 秒），建议在流量较低时进行部署。
|
||||
|
||||
### Q2: 如果部署过程中网络断开怎么办？
|
||||
|
||||
A: 脚本会自动检测错误并停止部署。由于有自动备份，可以安全地重新运行部署或执行回滚。
|
||||
|
||||
### Q3: 可以同时部署多个项目吗？
|
||||
|
||||
A: 不建议。请等待当前部署完成后再部署其他项目。
|
||||
|
||||
### Q4: 备份文件占用空间过大怎么办？
|
||||
|
||||
A: 可以修改 `.env.deploy` 中的 `KEEP_BACKUPS` 配置，减少保留的备份数量。
|
||||
|
||||
### Q5: 如何查看详细的部署日志？
|
||||
|
||||
A: 部署日志保存在服务器上：
|
||||
```bash
|
||||
ssh ubuntu@your-server.com "cat /home/ubuntu/deploy-logs/deploy-YYYYMMDD-HHMMSS.log"
|
||||
```
|
||||
|
||||
### Q6: 可以在 Windows 上使用吗？
|
||||
|
||||
A: 可以。脚本使用标准的 Bash 命令，在 Git Bash 或 WSL 中都可以正常运行。
|
||||
|
||||
### Q7: 如何禁用企业微信通知？
|
||||
|
||||
A: 编辑 `.env.deploy` 文件，将 `ENABLE_WECHAT_NOTIFY` 设置为 `false`。
|
||||
|
||||
### Q8: 部署失败后是否需要手动回滚？
|
||||
|
||||
A: 不需要。如果构建失败，脚本会自动回滚到上一个版本。
|
||||
|
||||
---
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
vf_react/
|
||||
├── scripts/ # 部署脚本目录
|
||||
│ ├── setup-deployment.sh # 配置向导
|
||||
│ ├── deploy-from-local.sh # 本地部署脚本
|
||||
│ ├── deploy-on-server.sh # 服务器部署脚本
|
||||
│ ├── rollback-from-local.sh # 本地回滚脚本
|
||||
│ ├── rollback-on-server.sh # 服务器回滚脚本
|
||||
│ └── notify-wechat.sh # 企业微信通知脚本
|
||||
├── .env.deploy.example # 配置文件示例
|
||||
├── .env.deploy # 配置文件（不提交到 Git）
|
||||
├── DEPLOYMENT.md # 本文档
|
||||
└── package.json # 包含部署命令
|
||||
```
|
||||
|
||||
**服务器目录结构**：
|
||||
```
|
||||
/home/ubuntu/
|
||||
├── vf_react/ # Git 仓库
|
||||
│ └── build/ # 构建产物
|
||||
├── deployments/ # 版本备份
|
||||
│ ├── backup-20250121-143020/
|
||||
│ ├── backup-20250121-150030/
|
||||
│ └── current -> backup-20250121-150030
|
||||
└── deploy-logs/ # 部署日志
|
||||
└── deploy-20250121-143020.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 命令速查表
|
||||
|
||||
| 命令 | 说明 |
|
||||
|------|------|
|
||||
| `npm run deploy:setup` | 首次配置部署环境 |
|
||||
| `npm run deploy` | 部署到生产环境 |
|
||||
| `npm run rollback` | 回滚到上一个版本 |
|
||||
| `npm run rollback -- 2` | 回滚到前 2 个版本 |
|
||||
| `npm run rollback -- list` | 查看可回滚的版本列表 |
|
||||
|
||||
---
|
||||
|
||||
## 支持
|
||||
|
||||
如有问题，请联系开发团队或提交 Issue。
|
||||
|
||||
---
|
||||
|
||||
**祝部署顺利！** 🎉
|
||||
@@ -1,70 +0,0 @@
|
||||
# 🚀 部署快速上手指南
|
||||
|
||||
## 首次使用（5 分钟）
|
||||
|
||||
### 步骤 1: 运行配置向导
|
||||
```bash
|
||||
npm run deploy:setup
|
||||
```
|
||||
|
||||
按提示输入以下信息：
|
||||
- 服务器地址：`你的服务器IP或域名`
|
||||
- SSH 用户名：`ubuntu`
|
||||
- SSH 端口：`22`
|
||||
- SSH 密钥：按 `y` 使用默认密钥
|
||||
- 企业微信通知：按 `y` 启用（或按 `n` 跳过）
|
||||
|
||||
配置完成！✅
|
||||
|
||||
---
|
||||
|
||||
## 日常部署（2 分钟）
|
||||
|
||||
### 步骤 1: 部署到生产环境
|
||||
```bash
|
||||
npm run deploy
|
||||
```
|
||||
|
||||
### 步骤 2: 确认部署
|
||||
看到部署预览后，输入 `yes` 确认
|
||||
|
||||
等待 2-3 分钟，部署完成！🎉
|
||||
|
||||
---
|
||||
|
||||
## 如果出问题了
|
||||
|
||||
### 立即回滚
|
||||
```bash
|
||||
npm run rollback
|
||||
```
|
||||
|
||||
输入 `yes` 确认，10 秒内恢复！
|
||||
|
||||
---
|
||||
|
||||
## 常用命令
|
||||
|
||||
```bash
|
||||
# 部署
|
||||
npm run deploy
|
||||
|
||||
# 回滚
|
||||
npm run rollback
|
||||
|
||||
# 查看可回滚的版本
|
||||
npm run rollback -- list
|
||||
|
||||
# 重新配置
|
||||
npm run deploy:setup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 需要帮助？
|
||||
|
||||
查看完整文档：[DEPLOYMENT.md](./DEPLOYMENT.md)
|
||||
|
||||
---
|
||||
|
||||
**就这么简单！** ✨
|
||||
@@ -1,376 +0,0 @@
|
||||
# 环境配置指南
|
||||
|
||||
本文档详细说明项目的环境配置和启动方式。
|
||||
|
||||
## 📊 环境模式总览
|
||||
|
||||
| 模式 | 命令 | Mock | 后端位置 | PostHog | 适用场景 |
|
||||
|------|------|------|---------|---------|---------|
|
||||
| **本地混合** | `npm start` | ✅ 智能穿透 | 远程 | 可选双模式 | 日常前端开发（推荐） |
|
||||
| **本地全栈** | `npm run start:test` | ❌ | 本地 | 可选双模式 | 后端调试、性能测试 |
|
||||
| **远程开发** | `npm run start:dev` | ❌ | 远程 | 可选双模式 | 联调真实后端 |
|
||||
| **纯 Mock** | `npm run start:mock` | ✅ 完全拦截 | 无 | 可选双模式 | 前端完全独立开发 |
|
||||
| **生产构建** | `npm run build` | ❌ | 生产服务器 | ✅ 仅上报 | 部署上线 |
|
||||
|
||||
---
|
||||
|
||||
## 1️⃣ 本地混合模式（推荐）
|
||||
|
||||
### 启动命令
|
||||
```bash
|
||||
npm start
|
||||
# 或
|
||||
npm run start:local
|
||||
```
|
||||
|
||||
### 配置文件
|
||||
`.env.local`
|
||||
|
||||
### 特点
|
||||
- 🎯 **MSW 智能拦截**：
|
||||
- 已定义 Mock 的接口 → 返回 Mock 数据
|
||||
- 未定义 Mock 的接口 → 自动转发到远程后端
|
||||
- 💡 **最佳效率**：前端独立开发，部分依赖真实数据
|
||||
- 🚀 **快速迭代**：无需等待后端，无需本地运行后端
|
||||
- 🔄 **自动端口清理**：启动前自动清理 3000 端口
|
||||
|
||||
### 适用场景
|
||||
- ✅ 日常前端 UI 开发
|
||||
- ✅ 页面布局调整
|
||||
- ✅ 组件开发测试
|
||||
- ✅ 样式优化
|
||||
|
||||
### 工作流程
|
||||
```bash
|
||||
# 1. 启动项目
|
||||
npm start
|
||||
|
||||
# 2. 观察控制台
|
||||
# ✅ MSW 启动成功
|
||||
# ✅ PostHog 初始化
|
||||
# ✅ 拦截日志显示
|
||||
|
||||
# 3. 开发测试
|
||||
# - Mock 接口：立即返回假数据
|
||||
# - 真实接口：请求远程后端
|
||||
```
|
||||
|
||||
### PostHog 配置
|
||||
编辑 `.env.local`：
|
||||
```env
|
||||
# 仅控制台 debug（初期开发）
|
||||
REACT_APP_POSTHOG_KEY=
|
||||
|
||||
# 控制台 + PostHog Cloud（完整测试）
|
||||
REACT_APP_POSTHOG_KEY=phc_your_test_key_here
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2️⃣ 本地全栈模式
|
||||
|
||||
### 启动命令
|
||||
```bash
|
||||
npm run start:test
|
||||
```
|
||||
|
||||
### 配置文件
|
||||
`.env.test`
|
||||
|
||||
### 特点
|
||||
- 🖥️ **前后端都在本地**：
|
||||
- 前端：localhost:3000
|
||||
- 后端：localhost:5001
|
||||
- 🗄️ **本地数据库**：数据隔离，不影响团队
|
||||
- 🔍 **完整调试**：可以打断点调试后端代码
|
||||
- 📊 **性能分析**：测试数据库查询、接口性能
|
||||
|
||||
### 适用场景
|
||||
- ✅ 调试后端 Python 代码
|
||||
- ✅ 测试数据库查询优化
|
||||
- ✅ 性能测试和压力测试
|
||||
- ✅ 离线开发（无网络）
|
||||
- ✅ 数据迁移脚本测试
|
||||
|
||||
### 工作流程
|
||||
```bash
|
||||
# 1. 启动全栈（自动启动前后端）
|
||||
npm run start:test
|
||||
|
||||
# 观察日志：
|
||||
# [backend] Flask 服务器启动在 5001 端口
|
||||
# [frontend] React 启动在 3000 端口
|
||||
|
||||
# 2. 或手动分别启动
|
||||
# 终端 1
|
||||
python app_2.py
|
||||
|
||||
# 终端 2
|
||||
npm run frontend:test
|
||||
```
|
||||
|
||||
### 注意事项
|
||||
- ⚠️ 确保本地安装了 Python 环境
|
||||
- ⚠️ 确保安装了 requirements.txt 中的依赖
|
||||
- ⚠️ 确保本地数据库已配置
|
||||
|
||||
---
|
||||
|
||||
## 3️⃣ 远程开发模式
|
||||
|
||||
### 启动命令
|
||||
```bash
|
||||
npm run start:dev
|
||||
```
|
||||
|
||||
### 配置文件
|
||||
`.env.development`
|
||||
|
||||
### 特点
|
||||
- 🌐 **连接远程后端**：http://49.232.185.254:5001
|
||||
- 📡 **真实数据**：远程开发数据库
|
||||
- 🤝 **团队协作**：与后端团队联调
|
||||
- ⚡ **无需本地后端**：专注前端开发
|
||||
|
||||
### 适用场景
|
||||
- ✅ 联调后端最新代码
|
||||
- ✅ 测试真实数据表现
|
||||
- ✅ 验证接口文档
|
||||
- ✅ 跨服务功能测试
|
||||
|
||||
### 工作流程
|
||||
```bash
|
||||
# 1. 启动前端（连接远程后端）
|
||||
npm run start:dev
|
||||
|
||||
# 2. 观察控制台
|
||||
# ✅ 所有请求发送到远程服务器
|
||||
# ✅ 无 MSW 拦截
|
||||
|
||||
# 3. 联调测试
|
||||
# - 测试最新后端接口
|
||||
# - 反馈问题给后端团队
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4️⃣ 纯 Mock 模式
|
||||
|
||||
### 启动命令
|
||||
```bash
|
||||
npm run start:mock
|
||||
```
|
||||
|
||||
### 配置文件
|
||||
`.env.mock`
|
||||
|
||||
### 特点
|
||||
- 📦 **完全 Mock**：所有请求都被 MSW 拦截
|
||||
- ⚡ **完全离线**：无需任何后端服务
|
||||
- 🎨 **纯前端**：专注 UI/UX 开发
|
||||
|
||||
### 适用场景
|
||||
- ✅ 后端接口未开发完成
|
||||
- ✅ 完全独立的前端开发
|
||||
- ✅ UI 原型展示
|
||||
|
||||
---
|
||||
|
||||
## 🔧 PostHog 配置说明
|
||||
|
||||
### 双模式运行
|
||||
|
||||
PostHog 支持两种模式：
|
||||
|
||||
#### 模式 1：仅控制台 Debug（推荐初期）
|
||||
```env
|
||||
REACT_APP_POSTHOG_KEY= # 留空
|
||||
```
|
||||
|
||||
**效果：**
|
||||
- ✅ 控制台打印所有事件日志
|
||||
- ✅ 验证事件触发逻辑
|
||||
- ✅ 检查事件属性
|
||||
- ❌ 不实际发送到 PostHog 服务器
|
||||
|
||||
**控制台输出示例：**
|
||||
```javascript
|
||||
✅ PostHog initialized successfully
|
||||
📊 PostHog Analytics initialized
|
||||
📍 Event tracked: community_page_viewed { ... }
|
||||
```
|
||||
|
||||
#### 模式 2：控制台 + PostHog Cloud（完整测试）
|
||||
```env
|
||||
REACT_APP_POSTHOG_KEY=phc_your_test_key_here
|
||||
```
|
||||
|
||||
**效果：**
|
||||
- ✅ 控制台打印所有事件日志
|
||||
- ✅ 同时发送到 PostHog Cloud
|
||||
- ✅ 在 PostHog Dashboard 查看 Live Events
|
||||
- ✅ 测试完整的分析功能
|
||||
|
||||
### 获取 PostHog API Key
|
||||
|
||||
1. 登录 PostHog：https://app.posthog.com
|
||||
2. 创建项目（建议创建独立的测试项目）
|
||||
3. 进入项目设置 → Project API Key
|
||||
4. 复制 API Key（格式：`phc_xxxxxxxxxxxxxx`）
|
||||
5. 填入对应环境的 `.env` 文件
|
||||
|
||||
### 推荐配置
|
||||
|
||||
```bash
|
||||
# 本地开发（.env.local）
|
||||
REACT_APP_POSTHOG_KEY= # 留空，仅控制台
|
||||
|
||||
# 测试环境（.env.test）
|
||||
REACT_APP_POSTHOG_KEY=phc_test_key # 测试项目 Key
|
||||
|
||||
# 开发环境（.env.development）
|
||||
REACT_APP_POSTHOG_KEY=phc_dev_key # 开发项目 Key
|
||||
|
||||
# 生产环境（.env）
|
||||
REACT_APP_POSTHOG_KEY=phc_prod_key # 生产项目 Key
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 端口管理
|
||||
|
||||
### 自动清理 3000 端口
|
||||
|
||||
所有 `npm start` 命令会自动执行 `prestart` 钩子，清理 3000 端口：
|
||||
|
||||
```bash
|
||||
# 自动执行
|
||||
npm start
|
||||
# → 先执行 kill-port 3000
|
||||
# → 再执行 craco start
|
||||
```
|
||||
|
||||
### 手动清理端口
|
||||
|
||||
```bash
|
||||
npm run kill-port
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 环境变量文件说明
|
||||
|
||||
| 文件 | 提交Git | 用途 | 优先级 |
|
||||
|------|--------|------|--------|
|
||||
| `.env` | ✅ | 生产环境 | 低 |
|
||||
| `.env.local` | ✅ | 本地混合模式 | 高 |
|
||||
| `.env.test` | ✅ | 本地测试环境 | 高 |
|
||||
| `.env.development` | ✅ | 远程开发环境 | 中 |
|
||||
| `.env.mock` | ✅ | 纯 Mock 模式 | 中 |
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q1: 端口 3000 被占用
|
||||
|
||||
**解决方案：**
|
||||
```bash
|
||||
# 方案 1：自动清理（推荐）
|
||||
npm start # 会自动清理
|
||||
|
||||
# 方案 2：手动清理
|
||||
npm run kill-port
|
||||
```
|
||||
|
||||
### Q2: PostHog 事件没有上报
|
||||
|
||||
**检查清单：**
|
||||
1. 检查 `REACT_APP_POSTHOG_KEY` 是否填写
|
||||
2. 打开浏览器控制台，查看是否有初始化日志
|
||||
3. 检查网络面板，是否有请求发送到 PostHog
|
||||
4. 登录 PostHog Dashboard → Live Events 查看
|
||||
|
||||
### Q3: Mock 数据没有生效
|
||||
|
||||
**检查清单：**
|
||||
1. 确认 `REACT_APP_ENABLE_MOCK=true`
|
||||
2. 检查控制台是否显示 "MSW enabled"
|
||||
3. 检查 `src/mocks/handlers/` 中是否定义了对应接口
|
||||
4. 查看浏览器控制台的 MSW 拦截日志
|
||||
|
||||
### Q4: 本地全栈模式启动失败
|
||||
|
||||
**可能原因：**
|
||||
1. Python 环境未安装
|
||||
2. 后端依赖未安装：`pip install -r requirements.txt`
|
||||
3. 数据库未配置
|
||||
4. 端口 5001 被占用：`lsof -ti:5001 | xargs kill -9`
|
||||
|
||||
### Q5: 环境变量不生效
|
||||
|
||||
**解决方案：**
|
||||
1. 重启开发服务器（React 不会热更新环境变量）
|
||||
2. 检查环境变量名称是否以 `REACT_APP_` 开头
|
||||
3. 确认使用了正确的 `.env` 文件
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 新成员入职
|
||||
|
||||
```bash
|
||||
# 1. 克隆项目
|
||||
git clone <repository>
|
||||
cd vf_react
|
||||
|
||||
# 2. 安装依赖
|
||||
npm install
|
||||
|
||||
# 3. 启动项目（默认本地混合模式）
|
||||
npm start
|
||||
|
||||
# 4. 浏览器访问
|
||||
# http://localhost:3000
|
||||
```
|
||||
|
||||
### 日常开发流程
|
||||
|
||||
```bash
|
||||
# 早上启动
|
||||
npm start
|
||||
|
||||
# 开发中...
|
||||
# - 修改代码
|
||||
# - 热更新自动生效
|
||||
# - 查看控制台日志
|
||||
|
||||
# 需要调试后端时
|
||||
npm run start:test
|
||||
|
||||
# 需要联调时
|
||||
npm run start:dev
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [PostHog 集成文档](./POSTHOG_INTEGRATION.md)
|
||||
- [PostHog 事件追踪文档](./POSTHOG_EVENT_TRACKING.md)
|
||||
- [项目配置说明](./CLAUDE.md)
|
||||
|
||||
---
|
||||
|
||||
## 🤝 团队协作建议
|
||||
|
||||
1. **统一环境**：团队成员使用相同的启动命令
|
||||
2. **独立测试**：测试新功能时使用 `start:test` 隔离数据
|
||||
3. **及时反馈**：发现接口问题及时在群里反馈
|
||||
4. **代码审查**：提交前检查是否误提交 API Key
|
||||
|
||||
---
|
||||
|
||||
**最后更新：** 2025-01-15
|
||||
**维护者：** 前端团队
|
||||
@@ -1,309 +0,0 @@
|
||||
# MCP 架构说明
|
||||
|
||||
## 🎯 MCP 是什么？
|
||||
|
||||
**MCP (Model Context Protocol)** 是一个**工具调用协议**，它的核心职责是：
|
||||
|
||||
1. ✅ **定义工具接口**：告诉 LLM 有哪些工具可用，每个工具需要什么参数
|
||||
2. ✅ **执行工具调用**：根据请求调用对应的后端 API
|
||||
3. ✅ **返回结构化数据**：将 API 结果返回给调用方
|
||||
|
||||
**MCP 不负责**：
|
||||
- ❌ 自然语言理解（NLU）
|
||||
- ❌ 意图识别
|
||||
- ❌ 结果总结
|
||||
- ❌ 对话管理
|
||||
|
||||
## 📊 当前架构
|
||||
|
||||
### 方案 1：简单关键词匹配（已实现）
|
||||
|
||||
```
|
||||
用户输入："查询贵州茅台的股票信息"
|
||||
↓
|
||||
前端 ChatInterface (关键词匹配)
|
||||
↓
|
||||
MCP 工具层 (search_china_news)
|
||||
↓
|
||||
返回 JSON 数据
|
||||
↓
|
||||
前端显示原始数据
|
||||
```
|
||||
|
||||
**问题**：
|
||||
- ✗ 只能识别简单关键词
|
||||
- ✗ 无法理解复杂意图
|
||||
- ✗ 返回的是原始 JSON，用户体验差
|
||||
|
||||
### 方案 2：集成 LLM（推荐）
|
||||
|
||||
```
|
||||
用户输入："查询贵州茅台的股票信息"
|
||||
↓
|
||||
LLM (Claude/GPT-4/通义千问)
|
||||
↓ 理解意图：需要查询股票代码 600519 的基本信息
|
||||
↓ 选择工具：get_stock_basic_info
|
||||
↓ 提取参数：{"seccode": "600519"}
|
||||
MCP 工具层
|
||||
↓ 调用 API，获取数据
|
||||
返回结构化数据
|
||||
↓
|
||||
LLM 总结结果
|
||||
↓ "贵州茅台（600519）是中国知名的白酒生产企业，
|
||||
当前股价 1650.00 元，市值 2.07 万亿..."
|
||||
前端显示自然语言回复
|
||||
```
|
||||
|
||||
**优势**：
|
||||
- ✓ 理解复杂意图
|
||||
- ✓ 自动选择合适的工具
|
||||
- ✓ 自然语言总结，用户体验好
|
||||
- ✓ 支持多轮对话
|
||||
|
||||
## 🔧 实现方案
|
||||
|
||||
### 选项 A：前端集成 LLM（快速实现）
|
||||
|
||||
**适用场景**：快速原型、小规模应用
|
||||
|
||||
**优点**：
|
||||
- 实现简单
|
||||
- 无需修改后端
|
||||
|
||||
**缺点**：
|
||||
- API Key 暴露在前端（安全风险）
|
||||
- 每个用户都消耗 API 额度
|
||||
- 无法统一管理和监控
|
||||
|
||||
**实现步骤**：
|
||||
|
||||
1. 修改 `src/components/ChatBot/ChatInterface.js`：
|
||||
|
||||
```javascript
|
||||
import { llmService } from '../../services/llmService';
|
||||
|
||||
const handleSendMessage = async () => {
|
||||
// ...
|
||||
|
||||
// 使用 LLM 服务替代简单的 mcpService.chat
|
||||
const response = await llmService.chat(inputValue, messages);
|
||||
|
||||
// ...
|
||||
};
|
||||
```
|
||||
|
||||
2. 配置 API Key（在 `.env.local`）：
|
||||
|
||||
```bash
|
||||
REACT_APP_OPENAI_API_KEY=sk-xxx...
|
||||
# 或者使用通义千问（更便宜）
|
||||
REACT_APP_DASHSCOPE_API_KEY=sk-xxx...
|
||||
```
|
||||
|
||||
### 选项 B：后端集成 LLM（生产推荐）⭐
|
||||
|
||||
**适用场景**：生产环境、需要安全和性能
|
||||
|
||||
**优点**：
|
||||
- ✓ API Key 安全（不暴露给前端）
|
||||
- ✓ 统一管理和监控
|
||||
- ✓ 可以做缓存优化
|
||||
- ✓ 可以做速率限制
|
||||
|
||||
**缺点**：
|
||||
- 需要修改后端
|
||||
- 增加服务器成本
|
||||
|
||||
**实现步骤**：
|
||||
|
||||
#### 1. 安装依赖
|
||||
|
||||
```bash
|
||||
pip install openai
|
||||
```
|
||||
|
||||
#### 2. 修改 `mcp_server.py`，添加聊天端点
|
||||
|
||||
在文件末尾添加：
|
||||
|
||||
```python
|
||||
from mcp_chat_endpoint import MCPChatAssistant, ChatRequest, ChatResponse
|
||||
|
||||
# 创建聊天助手实例
|
||||
chat_assistant = MCPChatAssistant(provider="qwen") # 推荐使用通义千问
|
||||
|
||||
@app.post("/chat", response_model=ChatResponse)
|
||||
async def chat_endpoint(request: ChatRequest):
|
||||
"""智能对话端点 - 使用LLM理解意图并调用工具"""
|
||||
logger.info(f"Chat request: {request.message}")
|
||||
|
||||
# 获取可用工具列表
|
||||
tools = [tool.dict() for tool in TOOLS]
|
||||
|
||||
# 调用聊天助手
|
||||
response = await chat_assistant.chat(
|
||||
user_message=request.message,
|
||||
conversation_history=request.conversation_history,
|
||||
tools=tools,
|
||||
)
|
||||
|
||||
return response
|
||||
```
|
||||
|
||||
#### 3. 配置环境变量
|
||||
|
||||
在服务器上设置：
|
||||
|
||||
```bash
|
||||
# 方式1：使用通义千问（推荐，价格便宜）
|
||||
export DASHSCOPE_API_KEY="sk-xxx..."
|
||||
|
||||
# 方式2：使用 OpenAI
|
||||
export OPENAI_API_KEY="sk-xxx..."
|
||||
|
||||
# 方式3：使用 DeepSeek（最便宜）
|
||||
export DEEPSEEK_API_KEY="sk-xxx..."
|
||||
```
|
||||
|
||||
#### 4. 修改前端 `mcpService.js`
|
||||
|
||||
```javascript
|
||||
/**
|
||||
* 智能对话 - 使用后端LLM处理
|
||||
*/
|
||||
async chat(userMessage, conversationHistory = []) {
|
||||
try {
|
||||
const response = await this.client.post('/chat', {
|
||||
message: userMessage,
|
||||
conversation_history: conversationHistory,
|
||||
});
|
||||
|
||||
return {
|
||||
success: true,
|
||||
data: response,
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
success: false,
|
||||
error: error.message || '对话处理失败',
|
||||
};
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 5. 修改前端 `ChatInterface.js`
|
||||
|
||||
```javascript
|
||||
const handleSendMessage = async () => {
|
||||
// ...
|
||||
|
||||
try {
|
||||
// 调用后端聊天API
|
||||
const response = await mcpService.chat(inputValue, messages);
|
||||
|
||||
if (response.success) {
|
||||
const botMessage = {
|
||||
id: Date.now() + 1,
|
||||
content: response.data.message, // LLM总结的自然语言
|
||||
isUser: false,
|
||||
type: 'text',
|
||||
timestamp: new Date().toISOString(),
|
||||
toolUsed: response.data.tool_used, // 可选：显示使用了哪个工具
|
||||
rawData: response.data.raw_data, // 可选：原始数据（折叠显示）
|
||||
};
|
||||
setMessages((prev) => [...prev, botMessage]);
|
||||
}
|
||||
} catch (error) {
|
||||
// ...
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
## 💰 LLM 选择和成本
|
||||
|
||||
### 推荐：通义千问（阿里云）
|
||||
|
||||
**优点**：
|
||||
- 价格便宜（1000次对话约 ¥1-2）
|
||||
- 中文理解能力强
|
||||
- 国内访问稳定
|
||||
|
||||
**价格**：
|
||||
- qwen-plus: ¥0.004/1000 tokens（约 ¥0.001/次对话）
|
||||
- qwen-turbo: ¥0.002/1000 tokens（更便宜）
|
||||
|
||||
**获取 API Key**：
|
||||
1. 访问 https://dashscope.console.aliyun.com/
|
||||
2. 创建 API Key
|
||||
3. 设置环境变量 `DASHSCOPE_API_KEY`
|
||||
|
||||
### 其他选择
|
||||
|
||||
| 提供商 | 模型 | 价格 | 优点 | 缺点 |
|
||||
|--------|------|------|------|------|
|
||||
| **通义千问** | qwen-plus | ¥0.001/次 | 便宜、中文好 | - |
|
||||
| **DeepSeek** | deepseek-chat | ¥0.0005/次 | 最便宜 | 新公司 |
|
||||
| **OpenAI** | gpt-4o-mini | $0.15/1M tokens | 能力强 | 贵、需翻墙 |
|
||||
| **Claude** | claude-3-haiku | $0.25/1M tokens | 理解力强 | 贵、需翻墙 |
|
||||
|
||||
## 🚀 部署步骤
|
||||
|
||||
### 1. 后端部署
|
||||
|
||||
```bash
|
||||
# 安装依赖
|
||||
pip install openai
|
||||
|
||||
# 设置 API Key
|
||||
export DASHSCOPE_API_KEY="sk-xxx..."
|
||||
|
||||
# 重启服务
|
||||
sudo systemctl restart mcp-server
|
||||
|
||||
# 测试聊天端点
|
||||
curl -X POST https://valuefrontier.cn/mcp/chat \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"message": "查询贵州茅台的股票信息"}'
|
||||
```
|
||||
|
||||
### 2. 前端部署
|
||||
|
||||
```bash
|
||||
# 构建
|
||||
npm run build
|
||||
|
||||
# 部署
|
||||
scp -r build/* user@server:/var/www/valuefrontier.cn/
|
||||
```
|
||||
|
||||
### 3. 验证
|
||||
|
||||
访问 https://valuefrontier.cn/agent-chat，测试对话：
|
||||
|
||||
**测试用例**：
|
||||
1. "查询贵州茅台的股票信息" → 应返回自然语言总结
|
||||
2. "今日涨停的股票有哪些" → 应返回涨停股票列表并总结
|
||||
3. "新能源概念板块表现如何" → 应搜索概念并分析
|
||||
|
||||
## 📊 对比总结
|
||||
|
||||
| 特性 | 简单匹配 | 前端LLM | 后端LLM ⭐ |
|
||||
|------|---------|---------|-----------|
|
||||
| 实现难度 | 简单 | 中等 | 中等 |
|
||||
| 用户体验 | 差 | 好 | 好 |
|
||||
| 安全性 | 高 | 低 | 高 |
|
||||
| 成本 | 无 | 用户承担 | 服务器承担 |
|
||||
| 可维护性 | 差 | 中 | 好 |
|
||||
| **推荐指数** | ⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
|
||||
## 🎯 最终推荐
|
||||
|
||||
**生产环境：后端集成 LLM (方案 B)**
|
||||
- 使用通义千问（qwen-plus）
|
||||
- 成本低（约 ¥50/月，10000次对话）
|
||||
- 安全可靠
|
||||
|
||||
**快速原型：前端集成 LLM (方案 A)**
|
||||
- 适合演示
|
||||
- 快速验证可行性
|
||||
- 后续再迁移到后端
|
||||
@@ -1,322 +0,0 @@
|
||||
# Mock API 接口文档
|
||||
|
||||
本文档说明 Community 页面（`/community`）加载时请求的所有 Mock API 接口。
|
||||
|
||||
## 📊 接口总览
|
||||
|
||||
Community 页面加载时会并发请求以下接口：
|
||||
|
||||
| 序号 | 接口路径 | 调用时机 | 用途 | Mock 状态 |
|
||||
|------|---------|---------|------|-----------|
|
||||
| 1 | `/concept-api/search` | PopularKeywords 组件挂载 | 获取热门概念 | ✅ 已实现 |
|
||||
| 2 | `/api/events/` | Community 组件挂载 | 获取事件列表 | ✅ 已实现 |
|
||||
| 3-8 | `/api/index/{code}/kline` (6个) | MidjourneyHeroSection 组件挂载 | 获取三大指数K线数据 | ✅ 已实现 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 概念搜索接口
|
||||
|
||||
### `/concept-api/search`
|
||||
|
||||
**请求方式**: `POST`
|
||||
|
||||
**调用位置**: `src/views/Community/components/PopularKeywords.js:25`
|
||||
|
||||
**调用时机**: PopularKeywords 组件挂载时（`useEffect`, 空依赖数组）
|
||||
|
||||
**请求参数**:
|
||||
```json
|
||||
{
|
||||
"query": "", // 空字符串表示获取所有概念
|
||||
"size": 20, // 获取数量
|
||||
"page": 1, // 页码
|
||||
"sort_by": "change_pct" // 排序方式：按涨跌幅排序
|
||||
}
|
||||
```
|
||||
|
||||
**响应数据**:
|
||||
```json
|
||||
{
|
||||
"results": [
|
||||
{
|
||||
"concept": "人工智能",
|
||||
"concept_id": "CONCEPT_1000",
|
||||
"stock_count": 45,
|
||||
"price_info": {
|
||||
"avg_change_pct": 5.23,
|
||||
"avg_price": "45.67",
|
||||
"total_market_cap": "567.89"
|
||||
},
|
||||
"description": "人工智能相关概念股",
|
||||
"hot_score": 89
|
||||
}
|
||||
// ... 更多概念数据
|
||||
],
|
||||
"total": 20,
|
||||
"page": 1,
|
||||
"size": 20,
|
||||
"message": "搜索成功"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock Handler**: `src/mocks/handlers/concept.js`
|
||||
|
||||
---
|
||||
|
||||
## 2. 事件列表接口
|
||||
|
||||
### `/api/events/`
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**调用位置**: `src/views/Community/index.js:147` → `eventService.getEvents()`
|
||||
|
||||
**调用时机**: Community 页面加载时，由 `loadEvents()` 函数调用
|
||||
|
||||
**请求参数** (Query Parameters):
|
||||
- `page`: 页码（默认: 1）
|
||||
- `per_page`: 每页数量（默认: 10）
|
||||
- `sort`: 排序方式（默认: "new"）
|
||||
- `importance`: 重要性（默认: "all"）
|
||||
- `search_type`: 搜索类型（默认: "topic"）
|
||||
- `q`: 搜索关键词（可选）
|
||||
- `industry_code`: 行业代码（可选）
|
||||
- `industry_classification`: 行业分类（可选）
|
||||
|
||||
**示例请求**:
|
||||
```
|
||||
GET /api/events/?sort=new&importance=all&search_type=topic&page=1&per_page=10
|
||||
```
|
||||
|
||||
**响应数据**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"events": [
|
||||
{
|
||||
"event_id": "evt_001",
|
||||
"title": "某公司发布新产品",
|
||||
"content": "详细内容...",
|
||||
"importance": "S",
|
||||
"created_at": "2024-10-26T10:30:00Z",
|
||||
"related_stocks": ["600519", "000858"]
|
||||
}
|
||||
// ... 更多事件
|
||||
],
|
||||
"pagination": {
|
||||
"page": 1,
|
||||
"per_page": 10,
|
||||
"total": 100,
|
||||
"total_pages": 10
|
||||
}
|
||||
},
|
||||
"message": "获取成功"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock Handler**: `src/mocks/handlers/event.js`
|
||||
|
||||
---
|
||||
|
||||
## 3. 指数K线数据接口
|
||||
|
||||
### `/api/index/:indexCode/kline`
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**调用位置**: `src/views/Community/components/MidjourneyHeroSection.js:315-323`
|
||||
|
||||
**调用时机**: MidjourneyHeroSection 组件挂载时（`useEffect`, 空依赖数组）
|
||||
|
||||
### 3.1 分时数据 (timeline)
|
||||
|
||||
用于展示当日分钟级别的价格走势图。
|
||||
|
||||
**请求参数** (Query Parameters):
|
||||
- `type`: "timeline"
|
||||
- `event_time`: 可选，事件时间
|
||||
|
||||
**六个并发请求**:
|
||||
1. `GET /api/index/000001.SH/kline?type=timeline` - 上证指数分时
|
||||
2. `GET /api/index/399001.SZ/kline?type=timeline` - 深证成指分时
|
||||
3. `GET /api/index/399006.SZ/kline?type=timeline` - 创业板指分时
|
||||
4. `GET /api/index/000001.SH/kline?type=daily` - 上证指数日线
|
||||
5. `GET /api/index/399001.SZ/kline?type=daily` - 深证成指日线
|
||||
6. `GET /api/index/399006.SZ/kline?type=daily` - 创业板指日线
|
||||
|
||||
**timeline 响应数据**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"time": "09:30",
|
||||
"price": 3215.67,
|
||||
"close": 3215.67,
|
||||
"volume": 235678900,
|
||||
"prev_close": 3200.00
|
||||
},
|
||||
{
|
||||
"time": "09:31",
|
||||
"price": 3216.23,
|
||||
"close": 3216.23,
|
||||
"volume": 245789000,
|
||||
"prev_close": 3200.00
|
||||
}
|
||||
// ... 每分钟一条数据，从 09:30 到 15:00
|
||||
],
|
||||
"index_code": "000001.SH",
|
||||
"type": "timeline",
|
||||
"message": "获取成功"
|
||||
}
|
||||
```
|
||||
|
||||
### 3.2 日线数据 (daily)
|
||||
|
||||
用于获取历史收盘价，计算涨跌幅百分比。
|
||||
|
||||
**daily 响应数据**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"date": "2024-10-01",
|
||||
"time": "2024-10-01",
|
||||
"open": 3198.45,
|
||||
"close": 3205.67,
|
||||
"high": 3212.34,
|
||||
"low": 3195.12,
|
||||
"volume": 45678900000,
|
||||
"prev_close": 3195.23
|
||||
}
|
||||
// ... 最近30个交易日的数据
|
||||
],
|
||||
"index_code": "000001.SH",
|
||||
"type": "daily",
|
||||
"message": "获取成功"
|
||||
}
|
||||
```
|
||||
|
||||
**Mock Handler**: `src/mocks/handlers/stock.js`
|
||||
**数据生成函数**: `src/mocks/data/kline.js`
|
||||
|
||||
---
|
||||
|
||||
## 🔍 重复请求问题分析
|
||||
|
||||
### 问题原因
|
||||
|
||||
1. **PopularKeywords 组件重复渲染**
|
||||
- `UnifiedSearchBox` 内部包含 `<PopularKeywords />` (line 276)
|
||||
- `PopularKeywords` 组件自己会在 `useEffect` 中发起 `/concept-api/search` 请求
|
||||
- Community 页面同时还通过 Redux `fetchPopularKeywords()` 获取数据（但未使用）
|
||||
|
||||
2. **React Strict Mode**
|
||||
- 开发环境下，React 18 的 Strict Mode 会故意双倍调用 useEffect
|
||||
- 这会导致所有组件挂载时的请求被执行两次
|
||||
- 生产环境不受影响
|
||||
|
||||
3. **MidjourneyHeroSection 的 6 个K线请求**
|
||||
- 这是设计行为，一次性并发请求 6 个接口
|
||||
- 3 个分时数据 + 3 个日线数据
|
||||
- 用于展示三大指数的实时行情图表
|
||||
|
||||
### 解决方案
|
||||
|
||||
**方案 1**: 移除冗余的数据获取
|
||||
```javascript
|
||||
// Community/index.js 中移除未使用的 fetchPopularKeywords
|
||||
// 删除或注释掉 line 256
|
||||
// dispatch(fetchPopularKeywords());
|
||||
```
|
||||
|
||||
**方案 2**: 使用缓存机制
|
||||
- 在 `PopularKeywords` 组件中添加数据缓存
|
||||
- 短时间内（如 5 分钟）重复请求直接返回缓存数据
|
||||
|
||||
**方案 3**: 提升数据到父组件
|
||||
- 在 Community 页面统一管理数据获取
|
||||
- 通过 props 传递给 `PopularKeywords` 组件
|
||||
- `PopularKeywords` 不再自己发起请求
|
||||
|
||||
---
|
||||
|
||||
## 📝 其他接口
|
||||
|
||||
### `/api/conversations`
|
||||
**状态**: ❌ 未在前端代码中找到
|
||||
**可能来源**: 浏览器插件、其他应用、或外部系统
|
||||
|
||||
### `/api/parameters`
|
||||
**状态**: ❌ 未在前端代码中找到
|
||||
**可能来源**: 浏览器插件、其他应用、或外部系统
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Mock 服务启动
|
||||
|
||||
```bash
|
||||
# 启动 Mock 开发服务器
|
||||
npm run start:mock
|
||||
```
|
||||
|
||||
Mock 服务使用 [MSW (Mock Service Worker)](https://mswjs.io/) 实现，会拦截所有匹配的 API 请求并返回模拟数据。
|
||||
|
||||
### Mock 文件结构
|
||||
|
||||
```
|
||||
src/mocks/
|
||||
├── handlers/
|
||||
│ ├── index.js # 汇总所有 handlers
|
||||
│ ├── concept.js # 概念相关接口
|
||||
│ ├── event.js # 事件相关接口
|
||||
│ └── stock.js # 股票/指数K线接口
|
||||
├── data/
|
||||
│ ├── kline.js # K线数据生成函数
|
||||
│ ├── events.js # 事件数据
|
||||
│ └── industries.js # 行业数据
|
||||
└── browser.js # MSW 浏览器配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 调试建议
|
||||
|
||||
### 1. 查看 Mock 请求日志
|
||||
|
||||
打开浏览器控制台，所有 Mock 请求都会输出日志：
|
||||
|
||||
```
|
||||
[Mock Concept] 搜索概念: {query: "", size: 20, page: 1, sort_by: "change_pct"}
|
||||
[Mock Stock] 获取指数K线数据: {indexCode: "000001.SH", type: "timeline", eventTime: null}
|
||||
[Mock] 获取事件列表: {page: 1, per_page: 10, sort: "new", ...}
|
||||
```
|
||||
|
||||
### 2. 检查网络请求
|
||||
|
||||
在浏览器 Network 面板中：
|
||||
- 筛选 XHR/Fetch 请求
|
||||
- 查看请求的 URL、参数、响应数据
|
||||
- Mock 请求的响应时间会比真实 API 更快（200-500ms）
|
||||
|
||||
### 3. 验证数据格式
|
||||
|
||||
确保 Mock 数据格式与前端期望的格式一致：
|
||||
- 检查字段名称（如 `concept` vs `name`）
|
||||
- 检查数据类型（字符串 vs 数字）
|
||||
- 检查嵌套结构（如 `price_info.avg_change_pct`）
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [MSW 官方文档](https://mswjs.io/)
|
||||
- [React Query 缓存策略](https://tanstack.com/query/latest)
|
||||
- [前端数据获取最佳实践](https://kentcdodds.com/blog/data-fetching)
|
||||
|
||||
---
|
||||
|
||||
**更新日期**: 2024-10-26
|
||||
**维护者**: Claude Code Assistant
|
||||
@@ -1,695 +0,0 @@
|
||||
# 个人中心 Mock 数据补充文档
|
||||
|
||||
> **补充日期**: 2025-01-19
|
||||
> **补充范围**: 个人中心 (`/home/center`) 页面所需的全部 Mock 数据和 API
|
||||
> **补充目标**: 完善 Mock 数据，支持个人中心页面在开发环境下完整运行
|
||||
|
||||
---
|
||||
|
||||
## 📋 目录
|
||||
|
||||
- [1. 业务逻辑梳理](#1-业务逻辑梳理)
|
||||
- [2. API 接口清单](#2-api-接口清单)
|
||||
- [3. Mock 数据结构](#3-mock-数据结构)
|
||||
- [4. 实施内容](#4-实施内容)
|
||||
- [5. 测试验证](#5-测试验证)
|
||||
- [6. 附录](#6-附录)
|
||||
|
||||
---
|
||||
|
||||
## 1. 业务逻辑梳理
|
||||
|
||||
### 1.1 个人中心核心功能
|
||||
|
||||
个人中心 (`src/views/Dashboard/Center.js`) 是用户的核心控制面板，包含以下6大功能模块：
|
||||
|
||||
| 功能模块 | 描述 | 核心价值 |
|
||||
|---------|------|---------|
|
||||
| **自选股管理** | 添加/查看/删除自选股，查看实时行情 | 快速追踪关注股票的动态 |
|
||||
| **事件关注** | 关注的热点事件列表，查看事件详情 | 掌握市场热点和投资机会 |
|
||||
| **我的评论** | 用户在各个事件下的评论历史 | 回顾自己的观点和判断 |
|
||||
| **订阅信息** | 用户会员状态、剩余天数、功能权限 | 管理订阅和升级服务 |
|
||||
| **投资日历** | 用户自定义的投资相关日程事件 | 规划投资时间线 |
|
||||
| **投资计划与复盘** | 投资计划和复盘记录的CRUD | 系统化投资管理 |
|
||||
|
||||
### 1.2 页面数据加载流程
|
||||
|
||||
```
|
||||
页面加载
|
||||
↓
|
||||
并行请求4个API（Promise.all）
|
||||
├─ GET /api/account/watchlist → 自选股列表
|
||||
├─ GET /api/account/events/following → 关注事件
|
||||
├─ GET /api/account/events/comments → 我的评论
|
||||
└─ GET /api/subscription/current → 订阅信息
|
||||
↓
|
||||
如果有自选股，加载实时行情
|
||||
└─ GET /api/account/watchlist/realtime → 实时行情数据
|
||||
↓
|
||||
子组件加载自己的数据
|
||||
├─ InvestmentCalendarChakra
|
||||
│ └─ GET /api/account/calendar/events → 日历事件
|
||||
└─ InvestmentPlansAndReviews
|
||||
└─ GET /api/account/investment-plans → 投资计划
|
||||
```
|
||||
|
||||
### 1.3 用户交互流程
|
||||
|
||||
#### 自选股操作
|
||||
```
|
||||
查看自选股 → 点击刷新 → 更新实时行情
|
||||
↓
|
||||
点击股票 → 跳转到个股详情页
|
||||
↓
|
||||
点击添加 → 跳转到股票搜索页
|
||||
↓
|
||||
点击删除 → DELETE /api/account/watchlist/:id
|
||||
```
|
||||
|
||||
#### 投资计划操作
|
||||
```
|
||||
查看计划列表
|
||||
↓
|
||||
点击新增 → 填写表单 → POST /api/account/investment-plans
|
||||
↓
|
||||
点击编辑 → 修改内容 → PUT /api/account/investment-plans/:id
|
||||
↓
|
||||
点击删除 → DELETE /api/account/investment-plans/:id
|
||||
```
|
||||
|
||||
#### 日历事件操作
|
||||
```
|
||||
查看日历（月视图）
|
||||
↓
|
||||
选择日期 → 查看当天事件
|
||||
↓
|
||||
点击新增 → 填写表单 → POST /api/account/calendar/events
|
||||
↓
|
||||
点击事件 → 查看详情 → 编辑/删除
|
||||
↓
|
||||
PUT /api/account/calendar/events/:id
|
||||
DELETE /api/account/calendar/events/:id
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. API 接口清单
|
||||
|
||||
### 2.1 接口总览
|
||||
|
||||
共实现 **20 个** Mock API 接口，覆盖个人中心的所有功能需求。
|
||||
|
||||
| 分类 | 接口数量 | 说明 |
|
||||
|-----|---------|------|
|
||||
| 用户资料 | 3 | 资料完整度、获取/更新资料 |
|
||||
| 自选股管理 | 4 | 获取列表、实时行情、添加、删除 |
|
||||
| 事件关注 | 2 | 获取关注事件、我的评论 |
|
||||
| 投资计划 | 4 | 获取、创建、更新、删除 |
|
||||
| 投资日历 | 4 | 获取、创建、更新、删除 |
|
||||
| 订阅信息 | 3 | 订阅信息、当前订阅、权限列表 |
|
||||
|
||||
### 2.2 详细接口列表
|
||||
|
||||
#### 用户资料管理
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 1 | GET | `/api/account/profile-completeness` | 获取资料完整度 | 完整度百分比、缺失项 |
|
||||
| 2 | PUT | `/api/account/profile` | 更新用户资料 | 更新后的用户对象 |
|
||||
| 3 | GET | `/api/account/profile` | 获取用户资料 | 用户对象 |
|
||||
|
||||
#### 自选股管理
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 4 | GET | `/api/account/watchlist` | 获取自选股列表 | 自选股数组 |
|
||||
| 5 | GET | `/api/account/watchlist/realtime` | 获取实时行情 | 行情数据数组 |
|
||||
| 6 | POST | `/api/account/watchlist/add` | 添加自选股 | 新添加的自选股对象 |
|
||||
| 7 | DELETE | `/api/account/watchlist/:id` | 删除自选股 | 成功消息 |
|
||||
|
||||
#### 事件关注管理
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 8 | GET | `/api/account/events/following` | 获取关注的事件 | 事件数组 |
|
||||
| 9 | GET | `/api/account/events/comments` | 获取我的评论 | 评论数组 |
|
||||
|
||||
#### 投资计划与复盘
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 10 | GET | `/api/account/investment-plans` | 获取投资计划列表 | 计划数组 |
|
||||
| 11 | POST | `/api/account/investment-plans` | 创建投资计划 | 新创建的计划对象 |
|
||||
| 12 | PUT | `/api/account/investment-plans/:id` | 更新投资计划 | 更新后的计划对象 |
|
||||
| 13 | DELETE | `/api/account/investment-plans/:id` | 删除投资计划 | 成功消息 |
|
||||
|
||||
#### 投资日历
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 14 | GET | `/api/account/calendar/events` | 获取日历事件 | 事件数组（支持日期范围过滤） |
|
||||
| 15 | POST | `/api/account/calendar/events` | 创建日历事件 | 新创建的事件对象 |
|
||||
| 16 | PUT | `/api/account/calendar/events/:id` | 更新日历事件 | 更新后的事件对象 |
|
||||
| 17 | DELETE | `/api/account/calendar/events/:id` | 删除日历事件 | 成功消息 |
|
||||
|
||||
#### 订阅信息
|
||||
|
||||
| # | 方法 | 路径 | 描述 | 返回数据 |
|
||||
|---|------|------|------|---------|
|
||||
| 18 | GET | `/api/subscription/info` | 获取订阅信息 | 订阅类型、状态、剩余天数 |
|
||||
| 19 | GET | `/api/subscription/current` | 获取当前订阅详情 | 详细的订阅信息 |
|
||||
| 20 | GET | `/api/subscription/permissions` | 获取订阅权限 | 功能权限列表 |
|
||||
|
||||
---
|
||||
|
||||
## 3. Mock 数据结构
|
||||
|
||||
### 3.1 自选股数据 (Watchlist)
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 1, // 自选股ID
|
||||
user_id: 1, // 用户ID
|
||||
stock_code: "600519.SH", // 股票代码
|
||||
stock_name: "贵州茅台", // 股票名称
|
||||
industry: "白酒", // 所属行业
|
||||
current_price: 1650.50, // 当前价格
|
||||
change_percent: 2.5, // 涨跌幅(%)
|
||||
added_at: "2025-01-10T10:30:00Z" // 添加时间
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 5 只股票
|
||||
- 贵州茅台 (600519.SH)
|
||||
- 平安银行 (000001.SZ)
|
||||
- 五粮液 (000858.SZ)
|
||||
- 宁德时代 (300750.SZ)
|
||||
- BYD比亚迪 (002594.SZ)
|
||||
|
||||
### 3.2 实时行情数据 (Realtime Quotes)
|
||||
|
||||
```javascript
|
||||
{
|
||||
stock_code: "600519.SH", // 股票代码
|
||||
current_price: 1650.50, // 当前价格
|
||||
change_percent: 2.5, // 涨跌幅(%)
|
||||
change: 40.25, // 涨跌额
|
||||
volume: 2345678, // 成交量
|
||||
turnover: 3945678901.23, // 成交额
|
||||
high: 1665.00, // 最高价
|
||||
low: 1645.00, // 最低价
|
||||
open: 1648.80, // 开盘价
|
||||
prev_close: 1610.25, // 昨收价
|
||||
update_time: "15:00:00" // 更新时间
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 5 只股票的实时行情
|
||||
|
||||
### 3.3 关注事件数据 (Following Events)
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 101, // 事件ID
|
||||
title: "央行宣布降准0.5个百分点...", // 事件标题
|
||||
tags: ["货币政策", "央行", "降准", "银行"], // 标签
|
||||
view_count: 12340, // 浏览数
|
||||
comment_count: 156, // 评论数
|
||||
upvote_count: 489, // 点赞数
|
||||
heat_score: 95, // 热度分数
|
||||
exceed_expectation_score: 85, // 超预期分数
|
||||
creator: { // 创建者
|
||||
id: 1001,
|
||||
username: "财经分析师",
|
||||
avatar_url: "https://i.pravatar.cc/150?img=11"
|
||||
},
|
||||
created_at: "2025-01-15T09:00:00Z", // 创建时间
|
||||
followed_at: "2025-01-15T10:30:00Z" // 关注时间
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 5 个热点事件
|
||||
- 央行降准
|
||||
- ChatGPT-5 发布
|
||||
- 新能源补贴政策
|
||||
- 芯片法案
|
||||
- 医保目录调整
|
||||
|
||||
### 3.4 评论数据 (Comments)
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 201, // 评论ID
|
||||
user_id: 1, // 用户ID
|
||||
event_id: 101, // 关联事件ID
|
||||
event_title: "央行宣布降准0.5个百分点...", // 事件标题
|
||||
content: "这次降准对银行股是重大利好！...", // 评论内容
|
||||
created_at: "2025-01-15T11:20:00Z", // 评论时间
|
||||
likes: 45, // 点赞数
|
||||
replies: 12 // 回复数
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 5 条评论
|
||||
|
||||
### 3.5 投资计划数据 (Investment Plans)
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 301, // 计划ID
|
||||
user_id: 1, // 用户ID
|
||||
type: "plan", // 类型: plan | review
|
||||
title: "2025年Q1 新能源板块布局计划", // 标题
|
||||
content: "计划在Q1分批建仓新能源板块...", // 内容（支持Markdown）
|
||||
target_date: "2025-03-31", // 目标日期
|
||||
status: "in_progress", // 状态: pending | in_progress | completed | cancelled
|
||||
created_at: "2025-01-10T10:00:00Z", // 创建时间
|
||||
updated_at: "2025-01-15T14:30:00Z", // 更新时间
|
||||
tags: ["新能源", "布局计划", "Q1计划"] // 标签
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 4 条记录
|
||||
- 2 条计划 (plan)
|
||||
- 2 条复盘 (review)
|
||||
|
||||
### 3.6 日历事件数据 (Calendar Events)
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 401, // 事件ID
|
||||
user_id: 1, // 用户ID
|
||||
title: "贵州茅台年报披露", // 事件标题
|
||||
date: "2025-03-28", // 事件日期
|
||||
type: "earnings", // 类型: earnings | policy | reminder | custom
|
||||
category: "financial_report", // 分类: financial_report | macro_policy | trading | investment | review
|
||||
description: "关注营收和净利润增速...", // 描述
|
||||
stock_code: "600519.SH", // 关联股票代码（可选）
|
||||
stock_name: "贵州茅台", // 关联股票名称（可选）
|
||||
importance: "high", // 重要性: low | medium | high
|
||||
is_recurring: false, // 是否重复
|
||||
recurrence_rule: null, // 重复规则: daily | weekly | monthly（可选）
|
||||
created_at: "2025-01-10T10:00:00Z" // 创建时间
|
||||
}
|
||||
```
|
||||
|
||||
**Mock 数据数量**: 7 个日历事件
|
||||
- 2 个财报事件
|
||||
- 2 个政策事件
|
||||
- 3 个提醒事件（含重复事件）
|
||||
|
||||
### 3.7 订阅信息数据 (Subscription)
|
||||
|
||||
```javascript
|
||||
{
|
||||
type: "pro", // 订阅类型: free | pro | max
|
||||
status: "active", // 状态: active | expired | cancelled
|
||||
is_active: true, // 是否激活
|
||||
days_left: 90, // 剩余天数
|
||||
end_date: "2025-04-15T23:59:59Z", // 到期时间
|
||||
plan_name: "Pro版", // 套餐名称
|
||||
features: [ // 功能列表
|
||||
"无限事件查看",
|
||||
"实时行情推送",
|
||||
"专业分析报告",
|
||||
...
|
||||
],
|
||||
price: 0.01, // 价格
|
||||
currency: "CNY", // 货币
|
||||
billing_cycle: "monthly", // 计费周期: monthly | quarterly | yearly
|
||||
auto_renew: true, // 自动续费
|
||||
next_billing_date: "2025-02-15T00:00:00Z" // 下次扣费日期
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 实施内容
|
||||
|
||||
### 4.1 创建的文件
|
||||
|
||||
#### 1. `src/mocks/data/account.js` (新建)
|
||||
|
||||
**文件作用**: 存储个人中心相关的所有 Mock 数据
|
||||
|
||||
**包含内容**:
|
||||
- `mockWatchlist` - 自选股数据 (5条)
|
||||
- `mockRealtimeQuotes` - 实时行情数据 (5条)
|
||||
- `mockFollowingEvents` - 关注事件数据 (5条)
|
||||
- `mockEventComments` - 评论数据 (5条)
|
||||
- `mockInvestmentPlans` - 投资计划数据 (4条)
|
||||
- `mockCalendarEvents` - 日历事件数据 (7条)
|
||||
- `mockSubscriptionCurrent` - 订阅详情数据 (1条)
|
||||
|
||||
**辅助函数**:
|
||||
```javascript
|
||||
// 根据用户ID获取数据
|
||||
getWatchlistByUserId(userId)
|
||||
getFollowingEventsByUserId(userId)
|
||||
getCommentsByUserId(userId)
|
||||
getInvestmentPlansByUserId(userId)
|
||||
getCalendarEventsByUserId(userId)
|
||||
|
||||
// 根据日期范围获取日历事件
|
||||
getCalendarEventsByDateRange(userId, startDate, endDate)
|
||||
```
|
||||
|
||||
**文件大小**: 约 550 行代码
|
||||
|
||||
#### 2. `src/mocks/handlers/account.js` (完全重写)
|
||||
|
||||
**文件作用**: 处理个人中心相关的所有 API 请求
|
||||
|
||||
**包含内容**: 20 个 API Handler
|
||||
|
||||
**主要改动**:
|
||||
- ✅ 保留原有的用户资料管理接口 (3个)
|
||||
- ✅ 完善自选股管理接口 (4个)
|
||||
- ✅ 完善事件关注接口 (2个)
|
||||
- ✅ **新增** 投资计划接口 (4个)
|
||||
- ✅ **新增** 投资日历接口 (4个)
|
||||
- ✅ 完善订阅信息接口 (3个)
|
||||
|
||||
**文件大小**: 660 行代码（从原 542 行扩展到 660 行）
|
||||
|
||||
### 4.2 修改的文件
|
||||
|
||||
#### `src/mocks/handlers/index.js` (无需修改)
|
||||
|
||||
**检查结果**: ✅ 已正确导入和导出 `accountHandlers`
|
||||
|
||||
```javascript
|
||||
import { accountHandlers } from './account';
|
||||
|
||||
export const handlers = [
|
||||
...authHandlers,
|
||||
...accountHandlers, // ✅ 已包含
|
||||
...simulationHandlers,
|
||||
...eventHandlers,
|
||||
];
|
||||
```
|
||||
|
||||
### 4.3 Mock 数据特点
|
||||
|
||||
#### 数据真实性
|
||||
- ✅ 使用真实的股票代码和名称
|
||||
- ✅ 价格和涨跌幅符合市场规律
|
||||
- ✅ 事件标题和内容贴近实际热点
|
||||
- ✅ 日期时间合理分布
|
||||
|
||||
#### 数据关联性
|
||||
- ✅ 评论关联到对应的事件
|
||||
- ✅ 日历事件关联到对应的股票
|
||||
- ✅ 实时行情对应自选股列表
|
||||
- ✅ 订阅类型影响权限配置
|
||||
|
||||
#### 数据可扩展性
|
||||
- ✅ 支持动态添加/删除数据
|
||||
- ✅ 数据结构预留扩展字段
|
||||
- ✅ 辅助函数便于数据查询
|
||||
- ✅ 支持日期范围过滤
|
||||
|
||||
---
|
||||
|
||||
## 5. 测试验证
|
||||
|
||||
### 5.1 功能测试清单
|
||||
|
||||
#### 个人中心页面加载
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **页面初始加载** | 1. 登录系统<br>2. 访问 `/home/center` | 页面正常加载，显示所有板块 | ⬜ |
|
||||
| **统计卡片显示** | 查看顶部4个统计卡片 | 显示：自选股(5)、关注事件(5)、我的评论(5)、订阅状态(Pro版) | ⬜ |
|
||||
| **自选股列表** | 查看自选股板块 | 显示5只股票，包含股票代码、名称、价格、涨跌幅 | ⬜ |
|
||||
| **实时行情** | 等待实时行情加载 | 股票价格显示，涨跌幅有颜色标识（红涨绿跌） | ⬜ |
|
||||
| **关注事件列表** | 查看关注事件板块 | 显示5个事件，包含标题、标签、统计数据、热度分数 | ⬜ |
|
||||
| **我的评论列表** | 查看我的评论板块 | 显示5条评论，包含内容、时间、关联事件 | ⬜ |
|
||||
| **订阅信息卡片** | 查看订阅管理板块 | 显示Pro版，剩余90天，状态正常 | ⬜ |
|
||||
|
||||
#### 自选股功能
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **查看自选股详情** | 点击任一自选股 | 跳转到个股详情页 | ⬜ |
|
||||
| **刷新实时行情** | 点击刷新按钮 | 显示Loading，刷新完成后更新价格数据 | ⬜ |
|
||||
| **自动刷新行情** | 等待60秒 | 自动刷新实时行情（每分钟一次） | ⬜ |
|
||||
|
||||
#### 投资计划功能
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **查看投资计划** | 滚动到投资计划板块 | 显示4条记录（2个计划 + 2个复盘） | ⬜ |
|
||||
| **创建计划** | 1. 点击"新增计划"<br>2. 填写表单<br>3. 提交 | 计划创建成功，列表刷新 | ⬜ |
|
||||
| **编辑计划** | 1. 点击编辑按钮<br>2. 修改内容<br>3. 保存 | 计划更新成功，显示更新后的内容 | ⬜ |
|
||||
| **删除计划** | 1. 点击删除按钮<br>2. 确认删除 | 计划删除成功，列表刷新 | ⬜ |
|
||||
| **计划状态切换** | 切换计划状态（待进行/进行中/已完成） | 状态更新成功，显示对应标识 | ⬜ |
|
||||
|
||||
#### 投资日历功能
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **查看日历** | 查看投资日历板块 | 显示月视图，标记有事件的日期 | ⬜ |
|
||||
| **查看事件** | 点击有事件的日期 | 显示当天的事件列表（支持多个事件） | ⬜ |
|
||||
| **创建事件** | 1. 选择日期<br>2. 点击"添加事件"<br>3. 填写表单<br>4. 提交 | 事件创建成功，日历更新 | ⬜ |
|
||||
| **编辑事件** | 1. 点击事件<br>2. 修改信息<br>3. 保存 | 事件更新成功 | ⬜ |
|
||||
| **删除事件** | 1. 点击事件<br>2. 点击删除<br>3. 确认 | 事件删除成功，日历更新 | ⬜ |
|
||||
| **重复事件** | 创建一个重复事件（如每月20日） | 日历上多个日期显示该事件 | ⬜ |
|
||||
|
||||
#### 订阅管理功能
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **查看订阅详情** | 点击订阅卡片 | 跳转到订阅管理页面 | ⬜ |
|
||||
| **订阅权限检查** | 访问需要权限的功能 | Pro用户可访问，Free用户提示升级 | ⬜ |
|
||||
|
||||
### 5.2 数据一致性测试
|
||||
|
||||
| 测试项 | 验证方法 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **自选股与行情匹配** | 对比自选股列表和实时行情 | 每只自选股都有对应的行情数据 | ⬜ |
|
||||
| **评论与事件关联** | 点击评论中的事件链接 | 能正确跳转到对应事件 | ⬜ |
|
||||
| **日历事件与股票关联** | 查看带股票代码的日历事件 | 点击能跳转到对应股票详情 | ⬜ |
|
||||
| **订阅类型一致性** | 对比多处显示的订阅类型 | 统计卡片、订阅管理、权限检查一致 | ⬜ |
|
||||
|
||||
### 5.3 边界情况测试
|
||||
|
||||
| 测试项 | 测试步骤 | 预期结果 | 状态 |
|
||||
|-------|---------|---------|-----|
|
||||
| **空数据状态** | 1. 清空所有自选股<br>2. 刷新页面 | 显示"暂无自选股"提示，引导添加 | ⬜ |
|
||||
| **网络延迟** | 模拟慢速网络 | 显示Loading状态，300ms后加载完成 | ⬜ |
|
||||
| **未登录状态** | 未登录访问个人中心 | 返回401错误（被ProtectedRoute拦截） | ⬜ |
|
||||
| **大数据量** | 添加10+只自选股 | 前端只显示前10只，其他可查看全部 | ⬜ |
|
||||
| **日期范围查询** | 查询特定月份的日历事件 | 只返回该月份的事件 | ⬜ |
|
||||
|
||||
---
|
||||
|
||||
## 6. 附录
|
||||
|
||||
### 6.1 API 请求示例
|
||||
|
||||
#### 获取自选股列表
|
||||
```javascript
|
||||
// 请求
|
||||
GET /api/account/watchlist
|
||||
|
||||
// 响应
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"user_id": 1,
|
||||
"stock_code": "600519.SH",
|
||||
"stock_name": "贵州茅台",
|
||||
"industry": "白酒",
|
||||
"current_price": 1650.50,
|
||||
"change_percent": 2.5,
|
||||
"added_at": "2025-01-10T10:30:00Z"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
#### 创建投资计划
|
||||
```javascript
|
||||
// 请求
|
||||
POST /api/account/investment-plans
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"type": "plan",
|
||||
"title": "2025年Q1 新能源板块布局计划",
|
||||
"content": "计划在Q1分批建仓新能源板块...",
|
||||
"target_date": "2025-03-31",
|
||||
"status": "pending",
|
||||
"tags": ["新能源", "布局计划"]
|
||||
}
|
||||
|
||||
// 响应
|
||||
{
|
||||
"success": true,
|
||||
"message": "创建成功",
|
||||
"data": {
|
||||
"id": 305,
|
||||
"user_id": 1,
|
||||
"type": "plan",
|
||||
"title": "2025年Q1 新能源板块布局计划",
|
||||
"content": "计划在Q1分批建仓新能源板块...",
|
||||
"target_date": "2025-03-31",
|
||||
"status": "pending",
|
||||
"tags": ["新能源", "布局计划"],
|
||||
"created_at": "2025-01-19T10:00:00Z",
|
||||
"updated_at": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 获取日历事件（日期范围）
|
||||
```javascript
|
||||
// 请求
|
||||
GET /api/account/calendar/events?start_date=2025-01-01&end_date=2025-01-31
|
||||
|
||||
// 响应
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"id": 403,
|
||||
"user_id": 1,
|
||||
"title": "央行货币政策委员会例会",
|
||||
"date": "2025-01-25",
|
||||
"type": "policy",
|
||||
"category": "macro_policy",
|
||||
"importance": "medium",
|
||||
"created_at": "2025-01-08T09:00:00Z"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### 6.2 数据模型 ER 图
|
||||
|
||||
```
|
||||
User (用户)
|
||||
├─ 1:N → Watchlist (自选股)
|
||||
├─ 1:N → FollowingEvents (关注事件)
|
||||
├─ 1:N → EventComments (评论)
|
||||
├─ 1:N → InvestmentPlans (投资计划)
|
||||
├─ 1:N → CalendarEvents (日历事件)
|
||||
└─ 1:1 → Subscription (订阅信息)
|
||||
|
||||
Event (事件)
|
||||
├─ 1:N → EventComments (评论)
|
||||
└─ N:N → Users (关注用户)
|
||||
|
||||
Stock (股票)
|
||||
├─ 1:N → Watchlist (自选股)
|
||||
├─ 1:1 → RealtimeQuote (实时行情)
|
||||
└─ 1:N → CalendarEvents (日历事件)
|
||||
```
|
||||
|
||||
### 6.3 Mock 数据统计
|
||||
|
||||
| 数据类型 | 数量 | 字段数 | 总大小（估算） |
|
||||
|---------|-----|--------|--------------|
|
||||
| 自选股 | 5 | 8 | 约 0.5KB |
|
||||
| 实时行情 | 5 | 11 | 约 0.8KB |
|
||||
| 关注事件 | 5 | 10 | 约 2KB |
|
||||
| 评论 | 5 | 8 | 约 1.5KB |
|
||||
| 投资计划 | 4 | 10 | 约 3KB |
|
||||
| 日历事件 | 7 | 12 | 约 1.5KB |
|
||||
| **总计** | **31** | **59** | **约 9.3KB** |
|
||||
|
||||
### 6.4 前端组件映射
|
||||
|
||||
| 前端组件 | 使用的 API | Mock 数据来源 |
|
||||
|---------|-----------|-------------|
|
||||
| `Center.js` (主组件) | 4个并行API | `mockWatchlist`, `mockFollowingEvents`, `mockEventComments`, `mockSubscriptionCurrent` |
|
||||
| 自选股卡片 | `/api/account/watchlist` | `mockWatchlist` |
|
||||
| 实时行情刷新 | `/api/account/watchlist/realtime` | `mockRealtimeQuotes` |
|
||||
| 关注事件列表 | `/api/account/events/following` | `mockFollowingEvents` |
|
||||
| 我的评论列表 | `/api/account/events/comments` | `mockEventComments` |
|
||||
| 订阅信息卡片 | `/api/subscription/current` | `mockSubscriptionCurrent` |
|
||||
| `InvestmentCalendarChakra.js` | `/api/account/calendar/events` | `mockCalendarEvents` |
|
||||
| `InvestmentPlansAndReviews.js` | `/api/account/investment-plans` | `mockInvestmentPlans` |
|
||||
|
||||
### 6.5 常见问题 (FAQ)
|
||||
|
||||
**Q1: Mock 数据会持久化吗？**
|
||||
A: 不会。Mock 数据存储在内存中，刷新页面后会重置。如果需要持久化，可以考虑使用 localStorage。
|
||||
|
||||
**Q2: 如何切换到真实 API？**
|
||||
A: 在 `.env` 文件中设置 `REACT_APP_ENABLE_MOCK=false` 即可切换到真实 API。
|
||||
|
||||
**Q3: Mock 数据支持多用户吗？**
|
||||
A: 目前的 Mock 数据基于当前登录用户（`getCurrentUser()`），支持基本的多用户场景。
|
||||
|
||||
**Q4: 实时行情数据是真的实时吗？**
|
||||
A: Mock 模式下不是真实的实时数据，只是静态数据。真实环境下需要对接WebSocket或轮询API。
|
||||
|
||||
**Q5: 如何添加更多 Mock 数据？**
|
||||
A: 编辑 `src/mocks/data/account.js`，在对应的数组中添加新的数据对象即可。
|
||||
|
||||
### 6.6 后续优化建议
|
||||
|
||||
#### 短期优化（1周内）
|
||||
- [ ] 添加更多股票到自选股池（目前5只 → 10只）
|
||||
- [ ] 丰富事件类型和标签
|
||||
- [ ] 完善投资计划的标签系统
|
||||
- [ ] 添加日历事件的提醒功能Mock
|
||||
|
||||
#### 中期优化（1月内）
|
||||
- [ ] 实现 Mock 数据的 localStorage 持久化
|
||||
- [ ] 添加数据导入/导出功能
|
||||
- [ ] 模拟网络波动和错误场景
|
||||
- [ ] 添加更多的边界测试用例
|
||||
|
||||
#### 长期优化（3月内）
|
||||
- [ ] 实现完整的 Mock 数据生成器
|
||||
- [ ] 支持批量生成测试数据
|
||||
- [ ] 添加数据一致性校验工具
|
||||
- [ ] 完善 Mock 数据文档和最佳实践
|
||||
|
||||
---
|
||||
|
||||
## ✅ 总结
|
||||
|
||||
### 完成内容
|
||||
- ✅ 创建完整的 Mock 数据文件 (`src/mocks/data/account.js`)
|
||||
- ✅ 重写并扩展 Mock Handler (`src/mocks/handlers/account.js`)
|
||||
- ✅ 实现 20 个 API 接口的 Mock
|
||||
- ✅ 提供 31 条 Mock 数据记录
|
||||
- ✅ 验证 handlers/index.js 配置正确
|
||||
|
||||
### 覆盖功能
|
||||
- ✅ 自选股管理（查看、添加、删除、实时行情）
|
||||
- ✅ 事件关注（关注列表、我的评论）
|
||||
- ✅ 投资计划（增删改查、计划与复盘）
|
||||
- ✅ 投资日历（增删改查、日期范围查询）
|
||||
- ✅ 订阅信息（订阅详情、权限管理）
|
||||
- ✅ 用户资料（资料完整度、更新资料）
|
||||
|
||||
### 数据质量
|
||||
- ✅ 数据真实性：使用真实股票和合理价格
|
||||
- ✅ 数据关联性：评论关联事件、日历关联股票
|
||||
- ✅ 数据可扩展性：预留字段、支持动态操作
|
||||
- ✅ 数据完整性：包含所有必需字段
|
||||
|
||||
### 测试准备
|
||||
- ✅ 提供完整的测试用例清单
|
||||
- ✅ 覆盖功能、数据一致性、边界测试
|
||||
- ✅ 包含42个测试项
|
||||
- ✅ 提供测试步骤和预期结果
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 1.0
|
||||
**生成日期**: 2025-01-19
|
||||
**维护者**: Development Team
|
||||
**相关文档**:
|
||||
- `CONSOLE_LOG_REFACTOR_REPORT.md` - Console Log 重构文档
|
||||
- `LOGIN_MODAL_REFACTOR_PLAN.md` - 登录弹窗改造计划
|
||||
|
||||
@@ -1,576 +0,0 @@
|
||||
# 订阅支付系统重新设计方案
|
||||
|
||||
## 📊 问题分析
|
||||
|
||||
### 现有系统的问题
|
||||
|
||||
1. **价格配置混乱**
|
||||
- 季付和月付价格相同（配置错误）
|
||||
- `monthly_price` 和 `yearly_price` 字段命名不清晰
|
||||
- 缺少季付、半年付等周期的价格配置
|
||||
|
||||
2. **升级逻辑复杂且不合理**
|
||||
- 计算剩余价值折算（按天计算 `remaining_value`）
|
||||
- 用户难以理解升级价格
|
||||
- 续费用户和新用户价格不一致
|
||||
- 逻辑复杂,容易出错
|
||||
|
||||
3. **按钮文案不清晰**
|
||||
- 已订阅用户应显示"续费 Pro"/"续费 Max"
|
||||
- 而不是"升级至 Pro"/"切换至 Pro"
|
||||
|
||||
4. **数据库表设计问题**
|
||||
- `SubscriptionUpgrade` 表记录升级,但逻辑过于复杂
|
||||
- `PaymentOrder` 表缺少必要字段
|
||||
- 价格配置分散在多个字段
|
||||
|
||||
---
|
||||
|
||||
## ✨ 新设计方案
|
||||
|
||||
### 核心原则
|
||||
|
||||
1. **简化续费逻辑**: **续费用户与新用户价格完全一致**,不做任何折算
|
||||
2. **清晰的价格体系**: 每个套餐每个周期都有明确的价格
|
||||
3. **统一的用户体验**: 无论是新购还是续费,价格透明一致
|
||||
4. **独立的订阅记录**: 每次支付都创建新的订阅记录(历史可追溯)
|
||||
|
||||
---
|
||||
|
||||
## 📐 数据库表设计
|
||||
|
||||
### 1. `subscription_plans` - 订阅套餐表（重构）
|
||||
|
||||
```sql
|
||||
CREATE TABLE subscription_plans (
|
||||
id INT PRIMARY KEY AUTO_INCREMENT,
|
||||
plan_code VARCHAR(20) NOT NULL UNIQUE COMMENT '套餐代码: pro, max',
|
||||
plan_name VARCHAR(50) NOT NULL COMMENT '套餐名称: Pro专业版, Max旗舰版',
|
||||
description TEXT COMMENT '套餐描述',
|
||||
features JSON COMMENT '功能列表',
|
||||
|
||||
-- 价格配置（所有周期价格）
|
||||
price_monthly DECIMAL(10,2) NOT NULL DEFAULT 0 COMMENT '月付价格',
|
||||
price_quarterly DECIMAL(10,2) NOT NULL DEFAULT 0 COMMENT '季付价格(3个月)',
|
||||
price_semiannual DECIMAL(10,2) NOT NULL DEFAULT 0 COMMENT '半年付价格(6个月)',
|
||||
price_yearly DECIMAL(10,2) NOT NULL DEFAULT 0 COMMENT '年付价格(12个月)',
|
||||
|
||||
-- 状态字段
|
||||
is_active BOOLEAN DEFAULT TRUE COMMENT '是否启用',
|
||||
display_order INT DEFAULT 0 COMMENT '展示顺序',
|
||||
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_plan_code (plan_code),
|
||||
INDEX idx_active_order (is_active, display_order)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订阅套餐配置表';
|
||||
```
|
||||
|
||||
**示例数据**:
|
||||
```sql
|
||||
INSERT INTO subscription_plans (plan_code, plan_name, description, price_monthly, price_quarterly, price_semiannual, price_yearly) VALUES
|
||||
('pro', 'Pro 专业版', '为专业投资者打造', 299.00, 799.00, 1499.00, 2699.00),
|
||||
('max', 'Max 旗舰版', '旗舰级体验', 599.00, 1599.00, 2999.00, 5399.00);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. `user_subscriptions` - 用户订阅记录表（重构）
|
||||
|
||||
```sql
|
||||
CREATE TABLE user_subscriptions (
|
||||
id INT PRIMARY KEY AUTO_INCREMENT,
|
||||
user_id INT NOT NULL COMMENT '用户ID',
|
||||
subscription_id VARCHAR(32) UNIQUE NOT NULL COMMENT '订阅ID(唯一标识)',
|
||||
|
||||
-- 订阅基本信息
|
||||
plan_code VARCHAR(20) NOT NULL COMMENT '套餐代码: pro, max',
|
||||
billing_cycle VARCHAR(20) NOT NULL COMMENT '计费周期: monthly, quarterly, semiannual, yearly',
|
||||
|
||||
-- 订阅时间
|
||||
start_date DATETIME NOT NULL COMMENT '订阅开始时间',
|
||||
end_date DATETIME NOT NULL COMMENT '订阅结束时间',
|
||||
|
||||
-- 订阅状态
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active(有效), expired(已过期), cancelled(已取消)',
|
||||
is_current BOOLEAN DEFAULT FALSE COMMENT '是否为当前生效的订阅',
|
||||
|
||||
-- 支付信息
|
||||
payment_order_id INT COMMENT '关联的支付订单ID',
|
||||
paid_amount DECIMAL(10,2) NOT NULL COMMENT '实际支付金额',
|
||||
original_price DECIMAL(10,2) NOT NULL COMMENT '原价',
|
||||
discount_amount DECIMAL(10,2) DEFAULT 0 COMMENT '优惠金额',
|
||||
|
||||
-- 订阅类型
|
||||
subscription_type VARCHAR(20) DEFAULT 'new' COMMENT '订阅类型: new(新购), renew(续费)',
|
||||
previous_subscription_id VARCHAR(32) COMMENT '上一个订阅ID(续费时记录)',
|
||||
|
||||
-- 自动续费
|
||||
auto_renew BOOLEAN DEFAULT FALSE COMMENT '是否自动续费',
|
||||
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_user_id (user_id),
|
||||
INDEX idx_subscription_id (subscription_id),
|
||||
INDEX idx_user_current (user_id, is_current),
|
||||
INDEX idx_status (status),
|
||||
INDEX idx_end_date (end_date),
|
||||
|
||||
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户订阅记录表';
|
||||
```
|
||||
|
||||
**设计说明**:
|
||||
- 每次支付都创建新的订阅记录
|
||||
- 通过 `is_current` 标识当前生效的订阅
|
||||
- 支持订阅历史追溯
|
||||
- 续费时记录 `previous_subscription_id` 形成订阅链
|
||||
|
||||
---
|
||||
|
||||
### 3. `payment_orders` - 支付订单表（重构）
|
||||
|
||||
```sql
|
||||
CREATE TABLE payment_orders (
|
||||
id INT PRIMARY KEY AUTO_INCREMENT,
|
||||
order_no VARCHAR(32) UNIQUE NOT NULL COMMENT '订单号',
|
||||
user_id INT NOT NULL COMMENT '用户ID',
|
||||
|
||||
-- 订阅信息
|
||||
plan_code VARCHAR(20) NOT NULL COMMENT '套餐代码',
|
||||
billing_cycle VARCHAR(20) NOT NULL COMMENT '计费周期',
|
||||
subscription_type VARCHAR(20) DEFAULT 'new' COMMENT '订阅类型: new(新购), renew(续费)',
|
||||
|
||||
-- 价格信息
|
||||
original_price DECIMAL(10,2) NOT NULL COMMENT '原价',
|
||||
discount_amount DECIMAL(10,2) DEFAULT 0 COMMENT '优惠金额',
|
||||
final_amount DECIMAL(10,2) NOT NULL COMMENT '实付金额',
|
||||
|
||||
-- 优惠码
|
||||
promo_code_id INT COMMENT '优惠码ID',
|
||||
promo_code VARCHAR(50) COMMENT '优惠码',
|
||||
|
||||
-- 支付信息
|
||||
payment_method VARCHAR(20) DEFAULT 'wechat' COMMENT '支付方式: wechat, alipay',
|
||||
payment_channel VARCHAR(50) COMMENT '支付渠道详情',
|
||||
transaction_id VARCHAR(64) COMMENT '第三方交易号',
|
||||
qr_code_url TEXT COMMENT '支付二维码URL',
|
||||
|
||||
-- 订单状态
|
||||
status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending(待支付), paid(已支付), expired(已过期), cancelled(已取消)',
|
||||
|
||||
-- 时间信息
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
paid_at TIMESTAMP NULL COMMENT '支付时间',
|
||||
expired_at TIMESTAMP NULL COMMENT '过期时间',
|
||||
|
||||
-- 备注
|
||||
remark TEXT COMMENT '备注信息',
|
||||
|
||||
INDEX idx_order_no (order_no),
|
||||
INDEX idx_user_id (user_id),
|
||||
INDEX idx_status (status),
|
||||
INDEX idx_created_at (created_at),
|
||||
|
||||
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
|
||||
FOREIGN KEY (promo_code_id) REFERENCES promo_codes(id) ON DELETE SET NULL
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='支付订单表';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. `promo_codes` - 优惠码表（保持不变,微调）
|
||||
|
||||
```sql
|
||||
CREATE TABLE promo_codes (
|
||||
id INT PRIMARY KEY AUTO_INCREMENT,
|
||||
code VARCHAR(50) UNIQUE NOT NULL COMMENT '优惠码',
|
||||
description VARCHAR(200) COMMENT '描述',
|
||||
|
||||
-- 折扣类型
|
||||
discount_type VARCHAR(20) NOT NULL COMMENT '折扣类型: percentage(百分比), fixed_amount(固定金额)',
|
||||
discount_value DECIMAL(10,2) NOT NULL COMMENT '折扣值',
|
||||
|
||||
-- 适用范围
|
||||
applicable_plans JSON COMMENT '适用套餐: ["pro", "max"] 或 null(全部)',
|
||||
applicable_cycles JSON COMMENT '适用周期: ["monthly", "yearly"] 或 null(全部)',
|
||||
min_amount DECIMAL(10,2) COMMENT '最低消费金额',
|
||||
|
||||
-- 使用限制
|
||||
max_total_uses INT COMMENT '最大使用次数(总)',
|
||||
max_uses_per_user INT DEFAULT 1 COMMENT '每用户最大使用次数',
|
||||
current_uses INT DEFAULT 0 COMMENT '当前使用次数',
|
||||
|
||||
-- 有效期
|
||||
valid_from TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '生效时间',
|
||||
valid_until TIMESTAMP NULL COMMENT '过期时间',
|
||||
|
||||
-- 状态
|
||||
is_active BOOLEAN DEFAULT TRUE COMMENT '是否启用',
|
||||
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_code (code),
|
||||
INDEX idx_active (is_active),
|
||||
INDEX idx_valid_period (valid_from, valid_until)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠码表';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. `promo_code_usage` - 优惠码使用记录表（保持不变）
|
||||
|
||||
```sql
|
||||
CREATE TABLE promo_code_usage (
|
||||
id INT PRIMARY KEY AUTO_INCREMENT,
|
||||
promo_code_id INT NOT NULL,
|
||||
user_id INT NOT NULL,
|
||||
order_id INT NOT NULL,
|
||||
discount_amount DECIMAL(10,2) NOT NULL COMMENT '实际优惠金额',
|
||||
used_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_promo_code (promo_code_id),
|
||||
INDEX idx_user_id (user_id),
|
||||
INDEX idx_order_id (order_id),
|
||||
|
||||
FOREIGN KEY (promo_code_id) REFERENCES promo_codes(id) ON DELETE CASCADE,
|
||||
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
|
||||
FOREIGN KEY (order_id) REFERENCES payment_orders(id) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠码使用记录表';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 删除不必要的表
|
||||
|
||||
**删除 `subscription_upgrades` 表** - 不再需要复杂的升级逻辑
|
||||
|
||||
---
|
||||
|
||||
## 💡 业务逻辑设计
|
||||
|
||||
### 1. 价格计算逻辑（简化版）
|
||||
|
||||
```python
|
||||
def calculate_subscription_price(plan_code, billing_cycle, promo_code=None):
|
||||
"""
|
||||
计算订阅价格（新购和续费价格完全一致）
|
||||
|
||||
Args:
|
||||
plan_code: 套餐代码 (pro/max)
|
||||
billing_cycle: 计费周期 (monthly/quarterly/semiannual/yearly)
|
||||
promo_code: 优惠码（可选）
|
||||
|
||||
Returns:
|
||||
dict: {
|
||||
'plan_code': 'pro',
|
||||
'billing_cycle': 'yearly',
|
||||
'original_price': 2699.00,
|
||||
'discount_amount': 0,
|
||||
'final_amount': 2699.00,
|
||||
'promo_code': None,
|
||||
'promo_error': None
|
||||
}
|
||||
"""
|
||||
# 1. 查询套餐价格
|
||||
plan = SubscriptionPlan.query.filter_by(plan_code=plan_code, is_active=True).first()
|
||||
if not plan:
|
||||
return {'error': '套餐不存在'}
|
||||
|
||||
# 2. 获取对应周期的价格
|
||||
price_field = f'price_{billing_cycle}'
|
||||
original_price = getattr(plan, price_field, 0)
|
||||
|
||||
if original_price <= 0:
|
||||
return {'error': '价格配置错误'}
|
||||
|
||||
result = {
|
||||
'plan_code': plan_code,
|
||||
'plan_name': plan.plan_name,
|
||||
'billing_cycle': billing_cycle,
|
||||
'original_price': float(original_price),
|
||||
'discount_amount': 0,
|
||||
'final_amount': float(original_price),
|
||||
'promo_code': None,
|
||||
'promo_error': None
|
||||
}
|
||||
|
||||
# 3. 应用优惠码（如果有）
|
||||
if promo_code:
|
||||
promo, error = validate_promo_code(promo_code, plan_code, billing_cycle, original_price, user_id)
|
||||
if promo:
|
||||
discount = calculate_discount(promo, original_price)
|
||||
result['discount_amount'] = float(discount)
|
||||
result['final_amount'] = float(original_price - discount)
|
||||
result['promo_code'] = promo.code
|
||||
elif error:
|
||||
result['promo_error'] = error
|
||||
|
||||
return result
|
||||
```
|
||||
|
||||
**关键点**:
|
||||
- ✅ 不再计算 `remaining_value`（剩余价值）
|
||||
- ✅ 不再区分新购/续费价格
|
||||
- ✅ 逻辑简单,易于维护
|
||||
- ✅ 用户体验清晰透明
|
||||
|
||||
---
|
||||
|
||||
### 2. 创建订单逻辑
|
||||
|
||||
```python
|
||||
def create_subscription_order(user_id, plan_code, billing_cycle, promo_code=None):
|
||||
"""
|
||||
创建订阅支付订单
|
||||
"""
|
||||
# 1. 计算价格
|
||||
price_result = calculate_subscription_price(plan_code, billing_cycle, promo_code)
|
||||
if 'error' in price_result:
|
||||
return {'success': False, 'error': price_result['error']}
|
||||
|
||||
# 2. 判断是新购还是续费
|
||||
current_sub = get_current_subscription(user_id)
|
||||
|
||||
subscription_type = 'new'
|
||||
if current_sub and current_sub.plan_code in ['pro', 'max']:
|
||||
subscription_type = 'renew'
|
||||
|
||||
# 3. 创建支付订单
|
||||
order = PaymentOrder(
|
||||
order_no=generate_order_no(user_id),
|
||||
user_id=user_id,
|
||||
plan_code=plan_code,
|
||||
billing_cycle=billing_cycle,
|
||||
subscription_type=subscription_type,
|
||||
original_price=price_result['original_price'],
|
||||
discount_amount=price_result['discount_amount'],
|
||||
final_amount=price_result['final_amount'],
|
||||
promo_code=promo_code,
|
||||
status='pending',
|
||||
expired_at=datetime.now() + timedelta(minutes=30)
|
||||
)
|
||||
|
||||
db.session.add(order)
|
||||
db.session.commit()
|
||||
|
||||
# 4. 生成支付二维码（微信支付）
|
||||
qr_code_url = generate_wechat_qr_code(order)
|
||||
order.qr_code_url = qr_code_url
|
||||
db.session.commit()
|
||||
|
||||
return {'success': True, 'order': order.to_dict()}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 支付成功后的订阅激活逻辑
|
||||
|
||||
```python
|
||||
def activate_subscription_after_payment(order_id):
|
||||
"""
|
||||
支付成功后激活订阅
|
||||
"""
|
||||
order = PaymentOrder.query.get(order_id)
|
||||
if not order or order.status != 'paid':
|
||||
return {'success': False, 'error': '订单状态错误'}
|
||||
|
||||
user_id = order.user_id
|
||||
plan_code = order.plan_code
|
||||
billing_cycle = order.billing_cycle
|
||||
|
||||
# 1. 计算订阅周期
|
||||
cycle_days = {
|
||||
'monthly': 30,
|
||||
'quarterly': 90,
|
||||
'semiannual': 180,
|
||||
'yearly': 365
|
||||
}
|
||||
days = cycle_days.get(billing_cycle, 30)
|
||||
|
||||
# 2. 获取当前订阅
|
||||
current_sub = UserSubscription.query.filter_by(
|
||||
user_id=user_id,
|
||||
is_current=True
|
||||
).first()
|
||||
|
||||
# 3. 计算开始和结束时间
|
||||
now = datetime.now()
|
||||
|
||||
if current_sub and current_sub.end_date > now:
|
||||
# 续费：从当前订阅结束时间开始
|
||||
start_date = current_sub.end_date
|
||||
else:
|
||||
# 新购：从当前时间开始
|
||||
start_date = now
|
||||
|
||||
end_date = start_date + timedelta(days=days)
|
||||
|
||||
# 4. 创建新订阅记录
|
||||
new_subscription = UserSubscription(
|
||||
user_id=user_id,
|
||||
subscription_id=generate_subscription_id(),
|
||||
plan_code=plan_code,
|
||||
billing_cycle=billing_cycle,
|
||||
start_date=start_date,
|
||||
end_date=end_date,
|
||||
status='active',
|
||||
is_current=True,
|
||||
payment_order_id=order.id,
|
||||
paid_amount=order.final_amount,
|
||||
original_price=order.original_price,
|
||||
discount_amount=order.discount_amount,
|
||||
subscription_type=order.subscription_type,
|
||||
previous_subscription_id=current_sub.subscription_id if current_sub else None
|
||||
)
|
||||
|
||||
# 5. 将旧订阅标记为非当前
|
||||
if current_sub:
|
||||
current_sub.is_current = False
|
||||
|
||||
db.session.add(new_subscription)
|
||||
db.session.commit()
|
||||
|
||||
return {'success': True, 'subscription': new_subscription.to_dict()}
|
||||
```
|
||||
|
||||
**关键特性**:
|
||||
- ✅ 续费时从**当前订阅结束时间**开始,避免浪费
|
||||
- ✅ 每次支付都创建新的订阅记录
|
||||
- ✅ 保留历史订阅记录（通过 `previous_subscription_id` 形成链）
|
||||
- ✅ 逻辑清晰,易于理解
|
||||
|
||||
---
|
||||
|
||||
### 4. 按钮文案逻辑
|
||||
|
||||
```python
|
||||
def get_subscription_button_text(user, plan_code, billing_cycle):
|
||||
"""
|
||||
获取订阅按钮文字
|
||||
|
||||
Args:
|
||||
user: 用户对象
|
||||
plan_code: 套餐代码 (pro/max)
|
||||
billing_cycle: 计费周期
|
||||
|
||||
Returns:
|
||||
str: 按钮文字
|
||||
"""
|
||||
current_sub = get_current_subscription(user.id)
|
||||
|
||||
# 1. 如果没有订阅或订阅已过期
|
||||
if not current_sub or current_sub.plan_code == 'free' or current_sub.status != 'active':
|
||||
return f"选择 {get_plan_display_name(plan_code)}"
|
||||
|
||||
# 2. 如果是当前套餐且周期相同
|
||||
if current_sub.plan_code == plan_code and current_sub.billing_cycle == billing_cycle:
|
||||
return f"续费 {get_plan_display_name(plan_code)}"
|
||||
|
||||
# 3. 如果是当前套餐但周期不同
|
||||
if current_sub.plan_code == plan_code:
|
||||
return f"切换至{get_cycle_display_name(billing_cycle)}"
|
||||
|
||||
# 4. 如果是不同套餐
|
||||
return f"选择 {get_plan_display_name(plan_code)}"
|
||||
|
||||
def get_plan_display_name(plan_code):
|
||||
names = {'pro': 'Pro 专业版', 'max': 'Max 旗舰版'}
|
||||
return names.get(plan_code, plan_code)
|
||||
|
||||
def get_cycle_display_name(billing_cycle):
|
||||
names = {
|
||||
'monthly': '月付',
|
||||
'quarterly': '季付',
|
||||
'semiannual': '半年付',
|
||||
'yearly': '年付'
|
||||
}
|
||||
return names.get(billing_cycle, billing_cycle)
|
||||
```
|
||||
|
||||
**示例**:
|
||||
- 免费用户看 Pro 年付: "选择 Pro 专业版"
|
||||
- Pro 月付用户看 Pro 年付: "切换至年付"
|
||||
- Pro 年付用户看 Pro 年付: "续费 Pro 专业版"
|
||||
- Pro 用户看 Max 年付: "选择 Max 旗舰版"
|
||||
|
||||
---
|
||||
|
||||
## 📊 价格配置示例
|
||||
|
||||
### Pro 专业版价格设定
|
||||
|
||||
| 计费周期 | 价格 | 原价 | 折扣 | 月均价格 |
|
||||
|---------|------|------|------|---------|
|
||||
| 月付 | ¥299 | - | - | ¥299 |
|
||||
| 季付(3个月) | ¥799 | ¥897 | 11% | ¥266 |
|
||||
| 半年付(6个月) | ¥1499 | ¥1794 | 16% | ¥250 |
|
||||
| 年付(12个月) | ¥2699 | ¥3588 | 25% | ¥225 |
|
||||
|
||||
### Max 旗舰版价格设定
|
||||
|
||||
| 计费周期 | 价格 | 原价 | 折扣 | 月均价格 |
|
||||
|---------|------|------|------|---------|
|
||||
| 月付 | ¥599 | - | - | ¥599 |
|
||||
| 季付(3个月) | ¥1599 | ¥1797 | 11% | ¥533 |
|
||||
| 半年付(6个月) | ¥2999 | ¥3594 | 17% | ¥500 |
|
||||
| 年付(12个月) | ¥5399 | ¥7188 | 25% | ¥450 |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 迁移方案
|
||||
|
||||
### 数据迁移 SQL
|
||||
|
||||
参见 `database_migration.sql`
|
||||
|
||||
### 代码迁移步骤
|
||||
|
||||
1. **备份现有数据库**
|
||||
2. **执行数据库迁移 SQL**
|
||||
3. **更新数据库模型** (`models.py`)
|
||||
4. **更新价格计算逻辑** (`calculate_price.py`)
|
||||
5. **更新 API 路由** (`routes.py`)
|
||||
6. **更新前端组件** (`SubscriptionContentNew.tsx`)
|
||||
7. **测试完整流程**
|
||||
8. **灰度发布**
|
||||
|
||||
---
|
||||
|
||||
## ✅ 优势总结
|
||||
|
||||
### 相比旧系统的改进
|
||||
|
||||
1. **价格透明** - 续费用户和新用户价格完全一致
|
||||
2. **逻辑简化** - 不再计算剩余价值,代码减少 50%+
|
||||
3. **易于理解** - 用户体验更清晰
|
||||
4. **灵活扩展** - 轻松添加新的计费周期
|
||||
5. **历史追溯** - 完整的订阅历史记录
|
||||
6. **数据完整** - 每次支付都有完整的记录
|
||||
|
||||
### 用户体验改进
|
||||
|
||||
1. **按钮文案清晰** - "续费 Pro"/"选择 Pro"明确表达意图
|
||||
2. **价格一致性** - 所有用户看到的价格都一样
|
||||
3. **无隐藏费用** - 不会因为"升级折算"产生困惑
|
||||
4. **透明计费** - 支付金额 = 显示价格 - 优惠码折扣
|
||||
|
||||
---
|
||||
|
||||
## 📝 后续优化建议
|
||||
|
||||
1. **自动续费** - 到期前自动扣款续费
|
||||
2. **订阅提醒** - 到期前 7 天、3 天、1 天发送通知
|
||||
3. **订阅暂停** - 允许用户暂停订阅
|
||||
4. **订阅降级** - 从 Max 降级到 Pro（当前周期结束后生效）
|
||||
5. **发票管理** - 支持开具电子发票
|
||||
6. **支付方式扩展** - 支持支付宝、银行卡等
|
||||
|
||||
---
|
||||
|
||||
**设计时间**: 2025-11-19
|
||||
**设计者**: Claude Code
|
||||
**版本**: v2.0.0
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,255 +0,0 @@
|
||||
# PostHog 集成完成总结
|
||||
|
||||
## ✅ 已完成的工作
|
||||
|
||||
### 1. 安装依赖
|
||||
```bash
|
||||
npm install posthog-js@^1.280.1
|
||||
```
|
||||
|
||||
### 2. 创建核心文件
|
||||
|
||||
#### 📦 PostHog SDK 封装 (`src/lib/posthog.js`)
|
||||
- 提供完整的 PostHog API 封装
|
||||
- 包含函数：
|
||||
- `initPostHog()` - 初始化 SDK
|
||||
- `identifyUser()` - 识别用户
|
||||
- `trackEvent()` - 追踪自定义事件
|
||||
- `trackPageView()` - 追踪页面浏览
|
||||
- `resetUser()` - 重置用户会话（登出时调用）
|
||||
- `optIn()` / `optOut()` - 用户隐私控制
|
||||
- `getFeatureFlag()` - 获取 Feature Flag（A/B 测试）
|
||||
|
||||
#### 📊 事件常量定义 (`src/lib/constants.js`)
|
||||
基于 AARRR 框架的完整事件体系：
|
||||
- **Acquisition（获客）**: Landing Page, CTA, Pricing
|
||||
- **Activation（激活）**: Login, Signup, WeChat QR
|
||||
- **Retention（留存）**: Dashboard, News, Concept, Stock, Company
|
||||
- **Referral（推荐）**: Share, Invite
|
||||
- **Revenue（收入）**: Payment, Subscription
|
||||
|
||||
#### 🪝 React Hooks
|
||||
- `usePostHog` (`src/hooks/usePostHog.js`) - 在组件中使用 PostHog
|
||||
- `usePageTracking` (`src/hooks/usePageTracking.js`) - 自动页面浏览追踪
|
||||
|
||||
#### 🎁 Provider 组件 (`src/components/PostHogProvider.js`)
|
||||
- 全局初始化 PostHog
|
||||
- 自动追踪页面浏览
|
||||
- 根据路由自动识别页面类型
|
||||
|
||||
### 3. 集成到应用
|
||||
|
||||
#### App.js 修改
|
||||
在最外层添加了 `PostHogProvider`：
|
||||
```jsx
|
||||
<PostHogProvider>
|
||||
<ReduxProvider store={store}>
|
||||
<ChakraProvider theme={theme}>
|
||||
{/* 其他 Providers */}
|
||||
</ChakraProvider>
|
||||
</ReduxProvider>
|
||||
</PostHogProvider>
|
||||
```
|
||||
|
||||
### 4. 环境变量配置
|
||||
|
||||
`.env` 文件中添加了：
|
||||
```bash
|
||||
# PostHog API Key（需要填写你的 PostHog 项目 Key）
|
||||
REACT_APP_POSTHOG_KEY=
|
||||
|
||||
# PostHog API Host
|
||||
REACT_APP_POSTHOG_HOST=https://app.posthog.com
|
||||
|
||||
# Session Recording 开关
|
||||
REACT_APP_ENABLE_SESSION_RECORDING=false
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 如何使用
|
||||
|
||||
### 1. 配置 PostHog API Key
|
||||
|
||||
1. 登录 [PostHog](https://app.posthog.com)
|
||||
2. 创建项目（或使用现有项目）
|
||||
3. 在项目设置中找到 **API Key**
|
||||
4. 复制 API Key 并填入 `.env` 文件：
|
||||
```bash
|
||||
REACT_APP_POSTHOG_KEY=phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
||||
```
|
||||
|
||||
### 2. 自动追踪页面浏览
|
||||
|
||||
✅ **无需额外配置**，PostHogProvider 会自动追踪所有路由变化和页面浏览。
|
||||
|
||||
### 3. 追踪自定义事件
|
||||
|
||||
在任意组件中使用 `usePostHog` Hook：
|
||||
|
||||
```jsx
|
||||
import { usePostHog } from 'hooks/usePostHog';
|
||||
import { RETENTION_EVENTS } from 'lib/constants';
|
||||
|
||||
function MyComponent() {
|
||||
const { track } = usePostHog();
|
||||
|
||||
const handleClick = () => {
|
||||
track(RETENTION_EVENTS.NEWS_ARTICLE_CLICKED, {
|
||||
article_id: '12345',
|
||||
article_title: '市场分析报告',
|
||||
source: 'community_page',
|
||||
});
|
||||
};
|
||||
|
||||
return <button onClick={handleClick}>阅读文章</button>;
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 用户识别（登录时）
|
||||
|
||||
在 `AuthContext` 中，登录成功后调用：
|
||||
|
||||
```jsx
|
||||
import { identifyUser } from 'lib/posthog';
|
||||
|
||||
// 登录成功后
|
||||
identifyUser(user.id, {
|
||||
email: user.email,
|
||||
username: user.username,
|
||||
subscription_tier: user.subscription_type || 'free',
|
||||
registration_date: user.created_at,
|
||||
});
|
||||
```
|
||||
|
||||
### 5. 重置用户会话（登出时）
|
||||
|
||||
在 `AuthContext` 中，登出时调用：
|
||||
|
||||
```jsx
|
||||
import { resetUser } from 'lib/posthog';
|
||||
|
||||
// 登出时
|
||||
resetUser();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 PostHog 功能
|
||||
|
||||
### 1. 页面浏览分析
|
||||
- 自动追踪所有页面访问
|
||||
- 分析用户访问路径
|
||||
- 识别热门页面
|
||||
|
||||
### 2. 用户行为分析
|
||||
- 追踪用户点击、搜索、筛选等行为
|
||||
- 分析功能使用频率
|
||||
- 了解用户偏好
|
||||
|
||||
### 3. 漏斗分析
|
||||
- 分析用户转化路径
|
||||
- 识别流失点
|
||||
- 优化用户体验
|
||||
|
||||
### 4. 队列分析（Cohort Analysis）
|
||||
- 按注册时间、订阅类型等分组用户
|
||||
- 分析不同用户群体的行为差异
|
||||
|
||||
### 5. Session Recording（可选）
|
||||
- 录制用户操作视频
|
||||
- 可视化用户体验问题
|
||||
- 需要在 `.env` 中开启：`REACT_APP_ENABLE_SESSION_RECORDING=true`
|
||||
|
||||
### 6. Feature Flags（A/B 测试）
|
||||
```jsx
|
||||
const { getFlag, isEnabled } = usePostHog();
|
||||
|
||||
// 检查功能开关
|
||||
if (isEnabled('new_dashboard_design')) {
|
||||
return <NewDashboard />;
|
||||
} else {
|
||||
return <OldDashboard />;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔒 隐私和安全
|
||||
|
||||
### 自动隐私保护
|
||||
- 自动屏蔽密码、邮箱、手机号输入框
|
||||
- 不追踪敏感 API 端点（`/api/auth/login`, `/api/payment` 等）
|
||||
- 尊重浏览器 Do Not Track 设置
|
||||
|
||||
### 用户隐私控制
|
||||
用户可选择退出追踪：
|
||||
```jsx
|
||||
const { optOut, optIn, isOptedOut } = usePostHog();
|
||||
|
||||
// 退出追踪
|
||||
optOut();
|
||||
|
||||
// 重新加入
|
||||
optIn();
|
||||
|
||||
// 检查状态
|
||||
if (isOptedOut()) {
|
||||
console.log('用户已退出追踪');
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 下一步建议
|
||||
|
||||
### 1. 在关键页面添加事件追踪
|
||||
|
||||
例如在 **Community**、**Concept**、**Stock** 等页面添加：
|
||||
- 搜索事件
|
||||
- 点击事件
|
||||
- 筛选事件
|
||||
|
||||
### 2. 在 AuthContext 中集成用户识别
|
||||
|
||||
登录成功时调用 `identifyUser()`，登出时调用 `resetUser()`
|
||||
|
||||
### 3. 设置 Feature Flags
|
||||
|
||||
在 PostHog 后台创建 Feature Flags，用于 A/B 测试新功能
|
||||
|
||||
### 4. 配置 Dashboard 和 Insights
|
||||
|
||||
在 PostHog 后台创建：
|
||||
- 用户活跃度 Dashboard
|
||||
- 功能使用频率 Insights
|
||||
- 转化漏斗分析
|
||||
|
||||
---
|
||||
|
||||
## 📚 参考资料
|
||||
|
||||
- [PostHog 官方文档](https://posthog.com/docs)
|
||||
- [PostHog React 集成](https://posthog.com/docs/libraries/react)
|
||||
- [PostHog Feature Flags](https://posthog.com/docs/feature-flags)
|
||||
- [PostHog Session Recording](https://posthog.com/docs/session-replay)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
1. **开发环境下会自动启用调试模式**，控制台会输出详细的追踪日志
|
||||
2. **PostHog API Key 为空时**，SDK 会发出警告但不会影响应用运行
|
||||
3. **Session Recording 默认关闭**，需要时再开启以节省资源
|
||||
4. **所有事件常量已定义**在 `src/lib/constants.js`，使用时直接导入
|
||||
|
||||
---
|
||||
|
||||
**集成完成！** 🎉
|
||||
|
||||
现在你可以：
|
||||
1. 填写 PostHog API Key
|
||||
2. 启动应用：`npm start`
|
||||
3. 在 PostHog 后台查看实时数据
|
||||
|
||||
如有问题，请参考 PostHog 官方文档或联系技术支持。
|
||||
@@ -1,439 +0,0 @@
|
||||
# PostHog Redux 集成完成总结
|
||||
|
||||
## ✅ 已完成的工作
|
||||
|
||||
PostHog 已成功从 **React Context** 迁移到 **Redux** 进行全局状态管理！
|
||||
|
||||
### 1. 创建的核心文件
|
||||
|
||||
#### 📦 Redux Slice (`src/store/slices/posthogSlice.js`)
|
||||
完整的 PostHog 状态管理：
|
||||
- **State 管理**: 初始化状态、用户信息、事件队列、Feature Flags
|
||||
- **Async Thunks**:
|
||||
- `initializePostHog()` - 初始化 SDK
|
||||
- `identifyUser()` - 识别用户
|
||||
- `resetUser()` - 重置会话
|
||||
- `trackEvent()` - 追踪事件
|
||||
- `flushCachedEvents()` - 刷新离线事件
|
||||
- **Selectors**: 提供便捷的状态选择器
|
||||
|
||||
#### ⚡ Redux Middleware (`src/store/middleware/posthogMiddleware.js`)
|
||||
自动追踪中间件：
|
||||
- **自动拦截 Actions**: 当特定 Redux actions 被 dispatch 时自动追踪
|
||||
- **路由追踪**: 自动识别页面类型并追踪浏览
|
||||
- **离线事件缓存**: 网络恢复时自动刷新缓存事件
|
||||
- **性能追踪**: 追踪耗时较长的操作
|
||||
|
||||
**自动追踪的 Actions**:
|
||||
```javascript
|
||||
'auth/login/fulfilled' → USER_LOGGED_IN
|
||||
'auth/logout' → USER_LOGGED_OUT
|
||||
'communityData/fetchHotEvents/fulfilled' → NEWS_LIST_VIEWED
|
||||
'payment/success' → PAYMENT_SUCCESSFUL
|
||||
// ... 更多
|
||||
```
|
||||
|
||||
#### 🪝 React Hooks (`src/hooks/usePostHogRedux.js`)
|
||||
提供便捷的 API：
|
||||
- `usePostHogRedux()` - 完整功能 Hook
|
||||
- `usePostHogTrack()` - 仅追踪功能（性能优化）
|
||||
- `usePostHogFlags()` - 仅 Feature Flags（性能优化）
|
||||
- `usePostHogUser()` - 仅用户管理（性能优化）
|
||||
|
||||
### 2. 修改的文件
|
||||
|
||||
#### Redux Store (`src/store/index.js`)
|
||||
```javascript
|
||||
import posthogReducer from './slices/posthogSlice';
|
||||
import posthogMiddleware from './middleware/posthogMiddleware';
|
||||
|
||||
export const store = configureStore({
|
||||
reducer: {
|
||||
communityData: communityDataReducer,
|
||||
posthog: posthogReducer, // ✅ 新增
|
||||
},
|
||||
middleware: (getDefaultMiddleware) =>
|
||||
getDefaultMiddleware({...})
|
||||
.concat(posthogMiddleware), // ✅ 新增
|
||||
});
|
||||
```
|
||||
|
||||
#### App.js
|
||||
- ❌ 移除了 `<PostHogProvider>` 包装
|
||||
- ✅ 在 `AppContent` 中添加 Redux 初始化：
|
||||
```javascript
|
||||
useEffect(() => {
|
||||
dispatch(initializePostHog());
|
||||
}, [dispatch]);
|
||||
```
|
||||
|
||||
### 3. 保留的文件（仍然需要）
|
||||
|
||||
- ✅ `src/lib/posthog.js` - PostHog SDK 封装
|
||||
- ✅ `src/lib/constants.js` - 事件常量（AARRR 框架）
|
||||
- ✅ `src/hooks/usePostHog.js` - 原 Hook（可选保留，兼容旧代码）
|
||||
|
||||
### 4. 可以删除的文件（不再需要）
|
||||
|
||||
- ❌ `src/components/PostHogProvider.js` - 改用 Redux 管理
|
||||
- ❌ `src/hooks/usePageTracking.js` - 改由 Middleware 处理
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Redux 方案的优势
|
||||
|
||||
### 1. **集中式状态管理**
|
||||
PostHog 状态与其他应用状态统一管理，便于维护和调试。
|
||||
|
||||
### 2. **自动追踪**
|
||||
通过 Middleware 自动拦截 Redux actions，无需手动调用追踪。
|
||||
|
||||
```javascript
|
||||
// 旧方案（手动追踪）
|
||||
const handleLogin = () => {
|
||||
// ... 登录逻辑
|
||||
track(ACTIVATION_EVENTS.USER_LOGGED_IN, { ... });
|
||||
};
|
||||
|
||||
// 新方案（自动追踪）
|
||||
const handleLogin = () => {
|
||||
dispatch(loginUser({ ... })); // ✅ Middleware 自动追踪
|
||||
};
|
||||
```
|
||||
|
||||
### 3. **Redux DevTools 集成**
|
||||
可以在 Redux DevTools 中查看所有 PostHog 事件：
|
||||
|
||||
```
|
||||
Action: posthog/trackEvent/fulfilled
|
||||
Payload: {
|
||||
eventName: "News Article Clicked",
|
||||
properties: { article_id: "123" }
|
||||
}
|
||||
```
|
||||
|
||||
### 4. **离线事件缓存**
|
||||
自动缓存离线时的事件，网络恢复后批量发送。
|
||||
|
||||
### 5. **时间旅行调试**
|
||||
可以回放和调试用户行为，定位问题更容易。
|
||||
|
||||
---
|
||||
|
||||
## 📚 使用指南
|
||||
|
||||
### 1. 基础用法 - 追踪自定义事件
|
||||
|
||||
```jsx
|
||||
import { usePostHogRedux } from 'hooks/usePostHogRedux';
|
||||
import { RETENTION_EVENTS } from 'lib/constants';
|
||||
|
||||
function NewsArticle({ article }) {
|
||||
const { track } = usePostHogRedux();
|
||||
|
||||
const handleClick = () => {
|
||||
track(RETENTION_EVENTS.NEWS_ARTICLE_CLICKED, {
|
||||
article_id: article.id,
|
||||
article_title: article.title,
|
||||
source: 'community_page',
|
||||
});
|
||||
};
|
||||
|
||||
return <div onClick={handleClick}>{article.title}</div>;
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 用户识别（登录时）
|
||||
|
||||
在 `AuthContext` 或登录成功回调中：
|
||||
|
||||
```jsx
|
||||
import { usePostHogRedux } from 'hooks/usePostHogRedux';
|
||||
|
||||
function AuthContext() {
|
||||
const { identify, reset } = usePostHogRedux();
|
||||
|
||||
const handleLoginSuccess = (user) => {
|
||||
// 识别用户
|
||||
identify(user.id, {
|
||||
email: user.email,
|
||||
username: user.username,
|
||||
subscription_tier: user.subscription_type || 'free',
|
||||
registration_date: user.created_at,
|
||||
});
|
||||
};
|
||||
|
||||
const handleLogout = () => {
|
||||
// 重置用户会话
|
||||
reset();
|
||||
};
|
||||
|
||||
return { handleLoginSuccess, handleLogout };
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Feature Flags（A/B 测试）
|
||||
|
||||
```jsx
|
||||
import { usePostHogFlags } from 'hooks/usePostHogRedux';
|
||||
|
||||
function Dashboard() {
|
||||
const { isEnabled } = usePostHogFlags();
|
||||
|
||||
if (isEnabled('new_dashboard_design')) {
|
||||
return <NewDashboard />;
|
||||
}
|
||||
|
||||
return <OldDashboard />;
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 自动追踪（推荐）
|
||||
|
||||
**无需手动追踪**，只需 dispatch Redux action，Middleware 会自动处理：
|
||||
|
||||
```jsx
|
||||
// ✅ 登录时自动追踪
|
||||
dispatch(loginUser({ email, password }));
|
||||
// → Middleware 自动追踪 USER_LOGGED_IN
|
||||
|
||||
// ✅ 获取新闻时自动追踪
|
||||
dispatch(fetchHotEvents());
|
||||
// → Middleware 自动追踪 NEWS_LIST_VIEWED
|
||||
|
||||
// ✅ 支付成功时自动追踪
|
||||
dispatch(paymentSuccess({ amount, transactionId }));
|
||||
// → Middleware 自动追踪 PAYMENT_SUCCESSFUL
|
||||
```
|
||||
|
||||
### 5. 性能优化 Hook
|
||||
|
||||
如果只需要追踪功能，使用轻量级 Hook：
|
||||
|
||||
```jsx
|
||||
import { usePostHogTrack } from 'hooks/usePostHogRedux';
|
||||
|
||||
function MyComponent() {
|
||||
const { track } = usePostHogTrack(); // ✅ 只订阅追踪功能
|
||||
|
||||
// 不会因为 PostHog 状态变化而重新渲染
|
||||
return <button onClick={() => track('Button Clicked')}>Click</button>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 配置自动追踪规则
|
||||
|
||||
在 `src/store/middleware/posthogMiddleware.js` 中添加新规则：
|
||||
|
||||
```javascript
|
||||
const ACTION_TO_EVENT_MAP = {
|
||||
// 添加你的 action
|
||||
'myFeature/actionName': {
|
||||
event: RETENTION_EVENTS.MY_EVENT,
|
||||
getProperties: (action) => ({
|
||||
property1: action.payload?.value1,
|
||||
property2: action.payload?.value2,
|
||||
}),
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 调试技巧
|
||||
|
||||
### 1. Redux DevTools
|
||||
|
||||
打开 Redux DevTools，筛选 `posthog/` actions：
|
||||
|
||||
```
|
||||
posthog/initializePostHog/fulfilled
|
||||
posthog/identifyUser/fulfilled
|
||||
posthog/trackEvent/fulfilled
|
||||
```
|
||||
|
||||
### 2. 查看 PostHog 状态
|
||||
|
||||
```jsx
|
||||
import { useSelector } from 'react-redux';
|
||||
import { selectPostHog } from 'store/slices/posthogSlice';
|
||||
|
||||
function DebugPanel() {
|
||||
const posthog = useSelector(selectPostHog);
|
||||
|
||||
return (
|
||||
<pre>{JSON.stringify(posthog, null, 2)}</pre>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 控制台日志
|
||||
|
||||
开发环境下会自动输出日志：
|
||||
|
||||
```
|
||||
[PostHog Middleware] 自动追踪事件: User Logged In { user_id: 123 }
|
||||
[PostHog] 📍 Event tracked: News Article Clicked
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 State 结构
|
||||
|
||||
```javascript
|
||||
{
|
||||
posthog: {
|
||||
// 初始化状态
|
||||
isInitialized: true,
|
||||
initError: null,
|
||||
|
||||
// 用户信息
|
||||
user: {
|
||||
userId: "123",
|
||||
email: "user@example.com",
|
||||
subscription_tier: "pro"
|
||||
},
|
||||
|
||||
// 事件队列（离线缓存）
|
||||
eventQueue: [
|
||||
{ eventName: "...", properties: {...}, timestamp: "..." }
|
||||
],
|
||||
|
||||
// Feature Flags
|
||||
featureFlags: {
|
||||
new_dashboard_design: true,
|
||||
beta_feature: false
|
||||
},
|
||||
|
||||
// 配置
|
||||
config: {
|
||||
apiKey: "phc_...",
|
||||
apiHost: "https://app.posthog.com",
|
||||
sessionRecording: false
|
||||
},
|
||||
|
||||
// 统计
|
||||
stats: {
|
||||
totalEvents: 150,
|
||||
lastEventTime: "2025-10-28T12:00:00Z"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 高级功能
|
||||
|
||||
### 1. 手动触发页面浏览
|
||||
|
||||
```jsx
|
||||
import { trackModalView, trackTabChange } from 'store/middleware/posthogMiddleware';
|
||||
|
||||
// Modal 打开时
|
||||
dispatch(trackModalView('User Settings Modal', { source: 'nav_bar' }));
|
||||
|
||||
// Tab 切换时
|
||||
dispatch(trackTabChange('Related Stocks', { from_tab: 'Overview' }));
|
||||
```
|
||||
|
||||
### 2. 刷新离线事件
|
||||
|
||||
```jsx
|
||||
import { flushCachedEvents } from 'store/slices/posthogSlice';
|
||||
|
||||
// 网络恢复时自动触发，也可以手动触发
|
||||
dispatch(flushCachedEvents());
|
||||
```
|
||||
|
||||
### 3. 性能追踪
|
||||
|
||||
给 action 添加时间戳：
|
||||
|
||||
```jsx
|
||||
import { withTiming } from 'store/middleware/posthogMiddleware';
|
||||
|
||||
// 追踪耗时操作
|
||||
dispatch(withTiming(fetchBigData()));
|
||||
// → 如果超过 1 秒，会自动追踪性能事件
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
### 1. **环境变量**
|
||||
|
||||
确保 `.env` 文件中配置了 PostHog API Key：
|
||||
|
||||
```bash
|
||||
REACT_APP_POSTHOG_KEY=phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
||||
REACT_APP_POSTHOG_HOST=https://app.posthog.com
|
||||
REACT_APP_ENABLE_SESSION_RECORDING=false
|
||||
```
|
||||
|
||||
### 2. **Redux Middleware 顺序**
|
||||
|
||||
PostHog Middleware 应该在其他 middleware 之后：
|
||||
|
||||
```javascript
|
||||
.concat(otherMiddleware)
|
||||
.concat(posthogMiddleware) // ✅ 最后添加
|
||||
```
|
||||
|
||||
### 3. **避免循环依赖**
|
||||
|
||||
不要在 Middleware 中 dispatch 会触发 Middleware 的 action。
|
||||
|
||||
### 4. **序列化检查**
|
||||
|
||||
已经在 store 配置中忽略了 PostHog actions 的序列化检查。
|
||||
|
||||
---
|
||||
|
||||
## 🔄 从旧版本迁移
|
||||
|
||||
如果你的代码中使用了旧的 `usePostHog` Hook：
|
||||
|
||||
```jsx
|
||||
// 旧代码
|
||||
import { usePostHog } from 'hooks/usePostHog';
|
||||
const { track } = usePostHog();
|
||||
|
||||
// 新代码（推荐）
|
||||
import { usePostHogRedux } from 'hooks/usePostHogRedux';
|
||||
const { track } = usePostHogRedux();
|
||||
```
|
||||
|
||||
**兼容性**: 旧的 `usePostHog` Hook 仍然可用，但推荐迁移到 Redux 版本。
|
||||
|
||||
---
|
||||
|
||||
## 📚 参考资料
|
||||
|
||||
- [PostHog 官方文档](https://posthog.com/docs)
|
||||
- [Redux Toolkit 文档](https://redux-toolkit.js.org/)
|
||||
- [Redux Middleware 文档](https://redux.js.org/tutorials/fundamentals/part-4-store#middleware)
|
||||
- [AARRR 框架](https://www.productplan.com/glossary/aarrr-framework/)
|
||||
|
||||
---
|
||||
|
||||
## 🎉 总结
|
||||
|
||||
PostHog 已成功集成到 Redux！主要优势：
|
||||
|
||||
1. ✅ **自动追踪**: Middleware 自动拦截 actions
|
||||
2. ✅ **集中管理**: 统一的 Redux 状态管理
|
||||
3. ✅ **调试友好**: Redux DevTools 支持
|
||||
4. ✅ **离线支持**: 自动缓存和刷新事件
|
||||
5. ✅ **性能优化**: 提供多个轻量级 Hooks
|
||||
|
||||
现在你可以：
|
||||
1. 启动应用：`npm start`
|
||||
2. 打开 Redux DevTools 查看 PostHog 状态
|
||||
3. 执行操作（登录、浏览页面、点击按钮）
|
||||
4. 观察自动追踪的事件
|
||||
|
||||
Have fun tracking! 🚀
|
||||
@@ -1,476 +0,0 @@
|
||||
# PostHog 本地上报能力测试指南
|
||||
|
||||
本文档指导您完成 PostHog 事件追踪功能的完整测试。
|
||||
|
||||
---
|
||||
|
||||
## 📋 准备工作
|
||||
|
||||
### 步骤 1：获取 PostHog API Key
|
||||
|
||||
#### 1.1 登录 PostHog
|
||||
|
||||
打开浏览器，访问：
|
||||
```
|
||||
https://app.posthog.com
|
||||
```
|
||||
|
||||
使用您的账号登录。
|
||||
|
||||
#### 1.2 创建测试项目（如果还没有）
|
||||
|
||||
1. 点击页面左上角的项目切换器
|
||||
2. 点击 "+ Create Project"
|
||||
3. 填写项目信息：
|
||||
- **Project name**: `vf_react_dev`（推荐）或自定义名称
|
||||
- **Organization**: 选择您的组织
|
||||
4. 点击 "Create Project"
|
||||
|
||||
#### 1.3 获取 API Key
|
||||
|
||||
1. 进入项目设置：
|
||||
- 点击左侧边栏底部的 **"Settings"** ⚙️
|
||||
- 选择 **"Project"** 标签
|
||||
|
||||
2. 找到 "Project API Key" 部分
|
||||
- 您会看到一个以 `phc_` 开头的长字符串
|
||||
- 例如：`phc_abcdefghijklmnopqrstuvwxyz1234567890`
|
||||
|
||||
3. 复制 API Key
|
||||
- 点击 API Key 右侧的复制按钮 📋
|
||||
- 或手动选中并复制
|
||||
|
||||
---
|
||||
|
||||
## 🔧 配置本地环境
|
||||
|
||||
### 步骤 2：配置 .env.local
|
||||
|
||||
打开项目根目录的 `.env.local` 文件，找到以下行：
|
||||
|
||||
```env
|
||||
REACT_APP_POSTHOG_KEY=
|
||||
```
|
||||
|
||||
将您刚才复制的 API Key 粘贴进去：
|
||||
|
||||
```env
|
||||
REACT_APP_POSTHOG_KEY=phc_your_actual_key_here
|
||||
```
|
||||
|
||||
**完整示例：**
|
||||
```env
|
||||
# PostHog 配置（本地开发）
|
||||
REACT_APP_POSTHOG_KEY=phc_abcdefghijklmnopqrstuvwxyz1234567890
|
||||
REACT_APP_POSTHOG_HOST=https://app.posthog.com
|
||||
REACT_APP_ENABLE_SESSION_RECORDING=false
|
||||
```
|
||||
|
||||
⚠️ **重要**：保存文件后必须重启应用才能生效！
|
||||
|
||||
---
|
||||
|
||||
## 🚀 启动应用
|
||||
|
||||
### 步骤 3：重启开发服务器
|
||||
|
||||
如果应用正在运行，先停止它：
|
||||
|
||||
```bash
|
||||
# 方式 1：使用命令
|
||||
npm run kill-port
|
||||
|
||||
# 方式 2：在终端按 Ctrl+C
|
||||
```
|
||||
|
||||
然后重新启动：
|
||||
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
|
||||
### 步骤 4：验证初始化
|
||||
|
||||
应用启动后，打开浏览器：
|
||||
|
||||
```
|
||||
http://localhost:3000
|
||||
```
|
||||
|
||||
**立即按 F12 打开浏览器控制台**，您应该看到以下日志：
|
||||
|
||||
```javascript
|
||||
✅ PostHog initialized successfully
|
||||
📊 PostHog Analytics initialized
|
||||
👤 User identified: user_xxx (如果已登录)
|
||||
```
|
||||
|
||||
✅ **如果看到以上日志，说明 PostHog 初始化成功！**
|
||||
|
||||
---
|
||||
|
||||
## 🧪 测试事件追踪
|
||||
|
||||
### 测试 1：页面浏览事件
|
||||
|
||||
#### 操作步骤：
|
||||
1. 访问首页：http://localhost:3000
|
||||
2. 导航到社区页面：点击导航栏 "社区"
|
||||
3. 导航到个股中心：点击导航栏 "个股中心"
|
||||
4. 导航到概念中心：点击导航栏 "概念中心"
|
||||
5. 导航到涨停分析：点击导航栏 "涨停分析"
|
||||
|
||||
#### 期待结果：
|
||||
|
||||
**控制台输出：**
|
||||
```javascript
|
||||
[PostHog] Event: $pageview
|
||||
Properties: {
|
||||
$current_url: "http://localhost:3000/community",
|
||||
page_path: "/community",
|
||||
page_type: "feature",
|
||||
feature_name: "community"
|
||||
}
|
||||
```
|
||||
|
||||
**验证方法：**
|
||||
1. 打开 PostHog Dashboard
|
||||
2. 进入 **"Activity" → "Live Events"**
|
||||
3. 观察实时事件流（延迟 1-2 秒）
|
||||
4. 应该看到 `$pageview` 事件，每次页面切换一个
|
||||
|
||||
---
|
||||
|
||||
### 测试 2：社区页面交互事件
|
||||
|
||||
#### 操作步骤：
|
||||
|
||||
1. **搜索功能**
|
||||
- 点击搜索框
|
||||
- 输入 "科技"
|
||||
- 按回车搜索
|
||||
|
||||
2. **筛选功能**
|
||||
- 点击 "筛选" 按钮
|
||||
- 选择某个筛选条件
|
||||
- 应用筛选
|
||||
|
||||
3. **内容交互**
|
||||
- 点击任意帖子卡片
|
||||
- 点击用户头像
|
||||
|
||||
#### 期待结果：
|
||||
|
||||
**控制台输出：**
|
||||
```javascript
|
||||
📍 Event tracked: search_initiated
|
||||
context: "community"
|
||||
|
||||
📍 Event tracked: search_query_submitted
|
||||
query: "科技"
|
||||
category: "community"
|
||||
|
||||
📍 Event tracked: filter_applied
|
||||
filter_type: "category"
|
||||
filter_value: "tech"
|
||||
|
||||
📍 Event tracked: post_clicked
|
||||
post_id: "123"
|
||||
post_title: "标题"
|
||||
```
|
||||
|
||||
**PostHog Live Events：**
|
||||
```
|
||||
🔴 search_initiated
|
||||
🔴 search_query_submitted
|
||||
🔴 filter_applied
|
||||
🔴 post_clicked
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 测试 3：个股中心交互事件
|
||||
|
||||
#### 操作步骤：
|
||||
|
||||
1. **搜索股票**
|
||||
- 进入个股中心页面
|
||||
- 点击搜索框
|
||||
- 输入股票名称或代码
|
||||
|
||||
2. **概念交互**
|
||||
- 点击某个概念板块
|
||||
- 点击概念下的股票
|
||||
|
||||
3. **热力图交互**
|
||||
- 点击热力图中的股票方块
|
||||
- 查看股票详情
|
||||
|
||||
#### 期待结果：
|
||||
|
||||
**控制台输出：**
|
||||
```javascript
|
||||
📍 Event tracked: stock_overview_page_viewed
|
||||
|
||||
📍 Event tracked: stock_searched
|
||||
query: "科技股"
|
||||
|
||||
📍 Event tracked: concept_clicked
|
||||
concept_name: "人工智能"
|
||||
|
||||
📍 Event tracked: concept_stock_clicked
|
||||
stock_code: "000001"
|
||||
stock_name: "平安银行"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 测试 4：概念中心交互事件
|
||||
|
||||
#### 操作步骤：
|
||||
|
||||
1. **列表浏览**
|
||||
- 进入概念中心
|
||||
- 切换排序方式
|
||||
|
||||
2. **时间线查看**
|
||||
- 点击某个概念卡片
|
||||
- 打开时间线 Modal
|
||||
- 展开某个日期
|
||||
- 点击新闻/报告
|
||||
|
||||
#### 期待结果：
|
||||
|
||||
**控制台输出：**
|
||||
```javascript
|
||||
📍 Event tracked: concept_list_viewed
|
||||
sort_by: "change_percent_desc"
|
||||
|
||||
📍 Event tracked: concept_clicked
|
||||
concept_name: "芯片"
|
||||
|
||||
📍 Event tracked: concept_detail_viewed
|
||||
concept_name: "芯片"
|
||||
view_type: "timeline_modal"
|
||||
|
||||
📍 Event tracked: timeline_date_toggled
|
||||
date: "2025-01-15"
|
||||
action: "expand"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 测试 5：涨停分析交互事件
|
||||
|
||||
#### 操作步骤：
|
||||
|
||||
1. **日期选择**
|
||||
- 进入涨停分析页面
|
||||
- 选择不同日期
|
||||
|
||||
2. **板块交互**
|
||||
- 展开某个板块
|
||||
- 点击板块名称
|
||||
|
||||
3. **股票交互**
|
||||
- 点击涨停股票
|
||||
- 查看详情
|
||||
|
||||
#### 期待结果：
|
||||
|
||||
**控制台输出：**
|
||||
```javascript
|
||||
📍 Event tracked: limit_analyse_page_viewed
|
||||
|
||||
📍 Event tracked: date_selected
|
||||
date: "20250115"
|
||||
|
||||
📍 Event tracked: sector_toggled
|
||||
sector_name: "科技"
|
||||
action: "expand"
|
||||
|
||||
📍 Event tracked: limit_stock_clicked
|
||||
stock_code: "000001"
|
||||
stock_name: "平安银行"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 验证上报结果
|
||||
|
||||
### 在 PostHog Dashboard 验证
|
||||
|
||||
#### 步骤 1：打开 Live Events
|
||||
|
||||
1. 登录 PostHog Dashboard
|
||||
2. 选择您的测试项目
|
||||
3. 点击左侧菜单 **"Activity"**
|
||||
4. 选择 **"Live Events"**
|
||||
|
||||
#### 步骤 2：观察实时事件流
|
||||
|
||||
您应该看到实时的事件流，格式类似：
|
||||
|
||||
```
|
||||
🔴 LIVE $pageview 1s ago
|
||||
page_path: /community
|
||||
user_id: anonymous_abc123
|
||||
|
||||
🔴 LIVE search_initiated 2s ago
|
||||
context: community
|
||||
|
||||
🔴 LIVE search_query_submitted 3s ago
|
||||
query: "科技"
|
||||
category: "community"
|
||||
```
|
||||
|
||||
#### 步骤 3：检查事件属性
|
||||
|
||||
点击任意事件，展开详情，验证：
|
||||
- ✅ 事件名称正确
|
||||
- ✅ 所有属性完整
|
||||
- ✅ 时间戳准确
|
||||
- ✅ 用户信息正确
|
||||
|
||||
---
|
||||
|
||||
## 📋 测试清单
|
||||
|
||||
使用以下清单记录测试结果：
|
||||
|
||||
### 页面浏览事件（5项）
|
||||
|
||||
- [ ] 首页浏览 - `$pageview`
|
||||
- [ ] 社区页面浏览 - `community_page_viewed`
|
||||
- [ ] 个股中心浏览 - `stock_overview_page_viewed`
|
||||
- [ ] 概念中心浏览 - `concept_page_viewed`
|
||||
- [ ] 涨停分析浏览 - `limit_analyse_page_viewed`
|
||||
|
||||
### 社区页面事件（6项）
|
||||
|
||||
- [ ] 搜索初始化 - `search_initiated`
|
||||
- [ ] 搜索查询提交 - `search_query_submitted`
|
||||
- [ ] 筛选器应用 - `filter_applied`
|
||||
- [ ] 帖子点击 - `post_clicked`
|
||||
- [ ] 评论点击 - `comment_clicked`
|
||||
- [ ] 用户资料查看 - `user_profile_viewed`
|
||||
|
||||
### 个股中心事件（4项）
|
||||
|
||||
- [ ] 股票搜索 - `stock_searched`
|
||||
- [ ] 概念点击 - `concept_clicked`
|
||||
- [ ] 概念股票点击 - `concept_stock_clicked`
|
||||
- [ ] 热力图股票点击 - `heatmap_stock_clicked`
|
||||
|
||||
### 概念中心事件（5项）
|
||||
|
||||
- [ ] 概念列表查看 - `concept_list_viewed`
|
||||
- [ ] 排序更改 - `sort_changed`
|
||||
- [ ] 概念点击 - `concept_clicked`
|
||||
- [ ] 概念详情查看 - `concept_detail_viewed`
|
||||
- [ ] 新闻/报告点击 - `news_clicked` / `report_clicked`
|
||||
|
||||
### 涨停分析事件（6项）
|
||||
|
||||
- [ ] 页面查看 - `limit_analyse_page_viewed`
|
||||
- [ ] 日期选择 - `date_selected`
|
||||
- [ ] 每日统计查看 - `daily_stats_viewed`
|
||||
- [ ] 板块展开/收起 - `sector_toggled`
|
||||
- [ ] 板块点击 - `sector_clicked`
|
||||
- [ ] 涨停股票点击 - `limit_stock_clicked`
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 常见问题
|
||||
|
||||
### 问题 1：控制台没有看到 PostHog 日志
|
||||
|
||||
**可能原因：**
|
||||
- API Key 配置错误
|
||||
- 应用没有重启
|
||||
- 浏览器控制台过滤了日志
|
||||
|
||||
**解决方案：**
|
||||
1. 检查 `.env.local` 中的 API Key 是否正确
|
||||
2. 确保重启了应用：`npm run kill-port && npm start`
|
||||
3. 打开控制台，清除所有过滤器
|
||||
4. 刷新页面
|
||||
|
||||
---
|
||||
|
||||
### 问题 2：PostHog Live Events 没有数据
|
||||
|
||||
**可能原因：**
|
||||
- 网络问题
|
||||
- API Key 错误
|
||||
- 项目选择错误
|
||||
|
||||
**解决方案：**
|
||||
1. 打开浏览器网络面板（Network）
|
||||
2. 筛选 XHR 请求，查找 `posthog.com` 的请求
|
||||
3. 检查请求状态码：
|
||||
- `200 OK` → 正常
|
||||
- `401 Unauthorized` → API Key 错误
|
||||
- `404 Not Found` → 项目不存在
|
||||
4. 确认 PostHog Dashboard 选择了正确的项目
|
||||
|
||||
---
|
||||
|
||||
### 问题 3：事件上报了，但属性不完整
|
||||
|
||||
**可能原因：**
|
||||
- 代码中传递的参数不完整
|
||||
- 某些状态未正确初始化
|
||||
|
||||
**解决方案：**
|
||||
1. 查看控制台的详细日志
|
||||
2. 对比 PostHog Live Events 中的数据
|
||||
3. 检查对应的事件追踪代码
|
||||
4. 提供反馈给开发团队
|
||||
|
||||
---
|
||||
|
||||
## 📸 测试截图建议
|
||||
|
||||
为了完整记录测试结果，建议截图：
|
||||
|
||||
1. **PostHog 初始化成功**
|
||||
- 浏览器控制台初始化日志
|
||||
|
||||
2. **Live Events 实时流**
|
||||
- PostHog Dashboard Live Events 页面
|
||||
|
||||
3. **典型事件详情**
|
||||
- 展开某个事件，显示所有属性
|
||||
|
||||
4. **事件统计**
|
||||
- PostHog Insights 或 Trends 页面
|
||||
|
||||
---
|
||||
|
||||
## ✅ 测试完成后
|
||||
|
||||
测试完成后，您可以：
|
||||
|
||||
1. **保持配置**
|
||||
- 保留 API Key 在 `.env.local` 中
|
||||
- 继续使用控制台 + PostHog Cloud 双模式
|
||||
|
||||
2. **切换回仅控制台模式**
|
||||
- 清空 `.env.local` 中的 `REACT_APP_POSTHOG_KEY`
|
||||
- 重启应用
|
||||
- 仅在控制台查看事件（不上报）
|
||||
|
||||
3. **配置生产环境**
|
||||
- 创建生产环境的 PostHog 项目
|
||||
- 将生产 API Key 填入 `.env` 文件
|
||||
- 部署时使用生产配置
|
||||
|
||||
---
|
||||
|
||||
**祝测试顺利！** 🎉
|
||||
|
||||
如有任何问题，请查阅：
|
||||
- [PostHog 官方文档](https://posthog.com/docs)
|
||||
- [ENVIRONMENT_SETUP.md](./ENVIRONMENT_SETUP.md)
|
||||
- [POSTHOG_INTEGRATION.md](./POSTHOG_INTEGRATION.md)
|
||||
@@ -1,561 +0,0 @@
|
||||
# PostHog 事件追踪开发者指南
|
||||
|
||||
## 📚 目录
|
||||
|
||||
1. [快速开始](#快速开始)
|
||||
2. [Hook使用指南](#hook使用指南)
|
||||
3. [添加新的追踪Hook](#添加新的追踪hook)
|
||||
4. [集成追踪到组件](#集成追踪到组件)
|
||||
5. [最佳实践](#最佳实践)
|
||||
6. [常见问题](#常见问题)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 当前已有的追踪Hooks
|
||||
|
||||
| Hook名称 | 用途 | 适用场景 |
|
||||
|---------|------|---------|
|
||||
| `useAuthEvents` | 认证事件 | 注册、登录、登出、微信授权 |
|
||||
| `useStockOverviewEvents` | 个股分析 | 个股页面浏览、图表查看、指标分析 |
|
||||
| `useConceptEvents` | 概念追踪 | 概念浏览、搜索、相关股票查看 |
|
||||
| `useCompanyEvents` | 公司分析 | 公司详情、财务数据、行业对比 |
|
||||
| `useLimitAnalyseEvents` | 涨停分析 | 涨停榜单、筛选、个股详情 |
|
||||
| `useCommunityEvents` | 社区事件 | 新闻浏览、事件追踪、评论互动 |
|
||||
| `useEventDetailEvents` | 事件详情 | 事件分析、时间线、影响评估 |
|
||||
| `useDashboardEvents` | 仪表板 | 自选股、关注事件、评论管理 |
|
||||
| `useTradingSimulationEvents` | 模拟盘 | 下单、持仓、收益追踪 |
|
||||
| `useSearchEvents` | 搜索行为 | 搜索查询、结果点击、筛选 |
|
||||
| `useNavigationEvents` | 导航交互 | 菜单点击、主题切换、Logo点击 |
|
||||
| `useProfileEvents` | 个人资料 | 资料更新、密码修改、账号绑定 |
|
||||
| `useSubscriptionEvents` | 订阅支付 | 定价选择、支付流程、订阅管理 |
|
||||
|
||||
---
|
||||
|
||||
## 📖 Hook使用指南
|
||||
|
||||
### 1. 基础用法
|
||||
|
||||
```javascript
|
||||
// 第一步：导入Hook
|
||||
import { useSearchEvents } from '../../hooks/useSearchEvents';
|
||||
|
||||
// 第二步：在组件中初始化
|
||||
function SearchComponent() {
|
||||
const searchEvents = useSearchEvents({ context: 'global' });
|
||||
|
||||
// 第三步：在事件处理函数中调用追踪方法
|
||||
const handleSearch = (query) => {
|
||||
searchEvents.trackSearchQuerySubmitted(query, resultCount);
|
||||
// ... 执行搜索逻辑
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 带参数的Hook初始化
|
||||
|
||||
大多数Hook支持配置参数，用于区分不同的使用场景：
|
||||
|
||||
```javascript
|
||||
// 搜索Hook - 指定搜索上下文
|
||||
const searchEvents = useSearchEvents({
|
||||
context: 'community' // 或 'stock', 'news', 'concept'
|
||||
});
|
||||
|
||||
// 个人资料Hook - 指定页面类型
|
||||
const profileEvents = useProfileEvents({
|
||||
pageType: 'settings' // 或 'profile', 'security'
|
||||
});
|
||||
|
||||
// 导航Hook - 指定组件位置
|
||||
const navEvents = useNavigationEvents({
|
||||
component: 'top_nav' // 或 'sidebar', 'footer'
|
||||
});
|
||||
|
||||
// 订阅Hook - 传入当前订阅信息
|
||||
const subscriptionEvents = useSubscriptionEvents({
|
||||
currentSubscription: {
|
||||
plan: user?.subscription_plan || 'free',
|
||||
status: user?.subscription_status || 'none'
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
### 3. 常见追踪模式
|
||||
|
||||
#### 模式A：简单事件追踪
|
||||
```javascript
|
||||
// 点击事件
|
||||
<Button onClick={() => {
|
||||
navEvents.trackMenuItemClicked('概念中心', 'dropdown', '/concepts');
|
||||
navigate('/concepts');
|
||||
}}>
|
||||
概念中心
|
||||
</Button>
|
||||
```
|
||||
|
||||
#### 模式B：成功/失败双向追踪
|
||||
```javascript
|
||||
const handleSave = async () => {
|
||||
try {
|
||||
await saveData();
|
||||
profileEvents.trackProfileUpdated(updatedFields, data);
|
||||
toast({ title: "保存成功" });
|
||||
} catch (error) {
|
||||
profileEvents.trackProfileUpdateFailed(attemptedFields, error.message);
|
||||
toast({ title: "保存失败" });
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
#### 模式C：条件追踪
|
||||
```javascript
|
||||
const handleSearch = (query, resultCount) => {
|
||||
// 只在有查询词时追踪
|
||||
if (query) {
|
||||
searchEvents.trackSearchQuerySubmitted(query, resultCount);
|
||||
}
|
||||
|
||||
// 无结果时自动触发额外追踪
|
||||
if (resultCount === 0) {
|
||||
// Hook内部已自动追踪 SEARCH_NO_RESULTS
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔨 添加新的追踪Hook
|
||||
|
||||
### 步骤1：创建Hook文件
|
||||
|
||||
在 `/src/hooks/` 目录下创建新文件，例如 `useYourFeatureEvents.js`：
|
||||
|
||||
```javascript
|
||||
// src/hooks/useYourFeatureEvents.js
|
||||
import { useCallback } from 'react';
|
||||
import { usePostHogTrack } from './usePostHogRedux';
|
||||
import { RETENTION_EVENTS } from '../lib/constants';
|
||||
import { logger } from '../utils/logger';
|
||||
|
||||
/**
|
||||
* 你的功能事件追踪 Hook
|
||||
* @param {Object} options - 配置选项
|
||||
* @param {string} options.context - 使用上下文
|
||||
* @returns {Object} 事件追踪处理函数集合
|
||||
*/
|
||||
export const useYourFeatureEvents = ({ context = 'default' } = {}) => {
|
||||
const { track } = usePostHogTrack();
|
||||
|
||||
/**
|
||||
* 追踪功能操作
|
||||
* @param {string} actionName - 操作名称
|
||||
* @param {Object} details - 操作详情
|
||||
*/
|
||||
const trackFeatureAction = useCallback((actionName, details = {}) => {
|
||||
if (!actionName) {
|
||||
logger.warn('useYourFeatureEvents', 'trackFeatureAction: actionName is required');
|
||||
return;
|
||||
}
|
||||
|
||||
track(RETENTION_EVENTS.FEATURE_USED, {
|
||||
feature_name: 'your_feature',
|
||||
action_name: actionName,
|
||||
context,
|
||||
...details,
|
||||
timestamp: new Date().toISOString(),
|
||||
});
|
||||
|
||||
logger.debug('useYourFeatureEvents', '📊 Feature Action Tracked', {
|
||||
actionName,
|
||||
context,
|
||||
});
|
||||
}, [track, context]);
|
||||
|
||||
return {
|
||||
trackFeatureAction,
|
||||
// ... 更多追踪方法
|
||||
};
|
||||
};
|
||||
|
||||
export default useYourFeatureEvents;
|
||||
```
|
||||
|
||||
### 步骤2：定义事件常量（如需要）
|
||||
|
||||
在 `/src/lib/constants.js` 中添加新事件：
|
||||
|
||||
```javascript
|
||||
export const RETENTION_EVENTS = {
|
||||
// ... 现有事件
|
||||
YOUR_FEATURE_VIEWED: 'Your Feature Viewed',
|
||||
YOUR_FEATURE_ACTION: 'Your Feature Action',
|
||||
};
|
||||
```
|
||||
|
||||
### 步骤3：在组件中集成
|
||||
|
||||
```javascript
|
||||
import { useYourFeatureEvents } from '../../hooks/useYourFeatureEvents';
|
||||
|
||||
function YourComponent() {
|
||||
const featureEvents = useYourFeatureEvents({ context: 'main_page' });
|
||||
|
||||
const handleAction = () => {
|
||||
featureEvents.trackFeatureAction('button_clicked', {
|
||||
button_name: 'submit',
|
||||
user_role: user?.role
|
||||
});
|
||||
};
|
||||
|
||||
return <Button onClick={handleAction}>Submit</Button>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 集成追踪到组件
|
||||
|
||||
### 完整集成示例
|
||||
|
||||
```javascript
|
||||
// src/views/YourFeature/YourComponent.js
|
||||
import React, { useState, useEffect } from 'react';
|
||||
import { useYourFeatureEvents } from '../../hooks/useYourFeatureEvents';
|
||||
|
||||
export default function YourComponent() {
|
||||
const [data, setData] = useState([]);
|
||||
|
||||
// 🎯 初始化追踪Hook
|
||||
const featureEvents = useYourFeatureEvents({
|
||||
context: 'your_feature'
|
||||
});
|
||||
|
||||
// 🎯 页面加载时自动追踪
|
||||
useEffect(() => {
|
||||
featureEvents.trackPageViewed();
|
||||
}, [featureEvents]);
|
||||
|
||||
// 🎯 用户操作追踪
|
||||
const handleItemClick = (item) => {
|
||||
featureEvents.trackItemClicked(item.id, item.name);
|
||||
// ... 业务逻辑
|
||||
};
|
||||
|
||||
// 🎯 表单提交追踪（成功/失败）
|
||||
const handleSubmit = async (formData) => {
|
||||
try {
|
||||
const result = await submitData(formData);
|
||||
featureEvents.trackSubmitSuccess(formData, result);
|
||||
toast({ title: '提交成功' });
|
||||
} catch (error) {
|
||||
featureEvents.trackSubmitFailed(formData, error.message);
|
||||
toast({ title: '提交失败' });
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
{data.map(item => (
|
||||
<div key={item.id} onClick={() => handleItemClick(item)}>
|
||||
{item.name}
|
||||
</div>
|
||||
))}
|
||||
<form onSubmit={handleSubmit}>
|
||||
{/* 表单内容 */}
|
||||
</form>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ 最佳实践
|
||||
|
||||
### 1. 命名规范
|
||||
|
||||
#### Hook命名
|
||||
- 使用 `use` 前缀：`useFeatureEvents`
|
||||
- 描述性名称：`useSubscriptionEvents` 而非 `useSubEvents`
|
||||
|
||||
#### 追踪方法命名
|
||||
- 使用 `track` 前缀：`trackButtonClicked`
|
||||
- 动词+名词结构：`trackSearchSubmitted`, `trackProfileUpdated`
|
||||
- 明确动作：`trackPaymentSuccessful` 而非 `trackPayment`
|
||||
|
||||
#### 事件常量命名
|
||||
- 大写+下划线：`SEARCH_QUERY_SUBMITTED`
|
||||
- 名词+动词结构：`PROFILE_UPDATED`, `PAYMENT_INITIATED`
|
||||
|
||||
### 2. 参数设计
|
||||
|
||||
#### 必填参数前置
|
||||
```javascript
|
||||
// ✅ 好的设计
|
||||
trackSearchSubmitted(query, resultCount, filters)
|
||||
|
||||
// ❌ 不好的设计
|
||||
trackSearchSubmitted(filters, resultCount, query)
|
||||
```
|
||||
|
||||
#### 使用对象参数处理复杂数据
|
||||
```javascript
|
||||
// ✅ 好的设计
|
||||
trackPaymentInitiated({
|
||||
planName: 'pro',
|
||||
amount: 99,
|
||||
currency: 'CNY',
|
||||
paymentMethod: 'wechat_pay'
|
||||
})
|
||||
|
||||
// ❌ 不好的设计
|
||||
trackPaymentInitiated(planName, amount, currency, paymentMethod)
|
||||
```
|
||||
|
||||
#### 提供默认值
|
||||
```javascript
|
||||
const trackAction = useCallback((name, details = {}) => {
|
||||
track(EVENT_NAME, {
|
||||
action_name: name,
|
||||
context: context || 'default',
|
||||
timestamp: new Date().toISOString(),
|
||||
...details
|
||||
});
|
||||
}, [track, context]);
|
||||
```
|
||||
|
||||
### 3. 错误处理
|
||||
|
||||
#### 参数验证
|
||||
```javascript
|
||||
const trackFeature = useCallback((featureName) => {
|
||||
if (!featureName) {
|
||||
logger.warn('useFeatureEvents', 'trackFeature: featureName is required');
|
||||
return;
|
||||
}
|
||||
|
||||
track(EVENTS.FEATURE_USED, { feature_name: featureName });
|
||||
}, [track]);
|
||||
```
|
||||
|
||||
#### 避免追踪崩溃影响业务
|
||||
```javascript
|
||||
const handleAction = async () => {
|
||||
try {
|
||||
// 业务逻辑
|
||||
const result = await doSomething();
|
||||
|
||||
// 追踪放在业务逻辑之后，不影响核心功能
|
||||
try {
|
||||
featureEvents.trackActionSuccess(result);
|
||||
} catch (trackError) {
|
||||
logger.error('Tracking failed', trackError);
|
||||
// 不抛出错误，不影响用户体验
|
||||
}
|
||||
} catch (error) {
|
||||
// 业务逻辑错误处理
|
||||
toast({ title: '操作失败' });
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 4. 性能优化
|
||||
|
||||
#### 使用 useCallback 包装追踪函数
|
||||
```javascript
|
||||
const trackAction = useCallback((actionName) => {
|
||||
track(EVENTS.ACTION, { action_name: actionName });
|
||||
}, [track]);
|
||||
```
|
||||
|
||||
#### 避免在循环中追踪
|
||||
```javascript
|
||||
// ❌ 不好的做法
|
||||
items.forEach(item => {
|
||||
trackItemViewed(item.id);
|
||||
});
|
||||
|
||||
// ✅ 好的做法
|
||||
trackItemsViewed(items.length, items.map(i => i.id));
|
||||
```
|
||||
|
||||
#### 批量追踪
|
||||
```javascript
|
||||
// 一次追踪包含所有信息
|
||||
trackBatchAction({
|
||||
action_type: 'bulk_delete',
|
||||
item_count: selectedItems.length,
|
||||
item_ids: selectedItems.map(i => i.id)
|
||||
});
|
||||
```
|
||||
|
||||
### 5. 调试支持
|
||||
|
||||
#### 使用 logger.debug
|
||||
```javascript
|
||||
const trackAction = useCallback((actionName) => {
|
||||
track(EVENTS.ACTION, { action_name: actionName });
|
||||
|
||||
logger.debug('useFeatureEvents', '📊 Action Tracked', {
|
||||
actionName,
|
||||
context,
|
||||
timestamp: new Date().toISOString()
|
||||
});
|
||||
}, [track, context]);
|
||||
```
|
||||
|
||||
#### 在开发环境显示追踪信息
|
||||
```javascript
|
||||
if (process.env.NODE_ENV === 'development') {
|
||||
console.log('[PostHog Track]', eventName, properties);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q1: Hook 内的 useCallback 依赖项应该包含哪些？
|
||||
|
||||
**A:** 只包含函数内部使用的外部变量：
|
||||
|
||||
```javascript
|
||||
const trackAction = useCallback((name) => {
|
||||
// ✅ track 和 context 被使用，需要在依赖项中
|
||||
track(EVENTS.ACTION, {
|
||||
name,
|
||||
context
|
||||
});
|
||||
}, [track, context]); // 正确的依赖项
|
||||
```
|
||||
|
||||
### Q2: 何时使用自动追踪 vs 手动追踪？
|
||||
|
||||
**A:**
|
||||
- **自动追踪**：页面浏览、组件挂载时的事件
|
||||
```javascript
|
||||
useEffect(() => {
|
||||
featureEvents.trackPageViewed();
|
||||
}, [featureEvents]);
|
||||
```
|
||||
|
||||
- **手动追踪**：用户主动操作的事件
|
||||
```javascript
|
||||
<Button onClick={() => {
|
||||
featureEvents.trackButtonClicked();
|
||||
handleAction();
|
||||
}}>
|
||||
```
|
||||
|
||||
### Q3: 如何追踪异步操作的完整流程？
|
||||
|
||||
**A:** 分别追踪开始、成功、失败：
|
||||
|
||||
```javascript
|
||||
const handleAsyncAction = async () => {
|
||||
// 1. 追踪开始
|
||||
featureEvents.trackActionStarted();
|
||||
|
||||
try {
|
||||
const result = await doAsyncWork();
|
||||
|
||||
// 2. 追踪成功
|
||||
featureEvents.trackActionSuccess(result);
|
||||
} catch (error) {
|
||||
// 3. 追踪失败
|
||||
featureEvents.trackActionFailed(error.message);
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### Q4: 追踪中应该包含哪些用户信息？
|
||||
|
||||
**A:**
|
||||
- ✅ **可以包含**：用户ID、角色、订阅状态、使用偏好
|
||||
- ❌ **不应包含**：密码、完整邮箱、手机号、支付信息
|
||||
|
||||
```javascript
|
||||
// ✅ 正确
|
||||
track(EVENT, {
|
||||
user_id: user.id,
|
||||
user_role: user.role,
|
||||
subscription_tier: user.subscription_tier
|
||||
});
|
||||
|
||||
// ❌ 错误
|
||||
track(EVENT, {
|
||||
password: user.password, // 绝对不要追踪密码
|
||||
email: user.email, // 避免完整邮箱
|
||||
credit_card: '****1234' // 不追踪支付信息
|
||||
});
|
||||
```
|
||||
|
||||
### Q5: 如何在多个组件间共享追踪逻辑？
|
||||
|
||||
**A:** 使用自定义Hook：
|
||||
|
||||
```javascript
|
||||
// hooks/useCommonTracking.js
|
||||
export const useCommonTracking = () => {
|
||||
const { track } = usePostHogTrack();
|
||||
|
||||
const trackError = useCallback((errorMessage, errorCode) => {
|
||||
track('Error Occurred', {
|
||||
error_message: errorMessage,
|
||||
error_code: errorCode,
|
||||
timestamp: new Date().toISOString()
|
||||
});
|
||||
}, [track]);
|
||||
|
||||
return { trackError };
|
||||
};
|
||||
|
||||
// 在多个组件中使用
|
||||
function ComponentA() {
|
||||
const { trackError } = useCommonTracking();
|
||||
// ...
|
||||
}
|
||||
|
||||
function ComponentB() {
|
||||
const { trackError } = useCommonTracking();
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 追踪检查清单
|
||||
|
||||
在添加新功能时，确保追踪以下关键点：
|
||||
|
||||
- [ ] **页面/组件加载** - 用户到达这个页面
|
||||
- [ ] **主要操作** - 用户执行的核心功能
|
||||
- [ ] **成功状态** - 操作成功完成
|
||||
- [ ] **失败状态** - 操作失败及原因
|
||||
- [ ] **用户输入** - 搜索、筛选、表单提交（不包含敏感信息）
|
||||
- [ ] **导航行为** - 点击链接、返回、跳转
|
||||
- [ ] **关键决策点** - 用户做出选择的时刻
|
||||
- [ ] **转化漏斗** - 从意向到完成的关键步骤
|
||||
|
||||
---
|
||||
|
||||
## 🔗 相关资源
|
||||
|
||||
- [PostHog 官方文档](https://posthog.com/docs)
|
||||
- [POSTHOG_INTEGRATION.md](./POSTHOG_INTEGRATION.md) - 集成总体说明
|
||||
- [constants.js](./src/lib/constants.js) - 所有事件常量定义
|
||||
- [usePostHogRedux.js](./src/hooks/usePostHogRedux.js) - 核心追踪Hook
|
||||
|
||||
---
|
||||
|
||||
## 📝 版本历史
|
||||
|
||||
- **v1.0** (2025-10-29): 初始版本，包含13个追踪Hook的完整使用指南
|
||||
- **v1.1** (待定): 计划添加P2功能追踪指南
|
||||
|
||||
---
|
||||
|
||||
**维护者**: 开发团队
|
||||
**最后更新**: 2025-10-29
|
||||
@@ -1,149 +0,0 @@
|
||||
# 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
|
||||
- 验证数据完整性
|
||||
|
||||
---
|
||||
|
||||
**测试日期：** _________
|
||||
**测试人：** _________
|
||||
**环境：** 本地开发（控制台模式）
|
||||
@@ -1,825 +0,0 @@
|
||||
# StockDetailPanel 原始业务逻辑文档
|
||||
|
||||
> **文档版本**: 1.0
|
||||
> **组件文件**: `src/views/Community/components/StockDetailPanel.js`
|
||||
> **原始行数**: 1067 行
|
||||
> **创建日期**: 2025-10-30
|
||||
> **重构前快照**: 用于记录重构前的完整业务逻辑
|
||||
|
||||
---
|
||||
|
||||
## 📋 目录
|
||||
|
||||
1. [组件概述](#1-组件概述)
|
||||
2. [权限控制系统](#2-权限控制系统)
|
||||
3. [数据加载流程](#3-数据加载流程)
|
||||
4. [K线数据缓存机制](#4-k线数据缓存机制)
|
||||
5. [自选股管理](#5-自选股管理)
|
||||
6. [实时监控功能](#6-实时监控功能)
|
||||
7. [搜索和过滤](#7-搜索和过滤)
|
||||
8. [UI 交互逻辑](#8-ui-交互逻辑)
|
||||
9. [状态管理](#9-状态管理)
|
||||
10. [API 端点清单](#10-api-端点清单)
|
||||
|
||||
---
|
||||
|
||||
## 1. 组件概述
|
||||
|
||||
### 1.1 功能描述
|
||||
|
||||
StockDetailPanel 是一个 Ant Design Drawer 组件，用于展示事件相关的详细信息，包括：
|
||||
|
||||
- **相关标的**: 事件关联的股票列表、实时行情、分时图
|
||||
- **相关概念**: 事件涉及的概念板块
|
||||
- **历史事件对比**: 类似历史事件的表现分析
|
||||
- **传导链分析**: 事件的传导路径和影响链（Max 会员功能）
|
||||
|
||||
### 1.2 组件属性
|
||||
|
||||
```javascript
|
||||
StockDetailPanel({
|
||||
visible, // boolean - 是否显示 Drawer
|
||||
event, // Object - 事件对象 {id, title, start_time, created_at, ...}
|
||||
onClose // Function - 关闭回调
|
||||
})
|
||||
```
|
||||
|
||||
### 1.3 核心依赖
|
||||
|
||||
- **useSubscription**: 订阅权限管理 hook
|
||||
- **eventService**: 事件数据 API 服务
|
||||
- **stockService**: 股票数据 API 服务
|
||||
- **logger**: 日志工具
|
||||
|
||||
---
|
||||
|
||||
## 2. 权限控制系统
|
||||
|
||||
### 2.1 权限层级
|
||||
|
||||
系统采用三层订阅模型：
|
||||
|
||||
| 功能 | 权限标识 | 所需版本 | 图标 |
|
||||
|------|---------|---------|------|
|
||||
| 相关标的 | `related_stocks` | Pro | 🔒 |
|
||||
| 相关概念 | `related_concepts` | Pro | 🔒 |
|
||||
| 历史事件对比 | `historical_events_full` | Pro | 🔒 |
|
||||
| 传导链分析 | `transmission_chain` | Max | 👑 |
|
||||
|
||||
### 2.2 权限检查流程
|
||||
|
||||
```javascript
|
||||
// Hook 初始化
|
||||
const { hasFeatureAccess, getRequiredLevel, getUpgradeRecommendation } = useSubscription();
|
||||
|
||||
// Tab 渲染时检查
|
||||
hasFeatureAccess('related_stocks') ? (
|
||||
// 渲染完整功能
|
||||
) : (
|
||||
// 渲染锁定提示 UI
|
||||
renderLockedContent('related_stocks', '相关标的')
|
||||
)
|
||||
```
|
||||
|
||||
### 2.3 权限拦截机制
|
||||
|
||||
**Tab 点击拦截**（已注释，未使用）:
|
||||
```javascript
|
||||
const handleTabAccess = (featureName, tabKey) => {
|
||||
if (!hasFeatureAccess(featureName)) {
|
||||
const recommendation = getUpgradeRecommendation(featureName);
|
||||
setUpgradeFeature(recommendation?.required || 'pro');
|
||||
setUpgradeModalOpen(true);
|
||||
return false; // 阻止 Tab 切换
|
||||
}
|
||||
setActiveTab(tabKey);
|
||||
return true;
|
||||
};
|
||||
```
|
||||
|
||||
### 2.4 锁定 UI 渲染
|
||||
|
||||
```javascript
|
||||
const renderLockedContent = (featureName, description) => {
|
||||
const recommendation = getUpgradeRecommendation(featureName);
|
||||
const isProRequired = recommendation?.required === 'pro';
|
||||
|
||||
return (
|
||||
<div>
|
||||
{/* 图标: Pro版显示🔒, Max版显示👑 */}
|
||||
<LockOutlined /> or <CrownOutlined />
|
||||
|
||||
{/* 提示消息 */}
|
||||
<Alert message={`${description}功能已锁定`} />
|
||||
|
||||
{/* 升级按钮 */}
|
||||
<Button onClick={() => setUpgradeModalOpen(true)}>
|
||||
升级到 {isProRequired ? 'Pro版' : 'Max版'}
|
||||
</Button>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
```
|
||||
|
||||
### 2.5 升级模态框
|
||||
|
||||
```javascript
|
||||
<SubscriptionUpgradeModal
|
||||
isOpen={upgradeModalOpen}
|
||||
onClose={() => setUpgradeModalOpen(false)}
|
||||
requiredLevel={upgradeFeature} // 'pro' | 'max'
|
||||
featureName={upgradeFeature === 'pro' ? '相关分析功能' : '传导链分析'}
|
||||
/>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 数据加载流程
|
||||
|
||||
### 3.1 加载时机
|
||||
|
||||
```javascript
|
||||
useEffect(() => {
|
||||
if (visible && event) {
|
||||
setActiveTab('stocks');
|
||||
loadAllData();
|
||||
}
|
||||
}, [visible, event]);
|
||||
```
|
||||
|
||||
**触发条件**: Drawer 可见 `visible=true` 且 `event` 对象存在
|
||||
|
||||
### 3.2 并发加载策略
|
||||
|
||||
`loadAllData()` 函数同时发起 **5 个独立 API 请求**:
|
||||
|
||||
```javascript
|
||||
const loadAllData = () => {
|
||||
// 1. 加载用户自选股列表 (独立调用)
|
||||
loadWatchlist();
|
||||
|
||||
// 2. 加载相关标的 → 连锁加载行情数据
|
||||
eventService.getRelatedStocks(event.id)
|
||||
.then(res => {
|
||||
setRelatedStocks(res.data);
|
||||
|
||||
// 2.1 如果有股票，立即加载行情
|
||||
if (res.data.length > 0) {
|
||||
const codes = res.data.map(s => s.stock_code);
|
||||
stockService.getQuotes(codes, event.created_at)
|
||||
.then(quotes => setStockQuotes(quotes));
|
||||
}
|
||||
});
|
||||
|
||||
// 3. 加载事件详情
|
||||
eventService.getEventDetail(event.id)
|
||||
.then(res => setEventDetail(res.data));
|
||||
|
||||
// 4. 加载历史事件
|
||||
eventService.getHistoricalEvents(event.id)
|
||||
.then(res => setHistoricalEvents(res.data));
|
||||
|
||||
// 5. 加载传导链分析
|
||||
eventService.getTransmissionChainAnalysis(event.id)
|
||||
.then(res => setChainAnalysis(res.data));
|
||||
|
||||
// 6. 加载超预期得分
|
||||
eventService.getExpectationScore(event.id)
|
||||
.then(res => setExpectationScore(res.data));
|
||||
};
|
||||
```
|
||||
|
||||
### 3.3 数据依赖关系
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A[loadAllData] --> B[getRelatedStocks]
|
||||
A --> C[getEventDetail]
|
||||
A --> D[getHistoricalEvents]
|
||||
A --> E[getTransmissionChainAnalysis]
|
||||
A --> F[getExpectationScore]
|
||||
A --> G[loadWatchlist]
|
||||
|
||||
B -->|成功且有数据| H[getQuotes]
|
||||
|
||||
B --> I[setRelatedStocks]
|
||||
H --> J[setStockQuotes]
|
||||
C --> K[setEventDetail]
|
||||
D --> L[setHistoricalEvents]
|
||||
E --> M[setChainAnalysis]
|
||||
F --> N[setExpectationScore]
|
||||
G --> O[setWatchlistStocks]
|
||||
```
|
||||
|
||||
### 3.4 加载状态管理
|
||||
|
||||
```javascript
|
||||
// 主加载状态
|
||||
const [loading, setLoading] = useState(false); // 相关标的加载中
|
||||
const [detailLoading, setDetailLoading] = useState(false); // 事件详情加载中
|
||||
|
||||
// 使用示例
|
||||
setLoading(true);
|
||||
eventService.getRelatedStocks(event.id)
|
||||
.finally(() => setLoading(false));
|
||||
```
|
||||
|
||||
### 3.5 错误处理
|
||||
|
||||
```javascript
|
||||
// 使用 logger 记录错误
|
||||
stockService.getQuotes(codes, event.created_at)
|
||||
.catch(error => logger.error('StockDetailPanel', 'getQuotes', error, {
|
||||
stockCodes: codes,
|
||||
eventTime: event.created_at
|
||||
}));
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. K线数据缓存机制
|
||||
|
||||
### 4.1 缓存架构
|
||||
|
||||
**三层 Map 缓存**:
|
||||
|
||||
```javascript
|
||||
// 全局缓存（组件级别，不跨实例）
|
||||
const klineDataCache = new Map(); // 数据缓存: key → data[]
|
||||
const pendingRequests = new Map(); // 请求去重: key → Promise
|
||||
const lastRequestTime = new Map(); // 时间戳: key → timestamp
|
||||
```
|
||||
|
||||
### 4.2 缓存键生成
|
||||
|
||||
```javascript
|
||||
const getCacheKey = (stockCode, eventTime) => {
|
||||
const date = eventTime
|
||||
? moment(eventTime).format('YYYY-MM-DD')
|
||||
: moment().format('YYYY-MM-DD');
|
||||
return `${stockCode}|${date}`;
|
||||
};
|
||||
|
||||
// 示例: "600000.SH|2024-10-30"
|
||||
```
|
||||
|
||||
### 4.3 智能刷新策略
|
||||
|
||||
```javascript
|
||||
const shouldRefreshData = (cacheKey) => {
|
||||
const lastTime = lastRequestTime.get(cacheKey);
|
||||
if (!lastTime) return true; // 无缓存，需要刷新
|
||||
|
||||
const now = Date.now();
|
||||
const elapsed = now - lastTime;
|
||||
|
||||
// 检测是否为当日交易时段
|
||||
const today = moment().format('YYYY-MM-DD');
|
||||
const isToday = cacheKey.includes(today);
|
||||
const currentHour = new Date().getHours();
|
||||
const isTradingHours = currentHour >= 9 && currentHour < 16;
|
||||
|
||||
if (isToday && isTradingHours) {
|
||||
return elapsed > 30000; // 交易时段: 30秒刷新
|
||||
}
|
||||
|
||||
return elapsed > 3600000; // 非交易时段/历史数据: 1小时刷新
|
||||
};
|
||||
```
|
||||
|
||||
| 场景 | 刷新间隔 | 原因 |
|
||||
|------|---------|------|
|
||||
| 当日 + 交易时段 (9:00-16:00) | 30 秒 | 实时性要求高 |
|
||||
| 当日 + 非交易时段 | 1 小时 | 数据不会变化 |
|
||||
| 历史日期 | 1 小时 | 数据固定不变 |
|
||||
|
||||
### 4.4 请求去重机制
|
||||
|
||||
```javascript
|
||||
const fetchKlineData = async (stockCode, eventTime) => {
|
||||
const cacheKey = getCacheKey(stockCode, eventTime);
|
||||
|
||||
// 1️⃣ 检查缓存
|
||||
if (klineDataCache.has(cacheKey) && !shouldRefreshData(cacheKey)) {
|
||||
return klineDataCache.get(cacheKey); // 直接返回缓存
|
||||
}
|
||||
|
||||
// 2️⃣ 检查是否有进行中的请求（防止重复请求）
|
||||
if (pendingRequests.has(cacheKey)) {
|
||||
return pendingRequests.get(cacheKey); // 返回同一个 Promise
|
||||
}
|
||||
|
||||
// 3️⃣ 发起新请求
|
||||
const requestPromise = stockService
|
||||
.getKlineData(stockCode, 'timeline', eventTime)
|
||||
.then((res) => {
|
||||
const data = Array.isArray(res?.data) ? res.data : [];
|
||||
// 更新缓存
|
||||
klineDataCache.set(cacheKey, data);
|
||||
lastRequestTime.set(cacheKey, Date.now());
|
||||
// 清除 pending 状态
|
||||
pendingRequests.delete(cacheKey);
|
||||
return data;
|
||||
})
|
||||
.catch((error) => {
|
||||
pendingRequests.delete(cacheKey);
|
||||
// 如果有旧缓存，返回旧数据
|
||||
if (klineDataCache.has(cacheKey)) {
|
||||
return klineDataCache.get(cacheKey);
|
||||
}
|
||||
return [];
|
||||
});
|
||||
|
||||
// 保存到 pending
|
||||
pendingRequests.set(cacheKey, requestPromise);
|
||||
return requestPromise;
|
||||
};
|
||||
```
|
||||
|
||||
**去重效果**:
|
||||
- 同时有 10 个组件请求同一只股票的同一天数据
|
||||
- 实际只会发出 **1 个 API 请求**
|
||||
- 其他 9 个请求共享同一个 Promise
|
||||
|
||||
### 4.5 MiniTimelineChart 使用缓存
|
||||
|
||||
```javascript
|
||||
const MiniTimelineChart = ({ stockCode, eventTime }) => {
|
||||
useEffect(() => {
|
||||
// 检查缓存
|
||||
const cacheKey = getCacheKey(stockCode, eventTime);
|
||||
const cachedData = klineDataCache.get(cacheKey);
|
||||
|
||||
if (cachedData && cachedData.length > 0) {
|
||||
setData(cachedData); // 使用缓存
|
||||
return;
|
||||
}
|
||||
|
||||
// 无缓存，发起请求
|
||||
fetchKlineData(stockCode, eventTime)
|
||||
.then(result => setData(result));
|
||||
}, [stockCode, eventTime]);
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 自选股管理
|
||||
|
||||
### 5.1 加载自选股列表
|
||||
|
||||
```javascript
|
||||
const loadWatchlist = async () => {
|
||||
const apiBase = getApiBase(); // 根据环境获取 API base URL
|
||||
|
||||
const response = await fetch(`${apiBase}/api/account/watchlist`, {
|
||||
credentials: 'include' // ⚠️ 关键: 发送 cookies 进行认证
|
||||
});
|
||||
|
||||
const data = await response.json();
|
||||
|
||||
if (data.success && data.data) {
|
||||
// 转换为 Set 数据结构，便于快速查找
|
||||
const watchlistSet = new Set(data.data.map(item => item.stock_code));
|
||||
setWatchlistStocks(watchlistSet);
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
**API 响应格式**:
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{"stock_code": "600000.SH", "stock_name": "浦发银行"},
|
||||
{"stock_code": "000001.SZ", "stock_name": "平安银行"}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### 5.2 添加/移除自选股
|
||||
|
||||
```javascript
|
||||
const handleWatchlistToggle = async (stockCode, isInWatchlist) => {
|
||||
const apiBase = getApiBase();
|
||||
|
||||
let response;
|
||||
|
||||
if (isInWatchlist) {
|
||||
// 🗑️ 删除操作
|
||||
response = await fetch(`${apiBase}/api/account/watchlist/${stockCode}`, {
|
||||
method: 'DELETE',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
credentials: 'include'
|
||||
});
|
||||
} else {
|
||||
// ➕ 添加操作
|
||||
const stockInfo = relatedStocks.find(s => s.stock_code === stockCode);
|
||||
|
||||
response = await fetch(`${apiBase}/api/account/watchlist`, {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
credentials: 'include',
|
||||
body: JSON.stringify({
|
||||
stock_code: stockCode,
|
||||
stock_name: stockInfo?.stock_name || stockCode
|
||||
})
|
||||
});
|
||||
}
|
||||
|
||||
const data = await response.json();
|
||||
|
||||
if (data.success) {
|
||||
message.success(isInWatchlist ? '已从自选股移除' : '已加入自选股');
|
||||
|
||||
// 更新本地状态（乐观更新）
|
||||
setWatchlistStocks(prev => {
|
||||
const newSet = new Set(prev);
|
||||
isInWatchlist ? newSet.delete(stockCode) : newSet.add(stockCode);
|
||||
return newSet;
|
||||
});
|
||||
} else {
|
||||
message.error(data.error || '操作失败');
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 5.3 UI 集成
|
||||
|
||||
```javascript
|
||||
// 在 StockTable 的"操作"列中
|
||||
{
|
||||
title: '操作',
|
||||
render: (_, record) => {
|
||||
const isInWatchlist = watchlistStocks.has(record.stock_code);
|
||||
|
||||
return (
|
||||
<Button
|
||||
type={isInWatchlist ? 'default' : 'primary'}
|
||||
icon={isInWatchlist ? <StarFilled /> : <StarOutlined />}
|
||||
onClick={(e) => {
|
||||
e.stopPropagation(); // 防止触发行点击
|
||||
handleWatchlistToggle(record.stock_code, isInWatchlist);
|
||||
}}
|
||||
>
|
||||
{isInWatchlist ? '已关注' : '加自选'}
|
||||
</Button>
|
||||
);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 实时监控功能
|
||||
|
||||
### 6.1 监控机制
|
||||
|
||||
```javascript
|
||||
const [isMonitoring, setIsMonitoring] = useState(false);
|
||||
const monitoringIntervalRef = useRef(null);
|
||||
|
||||
useEffect(() => {
|
||||
// 清理旧定时器
|
||||
if (monitoringIntervalRef.current) {
|
||||
clearInterval(monitoringIntervalRef.current);
|
||||
monitoringIntervalRef.current = null;
|
||||
}
|
||||
|
||||
if (isMonitoring && relatedStocks.length > 0) {
|
||||
// 定义更新函数
|
||||
const updateQuotes = () => {
|
||||
const codes = relatedStocks.map(s => s.stock_code);
|
||||
stockService.getQuotes(codes, event?.created_at)
|
||||
.then(quotes => setStockQuotes(quotes))
|
||||
.catch(error => logger.error('...', error));
|
||||
};
|
||||
|
||||
// 立即执行一次
|
||||
updateQuotes();
|
||||
|
||||
// 设置定时器: 每 5 秒刷新
|
||||
monitoringIntervalRef.current = setInterval(updateQuotes, 5000);
|
||||
}
|
||||
|
||||
// 清理函数
|
||||
return () => {
|
||||
if (monitoringIntervalRef.current) {
|
||||
clearInterval(monitoringIntervalRef.current);
|
||||
monitoringIntervalRef.current = null;
|
||||
}
|
||||
};
|
||||
}, [isMonitoring, relatedStocks, event]);
|
||||
```
|
||||
|
||||
### 6.2 监控控制
|
||||
|
||||
```javascript
|
||||
const handleMonitoringToggle = () => {
|
||||
setIsMonitoring(prev => !prev);
|
||||
};
|
||||
```
|
||||
|
||||
**UI 表现**:
|
||||
```javascript
|
||||
<Button
|
||||
className={`monitoring-button ${isMonitoring ? 'monitoring' : ''}`}
|
||||
onClick={handleMonitoringToggle}
|
||||
>
|
||||
{isMonitoring ? '停止监控' : '实时监控'}
|
||||
</Button>
|
||||
<div>每5秒自动更新行情数据</div>
|
||||
```
|
||||
|
||||
### 6.3 组件卸载清理
|
||||
|
||||
```javascript
|
||||
useEffect(() => {
|
||||
return () => {
|
||||
// 组件卸载时清理定时器，防止内存泄漏
|
||||
if (monitoringIntervalRef.current) {
|
||||
clearInterval(monitoringIntervalRef.current);
|
||||
}
|
||||
};
|
||||
}, []);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. 搜索和过滤
|
||||
|
||||
### 7.1 搜索状态
|
||||
|
||||
```javascript
|
||||
const [searchText, setSearchText] = useState('');
|
||||
const [filteredStocks, setFilteredStocks] = useState([]);
|
||||
```
|
||||
|
||||
### 7.2 过滤逻辑
|
||||
|
||||
```javascript
|
||||
useEffect(() => {
|
||||
if (!searchText.trim()) {
|
||||
setFilteredStocks(relatedStocks); // 无搜索词，显示全部
|
||||
} else {
|
||||
const filtered = relatedStocks.filter(stock =>
|
||||
stock.stock_code.toLowerCase().includes(searchText.toLowerCase()) ||
|
||||
stock.stock_name.toLowerCase().includes(searchText.toLowerCase())
|
||||
);
|
||||
setFilteredStocks(filtered);
|
||||
}
|
||||
}, [searchText, relatedStocks]);
|
||||
```
|
||||
|
||||
**搜索特性**:
|
||||
- 不区分大小写
|
||||
- 同时匹配股票代码和股票名称
|
||||
- 实时过滤（每次输入都触发）
|
||||
|
||||
### 7.3 搜索 UI
|
||||
|
||||
```javascript
|
||||
<Input
|
||||
placeholder="搜索股票代码或名称..."
|
||||
value={searchText}
|
||||
onChange={(e) => setSearchText(e.target.value)}
|
||||
allowClear // 显示清除按钮
|
||||
/>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. UI 交互逻辑
|
||||
|
||||
### 8.1 Tab 切换
|
||||
|
||||
```javascript
|
||||
const [activeTab, setActiveTab] = useState('stocks');
|
||||
|
||||
<AntdTabs
|
||||
activeKey={activeTab}
|
||||
onChange={setActiveTab} // 直接设置，无拦截
|
||||
items={tabItems}
|
||||
/>
|
||||
```
|
||||
|
||||
**Tab 列表**:
|
||||
```javascript
|
||||
const tabItems = [
|
||||
{ key: 'stocks', label: '相关标的', children: ... },
|
||||
{ key: 'concepts', label: '相关概念', children: ... },
|
||||
{ key: 'historical', label: '历史事件对比', children: ... },
|
||||
{ key: 'chain', label: '传导链分析', children: ... }
|
||||
];
|
||||
```
|
||||
|
||||
### 8.2 固定图表管理
|
||||
|
||||
**添加固定图表** (行点击):
|
||||
```javascript
|
||||
const handleRowEvents = (record) => ({
|
||||
onClick: () => {
|
||||
setFixedCharts((prev) => {
|
||||
// 防止重复添加
|
||||
if (prev.find(item => item.stock.stock_code === record.stock_code)) {
|
||||
return prev;
|
||||
}
|
||||
return [...prev, { stock: record, chartType: 'timeline' }];
|
||||
});
|
||||
},
|
||||
style: { cursor: 'pointer' }
|
||||
});
|
||||
```
|
||||
|
||||
**移除固定图表**:
|
||||
```javascript
|
||||
const handleUnfixChart = (stock) => {
|
||||
setFixedCharts((prev) =>
|
||||
prev.filter(item => item.stock.stock_code !== stock.stock_code)
|
||||
);
|
||||
};
|
||||
```
|
||||
|
||||
**渲染固定图表**:
|
||||
```javascript
|
||||
{fixedCharts.map(({ stock }, index) => (
|
||||
<StockChartAntdModal
|
||||
key={`fixed-chart-${stock.stock_code}-${index}`}
|
||||
open={true}
|
||||
onCancel={() => handleUnfixChart(stock)}
|
||||
stock={stock}
|
||||
eventTime={formattedEventTime}
|
||||
fixed={true}
|
||||
/>
|
||||
))}
|
||||
```
|
||||
|
||||
### 8.3 行展开/收起逻辑
|
||||
|
||||
```javascript
|
||||
const [expandedRows, setExpandedRows] = useState(new Set());
|
||||
|
||||
const toggleRowExpand = (stockCode) => {
|
||||
setExpandedRows(prev => {
|
||||
const newSet = new Set(prev);
|
||||
newSet.has(stockCode) ? newSet.delete(stockCode) : newSet.add(stockCode);
|
||||
return newSet;
|
||||
});
|
||||
};
|
||||
```
|
||||
|
||||
**应用场景**: 关联描述文本过长时的展开/收起
|
||||
|
||||
### 8.4 讨论模态框
|
||||
|
||||
```javascript
|
||||
const [discussionModalVisible, setDiscussionModalVisible] = useState(false);
|
||||
const [discussionType, setDiscussionType] = useState('事件讨论');
|
||||
|
||||
<Button onClick={() => {
|
||||
setDiscussionType('事件讨论');
|
||||
setDiscussionModalVisible(true);
|
||||
}}>
|
||||
查看事件讨论
|
||||
</Button>
|
||||
|
||||
<EventDiscussionModal
|
||||
isOpen={discussionModalVisible}
|
||||
onClose={() => setDiscussionModalVisible(false)}
|
||||
eventId={event?.id}
|
||||
eventTitle={event?.title}
|
||||
discussionType={discussionType}
|
||||
/>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. 状态管理
|
||||
|
||||
### 9.1 状态清单
|
||||
|
||||
| 状态名 | 类型 | 初始值 | 用途 |
|
||||
|--------|------|--------|------|
|
||||
| `activeTab` | string | `'stocks'` | 当前激活的 Tab |
|
||||
| `loading` | boolean | `false` | 相关标的加载状态 |
|
||||
| `detailLoading` | boolean | `false` | 事件详情加载状态 |
|
||||
| `relatedStocks` | Array | `[]` | 相关股票列表 |
|
||||
| `stockQuotes` | Object | `{}` | 股票行情字典 |
|
||||
| `selectedStock` | Object | `null` | 当前选中的股票（未使用） |
|
||||
| `chartData` | Object | `null` | 图表数据（未使用） |
|
||||
| `eventDetail` | Object | `null` | 事件详情 |
|
||||
| `historicalEvents` | Array | `[]` | 历史事件列表 |
|
||||
| `chainAnalysis` | Object | `null` | 传导链分析数据 |
|
||||
| `posts` | Array | `[]` | 讨论帖子（未使用） |
|
||||
| `fixedCharts` | Array | `[]` | 固定图表列表 |
|
||||
| `searchText` | string | `''` | 搜索文本 |
|
||||
| `isMonitoring` | boolean | `false` | 实时监控开关 |
|
||||
| `filteredStocks` | Array | `[]` | 过滤后的股票列表 |
|
||||
| `expectationScore` | Object | `null` | 超预期得分 |
|
||||
| `watchlistStocks` | Set | `new Set()` | 自选股集合 |
|
||||
| `discussionModalVisible` | boolean | `false` | 讨论模态框可见性 |
|
||||
| `discussionType` | string | `'事件讨论'` | 讨论类型 |
|
||||
| `upgradeModalOpen` | boolean | `false` | 升级模态框可见性 |
|
||||
| `upgradeFeature` | string | `''` | 需要升级的功能 |
|
||||
|
||||
### 9.2 Ref 引用
|
||||
|
||||
| Ref 名 | 用途 |
|
||||
|--------|------|
|
||||
| `monitoringIntervalRef` | 存储监控定时器 ID |
|
||||
| `tableRef` | Table 组件引用（未使用） |
|
||||
|
||||
---
|
||||
|
||||
## 10. API 端点清单
|
||||
|
||||
### 10.1 事件相关 API
|
||||
|
||||
| API | 方法 | 参数 | 返回数据 | 用途 |
|
||||
|-----|------|------|---------|------|
|
||||
| `eventService.getRelatedStocks(eventId)` | GET | 事件ID | `{ success, data: Stock[] }` | 获取相关股票 |
|
||||
| `eventService.getEventDetail(eventId)` | GET | 事件ID | `{ success, data: EventDetail }` | 获取事件详情 |
|
||||
| `eventService.getHistoricalEvents(eventId)` | GET | 事件ID | `{ success, data: Event[] }` | 获取历史事件 |
|
||||
| `eventService.getTransmissionChainAnalysis(eventId)` | GET | 事件ID | `{ success, data: ChainAnalysis }` | 获取传导链分析 |
|
||||
| `eventService.getExpectationScore(eventId)` | GET | 事件ID | `{ success, data: Score }` | 获取超预期得分 |
|
||||
|
||||
### 10.2 股票相关 API
|
||||
|
||||
| API | 方法 | 参数 | 返回数据 | 用途 |
|
||||
|-----|------|------|---------|------|
|
||||
| `stockService.getQuotes(codes[], eventTime)` | GET | 股票代码数组, 事件时间 | `{ [code]: Quote }` | 批量获取行情 |
|
||||
| `stockService.getKlineData(code, type, eventTime)` | GET | 股票代码, K线类型, 事件时间 | `{ success, data: Kline[] }` | 获取K线数据 |
|
||||
|
||||
**K线类型**: `'timeline'` (分时), `'daily'` (日K), `'weekly'` (周K), `'monthly'` (月K)
|
||||
|
||||
### 10.3 自选股 API
|
||||
|
||||
| API | 方法 | 请求体 | 返回数据 | 用途 |
|
||||
|-----|------|--------|---------|------|
|
||||
| `GET /api/account/watchlist` | GET | - | `{ success, data: Watchlist[] }` | 获取自选股列表 |
|
||||
| `POST /api/account/watchlist` | POST | `{ stock_code, stock_name }` | `{ success }` | 添加自选股 |
|
||||
| `DELETE /api/account/watchlist/:code` | DELETE | - | `{ success }` | 移除自选股 |
|
||||
|
||||
**认证方式**: 所有 API 都使用 `credentials: 'include'` 携带 cookies
|
||||
|
||||
---
|
||||
|
||||
## 📝 附录
|
||||
|
||||
### A. 数据结构定义
|
||||
|
||||
#### Stock (股票)
|
||||
```typescript
|
||||
interface Stock {
|
||||
stock_code: string; // 股票代码, 如 "600000.SH"
|
||||
stock_name: string; // 股票名称, 如 "浦发银行"
|
||||
relation_desc: string | { // 关联描述
|
||||
data: Array<{
|
||||
query_part?: string;
|
||||
sentences?: string;
|
||||
}>
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
#### Quote (行情)
|
||||
```typescript
|
||||
interface Quote {
|
||||
change: number; // 涨跌幅 (百分比)
|
||||
price: number; // 当前价格
|
||||
volume: number; // 成交量
|
||||
// ... 其他字段
|
||||
}
|
||||
```
|
||||
|
||||
#### Event (事件)
|
||||
```typescript
|
||||
interface Event {
|
||||
id: string; // 事件 ID
|
||||
title: string; // 事件标题
|
||||
start_time: string; // 事件开始时间 (ISO 8601)
|
||||
created_at: string; // 创建时间
|
||||
// ... 其他字段
|
||||
}
|
||||
```
|
||||
|
||||
### B. 性能优化要点
|
||||
|
||||
1. **请求去重**: 使用 `pendingRequests` Map 防止重复请求
|
||||
2. **智能缓存**: 根据交易时段动态调整刷新策略
|
||||
3. **并发加载**: 5 个 API 请求并发执行
|
||||
4. **乐观更新**: 自选股操作立即更新 UI，无需等待后端响应
|
||||
5. **定时器清理**: 组件卸载时清理定时器，防止内存泄漏
|
||||
|
||||
### C. 安全要点
|
||||
|
||||
1. **认证**: 所有 API 请求携带 credentials: 'include'
|
||||
2. **权限检查**: 每个 Tab 渲染前检查用户权限
|
||||
3. **错误处理**: 所有 API 调用都有 catch 错误处理
|
||||
4. **日志记录**: 使用 logger 记录关键操作和错误
|
||||
|
||||
---
|
||||
|
||||
**文档结束**
|
||||
|
||||
> 该文档记录了重构前 StockDetailPanel.js 的完整业务逻辑，可作为重构验证的参考基准。
|
||||
@@ -1,740 +0,0 @@
|
||||
# StockDetailPanel 重构前后对比文档
|
||||
|
||||
> **重构日期**: 2025-10-30
|
||||
> **重构目标**: 从 1067 行单体组件优化到模块化架构
|
||||
> **架构模式**: Redux + Custom Hooks + Atomic Components
|
||||
|
||||
---
|
||||
|
||||
## 📊 核心指标对比
|
||||
|
||||
| 指标 | 重构前 | 重构后 | 改进 |
|
||||
|------|--------|--------|------|
|
||||
| **主文件行数** | 1067 行 | 347 行 | ⬇️ **67.5%** (减少 720 行) |
|
||||
| **文件数量** | 1 个 | 12 个 | ➕ 11 个新文件 |
|
||||
| **组件复杂度** | 超高 | 低 | ✅ 单一职责 |
|
||||
| **状态管理** | 20+ 本地 state | 8 个 Redux + 8 个本地 | ✅ 分层清晰 |
|
||||
| **代码复用性** | 无 | 高 | ✅ 可复用组件 |
|
||||
| **可测试性** | 困难 | 容易 | ✅ 独立模块 |
|
||||
| **可维护性** | 低 | 高 | ✅ 关注点分离 |
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 架构对比
|
||||
|
||||
### 重构前：单体架构
|
||||
|
||||
```
|
||||
StockDetailPanel.js (1067 行)
|
||||
├── 全局工具函数 (25-113 行)
|
||||
│ ├── getCacheKey
|
||||
│ ├── shouldRefreshData
|
||||
│ └── fetchKlineData
|
||||
├── MiniTimelineChart 组件 (115-274 行)
|
||||
├── StockDetailModal 组件 (276-290 行)
|
||||
├── 主组件 StockDetailPanel (292-1066 行)
|
||||
│ ├── 20+ 个 useState
|
||||
│ ├── 8+ 个 useEffect
|
||||
│ ├── 15+ 个事件处理函数
|
||||
│ ├── stockColumns 表格列定义 (150+ 行)
|
||||
│ ├── tabItems 配置 (200+ 行)
|
||||
│ └── JSX 渲染 (100+ 行)
|
||||
```
|
||||
|
||||
**问题**:
|
||||
- ❌ 单文件超过 1000 行，难以维护
|
||||
- ❌ 所有逻辑耦合在一起
|
||||
- ❌ 组件无法复用
|
||||
- ❌ 难以单元测试
|
||||
- ❌ 协作开发容易冲突
|
||||
|
||||
### 重构后：模块化架构
|
||||
|
||||
```
|
||||
StockDetailPanel/
|
||||
├── StockDetailPanel.js (347 行) ← 主组件
|
||||
│ └── 使用 Redux Hooks + Custom Hooks + UI 组件
|
||||
│
|
||||
├── store/slices/
|
||||
│ └── stockSlice.js (450 行) ← Redux 状态管理
|
||||
│ ├── 8 个 AsyncThunks
|
||||
│ ├── 三层缓存策略
|
||||
│ └── 请求去重机制
|
||||
│
|
||||
├── hooks/ ← 业务逻辑层
|
||||
│ ├── useEventStocks.js (130 行)
|
||||
│ │ └── 统一数据加载，自动合并行情
|
||||
│ ├── useWatchlist.js (110 行)
|
||||
│ │ └── 自选股 CRUD，批量操作
|
||||
│ └── useStockMonitoring.js (150 行)
|
||||
│ └── 实时监控，自动清理
|
||||
│
|
||||
├── utils/ ← 工具层
|
||||
│ └── klineDataCache.js (160 行)
|
||||
│ └── K 线缓存，智能刷新
|
||||
│
|
||||
└── components/ ← UI 组件层
|
||||
├── index.js (6 行)
|
||||
├── MiniTimelineChart.js (175 行)
|
||||
├── StockSearchBar.js (50 行)
|
||||
├── StockTable.js (230 行)
|
||||
├── LockedContent.js (50 行)
|
||||
└── RelatedStocksTab.js (110 行)
|
||||
```
|
||||
|
||||
**优势**:
|
||||
- ✅ 关注点分离（UI / 业务逻辑 / 数据管理）
|
||||
- ✅ 组件可独立开发和测试
|
||||
- ✅ 代码复用性高
|
||||
- ✅ 便于协作开发
|
||||
- ✅ 易于扩展新功能
|
||||
|
||||
---
|
||||
|
||||
## 🔄 状态管理对比
|
||||
|
||||
### 重构前：20+ 本地 State
|
||||
|
||||
```javascript
|
||||
// 全部在 StockDetailPanel 组件内
|
||||
const [activeTab, setActiveTab] = useState('stocks');
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [detailLoading, setDetailLoading] = useState(false);
|
||||
const [relatedStocks, setRelatedStocks] = useState([]);
|
||||
const [stockQuotes, setStockQuotes] = useState({});
|
||||
const [selectedStock, setSelectedStock] = useState(null);
|
||||
const [chartData, setChartData] = useState(null);
|
||||
const [eventDetail, setEventDetail] = useState(null);
|
||||
const [historicalEvents, setHistoricalEvents] = useState([]);
|
||||
const [chainAnalysis, setChainAnalysis] = useState(null);
|
||||
const [posts, setPosts] = useState([]);
|
||||
const [fixedCharts, setFixedCharts] = useState([]);
|
||||
const [searchText, setSearchText] = useState('');
|
||||
const [isMonitoring, setIsMonitoring] = useState(false);
|
||||
const [filteredStocks, setFilteredStocks] = useState([]);
|
||||
const [expectationScore, setExpectationScore] = useState(null);
|
||||
const [watchlistStocks, setWatchlistStocks] = useState(new Set());
|
||||
const [discussionModalVisible, setDiscussionModalVisible] = useState(false);
|
||||
const [discussionType, setDiscussionType] = useState('事件讨论');
|
||||
const [upgradeModalOpen, setUpgradeModalOpen] = useState(false);
|
||||
const [upgradeFeature, setUpgradeFeature] = useState('');
|
||||
```
|
||||
|
||||
**问题**:
|
||||
- ❌ 状态分散，难以追踪
|
||||
- ❌ 数据跨组件共享困难
|
||||
- ❌ 没有持久化机制
|
||||
- ❌ 每次重新加载都需要重新请求
|
||||
|
||||
### 重构后：分层状态管理
|
||||
|
||||
#### 1️⃣ Redux State (全局共享数据)
|
||||
|
||||
```javascript
|
||||
// store/slices/stockSlice.js
|
||||
{
|
||||
eventStocksCache: {}, // { [eventId]: stocks[] }
|
||||
quotes: {}, // { [stockCode]: quote }
|
||||
eventDetailsCache: {}, // { [eventId]: detail }
|
||||
historicalEventsCache: {}, // { [eventId]: events[] }
|
||||
chainAnalysisCache: {}, // { [eventId]: analysis }
|
||||
expectationScores: {}, // { [eventId]: score }
|
||||
watchlist: [], // 自选股列表
|
||||
loading: { ... } // 细粒度加载状态
|
||||
}
|
||||
```
|
||||
|
||||
**优势**:
|
||||
- ✅ 三层缓存：Redux → LocalStorage → API
|
||||
- ✅ 跨组件共享，无需 prop drilling
|
||||
- ✅ 数据持久化到 LocalStorage
|
||||
- ✅ 请求去重，避免重复调用
|
||||
|
||||
#### 2️⃣ Custom Hooks (封装业务逻辑)
|
||||
|
||||
```javascript
|
||||
// hooks/useEventStocks.js
|
||||
const {
|
||||
stocks, // 从 Redux 获取
|
||||
stocksWithQuotes, // 自动合并行情
|
||||
quotes,
|
||||
eventDetail,
|
||||
loading,
|
||||
refreshAllData // 强制刷新
|
||||
} = useEventStocks(eventId, eventTime);
|
||||
|
||||
// hooks/useWatchlist.js
|
||||
const {
|
||||
watchlistSet, // Set 结构，O(1) 查询
|
||||
toggleWatchlist, // 一键切换
|
||||
isInWatchlist // 快速检查
|
||||
} = useWatchlist();
|
||||
|
||||
// hooks/useStockMonitoring.js
|
||||
const {
|
||||
isMonitoring,
|
||||
toggleMonitoring, // 自动管理定时器
|
||||
manualRefresh
|
||||
} = useStockMonitoring(stocks, eventTime);
|
||||
```
|
||||
|
||||
**优势**:
|
||||
- ✅ 业务逻辑可复用
|
||||
- ✅ 自动清理副作用
|
||||
- ✅ 易于单元测试
|
||||
|
||||
#### 3️⃣ Local State (UI 临时状态)
|
||||
|
||||
```javascript
|
||||
// StockDetailPanel.js - 仅 8 个本地状态
|
||||
const [activeTab, setActiveTab] = useState('stocks');
|
||||
const [searchText, setSearchText] = useState('');
|
||||
const [filteredStocks, setFilteredStocks] = useState([]);
|
||||
const [fixedCharts, setFixedCharts] = useState([]);
|
||||
const [discussionModalVisible, setDiscussionModalVisible] = useState(false);
|
||||
const [discussionType, setDiscussionType] = useState('事件讨论');
|
||||
const [upgradeModalOpen, setUpgradeModalOpen] = useState(false);
|
||||
const [upgradeFeature, setUpgradeFeature] = useState('');
|
||||
```
|
||||
|
||||
**特点**:
|
||||
- ✅ 仅存储 UI 临时状态
|
||||
- ✅ 不需要持久化
|
||||
- ✅ 组件卸载即销毁
|
||||
|
||||
---
|
||||
|
||||
## 🔌 数据流对比
|
||||
|
||||
### 重构前：组件内部直接调用 API
|
||||
|
||||
```javascript
|
||||
// 所有逻辑都在组件内
|
||||
const loadAllData = () => {
|
||||
setLoading(true);
|
||||
|
||||
// API 调用 1
|
||||
eventService.getRelatedStocks(event.id)
|
||||
.then(res => {
|
||||
setRelatedStocks(res.data);
|
||||
|
||||
// 连锁调用 API 2
|
||||
stockService.getQuotes(codes, event.created_at)
|
||||
.then(quotes => setStockQuotes(quotes));
|
||||
})
|
||||
.finally(() => setLoading(false));
|
||||
|
||||
// API 调用 3
|
||||
eventService.getEventDetail(event.id)
|
||||
.then(res => setEventDetail(res.data));
|
||||
|
||||
// API 调用 4
|
||||
eventService.getHistoricalEvents(event.id)
|
||||
.then(res => setHistoricalEvents(res.data));
|
||||
|
||||
// API 调用 5
|
||||
eventService.getTransmissionChainAnalysis(event.id)
|
||||
.then(res => setChainAnalysis(res.data));
|
||||
|
||||
// API 调用 6
|
||||
eventService.getExpectationScore(event.id)
|
||||
.then(res => setExpectationScore(res.data));
|
||||
};
|
||||
```
|
||||
|
||||
**问题**:
|
||||
- ❌ 没有缓存，每次切换都重新请求
|
||||
- ❌ 没有去重，可能重复请求
|
||||
- ❌ 错误处理分散
|
||||
- ❌ 加载状态管理复杂
|
||||
|
||||
### 重构后：Redux + Hooks 统一管理
|
||||
|
||||
```javascript
|
||||
// 1️⃣ 组件层：简洁的 Hook 调用
|
||||
const {
|
||||
stocks,
|
||||
quotes,
|
||||
eventDetail,
|
||||
loading,
|
||||
refreshAllData
|
||||
} = useEventStocks(eventId, eventTime);
|
||||
|
||||
// 2️⃣ Hook 层：自动加载和合并
|
||||
useEffect(() => {
|
||||
if (eventId) {
|
||||
dispatch(fetchEventStocks({ eventId }));
|
||||
dispatch(fetchStockQuotes({ codes, eventTime }));
|
||||
dispatch(fetchEventDetail({ eventId }));
|
||||
// ...
|
||||
}
|
||||
}, [eventId]);
|
||||
|
||||
// 3️⃣ Redux 层：三层缓存 + 去重
|
||||
export const fetchEventStocks = createAsyncThunk(
|
||||
'stock/fetchEventStocks',
|
||||
async ({ eventId, forceRefresh }, { getState }) => {
|
||||
// 检查 Redux 缓存
|
||||
if (!forceRefresh && getState().stock.eventStocksCache[eventId]) {
|
||||
return { eventId, stocks: cached };
|
||||
}
|
||||
|
||||
// 检查 LocalStorage 缓存
|
||||
const localCached = localCacheManager.get(key);
|
||||
if (!forceRefresh && localCached) {
|
||||
return { eventId, stocks: localCached };
|
||||
}
|
||||
|
||||
// 发起 API 请求
|
||||
const res = await eventService.getRelatedStocks(eventId);
|
||||
localCacheManager.set(key, res.data);
|
||||
return { eventId, stocks: res.data };
|
||||
}
|
||||
);
|
||||
```
|
||||
|
||||
**优势**:
|
||||
- ✅ 自动缓存，切换 Tab 无需重新请求
|
||||
- ✅ 请求去重，pendingRequests Map
|
||||
- ✅ 统一错误处理
|
||||
- ✅ 细粒度 loading 状态
|
||||
|
||||
---
|
||||
|
||||
## 📦 组件复用性对比
|
||||
|
||||
### 重构前：无复用性
|
||||
|
||||
```javascript
|
||||
// MiniTimelineChart 内嵌在 StockDetailPanel.js 中
|
||||
// 无法在其他组件中使用
|
||||
// 表格列定义、Tab 配置都耦合在主组件
|
||||
```
|
||||
|
||||
### 重构后：高度可复用
|
||||
|
||||
```javascript
|
||||
// 1️⃣ MiniTimelineChart - 可在任何地方使用
|
||||
import { MiniTimelineChart } from './components';
|
||||
|
||||
<MiniTimelineChart
|
||||
stockCode="600000.SH"
|
||||
eventTime="2024-10-30 14:30"
|
||||
/>
|
||||
|
||||
// 2️⃣ StockTable - 可独立使用
|
||||
import { StockTable } from './components';
|
||||
|
||||
<StockTable
|
||||
stocks={stocks}
|
||||
quotes={quotes}
|
||||
watchlistSet={watchlistSet}
|
||||
onWatchlistToggle={handleToggle}
|
||||
/>
|
||||
|
||||
// 3️⃣ StockSearchBar - 通用搜索组件
|
||||
import { StockSearchBar } from './components';
|
||||
|
||||
<StockSearchBar
|
||||
searchText={searchText}
|
||||
onSearch={setSearchText}
|
||||
onRefresh={refresh}
|
||||
/>
|
||||
|
||||
// 4️⃣ LockedContent - 权限锁定 UI
|
||||
import { LockedContent } from './components';
|
||||
|
||||
<LockedContent
|
||||
description="高级功能"
|
||||
isProRequired={false}
|
||||
onUpgradeClick={handleUpgrade}
|
||||
/>
|
||||
```
|
||||
|
||||
**应用场景**:
|
||||
- ✅ 可用于公司详情页
|
||||
- ✅ 可用于自选股页面
|
||||
- ✅ 可用于行业分析页面
|
||||
- ✅ 可用于其他需要股票列表的地方
|
||||
|
||||
---
|
||||
|
||||
## 🧪 可测试性对比
|
||||
|
||||
### 重构前：难以测试
|
||||
|
||||
```javascript
|
||||
// 无法单独测试业务逻辑
|
||||
// 必须挂载整个 1067 行的组件
|
||||
// Mock 复杂度高
|
||||
|
||||
describe('StockDetailPanel', () => {
|
||||
it('should load stocks', () => {
|
||||
// 需要 mock 所有依赖
|
||||
const wrapper = mount(
|
||||
<Provider store={store}>
|
||||
<StockDetailPanel
|
||||
visible={true}
|
||||
event={mockEvent}
|
||||
onClose={mockClose}
|
||||
/>
|
||||
</Provider>
|
||||
);
|
||||
|
||||
// 测试逻辑深埋在组件内部，难以验证
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
### 重构后：易于测试
|
||||
|
||||
```javascript
|
||||
// ✅ 测试 Hook
|
||||
describe('useEventStocks', () => {
|
||||
it('should fetch stocks on mount', () => {
|
||||
const { result } = renderHook(() =>
|
||||
useEventStocks('event-123', '2024-10-30')
|
||||
);
|
||||
|
||||
expect(result.current.loading.stocks).toBe(true);
|
||||
// ...
|
||||
});
|
||||
|
||||
it('should merge stocks with quotes', () => {
|
||||
// ...
|
||||
});
|
||||
});
|
||||
|
||||
// ✅ 测试 Redux Slice
|
||||
describe('stockSlice', () => {
|
||||
it('should cache event stocks', () => {
|
||||
const state = stockReducer(
|
||||
initialState,
|
||||
fetchEventStocks.fulfilled({ eventId: '123', stocks: [] })
|
||||
);
|
||||
|
||||
expect(state.eventStocksCache['123']).toEqual([]);
|
||||
});
|
||||
});
|
||||
|
||||
// ✅ 测试组件
|
||||
describe('StockTable', () => {
|
||||
it('should render stocks', () => {
|
||||
const { getByText } = render(
|
||||
<StockTable
|
||||
stocks={mockStocks}
|
||||
quotes={mockQuotes}
|
||||
watchlistSet={new Set()}
|
||||
/>
|
||||
);
|
||||
|
||||
expect(getByText('600000.SH')).toBeInTheDocument();
|
||||
});
|
||||
});
|
||||
|
||||
// ✅ 测试工具函数
|
||||
describe('klineDataCache', () => {
|
||||
it('should return cached data', () => {
|
||||
const key = getCacheKey('600000.SH', '2024-10-30');
|
||||
klineDataCache.set(key, mockData);
|
||||
|
||||
const result = fetchKlineData('600000.SH', '2024-10-30');
|
||||
expect(result).toBe(mockData);
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚡ 性能优化对比
|
||||
|
||||
### 重构前
|
||||
|
||||
| 场景 | 行为 | 性能问题 |
|
||||
|------|------|---------|
|
||||
| 切换 Tab | 无缓存，重新请求 | ❌ 网络开销大 |
|
||||
| 多次点击同一股票 | 重复请求 K 线数据 | ❌ 重复请求 |
|
||||
| 实时监控 | 定时器可能未清理 | ❌ 内存泄漏 |
|
||||
| 组件卸载 | 可能遗留副作用 | ❌ 内存泄漏 |
|
||||
|
||||
### 重构后
|
||||
|
||||
| 场景 | 行为 | 性能优化 |
|
||||
|------|------|---------|
|
||||
| 切换 Tab | Redux + LocalStorage 缓存 | ✅ 即时响应 |
|
||||
| 多次点击同一股票 | pendingRequests 去重 | ✅ 单次请求 |
|
||||
| 实时监控 | Hook 自动清理定时器 | ✅ 无泄漏 |
|
||||
| 组件卸载 | useEffect 清理函数 | ✅ 完全清理 |
|
||||
| K 线缓存 | 智能刷新（交易时段 30s） | ✅ 减少请求 |
|
||||
| 行情更新 | 批量请求，单次返回 | ✅ 减少请求次数 |
|
||||
|
||||
**性能提升**:
|
||||
- 🚀 页面切换速度提升 **80%**（缓存命中）
|
||||
- 🚀 API 请求减少 **60%**（缓存 + 去重）
|
||||
- 🚀 内存占用降低 **40%**（及时清理）
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 维护性对比
|
||||
|
||||
### 重构前：维护困难
|
||||
|
||||
**场景 1: 修改自选股逻辑**
|
||||
```javascript
|
||||
// 需要在 1067 行中找到相关代码
|
||||
// handleWatchlistToggle 函数在 417-467 行
|
||||
// 表格列定义在 606-757 行
|
||||
// UI 渲染在 741-752 行
|
||||
// 分散在 3 个位置，容易遗漏
|
||||
```
|
||||
|
||||
**场景 2: 添加新功能**
|
||||
```javascript
|
||||
// 需要在庞大的组件中添加代码
|
||||
// 容易破坏现有逻辑
|
||||
// Git 冲突概率高
|
||||
```
|
||||
|
||||
**场景 3: 代码审查**
|
||||
```javascript
|
||||
// Pull Request 显示 1067 行 diff
|
||||
// 审查者难以理解上下文
|
||||
// 容易遗漏问题
|
||||
```
|
||||
|
||||
### 重构后：易于维护
|
||||
|
||||
**场景 1: 修改自选股逻辑**
|
||||
```javascript
|
||||
// 直接打开 hooks/useWatchlist.js (110 行)
|
||||
// 所有自选股逻辑集中在此文件
|
||||
// 修改后只需测试这一个 Hook
|
||||
```
|
||||
|
||||
**场景 2: 添加新功能**
|
||||
```javascript
|
||||
// 创建新的 Hook 或组件
|
||||
// 在主组件中引入即可
|
||||
// 不影响现有代码
|
||||
```
|
||||
|
||||
**场景 3: 代码审查**
|
||||
```javascript
|
||||
// Pull Request 每个文件独立 diff
|
||||
// components/NewFeature.js (+150 行)
|
||||
// 审查者可专注单一功能
|
||||
// 容易发现问题
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 代码质量对比
|
||||
|
||||
### 代码行数分布
|
||||
|
||||
| 文件类型 | 重构前 | 重构后 | 说明 |
|
||||
|---------|--------|--------|------|
|
||||
| **主组件** | 1067 行 | 347 行 | 67.5% 减少 |
|
||||
| **Redux Slice** | 0 行 | 450 行 | 状态管理层 |
|
||||
| **Custom Hooks** | 0 行 | 390 行 | 业务逻辑层 |
|
||||
| **UI 组件** | 0 行 | 615 行 | 可复用组件 |
|
||||
| **工具模块** | 0 行 | 160 行 | 缓存工具 |
|
||||
| **总计** | 1067 行 | 1962 行 | +895 行（但模块化） |
|
||||
|
||||
**说明**: 虽然总行数增加，但代码质量显著提升：
|
||||
- ✅ 每个文件职责单一
|
||||
- ✅ 可读性大幅提高
|
||||
- ✅ 可维护性显著增强
|
||||
- ✅ 可复用性从 0 到 100%
|
||||
|
||||
### ESLint / 代码规范
|
||||
|
||||
| 指标 | 重构前 | 重构后 |
|
||||
|------|--------|--------|
|
||||
| **函数平均行数** | ~50 行 | ~15 行 |
|
||||
| **最大函数行数** | 200+ 行 | 60 行 |
|
||||
| **嵌套层级** | 最深 6 层 | 最深 3 层 |
|
||||
| **循环复杂度** | 高 | 低 |
|
||||
|
||||
---
|
||||
|
||||
## ✅ 业务逻辑保留验证
|
||||
|
||||
### 权限控制 ✅ 完全保留
|
||||
|
||||
| 功能 | 重构前 | 重构后 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| `hasFeatureAccess` 检查 | ✅ | ✅ | 保留 |
|
||||
| `getUpgradeRecommendation` | ✅ | ✅ | 保留 |
|
||||
| Tab 锁定图标显示 | ✅ | ✅ | 保留 |
|
||||
| LockedContent UI | ✅ | ✅ | 提取为组件 |
|
||||
| SubscriptionUpgradeModal | ✅ | ✅ | 保留 |
|
||||
|
||||
### 数据加载 ✅ 完全保留
|
||||
|
||||
| API 调用 | 重构前 | 重构后 | 状态 |
|
||||
|---------|--------|--------|------|
|
||||
| getRelatedStocks | ✅ | ✅ | 移至 Redux |
|
||||
| getStockQuotes | ✅ | ✅ | 移至 Redux |
|
||||
| getEventDetail | ✅ | ✅ | 移至 Redux |
|
||||
| getHistoricalEvents | ✅ | ✅ | 移至 Redux |
|
||||
| getTransmissionChainAnalysis | ✅ | ✅ | 移至 Redux |
|
||||
| getExpectationScore | ✅ | ✅ | 移至 Redux |
|
||||
|
||||
### K 线缓存 ✅ 完全保留
|
||||
|
||||
| 功能 | 重构前 | 重构后 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| klineDataCache Map | ✅ | ✅ | 移至 utils/ |
|
||||
| pendingRequests 去重 | ✅ | ✅ | 移至 utils/ |
|
||||
| 智能刷新策略 | ✅ | ✅ | 移至 utils/ |
|
||||
| 交易时段检测 | ✅ | ✅ | 移至 utils/ |
|
||||
|
||||
### 自选股管理 ✅ 完全保留
|
||||
|
||||
| 功能 | 重构前 | 重构后 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| loadWatchlist | ✅ | ✅ | 移至 Hook |
|
||||
| handleWatchlistToggle | ✅ | ✅ | 移至 Hook |
|
||||
| API: GET /watchlist | ✅ | ✅ | 保留 |
|
||||
| API: POST /watchlist | ✅ | ✅ | 保留 |
|
||||
| API: DELETE /watchlist/:code | ✅ | ✅ | 保留 |
|
||||
| credentials: 'include' | ✅ | ✅ | 保留 |
|
||||
|
||||
### 实时监控 ✅ 完全保留
|
||||
|
||||
| 功能 | 重构前 | 重构后 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| 5 秒定时刷新 | ✅ | ✅ | 移至 Hook |
|
||||
| 定时器清理 | ✅ | ✅ | Hook 自动清理 |
|
||||
| 监控开关 | ✅ | ✅ | 保留 |
|
||||
| 立即执行一次 | ✅ | ✅ | 保留 |
|
||||
|
||||
### UI 交互 ✅ 完全保留
|
||||
|
||||
| 功能 | 重构前 | 重构后 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| Tab 切换 | ✅ | ✅ | 保留 |
|
||||
| 搜索过滤 | ✅ | ✅ | 保留 |
|
||||
| 行点击固定图表 | ✅ | ✅ | 保留 |
|
||||
| 关联描述展开/收起 | ✅ | ✅ | 移至 StockTable |
|
||||
| 讨论模态框 | ✅ | ✅ | 保留 |
|
||||
| 升级模态框 | ✅ | ✅ | 保留 |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 重构收益总结
|
||||
|
||||
### 技术收益
|
||||
|
||||
| 维度 | 收益 | 量化指标 |
|
||||
|------|------|---------|
|
||||
| **代码质量** | 显著提升 | 主文件行数 ⬇️ 67.5% |
|
||||
| **可维护性** | 显著提升 | 模块化，单一职责 |
|
||||
| **可测试性** | 从困难到容易 | 可独立测试每个模块 |
|
||||
| **可复用性** | 从 0 到 100% | 5 个可复用组件 |
|
||||
| **性能** | 提升 60-80% | 缓存命中率高 |
|
||||
| **开发效率** | 提升 40% | 并行开发，减少冲突 |
|
||||
|
||||
### 业务收益
|
||||
|
||||
| 维度 | 收益 |
|
||||
|------|------|
|
||||
| **功能完整性** | ✅ 100% 保留原有功能 |
|
||||
| **用户体验** | ✅ 页面响应速度提升 |
|
||||
| **稳定性** | ✅ 减少内存泄漏风险 |
|
||||
| **扩展性** | ✅ 易于添加新功能 |
|
||||
|
||||
### 团队收益
|
||||
|
||||
| 维度 | 收益 |
|
||||
|------|------|
|
||||
| **协作效率** | ✅ 减少代码冲突 |
|
||||
| **代码审查** | ✅ 更容易 review |
|
||||
| **知识传递** | ✅ 新人易于理解 |
|
||||
| **长期维护** | ✅ 降低维护成本 |
|
||||
|
||||
---
|
||||
|
||||
## 📝 重构最佳实践总结
|
||||
|
||||
本次重构遵循的原则：
|
||||
|
||||
### 1. **关注点分离** (Separation of Concerns)
|
||||
- ✅ UI 组件只负责渲染
|
||||
- ✅ Custom Hooks 负责业务逻辑
|
||||
- ✅ Redux 负责状态管理
|
||||
- ✅ Utils 负责工具函数
|
||||
|
||||
### 2. **单一职责** (Single Responsibility)
|
||||
- ✅ 每个文件只做一件事
|
||||
- ✅ 每个函数只有一个职责
|
||||
- ✅ 组件职责清晰
|
||||
|
||||
### 3. **开闭原则** (Open-Closed)
|
||||
- ✅ 对扩展开放：易于添加新功能
|
||||
- ✅ 对修改封闭：不破坏现有功能
|
||||
|
||||
### 4. **DRY 原则** (Don't Repeat Yourself)
|
||||
- ✅ 提取可复用组件
|
||||
- ✅ 封装通用逻辑
|
||||
- ✅ 避免代码重复
|
||||
|
||||
### 5. **可测试性优先**
|
||||
- ✅ 每个模块独立可测
|
||||
- ✅ 纯函数易于测试
|
||||
- ✅ Mock 依赖简单
|
||||
|
||||
---
|
||||
|
||||
## 🚀 后续优化建议
|
||||
|
||||
虽然本次重构已大幅改善代码质量，但仍有优化空间：
|
||||
|
||||
### 短期优化 (1-2 周)
|
||||
|
||||
1. **添加单元测试**
|
||||
- [ ] useEventStocks 测试覆盖率 > 80%
|
||||
- [ ] stockSlice 测试覆盖率 > 90%
|
||||
- [ ] 组件快照测试
|
||||
|
||||
2. **性能监控**
|
||||
- [ ] 添加 React.memo 优化渲染
|
||||
- [ ] 监控 API 调用次数
|
||||
- [ ] 监控缓存命中率
|
||||
|
||||
3. **文档完善**
|
||||
- [ ] 组件 API 文档
|
||||
- [ ] Hook 使用指南
|
||||
- [ ] Storybook 示例
|
||||
|
||||
### 中期优化 (1-2 月)
|
||||
|
||||
1. **TypeScript 迁移**
|
||||
- [ ] 添加类型定义
|
||||
- [ ] 提升类型安全
|
||||
|
||||
2. **Error Boundary**
|
||||
- [ ] 添加错误边界
|
||||
- [ ] 优雅降级
|
||||
|
||||
3. **国际化支持**
|
||||
- [ ] 提取文案
|
||||
- [ ] 支持多语言
|
||||
|
||||
### 长期优化 (3-6 月)
|
||||
|
||||
1. **微前端拆分**
|
||||
- [ ] 股票模块独立部署
|
||||
- [ ] 按需加载
|
||||
|
||||
2. **性能极致优化**
|
||||
- [ ] 虚拟滚动
|
||||
- [ ] Web Worker 计算
|
||||
- [ ] Service Worker 缓存
|
||||
|
||||
---
|
||||
|
||||
**文档结束**
|
||||
|
||||
> 本次重构是一次成功的工程实践，在保持 100% 功能完整性的前提下，实现了代码质量的质的飞跃。
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,484 +0,0 @@
|
||||
# PostHog 事件追踪验证清单
|
||||
|
||||
## 📋 验证目的
|
||||
|
||||
本清单用于验证所有PostHog事件追踪是否正常工作。建议在以下场景使用：
|
||||
- ✅ 开发环境集成后的验证
|
||||
- ✅ 上线前的最终检查
|
||||
- ✅ 定期追踪健康度检查
|
||||
- ✅ 新功能上线后的验证
|
||||
|
||||
---
|
||||
|
||||
## 🔧 验证准备
|
||||
|
||||
### 1. 环境检查
|
||||
- [ ] PostHog已正确配置（检查.env文件）
|
||||
- [ ] PostHog控制台可以访问
|
||||
- [ ] 开发者工具Network面板可以看到PostHog请求
|
||||
- [ ] 浏览器Console没有PostHog相关错误
|
||||
|
||||
### 2. 验证工具
|
||||
- [ ] 打开浏览器开发者工具（F12）
|
||||
- [ ] 切换到Network标签
|
||||
- [ ] 过滤器设置为：`posthog` 或 `api/events`
|
||||
- [ ] 打开Console标签查看logger.debug输出
|
||||
|
||||
### 3. PostHog控制台
|
||||
- [ ] 登录 https://app.posthog.com
|
||||
- [ ] 进入项目
|
||||
- [ ] 打开 "Live events" 视图
|
||||
- [ ] 准备监控实时事件
|
||||
|
||||
---
|
||||
|
||||
## ✅ 功能模块验证
|
||||
|
||||
### 🔐 认证模块（useAuthEvents）
|
||||
|
||||
#### 注册流程
|
||||
- [ ] 打开注册页面
|
||||
- [ ] 填写手机号和密码
|
||||
- [ ] 点击注册按钮
|
||||
- [ ] **验证事件**: `USER_SIGNED_UP`
|
||||
- 检查属性：`signup_method`, `user_id`
|
||||
|
||||
#### 登录流程
|
||||
- [ ] 打开登录页面
|
||||
- [ ] 使用密码登录
|
||||
- [ ] **验证事件**: `USER_LOGGED_IN`
|
||||
- 检查属性：`login_method: 'password'`
|
||||
- [ ] 退出登录
|
||||
- [ ] 使用微信登录
|
||||
- [ ] **验证事件**: `USER_LOGGED_IN`
|
||||
- 检查属性：`login_method: 'wechat'`
|
||||
|
||||
#### 登出
|
||||
- [ ] 点击退出登录
|
||||
- [ ] **验证事件**: `USER_LOGGED_OUT`
|
||||
|
||||
---
|
||||
|
||||
### 🏠 社区模块（useCommunityEvents）
|
||||
|
||||
#### 页面浏览
|
||||
- [ ] 访问社区页面 `/community`
|
||||
- [ ] **验证事件**: `Community Page Viewed`
|
||||
- [ ] **验证事件**: `News List Viewed`
|
||||
- 检查属性：`total_count`, `sort_by`, `importance_filter`
|
||||
|
||||
#### 新闻点击
|
||||
- [ ] 点击任一新闻事件
|
||||
- [ ] **验证事件**: `NEWS_ARTICLE_CLICKED`
|
||||
- 检查属性：`event_id`, `event_title`, `importance`
|
||||
|
||||
#### 搜索功能
|
||||
- [ ] 在搜索框输入关键词
|
||||
- [ ] 点击搜索
|
||||
- [ ] **验证事件**: `SEARCH_QUERY_SUBMITTED`
|
||||
- 检查属性：`query`, `result_count`, `context: 'community'`
|
||||
|
||||
#### 筛选功能
|
||||
- [ ] 切换重要性筛选
|
||||
- [ ] **验证事件**: `SEARCH_FILTER_APPLIED`
|
||||
- 检查属性：`filter_type: 'importance'`
|
||||
- [ ] 切换排序方式
|
||||
- [ ] **验证事件**: `SEARCH_FILTER_APPLIED`
|
||||
- 检查属性：`filter_type: 'sort'`
|
||||
|
||||
---
|
||||
|
||||
### 📰 事件详情模块（useEventDetailEvents）
|
||||
|
||||
#### 页面浏览
|
||||
- [ ] 点击任一事件进入详情页
|
||||
- [ ] **验证事件**: `EVENT_DETAIL_VIEWED`
|
||||
- 检查属性：`event_id`, `event_title`, `importance`
|
||||
|
||||
#### 分析查看
|
||||
- [ ] 页面加载完成后
|
||||
- [ ] **验证事件**: `EVENT_ANALYSIS_VIEWED`
|
||||
- 检查属性：`analysis_type`, `related_stock_count`
|
||||
|
||||
#### 标签切换
|
||||
- [ ] 点击"相关股票"标签
|
||||
- [ ] **验证事件**: `NEWS_TAB_CLICKED`
|
||||
- 检查属性：`tab_name: 'related_stocks'`
|
||||
|
||||
#### 相关股票点击
|
||||
- [ ] 点击任一相关股票
|
||||
- [ ] **验证事件**: `STOCK_CLICKED`
|
||||
- 检查属性：`stock_code`, `source: 'event_detail_related_stocks'`
|
||||
|
||||
#### 社交互动
|
||||
- [ ] 点击评论点赞按钮
|
||||
- [ ] **验证事件**: `Comment Liked` 或 `Comment Unliked`
|
||||
- 检查属性：`comment_id`, `event_id`, `action`
|
||||
- [ ] 输入评论内容
|
||||
- [ ] 点击发表评论
|
||||
- [ ] **验证事件**: `Comment Added`
|
||||
- 检查属性：`comment_id`, `event_id`, `content_length`
|
||||
- [ ] 删除自己的评论（如果有）
|
||||
- [ ] **验证事件**: `Comment Deleted`
|
||||
- 检查属性：`comment_id`
|
||||
|
||||
---
|
||||
|
||||
### 📊 仪表板模块（useDashboardEvents）
|
||||
|
||||
#### 页面浏览
|
||||
- [ ] 访问个人中心 `/dashboard/center`
|
||||
- [ ] **验证事件**: `DASHBOARD_CENTER_VIEWED`
|
||||
- 检查属性：`page_type: 'center'`
|
||||
|
||||
#### 自选股
|
||||
- [ ] 查看自选股列表
|
||||
- [ ] **验证事件**: `Watchlist Viewed`
|
||||
- 检查属性：`stock_count`, `has_stocks`
|
||||
|
||||
#### 关注的事件
|
||||
- [ ] 查看关注的事件列表
|
||||
- [ ] **验证事件**: `Following Events Viewed`
|
||||
- 检查属性：`event_count`
|
||||
|
||||
#### 评论管理
|
||||
- [ ] 查看我的评论
|
||||
- [ ] **验证事件**: `Comments Viewed`
|
||||
- 检查属性：`comment_count`
|
||||
|
||||
---
|
||||
|
||||
### 💹 模拟盘模块（useTradingSimulationEvents）
|
||||
|
||||
#### 进入模拟盘
|
||||
- [ ] 访问模拟盘页面 `/trading-simulation`
|
||||
- [ ] **验证事件**: `TRADING_SIMULATION_ENTERED`
|
||||
- 检查属性：`total_value`, `available_cash`, `holdings_count`
|
||||
|
||||
#### 搜索股票
|
||||
- [ ] 在搜索框输入股票代码/名称
|
||||
- [ ] **验证事件**: `Simulation Stock Searched`
|
||||
- 检查属性：`query`
|
||||
|
||||
#### 下单操作
|
||||
- [ ] 选择一只股票
|
||||
- [ ] 输入数量和价格
|
||||
- [ ] 点击买入/卖出
|
||||
- [ ] **验证事件**: `Simulation Order Placed`
|
||||
- 检查属性：`stock_code`, `order_type`, `quantity`, `price`
|
||||
|
||||
#### 持仓查看
|
||||
- [ ] 切换到持仓标签
|
||||
- [ ] **验证事件**: `Simulation Holdings Viewed`
|
||||
- 检查属性：`holdings_count`, `total_value`
|
||||
|
||||
---
|
||||
|
||||
### 🔍 搜索模块（useSearchEvents）
|
||||
|
||||
#### 搜索发起
|
||||
- [ ] 点击搜索框获得焦点
|
||||
- [ ] **验证事件**: `SEARCH_INITIATED`
|
||||
- 检查属性：`context: 'community'`
|
||||
|
||||
#### 搜索提交
|
||||
- [ ] 输入搜索词
|
||||
- [ ] 按回车或点击搜索
|
||||
- [ ] **验证事件**: `SEARCH_QUERY_SUBMITTED`
|
||||
- 检查属性：`query`, `result_count`, `has_results`
|
||||
|
||||
#### 无结果追踪
|
||||
- [ ] 搜索一个不存在的词
|
||||
- [ ] **验证事件**: `SEARCH_NO_RESULTS`
|
||||
- 检查属性：`query`, `context`
|
||||
|
||||
---
|
||||
|
||||
### 🧭 导航模块（useNavigationEvents）
|
||||
|
||||
#### Logo点击
|
||||
- [ ] 点击页面左上角Logo
|
||||
- [ ] **验证事件**: `Logo Clicked`
|
||||
- 检查属性：`component: 'main_navbar'`
|
||||
|
||||
#### 主题切换
|
||||
- [ ] 点击主题切换按钮
|
||||
- [ ] **验证事件**: `Theme Changed`
|
||||
- 检查属性：`from_theme`, `to_theme`
|
||||
|
||||
#### 顶部导航
|
||||
- [ ] 点击"高频跟踪"下拉菜单
|
||||
- [ ] 点击"事件中心"
|
||||
- [ ] **验证事件**: `MENU_ITEM_CLICKED`
|
||||
- 检查属性：`item_name: '事件中心'`, `menu_type: 'dropdown'`
|
||||
|
||||
#### 二级导航
|
||||
- [ ] 在二级导航栏点击任一菜单
|
||||
- [ ] **验证事件**: `SIDEBAR_MENU_CLICKED`
|
||||
- 检查属性：`item_name`, `path`, `level: 2`
|
||||
|
||||
---
|
||||
|
||||
### 👤 个人资料模块（useProfileEvents）
|
||||
|
||||
#### 个人资料页面
|
||||
- [ ] 访问个人资料页 `/profile`
|
||||
- [ ] 点击编辑按钮
|
||||
- [ ] **验证事件**: `Profile Field Edit Started`
|
||||
|
||||
#### 更新资料
|
||||
- [ ] 修改昵称或其他信息
|
||||
- [ ] 点击保存
|
||||
- [ ] **验证事件**: `PROFILE_UPDATED`
|
||||
- 检查属性：`updated_fields`, `field_count`
|
||||
|
||||
#### 上传头像
|
||||
- [ ] 点击头像上传
|
||||
- [ ] 选择图片
|
||||
- [ ] **验证事件**: `Avatar Uploaded`
|
||||
- 检查属性：`upload_method`, `file_size`
|
||||
|
||||
#### 设置页面
|
||||
- [ ] 访问设置页 `/settings`
|
||||
- [ ] 点击修改密码
|
||||
- [ ] 输入当前密码和新密码
|
||||
- [ ] 提交
|
||||
- [ ] **验证事件**: `Password Changed`
|
||||
- 检查属性：`success: true`
|
||||
|
||||
#### 通知设置
|
||||
- [ ] 切换通知开关
|
||||
- [ ] 点击保存
|
||||
- [ ] **验证事件**: `Notification Preferences Changed`
|
||||
- 检查属性：`email_enabled`, `push_enabled`, `sms_enabled`
|
||||
|
||||
#### 账号绑定
|
||||
- [ ] 输入邮箱地址
|
||||
- [ ] 获取验证码
|
||||
- [ ] 输入验证码绑定
|
||||
- [ ] **验证事件**: `Account Bound`
|
||||
- 检查属性：`account_type: 'email'`, `success: true`
|
||||
|
||||
---
|
||||
|
||||
### 💳 订阅支付模块（useSubscriptionEvents）
|
||||
|
||||
#### 订阅页面查看
|
||||
- [ ] 打开订阅管理页面
|
||||
- [ ] **验证事件**: `SUBSCRIPTION_PAGE_VIEWED`
|
||||
- 检查属性：`current_plan`, `subscription_status`
|
||||
|
||||
#### 定价方案查看
|
||||
- [ ] 浏览不同的定价方案
|
||||
- [ ] **验证事件**: `Pricing Plan Viewed`
|
||||
- 检查属性：`plan_name`, `price`
|
||||
|
||||
#### 选择方案
|
||||
- [ ] 选择月付/年付
|
||||
- [ ] 点击"立即订阅"
|
||||
- [ ] **验证事件**: `Pricing Plan Selected`
|
||||
- 检查属性：`plan_name`, `billing_cycle`, `price`
|
||||
|
||||
#### 查看支付页面
|
||||
- [ ] 进入支付页面
|
||||
- [ ] **验证事件**: `PAYMENT_PAGE_VIEWED`
|
||||
- 检查属性：`plan_name`, `amount`
|
||||
|
||||
#### 支付流程
|
||||
- [ ] 选择支付方式（微信支付）
|
||||
- [ ] **验证事件**: `PAYMENT_METHOD_SELECTED`
|
||||
- 检查属性：`payment_method: 'wechat_pay'`
|
||||
- [ ] 点击创建订单
|
||||
- [ ] **验证事件**: `PAYMENT_INITIATED`
|
||||
- 检查属性：`plan_name`, `amount`, `payment_method`
|
||||
|
||||
#### 支付成功（需要完成支付）
|
||||
- [ ] 完成微信支付
|
||||
- [ ] **验证事件**: `PAYMENT_SUCCESSFUL`
|
||||
- 检查属性：`order_id`, `transaction_id`
|
||||
- [ ] **验证事件**: `SUBSCRIPTION_CREATED`
|
||||
- 检查属性：`plan`, `billing_cycle`, `start_date`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 关键漏斗验证
|
||||
|
||||
### 注册激活漏斗
|
||||
1. [ ] `PAGE_VIEWED` (注册页)
|
||||
2. [ ] `USER_SIGNED_UP`
|
||||
3. [ ] `USER_LOGGED_IN`
|
||||
4. [ ] `PROFILE_UPDATED` (完善资料)
|
||||
|
||||
### 内容消费漏斗
|
||||
1. [ ] `Community Page Viewed`
|
||||
2. [ ] `News List Viewed`
|
||||
3. [ ] `NEWS_ARTICLE_CLICKED`
|
||||
4. [ ] `EVENT_DETAIL_VIEWED`
|
||||
5. [ ] `Comment Added` (深度互动)
|
||||
|
||||
### 付费转化漏斗
|
||||
1. [ ] `PAYWALL_SHOWN` (触发付费墙)
|
||||
2. [ ] `SUBSCRIPTION_PAGE_VIEWED`
|
||||
3. [ ] `Pricing Plan Selected`
|
||||
4. [ ] `PAYMENT_INITIATED`
|
||||
5. [ ] `PAYMENT_SUCCESSFUL`
|
||||
6. [ ] `SUBSCRIPTION_CREATED`
|
||||
|
||||
### 模拟盘转化漏斗
|
||||
1. [ ] `TRADING_SIMULATION_ENTERED`
|
||||
2. [ ] `Simulation Stock Searched`
|
||||
3. [ ] `Simulation Order Placed`
|
||||
4. [ ] `Simulation Holdings Viewed`
|
||||
|
||||
---
|
||||
|
||||
## 🐛 错误场景验证
|
||||
|
||||
### 失败追踪验证
|
||||
- [ ] 密码修改失败
|
||||
- **验证事件**: `Password Changed` (success: false)
|
||||
- [ ] 支付失败
|
||||
- **验证事件**: `PAYMENT_FAILED`
|
||||
- 检查属性：`error_reason`
|
||||
- [ ] 个人资料更新失败
|
||||
- **验证事件**: `Profile Update Failed`
|
||||
- 检查属性：`attempted_fields`, `error_message`
|
||||
|
||||
---
|
||||
|
||||
## 📊 PostHog控制台验证
|
||||
|
||||
### 实时事件检查
|
||||
- [ ] 登录PostHog控制台
|
||||
- [ ] 进入 "Live events" 页面
|
||||
- [ ] 执行上述操作
|
||||
- [ ] 确认每个操作都有对应事件出现
|
||||
- [ ] 检查事件属性完整性
|
||||
|
||||
### 用户属性检查
|
||||
- [ ] 进入 "Persons" 页面
|
||||
- [ ] 找到测试用户
|
||||
- [ ] 验证用户属性：
|
||||
- [ ] `user_id`
|
||||
- [ ] `email` (如果有)
|
||||
- [ ] `subscription_tier`
|
||||
- [ ] `role`
|
||||
|
||||
### 事件属性检查
|
||||
对于每个验证的事件，确认以下属性存在：
|
||||
- [ ] `timestamp` - 时间戳
|
||||
- [ ] 事件特定属性（如 event_id, stock_code 等）
|
||||
- [ ] 上下文属性（如 context, page_type 等）
|
||||
|
||||
---
|
||||
|
||||
## 🔍 开发者工具验证
|
||||
|
||||
### Network 面板
|
||||
- [ ] 找到 PostHog API 请求
|
||||
- [ ] 检查请求URL: `https://app.posthog.com/e/`
|
||||
- [ ] 检查请求Method: POST
|
||||
- [ ] 检查Response Status: 200
|
||||
- [ ] 检查Request Payload包含事件数据
|
||||
|
||||
### Console 面板
|
||||
- [ ] 查找 logger.debug 输出
|
||||
- [ ] 格式如：`[useFeatureEvents] 📊 Action Tracked`
|
||||
- [ ] 验证输出的事件名称和参数正确
|
||||
|
||||
---
|
||||
|
||||
## ✅ 验证通过标准
|
||||
|
||||
### 单个事件验证通过
|
||||
- ✅ Network面板能看到PostHog请求
|
||||
- ✅ Console能看到logger.debug输出
|
||||
- ✅ PostHog Live events能看到事件
|
||||
- ✅ 事件名称正确
|
||||
- ✅ 事件属性完整且准确
|
||||
|
||||
### 整体验证通过
|
||||
- ✅ 所有核心功能模块至少验证了主要流程
|
||||
- ✅ 关键漏斗的每一步都能追踪到
|
||||
- ✅ 成功和失败场景都有追踪
|
||||
- ✅ 没有JavaScript错误
|
||||
- ✅ 所有事件在PostHog控制台可见
|
||||
|
||||
---
|
||||
|
||||
## 📝 验证记录
|
||||
|
||||
### 验证信息
|
||||
- **验证日期**: _______________
|
||||
- **验证人员**: _______________
|
||||
- **验证环境**: [ ] 开发环境 [ ] 测试环境 [ ] 生产环境
|
||||
- **PostHog项目**: _______________
|
||||
|
||||
### 验证结果
|
||||
- **总验证项**: _____
|
||||
- **通过项**: _____
|
||||
- **失败项**: _____
|
||||
- **通过率**: _____%
|
||||
|
||||
### 发现的问题
|
||||
| 问题描述 | 严重程度 | 状态 | 备注 |
|
||||
|---------|---------|------|------|
|
||||
| | | | |
|
||||
| | | | |
|
||||
|
||||
### 验证结论
|
||||
- [ ] ✅ 全部通过，可以上线
|
||||
- [ ] ⚠️ 有轻微问题，可以上线但需修复
|
||||
- [ ] ❌ 有严重问题，需要修复后重新验证
|
||||
|
||||
---
|
||||
|
||||
## 🔧 常见问题排查
|
||||
|
||||
### 问题1: 看不到PostHog请求
|
||||
**可能原因**:
|
||||
- PostHog未正确初始化
|
||||
- API Key配置错误
|
||||
- 网络被拦截
|
||||
|
||||
**排查步骤**:
|
||||
1. 检查 `.env` 文件中的 `REACT_APP_POSTHOG_KEY`
|
||||
2. 检查浏览器Console是否有错误
|
||||
3. 检查网络代理设置
|
||||
|
||||
### 问题2: 事件属性缺失
|
||||
**可能原因**:
|
||||
- 传参时属性名拼写错误
|
||||
- 某些数据为undefined
|
||||
- Hook未正确初始化
|
||||
|
||||
**排查步骤**:
|
||||
1. 查看Console的logger.debug输出
|
||||
2. 检查Hook初始化时传入的参数
|
||||
3. 检查调用追踪方法时的参数
|
||||
|
||||
### 问题3: 事件未在PostHog显示
|
||||
**可能原因**:
|
||||
- 数据同步延迟（通常<1分钟）
|
||||
- PostHog项目选择错误
|
||||
- 事件被过滤
|
||||
|
||||
**排查步骤**:
|
||||
1. 等待1-2分钟后刷新
|
||||
2. 确认选择了正确的项目
|
||||
3. 检查PostHog的事件过滤器设置
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关资源
|
||||
|
||||
- [PostHog 官方文档](https://posthog.com/docs)
|
||||
- [POSTHOG_TRACKING_GUIDE.md](./POSTHOG_TRACKING_GUIDE.md) - 开发者指南
|
||||
- [POSTHOG_INTEGRATION.md](./POSTHOG_INTEGRATION.md) - 集成说明
|
||||
- [constants.js](./src/lib/constants.js) - 事件常量定义
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: v1.0
|
||||
**最后更新**: 2025-10-29
|
||||
**维护者**: 开发团队
|
||||
@@ -1,546 +0,0 @@
|
||||
# WebSocket 事件实时推送 - 前端集成指南
|
||||
|
||||
## 📦 已创建的文件
|
||||
|
||||
1. **`src/services/socketService.js`** - WebSocket 服务（已扩展）
|
||||
2. **`src/hooks/useEventNotifications.js`** - React Hook
|
||||
3. **`test_websocket.html`** - 测试页面
|
||||
4. **`test_create_event.py`** - 测试脚本
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 方案 1：使用 React Hook（推荐）
|
||||
|
||||
在任何 React 组件中使用：
|
||||
|
||||
```jsx
|
||||
import { useEventNotifications } from 'hooks/useEventNotifications';
|
||||
import { useToast } from '@chakra-ui/react';
|
||||
|
||||
function EventsPage() {
|
||||
const toast = useToast();
|
||||
|
||||
// 订阅事件推送
|
||||
const { newEvent, isConnected } = useEventNotifications({
|
||||
eventType: 'all', // 'all' | 'policy' | 'market' | 'tech' | ...
|
||||
importance: 'all', // 'all' | 'S' | 'A' | 'B' | 'C'
|
||||
enabled: true, // 是否启用订阅
|
||||
onNewEvent: (event) => {
|
||||
// 收到新事件时的处理
|
||||
console.log('🔔 收到新事件:', event);
|
||||
|
||||
// 显示 Toast 通知
|
||||
toast({
|
||||
title: '新事件提醒',
|
||||
description: event.title,
|
||||
status: 'info',
|
||||
duration: 5000,
|
||||
isClosable: true,
|
||||
position: 'top-right',
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
return (
|
||||
<Box>
|
||||
<Text>连接状态: {isConnected ? '已连接 ✅' : '未连接 ❌'}</Text>
|
||||
{/* 你的事件列表 */}
|
||||
</Box>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 方案 2：在事件列表页面集成（完整示例）
|
||||
|
||||
**在 `src/views/Community/components/EventList.js` 中集成：**
|
||||
|
||||
```jsx
|
||||
import React, { useState, useEffect } from 'react';
|
||||
import { Box, Text, Badge, useToast } from '@chakra-ui/react';
|
||||
import { useEventNotifications } from 'hooks/useEventNotifications';
|
||||
|
||||
function EventList() {
|
||||
const [events, setEvents] = useState([]);
|
||||
const [loading, setLoading] = useState(true);
|
||||
const toast = useToast();
|
||||
|
||||
// 1️⃣ 初始加载事件列表（REST API）
|
||||
useEffect(() => {
|
||||
fetchEvents();
|
||||
}, []);
|
||||
|
||||
const fetchEvents = async () => {
|
||||
try {
|
||||
const response = await fetch('/api/events?per_page=20');
|
||||
const data = await response.json();
|
||||
|
||||
if (data.success) {
|
||||
setEvents(data.data.events);
|
||||
}
|
||||
} catch (error) {
|
||||
console.error('加载事件失败:', error);
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
// 2️⃣ 订阅 WebSocket 实时推送
|
||||
const { newEvent, isConnected } = useEventNotifications({
|
||||
eventType: 'all',
|
||||
importance: 'all',
|
||||
enabled: true, // 可以根据用户设置控制是否启用
|
||||
onNewEvent: (event) => {
|
||||
console.log('🔔 收到新事件:', event);
|
||||
|
||||
// 显示通知
|
||||
toast({
|
||||
title: '📰 新事件发布',
|
||||
description: `${event.title}`,
|
||||
status: 'info',
|
||||
duration: 6000,
|
||||
isClosable: true,
|
||||
position: 'top-right',
|
||||
});
|
||||
|
||||
// 将新事件添加到列表顶部
|
||||
setEvents((prevEvents) => {
|
||||
// 检查是否已存在（防止重复）
|
||||
const exists = prevEvents.some(e => e.id === event.id);
|
||||
if (exists) {
|
||||
return prevEvents;
|
||||
}
|
||||
// 添加到顶部，最多保留 100 个
|
||||
return [event, ...prevEvents].slice(0, 100);
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
return (
|
||||
<Box>
|
||||
{/* 连接状态指示器 */}
|
||||
<Box mb={4} display="flex" alignItems="center" gap={2}>
|
||||
<Badge colorScheme={isConnected ? 'green' : 'red'}>
|
||||
{isConnected ? '实时推送已开启' : '实时推送未连接'}
|
||||
</Badge>
|
||||
</Box>
|
||||
|
||||
{/* 事件列表 */}
|
||||
{loading ? (
|
||||
<Text>加载中...</Text>
|
||||
) : (
|
||||
<Box>
|
||||
{events.map((event) => (
|
||||
<EventCard key={event.id} event={event} />
|
||||
))}
|
||||
</Box>
|
||||
)}
|
||||
</Box>
|
||||
);
|
||||
}
|
||||
|
||||
export default EventList;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 方案 3：只订阅重要事件（S 和 A 级）
|
||||
|
||||
```jsx
|
||||
import { useImportantEventNotifications } from 'hooks/useEventNotifications';
|
||||
|
||||
function Dashboard() {
|
||||
const { importantEvents, isConnected } = useImportantEventNotifications((event) => {
|
||||
// 只会收到 S 和 A 级别的重要事件
|
||||
console.log('⚠️ 重要事件:', event);
|
||||
|
||||
// 播放提示音
|
||||
new Audio('/notification.mp3').play();
|
||||
});
|
||||
|
||||
return (
|
||||
<Box>
|
||||
<Heading>重要事件通知</Heading>
|
||||
{importantEvents.map(event => (
|
||||
<Alert key={event.id} status="warning">
|
||||
<AlertIcon />
|
||||
{event.title}
|
||||
</Alert>
|
||||
))}
|
||||
</Box>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 方案 4：直接使用 Service（不用 Hook）
|
||||
|
||||
```jsx
|
||||
import { useEffect } from 'react';
|
||||
import socketService from 'services/socketService';
|
||||
|
||||
function MyComponent() {
|
||||
useEffect(() => {
|
||||
// 连接
|
||||
socketService.connect();
|
||||
|
||||
// 订阅
|
||||
const unsubscribe = socketService.subscribeToAllEvents((event) => {
|
||||
console.log('新事件:', event);
|
||||
});
|
||||
|
||||
// 清理
|
||||
return () => {
|
||||
unsubscribe();
|
||||
socketService.disconnect();
|
||||
};
|
||||
}, []);
|
||||
|
||||
return <div>...</div>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 UI 集成示例
|
||||
|
||||
### 1. Toast 通知（Chakra UI）
|
||||
|
||||
```jsx
|
||||
import { useToast } from '@chakra-ui/react';
|
||||
|
||||
const toast = useToast();
|
||||
|
||||
// 在 onNewEvent 回调中
|
||||
onNewEvent: (event) => {
|
||||
toast({
|
||||
title: '新事件',
|
||||
description: event.title,
|
||||
status: 'info',
|
||||
duration: 5000,
|
||||
isClosable: true,
|
||||
position: 'top-right',
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. 顶部通知栏
|
||||
|
||||
```jsx
|
||||
import { Alert, AlertIcon, CloseButton } from '@chakra-ui/react';
|
||||
|
||||
function EventNotificationBanner() {
|
||||
const [showNotification, setShowNotification] = useState(false);
|
||||
const [latestEvent, setLatestEvent] = useState(null);
|
||||
|
||||
useEventNotifications({
|
||||
eventType: 'all',
|
||||
onNewEvent: (event) => {
|
||||
setLatestEvent(event);
|
||||
setShowNotification(true);
|
||||
}
|
||||
});
|
||||
|
||||
if (!showNotification || !latestEvent) return null;
|
||||
|
||||
return (
|
||||
<Alert status="info" variant="solid">
|
||||
<AlertIcon />
|
||||
新事件：{latestEvent.title}
|
||||
<CloseButton
|
||||
position="absolute"
|
||||
right="8px"
|
||||
top="8px"
|
||||
onClick={() => setShowNotification(false)}
|
||||
/>
|
||||
</Alert>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 角标提示（红点）
|
||||
|
||||
```jsx
|
||||
import { Badge } from '@chakra-ui/react';
|
||||
|
||||
function EventsMenuItem() {
|
||||
const [unreadCount, setUnreadCount] = useState(0);
|
||||
|
||||
useEventNotifications({
|
||||
eventType: 'all',
|
||||
onNewEvent: () => {
|
||||
setUnreadCount(prev => prev + 1);
|
||||
}
|
||||
});
|
||||
|
||||
return (
|
||||
<MenuItem position="relative">
|
||||
事件中心
|
||||
{unreadCount > 0 && (
|
||||
<Badge
|
||||
colorScheme="red"
|
||||
position="absolute"
|
||||
top="-5px"
|
||||
right="-5px"
|
||||
borderRadius="full"
|
||||
>
|
||||
{unreadCount > 99 ? '99+' : unreadCount}
|
||||
</Badge>
|
||||
)}
|
||||
</MenuItem>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. 浮动通知卡片
|
||||
|
||||
```jsx
|
||||
import { Box, Slide, useDisclosure } from '@chakra-ui/react';
|
||||
|
||||
function FloatingEventNotification() {
|
||||
const { isOpen, onClose, onOpen } = useDisclosure();
|
||||
const [event, setEvent] = useState(null);
|
||||
|
||||
useEventNotifications({
|
||||
eventType: 'all',
|
||||
onNewEvent: (newEvent) => {
|
||||
setEvent(newEvent);
|
||||
onOpen();
|
||||
|
||||
// 5秒后自动关闭
|
||||
setTimeout(onClose, 5000);
|
||||
}
|
||||
});
|
||||
|
||||
return (
|
||||
<Slide direction="bottom" in={isOpen} style={{ zIndex: 10 }}>
|
||||
<Box
|
||||
p="40px"
|
||||
color="white"
|
||||
bg="blue.500"
|
||||
rounded="md"
|
||||
shadow="md"
|
||||
m={4}
|
||||
>
|
||||
<Text fontWeight="bold">{event?.title}</Text>
|
||||
<Text fontSize="sm">{event?.description}</Text>
|
||||
<Button size="sm" mt={2} onClick={onClose}>
|
||||
关闭
|
||||
</Button>
|
||||
</Box>
|
||||
</Slide>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 API 参考
|
||||
|
||||
### `useEventNotifications(options)`
|
||||
|
||||
**参数：**
|
||||
| 参数 | 类型 | 默认值 | 说明 |
|
||||
|------|------|--------|------|
|
||||
| `eventType` | string | `'all'` | 事件类型：`'all'` / `'policy'` / `'market'` / `'tech'` 等 |
|
||||
| `importance` | string | `'all'` | 重要性：`'all'` / `'S'` / `'A'` / `'B'` / `'C'` |
|
||||
| `enabled` | boolean | `true` | 是否启用订阅 |
|
||||
| `onNewEvent` | function | - | 收到新事件时的回调函数 |
|
||||
|
||||
**返回值：**
|
||||
| 属性 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| `newEvent` | object | 最新收到的事件对象 |
|
||||
| `isConnected` | boolean | WebSocket 连接状态 |
|
||||
| `error` | object | 错误信息 |
|
||||
| `clearNewEvent` | function | 清除新事件状态 |
|
||||
|
||||
---
|
||||
|
||||
### `socketService` API
|
||||
|
||||
```javascript
|
||||
// 连接
|
||||
socketService.connect(options)
|
||||
|
||||
// 断开
|
||||
socketService.disconnect()
|
||||
|
||||
// 订阅所有事件
|
||||
socketService.subscribeToAllEvents(callback)
|
||||
|
||||
// 订阅特定类型
|
||||
socketService.subscribeToEventType('tech', callback)
|
||||
|
||||
// 订阅特定重要性
|
||||
socketService.subscribeToImportantEvents('S', callback)
|
||||
|
||||
// 取消订阅
|
||||
socketService.unsubscribeFromEvents({ eventType: 'all' })
|
||||
|
||||
// 检查连接状态
|
||||
socketService.isConnected()
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 事件数据结构
|
||||
|
||||
收到的 `event` 对象包含：
|
||||
|
||||
```javascript
|
||||
{
|
||||
id: 123,
|
||||
title: "事件标题",
|
||||
description: "事件描述",
|
||||
event_type: "tech", // 类型
|
||||
importance: "S", // 重要性
|
||||
status: "active",
|
||||
created_at: "2025-01-21T14:30:00",
|
||||
hot_score: 85.5,
|
||||
view_count: 1234,
|
||||
related_avg_chg: 5.2, // 平均涨幅
|
||||
related_max_chg: 15.8, // 最大涨幅
|
||||
keywords: ["AI", "芯片"], // 关键词
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ 高级配置
|
||||
|
||||
### 1. 条件订阅（用户设置）
|
||||
|
||||
```jsx
|
||||
function EventsPage() {
|
||||
const [enableNotifications, setEnableNotifications] = useState(
|
||||
localStorage.getItem('enableEventNotifications') === 'true'
|
||||
);
|
||||
|
||||
useEventNotifications({
|
||||
eventType: 'all',
|
||||
enabled: enableNotifications, // 根据用户设置控制
|
||||
onNewEvent: handleNewEvent
|
||||
});
|
||||
|
||||
return (
|
||||
<Switch
|
||||
isChecked={enableNotifications}
|
||||
onChange={(e) => {
|
||||
const enabled = e.target.checked;
|
||||
setEnableNotifications(enabled);
|
||||
localStorage.setItem('enableEventNotifications', enabled);
|
||||
}}
|
||||
>
|
||||
启用事件实时通知
|
||||
</Switch>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. 多个订阅（不同类型）
|
||||
|
||||
```jsx
|
||||
function MultiSubscriptionExample() {
|
||||
// 订阅科技类事件
|
||||
useEventNotifications({
|
||||
eventType: 'tech',
|
||||
onNewEvent: (event) => console.log('科技事件:', event)
|
||||
});
|
||||
|
||||
// 订阅政策类事件
|
||||
useEventNotifications({
|
||||
eventType: 'policy',
|
||||
onNewEvent: (event) => console.log('政策事件:', event)
|
||||
});
|
||||
|
||||
return <div>...</div>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 防抖处理（避免通知过多）
|
||||
|
||||
```jsx
|
||||
import { debounce } from 'lodash';
|
||||
|
||||
const debouncedNotify = debounce((event) => {
|
||||
toast({
|
||||
title: '新事件',
|
||||
description: event.title,
|
||||
});
|
||||
}, 1000);
|
||||
|
||||
useEventNotifications({
|
||||
eventType: 'all',
|
||||
onNewEvent: debouncedNotify
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 测试步骤
|
||||
|
||||
1. **启动 Flask 服务**
|
||||
```bash
|
||||
python app.py
|
||||
```
|
||||
|
||||
2. **启动 React 应用**
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
|
||||
3. **创建测试事件**
|
||||
```bash
|
||||
python test_create_event.py
|
||||
```
|
||||
|
||||
4. **观察结果**
|
||||
- 最多等待 30 秒
|
||||
- 前端页面应该显示通知
|
||||
- 控制台输出日志
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q: 没有收到推送？
|
||||
**A:** 检查：
|
||||
1. Flask 服务是否启动
|
||||
2. 浏览器控制台是否有连接错误
|
||||
3. 后端日志是否显示 `[轮询] 发现 X 个新事件`
|
||||
|
||||
### Q: 连接一直失败？
|
||||
**A:** 检查：
|
||||
1. API_BASE_URL 配置是否正确
|
||||
2. CORS 配置是否包含前端域名
|
||||
3. 防火墙/代理设置
|
||||
|
||||
### Q: 收到重复通知？
|
||||
**A:** 检查是否多次调用了 Hook，确保只在需要的地方订阅一次。
|
||||
|
||||
---
|
||||
|
||||
## 📚 更多资源
|
||||
|
||||
- Socket.IO 文档: https://socket.io/docs/v4/
|
||||
- Chakra UI Toast: https://chakra-ui.com/docs/components/toast
|
||||
- React Hooks: https://react.dev/reference/react
|
||||
|
||||
---
|
||||
|
||||
**完成！🎉** 现在你的前端可以实时接收事件推送了！
|
||||
145
init-forum-es.js
145
init-forum-es.js
@@ -1,145 +0,0 @@
|
||||
/**
|
||||
* 初始化价值论坛 Elasticsearch 索引
|
||||
* 运行方式：node init-forum-es.js
|
||||
*/
|
||||
|
||||
const axios = require('axios');
|
||||
|
||||
// Elasticsearch 配置
|
||||
const ES_BASE_URL = 'http://222.128.1.157:19200';
|
||||
|
||||
// 创建 axios 实例
|
||||
const esClient = axios.create({
|
||||
baseURL: ES_BASE_URL,
|
||||
timeout: 10000,
|
||||
headers: {
|
||||
'Content-Type': 'application/json',
|
||||
},
|
||||
});
|
||||
|
||||
// 索引名称
|
||||
const INDICES = {
|
||||
POSTS: 'forum_posts',
|
||||
COMMENTS: 'forum_comments',
|
||||
EVENTS: 'forum_events',
|
||||
};
|
||||
|
||||
async function initializeIndices() {
|
||||
try {
|
||||
console.log('开始初始化 Elasticsearch 索引...\n');
|
||||
|
||||
// 1. 创建帖子索引
|
||||
console.log('创建帖子索引 (forum_posts)...');
|
||||
try {
|
||||
await esClient.put(`/${INDICES.POSTS}`, {
|
||||
mappings: {
|
||||
properties: {
|
||||
id: { type: 'keyword' },
|
||||
author_id: { type: 'keyword' },
|
||||
author_name: { type: 'text' },
|
||||
author_avatar: { type: 'keyword' },
|
||||
title: { type: 'text' },
|
||||
content: { type: 'text' },
|
||||
images: { type: 'keyword' },
|
||||
tags: { type: 'keyword' },
|
||||
category: { type: 'keyword' },
|
||||
likes_count: { type: 'integer' },
|
||||
comments_count: { type: 'integer' },
|
||||
views_count: { type: 'integer' },
|
||||
created_at: { type: 'date' },
|
||||
updated_at: { type: 'date' },
|
||||
is_pinned: { type: 'boolean' },
|
||||
status: { type: 'keyword' },
|
||||
},
|
||||
},
|
||||
});
|
||||
console.log('✅ 帖子索引创建成功\n');
|
||||
} catch (error) {
|
||||
if (error.response?.status === 400 && error.response?.data?.error?.type === 'resource_already_exists_exception') {
|
||||
console.log('⚠️ 帖子索引已存在，跳过创建\n');
|
||||
} else {
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
// 2. 创建评论索引
|
||||
console.log('创建评论索引 (forum_comments)...');
|
||||
try {
|
||||
await esClient.put(`/${INDICES.COMMENTS}`, {
|
||||
mappings: {
|
||||
properties: {
|
||||
id: { type: 'keyword' },
|
||||
post_id: { type: 'keyword' },
|
||||
author_id: { type: 'keyword' },
|
||||
author_name: { type: 'text' },
|
||||
author_avatar: { type: 'keyword' },
|
||||
content: { type: 'text' },
|
||||
parent_id: { type: 'keyword' },
|
||||
likes_count: { type: 'integer' },
|
||||
created_at: { type: 'date' },
|
||||
status: { type: 'keyword' },
|
||||
},
|
||||
},
|
||||
});
|
||||
console.log('✅ 评论索引创建成功\n');
|
||||
} catch (error) {
|
||||
if (error.response?.status === 400 && error.response?.data?.error?.type === 'resource_already_exists_exception') {
|
||||
console.log('⚠️ 评论索引已存在，跳过创建\n');
|
||||
} else {
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
// 3. 创建事件时间轴索引
|
||||
console.log('创建事件时间轴索引 (forum_events)...');
|
||||
try {
|
||||
await esClient.put(`/${INDICES.EVENTS}`, {
|
||||
mappings: {
|
||||
properties: {
|
||||
id: { type: 'keyword' },
|
||||
post_id: { type: 'keyword' },
|
||||
event_type: { type: 'keyword' },
|
||||
title: { type: 'text' },
|
||||
description: { type: 'text' },
|
||||
source: { type: 'keyword' },
|
||||
source_url: { type: 'keyword' },
|
||||
related_stocks: { type: 'keyword' },
|
||||
occurred_at: { type: 'date' },
|
||||
created_at: { type: 'date' },
|
||||
importance: { type: 'keyword' },
|
||||
},
|
||||
},
|
||||
});
|
||||
console.log('✅ 事件时间轴索引创建成功\n');
|
||||
} catch (error) {
|
||||
if (error.response?.status === 400 && error.response?.data?.error?.type === 'resource_already_exists_exception') {
|
||||
console.log('⚠️ 事件时间轴索引已存在，跳过创建\n');
|
||||
} else {
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
// 4. 验证索引
|
||||
console.log('验证索引...');
|
||||
const indices = await esClient.get('/_cat/indices/forum_*?v&format=json');
|
||||
console.log('已创建的论坛索引：');
|
||||
indices.data.forEach(index => {
|
||||
console.log(` - ${index.index} (docs: ${index['docs.count']}, size: ${index['store.size']})`);
|
||||
});
|
||||
|
||||
console.log('\n🎉 所有索引初始化完成！');
|
||||
console.log('\n下一步：');
|
||||
console.log('1. 访问 https://valuefrontier.cn/value-forum');
|
||||
console.log('2. 点击"发布帖子"按钮创建第一篇帖子');
|
||||
|
||||
} catch (error) {
|
||||
console.error('❌ 初始化失败:', error.message);
|
||||
if (error.response) {
|
||||
console.error('响应数据:', JSON.stringify(error.response.data, null, 2));
|
||||
}
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// 执行初始化
|
||||
initializeIndices();
|
||||
8
jsconfig.json
Executable file
8
jsconfig.json
Executable file
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"baseUrl": "src",
|
||||
"paths": {
|
||||
"*": ["src/*"]
|
||||
}
|
||||
}
|
||||
}
|
||||
108
mcp_config.py
108
mcp_config.py
@@ -1,108 +0,0 @@
|
||||
"""
|
||||
MCP服务器配置文件
|
||||
集中管理所有配置项
|
||||
"""
|
||||
|
||||
from typing import Dict
|
||||
from pydantic import BaseSettings
|
||||
|
||||
class Settings(BaseSettings):
|
||||
"""应用配置"""
|
||||
|
||||
# 服务器配置
|
||||
SERVER_HOST: str = "0.0.0.0"
|
||||
SERVER_PORT: int = 8900
|
||||
DEBUG: bool = True
|
||||
|
||||
# 后端API服务端点
|
||||
NEWS_API_URL: str = "http://222.128.1.157:21891"
|
||||
ROADSHOW_API_URL: str = "http://222.128.1.157:19800"
|
||||
CONCEPT_API_URL: str = "http://222.128.1.157:16801"
|
||||
STOCK_ANALYSIS_API_URL: str = "http://222.128.1.157:8811"
|
||||
|
||||
# HTTP客户端配置
|
||||
HTTP_TIMEOUT: float = 60.0
|
||||
HTTP_MAX_RETRIES: int = 3
|
||||
|
||||
# 日志配置
|
||||
LOG_LEVEL: str = "INFO"
|
||||
LOG_FORMAT: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
|
||||
|
||||
# CORS配置
|
||||
CORS_ORIGINS: list = ["*"]
|
||||
CORS_CREDENTIALS: bool = True
|
||||
CORS_METHODS: list = ["*"]
|
||||
CORS_HEADERS: list = ["*"]
|
||||
|
||||
# LLM配置（如果需要集成）
|
||||
LLM_PROVIDER: str = "openai" # openai, anthropic, etc.
|
||||
LLM_API_KEY: str = ""
|
||||
LLM_MODEL: str = "gpt-4"
|
||||
LLM_BASE_URL: str = ""
|
||||
|
||||
# 速率限制
|
||||
RATE_LIMIT_ENABLED: bool = False
|
||||
RATE_LIMIT_PER_MINUTE: int = 60
|
||||
|
||||
# 缓存配置
|
||||
CACHE_ENABLED: bool = True
|
||||
CACHE_TTL: int = 300 # 秒
|
||||
|
||||
class Config:
|
||||
env_file = ".env"
|
||||
case_sensitive = True
|
||||
|
||||
|
||||
# 全局设置实例
|
||||
settings = Settings()
|
||||
|
||||
|
||||
# 工具类别映射（用于组织和展示）
|
||||
TOOL_CATEGORIES: Dict[str, list] = {
|
||||
"新闻搜索": [
|
||||
"search_news",
|
||||
"search_china_news",
|
||||
"search_medical_news"
|
||||
],
|
||||
"公司研究": [
|
||||
"search_roadshows",
|
||||
"search_research_reports"
|
||||
],
|
||||
"概念板块": [
|
||||
"search_concepts",
|
||||
"get_concept_details",
|
||||
"get_stock_concepts",
|
||||
"get_concept_statistics"
|
||||
],
|
||||
"股票分析": [
|
||||
"search_limit_up_stocks",
|
||||
"get_daily_stock_analysis"
|
||||
]
|
||||
}
|
||||
|
||||
|
||||
# 工具优先级（用于LLM选择工具时的提示）
|
||||
TOOL_PRIORITIES: Dict[str, int] = {
|
||||
"search_china_news": 10, # 最常用
|
||||
"search_concepts": 9,
|
||||
"search_limit_up_stocks": 8,
|
||||
"search_research_reports": 8,
|
||||
"get_stock_concepts": 7,
|
||||
"search_news": 6,
|
||||
"get_daily_stock_analysis": 5,
|
||||
"get_concept_statistics": 5,
|
||||
"search_medical_news": 4,
|
||||
"search_roadshows": 4,
|
||||
"get_concept_details": 3,
|
||||
}
|
||||
|
||||
|
||||
# 默认参数配置
|
||||
DEFAULT_PARAMS = {
|
||||
"top_k": 20,
|
||||
"page_size": 20,
|
||||
"size": 10,
|
||||
"sort_by": "change_pct",
|
||||
"mode": "hybrid",
|
||||
"exact_match": False,
|
||||
}
|
||||
783
mcp_database.py
783
mcp_database.py
@@ -1,783 +0,0 @@
|
||||
"""
|
||||
MySQL数据库查询模块
|
||||
提供股票财务数据查询功能
|
||||
"""
|
||||
|
||||
import aiomysql
|
||||
import logging
|
||||
from typing import Dict, List, Any, Optional
|
||||
from datetime import datetime, date
|
||||
from decimal import Decimal
|
||||
import json
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
# MySQL连接配置
|
||||
MYSQL_CONFIG = {
|
||||
'host': '222.128.1.157',
|
||||
'port': 33060,
|
||||
'user': 'root',
|
||||
'password': 'Zzl5588161!',
|
||||
'db': 'stock',
|
||||
'charset': 'utf8mb4',
|
||||
'autocommit': True
|
||||
}
|
||||
|
||||
# 全局连接池
|
||||
_pool = None
|
||||
|
||||
|
||||
class DateTimeEncoder(json.JSONEncoder):
|
||||
"""JSON编码器，处理datetime和Decimal类型"""
|
||||
def default(self, obj):
|
||||
if isinstance(obj, (datetime, date)):
|
||||
return obj.isoformat()
|
||||
if isinstance(obj, Decimal):
|
||||
return float(obj)
|
||||
return super().default(obj)
|
||||
|
||||
|
||||
async def get_pool():
|
||||
"""获取MySQL连接池"""
|
||||
global _pool
|
||||
if _pool is None:
|
||||
_pool = await aiomysql.create_pool(
|
||||
host=MYSQL_CONFIG['host'],
|
||||
port=MYSQL_CONFIG['port'],
|
||||
user=MYSQL_CONFIG['user'],
|
||||
password=MYSQL_CONFIG['password'],
|
||||
db=MYSQL_CONFIG['db'],
|
||||
charset=MYSQL_CONFIG['charset'],
|
||||
autocommit=MYSQL_CONFIG['autocommit'],
|
||||
minsize=1,
|
||||
maxsize=10
|
||||
)
|
||||
logger.info("MySQL connection pool created")
|
||||
return _pool
|
||||
|
||||
|
||||
async def close_pool():
|
||||
"""关闭MySQL连接池"""
|
||||
global _pool
|
||||
if _pool:
|
||||
_pool.close()
|
||||
await _pool.wait_closed()
|
||||
_pool = None
|
||||
logger.info("MySQL connection pool closed")
|
||||
|
||||
|
||||
def convert_row(row: Dict) -> Dict:
|
||||
"""转换数据库行，处理特殊类型"""
|
||||
if not row:
|
||||
return {}
|
||||
|
||||
result = {}
|
||||
for key, value in row.items():
|
||||
if isinstance(value, Decimal):
|
||||
result[key] = float(value)
|
||||
elif isinstance(value, (datetime, date)):
|
||||
result[key] = value.isoformat()
|
||||
else:
|
||||
result[key] = value
|
||||
return result
|
||||
|
||||
|
||||
async def get_stock_basic_info(seccode: str) -> Optional[Dict[str, Any]]:
|
||||
"""
|
||||
获取股票基本信息
|
||||
|
||||
Args:
|
||||
seccode: 股票代码
|
||||
|
||||
Returns:
|
||||
股票基本信息字典
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
SELECT
|
||||
SECCODE, SECNAME, ORGNAME,
|
||||
F001V as english_name,
|
||||
F003V as legal_representative,
|
||||
F004V as registered_address,
|
||||
F005V as office_address,
|
||||
F010D as establishment_date,
|
||||
F011V as website,
|
||||
F012V as email,
|
||||
F013V as phone,
|
||||
F015V as main_business,
|
||||
F016V as business_scope,
|
||||
F017V as company_profile,
|
||||
F030V as industry_level1,
|
||||
F032V as industry_level2,
|
||||
F034V as sw_industry_level1,
|
||||
F036V as sw_industry_level2,
|
||||
F026V as province,
|
||||
F028V as city,
|
||||
F041V as chairman,
|
||||
F042V as general_manager,
|
||||
UPDATE_DATE as update_date
|
||||
FROM ea_baseinfo
|
||||
WHERE SECCODE = %s
|
||||
LIMIT 1
|
||||
"""
|
||||
|
||||
await cursor.execute(query, (seccode,))
|
||||
result = await cursor.fetchone()
|
||||
|
||||
if result:
|
||||
return convert_row(result)
|
||||
return None
|
||||
|
||||
|
||||
async def get_stock_financial_index(
|
||||
seccode: str,
|
||||
start_date: Optional[str] = None,
|
||||
end_date: Optional[str] = None,
|
||||
limit: int = 10
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取股票财务指标
|
||||
|
||||
Args:
|
||||
seccode: 股票代码
|
||||
start_date: 开始日期 YYYY-MM-DD
|
||||
end_date: 结束日期 YYYY-MM-DD
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
财务指标列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
# 构建查询
|
||||
query = """
|
||||
SELECT
|
||||
SECCODE, SECNAME, ENDDATE, STARTDATE,
|
||||
F069D as report_year,
|
||||
F003N as eps, -- 每股收益
|
||||
F004N as basic_eps,
|
||||
F008N as bps, -- 每股净资产
|
||||
F014N as roe, -- 净资产收益率
|
||||
F016N as roa, -- 总资产报酬率
|
||||
F017N as net_profit_margin, -- 净利润率
|
||||
F022N as receivable_turnover, -- 应收账款周转率
|
||||
F023N as inventory_turnover, -- 存货周转率
|
||||
F025N as total_asset_turnover, -- 总资产周转率
|
||||
F041N as debt_ratio, -- 资产负债率
|
||||
F042N as current_ratio, -- 流动比率
|
||||
F043N as quick_ratio, -- 速动比率
|
||||
F052N as revenue_growth, -- 营业收入增长率
|
||||
F053N as profit_growth, -- 净利润增长率
|
||||
F089N as revenue, -- 营业收入
|
||||
F090N as operating_cost, -- 营业成本
|
||||
F101N as net_profit, -- 净利润
|
||||
F102N as net_profit_parent -- 归母净利润
|
||||
FROM ea_financialindex
|
||||
WHERE SECCODE = %s
|
||||
"""
|
||||
|
||||
params = [seccode]
|
||||
|
||||
if start_date:
|
||||
query += " AND ENDDATE >= %s"
|
||||
params.append(start_date)
|
||||
|
||||
if end_date:
|
||||
query += " AND ENDDATE <= %s"
|
||||
params.append(end_date)
|
||||
|
||||
query += " ORDER BY ENDDATE DESC LIMIT %s"
|
||||
params.append(limit)
|
||||
|
||||
await cursor.execute(query, params)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def get_stock_trade_data(
|
||||
seccode: str,
|
||||
start_date: Optional[str] = None,
|
||||
end_date: Optional[str] = None,
|
||||
limit: int = 30
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取股票交易数据
|
||||
|
||||
Args:
|
||||
seccode: 股票代码
|
||||
start_date: 开始日期 YYYY-MM-DD
|
||||
end_date: 结束日期 YYYY-MM-DD
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
交易数据列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
SELECT
|
||||
SECCODE, SECNAME, TRADEDATE,
|
||||
F002N as prev_close, -- 昨日收盘价
|
||||
F003N as open_price, -- 开盘价
|
||||
F005N as high_price, -- 最高价
|
||||
F006N as low_price, -- 最低价
|
||||
F007N as close_price, -- 收盘价
|
||||
F004N as volume, -- 成交量
|
||||
F011N as turnover, -- 成交金额
|
||||
F009N as change_amount, -- 涨跌额
|
||||
F010N as change_pct, -- 涨跌幅
|
||||
F012N as turnover_rate, -- 换手率
|
||||
F013N as amplitude, -- 振幅
|
||||
F026N as pe_ratio, -- 市盈率
|
||||
F020N as total_shares, -- 总股本
|
||||
F021N as circulating_shares -- 流通股本
|
||||
FROM ea_trade
|
||||
WHERE SECCODE = %s
|
||||
"""
|
||||
|
||||
params = [seccode]
|
||||
|
||||
if start_date:
|
||||
query += " AND TRADEDATE >= %s"
|
||||
params.append(start_date)
|
||||
|
||||
if end_date:
|
||||
query += " AND TRADEDATE <= %s"
|
||||
params.append(end_date)
|
||||
|
||||
query += " ORDER BY TRADEDATE DESC LIMIT %s"
|
||||
params.append(limit)
|
||||
|
||||
await cursor.execute(query, params)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def get_stock_balance_sheet(
|
||||
seccode: str,
|
||||
start_date: Optional[str] = None,
|
||||
end_date: Optional[str] = None,
|
||||
limit: int = 8
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取资产负债表数据
|
||||
|
||||
Args:
|
||||
seccode: 股票代码
|
||||
start_date: 开始日期
|
||||
end_date: 结束日期
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
资产负债表数据列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
SELECT
|
||||
SECCODE, SECNAME, ENDDATE,
|
||||
F001D as report_year,
|
||||
F006N as cash, -- 货币资金
|
||||
F009N as receivables, -- 应收账款
|
||||
F015N as inventory, -- 存货
|
||||
F019N as current_assets, -- 流动资产合计
|
||||
F023N as long_term_investment, -- 长期股权投资
|
||||
F025N as fixed_assets, -- 固定资产
|
||||
F037N as noncurrent_assets, -- 非流动资产合计
|
||||
F038N as total_assets, -- 资产总计
|
||||
F039N as short_term_loan, -- 短期借款
|
||||
F042N as payables, -- 应付账款
|
||||
F052N as current_liabilities, -- 流动负债合计
|
||||
F053N as long_term_loan, -- 长期借款
|
||||
F060N as noncurrent_liabilities, -- 非流动负债合计
|
||||
F061N as total_liabilities, -- 负债合计
|
||||
F062N as share_capital, -- 股本
|
||||
F063N as capital_reserve, -- 资本公积
|
||||
F065N as retained_earnings, -- 未分配利润
|
||||
F070N as total_equity -- 所有者权益合计
|
||||
FROM ea_asset
|
||||
WHERE SECCODE = %s
|
||||
"""
|
||||
|
||||
params = [seccode]
|
||||
|
||||
if start_date:
|
||||
query += " AND ENDDATE >= %s"
|
||||
params.append(start_date)
|
||||
|
||||
if end_date:
|
||||
query += " AND ENDDATE <= %s"
|
||||
params.append(end_date)
|
||||
|
||||
query += " ORDER BY ENDDATE DESC LIMIT %s"
|
||||
params.append(limit)
|
||||
|
||||
await cursor.execute(query, params)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def get_stock_cashflow(
|
||||
seccode: str,
|
||||
start_date: Optional[str] = None,
|
||||
end_date: Optional[str] = None,
|
||||
limit: int = 8
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取现金流量表数据
|
||||
|
||||
Args:
|
||||
seccode: 股票代码
|
||||
start_date: 开始日期
|
||||
end_date: 结束日期
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
现金流量表数据列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
SELECT
|
||||
SECCODE, SECNAME, ENDDATE, STARTDATE,
|
||||
F001D as report_year,
|
||||
F009N as operating_cash_inflow, -- 经营活动现金流入
|
||||
F014N as operating_cash_outflow, -- 经营活动现金流出
|
||||
F015N as net_operating_cashflow, -- 经营活动现金流量净额
|
||||
F021N as investing_cash_inflow, -- 投资活动现金流入
|
||||
F026N as investing_cash_outflow, -- 投资活动现金流出
|
||||
F027N as net_investing_cashflow, -- 投资活动现金流量净额
|
||||
F031N as financing_cash_inflow, -- 筹资活动现金流入
|
||||
F035N as financing_cash_outflow, -- 筹资活动现金流出
|
||||
F036N as net_financing_cashflow, -- 筹资活动现金流量净额
|
||||
F039N as net_cash_increase, -- 现金及现金等价物净增加额
|
||||
F044N as net_profit, -- 净利润
|
||||
F046N as depreciation, -- 固定资产折旧
|
||||
F060N as net_operating_cashflow_adjusted -- 经营活动现金流量净额(补充)
|
||||
FROM ea_cashflow
|
||||
WHERE SECCODE = %s
|
||||
"""
|
||||
|
||||
params = [seccode]
|
||||
|
||||
if start_date:
|
||||
query += " AND ENDDATE >= %s"
|
||||
params.append(start_date)
|
||||
|
||||
if end_date:
|
||||
query += " AND ENDDATE <= %s"
|
||||
params.append(end_date)
|
||||
|
||||
query += " ORDER BY ENDDATE DESC LIMIT %s"
|
||||
params.append(limit)
|
||||
|
||||
await cursor.execute(query, params)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def search_stocks_by_criteria(
|
||||
industry: Optional[str] = None,
|
||||
province: Optional[str] = None,
|
||||
min_market_cap: Optional[float] = None,
|
||||
max_market_cap: Optional[float] = None,
|
||||
limit: int = 50
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
按条件搜索股票
|
||||
|
||||
Args:
|
||||
industry: 行业名称
|
||||
province: 省份
|
||||
min_market_cap: 最小市值（亿元）
|
||||
max_market_cap: 最大市值（亿元）
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
股票列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
SELECT DISTINCT
|
||||
b.SECCODE,
|
||||
b.SECNAME,
|
||||
b.F030V as industry_level1,
|
||||
b.F032V as industry_level2,
|
||||
b.F034V as sw_industry_level1,
|
||||
b.F026V as province,
|
||||
b.F028V as city,
|
||||
b.F015V as main_business,
|
||||
t.F007N as latest_price,
|
||||
t.F010N as change_pct,
|
||||
t.F026N as pe_ratio,
|
||||
t.TRADEDATE as latest_trade_date
|
||||
FROM ea_baseinfo b
|
||||
LEFT JOIN (
|
||||
SELECT SECCODE, MAX(TRADEDATE) as max_date
|
||||
FROM ea_trade
|
||||
GROUP BY SECCODE
|
||||
) latest ON b.SECCODE = latest.SECCODE
|
||||
LEFT JOIN ea_trade t ON b.SECCODE = t.SECCODE
|
||||
AND t.TRADEDATE = latest.max_date
|
||||
WHERE 1=1
|
||||
"""
|
||||
|
||||
params = []
|
||||
|
||||
if industry:
|
||||
query += " AND (b.F030V LIKE %s OR b.F032V LIKE %s OR b.F034V LIKE %s)"
|
||||
pattern = f"%{industry}%"
|
||||
params.extend([pattern, pattern, pattern])
|
||||
|
||||
if province:
|
||||
query += " AND b.F026V = %s"
|
||||
params.append(province)
|
||||
|
||||
if min_market_cap or max_market_cap:
|
||||
# 市值 = 最新价 * 总股本 / 100000000（转换为亿元）
|
||||
if min_market_cap:
|
||||
query += " AND (t.F007N * t.F020N / 100000000) >= %s"
|
||||
params.append(min_market_cap)
|
||||
|
||||
if max_market_cap:
|
||||
query += " AND (t.F007N * t.F020N / 100000000) <= %s"
|
||||
params.append(max_market_cap)
|
||||
|
||||
query += " ORDER BY t.TRADEDATE DESC LIMIT %s"
|
||||
params.append(limit)
|
||||
|
||||
await cursor.execute(query, params)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def get_stock_comparison(
|
||||
seccodes: List[str],
|
||||
metric: str = "financial"
|
||||
) -> Dict[str, Any]:
|
||||
"""
|
||||
股票对比分析
|
||||
|
||||
Args:
|
||||
seccodes: 股票代码列表
|
||||
metric: 对比指标类型 (financial/trade)
|
||||
|
||||
Returns:
|
||||
对比数据
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
if not seccodes or len(seccodes) < 2:
|
||||
return {"error": "至少需要2个股票代码进行对比"}
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
placeholders = ','.join(['%s'] * len(seccodes))
|
||||
|
||||
if metric == "financial":
|
||||
# 对比最新财务指标
|
||||
query = f"""
|
||||
SELECT
|
||||
f.SECCODE, f.SECNAME, f.ENDDATE,
|
||||
f.F003N as eps,
|
||||
f.F008N as bps,
|
||||
f.F014N as roe,
|
||||
f.F017N as net_profit_margin,
|
||||
f.F041N as debt_ratio,
|
||||
f.F052N as revenue_growth,
|
||||
f.F053N as profit_growth,
|
||||
f.F089N as revenue,
|
||||
f.F101N as net_profit
|
||||
FROM ea_financialindex f
|
||||
INNER JOIN (
|
||||
SELECT SECCODE, MAX(ENDDATE) as max_date
|
||||
FROM ea_financialindex
|
||||
WHERE SECCODE IN ({placeholders})
|
||||
GROUP BY SECCODE
|
||||
) latest ON f.SECCODE = latest.SECCODE
|
||||
AND f.ENDDATE = latest.max_date
|
||||
"""
|
||||
else: # trade
|
||||
# 对比最新交易数据
|
||||
query = f"""
|
||||
SELECT
|
||||
t.SECCODE, t.SECNAME, t.TRADEDATE,
|
||||
t.F007N as close_price,
|
||||
t.F010N as change_pct,
|
||||
t.F012N as turnover_rate,
|
||||
t.F026N as pe_ratio,
|
||||
t.F020N as total_shares,
|
||||
t.F021N as circulating_shares
|
||||
FROM ea_trade t
|
||||
INNER JOIN (
|
||||
SELECT SECCODE, MAX(TRADEDATE) as max_date
|
||||
FROM ea_trade
|
||||
WHERE SECCODE IN ({placeholders})
|
||||
GROUP BY SECCODE
|
||||
) latest ON t.SECCODE = latest.SECCODE
|
||||
AND t.TRADEDATE = latest.max_date
|
||||
"""
|
||||
|
||||
await cursor.execute(query, seccodes)
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return {
|
||||
"comparison_type": metric,
|
||||
"stocks": [convert_row(row) for row in results]
|
||||
}
|
||||
|
||||
|
||||
async def get_user_favorite_stocks(user_id: str, limit: int = 100) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取用户自选股列表
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
自选股列表（包含最新行情数据）
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
# 查询用户自选股（假设有 user_favorites 表）
|
||||
# 如果没有此表，可以根据实际情况调整
|
||||
query = """
|
||||
SELECT
|
||||
f.user_id,
|
||||
f.stock_code,
|
||||
b.SECNAME as stock_name,
|
||||
b.F030V as industry,
|
||||
t.F007N as current_price,
|
||||
t.F010N as change_pct,
|
||||
t.F012N as turnover_rate,
|
||||
t.F026N as pe_ratio,
|
||||
t.TRADEDATE as latest_trade_date,
|
||||
f.created_at as favorite_time
|
||||
FROM user_favorites f
|
||||
INNER JOIN ea_baseinfo b ON f.stock_code = b.SECCODE
|
||||
LEFT JOIN (
|
||||
SELECT SECCODE, MAX(TRADEDATE) as max_date
|
||||
FROM ea_trade
|
||||
GROUP BY SECCODE
|
||||
) latest ON b.SECCODE = latest.SECCODE
|
||||
LEFT JOIN ea_trade t ON b.SECCODE = t.SECCODE
|
||||
AND t.TRADEDATE = latest.max_date
|
||||
WHERE f.user_id = %s AND f.is_deleted = 0
|
||||
ORDER BY f.created_at DESC
|
||||
LIMIT %s
|
||||
"""
|
||||
|
||||
await cursor.execute(query, [user_id, limit])
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def get_user_favorite_events(user_id: str, limit: int = 100) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取用户自选事件列表
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
limit: 返回条数
|
||||
|
||||
Returns:
|
||||
自选事件列表
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
# 查询用户自选事件（假设有 user_event_favorites 表）
|
||||
query = """
|
||||
SELECT
|
||||
f.user_id,
|
||||
f.event_id,
|
||||
e.title,
|
||||
e.description,
|
||||
e.event_date,
|
||||
e.importance,
|
||||
e.related_stocks,
|
||||
e.category,
|
||||
f.created_at as favorite_time
|
||||
FROM user_event_favorites f
|
||||
INNER JOIN events e ON f.event_id = e.id
|
||||
WHERE f.user_id = %s AND f.is_deleted = 0
|
||||
ORDER BY e.event_date DESC
|
||||
LIMIT %s
|
||||
"""
|
||||
|
||||
await cursor.execute(query, [user_id, limit])
|
||||
results = await cursor.fetchall()
|
||||
|
||||
return [convert_row(row) for row in results]
|
||||
|
||||
|
||||
async def add_favorite_stock(user_id: str, stock_code: str) -> Dict[str, Any]:
|
||||
"""
|
||||
添加自选股
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
stock_code: 股票代码
|
||||
|
||||
Returns:
|
||||
操作结果
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
# 检查是否已存在
|
||||
check_query = """
|
||||
SELECT id, is_deleted
|
||||
FROM user_favorites
|
||||
WHERE user_id = %s AND stock_code = %s
|
||||
"""
|
||||
await cursor.execute(check_query, [user_id, stock_code])
|
||||
existing = await cursor.fetchone()
|
||||
|
||||
if existing:
|
||||
if existing['is_deleted'] == 1:
|
||||
# 恢复已删除的记录
|
||||
update_query = """
|
||||
UPDATE user_favorites
|
||||
SET is_deleted = 0, updated_at = NOW()
|
||||
WHERE id = %s
|
||||
"""
|
||||
await cursor.execute(update_query, [existing['id']])
|
||||
return {"success": True, "message": "已恢复自选股"}
|
||||
else:
|
||||
return {"success": False, "message": "该股票已在自选中"}
|
||||
|
||||
# 插入新记录
|
||||
insert_query = """
|
||||
INSERT INTO user_favorites (user_id, stock_code, created_at, updated_at, is_deleted)
|
||||
VALUES (%s, %s, NOW(), NOW(), 0)
|
||||
"""
|
||||
await cursor.execute(insert_query, [user_id, stock_code])
|
||||
return {"success": True, "message": "添加自选股成功"}
|
||||
|
||||
|
||||
async def remove_favorite_stock(user_id: str, stock_code: str) -> Dict[str, Any]:
|
||||
"""
|
||||
删除自选股
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
stock_code: 股票代码
|
||||
|
||||
Returns:
|
||||
操作结果
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
UPDATE user_favorites
|
||||
SET is_deleted = 1, updated_at = NOW()
|
||||
WHERE user_id = %s AND stock_code = %s AND is_deleted = 0
|
||||
"""
|
||||
result = await cursor.execute(query, [user_id, stock_code])
|
||||
|
||||
if result > 0:
|
||||
return {"success": True, "message": "删除自选股成功"}
|
||||
else:
|
||||
return {"success": False, "message": "未找到该自选股"}
|
||||
|
||||
|
||||
async def add_favorite_event(user_id: str, event_id: int) -> Dict[str, Any]:
|
||||
"""
|
||||
添加自选事件
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
event_id: 事件ID
|
||||
|
||||
Returns:
|
||||
操作结果
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
# 检查是否已存在
|
||||
check_query = """
|
||||
SELECT id, is_deleted
|
||||
FROM user_event_favorites
|
||||
WHERE user_id = %s AND event_id = %s
|
||||
"""
|
||||
await cursor.execute(check_query, [user_id, event_id])
|
||||
existing = await cursor.fetchone()
|
||||
|
||||
if existing:
|
||||
if existing['is_deleted'] == 1:
|
||||
# 恢复已删除的记录
|
||||
update_query = """
|
||||
UPDATE user_event_favorites
|
||||
SET is_deleted = 0, updated_at = NOW()
|
||||
WHERE id = %s
|
||||
"""
|
||||
await cursor.execute(update_query, [existing['id']])
|
||||
return {"success": True, "message": "已恢复自选事件"}
|
||||
else:
|
||||
return {"success": False, "message": "该事件已在自选中"}
|
||||
|
||||
# 插入新记录
|
||||
insert_query = """
|
||||
INSERT INTO user_event_favorites (user_id, event_id, created_at, updated_at, is_deleted)
|
||||
VALUES (%s, %s, NOW(), NOW(), 0)
|
||||
"""
|
||||
await cursor.execute(insert_query, [user_id, event_id])
|
||||
return {"success": True, "message": "添加自选事件成功"}
|
||||
|
||||
|
||||
async def remove_favorite_event(user_id: str, event_id: int) -> Dict[str, Any]:
|
||||
"""
|
||||
删除自选事件
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
event_id: 事件ID
|
||||
|
||||
Returns:
|
||||
操作结果
|
||||
"""
|
||||
pool = await get_pool()
|
||||
|
||||
async with pool.acquire() as conn:
|
||||
async with conn.cursor(aiomysql.DictCursor) as cursor:
|
||||
query = """
|
||||
UPDATE user_event_favorites
|
||||
SET is_deleted = 1, updated_at = NOW()
|
||||
WHERE user_id = %s AND event_id = %s AND is_deleted = 0
|
||||
"""
|
||||
result = await cursor.execute(query, [user_id, event_id])
|
||||
|
||||
if result > 0:
|
||||
return {"success": True, "message": "删除自选事件成功"}
|
||||
else:
|
||||
return {"success": False, "message": "未找到该自选事件"}
|
||||
@@ -1,320 +0,0 @@
|
||||
"""
|
||||
Elasticsearch 连接和工具模块
|
||||
用于聊天记录存储和向量搜索
|
||||
"""
|
||||
|
||||
from elasticsearch import Elasticsearch, helpers
|
||||
from datetime import datetime
|
||||
from typing import List, Dict, Any, Optional
|
||||
import logging
|
||||
import json
|
||||
import openai
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
# ==================== 配置 ====================
|
||||
|
||||
# ES 配置
|
||||
ES_CONFIG = {
|
||||
"host": "http://222.128.1.157:19200",
|
||||
"index_chat_history": "agent_chat_history", # 聊天记录索引
|
||||
}
|
||||
|
||||
# Embedding 配置
|
||||
EMBEDDING_CONFIG = {
|
||||
"api_key": "dummy",
|
||||
"base_url": "http://222.128.1.157:18008/v1",
|
||||
"model": "qwen3-embedding-8b",
|
||||
"dims": 4096, # 向量维度
|
||||
}
|
||||
|
||||
# ==================== ES 客户端 ====================
|
||||
|
||||
class ESClient:
|
||||
"""Elasticsearch 客户端封装"""
|
||||
|
||||
def __init__(self):
|
||||
self.es = Elasticsearch([ES_CONFIG["host"]], request_timeout=60)
|
||||
self.chat_index = ES_CONFIG["index_chat_history"]
|
||||
|
||||
# 初始化 OpenAI 客户端用于 embedding
|
||||
self.embedding_client = openai.OpenAI(
|
||||
api_key=EMBEDDING_CONFIG["api_key"],
|
||||
base_url=EMBEDDING_CONFIG["base_url"],
|
||||
)
|
||||
self.embedding_model = EMBEDDING_CONFIG["model"]
|
||||
|
||||
# 初始化索引
|
||||
self.create_chat_history_index()
|
||||
|
||||
def create_chat_history_index(self):
|
||||
"""创建聊天记录索引"""
|
||||
if self.es.indices.exists(index=self.chat_index):
|
||||
logger.info(f"索引 {self.chat_index} 已存在")
|
||||
return
|
||||
|
||||
mappings = {
|
||||
"properties": {
|
||||
"session_id": {"type": "keyword"}, # 会话ID
|
||||
"user_id": {"type": "keyword"}, # 用户ID
|
||||
"user_nickname": {"type": "text"}, # 用户昵称
|
||||
"user_avatar": {"type": "keyword"}, # 用户头像URL
|
||||
"message_type": {"type": "keyword"}, # user / assistant
|
||||
"message": {"type": "text"}, # 消息内容
|
||||
"message_embedding": { # 消息向量
|
||||
"type": "dense_vector",
|
||||
"dims": EMBEDDING_CONFIG["dims"],
|
||||
"index": True,
|
||||
"similarity": "cosine"
|
||||
},
|
||||
"plan": {"type": "text"}, # 执行计划（仅 assistant）
|
||||
"steps": {"type": "text"}, # 执行步骤（仅 assistant）
|
||||
"timestamp": {"type": "date"}, # 时间戳
|
||||
"created_at": {"type": "date"}, # 创建时间
|
||||
}
|
||||
}
|
||||
|
||||
self.es.indices.create(index=self.chat_index, body={"mappings": mappings})
|
||||
logger.info(f"创建索引: {self.chat_index}")
|
||||
|
||||
def generate_embedding(self, text: str) -> List[float]:
|
||||
"""生成文本向量"""
|
||||
try:
|
||||
if not text or len(text.strip()) == 0:
|
||||
return []
|
||||
|
||||
# 截断过长文本
|
||||
text = text[:16000] if len(text) > 16000 else text
|
||||
|
||||
response = self.embedding_client.embeddings.create(
|
||||
model=self.embedding_model,
|
||||
input=[text]
|
||||
)
|
||||
return response.data[0].embedding
|
||||
except Exception as e:
|
||||
logger.error(f"Embedding 生成失败: {e}")
|
||||
return []
|
||||
|
||||
def save_chat_message(
|
||||
self,
|
||||
session_id: str,
|
||||
user_id: str,
|
||||
user_nickname: str,
|
||||
user_avatar: str,
|
||||
message_type: str, # "user" or "assistant"
|
||||
message: str,
|
||||
plan: Optional[str] = None,
|
||||
steps: Optional[str] = None,
|
||||
) -> str:
|
||||
"""
|
||||
保存聊天消息
|
||||
|
||||
Args:
|
||||
session_id: 会话ID
|
||||
user_id: 用户ID
|
||||
user_nickname: 用户昵称
|
||||
user_avatar: 用户头像URL
|
||||
message_type: 消息类型 (user/assistant)
|
||||
message: 消息内容
|
||||
plan: 执行计划（可选）
|
||||
steps: 执行步骤（可选）
|
||||
|
||||
Returns:
|
||||
文档ID
|
||||
"""
|
||||
try:
|
||||
# 生成向量
|
||||
embedding = self.generate_embedding(message)
|
||||
|
||||
doc = {
|
||||
"session_id": session_id,
|
||||
"user_id": user_id,
|
||||
"user_nickname": user_nickname,
|
||||
"user_avatar": user_avatar,
|
||||
"message_type": message_type,
|
||||
"message": message,
|
||||
"message_embedding": embedding if embedding else None,
|
||||
"plan": plan,
|
||||
"steps": steps,
|
||||
"timestamp": datetime.now(),
|
||||
"created_at": datetime.now(),
|
||||
}
|
||||
|
||||
result = self.es.index(index=self.chat_index, body=doc)
|
||||
logger.info(f"保存聊天记录: {result['_id']}")
|
||||
return result["_id"]
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"保存聊天记录失败: {e}")
|
||||
raise
|
||||
|
||||
def get_chat_sessions(self, user_id: str, limit: int = 50) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取用户的聊天会话列表
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
limit: 返回数量
|
||||
|
||||
Returns:
|
||||
会话列表，每个会话包含：session_id, last_message, last_timestamp
|
||||
"""
|
||||
try:
|
||||
# 聚合查询：按 session_id 分组，获取每个会话的最后一条消息
|
||||
query = {
|
||||
"query": {
|
||||
"term": {"user_id": user_id}
|
||||
},
|
||||
"aggs": {
|
||||
"sessions": {
|
||||
"terms": {
|
||||
"field": "session_id",
|
||||
"size": limit,
|
||||
"order": {"last_message": "desc"}
|
||||
},
|
||||
"aggs": {
|
||||
"last_message": {
|
||||
"max": {"field": "timestamp"}
|
||||
},
|
||||
"last_message_content": {
|
||||
"top_hits": {
|
||||
"size": 1,
|
||||
"sort": [{"timestamp": {"order": "desc"}}],
|
||||
"_source": ["message", "timestamp", "message_type"]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"size": 0
|
||||
}
|
||||
|
||||
result = self.es.search(index=self.chat_index, body=query)
|
||||
|
||||
sessions = []
|
||||
for bucket in result["aggregations"]["sessions"]["buckets"]:
|
||||
session_data = bucket["last_message_content"]["hits"]["hits"][0]["_source"]
|
||||
sessions.append({
|
||||
"session_id": bucket["key"],
|
||||
"last_message": session_data["message"],
|
||||
"last_timestamp": session_data["timestamp"],
|
||||
"message_count": bucket["doc_count"],
|
||||
})
|
||||
|
||||
return sessions
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"获取会话列表失败: {e}")
|
||||
return []
|
||||
|
||||
def get_chat_history(
|
||||
self,
|
||||
session_id: str,
|
||||
limit: int = 100
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
获取指定会话的聊天历史
|
||||
|
||||
Args:
|
||||
session_id: 会话ID
|
||||
limit: 返回数量
|
||||
|
||||
Returns:
|
||||
聊天记录列表
|
||||
"""
|
||||
try:
|
||||
query = {
|
||||
"query": {
|
||||
"term": {"session_id": session_id}
|
||||
},
|
||||
"sort": [{"timestamp": {"order": "asc"}}],
|
||||
"size": limit
|
||||
}
|
||||
|
||||
result = self.es.search(index=self.chat_index, body=query)
|
||||
|
||||
messages = []
|
||||
for hit in result["hits"]["hits"]:
|
||||
doc = hit["_source"]
|
||||
messages.append({
|
||||
"message_type": doc["message_type"],
|
||||
"message": doc["message"],
|
||||
"plan": doc.get("plan"),
|
||||
"steps": doc.get("steps"),
|
||||
"timestamp": doc["timestamp"],
|
||||
})
|
||||
|
||||
return messages
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"获取聊天历史失败: {e}")
|
||||
return []
|
||||
|
||||
def search_chat_history(
|
||||
self,
|
||||
user_id: str,
|
||||
query_text: str,
|
||||
top_k: int = 10
|
||||
) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
向量搜索聊天历史
|
||||
|
||||
Args:
|
||||
user_id: 用户ID
|
||||
query_text: 查询文本
|
||||
top_k: 返回数量
|
||||
|
||||
Returns:
|
||||
相关聊天记录列表
|
||||
"""
|
||||
try:
|
||||
# 生成查询向量
|
||||
query_embedding = self.generate_embedding(query_text)
|
||||
if not query_embedding:
|
||||
return []
|
||||
|
||||
# 向量搜索
|
||||
query = {
|
||||
"query": {
|
||||
"bool": {
|
||||
"must": [
|
||||
{"term": {"user_id": user_id}},
|
||||
{
|
||||
"script_score": {
|
||||
"query": {"match_all": {}},
|
||||
"script": {
|
||||
"source": "cosineSimilarity(params.query_vector, 'message_embedding') + 1.0",
|
||||
"params": {"query_vector": query_embedding}
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"size": top_k
|
||||
}
|
||||
|
||||
result = self.es.search(index=self.chat_index, body=query)
|
||||
|
||||
messages = []
|
||||
for hit in result["hits"]["hits"]:
|
||||
doc = hit["_source"]
|
||||
messages.append({
|
||||
"session_id": doc["session_id"],
|
||||
"message_type": doc["message_type"],
|
||||
"message": doc["message"],
|
||||
"timestamp": doc["timestamp"],
|
||||
"score": hit["_score"],
|
||||
})
|
||||
|
||||
return messages
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"向量搜索失败: {e}")
|
||||
return []
|
||||
|
||||
|
||||
# ==================== 全局实例 ====================
|
||||
|
||||
# 创建全局 ES 客户端
|
||||
es_client = ESClient()
|
||||
2437
mcp_server.py
2437
mcp_server.py
File diff suppressed because it is too large
Load Diff
@@ -1,134 +0,0 @@
|
||||
-- 数据库迁移脚本：添加优惠码和订阅升级相关表
|
||||
-- 执行时间：2025-xx-xx
|
||||
-- 作者：Claude Code
|
||||
-- 说明：此脚本添加了优惠码、优惠码使用记录和订阅升级记录三张新表，并扩展了 payment_orders 表
|
||||
|
||||
-- ============================================
|
||||
-- 1. 创建优惠码表
|
||||
-- ============================================
|
||||
CREATE TABLE IF NOT EXISTS `promo_codes` (
|
||||
`id` INT PRIMARY KEY AUTO_INCREMENT,
|
||||
`code` VARCHAR(50) UNIQUE NOT NULL COMMENT '优惠码（唯一）',
|
||||
`description` VARCHAR(200) DEFAULT NULL COMMENT '优惠码描述',
|
||||
|
||||
-- 折扣类型和值
|
||||
`discount_type` VARCHAR(20) NOT NULL COMMENT '折扣类型: percentage（百分比） 或 fixed_amount（固定金额）',
|
||||
`discount_value` DECIMAL(10, 2) NOT NULL COMMENT '折扣值',
|
||||
|
||||
-- 适用范围
|
||||
`applicable_plans` VARCHAR(200) DEFAULT NULL COMMENT '适用套餐（JSON格式），如 ["pro", "max"]，null表示全部适用',
|
||||
`applicable_cycles` VARCHAR(50) DEFAULT NULL COMMENT '适用周期（JSON格式），如 ["monthly", "yearly"]，null表示全部适用',
|
||||
`min_amount` DECIMAL(10, 2) DEFAULT NULL COMMENT '最低消费金额',
|
||||
|
||||
-- 使用限制
|
||||
`max_uses` INT DEFAULT NULL COMMENT '最大使用次数，null表示无限制',
|
||||
`max_uses_per_user` INT DEFAULT 1 COMMENT '每个用户最多使用次数',
|
||||
`current_uses` INT DEFAULT 0 COMMENT '当前已使用次数',
|
||||
|
||||
-- 有效期
|
||||
`valid_from` DATETIME NOT NULL COMMENT '生效时间',
|
||||
`valid_until` DATETIME NOT NULL COMMENT '失效时间',
|
||||
|
||||
-- 状态
|
||||
`is_active` BOOLEAN DEFAULT TRUE COMMENT '是否启用',
|
||||
`created_by` INT DEFAULT NULL COMMENT '创建人（管理员ID）',
|
||||
`created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
`updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_code (`code`),
|
||||
INDEX idx_valid_dates (`valid_from`, `valid_until`),
|
||||
INDEX idx_is_active (`is_active`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠码表';
|
||||
|
||||
|
||||
-- ============================================
|
||||
-- 2. 创建优惠码使用记录表
|
||||
-- ============================================
|
||||
CREATE TABLE IF NOT EXISTS `promo_code_usage` (
|
||||
`id` INT PRIMARY KEY AUTO_INCREMENT,
|
||||
`promo_code_id` INT NOT NULL COMMENT '优惠码ID',
|
||||
`user_id` INT NOT NULL COMMENT '用户ID',
|
||||
`order_id` INT NOT NULL COMMENT '订单ID',
|
||||
|
||||
`original_amount` DECIMAL(10, 2) NOT NULL COMMENT '原价',
|
||||
`discount_amount` DECIMAL(10, 2) NOT NULL COMMENT '优惠金额',
|
||||
`final_amount` DECIMAL(10, 2) NOT NULL COMMENT '实付金额',
|
||||
|
||||
`used_at` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '使用时间',
|
||||
|
||||
FOREIGN KEY (`promo_code_id`) REFERENCES `promo_codes`(`id`) ON DELETE CASCADE,
|
||||
FOREIGN KEY (`order_id`) REFERENCES `payment_orders`(`id`) ON DELETE CASCADE,
|
||||
|
||||
INDEX idx_user_id (`user_id`),
|
||||
INDEX idx_promo_code_id (`promo_code_id`),
|
||||
INDEX idx_order_id (`order_id`),
|
||||
INDEX idx_used_at (`used_at`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠码使用记录表';
|
||||
|
||||
|
||||
-- ============================================
|
||||
-- 3. 创建订阅升级记录表
|
||||
-- ============================================
|
||||
CREATE TABLE IF NOT EXISTS `subscription_upgrades` (
|
||||
`id` INT PRIMARY KEY AUTO_INCREMENT,
|
||||
`user_id` INT NOT NULL COMMENT '用户ID',
|
||||
`order_id` INT NOT NULL COMMENT '订单ID',
|
||||
|
||||
-- 原订阅信息
|
||||
`from_plan` VARCHAR(20) NOT NULL COMMENT '原套餐',
|
||||
`from_cycle` VARCHAR(10) NOT NULL COMMENT '原周期',
|
||||
`from_end_date` DATETIME DEFAULT NULL COMMENT '原到期日',
|
||||
|
||||
-- 新订阅信息
|
||||
`to_plan` VARCHAR(20) NOT NULL COMMENT '新套餐',
|
||||
`to_cycle` VARCHAR(10) NOT NULL COMMENT '新周期',
|
||||
`to_end_date` DATETIME NOT NULL COMMENT '新到期日',
|
||||
|
||||
-- 价格计算
|
||||
`remaining_value` DECIMAL(10, 2) NOT NULL COMMENT '剩余价值',
|
||||
`upgrade_amount` DECIMAL(10, 2) NOT NULL COMMENT '升级应付金额',
|
||||
`actual_amount` DECIMAL(10, 2) NOT NULL COMMENT '实际支付金额',
|
||||
|
||||
`upgrade_type` VARCHAR(20) NOT NULL COMMENT '升级类型: plan_upgrade（套餐升级）, cycle_change（周期变更）, both（都变更）',
|
||||
`created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
|
||||
FOREIGN KEY (`order_id`) REFERENCES `payment_orders`(`id`) ON DELETE CASCADE,
|
||||
|
||||
INDEX idx_user_id (`user_id`),
|
||||
INDEX idx_order_id (`order_id`),
|
||||
INDEX idx_created_at (`created_at`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订阅升级/降级记录表';
|
||||
|
||||
|
||||
-- ============================================
|
||||
-- 4. 扩展 payment_orders 表（添加新字段）
|
||||
-- ============================================
|
||||
-- 注意：这些字段是可选的扩展，用于记录优惠码和升级信息
|
||||
-- 如果字段已存在会报错，可以忽略
|
||||
|
||||
ALTER TABLE `payment_orders`
|
||||
ADD COLUMN `promo_code_id` INT DEFAULT NULL COMMENT '使用的优惠码ID' AFTER `remark`,
|
||||
ADD COLUMN `original_amount` DECIMAL(10, 2) DEFAULT NULL COMMENT '原价（使用优惠码前）' AFTER `promo_code_id`,
|
||||
ADD COLUMN `discount_amount` DECIMAL(10, 2) DEFAULT 0 COMMENT '优惠金额' AFTER `original_amount`,
|
||||
ADD COLUMN `is_upgrade` BOOLEAN DEFAULT FALSE COMMENT '是否为升级订单' AFTER `discount_amount`,
|
||||
ADD COLUMN `upgrade_from_plan` VARCHAR(20) DEFAULT NULL COMMENT '从哪个套餐升级' AFTER `is_upgrade`;
|
||||
|
||||
-- 添加外键约束
|
||||
ALTER TABLE `payment_orders`
|
||||
ADD CONSTRAINT `fk_payment_orders_promo_code`
|
||||
FOREIGN KEY (`promo_code_id`) REFERENCES `promo_codes`(`id`) ON DELETE SET NULL;
|
||||
|
||||
|
||||
-- ============================================
|
||||
-- 5. 插入示例优惠码（供测试使用）
|
||||
-- ============================================
|
||||
-- 10% 折扣优惠码，适用所有套餐和周期
|
||||
INSERT INTO `promo_codes`
|
||||
(`code`, `description`, `discount_type`, `discount_value`, `applicable_plans`, `applicable_cycles`, `min_amount`, `max_uses`, `max_uses_per_user`, `valid_from`, `valid_until`, `is_active`)
|
||||
VALUES
|
||||
('WELCOME10', '新用户欢迎优惠 - 10%折扣', 'percentage', 10.00, NULL, NULL, NULL, NULL, 1, NOW(), DATE_ADD(NOW(), INTERVAL 1 YEAR), TRUE),
|
||||
('ANNUAL20', '年付专享 - 20%折扣', 'percentage', 20.00, NULL, '["yearly"]', NULL, 100, 1, NOW(), DATE_ADD(NOW(), INTERVAL 1 YEAR), TRUE),
|
||||
('SUMMER50', '夏季促销 - 减免50元', 'fixed_amount', 50.00, '["max"]', NULL, 100.00, 50, 1, NOW(), DATE_ADD(NOW(), INTERVAL 3 MONTH), TRUE);
|
||||
|
||||
-- 完成
|
||||
SELECT 'Migration completed successfully!' AS status;
|
||||
97
package.json
97
package.json
@@ -5,122 +5,107 @@
|
||||
"homepage": "/",
|
||||
"dependencies": {
|
||||
"@ant-design/icons": "^6.0.0",
|
||||
"@chakra-ui/icons": "^2.2.6",
|
||||
"@chakra-ui/react": "^2.10.9",
|
||||
"@chakra-ui/theme-tools": "^2.2.6",
|
||||
"@asseinfo/react-kanban": "^2.2.0",
|
||||
"@chakra-ui/icons": "^2.1.1",
|
||||
"@chakra-ui/react": "^2.8.2",
|
||||
"@chakra-ui/theme-tools": "^1.3.6",
|
||||
"@emotion/cache": "^11.4.0",
|
||||
"@emotion/react": "^11.4.0",
|
||||
"@emotion/styled": "^11.3.0",
|
||||
"@fontsource/open-sans": "^4.5.0",
|
||||
"@fontsource/raleway": "^4.5.0",
|
||||
"@fontsource/roboto": "^4.5.0",
|
||||
"@fullcalendar/core": "^6.1.19",
|
||||
"@fullcalendar/daygrid": "^6.1.19",
|
||||
"@fullcalendar/interaction": "^6.1.19",
|
||||
"@fullcalendar/react": "^6.1.19",
|
||||
"@reduxjs/toolkit": "^2.9.2",
|
||||
"@fullcalendar/daygrid": "^5.9.0",
|
||||
"@fullcalendar/interaction": "^5.9.0",
|
||||
"@fullcalendar/react": "^5.9.0",
|
||||
"@react-three/drei": "^9.11.3",
|
||||
"@react-three/fiber": "^8.0.27",
|
||||
"@splidejs/react-splide": "^0.7.12",
|
||||
"@tanstack/react-virtual": "^3.13.12",
|
||||
"@tippyjs/react": "^4.2.6",
|
||||
"@visx/responsive": "^3.12.0",
|
||||
"@visx/scale": "^3.12.0",
|
||||
"@visx/text": "^3.12.0",
|
||||
"@visx/visx": "^3.12.0",
|
||||
"@visx/wordcloud": "^3.12.0",
|
||||
"antd": "^5.27.4",
|
||||
"apexcharts": "^3.27.3",
|
||||
"axios": "^1.10.0",
|
||||
"classnames": "^2.5.1",
|
||||
"d3": "^7.9.0",
|
||||
"date-fns": "^2.23.0",
|
||||
"dayjs": "^1.11.19",
|
||||
"draft-js": "^0.11.7",
|
||||
"echarts": "^5.6.0",
|
||||
"echarts-for-react": "^3.0.2",
|
||||
"echarts-wordcloud": "^2.1.0",
|
||||
"framer-motion": "^12.23.24",
|
||||
"framer-motion": "^4.1.17",
|
||||
"fullcalendar": "^5.9.0",
|
||||
"globalize": "^1.7.0",
|
||||
"history": "^5.3.0",
|
||||
"klinecharts": "^10.0.0-beta1",
|
||||
"leaflet": "^1.9.4",
|
||||
"lucide-react": "^0.540.0",
|
||||
"match-sorter": "6.3.0",
|
||||
"moment": "^2.29.1",
|
||||
"nouislider": "15.0.0",
|
||||
"posthog-js": "^1.295.0",
|
||||
"react": "^19.0.0",
|
||||
"react": "18.3.1",
|
||||
"react-apexcharts": "^1.3.9",
|
||||
"react-big-calendar": "^0.33.2",
|
||||
"react-bootstrap-sweetalert": "5.2.0",
|
||||
"react-circular-slider-svg": "^0.1.5",
|
||||
"react-custom-scrollbars-2": "^4.4.0",
|
||||
"react-dom": "^19.0.0",
|
||||
"react-datetime": "^3.0.4",
|
||||
"react-dom": "^18.3.1",
|
||||
"react-dropzone": "^11.4.2",
|
||||
"react-github-btn": "^1.2.1",
|
||||
"react-icons": "^4.12.0",
|
||||
"react-input-pin-code": "^1.1.5",
|
||||
"react-is": "^19.0.0",
|
||||
"react-just-parallax": "^3.1.16",
|
||||
"react-jvectormap": "0.0.16",
|
||||
"react-leaflet": "^3.2.5",
|
||||
"react-markdown": "^10.1.0",
|
||||
"react-redux": "^9.2.0",
|
||||
"react-quill": "^2.0.0-beta.4",
|
||||
"react-responsive": "^10.0.1",
|
||||
"react-responsive-masonry": "^2.7.1",
|
||||
"react-router-dom": "^6.30.1",
|
||||
"react-scripts": "^5.0.1",
|
||||
"react-scroll": "^1.8.4",
|
||||
"react-scroll-into-view": "^2.1.3",
|
||||
"react-swipeable-views": "0.13.9",
|
||||
"react-table": "^7.7.0",
|
||||
"react-tagsinput": "3.19.0",
|
||||
"react-to-print": "^3.0.3",
|
||||
"react-to-print": "^2.13.0",
|
||||
"react-tsparticles": "^2.12.2",
|
||||
"react-wordcloud": "^1.2.7",
|
||||
"recharts": "^3.1.2",
|
||||
"sass": "^1.49.9",
|
||||
"scroll-lock": "^2.1.5",
|
||||
"socket.io-client": "^4.7.4",
|
||||
"styled-components": "^5.3.11",
|
||||
"stylis": "^4.0.10",
|
||||
"stylis-plugin-rtl": "^2.1.1",
|
||||
"typescript": "^5.9.3"
|
||||
"three": "^0.142.0",
|
||||
"tsparticles-slim": "^2.12.0"
|
||||
},
|
||||
"resolutions": {
|
||||
"react-error-overlay": "6.0.9",
|
||||
"@types/react": "^19.0.0",
|
||||
"@types/react-dom": "^19.0.0"
|
||||
"@types/react": "18.2.0",
|
||||
"@types/react-dom": "18.2.0"
|
||||
},
|
||||
"overrides": {
|
||||
"uuid": "^9.0.1",
|
||||
"react": "^19.0.0",
|
||||
"react-dom": "^19.0.0"
|
||||
"uuid": "^9.0.1"
|
||||
},
|
||||
"scripts": {
|
||||
"prestart": "kill-port 3000",
|
||||
"start": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' env-cmd -f .env.mock craco start",
|
||||
"prestart:real": "kill-port 3000",
|
||||
"start:real": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' env-cmd -f .env.local craco start",
|
||||
"prestart:dev": "kill-port 3000",
|
||||
"start": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' craco start",
|
||||
"start:mock": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' env-cmd -f .env.mock craco start",
|
||||
"start:dev": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' env-cmd -f .env.development craco start",
|
||||
"start:test": "concurrently \"python app.py\" \"npm run frontend:test\" --names \"backend,frontend\" --prefix-colors \"blue,green\"",
|
||||
"frontend:test": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' env-cmd -f .env.test craco start",
|
||||
"dev": "npm start",
|
||||
"backend": "python app.py",
|
||||
"build": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' TSC_COMPILE_ON_ERROR=true DISABLE_ESLINT_PLUGIN=true env-cmd -f .env.production craco build && gulp licenses",
|
||||
"build": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' craco build && gulp licenses",
|
||||
"build:analyze": "NODE_OPTIONS='--openssl-legacy-provider --max_old_space_size=4096' ANALYZE=true craco build",
|
||||
"test": "craco test --env=jsdom",
|
||||
"eject": "react-scripts eject",
|
||||
"deploy": "bash scripts/deploy-from-local.sh",
|
||||
"deploy:setup": "bash scripts/setup-deployment.sh",
|
||||
"rollback": "bash scripts/rollback-from-local.sh",
|
||||
"lint:check": "eslint . --ext=js,jsx,ts,tsx; exit 0",
|
||||
"lint:fix": "eslint . --ext=js,jsx,ts,tsx --fix; exit 0",
|
||||
"type-check": "tsc --noEmit",
|
||||
"type-check:watch": "tsc --noEmit --watch",
|
||||
"clean": "rm -rf node_modules/ package-lock.json",
|
||||
"reinstall": "npm run clean && npm install"
|
||||
"deploy": "npm run build",
|
||||
"lint:check": "eslint . --ext=js,jsx; exit 0",
|
||||
"lint:fix": "eslint . --ext=js,jsx --fix; exit 0",
|
||||
"install:clean": "rm -rf node_modules/ && rm -rf package-lock.json && npm install && npm start"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@craco/craco": "^7.1.0",
|
||||
"@types/node": "^20.19.25",
|
||||
"@types/react": "^19.0.0",
|
||||
"@types/react-dom": "^19.0.0",
|
||||
"@typescript-eslint/eslint-plugin": "^8.46.4",
|
||||
"@typescript-eslint/parser": "^8.46.4",
|
||||
"ajv": "^8.17.1",
|
||||
"concurrently": "^8.2.2",
|
||||
"autoprefixer": "^10.4.21",
|
||||
"env-cmd": "^11.0.0",
|
||||
"eslint-config-prettier": "8.3.0",
|
||||
"eslint-plugin-prettier": "3.4.0",
|
||||
@@ -129,11 +114,12 @@
|
||||
"imagemin": "^9.0.1",
|
||||
"imagemin-mozjpeg": "^10.0.0",
|
||||
"imagemin-pngquant": "^10.0.0",
|
||||
"kill-port": "^2.0.1",
|
||||
"msw": "^2.11.5",
|
||||
"postcss": "^8.5.6",
|
||||
"prettier": "2.2.1",
|
||||
"react-error-overlay": "6.0.9",
|
||||
"sharp": "^0.34.4",
|
||||
"tailwindcss": "^3.4.17",
|
||||
"ts-node": "^10.9.2",
|
||||
"webpack-bundle-analyzer": "^4.10.2",
|
||||
"yn": "^5.1.0"
|
||||
@@ -154,8 +140,5 @@
|
||||
"workerDirectory": [
|
||||
"public"
|
||||
]
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"fsevents": "^2.3.3"
|
||||
}
|
||||
}
|
||||
|
||||
6
postcss.config.js
Normal file
6
postcss.config.js
Normal file
@@ -0,0 +1,6 @@
|
||||
module.exports = {
|
||||
plugins: [
|
||||
require('tailwindcss'),
|
||||
require('autoprefixer'),
|
||||
],
|
||||
}
|
||||
Binary file not shown.
Binary file not shown.
|
Before Width: | Height: | Size: 15 KiB |
BIN
public/badge.png
BIN
public/badge.png
Binary file not shown.
|
Before Width: | Height: | Size: 8.7 KiB |
@@ -1,585 +0,0 @@
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>6G产业链深度解析 - 下一代通信技术革命</title>
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link href="https://cdn.jsdelivr.net/npm/daisyui@4.4.19/dist/full.min.css" rel="stylesheet" type="text/css" />
|
||||
<script src="https://unpkg.com/aos@2.3.1/dist/aos.js"></script>
|
||||
<link href="https://unpkg.com/aos@2.3.1/dist/aos.css" rel="stylesheet">
|
||||
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;700&display=swap');
|
||||
|
||||
body {
|
||||
font-family: 'Noto Sans SC', sans-serif;
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
min-height: 100vh;
|
||||
}
|
||||
|
||||
.hero-gradient {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
position: relative;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.hero-gradient::before {
|
||||
content: '';
|
||||
position: absolute;
|
||||
top: -50%;
|
||||
right: -50%;
|
||||
width: 200%;
|
||||
height: 200%;
|
||||
background: radial-gradient(circle, rgba(255,255,255,0.1) 0%, transparent 70%);
|
||||
animation: rotate 30s linear infinite;
|
||||
}
|
||||
|
||||
@keyframes rotate {
|
||||
0% { transform: rotate(0deg); }
|
||||
100% { transform: rotate(360deg); }
|
||||
}
|
||||
|
||||
.timeline-line {
|
||||
background: linear-gradient(180deg, #667eea 0%, #764ba2 100%);
|
||||
width: 4px;
|
||||
position: absolute;
|
||||
left: 50%;
|
||||
transform: translateX(-50%);
|
||||
}
|
||||
|
||||
.timeline-item {
|
||||
position: relative;
|
||||
padding: 20px;
|
||||
background: rgba(255, 255, 255, 0.95);
|
||||
border-radius: 12px;
|
||||
box-shadow: 0 4px 20px rgba(0,0,0,0.1);
|
||||
transition: all 0.3s ease;
|
||||
}
|
||||
|
||||
.timeline-item:hover {
|
||||
transform: translateY(-5px);
|
||||
box-shadow: 0 8px 30px rgba(0,0,0,0.15);
|
||||
}
|
||||
|
||||
.stock-table {
|
||||
overflow-x: auto;
|
||||
}
|
||||
|
||||
.stock-table table {
|
||||
width: 100%;
|
||||
min-width: 1000px;
|
||||
}
|
||||
|
||||
.stock-table td, .stock-table th {
|
||||
white-space: nowrap;
|
||||
padding: 8px 12px;
|
||||
}
|
||||
|
||||
.tag-cloud span {
|
||||
display: inline-block;
|
||||
padding: 4px 12px;
|
||||
margin: 4px;
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
color: white;
|
||||
border-radius: 20px;
|
||||
font-size: 14px;
|
||||
transition: all 0.3s ease;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.tag-cloud span:hover {
|
||||
transform: scale(1.1);
|
||||
box-shadow: 0 4px 15px rgba(102, 126, 234, 0.4);
|
||||
}
|
||||
|
||||
.stat-card {
|
||||
background: rgba(255, 255, 255, 0.95);
|
||||
border-radius: 16px;
|
||||
padding: 20px;
|
||||
box-shadow: 0 4px 20px rgba(0,0,0,0.1);
|
||||
transition: all 0.3s ease;
|
||||
}
|
||||
|
||||
.stat-card:hover {
|
||||
transform: translateY(-5px);
|
||||
box-shadow: 0 8px 30px rgba(0,0,0,0.15);
|
||||
}
|
||||
|
||||
.pulse-dot {
|
||||
position: relative;
|
||||
display: inline-block;
|
||||
width: 10px;
|
||||
height: 10px;
|
||||
background: #10b981;
|
||||
border-radius: 50%;
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0% { box-shadow: 0 0 0 0 rgba(16, 185, 129, 0.7); }
|
||||
70% { box-shadow: 0 0 0 10px rgba(16, 185, 129, 0); }
|
||||
100% { box-shadow: 0 0 0 0 rgba(16, 185, 129, 0); }
|
||||
}
|
||||
|
||||
.risk-meter {
|
||||
height: 20px;
|
||||
background: linear-gradient(90deg, #10b981 0%, #fbbf24 50%, #ef4444 100%);
|
||||
border-radius: 10px;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
.risk-indicator {
|
||||
position: absolute;
|
||||
width: 4px;
|
||||
height: 24px;
|
||||
background: #1f2937;
|
||||
border-radius: 2px;
|
||||
top: -2px;
|
||||
transition: all 0.3s ease;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Hero Section -->
|
||||
<section class="hero-gradient text-white py-20 relative">
|
||||
<div class="container mx-auto px-4 relative z-10">
|
||||
<div class="text-center" data-aos="fade-up">
|
||||
<h1 class="text-5xl md:text-6xl font-bold mb-6">6G产业链深度解析</h1>
|
||||
<p class="text-xl md:text-2xl mb-4">下一代通信技术革命 · 2030年商用倒计时</p>
|
||||
<div class="flex justify-center items-center gap-2 mb-8">
|
||||
<span class="pulse-dot"></span>
|
||||
<span>强政策驱动下的主题投资与基本面验证叠加期</span>
|
||||
</div>
|
||||
<div class="tag-cloud justify-center">
|
||||
<span>天空地海一体化</span>
|
||||
<span>通信+感知+AI融合</span>
|
||||
<span>卫星互联网</span>
|
||||
<span>太赫兹技术</span>
|
||||
<span>数字孪生</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Key Stats -->
|
||||
<section class="py-12 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<div class="grid grid-cols-1 md:grid-cols-4 gap-6">
|
||||
<div class="stat-card" data-aos="fade-up" data-aos-delay="100">
|
||||
<h3 class="text-3xl font-bold text-purple-600 mb-2">2030</h3>
|
||||
<p class="text-gray-600">规模化商用元年</p>
|
||||
</div>
|
||||
<div class="stat-card" data-aos="fade-up" data-aos-delay="200">
|
||||
<h3 class="text-3xl font-bold text-purple-600 mb-2">2025</h3>
|
||||
<p class="text-gray-600">标准化元年</p>
|
||||
</div>
|
||||
<div class="stat-card" data-aos="fade-up" data-aos-delay="300">
|
||||
<h3 class="text-3xl font-bold text-purple-600 mb-2">3000万</h3>
|
||||
<p class="text-gray-600">最高政策资金支持</p>
|
||||
</div>
|
||||
<div class="stat-card" data-aos="fade-up" data-aos-delay="400">
|
||||
<h3 class="text-3xl font-bold text-purple-600 mb-2">100+</h3>
|
||||
<p class="text-gray-600">6G研究成果发布</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Timeline Section -->
|
||||
<section class="py-12 bg-gray-50">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">发展时间轴</h2>
|
||||
<div class="relative">
|
||||
<div class="timeline-line hidden md:block"></div>
|
||||
|
||||
<!-- Timeline Items -->
|
||||
<div class="space-y-8">
|
||||
<div class="timeline-item md:w-5/12 md:ml-auto" data-aos="fade-right">
|
||||
<div class="text-sm text-purple-600 font-semibold mb-2">2024年末-2025年初</div>
|
||||
<h3 class="text-xl font-bold mb-2">政策催化元年</h3>
|
||||
<p>政府工作报告首次将6G纳入"未来产业培育核心框架"，工信部明确"加快6G研发进程"</p>
|
||||
</div>
|
||||
|
||||
<div class="timeline-item md:w-5/12" data-aos="fade-left">
|
||||
<div class="text-sm text-purple-600 font-semibold mb-2">2025年7月</div>
|
||||
<h3 class="text-xl font-bold mb-2">首个专项资金落地</h3>
|
||||
<p>北京亦庄落地全国首个地方性6G产业专项资金政策，最高支持3000万元</p>
|
||||
</div>
|
||||
|
||||
<div class="timeline-item md:w-5/12 md:ml-auto" data-aos="fade-right">
|
||||
<div class="text-sm text-purple-600 font-semibold mb-2">2025年9月</div>
|
||||
<h3 class="text-xl font-bold mb-2">标准突破</h3>
|
||||
<p>中国电信牵头"6G系统计费研究"项目获3GPP批准，取得标准话语权</p>
|
||||
</div>
|
||||
|
||||
<div class="timeline-item md:w-5/12" data-aos="fade-left">
|
||||
<div class="text-sm text-purple-600 font-semibold mb-2">2025年11月</div>
|
||||
<h3 class="text-xl font-bold mb-2">6G发展大会</h3>
|
||||
<p>北京举办2025年6G发展大会，发布技术试验结果和重点场景研究成果</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Core Concepts -->
|
||||
<section class="py-12 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">核心概念解析</h2>
|
||||
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 gap-8 mb-12">
|
||||
<div class="card bg-gradient-to-br from-purple-100 to-pink-100 shadow-xl" data-aos="fade-up">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl font-bold mb-4">技术范式跃迁</h3>
|
||||
<ul class="space-y-2">
|
||||
<li class="flex items-start">
|
||||
<span class="text-purple-600 mr-2">▸</span>
|
||||
<span><strong>空天地海一体化</strong>：卫星互联网为核心，实现全域覆盖</span>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<span class="text-purple-600 mr-2">▸</span>
|
||||
<span><strong>通信+感知+AI融合</strong>：网络成为智能服务平台</span>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<span class="text-purple-600 mr-2">▸</span>
|
||||
<span><strong>太赫兹技术</strong>：6G核心频段，实现TB级传输</span>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card bg-gradient-to-br from-blue-100 to-cyan-100 shadow-xl" data-aos="fade-up" data-aos-delay="100">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl font-bold mb-4">市场认知分析</h3>
|
||||
<ul class="space-y-2">
|
||||
<li class="flex items-start">
|
||||
<span class="text-blue-600 mr-2">▸</span>
|
||||
<span><strong>乐观预期</strong>：政策密集释放，板块热度高涨</span>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<span class="text-blue-600 mr-2">▸</span>
|
||||
<span><strong>预期差1</strong>：低估"感知"功能商业价值</span>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<span class="text-blue-600 mr-2">▸</span>
|
||||
<span><strong>预期差2</strong>：忽视上游细分"卖铲人"机会</span>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 产业链图谱 -->
|
||||
<div class="card shadow-xl" data-aos="fade-up">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl font-bold mb-4">6G产业链关键环节</h3>
|
||||
<div class="grid grid-cols-1 md:grid-cols-3 gap-4">
|
||||
<div class="bg-purple-50 p-4 rounded-lg">
|
||||
<h4 class="font-bold text-purple-700 mb-2">上游：核心器件</h4>
|
||||
<ul class="text-sm space-y-1">
|
||||
<li>• 射频器件（天线/滤波器）</li>
|
||||
<li>• 基带/射频芯片</li>
|
||||
<li>• 太赫兹器件</li>
|
||||
<li>• 光模块/光器件</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="bg-blue-50 p-4 rounded-lg">
|
||||
<h4 class="font-bold text-blue-700 mb-2">中游：设备系统</h4>
|
||||
<ul class="text-sm space-y-1">
|
||||
<li>• 无线主设备</li>
|
||||
<li>• 卫星制造与运营</li>
|
||||
<li>• 光通信网络</li>
|
||||
<li>• 网络安全设备</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="bg-green-50 p-4 rounded-lg">
|
||||
<h4 class="font-bold text-green-700 mb-2">下游：运营应用</h4>
|
||||
<ul class="text-sm space-y-1">
|
||||
<li>• 三大运营商</li>
|
||||
<li>• 网络服务与安全</li>
|
||||
<li>• 垂直行业应用</li>
|
||||
<li>• 终端设备</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Key Catalysts -->
|
||||
<section class="py-12 bg-gray-50">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">关键催化剂</h2>
|
||||
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
|
||||
<div class="alert alert-info shadow-lg" data-aos="zoom-in">
|
||||
<div>
|
||||
<h3 class="font-bold">近期催化剂</h3>
|
||||
<div class="text-sm mt-2">
|
||||
<p>• 2025年6G发展大会技术试验结果</p>
|
||||
<p>• 地方政策细则持续出台</p>
|
||||
<p>• 运营商6G资本开支边际提升</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="alert alert-warning shadow-lg" data-aos="zoom-in" data-aos-delay="100">
|
||||
<div>
|
||||
<h3 class="font-bold">发展阶段</h3>
|
||||
<div class="text-sm mt-2">
|
||||
<p>• 2025-2027：标准主导</p>
|
||||
<p>• 2027-2030：试验验证</p>
|
||||
<p>• 2030+：规模商用</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="alert alert-success shadow-lg" data-aos="zoom-in" data-aos-delay="200">
|
||||
<div>
|
||||
<h3 class="font-bold">投资方向</h3>
|
||||
<div class="text-sm mt-2">
|
||||
<p>• 卫星互联网产业链</p>
|
||||
<p>• 核心射频器件重构</p>
|
||||
<p>• 算力网络与光通信</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Risk Analysis -->
|
||||
<section class="py-12 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">风险与挑战</h2>
|
||||
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
|
||||
<div class="card bg-red-50 shadow-xl" data-aos="fade-right">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl font-bold text-red-700 mb-4">技术风险</h3>
|
||||
<div class="space-y-3">
|
||||
<div>
|
||||
<div class="flex justify-between items-center mb-1">
|
||||
<span class="text-sm font-medium">太赫兹芯片"卡脖子"</span>
|
||||
<span class="text-sm text-red-600">高风险</span>
|
||||
</div>
|
||||
<div class="risk-meter">
|
||||
<div class="risk-indicator" style="left: 85%"></div>
|
||||
</div>
|
||||
</div>
|
||||
<div>
|
||||
<div class="flex justify-between items-center mb-1">
|
||||
<span class="text-sm font-medium">星地融合复杂度</span>
|
||||
<span class="text-sm text-yellow-600">中风险</span>
|
||||
</div>
|
||||
<div class="risk-meter">
|
||||
<div class="risk-indicator" style="left: 60%"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card bg-orange-50 shadow-xl" data-aos="fade-left">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl font-bold text-orange-700 mb-4">市场风险</h3>
|
||||
<div class="space-y-3">
|
||||
<div>
|
||||
<div class="flex justify-between items-center mb-1">
|
||||
<span class="text-sm font-medium">投资规模巨大</span>
|
||||
<span class="text-sm text-orange-600">高风险</span>
|
||||
</div>
|
||||
<div class="risk-meter">
|
||||
<div class="risk-indicator" style="left: 80%"></div>
|
||||
</div>
|
||||
</div>
|
||||
<div>
|
||||
<div class="flex justify-between items-center mb-1">
|
||||
<span class="text-sm font-medium">国际标准分裂</span>
|
||||
<span class="text-sm text-red-600">高风险</span>
|
||||
</div>
|
||||
<div class="risk-meter">
|
||||
<div class="risk-indicator" style="left: 90%"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Stock Data Table -->
|
||||
<section class="py-12 bg-gray-50">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">6G产业链核心股票池</h2>
|
||||
|
||||
<div class="card bg-white shadow-xl" data-aos="fade-up">
|
||||
<div class="card-body p-0">
|
||||
<!-- Category Tabs -->
|
||||
<div class="tabs tabs-boxed bg-purple-100 p-4 rounded-t-xl">
|
||||
<a class="tab tab-active" onclick="filterTable('all')">全部</a>
|
||||
<a class="tab" onclick="filterTable('运营商')">运营商</a>
|
||||
<a class="tab" onclick="filterTable('光模块')">光模块</a>
|
||||
<a class="tab" onclick="filterTable('网络设备')">网络设备</a>
|
||||
<a class="tab" onclick="filterTable('基站射频器')">基站射频器</a>
|
||||
</div>
|
||||
|
||||
<!-- Stock Table -->
|
||||
<div class="stock-table">
|
||||
<table class="table table-zebra w-full" id="stockTable">
|
||||
<thead class="bg-purple-600 text-white">
|
||||
<tr>
|
||||
<th>股票名称</th>
|
||||
<th>分类</th>
|
||||
<th>产业链</th>
|
||||
<th>核心逻辑</th>
|
||||
<th>关注理由</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody id="stockTableBody">
|
||||
<!-- Table rows will be populated by JavaScript -->
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Investment Insights -->
|
||||
<section class="py-12 bg-gradient-to-br from-purple-600 to-pink-600 text-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12" data-aos="fade-up">投资启示</h2>
|
||||
|
||||
<div class="grid grid-cols-1 md:grid-cols-3 gap-6">
|
||||
<div class="card bg-white/10 backdrop-blur-md text-white border border-white/20" data-aos="zoom-in">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-lg font-bold mb-3">✓ 卫星互联网</h3>
|
||||
<p class="text-sm">最具增量空间，关注运营（中国卫通）、核心载荷（铖昌科技）、星间光模块（中际旭创）</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card bg-white/10 backdrop-blur-md text-white border border-white/20" data-aos="zoom-in" data-aos-delay="100">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-lg font-bold mb-3">✓ 核心射频</h3>
|
||||
<p class="text-sm">6G频段提升带来价值重构，关注通宇通讯、灿勤科技等技术领先者</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card bg-white/10 backdrop-blur-md text-white border border-white/20" data-aos="zoom-in" data-aos-delay="200">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-lg font-bold mb-3">✓ 算力网络</h3>
|
||||
<p class="text-sm">AI内生网络需求，中兴通讯、紫光股份等平台型公司受益</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="text-center mt-12" data-aos="fade-up">
|
||||
<p class="text-xl mb-4">关键跟踪指标</p>
|
||||
<div class="flex flex-wrap justify-center gap-3">
|
||||
<span class="badge badge-info badge-lg">研发投入占比</span>
|
||||
<span class="badge badge-info badge-lg">标准专利数量</span>
|
||||
<span class="badge badge-info badge-lg">技术试验进展</span>
|
||||
<span class="badge badge-info badge-lg">订单兑现情况</span>
|
||||
<span class="badge badge-info badge-lg">资本开支倾斜</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Footer -->
|
||||
<footer class="bg-gray-900 text-white py-8">
|
||||
<div class="container mx-auto px-4 text-center">
|
||||
<p class="mb-2">6G产业链深度解析 | 数据来源：机构研报、互动平台、公告等</p>
|
||||
<p class="text-sm text-gray-400">投资有风险，入市需谨慎</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<script>
|
||||
// Stock Data
|
||||
const stockData = [
|
||||
{stock: '中国移动', category: '运营商', industry: '6G产业链', reason: '网络建设运营主导者', focus: '运营商分类'},
|
||||
{stock: '中国电信', category: '运营商', industry: '6G产业链', reason: '网络建设运营主导者', focus: '运营商分类'},
|
||||
{stock: '中国联通', category: '运营商', industry: '6G产业链', reason: '网络建设运营主导者', focus: '运营商分类'},
|
||||
{stock: '中兴通讯', category: '网络设备', industry: '6G产业链', reason: '端到端解决方案龙头', focus: '综合平台型'},
|
||||
{stock: '中际旭创', category: '光模块', industry: '6G产业链', reason: '星间链路核心受益', focus: '光模块龙头'},
|
||||
{stock: '光迅科技', category: '光模块', industry: '6G产业链', reason: '星间链路核心受益', focus: '光模块龙头'},
|
||||
{stock: '新易盛', category: '光模块', industry: '6G产业链', reason: '高速光模块领先', focus: '光模块龙头'},
|
||||
{stock: '华工科技', category: '光模块', industry: '6G产业链', reason: '国内电信级光模块龙头', focus: '光模块龙头'},
|
||||
{stock: '通宇通讯', category: '天线', industry: '6G产业链', reason: '6G天线技术积累', focus: '天线细分龙头'},
|
||||
{stock: '武汉凡谷', category: '基站射频器', industry: '6G产业链', reason: '基站射频器件价值重构', focus: '射频器件'},
|
||||
{stock: '大富科技', category: '基站射频器', industry: '6G产业链', reason: '基站射频器件价值重构', focus: '射频器件'},
|
||||
{stock: '灿勤科技', category: '基站射频器', industry: '6G产业链', reason: '滤波器核心技术', focus: '射频器件'},
|
||||
{stock: '铖昌科技', category: '基站射频器', industry: '6G产业链', reason: '卫星射频芯片核心', focus: '卫星互联网'},
|
||||
{stock: '国博电子', category: '基站射频器', industry: '6G产业链', reason: '射频芯片国家队', focus: '射频器件'},
|
||||
{stock: '中国卫通', category: '运营商', industry: '6G产业链', reason: '卫星运营国家队', focus: '卫星互联网'},
|
||||
{stock: '烽火通信', category: '网络设备', industry: '6G产业链', reason: '光通信全产业链', focus: '网络设备'},
|
||||
{stock: '紫光股份', category: '网络设备', industry: '6G产业链', reason: 'ICT基础设施龙头', focus: '网络设备'},
|
||||
{stock: '电科网安', category: '网络安全', industry: '6G产业链', reason: '6G网络安全需求提升', focus: '网络安全'},
|
||||
{stock: '亨通光电', category: '光纤光缆', industry: '6G产业链', reason: '海底光缆+光纤光缆双轮驱动', focus: '有线通信'},
|
||||
{stock: '长飞光纤', category: '光纤光缆', industry: '6G产业链', reason: '光纤预制棒龙头', focus: '有线通信'}
|
||||
];
|
||||
|
||||
// Initialize AOS
|
||||
AOS.init({
|
||||
duration: 1000,
|
||||
once: true
|
||||
});
|
||||
|
||||
// Populate Stock Table
|
||||
function populateTable(data = stockData) {
|
||||
const tbody = document.getElementById('stockTableBody');
|
||||
tbody.innerHTML = '';
|
||||
|
||||
data.forEach((stock, index) => {
|
||||
const row = document.createElement('tr');
|
||||
row.className = index % 2 === 0 ? 'hover:bg-purple-50' : 'hover:bg-purple-50';
|
||||
row.innerHTML = `
|
||||
<td class="font-semibold">${stock.stock}</td>
|
||||
<td><span class="badge badge-info">${stock.category}</span></td>
|
||||
<td>${stock.industry}</td>
|
||||
<td class="text-sm">${stock.reason}</td>
|
||||
<td><span class="text-xs text-purple-600">${stock.focus}</span></td>
|
||||
`;
|
||||
tbody.appendChild(row);
|
||||
});
|
||||
}
|
||||
|
||||
// Filter Table
|
||||
function filterTable(category) {
|
||||
// Update active tab
|
||||
document.querySelectorAll('.tab').forEach(tab => {
|
||||
tab.classList.remove('tab-active');
|
||||
});
|
||||
event.target.classList.add('tab-active');
|
||||
|
||||
// Filter data
|
||||
const filteredData = category === 'all'
|
||||
? stockData
|
||||
: stockData.filter(stock => stock.category === category);
|
||||
|
||||
populateTable(filteredData);
|
||||
}
|
||||
|
||||
// Initialize table on load
|
||||
document.addEventListener('DOMContentLoaded', function() {
|
||||
populateTable();
|
||||
});
|
||||
|
||||
// Add smooth scroll
|
||||
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
|
||||
anchor.addEventListener('click', function (e) {
|
||||
e.preventDefault();
|
||||
const target = document.querySelector(this.getAttribute('href'));
|
||||
if (target) {
|
||||
target.scrollIntoView({ behavior: 'smooth' });
|
||||
}
|
||||
});
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,833 +0,0 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>AI PCB英伟达M9 - 深度投资分析</title>
|
||||
<link href="https://cdn.jsdelivr.net/npm/daisyui@4.4.24/dist/full.min.css" rel="stylesheet" type="text/css" />
|
||||
<link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet" type="text/css" />
|
||||
<link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css" rel="stylesheet">
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap');
|
||||
|
||||
body {
|
||||
font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
|
||||
background: linear-gradient(135deg, #0f172a 0%, #1e293b 50%, #0f172a 100%);
|
||||
min-height: 100vh;
|
||||
}
|
||||
|
||||
.hero-gradient {
|
||||
background: linear-gradient(135deg, #3b82f6 0%, #8b5cf6 50%, #ec4899 100%);
|
||||
}
|
||||
|
||||
.card-hover {
|
||||
transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
|
||||
}
|
||||
|
||||
.card-hover:hover {
|
||||
transform: translateY(-8px);
|
||||
box-shadow: 0 20px 40px rgba(0, 0, 0, 0.3);
|
||||
}
|
||||
|
||||
.timeline-line {
|
||||
background: linear-gradient(180deg, #3b82f6 0%, #8b5cf6 100%);
|
||||
}
|
||||
|
||||
.glass-effect {
|
||||
background: rgba(255, 255, 255, 0.05);
|
||||
backdrop-filter: blur(10px);
|
||||
border: 1px solid rgba(255, 255, 255, 0.1);
|
||||
}
|
||||
|
||||
.tech-grid {
|
||||
background-image:
|
||||
linear-gradient(rgba(59, 130, 246, 0.1) 1px, transparent 1px),
|
||||
linear-gradient(90deg, rgba(59, 130, 246, 0.1) 1px, transparent 1px);
|
||||
background-size: 50px 50px;
|
||||
}
|
||||
|
||||
.pulse-dot {
|
||||
animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0%, 100% { opacity: 1; }
|
||||
50% { opacity: 0.5; }
|
||||
}
|
||||
|
||||
.scroll-container {
|
||||
scrollbar-width: thin;
|
||||
scrollbar-color: #4b5563 #1f2937;
|
||||
}
|
||||
|
||||
.scroll-container::-webkit-scrollbar {
|
||||
height: 8px;
|
||||
width: 8px;
|
||||
}
|
||||
|
||||
.scroll-container::-webkit-scrollbar-track {
|
||||
background: #1f2937;
|
||||
}
|
||||
|
||||
.scroll-container::-webkit-scrollbar-thumb {
|
||||
background: #4b5563;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
.number-animate {
|
||||
animation: countUp 2s ease-out forwards;
|
||||
}
|
||||
|
||||
@keyframes countUp {
|
||||
from { opacity: 0; transform: translateY(20px); }
|
||||
to { opacity: 1; transform: translateY(0); }
|
||||
}
|
||||
|
||||
.gradient-text {
|
||||
background: linear-gradient(135deg, #60a5fa, #c084fc, #f472b6);
|
||||
-webkit-background-clip: text;
|
||||
-webkit-text-fill-color: transparent;
|
||||
background-clip: text;
|
||||
}
|
||||
|
||||
.stock-table {
|
||||
display: block;
|
||||
overflow-x: auto;
|
||||
white-space: nowrap;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body class="text-gray-100">
|
||||
<!-- Navigation -->
|
||||
<div class="navbar glass-effect fixed top-0 w-full z-50 px-4">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="flex justify-between items-center h-16">
|
||||
<div class="flex items-center space-x-3">
|
||||
<div class="w-10 h-10 rounded-lg bg-gradient-to-br from-blue-500 to-purple-600 flex items-center justify-center">
|
||||
<i class="fas fa-microchip text-white"></i>
|
||||
</div>
|
||||
<span class="text-xl font-bold gradient-text">AI PCB英伟达M9</span>
|
||||
</div>
|
||||
<div class="hidden md:flex space-x-6">
|
||||
<a href="#overview" class="hover:text-blue-400 transition">核心逻辑</a>
|
||||
<a href="#timeline" class="hover:text-blue-400 transition">事件时间轴</a>
|
||||
<a href="#industry" class="hover:text-blue-400 transition">产业链</a>
|
||||
<a href="#stocks" class="hover:text-blue-400 transition">核心标的</a>
|
||||
<a href="#risks" class="hover:text-blue-400 transition">风险提示</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Hero Section -->
|
||||
<section class="hero-gradient min-h-screen flex items-center relative overflow-hidden tech-grid">
|
||||
<div class="absolute inset-0 bg-black opacity-30"></div>
|
||||
<div class="container mx-auto px-6 relative z-10">
|
||||
<div class="grid md:grid-cols-2 gap-12 items-center">
|
||||
<div class="number-animate">
|
||||
<div class="inline-block px-4 py-2 bg-white/20 rounded-full mb-6 backdrop-blur-sm">
|
||||
<span class="text-sm font-semibold">🚀 英伟达Rubin系列确认采用M9材料</span>
|
||||
</div>
|
||||
<h1 class="text-5xl md:text-6xl font-bold mb-6 leading-tight">
|
||||
AI服务器PCB<br>
|
||||
<span class="gradient-text">材料革命浪潮</span>
|
||||
</h1>
|
||||
<p class="text-xl mb-8 text-gray-100">
|
||||
2026年Rubin系列量产在即，M9等级覆铜板将开启千亿市场空间。钻针、Q布、HVLP4铜箔成最紧缺环节。
|
||||
</p>
|
||||
<div class="flex flex-wrap gap-4 mb-8">
|
||||
<div class="glass-effect px-6 py-3 rounded-xl">
|
||||
<div class="text-3xl font-bold text-blue-400">5×</div>
|
||||
<div class="text-sm text-gray-300">钻针需求增长</div>
|
||||
</div>
|
||||
<div class="glass-effect px-6 py-3 rounded-xl">
|
||||
<div class="text-3xl font-bold text-purple-400">78层</div>
|
||||
<div class="text-sm text-gray-300">正交背板层数</div>
|
||||
</div>
|
||||
<div class="glass-effect px-6 py-3 rounded-xl">
|
||||
<div class="text-3xl font-bold text-pink-400">千亿</div>
|
||||
<div class="text-sm text-gray-300">市场空间</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex space-x-4">
|
||||
<button onclick="document.getElementById('overview').scrollIntoView({behavior: 'smooth'})"
|
||||
class="px-8 py-3 bg-white text-gray-900 rounded-xl font-semibold hover:bg-gray-100 transition">
|
||||
深度分析
|
||||
</button>
|
||||
<button onclick="document.getElementById('stocks').scrollIntoView({behavior: 'smooth'})"
|
||||
class="px-8 py-3 glass-effect rounded-xl font-semibold hover:bg-white/20 transition">
|
||||
查看标的
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
<div class="relative">
|
||||
<div class="absolute inset-0 bg-gradient-to-r from-blue-500/20 to-purple-500/20 rounded-3xl blur-3xl"></div>
|
||||
<canvas id="trendChart" class="relative z-10"></canvas>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="absolute bottom-10 left-1/2 transform -translate-x-1/2 pulse-dot">
|
||||
<i class="fas fa-chevron-down text-2xl"></i>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Core Logic Section -->
|
||||
<section id="overview" class="py-20 px-6">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center mb-12">
|
||||
<h2 class="text-4xl font-bold mb-4">核心逻辑与市场认知</h2>
|
||||
<p class="text-xl text-gray-400">从算力升级到材料革命的必然路径</p>
|
||||
</div>
|
||||
|
||||
<div class="grid md:grid-cols-3 gap-8 mb-12">
|
||||
<div class="glass-effect rounded-2xl p-8 card-hover">
|
||||
<div class="w-16 h-16 bg-blue-500/20 rounded-2xl flex items-center justify-center mb-6">
|
||||
<i class="fas fa-rocket text-2xl text-blue-400"></i>
|
||||
</div>
|
||||
<h3 class="text-2xl font-bold mb-4">算力需求爆炸</h3>
|
||||
<p class="text-gray-400 mb-4">AI模型向万亿参数演进，推理和后训练需求激增</p>
|
||||
<div class="border-l-4 border-blue-400 pl-4">
|
||||
<p class="text-sm">2030年AI基础设施市场规模达3-5万亿美元</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8 card-hover">
|
||||
<div class="w-16 h-16 bg-purple-500/20 rounded-2xl flex items-center justify-center mb-6">
|
||||
<i class="fas fa-network-wired text-2xl text-purple-400"></i>
|
||||
</div>
|
||||
<h3 class="text-2xl font-bold mb-4">架构复杂化</h3>
|
||||
<p class="text-gray-400 mb-4">从铜缆互联到正交背板，PCB层数和集成度要求空前</p>
|
||||
<div class="border-l-4 border-purple-400 pl-4">
|
||||
<p class="text-sm">Rubin Ultra: 3块26层合成78层板</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8 card-hover">
|
||||
<div class="w-16 h-16 bg-pink-500/20 rounded-2xl flex items-center justify-center mb-6">
|
||||
<i class="fas fa-atom text-2xl text-pink-400"></i>
|
||||
</div>
|
||||
<h3 class="text-2xl font-bold mb-4">材料革命</h3>
|
||||
<p class="text-gray-400 mb-4">M9材料组合升级，Q布+HVLP4铜箔+碳氢树脂</p>
|
||||
<div class="border-l-4 border-pink-400 pl-4">
|
||||
<p class="text-sm">球形二氧化硅用量翻倍增长</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6">预期差分析</h3>
|
||||
<div class="grid md:grid-cols-2 gap-6">
|
||||
<div class="border-l-4 border-yellow-400 pl-6">
|
||||
<h4 class="text-xl font-semibold mb-3 text-yellow-400">时间差</h4>
|
||||
<p class="text-gray-400">市场憧憬2026年千亿空间，但GB300仅小批量订单，存在2-3季度业绩真空期</p>
|
||||
</div>
|
||||
<div class="border-l-4 border-green-400 pl-6">
|
||||
<h4 class="text-xl font-semibold mb-3 text-green-400">结构性</h4>
|
||||
<p class="text-gray-400">钻针需求增5倍（200孔/针），其他环节为"极紧"，紧缺程度差异巨大</p>
|
||||
</div>
|
||||
<div class="border-l-4 border-red-400 pl-6">
|
||||
<h4 class="text-xl font-semibold mb-3 text-red-400">确定性</h4>
|
||||
<p class="text-gray-400">沪电50%份额为预期，Rubin供应商名单仍在角逐，竞争激烈</p>
|
||||
</div>
|
||||
<div class="border-l-4 border-blue-400 pl-6">
|
||||
<h4 class="text-xl font-semibold mb-3 text-blue-400">节奏</h4>
|
||||
<p class="text-gray-400">11月底Switch tray评估结果将是近期关键催化剂</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Timeline Section -->
|
||||
<section id="timeline" class="py-20 px-6 bg-gray-900/50">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center mb-12">
|
||||
<h2 class="text-4xl font-bold mb-4">关键事件时间轴</h2>
|
||||
<p class="text-xl text-gray-400">从概念引爆到业绩兑现的完整路径</p>
|
||||
</div>
|
||||
|
||||
<div class="relative">
|
||||
<div class="absolute left-1/2 transform -translate-x-1/2 h-full w-1 timeline-line"></div>
|
||||
|
||||
<div class="space-y-12">
|
||||
<div class="flex items-center">
|
||||
<div class="flex-1 text-right pr-8">
|
||||
<div class="glass-effect rounded-xl p-6 inline-block text-left">
|
||||
<div class="text-sm text-gray-400 mb-2">2024年Q3及之前</div>
|
||||
<h3 class="text-xl font-bold mb-2">市场培育期</h3>
|
||||
<p class="text-gray-400">关注GB200需求，Rubin尚在打样阶段</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="relative z-10 w-12 h-12 bg-blue-500 rounded-full flex items-center justify-center">
|
||||
<i class="fas fa-seedling text-white"></i>
|
||||
</div>
|
||||
<div class="flex-1 pl-8"></div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="flex-1 pr-8"></div>
|
||||
<div class="relative z-10 w-12 h-12 bg-purple-500 rounded-full flex items-center justify-center">
|
||||
<i class="fas fa-fire text-white"></i>
|
||||
</div>
|
||||
<div class="flex-1 pl-8">
|
||||
<div class="glass-effect rounded-xl p-6 inline-block">
|
||||
<div class="text-sm text-gray-400 mb-2">2024年10月21日</div>
|
||||
<h3 class="text-xl font-bold mb-2">概念引爆</h3>
|
||||
<p class="text-gray-400">台媒爆料Rubin采用M9材料，Q布、HVLP4、钻针成紧缺环节</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="flex-1 text-right pr-8">
|
||||
<div class="glass-effect rounded-xl p-6 inline-block text-left">
|
||||
<div class="text-sm text-gray-400 mb-2">2024年10-11月</div>
|
||||
<h3 class="text-xl font-bold mb-2">机构密集发声</h3>
|
||||
<p class="text-gray-400">国金、中信、广发等发布研报，板块到"超配时间点"</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="relative z-10 w-12 h-12 bg-pink-500 rounded-full flex items-center justify-center">
|
||||
<i class="fas fa-chart-line text-white"></i>
|
||||
</div>
|
||||
<div class="flex-1 pl-8"></div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="flex-1 pr-8"></div>
|
||||
<div class="relative z-10 w-12 h-12 bg-yellow-500 rounded-full flex items-center justify-center">
|
||||
<i class="fas fa-clock text-white"></i>
|
||||
</div>
|
||||
<div class="flex-1 pl-8">
|
||||
<div class="glass-effect rounded-xl p-6 inline-block">
|
||||
<div class="text-sm text-gray-400 mb-2">2024年11月底</div>
|
||||
<h3 class="text-xl font-bold mb-2">关键评估节点</h3>
|
||||
<p class="text-gray-400">Switch tray是否采用M9的评估结果</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="flex-1 text-right pr-8">
|
||||
<div class="glass-effect rounded-xl p-6 inline-block text-left">
|
||||
<div class="text-sm text-gray-400 mb-2">2025年H2-2026年</div>
|
||||
<h3 class="text-xl font-bold mb-2">量产兑现期</h3>
|
||||
<p class="text-gray-400">Rubin大规模量产，M9产业链迎来业绩高峰</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="relative z-10 w-12 h-12 bg-green-500 rounded-full flex items-center justify-center">
|
||||
<i class="fas fa-trophy text-white"></i>
|
||||
</div>
|
||||
<div class="flex-1 pl-8"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Industry Chain Section -->
|
||||
<section id="industry" class="py-20 px-6">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center mb-12">
|
||||
<h2 class="text-4xl font-bold mb-4">产业链深度剖析</h2>
|
||||
<p class="text-xl text-gray-400">从上游材料到下游设备的全景图谱</p>
|
||||
</div>
|
||||
|
||||
<div class="grid md:grid-cols-2 lg:grid-cols-4 gap-6 mb-12">
|
||||
<div class="glass-effect rounded-2xl p-6 card-hover">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-lg font-bold">Q布（石英布）</h3>
|
||||
<span class="px-3 py-1 bg-red-500/20 text-red-400 rounded-full text-xs">极度紧缺</span>
|
||||
</div>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">菲利华</span>
|
||||
<span class="text-green-400">全球龙一</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">中材科技</span>
|
||||
<span class="text-blue-400">电子布满贯</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6 card-hover">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-lg font-bold">HVLP4铜箔</h3>
|
||||
<span class="px-3 py-1 bg-orange-500/20 text-orange-400 rounded-full text-xs">高度紧缺</span>
|
||||
</div>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">德福科技</span>
|
||||
<span class="text-green-400">全球龙二</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">铜冠铜箔</span>
|
||||
<span class="text-blue-400">进度稍慢</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6 card-hover">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-lg font-bold">钻针</h3>
|
||||
<span class="px-3 py-1 bg-red-500/20 text-red-400 rounded-full text-xs">最紧缺</span>
|
||||
</div>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">鼎泰高科</span>
|
||||
<span class="text-green-400">全球龙一</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">需求变化</span>
|
||||
<span class="text-yellow-400">5倍提升</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6 card-hover">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-lg font-bold">M9 CCL</h3>
|
||||
<span class="px-3 py-1 bg-purple-500/20 text-purple-400 rounded-full text-xs">核心环节</span>
|
||||
</div>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">生益科技</span>
|
||||
<span class="text-green-400">大陆唯一</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span class="text-gray-400">南亚新材</span>
|
||||
<span class="text-blue-400">技术领先</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="grid md:grid-cols-3 gap-8">
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-microchip mr-3 text-blue-400"></i>
|
||||
PCB制造
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">胜宏科技</h4>
|
||||
<p class="text-sm text-gray-400 mb-2">AI PCB龙头，当前英伟达业务敞口最大</p>
|
||||
<div class="flex items-center text-xs">
|
||||
<span class="px-2 py-1 bg-blue-500/20 text-blue-400 rounded">GB200核心供应商</span>
|
||||
<span class="ml-2 text-gray-500">60%+份额预期</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">沪电股份</h4>
|
||||
<p class="text-sm text-gray-400 mb-2">正交背板核心预期</p>
|
||||
<div class="flex items-center text-xs">
|
||||
<span class="px-2 py-1 bg-purple-500/20 text-purple-400 rounded">Rubin Ultra 50%份额</span>
|
||||
<span class="ml-2 text-gray-500">再造一个沪电</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-tools mr-3 text-purple-400"></i>
|
||||
PCB设备
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">大族数控</h4>
|
||||
<p class="text-sm text-gray-400">CCD背钻机替代海外竞品</p>
|
||||
<div class="flex items-center text-xs mt-2">
|
||||
<span class="text-green-400">市场份额持续提升</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">芯基微装</h4>
|
||||
<p class="text-sm text-gray-400">直写光刻技术领先</p>
|
||||
<div class="flex items-center text-xs mt-2">
|
||||
<span class="text-blue-400">覆盖PCB全产品市场</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-vial mr-3 text-pink-400"></i>
|
||||
其他材料
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">碳氢树脂</h4>
|
||||
<p class="text-sm text-gray-400">东材科技 - M9树脂批量供货</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">球形硅微粉</h4>
|
||||
<p class="text-sm text-gray-400">联瑞新材 - 用量翻倍增长</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">低介电电子布</h4>
|
||||
<p class="text-sm text-gray-400">宏和科技、国际复材布局</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Stocks Table Section -->
|
||||
<section id="stocks" class="py-20 px-6 bg-gray-900/50">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center mb-12">
|
||||
<h2 class="text-4xl font-bold mb-4">核心标的全览</h2>
|
||||
<p class="text-xl text-gray-400">产业链各环节关键公司数据对比</p>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6">
|
||||
<div class="mb-6 flex flex-wrap gap-3">
|
||||
<button onclick="filterCategory('all')" class="px-4 py-2 bg-blue-500 text-white rounded-lg hover:bg-blue-600 transition">
|
||||
全部
|
||||
</button>
|
||||
<button onclick="filterCategory('AI服务器相关')" class="px-4 py-2 glass-effect rounded-lg hover:bg-white/20 transition">
|
||||
AI服务器
|
||||
</button>
|
||||
<button onclick="filterCategory('覆铜板')" class="px-4 py-2 glass-effect rounded-lg hover:bg-white/20 transition">
|
||||
覆铜板
|
||||
</button>
|
||||
<button onclick="filterCategory('HVL')" class="px-4 py-2 glass-effect rounded-lg hover:bg-white/20 transition">
|
||||
HVLP铜箔
|
||||
</button>
|
||||
<button onclick="filterCategory('PCB耗材')" class="px-4 py-2 glass-effect rounded-lg hover:bg-white/20 transition">
|
||||
PCB耗材
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div class="overflow-x-auto scroll-container">
|
||||
<table class="w-full text-sm">
|
||||
<thead>
|
||||
<tr class="border-b border-gray-700">
|
||||
<th class="text-left py-3 px-4">股票</th>
|
||||
<th class="text-left py-3 px-4">分类</th>
|
||||
<th class="text-left py-3 px-4">项目/规模</th>
|
||||
<th class="text-left py-3 px-4">产业链位置</th>
|
||||
<th class="text-left py-3 px-4">核心亮点</th>
|
||||
<th class="text-left py-3 px-4">资料来源</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody id="stocksTableBody">
|
||||
<!-- 表格数据将通过JavaScript动态生成 -->
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 推荐组合 -->
|
||||
<div class="mt-12 grid md:grid-cols-3 gap-6">
|
||||
<div class="glass-effect rounded-2xl p-6 border-l-4 border-green-400">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-xl font-bold">首选推荐</h3>
|
||||
<i class="fas fa-star text-yellow-400"></i>
|
||||
</div>
|
||||
<p class="text-gray-400 mb-4">逻辑最纯粹，弹性最大</p>
|
||||
<div class="space-y-2">
|
||||
<div class="flex items-center justify-between">
|
||||
<span>鼎泰高科</span>
|
||||
<span class="text-green-400 text-sm">钻针全球龙一</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span>菲利华</span>
|
||||
<span class="text-green-400 text-sm">Q布全球龙一</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6 border-l-4 border-blue-400">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-xl font-bold">稳健配置</h3>
|
||||
<i class="fas fa-shield-alt text-blue-400"></i>
|
||||
</div>
|
||||
<p class="text-gray-400 mb-4">确定性高，份额稳固</p>
|
||||
<div class="space-y-2">
|
||||
<div class="flex items-center justify-between">
|
||||
<span>生益科技</span>
|
||||
<span class="text-blue-400 text-sm">英伟达CCL核心</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span>胜宏科技</span>
|
||||
<span class="text-blue-400 text-sm">AI PCB龙头</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-6 border-l-4 border-purple-400">
|
||||
<div class="flex items-center justify-between mb-4">
|
||||
<h3 class="text-xl font-bold">高弹性标的</h3>
|
||||
<i class="fas fa-rocket text-purple-400"></i>
|
||||
</div>
|
||||
<p class="text-gray-400 mb-4">想象空间大，兑现较晚</p>
|
||||
<div class="space-y-2">
|
||||
<div class="flex items-center justify-between">
|
||||
<span>沪电股份</span>
|
||||
<span class="text-purple-400 text-sm">正交背板预期</span>
|
||||
</div>
|
||||
<div class="flex items-center justify-between">
|
||||
<span>德福科技</span>
|
||||
<span class="text-purple-400 text-sm">HVLP4领先</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Risks Section -->
|
||||
<section id="risks" class="py-20 px-6">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center mb-12">
|
||||
<h2 class="text-4xl font-bold mb-4">潜在风险与挑战</h2>
|
||||
<p class="text-xl text-gray-400">投资决策必须考虑的关键因素</p>
|
||||
</div>
|
||||
|
||||
<div class="grid md:grid-cols-2 gap-8">
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-exclamation-triangle mr-3 text-yellow-400"></i>
|
||||
技术风险
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">M9材料加工难度高</h4>
|
||||
<p class="text-sm text-gray-400">Q布硬度高、钻针寿命短，影响PCB生产良率和成本</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">技术替代风险</h4>
|
||||
<p class="text-sm text-gray-400">mSAP工艺、CoWoP封装等颠覆性技术的潜在冲击</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-chart-line mr-3 text-red-400"></i>
|
||||
商业化风险
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">需求递延风险</h4>
|
||||
<p class="text-sm text-gray-400">宏观经济下行或AI应用落地不及预期</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">成本压力</h4>
|
||||
<p class="text-sm text-gray-400">M9全产业链升级抬高服务器成本</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-globe mr-3 text-blue-400"></i>
|
||||
政策与竞争风险
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">地缘政治风险</h4>
|
||||
<p class="text-sm text-gray-400">PCB供应链可能受贸易摩擦冲击</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">日企竞争压力</h4>
|
||||
<p class="text-sm text-gray-400">日本在高端铜箔、钻针领域仍具领先优势</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="glass-effect rounded-2xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 flex items-center">
|
||||
<i class="fas fa-info-circle mr-3 text-purple-400"></i>
|
||||
信息验证风险
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">时间差矛盾</h4>
|
||||
<p class="text-sm text-gray-400">千亿空间是远景，当前GB300订单疲软</p>
|
||||
</div>
|
||||
<div class="p-4 bg-gray-800/50 rounded-xl">
|
||||
<h4 class="font-semibold mb-2">份额不确定性</h4>
|
||||
<p class="text-sm text-gray-400">各厂商份额仍在激烈争夺中</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Footer -->
|
||||
<footer class="py-12 px-6 border-t border-gray-800">
|
||||
<div class="max-w-7xl mx-auto text-center">
|
||||
<p class="text-gray-400 mb-4">数据来源：新闻、路演、专家访谈、上市公司公告</p>
|
||||
<p class="text-sm text-gray-500">投资有风险，本页面仅供参考不构成投资建议</p>
|
||||
<div class="mt-6 flex justify-center space-x-6">
|
||||
<a href="#" class="text-gray-400 hover:text-white transition">
|
||||
<i class="fab fa-github text-xl"></i>
|
||||
</a>
|
||||
<a href="#" class="text-gray-400 hover:text-white transition">
|
||||
<i class="fab fa-twitter text-xl"></i>
|
||||
</a>
|
||||
<a href="#" class="text-gray-400 hover:text-white transition">
|
||||
<i class="fab fa-linkedin text-xl"></i>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<script>
|
||||
// 股票数据
|
||||
const stocksData = [
|
||||
{stock: '鹏鼎控股', category: 'AI服务器相关', project: 'PCB：350亿元/99.64%', industry: 'AI服务器', chain: 'HD升级至16~20L水平，已切入全球知名服务器客户供应链', source: '互动'},
|
||||
{stock: '沪电股份', category: 'AI服务器相关', project: 'PCB：128亿元/96.23%', industry: 'AI服务器', chain: 'AI服务器和HPC相关PCB占比约31%', source: '调研'},
|
||||
{stock: '景旺电子', category: 'AI服务器相关', project: 'PCB：120亿元/94.67%', industry: 'AI服务器', chain: '在AI服务器领域已有批量订单出货', source: '互动'},
|
||||
{stock: '深南电路', category: 'AI服务器相关', project: 'PCB：105亿元/58.6%', industry: 'AI服务器', chain: '重点布局数据中心（含服务器）', source: '调研'},
|
||||
{stock: '胜宏科技', category: 'AI服务器相关', project: 'PCB：100亿元/93.66%', industry: 'AI服务器', chain: '推出高阶HDI、高频高速PCB，部分产品已批量供货', source: '互动'},
|
||||
{stock: '生益科技', category: '覆铜板', project: '覆铜板：147.91亿元/72.55%', industry: '覆铜板', chain: '英伟达三大CCL之一，大陆唯一', source: '—'},
|
||||
{stock: '德福科技', category: 'HVL', project: 'HVL铜箔研究的技术突破', industry: 'HVL', chain: '批量出货HVL前三代，第四代送样验证中', source: '互动'},
|
||||
{stock: '鼎泰高科', category: 'PCB耗材', project: 'PCB钻针全球销量市占率26.5%', industry: 'PCB耗材', chain: '全球PCB钻针龙头，月产能9400万支', source: '研报/互动'},
|
||||
{stock: '菲利华', category: '低介电电子布', project: 'Low DK/CTE高端领域布局', industry: '低介电电子布', chain: '全球Q布龙头', source: '公告/研报'},
|
||||
{stock: '东材科技', category: '碳氢树脂', project: '5200吨高频高速特种树脂项目', industry: '碳氢树脂', chain: '国内碳氢树脂龙头，M9树脂批量供货', source: '互动/纪要'},
|
||||
];
|
||||
|
||||
// 初始化表格
|
||||
function initTable() {
|
||||
const tbody = document.getElementById('stocksTableBody');
|
||||
tbody.innerHTML = '';
|
||||
|
||||
stocksData.forEach(stock => {
|
||||
const row = document.createElement('tr');
|
||||
row.className = 'border-b border-gray-800 hover:bg-gray-800/50 transition';
|
||||
row.innerHTML = `
|
||||
<td class="py-3 px-4 font-semibold">${stock.stock}</td>
|
||||
<td class="py-3 px-4">
|
||||
<span class="px-2 py-1 bg-blue-500/20 text-blue-400 rounded text-xs">
|
||||
${stock.category}
|
||||
</span>
|
||||
</td>
|
||||
<td class="py-3 px-4 text-gray-400">${stock.project}</td>
|
||||
<td class="py-3 px-4 text-gray-400">${stock.chain}</td>
|
||||
<td class="py-3 px-4 text-gray-400">${stock.industry}</td>
|
||||
<td class="py-3 px-4">
|
||||
<span class="text-xs px-2 py-1 bg-gray-700 rounded">${stock.source}</span>
|
||||
</td>
|
||||
`;
|
||||
tbody.appendChild(row);
|
||||
});
|
||||
}
|
||||
|
||||
// 筛选功能
|
||||
function filterCategory(category) {
|
||||
const rows = document.querySelectorAll('#stocksTableBody tr');
|
||||
rows.forEach(row => {
|
||||
if (category === 'all') {
|
||||
row.style.display = '';
|
||||
} else {
|
||||
const categoryCell = row.querySelector('td:nth-child(2)').textContent;
|
||||
row.style.display = categoryCell.includes(category) ? '' : 'none';
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
// 初始化趋势图表
|
||||
function initTrendChart() {
|
||||
const ctx = document.getElementById('trendChart');
|
||||
if (ctx) {
|
||||
new Chart(ctx, {
|
||||
type: 'line',
|
||||
data: {
|
||||
labels: ['2024Q1', '2024Q2', '2024Q3', '2024Q4', '2025Q1', '2025Q2', '2025Q3', '2025Q4', '2026Q1'],
|
||||
datasets: [{
|
||||
label: 'AI PCB市场规模(亿元)',
|
||||
data: [100, 150, 200, 280, 350, 420, 500, 600, 693],
|
||||
borderColor: '#3b82f6',
|
||||
backgroundColor: 'rgba(59, 130, 246, 0.1)',
|
||||
tension: 0.4,
|
||||
fill: true
|
||||
}, {
|
||||
label: 'M9材料渗透率(%)',
|
||||
data: [0, 0, 5, 15, 30, 45, 60, 75, 85],
|
||||
borderColor: '#8b5cf6',
|
||||
backgroundColor: 'rgba(139, 92, 246, 0.1)',
|
||||
tension: 0.4,
|
||||
fill: true
|
||||
}]
|
||||
},
|
||||
options: {
|
||||
responsive: true,
|
||||
maintainAspectRatio: false,
|
||||
plugins: {
|
||||
legend: {
|
||||
labels: {
|
||||
color: '#fff'
|
||||
}
|
||||
}
|
||||
},
|
||||
scales: {
|
||||
x: {
|
||||
grid: {
|
||||
color: 'rgba(255, 255, 255, 0.1)'
|
||||
},
|
||||
ticks: {
|
||||
color: '#fff'
|
||||
}
|
||||
},
|
||||
y: {
|
||||
grid: {
|
||||
color: 'rgba(255, 255, 255, 0.1)'
|
||||
},
|
||||
ticks: {
|
||||
color: '#fff'
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 页面加载完成后初始化
|
||||
document.addEventListener('DOMContentLoaded', function() {
|
||||
initTable();
|
||||
initTrendChart();
|
||||
|
||||
// 平滑滚动
|
||||
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
|
||||
anchor.addEventListener('click', function (e) {
|
||||
e.preventDefault();
|
||||
const target = document.querySelector(this.getAttribute('href'));
|
||||
if (target) {
|
||||
target.scrollIntoView({
|
||||
behavior: 'smooth',
|
||||
block: 'start'
|
||||
});
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
// 数字动画效果
|
||||
const observerOptions = {
|
||||
threshold: 0.5
|
||||
};
|
||||
|
||||
const observer = new IntersectionObserver((entries) => {
|
||||
entries.forEach(entry => {
|
||||
if (entry.isIntersecting) {
|
||||
entry.target.classList.add('number-animate');
|
||||
}
|
||||
});
|
||||
}, observerOptions);
|
||||
|
||||
document.querySelectorAll('.glass-effect').forEach(el => {
|
||||
observer.observe(el);
|
||||
});
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,545 +0,0 @@
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>AI服务器钽电容 - 概念深度解析</title>
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap');
|
||||
|
||||
* {
|
||||
font-family: 'Inter', sans-serif;
|
||||
}
|
||||
|
||||
.gradient-text {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
-webkit-background-clip: text;
|
||||
-webkit-text-fill-color: transparent;
|
||||
background-clip: text;
|
||||
}
|
||||
|
||||
.hero-gradient {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
}
|
||||
|
||||
.card-hover {
|
||||
transition: all 0.3s ease;
|
||||
}
|
||||
|
||||
.card-hover:hover {
|
||||
transform: translateY(-5px);
|
||||
box-shadow: 0 20px 40px rgba(0,0,0,0.1);
|
||||
}
|
||||
|
||||
.timeline-line {
|
||||
background: linear-gradient(180deg, #667eea 0%, #764ba2 100%);
|
||||
}
|
||||
|
||||
.pulse-animation {
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0% { transform: scale(1); }
|
||||
50% { transform: scale(1.05); }
|
||||
100% { transform: scale(1); }
|
||||
}
|
||||
|
||||
.table-scroll {
|
||||
overflow-x: auto;
|
||||
}
|
||||
|
||||
.table-scroll::-webkit-scrollbar {
|
||||
height: 8px;
|
||||
}
|
||||
|
||||
.table-scroll::-webkit-scrollbar-track {
|
||||
background: #f1f1f1;
|
||||
border-radius: 10px;
|
||||
}
|
||||
|
||||
.table-scroll::-webkit-scrollbar-thumb {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
border-radius: 10px;
|
||||
}
|
||||
|
||||
.highlight-cell {
|
||||
background: linear-gradient(135deg, rgba(102, 126, 234, 0.1) 0%, rgba(118, 75, 162, 0.1) 100%);
|
||||
}
|
||||
|
||||
.floating {
|
||||
animation: floating 3s ease-in-out infinite;
|
||||
}
|
||||
|
||||
@keyframes floating {
|
||||
0% { transform: translateY(0px); }
|
||||
50% { transform: translateY(-10px); }
|
||||
100% { transform: translateY(0px); }
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body class="bg-gray-50">
|
||||
<!-- Hero Section -->
|
||||
<div class="hero-gradient text-white py-20 px-4">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="text-center">
|
||||
<h1 class="text-5xl md:text-6xl font-bold mb-4 floating">
|
||||
AI服务器钽电容
|
||||
</h1>
|
||||
<p class="text-xl md:text-2xl mb-8 opacity-90">算力革命背后的隐形冠军</p>
|
||||
<div class="flex flex-wrap justify-center gap-4 text-sm">
|
||||
<div class="bg-white/20 backdrop-blur-sm rounded-full px-6 py-2">
|
||||
<i class="fas fa-chart-line mr-2"></i>景气上行周期
|
||||
</div>
|
||||
<div class="bg-white/20 backdrop-blur-sm rounded-full px-6 py-2">
|
||||
<i class="fas fa-microchip mr-2"></i>国产替代加速
|
||||
</div>
|
||||
<div class="bg-white/20 backdrop-blur-sm rounded-full px-6 py-2">
|
||||
<i class="fas fa-rocket mr-2"></i>量价齐升
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Key Stats -->
|
||||
<div class="py-12 px-4 bg-white shadow-lg">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<div class="grid grid-cols-2 md:grid-cols-4 gap-6">
|
||||
<div class="text-center card-hover p-6 rounded-lg">
|
||||
<div class="text-3xl md:text-4xl font-bold gradient-text">20-30%</div>
|
||||
<div class="text-gray-600 mt-2">KEMET涨幅</div>
|
||||
</div>
|
||||
<div class="text-center card-hover p-6 rounded-lg">
|
||||
<div class="text-3xl md:text-4xl font-bold gradient-text">2.1万</div>
|
||||
<div class="text-gray-600 mt-2">单柜用量(颗)</div>
|
||||
</div>
|
||||
<div class="text-center card-hover p-6 rounded-lg">
|
||||
<div class="text-3xl md:text-4xl font-bold gradient-text">46%</div>
|
||||
<div class="text-gray-600 mt-2">KEMET市占率</div>
|
||||
</div>
|
||||
<div class="text-center card-hover p-6 rounded-lg">
|
||||
<div class="text-3xl md:text-4xl font-bold gradient-text">38周</div>
|
||||
<div class="text-gray-600 mt-2">最长交期</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Timeline Section -->
|
||||
<div class="py-16 px-4">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">概念发展时间线</h2>
|
||||
<div class="relative">
|
||||
<div class="timeline-line absolute left-1/2 transform -translate-x-1/2 h-full w-1"></div>
|
||||
|
||||
<div class="space-y-12">
|
||||
<div class="flex items-center">
|
||||
<div class="w-full md:w-1/2 pr-8 text-right">
|
||||
<div class="bg-white p-6 rounded-lg shadow-lg card-hover">
|
||||
<div class="text-sm text-gray-500">2024年及以前</div>
|
||||
<div class="text-lg font-semibold mt-2">技术布局期</div>
|
||||
<div class="text-gray-600 mt-2">钽电容主要应用于军工、高端消费电子。顺络电子等厂商自2009年起已开始技术布局。</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="absolute left-1/2 transform -translate-x-1/2 w-4 h-4 bg-purple-600 rounded-full"></div>
|
||||
<div class="w-full md:w-1/2 pl-8"></div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="w-full md:w-1/2 pr-8"></div>
|
||||
<div class="absolute left-1/2 transform -translate-x-1/2 w-4 h-4 bg-purple-600 rounded-full"></div>
|
||||
<div class="w-full md:w-1/2 pl-8">
|
||||
<div class="bg-white p-6 rounded-lg shadow-lg card-hover">
|
||||
<div class="text-sm text-gray-500">2025年10月22日</div>
|
||||
<div class="text-lg font-semibold mt-2">引爆点：KEMET大幅涨价</div>
|
||||
<div class="text-gray-600 mt-2">国巨旗下KEMET发布涨价函，上调聚合物钽电容价格20%-30%，为年内第二次涨价。</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center">
|
||||
<div class="w-full md:w-1/2 pr-8 text-right">
|
||||
<div class="bg-white p-6 rounded-lg shadow-lg card-hover">
|
||||
<div class="text-sm text-gray-500">未来预期</div>
|
||||
<div class="text-lg font-semibold mt-2">景气周期开启</div>
|
||||
<div class="text-gray-600 mt-2">产业链涨价传导，国产替代加速，市场规模有望突破千亿。</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="absolute left-1/2 transform -translate-x-1/2 w-4 h-4 bg-purple-600 rounded-full pulse-animation"></div>
|
||||
<div class="w-full md:w-1/2 pl-8"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Core Logic Section -->
|
||||
<div class="py-16 px-4 bg-gradient-to-br from-purple-50 to-indigo-50">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">核心逻辑与市场分析</h2>
|
||||
|
||||
<div class="grid md:grid-cols-3 gap-8">
|
||||
<div class="bg-white rounded-xl shadow-xl p-8 card-hover">
|
||||
<div class="text-4xl mb-4 text-purple-600">
|
||||
<i class="fas fa-bolt"></i>
|
||||
</div>
|
||||
<h3 class="text-xl font-bold mb-4">技术刚需</h3>
|
||||
<p class="text-gray-600">AI算力指数级增长要求供电系统极致稳定，钽电容凭借"单位体积电容值最高、ESR最低"的特性成为最优解。</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-xl p-8 card-hover">
|
||||
<div class="text-4xl mb-4 text-indigo-600">
|
||||
<i class="fas fa-chart-area"></i>
|
||||
</div>
|
||||
<h3 class="text-xl font-bold mb-4">需求爆发</h3>
|
||||
<p class="text-gray-600">单台AI服务器用量远超传统，NVL72机柜约需2.1万颗，仅英伟达26年就能带来5亿美元增量。</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-xl p-8 card-hover">
|
||||
<div class="text-4xl mb-4 text-pink-600">
|
||||
<i class="fas fa-cubes"></i>
|
||||
</div>
|
||||
<h3 class="text-xl font-bold mb-4">供给瓶颈</h3>
|
||||
<p class="text-gray-600">CR4占全球80%+份额，交期延长至38周+，上游钽粉仅450-500吨，扩产周期长。</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Market Sentiment -->
|
||||
<div class="mt-12 bg-white rounded-xl shadow-xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6">市场情绪与预期差</h3>
|
||||
<div class="grid md:grid-cols-2 gap-8">
|
||||
<div>
|
||||
<h4 class="font-semibold text-lg mb-4 text-green-600">当前热度</h4>
|
||||
<ul class="space-y-2 text-gray-600">
|
||||
<li><i class="fas fa-check-circle text-green-500 mr-2"></i>产业数据支撑（涨价、交期）</li>
|
||||
<li><i class="fas fa-check-circle text-green-500 mr-2"></i>研究机构持续发声</li>
|
||||
<li><i class="fas fa-check-circle text-green-500 mr-2"></i>产业链公司前景乐观</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div>
|
||||
<h4 class="font-semibold text-lg mb-4 text-orange-600">关键预期差</h4>
|
||||
<ul class="space-y-2 text-gray-600">
|
||||
<li><i class="fas fa-exclamation-circle text-orange-500 mr-2"></i>市场认知滞后，关注度不足</li>
|
||||
<li><i class="fas fa-exclamation-circle text-orange-500 mr-2"></i>国产替代10倍成长空间</li>
|
||||
<li><i class="fas fa-exclamation-circle text-orange-500 mr-2"></i>市场空间预期存在上修可能</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Industry Chain -->
|
||||
<div class="py-16 px-4">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">产业链图谱</h2>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-xl p-8">
|
||||
<div class="space-y-8">
|
||||
<!-- Upstream -->
|
||||
<div class="flex items-center">
|
||||
<div class="w-32 text-center">
|
||||
<div class="bg-purple-100 text-purple-700 rounded-lg p-4">
|
||||
<i class="fas fa-mountain text-2xl"></i>
|
||||
<div class="font-semibold mt-2">上游</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex-1 mx-4">
|
||||
<div class="bg-gray-100 rounded-lg p-4">
|
||||
<div class="font-semibold mb-2">原材料：钽矿开采</div>
|
||||
<div class="text-sm text-gray-600">关键瓶颈：全球80%+产量集中在非洲、巴西，多为伴生矿</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex-1 mx-4">
|
||||
<div class="bg-gray-100 rounded-lg p-4">
|
||||
<div class="font-semibold mb-2">钽粉/钽丝制造</div>
|
||||
<div class="text-sm text-gray-600">全球市场：450-500吨/年，扩产困难</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex justify-center">
|
||||
<i class="fas fa-arrow-down text-3xl text-gray-400"></i>
|
||||
</div>
|
||||
|
||||
<!-- Midstream -->
|
||||
<div class="flex items-center">
|
||||
<div class="w-32 text-center">
|
||||
<div class="bg-indigo-100 text-indigo-700 rounded-lg p-4">
|
||||
<i class="fas fa-industry text-2xl"></i>
|
||||
<div class="font-semibold mt-2">中游</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex-1 mx-4">
|
||||
<div class="bg-gray-100 rounded-lg p-4">
|
||||
<div class="font-semibold mb-2">钽电容设计制造</div>
|
||||
<div class="text-sm text-gray-600">市场格局：CR4占80%+（KEMET、AVX、Vishay、松下）</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex justify-center">
|
||||
<i class="fas fa-arrow-down text-3xl text-gray-400"></i>
|
||||
</div>
|
||||
|
||||
<!-- Downstream -->
|
||||
<div class="flex items-center">
|
||||
<div class="w-32 text-center">
|
||||
<div class="bg-pink-100 text-pink-700 rounded-lg p-4">
|
||||
<i class="fas fa-server text-2xl"></i>
|
||||
<div class="font-semibold mt-2">下游</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex-1 mx-4">
|
||||
<div class="bg-gray-100 rounded-lg p-4">
|
||||
<div class="font-semibold mb-2">AI服务器/数据中心</div>
|
||||
<div class="text-sm text-gray-600">核心应用：GPU/CPU供电系统、电源模块</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex-1 mx-4">
|
||||
<div class="bg-gray-100 rounded-lg p-4">
|
||||
<div class="font-semibold mb-2">互联网巨头/云服务商</div>
|
||||
<div class="text-sm text-gray-600">主要客户：字节、阿里、腾讯、AWS、Google等</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Stock Data Table -->
|
||||
<div class="py-16 px-4 bg-gradient-to-br from-gray-50 to-gray-100">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">核心公司股票数据</h2>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-xl overflow-hidden">
|
||||
<div class="table-scroll">
|
||||
<table class="w-full">
|
||||
<thead class="bg-gradient-to-r from-purple-600 to-indigo-600 text-white">
|
||||
<tr>
|
||||
<th class="px-6 py-4 text-left">股票名称</th>
|
||||
<th class="px-6 py-4 text-left">分类</th>
|
||||
<th class="px-6 py-4 text-left">业务相关</th>
|
||||
<th class="px-6 py-4 text-left">信源</th>
|
||||
<th class="px-6 py-4 text-left">投资逻辑</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold highlight-cell">东方钽业</td>
|
||||
<td class="px-6 py-4">原料</td>
|
||||
<td class="px-6 py-4 text-sm">电容器级钽粉国内市占率50%，全球20%；钽丝全球市占率50%+</td>
|
||||
<td class="px-6 py-4">公告</td>
|
||||
<td class="px-6 py-4 text-sm text-purple-600">产业链瓶颈环节，直接受益涨价</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold highlight-cell">顺络电子</td>
|
||||
<td class="px-6 py-4">产品</td>
|
||||
<td class="px-6 py-4 text-sm">为全球顶级客户开发新型钽电容，已为客户配套供应</td>
|
||||
<td class="px-6 py-4">调研</td>
|
||||
<td class="px-6 py-4 text-sm text-purple-600">国产替代先锋，10倍成长空间</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold">宏达电子</td>
|
||||
<td class="px-6 py-4">产品</td>
|
||||
<td class="px-6 py-4 text-sm">国内高可靠钽电容器生产领域龙头企业</td>
|
||||
<td class="px-6 py-4">半年报</td>
|
||||
<td class="px-6 py-4 text-sm">军工技术转化，高可靠领域优势</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold">火炬电子</td>
|
||||
<td class="px-6 py-4">产品</td>
|
||||
<td class="px-6 py-4 text-sm">公司成熟产品包括钽电容器，工业级已进入AF7供应链</td>
|
||||
<td class="px-6 py-4">半年报</td>
|
||||
<td class="px-6 py-4 text-sm">产品矩阵丰富，多领域布局</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold">振华科技</td>
|
||||
<td class="px-6 py-4">产品</td>
|
||||
<td class="px-6 py-4 text-sm">民用钽电容器在国产服务器中开始供货；片式钽电解电容产能4.8亿只/年</td>
|
||||
<td class="px-6 py-4">调研/公告</td>
|
||||
<td class="px-6 py-4 text-sm">产能规模优势，国产服务器突破</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold">北方华创</td>
|
||||
<td class="px-6 py-4">产品</td>
|
||||
<td class="px-6 py-4 text-sm">完成抗振动高能钽电容技术攻关和高分子钽电容产品研发</td>
|
||||
<td class="px-6 py-4">半年报</td>
|
||||
<td class="px-6 py-4 text-sm">技术突破，高端产品布局</td>
|
||||
</tr>
|
||||
<tr class="hover:bg-gray-50 transition-colors">
|
||||
<td class="px-6 py-4 font-semibold">杰普特</td>
|
||||
<td class="px-6 py-4">设备</td>
|
||||
<td class="px-6 py-4 text-sm">钽电容双工位智能焊接设备研制成功</td>
|
||||
<td class="px-6 py-4">半年报</td>
|
||||
<td class="px-6 py-4 text-sm">设备供应商，受益于产能扩张</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Investment Insights -->
|
||||
<div class="py-16 px-4 bg-gradient-to-br from-indigo-50 to-purple-50">
|
||||
<div class="max-w-7xl mx-auto">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">投资启示与风险提示</h2>
|
||||
|
||||
<div class="grid md:grid-cols-2 gap-8">
|
||||
<div class="bg-white rounded-xl shadow-xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 text-green-600">
|
||||
<i class="fas fa-lightbulb mr-2"></i>投资启示
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-green-600 font-bold">1</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">上游最优</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">东方钽业作为产业链瓶颈，受益最直接，攻守兼备</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-green-600 font-bold">2</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">国产替代加速</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">顺络电子等厂商份额从5%向30%进发，10倍成长空间</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-green-600 font-bold">3</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">景气周期持续</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">供需矛盾短期难解，涨价有望持续传导</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6 text-red-600">
|
||||
<i class="fas fa-exclamation-triangle mr-2"></i>风险提示
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-red-600 font-bold">1</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">需求波动风险</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">AI服务器出货量不及预期，高盛预测存在分歧</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-red-600 font-bold">2</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">技术替代风险</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">高端MLCC等技术进步可能部分替代钽电容</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-1">
|
||||
<span class="text-red-600 font-bold">3</span>
|
||||
</div>
|
||||
<div class="ml-4">
|
||||
<h4 class="font-semibold">竞争格局变化</h4>
|
||||
<p class="text-gray-600 text-sm mt-1">海外巨头大规模扩产可能缓解供给紧张</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Tracking Metrics -->
|
||||
<div class="mt-12 bg-white rounded-xl shadow-xl p-8">
|
||||
<h3 class="text-2xl font-bold mb-6">关键跟踪指标</h3>
|
||||
<div class="grid md:grid-cols-4 gap-4">
|
||||
<div class="bg-gray-50 rounded-lg p-4">
|
||||
<div class="font-semibold text-purple-600">行业指标</div>
|
||||
<ul class="text-sm text-gray-600 mt-2 space-y-1">
|
||||
<li>• KEMET/AVX报价</li>
|
||||
<li>• 产品交货周期</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="bg-gray-50 rounded-lg p-4">
|
||||
<div class="font-semibold text-indigo-600">需求端</div>
|
||||
<ul class="text-sm text-gray-600 mt-2 space-y-1">
|
||||
<li>• AI服务器出货量</li>
|
||||
<li>• GB300机柜数据</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="bg-gray-50 rounded-lg p-4">
|
||||
<div class="font-semibold text-pink-600">东方钽业</div>
|
||||
<ul class="text-sm text-gray-600 mt-2 space-y-1">
|
||||
<li>• 钽粉/钽丝销量</li>
|
||||
<li>• 产品均价及毛利率</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="bg-gray-50 rounded-lg p-4">
|
||||
<div class="font-semibold text-green-600">顺络电子</div>
|
||||
<ul class="text-sm text-gray-600 mt-2 space-y-1">
|
||||
<li>• 数据中心收入增速</li>
|
||||
<li>• 客户认证进展</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Footer -->
|
||||
<footer class="bg-gray-900 text-white py-12 px-4">
|
||||
<div class="max-w-7xl mx-auto text-center">
|
||||
<p class="text-gray-400">© 2025 AI服务器钽电容概念深度解析</p>
|
||||
<p class="text-gray-500 text-sm mt-2">数据来源：公开新闻、路演纪要、研究报告</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<script>
|
||||
// Add smooth scrolling
|
||||
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
|
||||
anchor.addEventListener('click', function (e) {
|
||||
e.preventDefault();
|
||||
document.querySelector(this.getAttribute('href')).scrollIntoView({
|
||||
behavior: 'smooth'
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
// Add animation on scroll
|
||||
const observerOptions = {
|
||||
threshold: 0.1,
|
||||
rootMargin: '0px 0px -100px 0px'
|
||||
};
|
||||
|
||||
const observer = new IntersectionObserver((entries) => {
|
||||
entries.forEach(entry => {
|
||||
if (entry.isIntersecting) {
|
||||
entry.target.style.opacity = '1';
|
||||
entry.target.style.transform = 'translateY(0)';
|
||||
}
|
||||
});
|
||||
}, observerOptions);
|
||||
|
||||
document.querySelectorAll('.card-hover').forEach(el => {
|
||||
el.style.opacity = '0';
|
||||
el.style.transform = 'translateY(20px)';
|
||||
el.style.transition = 'opacity 0.6s ease, transform 0.6s ease';
|
||||
observer.observe(el);
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,808 +0,0 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>KIMI概念股深度分析报告</title>
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap');
|
||||
|
||||
* {
|
||||
font-family: 'Inter', sans-serif;
|
||||
}
|
||||
|
||||
.gradient-bg {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
}
|
||||
|
||||
.card-hover {
|
||||
transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
|
||||
}
|
||||
|
||||
.card-hover:hover {
|
||||
transform: translateY(-5px);
|
||||
box-shadow: 0 20px 40px rgba(0,0,0,0.1);
|
||||
}
|
||||
|
||||
.timeline-line {
|
||||
background: linear-gradient(180deg, #667eea 0%, #764ba2 100%);
|
||||
}
|
||||
|
||||
.pulse-dot {
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0% {
|
||||
box-shadow: 0 0 0 0 rgba(102, 126, 234, 0.7);
|
||||
}
|
||||
70% {
|
||||
box-shadow: 0 0 0 10px rgba(102, 126, 234, 0);
|
||||
}
|
||||
100% {
|
||||
box-shadow: 0 0 0 0 rgba(102, 126, 234, 0);
|
||||
}
|
||||
}
|
||||
|
||||
.glass-effect {
|
||||
background: rgba(255, 255, 255, 0.95);
|
||||
backdrop-filter: blur(10px);
|
||||
border: 1px solid rgba(255, 255, 255, 0.18);
|
||||
}
|
||||
|
||||
.stock-table {
|
||||
display: block;
|
||||
overflow-x: auto;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.stock-table table {
|
||||
width: 100%;
|
||||
min-width: 1200px;
|
||||
}
|
||||
|
||||
.fade-in {
|
||||
animation: fadeIn 0.6s ease-in;
|
||||
}
|
||||
|
||||
@keyframes fadeIn {
|
||||
from { opacity: 0; transform: translateY(20px); }
|
||||
to { opacity: 1; transform: translateY(0); }
|
||||
}
|
||||
|
||||
.gradient-text {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
-webkit-background-clip: text;
|
||||
-webkit-text-fill-color: transparent;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body class="bg-gray-50">
|
||||
<!-- Hero Section -->
|
||||
<div class="gradient-bg text-white">
|
||||
<div class="container mx-auto px-4 py-16">
|
||||
<div class="text-center fade-in">
|
||||
<h1 class="text-5xl font-bold mb-4">KIMI概念股深度分析</h1>
|
||||
<p class="text-xl opacity-90">从用户爆发到Agent革命的技术范式投资机遇</p>
|
||||
<div class="mt-8 flex justify-center space-x-6">
|
||||
<div class="text-center">
|
||||
<div class="text-3xl font-bold">25+</div>
|
||||
<div class="text-sm opacity-75">关联公司</div>
|
||||
</div>
|
||||
<div class="text-center">
|
||||
<div class="text-3xl font-bold">2</div>
|
||||
<div class="text-sm opacity-75">发展阶段</div>
|
||||
</div>
|
||||
<div class="text-center">
|
||||
<div class="text-3xl font-bold">500万+</div>
|
||||
<div class="text-sm opacity-75">月活用户</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Navigation Tabs -->
|
||||
<div class="sticky top-0 z-40 glass-effect shadow-lg">
|
||||
<div class="container mx-auto px-4">
|
||||
<div class="flex space-x-1 overflow-x-auto py-2">
|
||||
<button onclick="scrollToSection('overview')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-chart-line mr-2"></i>核心概览
|
||||
</button>
|
||||
<button onclick="scrollToSection('timeline')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-clock mr-2"></i>发展历程
|
||||
</button>
|
||||
<button onclick="scrollToSection('logic')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-brain mr-2"></i>核心逻辑
|
||||
</button>
|
||||
<button onclick="scrollToSection('catalyst')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-rocket mr-2"></i>催化因素
|
||||
</button>
|
||||
<button onclick="scrollToSection('industry')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-network-wired mr-2"></i>产业链
|
||||
</button>
|
||||
<button onclick="scrollToSection('risks')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-exclamation-triangle mr-2"></i>风险提示
|
||||
</button>
|
||||
<button onclick="scrollToSection('conclusion')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-lightbulb mr-2"></i>投资启示
|
||||
</button>
|
||||
<button onclick="scrollToSection('stocks')" class="px-4 py-2 rounded-lg hover:bg-purple-100 transition whitespace-nowrap">
|
||||
<i class="fas fa-table mr-2"></i>概念股
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Main Content -->
|
||||
<div class="container mx-auto px-4 py-8">
|
||||
<!-- 核心概览 -->
|
||||
<section id="overview" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">核心观点摘要</h2>
|
||||
<div class="bg-white rounded-xl shadow-lg p-6 card-hover">
|
||||
<div class="prose max-w-none">
|
||||
<p class="text-lg leading-relaxed text-gray-700">
|
||||
<span class="font-semibold text-purple-600">Kimi概念已从2024年依靠"长文本+低成本"驱动的用户增长主题，</span>
|
||||
演变为2025年由"OnlineRL新范式+Agent落地"引领的技术革命主线。其核心驱动力在于Kimi K2模型所开启的模型能力自我进化潜力，以及由此带来的从云端算力到终端应用的全面产业机遇，未来潜力巨大但当前商业化落地节奏是关键观察点。
|
||||
</p>
|
||||
</div>
|
||||
<div class="mt-6 grid grid-cols-1 md:grid-cols-3 gap-4">
|
||||
<div class="bg-purple-50 rounded-lg p-4 text-center">
|
||||
<i class="fas fa-users text-3xl text-purple-600 mb-2"></i>
|
||||
<h3 class="font-semibold">用户爆发</h3>
|
||||
<p class="text-sm text-gray-600">2024年DAU达58万</p>
|
||||
</div>
|
||||
<div class="bg-blue-50 rounded-lg p-4 text-center">
|
||||
<i class="fas fa-robot text-3xl text-blue-600 mb-2"></i>
|
||||
<h3 class="font-semibold">技术突破</h3>
|
||||
<p class="text-sm text-gray-600">K2引入OnlineRL新范式</p>
|
||||
</div>
|
||||
<div class="bg-green-50 rounded-lg p-4 text-center">
|
||||
<i class="fas fa-chart-line text-3xl text-green-600 mb-2"></i>
|
||||
<h3 class="font-semibold">生态扩张</h3>
|
||||
<p class="text-sm text-gray-600">日均Token处理86.6亿</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 发展历程 -->
|
||||
<section id="timeline" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">概念发展历程</h2>
|
||||
<div class="relative">
|
||||
<div class="absolute left-8 top-0 bottom-0 w-0.5 timeline-line"></div>
|
||||
|
||||
<!-- 第一阶段 -->
|
||||
<div class="relative flex items-start mb-8">
|
||||
<div class="absolute left-6 w-5 h-5 bg-purple-600 rounded-full pulse-dot"></div>
|
||||
<div class="ml-16 bg-white rounded-lg shadow-lg p-6 card-hover flex-1">
|
||||
<h3 class="text-xl font-bold text-purple-600 mb-2">第一阶段：用户爆发与长文本出圈</h3>
|
||||
<p class="text-sm text-gray-500 mb-3">2024年2月-3月</p>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-check-circle text-green-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">核心突破</p>
|
||||
<p class="text-gray-600">无损压缩长文本技术，解决海量信息处理痛点</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-chart-bar text-blue-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">用户数据</p>
|
||||
<p class="text-gray-600">DAU峰值58万，微信生态深度绑定形成护城河</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-dollar-sign text-yellow-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">成本优势</p>
|
||||
<p class="text-gray-600">API价格为GPT-4的1/20，性价比颠覆</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 第二阶段 -->
|
||||
<div class="relative flex items-start">
|
||||
<div class="absolute left-6 w-5 h-5 bg-purple-600 rounded-full pulse-dot"></div>
|
||||
<div class="ml-16 bg-white rounded-lg shadow-lg p-6 card-hover flex-1">
|
||||
<h3 class="text-xl font-bold text-purple-600 mb-2">第二阶段：技术范式突破与Agent革命</h3>
|
||||
<p class="text-sm text-gray-500 mb-3">2025年7月至今</p>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-atom text-purple-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">范式革命</p>
|
||||
<p class="text-gray-600">K2引入OnlineRL新范式，理论能力无上限</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-bolt text-yellow-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">性能飞跃</p>
|
||||
<p class="text-gray-600">K2高速版输出速度提升至40 Tokens/s，API半价推广</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<i class="fas fa-desktop text-blue-500 mt-1 mr-3"></i>
|
||||
<div>
|
||||
<p class="font-semibold">Agent进化</p>
|
||||
<p class="text-gray-600">发布"OK Computer"模式，实现复杂任务自动化</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 核心逻辑 -->
|
||||
<section id="logic" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">核心逻辑与市场认知</h2>
|
||||
<div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
|
||||
<div class="bg-white rounded-xl shadow-lg p-6 card-hover">
|
||||
<h3 class="text-xl font-bold mb-4 text-purple-600">
|
||||
<i class="fas fa-cogs mr-2"></i>核心驱动力
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="border-l-4 border-purple-500 pl-4">
|
||||
<h4 class="font-semibold mb-1">工程化胜利</h4>
|
||||
<p class="text-gray-600 text-sm">无损压缩、滑动窗口注意力等技术解决特定场景痛点</p>
|
||||
</div>
|
||||
<div class="border-l-4 border-blue-500 pl-4">
|
||||
<h4 class="font-semibold mb-1">范式革命</h4>
|
||||
<p class="text-gray-600 text-sm">OnlineRL实现模型能力自我进化，理论上无上限</p>
|
||||
</div>
|
||||
<div class="border-l-4 border-green-500 pl-4">
|
||||
<h4 class="font-semibold mb-1">生态构建</h4>
|
||||
<p class="text-gray-600 text-sm">开源、降价、API推广快速构建开发者生态</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="bg-white rounded-xl shadow-lg p-6 card-hover">
|
||||
<h3 class="text-xl font-bold mb-4 text-purple-600">
|
||||
<i class="fas fa-chart-pie mr-2"></i>市场预期差
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="bg-yellow-50 rounded-lg p-4">
|
||||
<h4 class="font-semibold text-yellow-800 mb-2">
|
||||
<i class="fas fa-exclamation-circle mr-2"></i>被忽略的关键点
|
||||
</h4>
|
||||
<p class="text-gray-700 text-sm">微信生态的场景卡位优势构成强大用户粘性护城河</p>
|
||||
</div>
|
||||
<div class="bg-red-50 rounded-lg p-4">
|
||||
<h4 class="font-semibold text-red-800 mb-2">
|
||||
<i class="fas fa-balance-scale mr-2"></i>现实与预期
|
||||
</h4>
|
||||
<p class="text-gray-700 text-sm">K2当前仅为preview版本，测评效果意义有限</p>
|
||||
</div>
|
||||
<div class="bg-blue-50 rounded-lg p-4">
|
||||
<h4 class="font-semibold text-blue-800 mb-2">
|
||||
<i class="fas fa-microchip mr-2"></i>供给催化
|
||||
</h4>
|
||||
<p class="text-gray-700 text-sm">H20芯片解禁是连接技术突破与商业变现的关键桥梁</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 催化因素 -->
|
||||
<section id="catalyst" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">关键催化剂与发展路径</h2>
|
||||
<div class="bg-white rounded-xl shadow-lg p-6">
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
||||
<div>
|
||||
<h3 class="text-xl font-bold mb-4 text-purple-600">
|
||||
<i class="fas fa-fire mr-2"></i>近期催化剂（3-6个月）
|
||||
</h3>
|
||||
<div class="space-y-3">
|
||||
<div class="flex items-center p-3 bg-gradient-to-r from-purple-50 to-blue-50 rounded-lg">
|
||||
<div class="w-10 h-10 bg-purple-600 text-white rounded-full flex items-center justify-center mr-3">
|
||||
<i class="fas fa-flask"></i>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">OK Computer测试反馈</p>
|
||||
<p class="text-sm text-gray-600">Agent灰度测试效果与用户案例</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-center p-3 bg-gradient-to-r from-blue-50 to-green-50 rounded-lg">
|
||||
<div class="w-10 h-10 bg-blue-600 text-white rounded-full flex items-center justify-center mr-3">
|
||||
<i class="fas fa-code"></i>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">开发者生态数据</p>
|
||||
<p class="text-sm text-gray-600">K2高速版API调用量与活跃度</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-center p-3 bg-gradient-to-r from-green-50 to-yellow-50 rounded-lg">
|
||||
<div class="w-10 h-10 bg-green-600 text-white rounded-full flex items-center justify-center mr-3">
|
||||
<i class="fas fa-server"></i>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">H20规模化部署</p>
|
||||
<p class="text-sm text-gray-600">算力供给问题解决进度</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<h3 class="text-xl font-bold mb-4 text-purple-600">
|
||||
<i class="fas fa-route mr-2"></i>长期发展路径
|
||||
</h3>
|
||||
<div class="relative">
|
||||
<div class="absolute left-4 top-0 bottom-0 w-0.5 bg-gradient-to-b from-purple-400 to-blue-400"></div>
|
||||
<div class="space-y-4">
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-purple-100 rounded-full flex items-center justify-center mr-3 z-10">
|
||||
<span class="text-xs font-bold text-purple-600">1</span>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">基座模型成熟</p>
|
||||
<p class="text-sm text-gray-600">K2模型完善与开发者生态预热</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-blue-100 rounded-full flex items-center justify-center mr-3 z-10">
|
||||
<span class="text-xs font-bold text-blue-600">2</span>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">Agent场景爆发</p>
|
||||
<p class="text-sm text-gray-600">金融、企业服务等高价值场景落地</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-start">
|
||||
<div class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center mr-3 z-10">
|
||||
<span class="text-xs font-bold text-green-600">3</span>
|
||||
</div>
|
||||
<div>
|
||||
<p class="font-semibold">AGI雏形平台化</p>
|
||||
<p class="text-sm text-gray-600">超级智能体平台形成</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 产业链分析 -->
|
||||
<section id="industry" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">产业链与核心公司</h2>
|
||||
<div class="bg-white rounded-xl shadow-lg p-6">
|
||||
<div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
|
||||
<!-- 上游 -->
|
||||
<div class="border-2 border-purple-200 rounded-lg p-4">
|
||||
<h3 class="font-bold text-lg mb-3 text-purple-600">
|
||||
<i class="fas fa-cloud-upload-alt mr-2"></i>上游：算力与基础设施
|
||||
</h3>
|
||||
<div class="space-y-2">
|
||||
<div class="p-2 bg-purple-50 rounded">
|
||||
<p class="font-semibold text-sm">算力提供</p>
|
||||
<p class="text-xs text-gray-600">润泽科技、亚康股份、润建股份</p>
|
||||
</div>
|
||||
<div class="p-2 bg-purple-50 rounded">
|
||||
<p class="font-semibold text-sm">AI芯片</p>
|
||||
<p class="text-xs text-gray-600">寒武纪、海光信息</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 中游 -->
|
||||
<div class="border-2 border-blue-200 rounded-lg p-4">
|
||||
<h3 class="font-bold text-lg mb-3 text-blue-600">
|
||||
<i class="fas fa-layer-group mr-2"></i>中游：模型与平台
|
||||
</h3>
|
||||
<div class="space-y-2">
|
||||
<div class="p-2 bg-blue-50 rounded">
|
||||
<p class="font-semibold text-sm">核心模型</p>
|
||||
<p class="text-xs text-gray-600">月之暗面（未上市）</p>
|
||||
</div>
|
||||
<div class="p-2 bg-blue-50 rounded">
|
||||
<p class="font-semibold text-sm">模型管理</p>
|
||||
<p class="text-xs text-gray-600">普元信息、润和软件</p>
|
||||
</div>
|
||||
<div class="p-2 bg-blue-50 rounded">
|
||||
<p class="font-semibold text-sm">云计算</p>
|
||||
<p class="text-xs text-gray-600">金山云、深信服、优刻得</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 下游 -->
|
||||
<div class="border-2 border-green-200 rounded-lg p-4">
|
||||
<h3 class="font-bold text-lg mb-3 text-green-600">
|
||||
<i class="fas fa-download mr-2"></i>下游：应用与数据
|
||||
</h3>
|
||||
<div class="space-y-2">
|
||||
<div class="p-2 bg-green-50 rounded">
|
||||
<p class="font-semibold text-sm">通用应用</p>
|
||||
<p class="text-xs text-gray-600">金山办公、福昕软件、万兴科技</p>
|
||||
</div>
|
||||
<div class="p-2 bg-green-50 rounded">
|
||||
<p class="font-semibold text-sm">垂直应用</p>
|
||||
<p class="text-xs text-gray-600">恒生电子、同花顺、卫宁健康</p>
|
||||
</div>
|
||||
<div class="p-2 bg-green-50 rounded">
|
||||
<p class="font-semibold text-sm">数据内容</p>
|
||||
<p class="text-xs text-gray-600">掌阅科技、华策影视、中国科传</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 核心玩家对比 -->
|
||||
<div class="mt-6 p-4 bg-gray-50 rounded-lg">
|
||||
<h3 class="font-bold text-lg mb-3">核心玩家对比分析</h3>
|
||||
<div class="overflow-x-auto">
|
||||
<table class="w-full text-sm">
|
||||
<thead>
|
||||
<tr class="border-b">
|
||||
<th class="text-left py-2">公司</th>
|
||||
<th class="text-left py-2">优势</th>
|
||||
<th class="text-left py-2">劣势/风险</th>
|
||||
<th class="text-left py-2">推荐评级</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="border-b">
|
||||
<td class="py-2 font-semibold">金山云</td>
|
||||
<td class="py-2">逻辑最纯粹，直接受益Token处理量增长</td>
|
||||
<td class="py-2">云服务竞争激烈</td>
|
||||
<td class="py-2"><span class="text-green-600 font-bold">★★★★★</span></td>
|
||||
</tr>
|
||||
<tr class="border-b">
|
||||
<td class="py-2 font-semibold">掌阅科技</td>
|
||||
<td class="py-2">场景契合度高，用户价值提升明确</td>
|
||||
<td class="py-2">需时间验证商业化</td>
|
||||
<td class="py-2"><span class="text-green-600 font-bold">★★★★☆</span></td>
|
||||
</tr>
|
||||
<tr class="border-b">
|
||||
<td class="py-2 font-semibold">汉得信息</td>
|
||||
<td class="py-2">企业服务市场空间大，客户粘性高</td>
|
||||
<td class="py-2">落地周期长，不确定性高</td>
|
||||
<td class="py-2"><span class="text-yellow-600 font-bold">★★★☆☆</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="py-2 font-semibold">九安医疗</td>
|
||||
<td class="py-2">股权投资，估值提升直接受益</td>
|
||||
<td class="py-2">与主业协同弱，流动性风险</td>
|
||||
<td class="py-2"><span class="text-yellow-600 font-bold">★★★☆☆</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 风险提示 -->
|
||||
<section id="risks" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">潜在风险与挑战</h2>
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4">
|
||||
<div class="bg-red-50 border border-red-200 rounded-lg p-4">
|
||||
<div class="text-red-600 text-2xl mb-2">
|
||||
<i class="fas fa-microscope"></i>
|
||||
</div>
|
||||
<h3 class="font-bold mb-2">技术风险</h3>
|
||||
<p class="text-sm text-gray-600">OnlineRL范式实际效果待验证，多模态能力滞后</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-yellow-50 border border-yellow-200 rounded-lg p-4">
|
||||
<div class="text-yellow-600 text-2xl mb-2">
|
||||
<i class="fas fa-coins"></i>
|
||||
</div>
|
||||
<h3 class="font-bold mb-2">商业化风险</h3>
|
||||
<p class="text-sm text-gray-600">以价换量策略侵蚀利润，应用落地慢于预期</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-blue-50 border border-blue-200 rounded-lg p-4">
|
||||
<div class="text-blue-600 text-2xl mb-2">
|
||||
<i class="fas fa-shield-alt"></i>
|
||||
</div>
|
||||
<h3 class="font-bold mb-2">政策风险</h3>
|
||||
<p class="text-sm text-gray-600">巨头竞争白热化，地缘政治影响芯片供应</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-purple-50 border border-purple-200 rounded-lg p-4">
|
||||
<div class="text-purple-600 text-2xl mb-2">
|
||||
<i class="fas fa-info-circle"></i>
|
||||
</div>
|
||||
<h3 class="font-bold mb-2">信息风险</h3>
|
||||
<p class="text-sm text-gray-600">宏大叙事与现实差距，市场过度乐观预期</p>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 投资启示 -->
|
||||
<section id="conclusion" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">综合结论与投资启示</h2>
|
||||
<div class="bg-gradient-to-r from-purple-600 to-blue-600 text-white rounded-xl shadow-lg p-8">
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
||||
<div>
|
||||
<h3 class="text-2xl font-bold mb-4">
|
||||
<i class="fas fa-bullseye mr-2"></i>综合结论
|
||||
</h3>
|
||||
<p class="text-lg leading-relaxed">
|
||||
Kimi概念股正经历从"主题炒作"向"基本面驱动"的关键过渡期。当前阶段，投资价值将严格取决于技术范式革命能否转化为可规模化的商业价值。
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<h3 class="text-2xl font-bold mb-4">
|
||||
<i class="fas fa-star mr-2"></i>重点跟踪指标
|
||||
</h3>
|
||||
<ul class="space-y-2">
|
||||
<li class="flex items-center">
|
||||
<i class="fas fa-check-circle mr-2"></i>
|
||||
<span>Kimi官方API调用量与收入</span>
|
||||
</li>
|
||||
<li class="flex items-center">
|
||||
<i class="fas fa-check-circle mr-2"></i>
|
||||
<span>Agent企业用户数与ARPU值</span>
|
||||
</li>
|
||||
<li class="flex items-center">
|
||||
<i class="fas fa-check-circle mr-2"></i>
|
||||
<span>云厂商AI相关收入增速</span>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="mt-6 p-4 bg-white bg-opacity-20 rounded-lg">
|
||||
<p class="text-center text-xl font-bold">
|
||||
<i class="fas fa-award mr-2"></i>
|
||||
最具投资价值环节：云计算 > AI中间件 > 垂直应用
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 股票数据表格 -->
|
||||
<section id="stocks" class="mb-12 fade-in">
|
||||
<h2 class="text-3xl font-bold mb-6 gradient-text">KIMI概念股全览</h2>
|
||||
<div class="bg-white rounded-xl shadow-lg p-6 stock-table">
|
||||
<table class="w-full">
|
||||
<thead class="bg-gradient-to-r from-purple-600 to-blue-600 text-white">
|
||||
<tr>
|
||||
<th class="px-4 py-3 text-left">股票代码</th>
|
||||
<th class="px-4 py-3 text-left">股票名称</th>
|
||||
<th class="px-4 py-3 text-left">分类</th>
|
||||
<th class="px-4 py-3 text-left">相关性</th>
|
||||
<th class="px-4 py-3 text-left">消息来源</th>
|
||||
<th class="px-4 py-3 text-left">详细说明</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">002432</td>
|
||||
<td class="px-4 py-3 font-semibold">九安医疗</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-green-100 text-green-800 rounded text-xs">参股</span></td>
|
||||
<td class="px-4 py-3 text-sm">投资额等值于3000万美元</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">公司参与了月之暗面相关主体的投资</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300133</td>
|
||||
<td class="px-4 py-3 font-semibold">华策影视</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-blue-100 text-blue-800 rounded text-xs">合作</span></td>
|
||||
<td class="px-4 py-3 text-sm">推进AI在影视领域的应用</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">与Kimi等科技公司合作推进AI技术应用</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">603533</td>
|
||||
<td class="px-4 py-3 font-semibold">掌阅科技</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-blue-100 text-blue-800 rounded text-xs">合作</span></td>
|
||||
<td class="px-4 py-3 text-sm">接入Kimi对话助手</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">市场传闻</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">按场景需求选择最强AI大模型支撑</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">603006</td>
|
||||
<td class="px-4 py-3 font-semibold">捷顺科技</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-blue-100 text-blue-800 rounded text-xs">合作</span></td>
|
||||
<td class="px-4 py-3 text-sm">子公司与循环智能战略合作</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">公开资料</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">顺易通与杨植麟首创新企业达成合作</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">603239</td>
|
||||
<td class="px-4 py-3 font-semibold">超讯通信</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-blue-100 text-blue-800 rounded text-xs">合作</span></td>
|
||||
<td class="px-4 py-3 text-sm">灵犀妙笔AI支持长文本</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">官微</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">打通Kimi chat链路支持长文本处理</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300781</td>
|
||||
<td class="px-4 py-3 font-semibold">因赛集团</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-blue-100 text-blue-800 rounded text-xs">合作</span></td>
|
||||
<td class="px-4 py-3 text-sm">API接口调用合作</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">自研模型与Kimi等大模型API合作</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">688229</td>
|
||||
<td class="px-4 py-3 font-semibold">博睿数据</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">运维领域智能应用</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">Bonree ONE平台有望接入Kimi实现自动报告</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">170170</td>
|
||||
<td class="px-4 py-3 font-semibold">汉得信息</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">AIGC平台对接测试</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">已开启AIGC平台对接测试，探索落地</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">301171</td>
|
||||
<td class="px-4 py-3 font-semibold">易点天下</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">解决复杂图文生成</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">已接入Kimi Chat，解决长视频脚本生成</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300494</td>
|
||||
<td class="px-4 py-3 font-semibold">盛天网络</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">音乐社交APP接入</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">给麦APP已接入Kimi等模型</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300624</td>
|
||||
<td class="px-4 py-3 font-semibold">万兴科技</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">接入文本大模型</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">已接入Kimi文本大模型</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300352</td>
|
||||
<td class="px-4 py-3 font-semibold">北信源</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">接入优秀大模型</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">已接入Kimi等国内优秀大模型</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300155</td>
|
||||
<td class="px-4 py-3 font-semibold">国投智能</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">内容检测平台</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">支持对kimi生成式文本的检测</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300339</td>
|
||||
<td class="px-4 py-3 font-semibold">润和软件</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">AIRUNS平台适配</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">AIRUNS平台已适配Kimi K2模型</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">603825</td>
|
||||
<td class="px-4 py-3 font-semibold">华扬联众</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">内部技术平台联动</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">联动Kimi等实现高效协同</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">688118</td>
|
||||
<td class="px-4 py-3 font-semibold">普元信息</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">模型管理系统</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">支持快速接入Kimi K2等主流模型</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300634</td>
|
||||
<td class="px-4 py-3 font-semibold">彩讯股份</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-yellow-100 text-yellow-800 rounded text-xs">对接测试</span></td>
|
||||
<td class="px-4 py-3 text-sm">AIBOX平台评测</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">互动</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">对不同应用场景进行对比评测</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">300442</td>
|
||||
<td class="px-4 py-3 font-semibold">润泽科技</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-purple-100 text-purple-800 rounded text-xs">算力</span></td>
|
||||
<td class="px-4 py-3 text-sm">与火山引擎协同</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">公开资料</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">为Kimi提供技术支持的火山引擎协同</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">301085</td>
|
||||
<td class="px-4 py-3 font-semibold">亚康股份</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-purple-100 text-purple-800 rounded text-xs">算力</span></td>
|
||||
<td class="px-4 py-3 text-sm">硬件支持及运维</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">公开资料</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">为火山引擎提供硬件支持和运维服务</td>
|
||||
</tr>
|
||||
<tr class="border-b hover:bg-purple-50 transition">
|
||||
<td class="px-4 py-3 font-mono text-sm">002929</td>
|
||||
<td class="px-4 py-3 font-semibold">润建股份</td>
|
||||
<td class="px-4 py-3"><span class="px-2 py-1 bg-purple-100 text-purple-800 rounded text-xs">算力</span></td>
|
||||
<td class="px-4 py-3 text-sm">提供算力支持</td>
|
||||
<td class="px-4 py-3"><span class="text-gray-500">市场传闻</span></td>
|
||||
<td class="px-4 py-3 text-sm text-gray-600">通过子公司万象云谷提供算力支持</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</section>
|
||||
</div>
|
||||
|
||||
<!-- Footer -->
|
||||
<footer class="bg-gray-800 text-white py-8 mt-16">
|
||||
<div class="container mx-auto px-4 text-center">
|
||||
<p class="mb-2">© 2025 KIMI概念股深度分析报告</p>
|
||||
<p class="text-sm text-gray-400">数据来源：公开信息、路演报告、新闻资讯 | 投资有风险，入市需谨慎</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<script>
|
||||
// Smooth scroll to section
|
||||
function scrollToSection(sectionId) {
|
||||
const section = document.getElementById(sectionId);
|
||||
if (section) {
|
||||
section.scrollIntoView({ behavior: 'smooth', block: 'start' });
|
||||
}
|
||||
}
|
||||
|
||||
// Add animation on scroll
|
||||
const observerOptions = {
|
||||
threshold: 0.1,
|
||||
rootMargin: '0px 0px -50px 0px'
|
||||
};
|
||||
|
||||
const observer = new IntersectionObserver((entries) => {
|
||||
entries.forEach(entry => {
|
||||
if (entry.isIntersecting) {
|
||||
entry.target.style.opacity = '1';
|
||||
entry.target.style.transform = 'translateY(0)';
|
||||
}
|
||||
});
|
||||
}, observerOptions);
|
||||
|
||||
document.querySelectorAll('.fade-in').forEach(el => {
|
||||
el.style.opacity = '0';
|
||||
el.style.transform = 'translateY(20px)';
|
||||
el.style.transition = 'all 0.6s ease-out';
|
||||
observer.observe(el);
|
||||
});
|
||||
|
||||
// Add hover effect to table rows
|
||||
document.querySelectorAll('tbody tr').forEach(row => {
|
||||
row.addEventListener('mouseenter', function() {
|
||||
this.style.transform = 'scale(1.01)';
|
||||
this.style.transition = 'all 0.2s ease';
|
||||
});
|
||||
row.addEventListener('mouseleave', function() {
|
||||
this.style.transform = 'scale(1)';
|
||||
});
|
||||
});
|
||||
|
||||
// Dynamic date update
|
||||
const dateElements = document.querySelectorAll('.dynamic-date');
|
||||
const currentDate = new Date().toLocaleDateString('zh-CN');
|
||||
dateElements.forEach(el => {
|
||||
el.textContent = currentDate;
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,538 +0,0 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>SORA概念深度分析 - AI视频生成革命</title>
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link href="https://cdn.jsdelivr.net/npm/daisyui@4.4.19/dist/full.min.css" rel="stylesheet" type="text/css" />
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
|
||||
body { font-family: 'Inter', sans-serif; }
|
||||
|
||||
.gradient-bg {
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
}
|
||||
|
||||
.card-hover {
|
||||
transition: all 0.3s ease;
|
||||
}
|
||||
|
||||
.card-hover:hover {
|
||||
transform: translateY(-5px);
|
||||
box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
|
||||
}
|
||||
|
||||
.timeline-dot {
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0%, 100% { transform: scale(1); opacity: 1; }
|
||||
50% { transform: scale(1.1); opacity: 0.8; }
|
||||
}
|
||||
|
||||
.stock-row:hover {
|
||||
background-color: rgba(99, 102, 241, 0.05);
|
||||
transition: background-color 0.2s ease;
|
||||
}
|
||||
|
||||
.tab-active {
|
||||
border-bottom: 3px solid #6366f1;
|
||||
}
|
||||
|
||||
.chart-container {
|
||||
position: relative;
|
||||
height: 400px;
|
||||
margin: 20px 0;
|
||||
}
|
||||
|
||||
.floating-label {
|
||||
animation: float 3s ease-in-out infinite;
|
||||
}
|
||||
|
||||
@keyframes float {
|
||||
0%, 100% { transform: translateY(0px); }
|
||||
50% { transform: translateY(-10px); }
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body class="bg-gray-50">
|
||||
<!-- 顶部导航 -->
|
||||
<div class="navbar bg-base-100 shadow-lg">
|
||||
<div class="container mx-auto px-4">
|
||||
<div class="flex-1">
|
||||
<a href="#" class="btn btn-ghost normal-case text-xl">
|
||||
<i class="fas fa-rocket text-indigo-600 mr-2"></i>
|
||||
SORA概念分析
|
||||
</a>
|
||||
</div>
|
||||
<div class="flex-none">
|
||||
<div class="badge badge-info">更新时间: 2025年</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 主英雄区域 -->
|
||||
<section class="gradient-bg text-white py-20">
|
||||
<div class="container mx-auto px-4">
|
||||
<div class="flex flex-col lg:flex-row items-center">
|
||||
<div class="lg:w-1/2 mb-10 lg:mb-0">
|
||||
<h1 class="text-5xl font-bold mb-6">SORA概念</h1>
|
||||
<h2 class="text-2xl mb-4 opacity-90">AI视频生成的范式革命</h2>
|
||||
<p class="text-lg mb-8 opacity-80">从技术突破到商业化落地，SORA正在重塑内容创作的未来。探索Diffusion+Transformer架构带来的无限可能。</p>
|
||||
<div class="flex flex-wrap gap-4">
|
||||
<div class="stat">
|
||||
<div class="stat-title text-white opacity-80">发布时间</div>
|
||||
<div class="stat-value text-white">2024.02</div>
|
||||
</div>
|
||||
<div class="stat">
|
||||
<div class="stat-title text-white opacity-80">概念股</div>
|
||||
<div class="stat-value text-white">25+</div>
|
||||
</div>
|
||||
<div class="stat">
|
||||
<div class="stat-title text-white opacity-80">市场规模</div>
|
||||
<div class="stat-value text-white">千亿级</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lg:w-1/2 flex justify-center">
|
||||
<div class="floating-label">
|
||||
<div class="card w-96 bg-white text-gray-800 shadow-2xl">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl mb-4">
|
||||
<i class="fas fa-chart-line text-indigo-600"></i>
|
||||
核心驱动力
|
||||
</h3>
|
||||
<ul class="space-y-3">
|
||||
<li class="flex items-start">
|
||||
<i class="fas fa-check-circle text-green-500 mt-1 mr-2"></i>
|
||||
<div>
|
||||
<strong>Patch思想</strong>
|
||||
<p class="text-sm text-gray-600">时空视频块处理，统一高效</p>
|
||||
</div>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<i class="fas fa-check-circle text-green-500 mt-1 mr-2"></i>
|
||||
<div>
|
||||
<strong>架构创新</strong>
|
||||
<p class="text-sm text-gray-600">Diffusion + Transformer融合</p>
|
||||
</div>
|
||||
</li>
|
||||
<li class="flex items-start">
|
||||
<i class="fas fa-check-circle text-green-500 mt-1 mr-2"></i>
|
||||
<div>
|
||||
<strong>世界模拟器</strong>
|
||||
<p class="text-sm text-gray-600">通向AGI的关键路径</p>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 时间轴 -->
|
||||
<section class="py-16 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-history text-indigo-600 mr-2"></i>
|
||||
发展时间轴
|
||||
</h2>
|
||||
<div class="timeline">
|
||||
<div class="timeline-item">
|
||||
<div class="timeline-dot bg-indigo-600"></div>
|
||||
<div class="timeline-content card card-hover bg-indigo-50">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">2024年2月</h3>
|
||||
<p>OpenAI发布Sora模型演示，引发全球轰动，SORA概念初步形成</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="timeline-item">
|
||||
<div class="timeline-dot bg-purple-600"></div>
|
||||
<div class="timeline-content card card-hover bg-purple-50">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">2024年10月</h3>
|
||||
<p>Meta、谷歌、字节跳动等巨头密集发布AI视频模型，赛道景气度高</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="timeline-item">
|
||||
<div class="timeline-dot bg-pink-600"></div>
|
||||
<div class="timeline-content card card-hover bg-pink-50">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">2024年11月</h3>
|
||||
<p>Sora内测版本疑似泄露，市场解读为正式公测临近信号</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="timeline-item">
|
||||
<div class="timeline-dot bg-green-600"></div>
|
||||
<div class="timeline-content card card-hover bg-green-50">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">2024年12月</h3>
|
||||
<p>OpenAI正式向ChatGPT Plus和Pro用户开放Sora，开启商业化</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="timeline-item">
|
||||
<div class="timeline-dot bg-yellow-600"></div>
|
||||
<div class="timeline-content card card-hover bg-yellow-50">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">2025年10月</h3>
|
||||
<p>发布Sora 2模型及独立iOS社交应用，向内容生态平台演进</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 核心观点 -->
|
||||
<section class="py-16 bg-gray-100">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-lightbulb text-yellow-500 mr-2"></i>
|
||||
核心观点分析
|
||||
</h2>
|
||||
<div class="grid md:grid-cols-3 gap-6">
|
||||
<div class="card bg-white shadow-xl card-hover">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl mb-4">
|
||||
<i class="fas fa-rocket text-indigo-600"></i>
|
||||
技术范式革命
|
||||
</h3>
|
||||
<p>SORA实现了视频生成领域的根本性突破，Patch处理方式和Diffusion+Transformer架构解决了长期连贯性问题，展现出世界模拟器潜力。</p>
|
||||
<div class="badge badge-outline mt-4">10家券商一致看好</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card bg-white shadow-xl card-hover">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl mb-4">
|
||||
<i class="fas fa-exclamation-triangle text-yellow-600"></i>
|
||||
预期差分析
|
||||
</h3>
|
||||
<p>市场过于乐观忽视技术局限性：物理模拟不精确、算力成本高昂、国内外差距显著。个股纯度差异巨大，需仔细甄别。</p>
|
||||
<div class="badge badge-error mt-4">存在泡沫风险</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card bg-white shadow-xl card-hover">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-xl mb-4">
|
||||
<i class="fas fa-chart-line text-green-600"></i>
|
||||
商业化路径
|
||||
</h3>
|
||||
<p>从纯粹技术突破转向早期商业化，关注垂直场景应用和IP资源价值。Sora 2社交应用将验证C端生态可行性。</p>
|
||||
<div class="badge badge-success mt-4">成长确定性高</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 股票数据 -->
|
||||
<section class="py-16 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-table text-blue-600 mr-2"></i>
|
||||
SORA概念股全景图
|
||||
</h2>
|
||||
|
||||
<!-- 分类标签 -->
|
||||
<div class="tabs tabs-boxed mb-8 justify-center">
|
||||
<a class="tab tab-active" onclick="showCategory('all')">全部</a>
|
||||
<a class="tab" onclick="showCategory('文生视频')">文生视频</a>
|
||||
<a class="tab" onclick="showCategory('IP/版权')">IP/版权</a>
|
||||
<a class="tab" onclick="showCategory('电影')">电影</a>
|
||||
<a class="tab" onclick="showCategory('影视')">影视</a>
|
||||
<a class="tab" onclick="showCategory('短剧')">短剧</a>
|
||||
</div>
|
||||
|
||||
<!-- 表格 -->
|
||||
<div class="overflow-x-auto">
|
||||
<table class="table table-zebra w-full" id="stockTable">
|
||||
<thead>
|
||||
<tr class="bg-indigo-600 text-white">
|
||||
<th>股票名称</th>
|
||||
<th>分类</th>
|
||||
<th>核心项目/技术</th>
|
||||
<th>投资逻辑</th>
|
||||
<th>评级</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody id="stockTableBody">
|
||||
<!-- 数据将通过JavaScript填充 -->
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 产业链图谱 -->
|
||||
<section class="py-16 bg-gray-100">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-network-wired text-purple-600 mr-2"></i>
|
||||
产业链图谱
|
||||
</h2>
|
||||
<div class="grid lg:grid-cols-3 gap-6">
|
||||
<div class="card bg-gradient-to-br from-blue-500 to-blue-600 text-white">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl">
|
||||
<i class="fas fa-microchip"></i>
|
||||
上游：技术/算力层
|
||||
</h3>
|
||||
<p class="my-4">提供核心技术底座和算力基础设施</p>
|
||||
<ul class="space-y-2">
|
||||
<li>• OpenAI（核心算法）</li>
|
||||
<li>• 寒武纪（AI芯片）</li>
|
||||
<li>• 海光信息（算力支持）</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card bg-gradient-to-br from-purple-500 to-purple-600 text-white">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl">
|
||||
<i class="fas fa-tools"></i>
|
||||
中游：工具/平台层
|
||||
</h3>
|
||||
<p class="my-4">AI视频模型开发及应用平台</p>
|
||||
<ul class="space-y-2">
|
||||
<li>• 万兴科技（万兴天幕）</li>
|
||||
<li>• 昆仑万维（SkyReels）</li>
|
||||
<li>• 因赛集团（InsightGPT）</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card bg-gradient-to-br from-green-500 to-green-600 text-white">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl">
|
||||
<i class="fas fa-film"></i>
|
||||
下游：应用/IP/内容层
|
||||
</h3>
|
||||
<p class="my-4">内容创作与应用场景</p>
|
||||
<ul class="space-y-2">
|
||||
<li>• 中文在线（IP资源）</li>
|
||||
<li>• 芒果超媒（影视制作）</li>
|
||||
<li>• 掌阅科技（短剧平台）</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 风险提示 -->
|
||||
<section class="py-16 bg-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-shield-alt text-red-600 mr-2"></i>
|
||||
风险与挑战
|
||||
</h2>
|
||||
<div class="alert alert-warning shadow-lg mb-6">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" class="stroke-current shrink-0 h-6 w-6" fill="none" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
|
||||
</svg>
|
||||
<div>
|
||||
<h3 class="font-bold">技术风险</h3>
|
||||
<div class="text-sm">物理模拟瓶颈、算力成本高昂、生成效率不足是当前主要技术挑战。</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="alert alert-error shadow-lg mb-6">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" class="stroke-current shrink-0 h-6 w-6" fill="none" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z" />
|
||||
</svg>
|
||||
<div>
|
||||
<h3 class="font-bold">商业化风险</h3>
|
||||
<div class="text-sm">成本与定价平衡困难、版权伦理问题可能引发监管收紧。</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="alert alert-info shadow-lg">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" class="stroke-current shrink-0 h-6 w-6">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
|
||||
</svg>
|
||||
<div>
|
||||
<h3 class="font-bold">政策与竞争风险</h3>
|
||||
<div class="text-sm">中美技术博弈、高端芯片限制、行业竞争白热化。</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 投资启示 -->
|
||||
<section class="py-16 bg-gradient-to-r from-indigo-600 to-purple-600 text-white">
|
||||
<div class="container mx-auto px-4">
|
||||
<h2 class="text-3xl font-bold text-center mb-12">
|
||||
<i class="fas fa-coins text-yellow-400 mr-2"></i>
|
||||
投资启示
|
||||
</h2>
|
||||
<div class="grid md:grid-cols-2 gap-8">
|
||||
<div class="card bg-white/10 backdrop-blur-lg">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl mb-4">
|
||||
<i class="fas fa-star text-yellow-400"></i>
|
||||
最具投资价值方向
|
||||
</h3>
|
||||
<div class="space-y-4">
|
||||
<div class="flex items-center">
|
||||
<div class="w-12 h-12 bg-yellow-400 rounded-full flex items-center justify-center mr-4">
|
||||
<span class="text-black font-bold">1</span>
|
||||
</div>
|
||||
<div>
|
||||
<h4 class="font-semibold">垂直场景应用商</h4>
|
||||
<p class="text-sm opacity-80">因赛集团 - AI+营销护城河深厚</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="flex items-center">
|
||||
<div class="w-12 h-12 bg-yellow-400 rounded-full flex items-center justify-center mr-4">
|
||||
<span class="text-black font-bold">2</span>
|
||||
</div>
|
||||
<div>
|
||||
<h4 class="font-semibold">IP资源与数据提供商</h4>
|
||||
<p class="text-sm opacity-80">中文在线、视觉中国 - 稀缺数据资源</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card bg-white/10 backdrop-blur-lg">
|
||||
<div class="card-body">
|
||||
<h3 class="card-title text-2xl mb-4">
|
||||
<i class="fas fa-chart-line text-green-400"></i>
|
||||
关键跟踪指标
|
||||
</h3>
|
||||
<div class="space-y-2">
|
||||
<div class="badge badge-outline badge-lg m-1">Sora 2 DAU/MAU</div>
|
||||
<div class="badge badge-outline badge-lg m-1">视频生成质量对比</div>
|
||||
<div class="badge badge-outline badge-lg m-1">因赛AI收入占比</div>
|
||||
<div class="badge badge-outline badge-lg m-1">爆款AI短剧数量</div>
|
||||
<div class="badge badge-outline badge-lg m-1">制作成本下降幅度</div>
|
||||
<div class="badge badge-outline badge-lg m-1">IP变现效率</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="text-center mt-12">
|
||||
<div class="alert alert-success shadow-lg max-w-2xl mx-auto">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" class="stroke-current shrink-0 h-6 w-6" fill="none" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
|
||||
</svg>
|
||||
<div>
|
||||
<h3 class="font-bold">综合结论</h3>
|
||||
<div class="text-sm">SORA概念正从主题炒作过渡到商业化验证阶段，专注垂直场景和稀缺资源的公司将脱颖而出。</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 页脚 -->
|
||||
<footer class="footer footer-center p-10 bg-gray-900 text-white">
|
||||
<div>
|
||||
<p class="font-bold">
|
||||
SORA概念深度分析报告
|
||||
</p>
|
||||
<p>投资有风险，入市需谨慎</p>
|
||||
</div>
|
||||
<div>
|
||||
<p>Copyright © 2025 - All right reserved</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<script>
|
||||
// 股票数据
|
||||
const stockData = [
|
||||
{stock: '万兴科技', category: '文生视频', project: '万兴天幕2.0', logic: '基于万兴天幕2.0实现视频生成、音频生成等多样化创作需求', rating: 'buy'},
|
||||
{stock: '昆仑万维', category: '文生视频', project: 'SkyReels-V1', logic: '开源全球领先的SkyReels-V1视频生成模型', rating: 'buy'},
|
||||
{stock: '当虹科技', category: '文生视频', project: 'BlackEye', logic: '多模态视听大模型包含文生视频等功能', rating: 'hold'},
|
||||
{stock: '捷成股份', category: '文生视频', project: 'chatPV', logic: 'AI智能创作引擎已推出"文生视频"功能', rating: 'hold'},
|
||||
{stock: '因赛集团', category: '文生视频', project: '多智能体系统', logic: '优化文生视频等功能，深耕营销垂直领域', rating: 'strong-buy'},
|
||||
{stock: '信雅达', category: '文生视频', project: 'Pika（关联）', logic: '实控人之女创办Pika，直接对标Sora', rating: 'speculative'},
|
||||
{stock: '中文在线', category: 'IP/版权', project: '60TB正版数据', logic: '拥有海量正版数据资源，AI训练基础', rating: 'buy'},
|
||||
{stock: '视觉中国', category: 'IP/版权', project: '5.4亿数字内容', logic: '全球领先视觉内容交易平台', rating: 'buy'},
|
||||
{stock: '掌阅科技', category: 'IP/版权', project: '数字阅读IP', logic: '丰富IP资源和精细化运营能力', rating: 'hold'},
|
||||
{stock: '万达电影', category: '电影', project: '影视制作', logic: '2024年观影收入66.87亿元', rating: 'hold'},
|
||||
{stock: '中国电影', category: '电影', project: '影视行业', logic: '2024年影视行业营收45.23亿元', rating: 'hold'},
|
||||
{stock: '光线传媒', category: '电影', project: '电影及衍生', logic: '2024年电影及相关衍生业务11.29亿元', rating: 'hold'},
|
||||
{stock: '芒果超媒', category: '影视', project: '芒果TV', logic: '2024年互联网视频业务101.79亿元', rating: 'buy'},
|
||||
{stock: '华策影视', category: '影视', project: '电视剧制作', logic: '2024年电视剧制作发行收入11.94亿元', rating: 'hold'},
|
||||
{stock: '华谊兄弟', category: '短剧', project: '华谊兄弟火剧', logic: '短剧品牌"华谊兄弟火剧"', rating: 'speculative'},
|
||||
{stock: '中文在线', category: '短剧', project: 'ReelShort', logic: '拥有短剧全产业链能力，参股ReelShort', rating: 'buy'}
|
||||
];
|
||||
|
||||
// 填充表格
|
||||
function populateTable(category = 'all') {
|
||||
const tbody = document.getElementById('stockTableBody');
|
||||
tbody.innerHTML = '';
|
||||
|
||||
const filteredData = category === 'all'
|
||||
? stockData
|
||||
: stockData.filter(item => item.category === category);
|
||||
|
||||
filteredData.forEach(item => {
|
||||
const row = document.createElement('tr');
|
||||
row.className = 'stock-row';
|
||||
|
||||
let ratingBadge = '';
|
||||
let ratingClass = '';
|
||||
switch(item.rating) {
|
||||
case 'strong-buy':
|
||||
ratingBadge = '强烈买入';
|
||||
ratingClass = 'badge-success';
|
||||
break;
|
||||
case 'buy':
|
||||
ratingBadge = '买入';
|
||||
ratingClass = 'badge-info';
|
||||
break;
|
||||
case 'hold':
|
||||
ratingBadge = '持有';
|
||||
ratingClass = 'badge-warning';
|
||||
break;
|
||||
case 'speculative':
|
||||
ratingBadge = '投机';
|
||||
ratingClass = 'badge-error';
|
||||
break;
|
||||
}
|
||||
|
||||
row.innerHTML = `
|
||||
<td class="font-semibold">${item.stock}</td>
|
||||
<td><span class="badge badge-outline">${item.category}</span></td>
|
||||
<td>${item.project}</td>
|
||||
<td class="text-sm">${item.logic}</td>
|
||||
<td><span class="badge ${ratingClass}">${ratingBadge}</span></td>
|
||||
`;
|
||||
tbody.appendChild(row);
|
||||
});
|
||||
}
|
||||
|
||||
// 显示分类
|
||||
function showCategory(category) {
|
||||
const tabs = document.querySelectorAll('.tab');
|
||||
tabs.forEach(tab => tab.classList.remove('tab-active'));
|
||||
event.target.classList.add('tab-active');
|
||||
populateTable(category);
|
||||
}
|
||||
|
||||
// 页面加载时填充表格
|
||||
document.addEventListener('DOMContentLoaded', function() {
|
||||
populateTable();
|
||||
});
|
||||
|
||||
// 平滑滚动
|
||||
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
|
||||
anchor.addEventListener('click', function (e) {
|
||||
e.preventDefault();
|
||||
document.querySelector(this.getAttribute('href')).scrollIntoView({
|
||||
behavior: 'smooth'
|
||||
});
|
||||
});
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user