How pranjal1-1/himachal-transit works
Himachal Transit is a transit operations system with an admin web console, backend API, and mobile client. The evidenced admin workflow is login or token entry, then managing fleet, routes, stops, and assignments through API requests. The repository also documents passenger and driver apps, GPS tracking, real-time updates, and ETA functionality. Mobile and ETA implementation details were not sampled, so those capabilities are represented as subsystems without asserted internal wiring; dashed edges mark unverified links.
Main entry points: index.ts HTTP API · server.ts Realtime Server · api.ts Admin API Client · db.ts Database Selector
Components 20
Admin Console
- Admin Login
ht_development_pack_v2/himachal_transit/admin/app/login/page.tsx - Fleet And Routes
ht_development_pack_v2/himachal_transit/admin/app/buses/page.tsx - Stop Management
ht_development_pack_v2/himachal_transit/admin/app/stops/page.tsx - Assignments
ht_development_pack_v2/himachal_transit/admin/app/assignments/page.tsx - Admin API Client
ht_development_pack_v2/himachal_transit/admin/lib/api.ts
Backend Services
- HTTP API
ht_development_pack_v2/himachal_transit/backend/src/index.ts - Authentication
ht_development_pack_v2/himachal_transit/backend/src/auth.ts
Persistence
- Database Selector
ht_development_pack_v2/himachal_transit/backend/src/db.ts - File Database
ht_development_pack_v2/himachal_transit/backend/src/db_file.ts - Postgres Database
ht_development_pack_v2/himachal_transit/backend/src/db_pg.ts
Mobile Client
- Driver App
ht_development_pack_v2/himachal_transit/mobile/lib/features/driver - Passenger App
ht_development_pack_v2/himachal_transit/mobile/lib/features/passenger - Mobile Authentication
ht_development_pack_v2/himachal_transit/mobile/lib/features/auth - Maps And Location
ht_development_pack_v2/himachal_transit/mobile/lib/features/maps
Transit Tracking
- Realtime Server
ht_development_pack_v2/himachal_transit/backend/src/realtime/server.ts - Realtime Events
ht_development_pack_v2/himachal_transit/backend/src/realtime/events.ts - ETA Engine
ht_development_pack_v2/himachal_transit/backend/src
Other components
- Admin User
- Transit Rider
- Driver
Connections 20
- Admin User → Admin Login: signs in
ht_development_pack_v2/himachal_transit/admin/app/login/page.tsx - Admin Login → Admin API Client: requests login
ht_development_pack_v2/himachal_transit/admin/app/login/page.tsx - Fleet And Routes → Admin API Client: fetches resources
ht_development_pack_v2/himachal_transit/admin/app/buses/page.tsx - Stop Management → Admin API Client: fetches stops
ht_development_pack_v2/himachal_transit/admin/app/stops/page.tsx - Assignments → Admin API Client: fetches assignments
ht_development_pack_v2/himachal_transit/admin/app/assignments/page.tsx - Admin API Client → HTTP API: sends HTTP requests
ht_development_pack_v2/himachal_transit/admin/lib/api.ts - HTTP API → Authentication: authenticates users
ht_development_pack_v2/himachal_transit/backend/src/index.ts - HTTP API → Database Selector: reads and writes
ht_development_pack_v2/himachal_transit/backend/src/index.ts - Database Selector → File Database: selects file store
ht_development_pack_v2/himachal_transit/backend/src/db.ts - Database Selector → Postgres Database: selects Postgres
ht_development_pack_v2/himachal_transit/backend/src/db.ts - HTTP API → Realtime Server: initializes realtime
ht_development_pack_v2/himachal_transit/backend/src/index.ts - Realtime Server → Realtime Events: creates events
ht_development_pack_v2/himachal_transit/backend/src/realtime/server.ts - Realtime Server → Database Selector: checks active trips
ht_development_pack_v2/himachal_transit/backend/src/realtime/server.ts - Driver → Driver App: uses
- Transit Rider → Passenger App: uses
- Mobile Authentication → HTTP API: authenticates
- Driver App → Maps And Location: uses location
- Driver App → Realtime Server: sends GPS updates
- Passenger App → Realtime Server: receives trip updates
- ETA Engine → Passenger App: provides ETAs