How manu08manu/traintrackerv2-server works
TrainTracker is a Kotlin server for live and scheduled UK rail service information. HTTP users query boards, service histories/details, train units and related data; the server combines timetable/reference feeds with Kafka movement and signalling events, persists state, then serves enriched views. Separate branches provide operator administration, login, Knowledgebase data, and location/reference updates. The graph follows only relationships shown by the excerpts, source index, or application wiring; several route and feed internals were not sampled, so those links are omitted rather than inferred.
Main entry points: Application.kt HTTP application · AppDatabase.kt Application database · CorpusLookup.kt Station corpus lookup · LocationData.kt Location reference data
Components 29
Server runtime
- HTTP application
src/main/kotlin/com/traintracker/server/Application.kt - Runtime configuration
src/main/kotlin/com/traintracker/server/Config.kt - Application database
src/main/kotlin/com/traintracker/server/database/AppDatabase.kt
Timetable and reference
- CIF importer
src/main/kotlin/com/traintracker/server/cif/CifParser.kt - Station corpus lookup
src/main/kotlin/com/traintracker/server/cif/CorpusLookup.kt - Location reference data
src/main/kotlin/com/traintracker/server/cif/LocationData.kt - Schedule cancellations
src/main/kotlin/com/traintracker/server/cif/ScheduleCancellations.kt - Smart berth lookup
src/main/kotlin/com/traintracker/server/cif/SmartLookup.kt - RDM feed watcher
src/main/kotlin/com/traintracker/server/rdm/RdmWatcher.kt - PIF parser
src/main/kotlin/com/traintracker/server/rdm/PifParser.kt - NLC parser
src/main/kotlin/com/traintracker/server/rdm/NlcParser.kt
Live rail feeds
- LINX consumer
src/main/kotlin/com/traintracker/server/kafka/LinxConsumer.kt - Movement writer
src/main/kotlin/com/traintracker/server/kafka/LinxMovementWriter.kt - TD consumer
src/main/kotlin/com/traintracker/server/kafka/TdConsumer.kt - TD correlator
src/main/kotlin/com/traintracker/server/kafka/TdCorrelator.kt - TD state store
src/main/kotlin/com/traintracker/server/kafka/TdStore.kt - Allocation consumer
src/main/kotlin/com/traintracker/server/kafka/AllocationConsumer.kt
Rail queries
- Rail query routes
src/main/kotlin/com/traintracker/server/routes/BoardQuery.kt - Service detail routes
src/main/kotlin/com/traintracker/server/routes/ServiceDetailRoutes.kt - Unit query
src/main/kotlin/com/traintracker/server/routes/UnitQuery.kt
Administration and integrations
- Authentication routes
src/main/kotlin/com/traintracker/server/auth/AuthRoutes.kt - User sessions
src/main/kotlin/com/traintracker/server/auth/AuthDatabase.kt - Admin routes
src/main/kotlin/com/traintracker/server/routes/AdminRoutes.kt - Admin data
src/main/kotlin/com/traintracker/server/database/AdminData.kt - Knowledgebase routes
src/main/kotlin/com/traintracker/server/routes/KbRoutes.kt - Knowledgebase client
src/main/kotlin/com/traintracker/server/kb/KbClient.kt
Other components
- Web user
- Rail event brokers
- Rail Knowledgebase
Connections 42
- Web user → HTTP application: requests
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Runtime configuration: configures
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Application database: initializes
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Station corpus lookup: initializes
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Location reference data: registers
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Smart berth lookup: starts
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → LINX consumer: starts
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → TD consumer: starts
src/main/kotlin/com/traintracker/server/Application.kt - HTTP application → Allocation consumer: starts
src/main/kotlin/com/traintracker/server/Application.kt - CIF importer → Application database: imports schedules
src/main/kotlin/com/traintracker/server/cif/CifParser.kt - CIF importer → Station corpus lookup: uses lookup
src/main/kotlin/com/traintracker/server/cif/CifParser.kt - CIF importer → Schedule cancellations: uses cancellations
src/main/kotlin/com/traintracker/server/cif/CifParser.kt - Location reference data → RDM feed watcher: registers feeds
src/main/kotlin/com/traintracker/server/cif/LocationData.kt - Location reference data → PIF parser: parses feed
src/main/kotlin/com/traintracker/server/cif/LocationData.kt - Location reference data → NLC parser: parses feed
src/main/kotlin/com/traintracker/server/cif/LocationData.kt - Location reference data → Application database: saves mappings
src/main/kotlin/com/traintracker/server/cif/LocationData.kt - Smart berth lookup → RDM feed watcher: registers feed
src/main/kotlin/com/traintracker/server/cif/SmartLookup.kt - LINX consumer → Rail event brokers: consumes events
src/main/kotlin/com/traintracker/server/kafka/LinxConsumer.kt - TD consumer → Rail event brokers: consumes events
src/main/kotlin/com/traintracker/server/kafka/TdConsumer.kt - LINX consumer → Movement writer: writes movements
src/main/kotlin/com/traintracker/server/kafka/LinxConsumer.kt - Movement writer → Station corpus lookup: checks references
src/main/kotlin/com/traintracker/server/kafka/LinxMovementWriter.kt - Movement writer → TD correlator: reports movement
src/main/kotlin/com/traintracker/server/kafka/LinxMovementWriter.kt - Movement writer → Application database: stores movements
src/main/kotlin/com/traintracker/server/kafka/LinxMovementWriter.kt - TD consumer → TD correlator: correlates events
src/main/kotlin/com/traintracker/server/kafka/TdConsumer.kt - TD correlator → TD state store: updates state
src/main/kotlin/com/traintracker/server/kafka/TdCorrelator.kt - Allocation consumer → Application database: stores allocations
src/main/kotlin/com/traintracker/server/kafka/AllocationConsumer.kt - HTTP application → Rail query routes: mounts routes
- HTTP application → Service detail routes: mounts routes
- Rail query routes → Application database: queries services
src/main/kotlin/com/traintracker/server/routes/BoardQuery.kt - Rail query routes → Station corpus lookup: resolves stations
src/main/kotlin/com/traintracker/server/routes/BoardQuery.kt - Rail query routes → Schedule cancellations: checks schedules
src/main/kotlin/com/traintracker/server/routes/BoardQuery.kt - Rail query routes → Movement writer: reads movements
src/main/kotlin/com/traintracker/server/routes/BoardQuery.kt - Service detail routes → Application database: queries service
src/main/kotlin/com/traintracker/server/routes/ServiceDetailRoutes.kt - Service detail routes → Station corpus lookup: resolves locations
src/main/kotlin/com/traintracker/server/routes/ServiceDetailRoutes.kt - Service detail routes → Schedule cancellations: checks cancellation
src/main/kotlin/com/traintracker/server/routes/ServiceDetailRoutes.kt - Unit query → Application database: queries units
src/main/kotlin/com/traintracker/server/routes/UnitQuery.kt - Unit query → Station corpus lookup: resolves locations
src/main/kotlin/com/traintracker/server/routes/UnitQuery.kt - Authentication routes → User sessions: authenticates users
src/main/kotlin/com/traintracker/server/auth/AuthRoutes.kt - Admin routes → Admin data: manages operators
src/main/kotlin/com/traintracker/server/routes/AdminRoutes.kt - Admin routes → Station corpus lookup: updates references
src/main/kotlin/com/traintracker/server/routes/AdminRoutes.kt - Knowledgebase routes → Knowledgebase client: requests data
src/main/kotlin/com/traintracker/server/routes/KbRoutes.kt - Knowledgebase client → Rail Knowledgebase: fetches rail data
src/main/kotlin/com/traintracker/server/kb/KbClient.kt