How lunalily-17/familyhardwarestore works
Family Hardware Store is a local-first store-management application with a Razor Pages web app and a WPF desktop variant sharing application, domain, and infrastructure layers. The main shop workflow is catalog and supplier setup, purchase receipt and stock increase, point-of-sale sales and receipt handling, then inventory and sales reporting. Backup/restore, role-based login, audit, export, settings, and printing are supporting capabilities. The legacy MVC API is present but treated as a separate, older implementation. Relationships are limited to source-index references, sampled calls, and README statements; unsampled page-to-service wiring is not asserted.
Main entry points: AppDbContext.cs EF data context · Program.cs Razor Pages app · PurchaseService.cs Purchase service · AuthService.cs Authentication
Components 28
Web Experience
- Razor Pages app
src/HardwareStore.Web/Program.cs - Catalog management
src/HardwareStore.Web/Pages/Products - Category management
src/HardwareStore.Web/Pages/Categories - Supplier management
src/HardwareStore.Web/Pages/Suppliers - Purchase workflow
src/HardwareStore.Web/Pages/Purchases - Sales and receipts
src/HardwareStore.Web/Pages/Sales - Reporting pages
src/HardwareStore.Web/Pages/Reports - Settings pages
src/HardwareStore.Web/Pages/Settings - Backup pages
src/HardwareStore.Web/Pages/Backup - Receipt printing
src/HardwareStore.Web/Printing
Business Operations
- Authentication
src/HardwareStore.Application/Services/AuthService.cs - Catalog services
src/HardwareStore.Application/Services/ProductService.cs - Purchase service
src/HardwareStore.Application/Services/PurchaseService.cs - Sales service
src/HardwareStore.Application/Services/SalesService.cs - Inventory service
src/HardwareStore.Application/Services/InventoryService.cs - Reporting service
src/HardwareStore.Application/Services/ReportingService.cs - Settings service
src/HardwareStore.Application/Services/SettingsService.cs - Audit service
src/HardwareStore.Application/Services/AuditService.cs
Shared Platform
- EF data context
src/HardwareStore.Infrastructure/Persistence/AppDbContext.cs - Store domain model
src/HardwareStore.Domain/Entities - Backup and restore
src/HardwareStore.Infrastructure/Services/BackupService.cs - CSV export
src/HardwareStore.Infrastructure/Services/CsvExportService.cs
Desktop Variant
- WPF desktop shell
src/HardwareStore.Desktop/App.xaml.cs
Legacy MVC API
- Legacy MVC API
legacy/FamilyHardwareStore.Api.mvc/Program.cs - Legacy product workflow
legacy/FamilyHardwareStore.Api.mvc/Services/ProductService.cs - Legacy sales workflow
legacy/FamilyHardwareStore.Api.mvc/Services/SalesService.cs - Legacy EF context
legacy/FamilyHardwareStore.Api.mvc/Data/HardwareStoreDbContext.cs
Other components
- Shop operator
Connections 23
- Shop operator → Razor Pages app: uses
README.md - Razor Pages app → Authentication: registers services
src/HardwareStore.Web/Program.cs - Razor Pages app → Receipt printing: registers printer
src/HardwareStore.Web/Program.cs - Razor Pages app → EF data context: initializes data
src/HardwareStore.Web/Program.cs - Purchase workflow → Purchase service: submits purchases
- Sales and receipts → Sales service: submits sales
- Catalog management → Catalog services: manages catalog
- Reporting pages → Reporting service: requests reports
- Backup pages → Backup and restore: requests backup
- Settings pages → Settings service: updates settings
- Purchase service → EF data context: reads and writes
src/HardwareStore.Application/Services/PurchaseService.cs - Purchase service → Audit service: records action
src/HardwareStore.Application/Services/PurchaseService.cs - Purchase service → Store domain model: creates purchase records
src/HardwareStore.Application/Services/PurchaseService.cs - Authentication → EF data context: checks user
src/HardwareStore.Application/Services/AuthService.cs - Authentication → Audit service: records login
src/HardwareStore.Application/Services/AuthService.cs - Sales service → EF data context: reads and writes
src/HardwareStore.Application/Services/SalesService.cs - Sales service → Audit service: records action
src/HardwareStore.Application/Services/SalesService.cs - EF data context → Store domain model: persists entities
src/HardwareStore.Infrastructure/Persistence/AppDbContext.cs - Shop operator → WPF desktop shell: uses
README.md - Legacy MVC API → Legacy product workflow: routes requests
- Legacy MVC API → Legacy sales workflow: routes requests
- Legacy product workflow → Legacy EF context: reads and writes
legacy/FamilyHardwareStore.Api.mvc/Services/ProductService.cs - Legacy sales workflow → Legacy EF context: reads and writes
legacy/FamilyHardwareStore.Api.mvc/Services/SalesService.cs