# mabdulahadch/lesco-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/mabdulahadch/lesco-management-system
- Repository: https://github.com/mabdulahadch/lesco-management-system

## Overview

##### Main Components

A. Client Layer (UI Components):
- Customer Interface
- Dashboard
- Bill View
- CNIC Update
- Employee Interface
- Dashboard
- Bill Management
- Customer Management
- Reports Generation
- Tariff Management

B. Business Logic Layer (BL Components):
- Core Services
- Bill Management Service
- Customer Management Service
- Employee Management Service
- NADRA Verification Service
- Tariff Management Service
- Server Component
- LESCO Server (handles client-server communication)

C. Data Layer (DB Components):
- File-based Storage System
- Customer Information Store
- Billing Information Store
- Employee Data Store
- NADRA Database
- Traffic Tax Information Store

**[UI Layer (Top)]**
- ↕
**[Business Logic Layer (Middle)]**
- ↕
**[Data Layer (Bottom)]**

##### Component Relationships to Highlight

- Data flow between business logic services and data stores
- Client-server communication pattern
- Authentication flow for both customer and employee access

##### Technical Details

- Java-based implementation
- File-based storage system
- Client-server architecture
- MVC pattern implementation in UI layer

##### Specific Component Relationships

- CustomerClient ↔ LescoServer
- EmployeeClient ↔ LescoServer
- LescoServer ↔ Data Stores
- UI Panels ↔ Corresponding Business Logic Classes
- NADRA Verification Flow

##### Notes Section

Notes about:
- File-based storage implementation
- Security considerations
- System requirements
- Scalability aspects

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef service fill:#2ecc71,stroke:#27ae60,color:white
    classDef data fill:#f1c40f,stroke:#f39c12,color:black
    classDef auth fill:#e74c3c,stroke:#c0392b,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white

    %% UI Layer
    subgraph UI
        CustUI["Customer Interface"]
        EmpUI["Employee Interface"]
        CLogin["Customer Login"]:::auth
        ELogin["Employee Login"]:::auth
        
        %% Customer UI Components
        CustUI --> CDash["Dashboard"]:::ui
        CustUI --> CBill["Bill View"]:::ui
        CustUI --> CCNIC["CNIC Update"]:::ui
        
        %% Employee UI Components
        EmpUI --> EDash["Dashboard"]:::ui
        EmpUI --> EBill["Bill Management"]:::ui
        EmpUI --> ECust["Customer Management"]:::ui
        EmpUI --> EReport["Reports Generation"]:::ui
        EmpUI --> ETariff["Tariff Management"]:::ui
    end

    %% Business Logic Layer
    subgraph BL
        %% Core Services
        BillServ["Bill Management Service"]:::service
        CustServ["Customer Management Service"]:::service
        EmpServ["Employee Management Service"]:::service
        NADRAServ["NADRA Verification Service"]:::service
        TariffServ["Tariff Management Service"]:::service
        
        %% Server Components
        LServer["LESCO Server"]:::service
        CClient["Customer Client"]:::service
        EClient["Employee Client"]:::service
    end

    %% Data Layer
    subgraph DB
        CustDB["Customer Information Store"]:::data
        BillDB["Billing Information Store"]:::data
        EmpDB["Employee Data Store"]:::data
        NADRADB["NADRA Database"]:::external
        TariffDB["Traffic Tax Information Store"]:::data
    end

    %% Relationships
    CLogin --> CClient
    ELogin --> EClient
    CClient --> LServer
    EClient --> LServer
    
    LServer --> BillServ
    LServer --> CustServ
    LServer --> EmpServ
    LServer --> NADRAServ
    LServer --> TariffServ
    
    BillServ --> BillDB
    CustServ --> CustDB
    EmpServ --> EmpDB
    NADRAServ --> NADRADB
    TariffServ --> TariffDB

    %% Click Events
    click CustUI "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/CustomerDashBoard.java"
    click EmpUI "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/EmployeeDashBoard.java"
    click CLogin "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/CustomerLogin.java"
    click ELogin "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/EmployeeLogin.java"
    click CBill "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/C_ViewBillPanel.java"
    click CCNIC "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/C_UpdateCNICPanel.java"
    click EBill "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/E_AddBillPanel.java"
    click ECust "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/E_AddCustomerPanel.java"
    click ETariff "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/E_UpdateTarrifTax.java"
    click EReport "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_UI/E_BillReportPanel.java"
    click BillServ "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/BillManagment.java"
    click CustServ "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/Customer.java"
    click EmpServ "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/Employee.java"
    click NADRAServ "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/NADRA.java"
    click TariffServ "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/TariffTax.java"
    click LServer "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/LescoServer.java"
    click CClient "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/CustomerClient.java"
    click EClient "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_BL/EmployeeClient.java"
    click CustDB "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_DB/CustomerInfo.txt"
    click BillDB "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_DB/BillingInfo.txt"
    click EmpDB "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_DB/EmployeesData.txt"
    click NADRADB "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_DB/NADRADB.txt"
    click TariffDB "https://github.com/mabdulahadch/LESCO-Management-system/blob/main/src/Package_DB/TrafficTaxInfo.txt"
```
