명확성과 유지보수를 위한 FastAPI 여정 및 라우트 API 리팩토링

Source: Dev.to

RouteReality v1.3이 라이브되었습니다

RouteReality가 하는 일

RouteReality는 오픈‑소스 실시간 버스 도착 예측 시스템입니다. 정적 시간표 데이터와 사용자가 보고한 실시간 여정 이벤트를 결합합니다. 목표는 정적인 스케줄만을 의존하는 것이 아니라 버스가 실제로 언제 도착할지에 대한 더 명확한 그림을 제공하는 것입니다. 사용자가 시스템과 상호작용할수록 예측은 더 똑똑해지고 정확해집니다.

RouteReality만의 차별점

많은 벨파스트 기반 버스 트래커는 이벤트가 발생한 후(예: 출발, 도착, 지연) 를 추적하는 데 초점을 맞춥니다. 이러한 시스템은 대부분 반응형입니다.

반면 RouteReality는 예측형이며 커뮤니티 주도입니다:

• 과거 이벤트만 보고하는 것이 아니라 버스 도착 시간을 예측합니다.
• 정적 시간표와 실시간 사용자 보고를 결합해 더 정확한 예측을 제공합니다.
• 커뮤니티 입력을 활용해 시간이 지남에 따라 정확도가 향상됩니다; 시스템은 반복된 여정으로부터 학습합니다.
• 예측에는 신뢰도 측정치가 포함되어 있어 추정치의 신뢰성을 보여줍니다.
• 오픈‑소스이며 개발자 친화적이어서 다른 사람이 쉽게 기여하거나 시스템을 확장할 수 있습니다.

v1.3의 새로운 기능

이번 업데이트는 안정성, 신뢰성 및 시스템 기반을 강화하는 데 중점을 두었습니다.

안정화 및 개선

• 새로운 개발자가 앱을 이해하기 쉽도록 README에 UI 스크린샷을 추가했습니다.
• 여정 이벤트 유형 처리를 개선해 보다 명확한 여정 라이프사이클을 제공했습니다.
• 최근 이벤트 수, 소스 메타데이터, 히스토리 데이터와 같은 컨텍스트를 포함하도록 예측 페이로드를 확장했습니다.
• 예측 및 이벤트 처리 레이어 전반에 걸쳐 보다 견고한 로깅 및 계측을 도입했습니다.

명명 및 리팩터링

• 주요 예측 필드명을 명확성과 일관성을 위해 변경했습니다(예: static_dt → reference_time).
• 중복 코드를 줄이고 유지보수성을 높이기 위해 예측 새로 고침 로직을 중앙화했습니다.
• 정적 데이터가 제한된 상황에 대비해 시간표 로딩 및 폴백 로직을 개선했습니다.

버그 수정

• 안전하지 않은 시간표 언패킹으로 인한 충돌을 수정했습니다.
• 데이터가 제한된 경우에도 예측 신뢰도 점수가 안정적으로 작동하도록 했습니다.
• 잘못된 경로나 정류장에 대한 API 오류 처리를 개선했습니다.

릴리스 노트

전체 v1.3 릴리스 노트는 여기에서 확인할 수 있습니다:
https://github.com/dillionhuston/RouteReality/releases/tag/V1.3

업데이트된 README

업데이트된 README에는 시작을 돕는 가이드와 스크린샷도 포함되어 있습니다:
https://github.com/dillionhuston/RouteReality/blob/main/README.md

앞으로의 계획

우리는 이미 다음을 향해 작업 중입니다:

• 사용자 계정 및 선호도
• 시간대별 패턴과 히스토리 트렌드를 고려한 예측 모델
• 모바일 친화적인 UI 및 성능 개선
• 더 강력한 커뮤니티 보고 및 피드백 루프

테스트, 버그 보고, 피드백을 제공해 주신 모든 분께 큰 감사를 드립니다. 여러분의 기여가 RouteReality의 미래를 만들고 있습니다.

즐거운 개발과 코딩 되세요!