Quadratic项目中的多工作表编辑时间戳同步问题解析

在电子表格协作工具Quadratic中，开发团队发现了一个关于文件更新时间戳同步的技术问题。当用户编辑工作簿中的非首个工作表时，系统未能正确更新文件的最后修改时间戳，这影响了仪表盘(dashboard)中文件排序和状态显示的准确性。

问题本质

该问题属于数据一致性范畴，具体表现为：

1. 文件元数据变更（如缩略图或文件名修改）能正常触发updated_date字段更新
2. 但通过文件服务创建新检查点(checkpoint)的操作却未能同步更新时间戳

技术背景

在Quadratic的架构设计中：

• 每个工作簿文件包含多个工作表(sheet)
• 文件服务负责管理版本控制，通过检查点机制保存编辑历史
• 前端仪表盘依赖updated_date字段确定文件最后修改时间

根本原因

问题出在检查点创建流程中。当用户编辑非首张工作表时：

1. 系统正确生成了新的检查点版本
2. 但未将检查点创建事件与文件元数据更新时间戳进行关联处理
3. 导致文件级别的updated_date字段未能反映实际修改时间

解决方案

修复方案直接明了：在文件服务创建新检查点时，同步更新File表中的updated_date字段。具体实现位置在检查点创建的PUT请求处理逻辑中。

这种修改确保了：

• 任何工作表的编辑都会触发时间戳更新
• 保持版本控制系统与元数据的一致性
• 仪表盘能准确反映所有工作表的编辑活动

技术启示

这个案例展示了分布式系统中常见的数据一致性问题。在具有多层抽象（工作表→工作簿→文件系统）的应用中，需要特别注意：

1. 跨层状态同步机制
2. 事务边界的明确定义
3. 所有修改路径的完整覆盖

对于类似的多层数据应用，建议采用：

• 统一的状态变更传播机制
• 全面的修改事件监控
• 端到端的集成测试验证

该修复虽然代码改动量小，但对提升用户体验至关重要，体现了细节决定体验的产品哲学。