Dawarich项目中的样本数据污染问题分析与解决方案

问题背景

Dawarich是一个基于位置数据的追踪应用，在0.25.3版本中存在一个影响用户体验的设计问题：系统在创建新用户时会自动注入样本数据。这些预置的演示数据不仅出现在默认的演示账户中，还会污染所有新创建的用户账户，导致用户无法获得一个干净的数据环境来记录自己的真实活动轨迹。

问题表现

当用户按照官方文档部署Dawarich实例后，会遇到以下现象：

1. 默认演示账户([e-mail])中包含2024年10月的644个样本数据点
2. 即使用户删除这些数据点，统计页面仍会保留相关的距离和生命周期统计数据
3. 新创建的用户账户也会自动继承这些样本数据
4. 统计数据的更新功能无法清除这些残留信息

技术原因分析

通过查看项目源代码，发现问题源于用户模型(user.rb)中的一段逻辑判断：

return unless Rails.env.development? ||
      Rails.env.production? ||
      (Rails.env.test? && ENV['IMPORT_SAMPLE_POINTS'])

这段代码意味着在开发环境和生产环境下，系统会无条件地导入样本数据，只有在测试环境中才考虑环境变量控制。这种设计导致了样本数据在所有常规部署场景下都会被自动注入。

临时解决方案

在0.26.0版本修复前，用户可以通过以下方式手动清理样本数据：

1. 进入Dawarich控制台
2. 执行以下Ruby命令清理特定月份的统计数据：

user = User.find_by(email: "your@email")
stat=user.stats.find_by(year:2024, month:10)
stat.destroy

3. 对于彻底清理，可以创建新管理员账户后删除演示账户：

User.find_by(email: "[e-mail]").destroy

官方修复方案

项目维护者在0.26.0版本中彻底移除了自动创建样本数据的功能。这一变更使得：

1. 新部署的实例不再包含任何预置数据
2. 新创建的用户账户将获得完全干净的初始状态
3. 用户能够从零开始记录自己的真实活动数据

最佳实践建议

对于正在使用0.25.3或更早版本的用户：

1. 考虑升级到0.26.0或更高版本
2. 如需保留现有数据，按照上述方法手动清理样本数据
3. 新部署时直接使用最新版本，避免样本数据污染问题

对于项目维护者而言，这一问题的解决也提供了有价值的经验：在设计中应当更细致地考虑用户数据所有权和初始状态的可控性，避免强制性的数据注入影响用户体验。