# safnimj/inventory-management-system architecture

> Architecture diagram of the GitHub repository safnimj/inventory-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/safnimj/inventory-management-system
- Repository: https://github.com/safnimj/inventory-management-system

## Overview

##### Project type and purpose
- This is a Windows-based full-stack desktop application (“Inventory Management System”) built with C# WinForms for the UI and SQL Server (.mdf) for persistence.
- Purpose: allow business users to authenticate, then manage customers, categories, products, orders and users, with order-summary reporting.

##### File structure
- Top-level:
- inventory.sln / inventory.csproj – Visual Studio solution & project
- App.config – holds the DB connection string
- inventorydb.mdf & inventorydb_log.ldf – SQL Server Express database files
- “inventory/” folder:
- *.cs and *.Designer.cs – WinForms UI definitions and code-behind (HomeForm, SplashForm, MainIn, ManageCustomers, ManageCategories, ManageProducts, ManageOrder, ViewOrders, ManageUser)
- Program.cs – application entry point and WinForms startup logic
- Properties/ – assembly metadata, resources, settings
- packages.config – any NuGet dependencies (e.g., ADO.NET provider or third-party controls)

##### README for additional insights
- Confirms features: authentication, CRUD on customers/categories/products/orders/users, print/view order summaries
- Mentions SQL scripts under “Database” (implied) and configuring connection in App.config

##### Key reminder
- Be comprehensive: list all forms and logical sub-components
- Essential flows without over-complicating: the goal is to show how data and control move through the system’s layers
- Iteratively refine: start with coarse layers, then expand each layer into its child components as necessary

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer: WinForms"
        direction TB
        SplashForm["SplashForm"]:::ui
        HomeForm["HomeForm"]:::ui
        MainIn["MainIn"]:::ui
        subgraph "Management Forms"
            direction TB
            ManageCustomers["ManageCustomers"]:::ui
            ManageCatogaries["ManageCatogaries"]:::ui
            ManageProducts["ManageProducts"]:::ui
            ManageOrder["ManageOrder"]:::ui
            ManageUser["ManageUser"]:::ui
        end
        ViewOrders["ViewOrders"]:::ui
    end

    %% Business Logic Layer
    BLL["Business Logic Layer"]:::bll

    %% Data Access Layer
    DAL["Data Access Layer\n(ADO.NET)"]:::dal

    %% Configuration
    AppConfig["App.config\n(DB Connection)"]:::config

    %% Database
    Database["SQL Server Express\n(inventorydb.mdf)"]:::db

    %% External Dependencies
    Packages["packages.config\n(NuGet)"]:::ext

    %% Connections
    SplashForm -->|"auth flow"| BLL
    HomeForm -->|"navigation calls"| BLL
    MainIn -->|"startup logic"| BLL
    ManageCustomers -->|"CRUD operations"| BLL
    ManageCatogaries -->|"CRUD operations"| BLL
    ManageProducts -->|"CRUD operations"| BLL
    ManageOrder -->|"order management"| BLL
    ViewOrders -->|"reporting"| BLL
    ManageUser -->|"user management"| BLL

    BLL -->|"calls DAL methods"| DAL
    DAL -->|"executes SQL"| Database
    Database -->|"returns data"| DAL
    DAL -->|"returns data"| BLL
    BLL -->|"binds data"| SplashForm
    BLL -->|"binds data"| HomeForm
    BLL -->|"binds data"| MainIn
    BLL -->|"binds data"| ManageCustomers
    BLL -->|"binds data"| ManageCatogaries
    BLL -->|"binds data"| ManageProducts
    BLL -->|"binds data"| ManageOrder
    BLL -->|"binds data"| ViewOrders
    BLL -->|"binds data"| ManageUser

    AppConfig -->|"provides connection string"| DAL
    Packages -->|"adds dependencies"| DAL

    %% Click Events
    click inventory.sln "https://github.com/safnimj/inventory-management-system/blob/master/inventory.sln"
    click inventory/inventory.csproj "https://github.com/safnimj/inventory-management-system/blob/master/inventory/inventory.csproj"
    click AppConfig "https://github.com/safnimj/inventory-management-system/blob/master/inventory/App.config"
    click SplashForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/SplashForm.cs"
    click SplashForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/SplashForm.Designer.cs"
    click SplashForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/SplashForm.resx"
    click HomeForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/HomeForm.cs"
    click HomeForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/HomeForm.Designer.cs"
    click HomeForm "https://github.com/safnimj/inventory-management-system/blob/master/inventory/HomeForm.resx"
    click MainIn "https://github.com/safnimj/inventory-management-system/blob/master/inventory/MainIn.cs"
    click MainIn "https://github.com/safnimj/inventory-management-system/blob/master/inventory/MainIn.Designer.cs"
    click MainIn "https://github.com/safnimj/inventory-management-system/blob/master/inventory/MainIn.resx"
    click ManageCustomers "https://github.com/safnimj/inventory-management-system/blob/master/inventory/Manage Customers.cs"
    click ManageCustomers "https://github.com/safnimj/inventory-management-system/blob/master/inventory/Manage Customers.Designer.cs"
    click ManageCustomers "https://github.com/safnimj/inventory-management-system/blob/master/inventory/Manage Customers.resx"
    click ManageCatogaries "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageCatogaries.cs"
    click ManageCatogaries "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageCatogaries.Designer.cs"
    click ManageCatogaries "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageCatogaries.resx"
    click ManageProducts "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageProducts.cs"
    click ManageProducts "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageProducts.Designer.cs"
    click ManageProducts "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageProducts.resx"
    click ManageOrder "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageOrder.cs"
    click ManageOrder "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageOrder.Designer.cs"
    click ManageOrder "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageOrder.resx"
    click ViewOrders "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ViewOrders.cs"
    click ViewOrders "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ViewOrders.Designer.cs"
    click ViewOrders "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ViewOrders.resx"
    click ManageUser "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageUser.cs"
    click ManageUser "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageUser.Designer.cs"
    click ManageUser "https://github.com/safnimj/inventory-management-system/blob/master/inventory/ManageUser.resx"
    click Program "https://github.com/safnimj/inventory-management-system/blob/master/inventory/Program.cs"
    click Packages "https://github.com/safnimj/inventory-management-system/blob/master/inventory/packages.config"

    %% Styles
    classDef ui fill:#8ecae6,stroke:#05668d,color:#000
    classDef bll fill:#ffd166,stroke:#ef476f,color:#000
    classDef dal fill:#f4a261,stroke:#e76f51,color:#000
    classDef db fill:#2a9d8f,stroke:#264653,color:#fff
    classDef config fill:#e0e0e0,stroke:#000,color:#000
    classDef ext fill:#bdb2ff,stroke:#5a189a,color:#000
```
