# drilonkrivaqa/smartstock architecture

> Architecture diagram of the GitHub repository drilonkrivaqa/smartstock, 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/drilonkrivaqa/smartstock
- Repository: https://github.com/drilonkrivaqa/smartstock

## Overview

SmartStock is a Flutter inventory-management application, but its README is only the default project template and the sampled source contains platform launchers rather than Dart application code. The tree indicates product, stock, sales, checkout, promotions, replenishment, audit, location, reports, and settings areas. The graph maps those named components and the likely user workflow; dashed, uncited links are explicitly unverified rather than claims about inspected calls.

Main entry points: [`lib/services/stock_service.dart`](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/stock_service.dart) (Stock Management), [`lib/pages/home_page.dart`](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/home_page.dart) (Home Dashboard), [`lib/services/hive_service.dart`](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/hive_service.dart) (Local Storage), [`lib/services/sale_service.dart`](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/sale_service.dart) (Sales Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_entry["App Entry<br/>[main.dart]"]
  node_shell["Main Shell<br/>[main_shell.dart]"]
  node_home["Home Dashboard<br/>[home_page.dart]"]
  node_settings["Settings<br/>[settings_page.dart]"]
end

subgraph group_operations["Inventory Operations"]
  node_products["Product Management"]
  node_product_detail["Product Detail"]
  node_product_service["Product Service"]
  node_stock["Stock Management<br/>[stock_service.dart]"]
  node_adjustment["Stock Adjustment"]
  node_movement["Stock Movements"]
  node_audit["Inventory Audits"]
  node_locations["Locations"]
  node_replenishment["Replenishment"]
end

subgraph group_commerce["Sales and Pricing"]
  node_checkout["Checkout<br/>[checkout_page.dart]"]
  node_sales["Sales Records<br/>[sale_service.dart]"]
  node_sales_page["Sales View<br/>[sales_page.dart]"]
  node_pricing["Promotion Engine"]
  node_reports["Reports<br/>[reports_page.dart]"]
end

subgraph group_data["Models and Storage"]
  node_settings_service["Settings Service"]
  node_hive[("Local Storage<br/>[hive_service.dart]")]
  node_product_model["Product Data<br/>[product.dart]"]
  node_stock_model["Stock Data<br/>[stock_item.dart]"]
  node_sale_model["Sale Data<br/>[sale.dart]"]
  node_audit_model["Audit Data<br/>[audit.dart]"]
  node_location_model["Location Data<br/>[location.dart]"]
  node_price_rule["Price Rules<br/>[price_rule.dart]"]
  node_replenishment_model["Replenishment Data<br/>[replenishment.dart]"]
end

node_user(("Store User"))

node_user -.->|"opens app"| node_entry
node_entry -.->|"starts shell"| node_shell
node_shell -.->|"shows dashboard"| node_home
node_home -.->|"opens products"| node_products
node_products -.->|"uses"| node_product_service
node_product_detail -.->|"uses"| node_product_service
node_home -.->|"views stock"| node_stock
node_adjustment -.->|"requests adjustment"| node_stock
node_stock -.->|"records"| node_movement
node_home -.->|"opens audits"| node_audit
node_home -.->|"views locations"| node_locations
node_home -.->|"views replenishment"| node_replenishment
node_checkout -.->|"applies promotions"| node_pricing
node_checkout -.->|"records sale"| node_sales
node_sales -.->|"updates stock"| node_stock
node_sales_page -.->|"loads sales"| node_sales
node_reports -.->|"uses sales data"| node_sales
node_reports -.->|"uses stock data"| node_stock
node_settings -.->|"uses"| node_settings_service
node_product_service -.->|"persists data"| node_hive
node_stock -.->|"persists data"| node_hive
node_sales -.->|"persists data"| node_hive
node_audit -.->|"persists data"| node_hive
node_locations -.->|"persists data"| node_hive
node_replenishment -.->|"persists data"| node_hive
node_settings_service -.->|"persists settings"| node_hive
node_product_service -.->|"uses model"| node_product_model
node_stock -.->|"uses model"| node_stock_model
node_sales -.->|"uses model"| node_sale_model
node_audit -.->|"uses model"| node_audit_model
node_locations -.->|"uses model"| node_location_model
node_pricing -.->|"uses rules"| node_price_rule
node_replenishment -.->|"uses model"| node_replenishment_model

click node_entry "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/main.dart"
click node_shell "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/main_shell.dart"
click node_home "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/home_page.dart"
click node_products "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/product_form_page.dart"
click node_product_detail "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/product_detail_page.dart"
click node_product_service "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/product_service.dart"
click node_stock "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/stock_service.dart"
click node_adjustment "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/stock_adjustment_dialog.dart"
click node_movement "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/stock_movement.dart"
click node_audit "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/inventory_audit_service.dart"
click node_locations "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/location_service.dart"
click node_replenishment "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/replenishment_service.dart"
click node_checkout "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/checkout_page.dart"
click node_sales "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/sale_service.dart"
click node_sales_page "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/sales_page.dart"
click node_pricing "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/promotion_engine.dart"
click node_reports "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/reports_page.dart"
click node_settings "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/settings_page.dart"
click node_settings_service "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/settings_service.dart"
click node_hive "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/hive_service.dart"
click node_product_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/product.dart"
click node_stock_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/stock_item.dart"
click node_sale_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/sale.dart"
click node_audit_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/audit.dart"
click node_location_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/location.dart"
click node_price_rule "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/price_rule.dart"
click node_replenishment_model "https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/replenishment.dart"

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_entry,node_shell,node_home,node_settings,node_user toneBlue
class node_products,node_product_detail,node_product_service,node_stock,node_adjustment,node_movement,node_audit,node_locations,node_replenishment toneAmber
class node_checkout,node_sales,node_sales_page,node_pricing,node_reports toneMint
class node_settings_service,node_hive,node_product_model,node_stock_model,node_sale_model,node_audit_model,node_location_model,node_price_rule,node_replenishment_model toneRose
```

## Components

### Application Shell

- [App Entry](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/main.dart): `lib/main.dart`
- [Main Shell](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/main_shell.dart): `lib/pages/main_shell.dart`
- [Home Dashboard](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/home_page.dart): `lib/pages/home_page.dart`
- [Settings](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/settings_page.dart): `lib/pages/settings_page.dart`

### Inventory Operations

- [Product Management](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/product_form_page.dart): `lib/pages/product_form_page.dart`
- [Product Detail](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/product_detail_page.dart): `lib/pages/product_detail_page.dart`
- [Product Service](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/product_service.dart): `lib/services/product_service.dart`
- [Stock Management](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/stock_service.dart): `lib/services/stock_service.dart`
- [Stock Adjustment](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/stock_adjustment_dialog.dart): `lib/pages/stock_adjustment_dialog.dart`
- [Stock Movements](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/stock_movement.dart): `lib/models/stock_movement.dart`
- [Inventory Audits](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/inventory_audit_service.dart): `lib/services/inventory_audit_service.dart`
- [Locations](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/location_service.dart): `lib/services/location_service.dart`
- [Replenishment](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/replenishment_service.dart): `lib/services/replenishment_service.dart`

### Sales and Pricing

- [Checkout](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/checkout_page.dart): `lib/pages/checkout_page.dart`
- [Sales Records](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/sale_service.dart): `lib/services/sale_service.dart`
- [Sales View](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/sales_page.dart): `lib/pages/sales_page.dart`
- [Promotion Engine](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/promotion_engine.dart): `lib/services/promotion_engine.dart`
- [Reports](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/pages/reports_page.dart): `lib/pages/reports_page.dart`

### Models and Storage

- [Settings Service](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/settings_service.dart): `lib/services/settings_service.dart`
- [Local Storage](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/services/hive_service.dart): `lib/services/hive_service.dart`
- [Product Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/product.dart): `lib/models/product.dart`
- [Stock Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/stock_item.dart): `lib/models/stock_item.dart`
- [Sale Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/sale.dart): `lib/models/sale.dart`
- [Audit Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/audit.dart): `lib/models/audit.dart`
- [Location Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/location.dart): `lib/models/location.dart`
- [Price Rules](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/price_rule.dart): `lib/models/price_rule.dart`
- [Replenishment Data](https://github.com/drilonkrivaqa/smartstock/blob/main/lib/models/replenishment.dart): `lib/models/replenishment.dart`

### Other components

- **Store User**

## Connections

- Store User → App Entry: opens app
- App Entry → Main Shell: starts shell
- Main Shell → Home Dashboard: shows dashboard
- Home Dashboard → Product Management: opens products
- Product Management → Product Service: uses
- Product Detail → Product Service: uses
- Home Dashboard → Stock Management: views stock
- Stock Adjustment → Stock Management: requests adjustment
- Stock Management → Stock Movements: records
- Home Dashboard → Inventory Audits: opens audits
- Home Dashboard → Locations: views locations
- Home Dashboard → Replenishment: views replenishment
- Checkout → Promotion Engine: applies promotions
- Checkout → Sales Records: records sale
- Sales Records → Stock Management: updates stock
- Sales View → Sales Records: loads sales
- Reports → Sales Records: uses sales data
- Reports → Stock Management: uses stock data
- Settings → Settings Service: uses
- Product Service → Local Storage: persists data
- Stock Management → Local Storage: persists data
- Sales Records → Local Storage: persists data
- Inventory Audits → Local Storage: persists data
- Locations → Local Storage: persists data
- Replenishment → Local Storage: persists data
- Settings Service → Local Storage: persists settings
- Product Service → Product Data: uses model
- Stock Management → Stock Data: uses model
- Sales Records → Sale Data: uses model
- Inventory Audits → Audit Data: uses model
- Locations → Location Data: uses model
- Promotion Engine → Price Rules: uses rules
- Replenishment → Replenishment Data: uses model
