Skip to content

Repository files navigation

EasySubway Backend

Reliable route discovery, real-time train updates, and facility reports for EasySubway riders.

The backend delivers mobility-adapted routing, live transit feeds, and fault reporting to the mobile app, giving operators clear oversight of data quality.


[ English ] | 🇰🇷 한국어


What it does

  • Route planning: Computes barrier-free paths using departure stations, arrival stations, schedules, and step-free constraints.
  • Live train tracking: Streams arrival times and active train positions to the app.
  • Timetable search: Looks up national passenger trains, stations, and schedule variants.
  • Facility reporting: Accepts community incident reports with optional photos and provides verifiable receipt codes.
  • Data verification: Audits station structures, track topologies, and candidate DataPack releases before they reach riders.
  • Observability: Keeps watch over route feedback, recurring elevator outages, and live transit provider connections.

Current scope

  • Provides client API endpoints and authenticated operator screens. Management tools are not publicly accessible.
  • Live subway arrival feeds integrate with Seoul TOPIS.
  • Production route planning is handled by the Journey V3 server using the RAPTOR algorithm with short-lived session tokens. The server relies on verified route bundles. If data is expired, missing, or mismatched, it returns an explicit error instead of falling back to stale approximations.
  • Incident reporting works with or without photos. Anonymous reports use pre-signed upload URLs.
  • Data modifications and releases require authenticated operator credentials.

API contracts

Server addresses and operator credentials are not public. Endpoint specifications, headers, and schemas are defined in our contract files:

Contact: aquila@aquilaxk.site

About

EasySubway Spring Boot backend, admin, batch, realtime adapters, and immutable image producer

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages