# abdelbar472/inventory architecture

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

- Interactive diagram: https://gitdiagram.com/abdelbar472/inventory
- Repository: https://github.com/abdelbar472/inventory

## Overview

InventoryApi is a role-secured store-management Web API. Customers browse products and place orders; orders snapshot prices, reduce stock, and record movements. Employees manage order status and stock, while managers also maintain products/users and view reports. Controllers use EF Core for persistence; startup seeds SQLite, and a background worker plus order requests feed Prometheus metrics. README documents the broader API and monitoring setup; controller/source excerpts establish only some implementation links, so unsampled subsystem links are not inferred.

Main entry points: [`Data/AppDbContext.cs`](https://github.com/abdelbar472/inventory/blob/main/Data/AppDbContext.cs) (EF data model), [`Controllers/OrdersController.cs`](https://github.com/abdelbar472/inventory/blob/main/Controllers/OrdersController.cs) (Order handling), [`Models/Dtos.cs`](https://github.com/abdelbar472/inventory/blob/main/Models/Dtos.cs) (API contracts), [`Controllers/AuthController.cs`](https://github.com/abdelbar472/inventory/blob/main/Controllers/AuthController.cs) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_products_api["Product catalog"]
  node_orders_api["Order handling"]
  node_stock_api["Stock operations<br/>[StockController.cs]"]
  node_users_api["User administration<br/>[UsersController.cs]"]
  node_reports_api["Reports"]
end

subgraph group_domain["Store domain"]
  node_contracts["API contracts<br/>[Dtos.cs]"]
  node_product["Products<br/>[Product.cs]"]
  node_order["Orders<br/>[Order.cs]"]
  node_order_item["Order lines<br/>[OrderItem.cs]"]
  node_order_status["Order status<br/>[OrderStatus.cs]"]
  node_movement["Stock movements<br/>[StockMovement.cs]"]
  node_user["Users and roles<br/>[User.cs]"]
  node_role["Role definitions<br/>[Role.cs]"]
  node_password["Password hashing<br/>[PasswordHelper.cs]"]
end

subgraph group_persistence["Persistence"]
  node_dbcontext["EF data model<br/>[AppDbContext.cs]"]
  node_sqlite[("SQLite store<br/>[appsettings.json]")]
  node_seeder["Sample data seeder<br/>[DbSeeder.cs]"]
  node_startup["Application startup<br/>[Program.cs]"]
end

subgraph group_observability["Metrics and monitoring"]
  node_order_metric["Order counter<br/>[AppMetrics.cs]"]
  node_low_stock_worker["Low-stock polling"]
  node_prometheus["Prometheus<br/>[prometheus.yml]"]
  node_grafana["Grafana dashboards<br/>[store-api.json]"]
end

node_clients(("Shop clients"))

node_clients -->|"requests login"| node_auth
node_clients -->|"browses catalog"| node_products_api
node_clients -->|"places orders"| node_orders_api
node_clients -->|"manages stock"| node_stock_api
node_clients -->|"manages users"| node_users_api
node_clients -->|"views reports"| node_reports_api
node_auth -->|"queries users"| node_dbcontext
node_auth -->|"verifies passwords"| node_password
node_auth -->|"accepts and returns"| node_contracts
node_products_api -->|"reads and saves"| node_dbcontext
node_products_api -->|"accepts product DTOs"| node_contracts
node_orders_api -->|"reads and saves"| node_dbcontext
node_orders_api -->|"accepts order DTOs"| node_contracts
node_orders_api -->|"increments counter"| node_order_metric
node_orders_api -->|"updates stock"| node_product
node_orders_api -->|"creates and updates"| node_order
node_orders_api -->|"creates lines"| node_order_item
node_orders_api -->|"records movement"| node_movement
node_stock_api -->|"reads and saves"| node_dbcontext
node_stock_api -->|"accepts stock DTOs"| node_contracts
node_users_api -->|"reads and saves"| node_dbcontext
node_users_api -->|"hashes passwords"| node_password
node_reports_api -->|"queries aggregates"| node_dbcontext
node_dbcontext -->|"persists entities"| node_sqlite
node_dbcontext -->|"maps entity"| node_user
node_dbcontext -->|"maps entity"| node_product
node_dbcontext -->|"maps entity"| node_order
node_dbcontext -->|"maps entity"| node_order_item
node_dbcontext -->|"maps entity"| node_movement
node_startup -->|"configures database"| node_dbcontext
node_startup -->|"runs seeding"| node_seeder
node_seeder -->|"writes sample data"| node_dbcontext
node_seeder -->|"hashes demo passwords"| node_password
node_startup -->|"registers worker"| node_low_stock_worker
node_low_stock_worker -->|"counts low stock"| node_dbcontext
node_low_stock_worker -->|"updates gauge"| node_order_metric
node_prometheus -.->|"scrapes metrics"| node_order_metric
node_prometheus -.->|"feeds dashboards"| node_grafana
node_contracts -->|"uses role values"| node_role
node_contracts -->|"uses status values"| node_order_status

click node_auth "https://github.com/abdelbar472/inventory/blob/main/Controllers/AuthController.cs"
click node_products_api "https://github.com/abdelbar472/inventory/blob/main/Controllers/ProductsController.cs"
click node_orders_api "https://github.com/abdelbar472/inventory/blob/main/Controllers/OrdersController.cs"
click node_stock_api "https://github.com/abdelbar472/inventory/blob/main/Controllers/StockController.cs"
click node_users_api "https://github.com/abdelbar472/inventory/blob/main/Controllers/UsersController.cs"
click node_reports_api "https://github.com/abdelbar472/inventory/blob/main/Controllers/ReportsController.cs"
click node_contracts "https://github.com/abdelbar472/inventory/blob/main/Models/Dtos.cs"
click node_product "https://github.com/abdelbar472/inventory/blob/main/Models/Product.cs"
click node_order "https://github.com/abdelbar472/inventory/blob/main/Models/Order.cs"
click node_order_item "https://github.com/abdelbar472/inventory/blob/main/Models/OrderItem.cs"
click node_order_status "https://github.com/abdelbar472/inventory/blob/main/Models/OrderStatus.cs"
click node_movement "https://github.com/abdelbar472/inventory/blob/main/Models/StockMovement.cs"
click node_user "https://github.com/abdelbar472/inventory/blob/main/Models/User.cs"
click node_role "https://github.com/abdelbar472/inventory/blob/main/Models/Role.cs"
click node_password "https://github.com/abdelbar472/inventory/blob/main/Services/PasswordHelper.cs"
click node_dbcontext "https://github.com/abdelbar472/inventory/blob/main/Data/AppDbContext.cs"
click node_sqlite "https://github.com/abdelbar472/inventory/blob/main/appsettings.json"
click node_seeder "https://github.com/abdelbar472/inventory/blob/main/Data/DbSeeder.cs"
click node_startup "https://github.com/abdelbar472/inventory/blob/main/Program.cs"
click node_order_metric "https://github.com/abdelbar472/inventory/blob/main/Services/AppMetrics.cs"
click node_low_stock_worker "https://github.com/abdelbar472/inventory/blob/main/Services/LowStockMetricsWorker.cs"
click node_prometheus "https://github.com/abdelbar472/inventory/blob/main/monitoring/prometheus/prometheus.yml"
click node_grafana "https://github.com/abdelbar472/inventory/blob/main/monitoring/grafana/dashboards/store-api.json"

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_auth,node_products_api,node_orders_api,node_stock_api,node_users_api,node_reports_api,node_clients toneBlue
class node_contracts,node_product,node_order,node_order_item,node_order_status,node_movement,node_user,node_role,node_password toneAmber
class node_dbcontext,node_sqlite,node_seeder,node_startup toneMint
class node_order_metric,node_low_stock_worker,node_prometheus,node_grafana toneRose
```

## Components

### API workflows

- [Authentication](https://github.com/abdelbar472/inventory/blob/main/Controllers/AuthController.cs): `Controllers/AuthController.cs`
- [Product catalog](https://github.com/abdelbar472/inventory/blob/main/Controllers/ProductsController.cs): `Controllers/ProductsController.cs`
- [Order handling](https://github.com/abdelbar472/inventory/blob/main/Controllers/OrdersController.cs): `Controllers/OrdersController.cs`
- [Stock operations](https://github.com/abdelbar472/inventory/blob/main/Controllers/StockController.cs): `Controllers/StockController.cs`
- [User administration](https://github.com/abdelbar472/inventory/blob/main/Controllers/UsersController.cs): `Controllers/UsersController.cs`
- [Reports](https://github.com/abdelbar472/inventory/blob/main/Controllers/ReportsController.cs): `Controllers/ReportsController.cs`

### Store domain

- [API contracts](https://github.com/abdelbar472/inventory/blob/main/Models/Dtos.cs): `Models/Dtos.cs`
- [Products](https://github.com/abdelbar472/inventory/blob/main/Models/Product.cs): `Models/Product.cs`
- [Orders](https://github.com/abdelbar472/inventory/blob/main/Models/Order.cs): `Models/Order.cs`
- [Order lines](https://github.com/abdelbar472/inventory/blob/main/Models/OrderItem.cs): `Models/OrderItem.cs`
- [Order status](https://github.com/abdelbar472/inventory/blob/main/Models/OrderStatus.cs): `Models/OrderStatus.cs`
- [Stock movements](https://github.com/abdelbar472/inventory/blob/main/Models/StockMovement.cs): `Models/StockMovement.cs`
- [Users and roles](https://github.com/abdelbar472/inventory/blob/main/Models/User.cs): `Models/User.cs`
- [Role definitions](https://github.com/abdelbar472/inventory/blob/main/Models/Role.cs): `Models/Role.cs`
- [Password hashing](https://github.com/abdelbar472/inventory/blob/main/Services/PasswordHelper.cs): `Services/PasswordHelper.cs`

### Persistence

- [EF data model](https://github.com/abdelbar472/inventory/blob/main/Data/AppDbContext.cs): `Data/AppDbContext.cs`
- [SQLite store](https://github.com/abdelbar472/inventory/blob/main/appsettings.json): `appsettings.json`
- [Sample data seeder](https://github.com/abdelbar472/inventory/blob/main/Data/DbSeeder.cs): `Data/DbSeeder.cs`
- [Application startup](https://github.com/abdelbar472/inventory/blob/main/Program.cs): `Program.cs`

### Metrics and monitoring

- [Order counter](https://github.com/abdelbar472/inventory/blob/main/Services/AppMetrics.cs): `Services/AppMetrics.cs`
- [Low-stock polling](https://github.com/abdelbar472/inventory/blob/main/Services/LowStockMetricsWorker.cs): `Services/LowStockMetricsWorker.cs`
- [Prometheus](https://github.com/abdelbar472/inventory/blob/main/monitoring/prometheus/prometheus.yml): `monitoring/prometheus/prometheus.yml`
- [Grafana dashboards](https://github.com/abdelbar472/inventory/blob/main/monitoring/grafana/dashboards/store-api.json): `monitoring/grafana/dashboards/store-api.json`

### Other components

- **Shop clients**

## Connections

- Shop clients → Authentication: requests login (evidence: `README.md`)
- Shop clients → Product catalog: browses catalog (evidence: `README.md`)
- Shop clients → Order handling: places orders (evidence: `README.md`)
- Shop clients → Stock operations: manages stock (evidence: `README.md`)
- Shop clients → User administration: manages users (evidence: `README.md`)
- Shop clients → Reports: views reports (evidence: `README.md`)
- Authentication → EF data model: queries users (evidence: `Controllers/AuthController.cs`)
- Authentication → Password hashing: verifies passwords (evidence: `Controllers/AuthController.cs`)
- Authentication → API contracts: accepts and returns (evidence: `Controllers/AuthController.cs`)
- Product catalog → EF data model: reads and saves (evidence: `Controllers/ProductsController.cs`)
- Product catalog → API contracts: accepts product DTOs (evidence: `Controllers/ProductsController.cs`)
- Order handling → EF data model: reads and saves (evidence: `Controllers/OrdersController.cs`)
- Order handling → API contracts: accepts order DTOs (evidence: `Controllers/OrdersController.cs`)
- Order handling → Order counter: increments counter (evidence: `Controllers/OrdersController.cs`)
- Order handling → Products: updates stock (evidence: `Controllers/OrdersController.cs`)
- Order handling → Orders: creates and updates (evidence: `Controllers/OrdersController.cs`)
- Order handling → Order lines: creates lines (evidence: `Controllers/OrdersController.cs`)
- Order handling → Stock movements: records movement (evidence: `Controllers/OrdersController.cs`)
- Stock operations → EF data model: reads and saves (evidence: `Controllers/StockController.cs`)
- Stock operations → API contracts: accepts stock DTOs (evidence: `Controllers/StockController.cs`)
- User administration → EF data model: reads and saves (evidence: `Controllers/UsersController.cs`)
- User administration → Password hashing: hashes passwords (evidence: `Controllers/UsersController.cs`)
- Reports → EF data model: queries aggregates (evidence: `Controllers/ReportsController.cs`)
- EF data model → SQLite store: persists entities (evidence: `README.md`)
- EF data model → Users and roles: maps entity (evidence: `Data/AppDbContext.cs`)
- EF data model → Products: maps entity (evidence: `Data/AppDbContext.cs`)
- EF data model → Orders: maps entity (evidence: `Data/AppDbContext.cs`)
- EF data model → Order lines: maps entity (evidence: `Data/AppDbContext.cs`)
- EF data model → Stock movements: maps entity (evidence: `Data/AppDbContext.cs`)
- Application startup → EF data model: configures database (evidence: `Program.cs`)
- Application startup → Sample data seeder: runs seeding (evidence: `Program.cs`)
- Sample data seeder → EF data model: writes sample data (evidence: `Data/DbSeeder.cs`)
- Sample data seeder → Password hashing: hashes demo passwords (evidence: `Data/DbSeeder.cs`)
- Application startup → Low-stock polling: registers worker (evidence: `Program.cs`)
- Low-stock polling → EF data model: counts low stock (evidence: `Services/LowStockMetricsWorker.cs`)
- Low-stock polling → Order counter: updates gauge (evidence: `Services/LowStockMetricsWorker.cs`)
- Prometheus → Order counter: scrapes metrics (evidence: `README.md`)
- Prometheus → Grafana dashboards: feeds dashboards (evidence: `README.md`)
- API contracts → Role definitions: uses role values (evidence: `Models/Dtos.cs`)
- API contracts → Order status: uses status values (evidence: `Models/Dtos.cs`)
