How yoseph-m/semuni works
Semuni is a fare, wallet, payment, and settlement platform for Ethiopia’s minibus network. Its documented journey is passenger/driver authentication, fare and trip handling, passenger wallet payment, driver earnings, settlement visibility, and withdrawal requests. The graph emphasizes backend domain stages and the sampled driver-facing orchestration. Flutter application source is not present in the supplied tree, and several backend capability modules are unsampled; their paths are included where the tree confirms them, but uncertain call relationships are omitted.
Main entry points: drivers.controller.ts Driver API · auth.service.ts Authentication · auth.controller.ts Auth API · wallets.service.ts Wallet operations
Components 22
Identity & access
- Auth API
backend/src/auth/auth.controller.ts - Authentication
backend/src/auth/auth.service.ts - User profiles
backend/src/users/users.service.ts
Transport & fares
- Driver API
backend/src/drivers/drivers.controller.ts - Driver profiles
backend/src/drivers/drivers.service.ts - Trips
backend/src/trips/trips.service.ts - Routes
backend/src/routes/routes.service.ts - Fare calculation
backend/src/fares/fares.service.ts - Tariff management
backend/src/tariffs/tariffs.service.ts
Wallet & finance
- Wallet API
backend/src/wallets/wallets.controller.ts - Wallet operations
backend/src/wallets/wallets.service.ts - Ledger
backend/src/ledger/ledger.service.ts - Payments
backend/src/payments/payments.service.ts - Payment providers
backend/src/payments/providers - Settlements
backend/src/settlements/settlements.service.ts - Withdrawals
backend/src/withdrawals/withdrawals.service.ts
Platform services
- Notifications
backend/src/notifications - Maps
backend/src/maps/maps.service.ts - Receipt verification
backend/src/links-et/links-et.client.ts
Other components
- Passenger
- Driver
- Admin
Connections 21
- Passenger → Auth API: register / login
- Driver → Auth API: register / login
- Auth API → Authentication: handles auth
- Authentication → User profiles: creates / looks up
backend/src/auth/auth.service.ts - Authentication → Driver profiles: creates driver
backend/src/auth/auth.service.ts - Driver → Driver API: views / requests
backend/src/drivers/drivers.controller.ts - Admin → Driver API: approves / suspends
backend/src/drivers/drivers.controller.ts - Driver API → Driver profiles: reads / updates
backend/src/drivers/drivers.controller.ts - Driver API → Trips: reads earnings
backend/src/drivers/drivers.controller.ts - Driver API → Routes: lists routes
backend/src/drivers/drivers.controller.ts - Driver API → Wallet operations: reads balance
backend/src/drivers/drivers.controller.ts - Driver API → Withdrawals: requests / lists
backend/src/drivers/drivers.controller.ts - Driver API → Passenger: looks up ride payer
backend/src/drivers/drivers.controller.ts - Passenger → Wallet API: uses wallet
- Wallet API → Wallet operations: handles requests
backend/src/wallets/wallets.controller.ts - Wallet operations → Ledger: records entries
backend/src/wallets/wallets.service.ts - Passenger → Payments: pays fare
README.md - Payments → Payment providers: selects provider
- Trips → Fare calculation: requests fare
backend/src/trips/trips.service.ts - Driver → Settlements: views settlements
README.md - Driver → Withdrawals: requests withdrawal