How khoi-dao/my-first-proud-mocking-project works
This repository implements SmartParking payment capabilities: invoice management and login through an HTTP API, transaction processing, and event-based transaction handling with SignalR notification components. The principal payment path is a client request to the invoice API, through business services and repositories, to SQL-backed invoice and transaction records. A separate user service handles authentication, while a MAUI/Blazor client includes invoice API and auth-state services. The README names RabbitMQ and Loki/Grafana; sampled API startup shows RabbitMQ publishing setup and Loki logging, but not the publish call or consumer-to-hub behavior, so those links are omitted.
Main entry points: SmartParking_PaymentServiceContext.cs Payment DbContext · InvoicesKhoiDnController.cs Invoice API · InvoicesKhoiDnRepository.cs Invoice repository · GenericRepository.cs Generic repository
Components 29
Client app
- MAUI web client
SmartParking.MAUIHybridWebApp.KhoiDN/SmartParking.MAUIHybridWebApp.KhoiDN.Web/Program.cs - Invoice API client
SmartParking.MAUIHybridWebApp.KhoiDN/SmartParking.MAUIHybridWebApp.KhoiDN.Shared/Services/InvoiceApiService.cs - Auth state
SmartParking.MAUIHybridWebApp.KhoiDN/SmartParking.MAUIHybridWebApp.KhoiDN.Shared/Services/CustomAuthStateProvider.cs
HTTP services
- API gateway
SmartParking.OcelotAPIGateway.KhoiDN/Program.cs - Invoice API
SmartParking_PaymentService.APIWebApp.KhoiDN/Controllers/InvoicesKhoiDnController.cs - Login API
SmartParking_PaymentService.APIWebApp.KhoiDN/Controllers/LoginController.cs - User auth service
SmartParking.User.Microservice.KhoiDN/Controllers/AuthController.cs - Transaction service host
SmartParking.Transactions.Microservice.KhoiDN/Program.cs - Notification service
SmartParking.Notification.SignalRService.KhoiDN/Program.cs
Payment logic
- Invoice service
SU26_PRN232_Payment.Services.KhoiDN/InvoicesKhoiDnService.cs - Transaction service
SU26_PRN232_Payment.Services.KhoiDN/TransactionsKhoiDnService.cs - User account service
SU26_PRN232_Payment.Services.KhoiDN/SystemUserAccountService.cs
Persistence
- Invoice repository
SU26_PRN232_Payment.Repositories.KhoiDN/InvoicesKhoiDnRepository.cs - Transaction repository
SU26_PRN232_Payment.Repositories.KhoiDN/TransactionsKhoiDnRepository.cs - Account repository
SU26_PRN232_Payment.Repositories.KhoiDN/SystemUserAccountRepository.cs - Generic repository
SU26_PRN232_Payment.Repositories.KhoiDN/Base/GenericRepository.cs - Payment DbContext
SU26_PRN232_Payment.Repositories.KhoiDN/DBContext/SmartParking_PaymentServiceContext.cs - SQL Server
- Invoice entity
SU26_PRN232_Payment.Entities.KhoiDN/Models/InvoicesKhoiDn.cs - Transaction entity
SU26_PRN232_Payment.Entities.KhoiDN/Models/TransactionsKhoiDn.cs - User account entity
SU26_PRN232_Payment.Entities.KhoiDN/Models/SystemUserAccount.cs
Events and observability
- RabbitMQ
- Transaction consumer
SmartParking.Transactions.Microservice.KhoiDN/Consumers/TransactionsKhoiDnConsumer.cs - Invoice-created event
SmartParking.BusinessObject.Shared.Models.KhoiDN/Events/InvoiceCreatedEvent.cs - Transaction-completed event
SmartParking.BusinessObject.Shared.Models.KhoiDN/Events/TransactionCompletedEvent.cs - Completion consumer
SmartParking.Notification.SignalRService.KhoiDN/Consumers/TransactionCompletedConsumer.cs - Notification hub
SmartParking.Notification.SignalRService.KhoiDN/Hubs/NotificationHub.cs - Loki logging
Other components
- Payment user
Connections 33
- Payment user → MAUI web client: uses
- MAUI web client → Invoice API client: uses
SmartParking.MAUIHybridWebApp.KhoiDN/SmartParking.MAUIHybridWebApp.KhoiDN.Web/Program.cs - MAUI web client → Auth state: registers
SmartParking.MAUIHybridWebApp.KhoiDN/SmartParking.MAUIHybridWebApp.KhoiDN.Web/Program.cs - Invoice API client → API gateway: HTTP requests
- API gateway → Invoice API: routes
- Invoice API → Invoice service: delegates to
SmartParking_PaymentService.APIWebApp.KhoiDN/Controllers/InvoicesKhoiDnController.cs - Invoice service → Invoice repository: reads and writes
SU26_PRN232_Payment.Services.KhoiDN/InvoicesKhoiDnService.cs - Transaction service → Invoice repository: checks and updates
SU26_PRN232_Payment.Services.KhoiDN/TransactionsKhoiDnService.cs - Transaction service → Transaction repository: records payment
SU26_PRN232_Payment.Services.KhoiDN/TransactionsKhoiDnService.cs - Transaction service host → Transaction consumer: registers
SmartParking.Transactions.Microservice.KhoiDN/Program.cs - Transaction consumer → Transaction service: invokes
- Login API → User account service: delegates to
- User auth service → User account service: delegates to
SmartParking.User.Microservice.KhoiDN/Controllers/AuthController.cs - User account service → Account repository: authenticates via
SU26_PRN232_Payment.Services.KhoiDN/SystemUserAccountService.cs - Invoice repository → Generic repository: inherits
SU26_PRN232_Payment.Repositories.KhoiDN/InvoicesKhoiDnRepository.cs - Account repository → Generic repository: inherits
SU26_PRN232_Payment.Repositories.KhoiDN/SystemUserAccountRepository.cs - Transaction repository → Generic repository: inherits
SU26_PRN232_Payment.Repositories.KhoiDN/TransactionsKhoiDnRepository.cs - Generic repository → Payment DbContext: queries and saves
SU26_PRN232_Payment.Repositories.KhoiDN/Base/GenericRepository.cs - Invoice repository → Payment DbContext: queries invoices
SU26_PRN232_Payment.Repositories.KhoiDN/InvoicesKhoiDnRepository.cs - Account repository → Payment DbContext: queries accounts
SU26_PRN232_Payment.Repositories.KhoiDN/SystemUserAccountRepository.cs - Payment DbContext → SQL Server: persists
- Payment DbContext → Invoice entity: maps
SU26_PRN232_Payment.Repositories.KhoiDN/DBContext/SmartParking_PaymentServiceContext.cs - Payment DbContext → Transaction entity: maps
SU26_PRN232_Payment.Repositories.KhoiDN/DBContext/SmartParking_PaymentServiceContext.cs - Payment DbContext → User account entity: maps
SU26_PRN232_Payment.Repositories.KhoiDN/DBContext/SmartParking_PaymentServiceContext.cs - Invoice API → RabbitMQ: publishes via setup
- Transaction service host → RabbitMQ: consumes queue
SmartParking.Transactions.Microservice.KhoiDN/Program.cs - Notification service → Completion consumer: registers
SmartParking.Notification.SignalRService.KhoiDN/Program.cs - Completion consumer → Transaction-completed event: handles
SmartParking.Notification.SignalRService.KhoiDN/Consumers/TransactionCompletedConsumer.cs - Completion consumer → Notification hub: notifies
SmartParking.Notification.SignalRService.KhoiDN/Consumers/TransactionCompletedConsumer.cs - Invoice-created event → RabbitMQ: event type
- Transaction-completed event → RabbitMQ: event type
- Invoice API → Loki logging: writes logs
- Transaction service host → Loki logging: writes logs
SmartParking.Transactions.Microservice.KhoiDN/Program.cs