Kvaesitso项目中的OSM开放时间解析优化方案

背景介绍

在Kvaesitso这个开源项目中，处理开放街图(OSM)的opening_hours标签是一个重要功能。这个标签用于描述各类场所(如商店、餐厅等)的营业时间信息。项目原本实现了自己的解析逻辑，但随着时间推移，发现现有方案存在一些不足。

现有问题分析

当前实现存在几个关键问题：

1. 解析准确性不足，某些特殊格式的开放时间无法正确处理
2. 功能覆盖不全，无法处理季节性营业时间(如仅夏季开放)或月份特定的营业安排
3. 维护成本高，需要自行处理OSM开放时间规范的各种复杂情况

解决方案

经过技术调研，决定采用成熟的第三方库来替代现有实现。选定的开源库具有以下优势：

• 专门为解析OSM开放时间设计
• 被StreetComplete等知名OSM相关项目采用
• 功能全面，支持各种复杂的时间表达式
• 维护活跃，能及时跟进OSM规范的更新

技术实现要点

迁移工作将遵循以下原则：

1. 保持现有OpeningSchedule接口不变，确保不影响其他模块
2. 仅关注周级别的营业时间预览，暂不实现季节/月份等高级特性
3. 根据用户本地时间生成适当的营业时间展示

预期收益

这一改进将带来多方面好处：

• 提高解析准确性，减少错误情况
• 降低维护成本，无需自行处理复杂的时间表达式
• 为未来可能的扩展(如季节性营业时间)奠定基础
• 提升代码质量，遵循"不重复造轮子"的原则

实施建议

建议将此项改进作为独立的技术优化提交，不影响其他功能开发的进度。这样可以确保每个变更集保持清晰的目的和范围，便于代码审查和问题追踪。

对于开发者而言，这种架构优化也体现了良好的工程实践：在保证接口稳定的前提下，灵活调整内部实现，既提升了系统能力，又保持了良好的向后兼容性。