埋点分析系统 - 项目总览
代码路径：
e:\AI工作台\埋点分析系统\
版本：v1.1.0
更新日期：2026-07-31
项目简介
前后端分离的埋点数据分析平台，对接 ClickHouse 数据库，为钱龙系列产品提供埋点数据采集、存储、分析和可视化能力。
技术栈速览
| 层级 | 技术 |
|---|---|
| 后端 | Python 3.10 + Flask 3.0 + Gunicorn |
| 前端 | React 18 + TypeScript + Vite + Chart.js |
| 数据库 | ClickHouse (TCP 9000) |
| 部署 | Docker + Docker Compose |
| 认证 | Token-based (12h TTL) |
文档索引
项目文档
- [[README]] - 项目说明与快速启动
- [[API测试报告]] - 20 个 API 端点测试结果
- [[开发记忆文档]] - 完整架构、功能清单、已知问题、开发规范
- [[埋点系统优化方案260731]] - P0/P1/P2 优化方案（留存/漏斗/行为序列）
- [[系统测试与优化方案]] - 测试结论 + 20 个问题清单（P0-P3）
- [[优化任务清单]] - 面向 AI 的可执行优化清单
- [[数据库索引优化文档]] - ClickHouse 索引诊断与优化 SQL
- [[生产优化文档]] - 安全加固、性能优化、部署指南
部署运维
- [[部署指南]] - Docker/传统部署完整步骤
- [[升级指南]] - v1.1.0 升级步骤与回滚方案
- [[打包说明]] - 交付包结构与使用说明
- [[部署指南详细版]] - 详细部署文档（含 Nginx 反向代理）
架构文档
- [[后端技术架构]] - Flask API 模块、数据库连接、安全措施
- [[前端技术架构]] - React 路由、组件树、设计系统
- [[clklog数据处理流程]] - 数据采集→处理→存储→查询全链路
功能模块
| 模块 | 路由 | 状态 |
|---|---|---|
| 概览看板 | / | 已上线 |
| 事件分析 | /events | 已上线 |
| 元素分析 | /elements | 已上线 |
| 用户分析 | /users | 已上线 |
| 留存分析 | /retention | 已上线 |
| 漏斗分析 | /funnel | 已上线 |
| 页面路径 | /screens | 已上线 |
| 数据明细 | /detail | 已上线 |
| 系统用户管理 | /sysusers | 已上线（仅 admin） |
环境信息
| 环境 | ClickHouse 地址 | 端口 |
|---|---|---|
| 生产 | 114.80.38.24 | 9000 |
| 测试 | 192.168.20.147 | 9000 |
默认账号
| 角色 | 账号 | 密码 |
|---|---|---|
| 管理员 | admin | clklog |
相关资源
- [[埋点系统概述]] - 业务需求侧文档（需求文档、接口定义、部署说明）
- 项目源码：
e:\AI工作台\埋点分析系统\ - 交付包：
e:\AI工作台\埋点分析系统\dist\tracker-analytics-v1.1.0.zip