How phat-smile/smart_parking_system works
This is a Smart Parking System technical foundation, not a completed user-facing parking product: the README explicitly says business user stories are not implemented. The intended request path is web client → YARP Gateway → business services, with service data and integration infrastructure behind them; the repository also contains concrete booking, identity, parking, payment, wallet and AI modules. The graph preserves those implemented domain stages and the documented messaging, IoT and observability capabilities. Edges rely on README statements or shown imports; unsampled service wiring is not inferred.
Main entry points: Program.cs YARP Gateway · Booking.Application Reservations · Accounts Identity accounts · Payment.Application Payments and wallet
Components 22
Client entry
- Next.js web app
web - YARP Gateway
src/Gateway/Program.cs
Business services
- Reservations
src/Services/Booking/Booking.Application - Reservation queries
src/Services/Booking/Booking.Application/Reservations/Queries/GetMyReservations/GetMyReservationsQueryHandler.cs - Identity accounts
src/Services/Identity/Identity.Application/Accounts - Vehicle lookup
src/Services/Identity/Identity.Application/Vehicles/Lookup/LookupVehicleByPlateQueryHandler.cs - Parking operations
src/Services/Parking/Parking.Application - Payments and wallet
src/Services/Payment/Payment.Application - Wallet history
src/Services/Payment/Payment.Application/Features/Wallets/Queries/GetWalletTransactions/GetWalletTransactionsQueryHandler.cs - Wallet ledger rules
src/Services/Payment/Payment.Domain/Entities/Wallet.cs
AI capabilities
- AI service
ai/ai-service/app/main.py - Arrival availability API
ai/ai-service/app/api/arrival_availability.py - Arrival estimation
ai/ai-service/app/application/arrival_availability.py - Lot recommendations
ai/ai-service/app/api/recommendations.py
Platform infrastructure
- IoT simulator
edge/iot-simulator/src/main.py - PostgreSQL
- RabbitMQ
- MQTT
- Telemetry stack
Integration contracts
- Integration events
contracts/events/ParkingSystem.Contracts.Events - gRPC contracts
contracts/grpc
Other components
- Web users
Connections 31
- Web users → Next.js web app: uses
README.md - Next.js web app → YARP Gateway: routes API requests
README.md - YARP Gateway → Reservations: routes requests
- YARP Gateway → Identity accounts: routes requests
- YARP Gateway → Parking operations: routes requests
- YARP Gateway → Payments and wallet: routes requests
- Reservations → Reservation queries: handles queries
src/Services/Booking/Booking.Application/Reservations/Queries/GetMyReservations/GetMyReservationsQueryHandler.cs - Identity accounts → Vehicle lookup: handles lookup
src/Services/Identity/Identity.Application/Vehicles/Lookup/LookupVehicleByPlateQueryHandler.cs - Payments and wallet → Wallet history: handles history
src/Services/Payment/Payment.Application/Features/Wallets/Queries/GetWalletTransactions/GetWalletTransactionsQueryHandler.cs - Wallet history → Wallet ledger rules: reads wallet
src/Services/Payment/Payment.Application/Features/Wallets/Queries/GetWalletTransactions/GetWalletTransactionsQueryHandler.cs - Reservations → PostgreSQL: persists data
- Identity accounts → PostgreSQL: persists data
- Parking operations → PostgreSQL: persists data
- Payments and wallet → PostgreSQL: persists data
- Reservations → RabbitMQ: publishes events
- Identity accounts → RabbitMQ: publishes events
- Parking operations → RabbitMQ: publishes events
- Payments and wallet → RabbitMQ: publishes events
- IoT simulator → MQTT: uses protocol
README.md - RabbitMQ → Integration events: carries event contracts
- Reservations → gRPC contracts: uses service contracts
- AI service → Arrival availability API: registers router
ai/ai-service/app/main.py - Arrival availability API → Arrival estimation: uses application logic
ai/ai-service/app/api/arrival_availability.py - AI service → Lot recommendations: registers router
ai/ai-service/app/main.py - YARP Gateway → AI service: routes requests
- Next.js web app → Telemetry stack: supports telemetry
- YARP Gateway → Telemetry stack: exports telemetry
README.md - Reservations → Telemetry stack: exports telemetry
- Identity accounts → Telemetry stack: exports telemetry
- Parking operations → Telemetry stack: exports telemetry
- Payments and wallet → Telemetry stack: exports telemetry