重构 FastAPI Journey 和 Route API，以提升清晰度和可维护性

Source: Dev.to

RouteReality v1.3 is Live

RouteReality 的功能

RouteReality 是一个开源的实时公交到站预测系统。它将静态时刻表数据与用户上报的实时行程事件相结合。目标是让人们更清晰地了解公交实际到达的时间，而不是仅仅依赖静态时刻表。用户与系统的交互越多，预测就会变得越智能、越准确。

RouteReality 的区别

许多位于贝尔法斯特的公交追踪器侧重于在事件发生 之后（例如发车、到达、延误）进行追踪。这类系统大多是被动响应的。

而 RouteReality 则是 预测型 且 社区驱动 的：

• 预测公交到达时间，而不仅仅报告过去的事件。
• 将静态时刻表与实时用户报告相融合，以获得更准确的预测。
• 利用社区输入随时间提升准确性；系统会从重复的行程中学习。
• 预测结果包含置信度，显示估计的可靠程度。
• 开源且对开发者友好，便于他人贡献或扩展系统。

v1.3 新增内容

本次更新侧重于稳定性、可靠性以及系统基础的改进。

稳定性与改进

• 在 README 中添加了 UI 截图，帮助新开发者了解应用。
• 改进了行程事件类型的处理，使行程生命周期更清晰。
• 扩展了预测负载，加入最近事件计数、来源元数据和历史数据等上下文信息。
• 在预测和事件处理层引入了更健壮的日志记录和监控。

命名与重构

• 重命名关键预测字段（例如 static_dt 现改为 reference_time），提升可读性和一致性。
• 将预测刷新逻辑集中化，减少重复代码并提升可维护性。
• 改进了时刻表加载和回退逻辑，以应对静态数据有限的情况。

Bug 修复

• 修复了因不安全的时刻表解包导致的崩溃。
• 在数据有限时稳定了预测置信度评分。
• 改进了 API 对无效线路或站点的错误处理。

发布说明

完整的 v1.3 发布说明请查看这里：
https://github.com/dillionhuston/RouteReality/releases/tag/V1.3

更新的 README

更新后的 README 还包含指南和截图，帮助您快速上手：
https://github.com/dillionhuston/RouteReality/blob/main/README.md

下一步计划

我们已经在推进以下工作：

• 用户账户与偏好设置
• 考虑时段模式和历史趋势的预测模型
• 改进移动端友好的 UI 与性能
• 更强大的社区报告与反馈循环

衷心感谢所有参与测试、报告 Bug 并提供反馈的朋友们。你们的贡献正在塑造 RouteReality 的未来。

祝开发愉快，编码顺利！