# mdiqbalhossan/pharmacy-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/mdiqbalhossan/pharmacy-management-system
- Repository: https://github.com/mdiqbalhossan/pharmacy-management-system

## Overview

##### Main Architecture Components

a) Client Layer
- Vue.js frontend components (found in resources/js)
- Inertia.js as the connecting layer between frontend and backend
- TailwindCSS for styling

b) Application Layer
- Laravel Framework core
- Authentication system
- Controllers layer
- Middleware layer
- Models layer

c) Data Layer
- Database (MySQL/PostgreSQL)
- Cache storage
- File storage system

##### Specific Components

Frontend Section:
- Auth components
- Layout components
- Pages (Dashboard, Category, Company, Location, Supplier)
- Shared components

Backend Section:
- Controllers hierarchy:
- Base Controller
- Auth Controllers
- Resource Controllers (Category, Company, Location, Supplier, Medicine)
- Models structure:
- User
- Medicine
- Category
- Company
- Location
- Supplier
- Middleware components:
- Authentication
- CSRF Protection
- API handlers

Database Section:
- Tables and their relationships
- Migration system
- Seeders

##### Flow and Relationships

- HTTP request flow from client to server
- Database queries and responses
- Authentication flow
- API endpoints and their connections to controllers
- Model relationships

##### Important Elements to Highlight

- Security layers (authentication, CSRF)
- MVC pattern implementation
- API routes and endpoints
- Database relationships
- Frontend component hierarchy

##### Specific Implementation Details

**[Vue.js Frontend] → [Inertia.js] → [Laravel Backend] → [Database]**

With sub-sections:
**Frontend:**
- Pages (Vue components)
- Layouts
- Shared Components
- Forms

**Backend:**
- Routes
- Controllers
- Models
- Middleware
- Services

**Database:**
- Tables
- Relationships
- Migrations

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        VueJS["Vue.js Frontend"]:::frontend
        click VueJS "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/resources/js"
        Pages["Pages Components"]:::frontend
        click Pages "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/resources/js/Pages"
        Layout["Layout Components"]:::frontend
        click Layout "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/resources/js/Layouts"
        Shared["Shared Components"]:::frontend
        click Shared "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/resources/js/Components"
        
        VueJS --> Pages
        VueJS --> Layout
        VueJS --> Shared
    end

    subgraph Auth
        AuthPages["Auth Pages"]:::auth
        click AuthPages "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/resources/js/Pages/Auth"
        AuthControllers["Auth Controllers"]:::auth
        click AuthControllers "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/app/Http/Controllers/Auth"
        
        AuthPages --> AuthControllers
    end

    subgraph Application
        Controllers["Main Controllers"]:::backend
        click Controllers "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/app/Http/Controllers"
        
        Middleware["Middleware Layer"]:::backend
        click Middleware "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/app/Http/Middleware"
        
        Routes["Routing System"]:::backend
        WebRoutes["Web Routes"]:::route
        click WebRoutes "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/routes/web.php"
        ApiRoutes["API Routes"]:::route
        click ApiRoutes "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/routes/api.php"
        AuthRoutes["Auth Routes"]:::route
        click AuthRoutes "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/routes/auth.php"
        
        Routes --> WebRoutes
        Routes --> ApiRoutes
        Routes --> AuthRoutes
        
        Config["App Configuration"]:::backend
        click Config "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/config"
    end

    subgraph "Entity Controllers"
        MedicineCtrl["Medicine Controller"]:::controller
        CategoryCtrl["Category Controller"]:::controller
        click CategoryCtrl "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Http/Controllers/CategoryController.php"
        CompanyCtrl["Company Controller"]:::controller
        click CompanyCtrl "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Http/Controllers/CompanyController.php"
        LocationCtrl["Location Controller"]:::controller
        click LocationCtrl "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Http/Controllers/LocationController.php"
        SupplierCtrl["Supplier Controller"]:::controller
        click SupplierCtrl "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Http/Controllers/SupplierController.php"
    end

    subgraph "Data Layer"
        Models["Data Models"]:::data
        click Models "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/app/Models"
        
        Medicine["Medicine Model"]:::model
        click Medicine "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Models/Medicine.php"
        Category["Category Model"]:::model
        click Category "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Models/Category.php"
        Company["Company Model"]:::model
        click Company "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Models/Company.php"
        Location["Location Model"]:::model
        click Location "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Models/Location.php"
        Supplier["Supplier Model"]:::model
        click Supplier "https://github.com/mdiqbalhossan/Pharmacy-Management-System/blob/main/app/Models/Supplier.php"
        
        Database["Database"]:::storage
        Migrations["Migrations"]:::data
        click Migrations "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/database/migrations"
        Seeders["Seeders"]:::data
        click Seeders "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/database/seeders"
        
        FileStorage["File Storage"]:::storage
        click FileStorage "https://github.com/mdiqbalhossan/Pharmacy-Management-System/tree/main/storage/app"
    end

    Client --> Auth
    Auth --> Application
    Application --> |CRUD Operations| EntityControllers
    EntityControllers --> DataLayer

    %% Relationships
    MedicineCtrl --> Medicine
    CategoryCtrl --> Category
    CompanyCtrl --> Company
    LocationCtrl --> Location
    SupplierCtrl --> Supplier

    %% Styling
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef auth fill:#9b59b6,stroke:#8e44ad,color:white
    classDef data fill:#e67e22,stroke:#d35400,color:white
    classDef storage fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef model fill:#e67e22,stroke:#d35400,color:white
    classDef controller fill:#2ecc71,stroke:#27ae60,color:white
    classDef route fill:#3498db,stroke:#2980b9,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        BackendComp["Backend Component"]:::backend
        AuthComp["Auth Component"]:::auth
        DataComp["Data Component"]:::data
        StorageComp["Storage Component"]:::storage
    end
```
