Proxima
An AFC (automated fare collection) platform for public transport: fare and access rule engines, products and tariffs, customers and media, device fleet configuration and software distribution, transaction ingestion and settlement.
4 of 19 active components are documented so far. All 22 are listed below, including the legacy and dead ones worth recognising — the traps are the point. The repository holds 307 project files, of which 257 are first-party; see the inventory for a mechanical verdict on each, or how to tell them apart by hand.
How it fits together
Three IIS tiers plus a set of Windows services, all against one SQL Server. Every service finds its configuration by walking up the directory tree to a single Proxima.config.json.
Components
Filtered to active by default. Switch to dead to see the traps — projects that look central and are not.
19 of 22 components
Proxima.Ext.Service
Service/Proxima.Ext.ServiceCustomer-facing External API. 21 controllers. Where refresh-token authentication landed. The most actively developed service in the repo.
Read the docs →Proxima.Web.Service
Service/Proxima.Web.ServiceMain back-office API and the largest surface in the system: 67 controllers over devices, products, fare/access/price rules, customers, media, publication, reporting.
Read the docs →Proxima.ActionList.Service
Service/Proxima.ActionList.ServiceDevice command queue. The ONLY live .NET Framework 4.8 web service — classic ASP.NET Web API with Global.asax and Unity DI. Proof that the V1 retirement is incomplete.
Not documented yetProxima.ExternalPayment.ServiceV2
Service/Proxima.ExternalPayment.ServiceV2Payment-provider integration API. Thin — the logic sits in the provider-specific Business projects: LittlePay, EuPlatesc, Hubtel, PSP, Bytemark.
Not documented yetProxima.ExtMonitoring.Service
Service/Proxima.ExtMonitoring.ServiceExternal monitoring API exposing device and system health. Two publish profiles disagree on its target folder.
Not documented yetProxima.FO.Service
Service/Proxima.FO.ServiceFront-office API that on-vehicle validators, POS and inspection devices talk to. Registers 9 DbContexts and also fans out to six AgentV2 HTTP clients. Hosts SignalR.
Not documented yetProxima.Replicator.ServiceV2
Service/Proxima.Replicator.ServiceV2Pushes reference data down to the device fleet — one controller per replicated artifact: dataset, denylist, acceptance list, binlist, CD settings, assets, software, GTFS, monitoring.
Not documented yetProxima.TrxStorage.ServiceV2
Service/Proxima.TrxStorage.ServiceV2Transaction storage and ingest API. Receives transaction records from devices and from other services.
Not documented yetProxima.DaylightSavingsTime.ServiceV2
Service/Proxima.DaylightSavingsTime.ServiceV2Windows service refreshing timezone and DST data from timeapi.io every 12 hours so devices apply correct local time.
Not documented yetProxima.FileCopy.Service
Service/Proxima.FileCopy.ServiceWindows service moving uploaded dataset and software archives between staging folders. Current generation despite having no V2 suffix.
Not documented yetProxima.GTFS.ServiceV2
Service/Proxima.GTFS.ServiceV2Windows service that polls and ingests GTFS and GTFS-Realtime transit feeds on a timer.
Not documented yetProxima.Trx.ServiceV2
Service/Proxima.Trx.ServiceV2Windows service 'Proxima Trx Service'. Zero controllers — a file-drop batch processor for transaction files and monitoring events. If you want a Trx HTTP API you want TrxStorage.ServiceV2.
Not documented yetProximaAngularWeb
App/ProximaAngularWebBack office / TMS: network modelling, products and fares, the rule engine, publication and distribution to the fleet, live monitoring, reporting, user administration, and operator tools for issuing tickets. Served under base href /tms/.
Read the docs →WebshopAngularNew (ProxyMobi)
App/WebshopAngularNewCustomer web shop and iOS/Android app from one codebase, one live project config (ppt) in -projects/, with operators selected at runtime. Buy tickets, top up, show QR codes, link cards, plan trips.
Read the docs →prodataWordpressLandingPage
App/prodataWordpressLandingPagePublic marketing site. WordPress core plus 17 plugins committed wholesale; the only first-party code is the ppt-landing theme.
Not documented yetReportsViewer
UI/ReportsViewerHost for SSRS reports. Deployed as the ReportingUI IIS app — but its solution is commented out of the build script, so someone must build it by hand first.
Not documented yetProxima.Afc.Db
Storage/RoundHouse/Proxima/Proxima.Afc.DbThe main database. Migrations live under Scripts/Up/TMSMilestoneNN and are applied by RoundHouse during install. Connection string name: ProximaDb.
Not documented yetProxima.Afc.Logging.Db
Storage/RoundHouse/Proxima/Proxima.Afc.Logging.DbLogging database. Note its migration folder is lower-case 'up' while the other two use 'Up'.
Not documented yetProxima.Afc.Reporting.Db
Storage/RoundHouse/Proxima/Proxima.Afc.Reporting.DbReporting database behind SSRS and the reporting endpoints. Connection string name: ProximaReportingDb.
Not documented yet