# nicoc144/inventorymanagementapp architecture

> Architecture diagram of the GitHub repository nicoc144/inventorymanagementapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nicoc144/inventorymanagementapp
- Repository: https://github.com/nicoc144/inventorymanagementapp

## Overview

This is a .NET MAUI webstore client backed by a separate HTTP API and a shared client library. Users browse and manage inventory, manage carts and cart contents, and use shop-management and mass-import screens; view models invoke the library proxies, which send requests to the API. The API routes inventory and shop operations through domain components to persistence. The README documents SQL Server and an optional file-backed inventory mode. Relationships for unsampled modules are limited to SOURCE INDEX references and README statements.

Main entry points: [`WebStore.MAUI/ViewModels/ItemViewModel.cs`](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/ItemViewModel.cs) (Item workflow), [`WebStore.MAUI/Views`](https://github.com/nicoc144/inventorymanagementapp/tree/master/WebStore.MAUI/Views) (Shop and cart views), [`WebStore.Library/Services/ShoppingCartServiceProxy.cs`](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Services/ShoppingCartServiceProxy.cs) (Cart proxy), [`WebStore.MAUI/ViewModels/CartViewModel.cs`](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/CartViewModel.cs) (Cart workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["MAUI client"]
  node_mainpage["App entry page<br/>[MainPage.xaml.cs]"]
  node_itemvm["Item workflow<br/>[ItemViewModel.cs]"]
  node_inventoryvm["Inventory management"]
  node_cartvm["Cart workflow<br/>[CartViewModel.cs]"]
  node_cartmgmtvm["Cart management"]
  node_shopvm["Shop management"]
  node_clientviews["Shop and cart views<br/>[Views]"]
  node_massimport["Mass import view"]
end

subgraph group_library["Shared client library"]
  node_itemdto["Item transfer data<br/>[ItemDTO.cs]"]
  node_cartdto["Cart transfer data<br/>[ShoppingCartDTO.cs]"]
  node_itemmodel["Item model<br/>[Item.cs]"]
  node_cartmodel["Cart model<br/>[ShoppingCart.cs]"]
  node_itemproxy["Inventory proxy"]
  node_cartproxy["Cart proxy"]
  node_requesthandler["HTTP request handler"]
end

subgraph group_api["API domain"]
  node_api["Webstore API<br/>[Program.cs]"]
  node_inventorycontroller["Inventory routes"]
  node_shopcontroller["Shop routes<br/>[ShopController.cs]"]
  node_inventoryec["Inventory operations<br/>[InventoryEC.cs]"]
  node_shopex["Cart operations<br/>[ShopEC.cs]"]
end

subgraph group_persistence["Persistence"]
  node_sqlcontext["SQL data access<br/>[MSSQLContext.cs]"]
  node_filebase[("File inventory store<br/>[Filebase.cs]")]
end

node_shopper(("Shop user"))
node_sqlserver[("SQL Server")]
node_localfiles[("Local item files")]

node_shopper -->|"uses"| node_mainpage
node_mainpage -->|"opens workflow"| node_itemvm
node_clientviews -->|"renders"| node_itemvm
node_clientviews -->|"renders"| node_inventoryvm
node_clientviews -->|"renders"| node_cartvm
node_clientviews -->|"renders"| node_cartmgmtvm
node_clientviews -->|"renders"| node_shopvm
node_massimport -->|"uses"| node_inventoryvm
node_itemvm -->|"calls"| node_itemproxy
node_itemvm -->|"calls"| node_cartproxy
node_inventoryvm -->|"uses"| node_itemproxy
node_cartvm -->|"uses"| node_cartproxy
node_cartmgmtvm -->|"uses"| node_cartproxy
node_shopvm -->|"uses"| node_itemproxy
node_shopvm -->|"uses"| node_cartproxy
node_itemvm -->|"maps data"| node_itemdto
node_itemvm -->|"uses model"| node_itemmodel
node_cartvm -->|"maps data"| node_cartdto
node_cartvm -->|"creates item views"| node_itemvm
node_itemproxy -->|"sends requests"| node_requesthandler
node_cartproxy -->|"sends requests"| node_requesthandler
node_requesthandler -->|"HTTPS requests"| node_api
node_api -.->|"routes"| node_inventorycontroller
node_api -.->|"routes"| node_shopcontroller
node_inventorycontroller -->|"delegates to"| node_inventoryec
node_shopcontroller -->|"delegates to"| node_shopex
node_inventoryec -->|"uses"| node_sqlcontext
node_inventoryec -.->|"optional storage"| node_filebase
node_shopex -->|"uses"| node_sqlcontext
node_sqlcontext -->|"reads and writes"| node_sqlserver
node_filebase -->|"stores items"| node_localfiles

click node_mainpage "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/MainPage.xaml.cs"
click node_itemvm "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/ItemViewModel.cs"
click node_inventoryvm "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/InventoryManagementViewModel.cs"
click node_cartvm "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/CartViewModel.cs"
click node_cartmgmtvm "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/CartManagementViewModel.cs"
click node_shopvm "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/ShopManagementViewModel.cs"
click node_clientviews "https://github.com/nicoc144/inventorymanagementapp/tree/master/WebStore.MAUI/Views"
click node_massimport "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/Views/MassImportView.xaml.cs"
click node_itemdto "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/DTO/ItemDTO.cs"
click node_cartdto "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/DTO/ShoppingCartDTO.cs"
click node_itemmodel "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Models/Item.cs"
click node_cartmodel "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Models/ShoppingCart.cs"
click node_itemproxy "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Services/ItemServiceProxy.cs"
click node_cartproxy "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Services/ShoppingCartServiceProxy.cs"
click node_requesthandler "https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Utility/WebRequestHandler.cs"
click node_api "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Program.cs"
click node_inventorycontroller "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Controllers/InventoryController.cs"
click node_shopcontroller "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Controllers/ShopController.cs"
click node_inventoryec "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/EC/InventoryEC.cs"
click node_shopex "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/EC/ShopEC.cs"
click node_sqlcontext "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Database/MSSQLContext.cs"
click node_filebase "https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Database/Filebase.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mainpage,node_itemvm,node_inventoryvm,node_cartvm,node_cartmgmtvm,node_shopvm,node_clientviews,node_massimport,node_shopper toneBlue
class node_itemdto,node_cartdto,node_itemmodel,node_cartmodel,node_itemproxy,node_cartproxy,node_requesthandler,node_sqlserver,node_localfiles toneAmber
class node_api,node_inventorycontroller,node_shopcontroller,node_inventoryec,node_shopex toneMint
class node_sqlcontext,node_filebase toneRose
```

## Components

### MAUI client

- [App entry page](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/MainPage.xaml.cs): `WebStore.MAUI/MainPage.xaml.cs`
- [Item workflow](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/ItemViewModel.cs): `WebStore.MAUI/ViewModels/ItemViewModel.cs`
- [Inventory management](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/InventoryManagementViewModel.cs): `WebStore.MAUI/ViewModels/InventoryManagementViewModel.cs`
- [Cart workflow](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/CartViewModel.cs): `WebStore.MAUI/ViewModels/CartViewModel.cs`
- [Cart management](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/CartManagementViewModel.cs): `WebStore.MAUI/ViewModels/CartManagementViewModel.cs`
- [Shop management](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/ViewModels/ShopManagementViewModel.cs): `WebStore.MAUI/ViewModels/ShopManagementViewModel.cs`
- [Shop and cart views](https://github.com/nicoc144/inventorymanagementapp/tree/master/WebStore.MAUI/Views): `WebStore.MAUI/Views`
- [Mass import view](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.MAUI/Views/MassImportView.xaml.cs): `WebStore.MAUI/Views/MassImportView.xaml.cs`

### Shared client library

- [Item transfer data](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/DTO/ItemDTO.cs): `WebStore.Library/DTO/ItemDTO.cs`
- [Cart transfer data](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/DTO/ShoppingCartDTO.cs): `WebStore.Library/DTO/ShoppingCartDTO.cs`
- [Item model](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Models/Item.cs): `WebStore.Library/Models/Item.cs`
- [Cart model](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Models/ShoppingCart.cs): `WebStore.Library/Models/ShoppingCart.cs`
- [Inventory proxy](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Services/ItemServiceProxy.cs): `WebStore.Library/Services/ItemServiceProxy.cs`
- [Cart proxy](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Services/ShoppingCartServiceProxy.cs): `WebStore.Library/Services/ShoppingCartServiceProxy.cs`
- [HTTP request handler](https://github.com/nicoc144/inventorymanagementapp/blob/master/WebStore.Library/Utility/WebRequestHandler.cs): `WebStore.Library/Utility/WebRequestHandler.cs`

### API domain

- [Webstore API](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Program.cs): `eCommerce.API/eCommerce.API/Program.cs`
- [Inventory routes](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Controllers/InventoryController.cs): `eCommerce.API/eCommerce.API/Controllers/InventoryController.cs`
- [Shop routes](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Controllers/ShopController.cs): `eCommerce.API/eCommerce.API/Controllers/ShopController.cs`
- [Inventory operations](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/EC/InventoryEC.cs): `eCommerce.API/eCommerce.API/EC/InventoryEC.cs`
- [Cart operations](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/EC/ShopEC.cs): `eCommerce.API/eCommerce.API/EC/ShopEC.cs`

### Persistence

- [SQL data access](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Database/MSSQLContext.cs): `eCommerce.API/eCommerce.API/Database/MSSQLContext.cs`
- [File inventory store](https://github.com/nicoc144/inventorymanagementapp/blob/master/eCommerce.API/eCommerce.API/Database/Filebase.cs): `eCommerce.API/eCommerce.API/Database/Filebase.cs`

### Other components

- **Shop user**
- **SQL Server**
- **Local item files**

## Connections

- Shop user → App entry page: uses (evidence: `README.md`)
- App entry page → Item workflow: opens workflow (evidence: `WebStore.MAUI/MainPage.xaml.cs`)
- Shop and cart views → Item workflow: renders (evidence: `WebStore.MAUI/Views/ItemView.xaml.cs`)
- Shop and cart views → Inventory management: renders (evidence: `WebStore.MAUI/Views/InventoryManagementView.xaml.cs`)
- Shop and cart views → Cart workflow: renders (evidence: `WebStore.MAUI/Views/CartView.xaml.cs`)
- Shop and cart views → Cart management: renders (evidence: `WebStore.MAUI/Views/CartManagementView.xaml.cs`)
- Shop and cart views → Shop management: renders (evidence: `WebStore.MAUI/Views/ShopManagementView.xaml.cs`)
- Mass import view → Inventory management: uses (evidence: `WebStore.MAUI/Views/MassImportView.xaml.cs`)
- Item workflow → Inventory proxy: calls (evidence: `WebStore.MAUI/ViewModels/ItemViewModel.cs`)
- Item workflow → Cart proxy: calls (evidence: `WebStore.MAUI/ViewModels/ItemViewModel.cs`)
- Inventory management → Inventory proxy: uses (evidence: `WebStore.MAUI/ViewModels/InventoryManagementViewModel.cs`)
- Cart workflow → Cart proxy: uses (evidence: `WebStore.MAUI/ViewModels/CartViewModel.cs`)
- Cart management → Cart proxy: uses (evidence: `WebStore.MAUI/ViewModels/CartManagementViewModel.cs`)
- Shop management → Inventory proxy: uses (evidence: `WebStore.MAUI/ViewModels/ShopManagementViewModel.cs`)
- Shop management → Cart proxy: uses (evidence: `WebStore.MAUI/ViewModels/ShopManagementViewModel.cs`)
- Item workflow → Item transfer data: maps data (evidence: `WebStore.MAUI/ViewModels/ItemViewModel.cs`)
- Item workflow → Item model: uses model (evidence: `WebStore.MAUI/ViewModels/ItemViewModel.cs`)
- Cart workflow → Cart transfer data: maps data (evidence: `WebStore.MAUI/ViewModels/CartViewModel.cs`)
- Cart workflow → Item workflow: creates item views (evidence: `WebStore.MAUI/ViewModels/CartViewModel.cs`)
- Inventory proxy → HTTP request handler: sends requests (evidence: `WebStore.Library/Services/ItemServiceProxy.cs`)
- Cart proxy → HTTP request handler: sends requests (evidence: `WebStore.Library/Services/ShoppingCartServiceProxy.cs`)
- HTTP request handler → Webstore API: HTTPS requests (evidence: `README.md`)
- Webstore API → Inventory routes: routes
- Webstore API → Shop routes: routes
- Inventory routes → Inventory operations: delegates to (evidence: `eCommerce.API/eCommerce.API/Controllers/InventoryController.cs`)
- Shop routes → Cart operations: delegates to (evidence: `eCommerce.API/eCommerce.API/Controllers/ShopController.cs`)
- Inventory operations → SQL data access: uses (evidence: `eCommerce.API/eCommerce.API/EC/InventoryEC.cs`)
- Inventory operations → File inventory store: optional storage (evidence: `README.md`)
- Cart operations → SQL data access: uses (evidence: `eCommerce.API/eCommerce.API/EC/ShopEC.cs`)
- SQL data access → SQL Server: reads and writes (evidence: `eCommerce.API/eCommerce.API/Database/MSSQLContext.cs`)
- File inventory store → Local item files: stores items (evidence: `README.md`)
