1. 停止当前服务

# 埋点分析系统 - 升级指南

版本：v1.1.0

更新日期：2026-07-31

---

一、升级前准备

1. 备份用户数据

`bash # Docker 部署 docker cp tracker-analytics:/app/backend/data/users.db ./users.db.bak

# 传统部署 cp backend/data/users.db ./users.db.bak `

1. 备份当前配置

`bash cp deploy/.env ./env.bak `

1. 记录当前版本

`bash docker images | grep tracker-analytics `

---

二、Docker 部署升级

# 1. 停止当前服务
docker-compose down

# 2. 替换新版本代码（解压新包覆盖）

# 3. 恢复 .env 配置（如有修改）
cp env.bak deploy/.env

# 4. 重新构建并启动
docker-compose up -d --build

# 5. 验证服务
curl http://localhost:5000/api/health

---

三、传统部署升级

# 1. 停止服务
./deploy/scripts/stop.sh

# 2. 替换新版本代码（解压新包覆盖 backend/ 和 frontend/dist/）

# 3. 恢复 .env 配置
cp env.bak deploy/.env

# 4. 启动服务（会自动更新依赖）
./deploy/scripts/start.sh daemon

# 5. 验证服务
curl http://localhost:5000/api/health

---

四、回滚

如果升级后出现问题，可快速回滚：

# Docker
docker-compose down
# 使用旧版本镜像启动
docker run -d --name tracker-analytics -p 5000:5000 tracker-analytics:<旧版本>

# 传统部署
./deploy/scripts/stop.sh
# 恢复旧版本代码目录
./deploy/scripts/start.sh daemon

---

五、数据兼容性

• users.db（SQLite 用户库）在版本间向后兼容
• 升级不会丢失用户账号、权限配置
• 如遇数据库 schema 变更，系统会在启动时自动迁移

---

六、版本变更说明

v1.1.0 (2026-07-31)

新增功能：

• 右上角用户下拉框新增"修改密码"功能
• 左侧新增"系统用户"管理模块（仅管理员可见）
• 新建系统用户（用户名/登录名/手机号/密码/角色）
• 用户查询、编辑、删除
• 角色设置（管理员/普通用户）
• 权限设置（项目权限 + 环境权限）
• 密码重置（支持快捷使用默认密码 123456）
• 用户启用/禁用
• 安全限制：不能删除/禁用最后一个管理员，不能操作自身账号

优化：

• 用户分析顶部看板样式统一为 KPI 卡片
• 数据明细页新增 app_name 和元素下拉筛选
• 数据明细下拉框按数据库出现数量降序排列，最多 30 条
• 数据明细下拉框等宽平均分配

修复：

• 留存分析 KPI 切换统计周期数值不变的问题
• 留存分析生产环境 30 日留存为 null 的问题
• 生产库 stat_date 未来日期脏数据排除
• 项目下拉框点击内部误关闭的问题