How mengheak/mart-management-window-form works
MiniMart is a Windows Forms point-of-sale and stock-management desktop application backed by SQL Server. A cashier signs in, searches products, builds a cart, applies a discount, accepts tender, and completes checkout; the sale service validates stock and payment before the repository persists the sale transactionally, then the UI displays a receipt. Other documented product areas include inventory and category maintenance, user administration, low-stock monitoring, and sales reporting/history. README and sampled files establish the layered design; several form and service connections are shown only by the README or remain unverified.
Main entry points: AppServices.cs Service wiring · SaleService.cs Checkout service · InventoryService.cs Inventory service · PosForm.cs Point of sale
Components 30
Desktop UI
- Application startup
src/MiniMart.Presentation/Program.cs - Service wiring
src/MiniMart.Presentation/AppServices.cs - Sign-in and setup
src/MiniMart.Presentation/Forms/LoginForm.cs - Point of sale
src/MiniMart.Presentation/Forms/PosForm.cs - Receipt display
src/MiniMart.Presentation/Forms/ReceiptForm.cs - Admin dashboard
src/MiniMart.Presentation/Forms/AdminDashboardForm.cs - Catalog maintenance
src/MiniMart.Presentation/Forms/ProductListForm.cs - Category maintenance
src/MiniMart.Presentation/Forms/CategoryListForm.cs - Stock monitoring
src/MiniMart.Presentation/Forms/LowStockForm.cs - Sales history
src/MiniMart.Presentation/Forms/SalesHistoryForm.cs - User administration
src/MiniMart.Presentation/Forms/UserListForm.cs
Business services
- Authentication
src/MiniMart.BusinessLogic/Services/AuthService.cs - Checkout service
src/MiniMart.BusinessLogic/Services/SaleService.cs - Cart and sale domain
src/MiniMart.BusinessLogic/Models/Cart.cs - Discount strategies
src/MiniMart.BusinessLogic/Discounts/DiscountStrategy.cs - Inventory service
src/MiniMart.BusinessLogic/Services/InventoryService.cs - Category service
src/MiniMart.BusinessLogic/Services/CategoryService.cs - User service
src/MiniMart.BusinessLogic/Services/UserService.cs - Sales reporting
src/MiniMart.BusinessLogic/Services/ReportingService.cs - Product rules
src/MiniMart.BusinessLogic/Models/Product.cs - Business exceptions
src/MiniMart.BusinessLogic/Exceptions/BusinessRuleException.cs - Repository contracts
src/MiniMart.BusinessLogic/Repositories/IProductRepository.cs
SQL persistence
- SQL connection factory
src/MiniMart.DataAccess/Infrastructure/ISqlConnectionFactory.cs - SQL query helpers
src/MiniMart.DataAccess/Infrastructure/SqlRepositoryBase.cs - Product repository
src/MiniMart.DataAccess/Repositories/ProductRepository.cs - Category repository
src/MiniMart.DataAccess/Repositories/CategoryRepository.cs - Sale repository
src/MiniMart.DataAccess/Repositories/SaleRepository.cs - User repository
src/MiniMart.DataAccess/Repositories/UserRepository.cs
Other components
- Cashier
- SQL Server
Connections 46
- Cashier → Application startup: starts
src/MiniMart.Presentation/Program.cs - Application startup → Service wiring: configures
src/MiniMart.Presentation/Program.cs - Application startup → Sign-in and setup: opens
src/MiniMart.Presentation/Program.cs - Sign-in and setup → Authentication: authenticates
- Authentication → User repository: looks up user
src/MiniMart.BusinessLogic/Services/AuthService.cs - Service wiring → User repository: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Product repository: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Category repository: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Sale repository: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Inventory service: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Category service: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Authentication: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → User service: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Sales reporting: constructs
src/MiniMart.Presentation/AppServices.cs - Service wiring → Checkout service: creates
src/MiniMart.Presentation/AppServices.cs - Point of sale → Service wiring: uses
src/MiniMart.Presentation/Forms/PosForm.cs - Point of sale → Checkout service: checks out
src/MiniMart.Presentation/Forms/PosForm.cs - Point of sale → Cart and sale domain: updates cart
src/MiniMart.Presentation/Forms/PosForm.cs - Point of sale → Inventory service: searches products
src/MiniMart.Presentation/Forms/PosForm.cs - Point of sale → Receipt display: shows receipt
src/MiniMart.Presentation/Forms/PosForm.cs - Checkout service → Cart and sale domain: quotes cart
src/MiniMart.BusinessLogic/Services/SaleService.cs - Checkout service → Discount strategies: applies discount
src/MiniMart.BusinessLogic/Services/SaleService.cs - Checkout service → Product repository: checks stock
src/MiniMart.BusinessLogic/Services/SaleService.cs - Checkout service → Sale repository: saves sale
src/MiniMart.BusinessLogic/Services/SaleService.cs - Checkout service → Business exceptions: rejects invalid sale
src/MiniMart.BusinessLogic/Services/SaleService.cs - Inventory service → Product repository: reads and updates
src/MiniMart.BusinessLogic/Services/InventoryService.cs - Inventory service → Category repository: uses categories
src/MiniMart.BusinessLogic/Services/InventoryService.cs - Category service → Category repository: manages categories
src/MiniMart.BusinessLogic/Services/CategoryService.cs - User service → User repository: manages users
src/MiniMart.BusinessLogic/Services/UserService.cs - Sales reporting → Sale repository: requests reports
- Catalog maintenance → Inventory service: manages catalog
- Category maintenance → Category service: manages categories
- Stock monitoring → Inventory service: views low stock
- Sales history → Sales reporting: views sales
src/MiniMart.Presentation/Forms/SalesHistoryForm.cs - User administration → User service: manages users
- Admin dashboard → Catalog maintenance: opens
- Product repository → SQL query helpers: uses query helpers
src/MiniMart.DataAccess/Repositories/ProductRepository.cs - Category repository → SQL query helpers: uses query helpers
src/MiniMart.DataAccess/Repositories/CategoryRepository.cs - Sale repository → SQL query helpers: uses query helpers
src/MiniMart.DataAccess/Repositories/SaleRepository.cs - User repository → SQL query helpers: uses query helpers
src/MiniMart.DataAccess/Repositories/UserRepository.cs - SQL query helpers → SQL connection factory: opens connections
src/MiniMart.DataAccess/Infrastructure/SqlRepositoryBase.cs - SQL connection factory → SQL Server: connects
- Product repository → SQL Server: reads and writes
- Category repository → SQL Server: reads and writes
- Sale repository → SQL Server: persists transaction
src/MiniMart.DataAccess/Repositories/SaleRepository.cs - User repository → SQL Server: reads and writes