How turb0xx/phonehub-backend works
PhoneHub is a phone-inventory and point-of-sale API. Requests enter product, sale, invoice, or user/token endpoints; services apply business rules and use repositories to access relational state. The sale workflow checks product stock and user activity, reduces inventory, records the sale, and supports annulment and daily cash-close reporting. Product inventory ingress and invoice/user management are separate capabilities. The sampled files establish several service-to-repository calls; other subsystem links are shown only where the source index or API excerpts support them.
Main entry points: SaleRepository.cs Sale repository · SaleService.cs Sale service · ProductRepository.cs Product repository · UserService.cs User service
Components 20
HTTP API
- Products API
PhoneHub.Api/Controllers/ProductController.cs - Sales API
PhoneHub.Api/Controllers/SaleController.cs - Invoices API
PhoneHub.Api/Controllers/InvoiceController.cs - Users API
PhoneHub.Api/Controllers/UserController.cs - Token API
PhoneHub.Api/Controllers/TokenController.cs
Business Services
- Product service
PhoneHub.Services/Services/ProductService.cs - Sale service
PhoneHub.Services/Services/SaleService.cs - Invoice service
PhoneHub.Services/Services/InvoiceService.cs
Persistence
- Product repository
PhoneHub.Infrastructure/Repositories/ProductRepository.cs - Sale repository
PhoneHub.Infrastructure/Repositories/SaleRepository.cs - Invoice repository
PhoneHub.Infrastructure/Repositories/InvoiceRepository.cs - Unit of work
PhoneHub.Infrastructure/Repositories/UnitOfWork.cs - EF context
PhoneHub.Infrastructure/Data/PhoneHubContext.cs - Dapper context
PhoneHub.Infrastructure/Data/DapperContext.cs - Sale queries
PhoneHub.Infrastructure/Queries/SaleQueries.cs
Identity
- User service
PhoneHub.Services/Services/UserService.cs - User repository
PhoneHub.Infrastructure/Repositories/UserRepository.cs - Password service
PhoneHub.Services/Services/PasswordService.cs
Other components
- API client
- Relational database
Connections 27
- API client → Products API: requests
PhoneHub.Api/Controllers/ProductController.cs - API client → Sales API: requests
PhoneHub.Api/Controllers/SaleController.cs - API client → Invoices API: requests
PhoneHub.Api/Controllers/InvoiceController.cs - API client → Users API: requests
PhoneHub.Api/Controllers/UserController.cs - API client → Token API: requests
PhoneHub.Api/Controllers/TokenController.cs - Products API → Product service: delegates
PhoneHub.Api/Controllers/ProductController.cs - Sales API → Sale service: delegates
PhoneHub.Api/Controllers/SaleController.cs - Invoices API → Invoice service: delegates
PhoneHub.Api/Controllers/InvoiceController.cs - Users API → User service: delegates
PhoneHub.Api/Controllers/UserController.cs - Token API → User service: authenticates
PhoneHub.Api/Controllers/TokenController.cs - Product service → Product repository: accesses
PhoneHub.Services/Services/ProductService.cs - Product service → Sale repository: checks sales
PhoneHub.Services/Services/ProductService.cs - Sale service → Product repository: checks stock
PhoneHub.Services/Services/SaleService.cs - Sale service → Sale repository: records sales
PhoneHub.Services/Services/SaleService.cs - Sale service → User repository: checks user
PhoneHub.Services/Services/SaleService.cs - User service → User repository: manages users
PhoneHub.Services/Services/UserService.cs - User service → Password service: uses passwords
PhoneHub.Services/Services/UserService.cs - Invoice service → Invoice repository: accesses
- Product repository → EF context: uses
PhoneHub.Infrastructure/Repositories/ProductRepository.cs - Sale repository → EF context: uses
PhoneHub.Infrastructure/Repositories/SaleRepository.cs - Invoice repository → EF context: uses
PhoneHub.Infrastructure/Repositories/InvoiceRepository.cs - Product repository → Dapper context: queries
PhoneHub.Infrastructure/Repositories/ProductRepository.cs - Sale repository → Dapper context: queries
PhoneHub.Infrastructure/Repositories/SaleRepository.cs - Invoice repository → Dapper context: queries
PhoneHub.Infrastructure/Repositories/InvoiceRepository.cs - Sale repository → Sale queries: selects SQL
PhoneHub.Infrastructure/Repositories/SaleRepository.cs - EF context → Relational database: reads/writes
- Dapper context → Relational database: executes SQL