# kajjayamadithya/expense-tracker-website architecture

> Architecture diagram of the GitHub repository kajjayamadithya/expense-tracker-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kajjayamadithya/expense-tracker-website
- Repository: https://github.com/kajjayamadithya/expense-tracker-website

## Overview

##### Project Type and Purpose
- This is a static, front-end only web application (“Expense Tracker Website”) built with HTML, CSS (Bootstrap), and plain JavaScript.
- Its purpose is to let users add income/expense entries, view transaction history, calculate balances in real time, and delete transactions.

##### High-Level File-Structure Analysis
- Top-level files:
- loginpage.html, loginpage.css, loginpage.js
- trackerpage.html, trackerpage.css, trackerpage.js
- No backend or server directory—everything runs in the browser.
- No build scripts or external services; runs by opening index.html.

##### Main Architectural Components
a. Browser/Client
- Hosts the UI, executes HTML/CSS/JS.
b. UI Layer
- HTML pages (Login, Tracker)
- CSS (custom + Bootstrap)
c. Controller / Business-Logic Layer
- JavaScript modules that handle:
- Event listeners (form submission, delete buttons)
- Model updates (adding/removing transactions)
- Balance calculation (income vs. expense totals)
d. View-Rendering Layer
- DOM manipulation functions that:
- Insert transaction items into the list
- Update balance, total income, total expenses fields
e. Persistence Layer
- Browser storage (e.g., localStorage) to persist transactions across reloads
f. Data Model
- In-memory array or object collection representing transactions

##### Relationships and Data Flows
- User interacts with UI (fills form or clicks delete) →
Controller captures event →
- Updates Data Model →
- Persists change to localStorage →
- Invokes View module to re-render transaction list and recalculated balances.
- On page load: Controller reads persisted transactions → initializes View.

##### Architectural Patterns and Principles
- MVC-style separation:
- Model: transaction data
- View: DOM updates & CSS styling
- Controller: event handling and business logic
- Single-page behavior for the tracker: two distinct HTML “pages” but could be treated as two views in one client app.
- Progressive enhancement: works with vanilla JS + Bootstrap, no dependencies on frameworks.

##### Essential Elements
- Clear, concise component labels matching actual file names/directories
- Notes on key technologies (HTML5, CSS3 with Bootstrap, ES6 JavaScript, localStorage API)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        LPHTML["Login Page<br/>(loginpage.html)"]:::ui
        LPCSS["loginpage.css"]:::ui
        TPHTML["Tracker Page<br/>(trackerpage.html)"]:::ui
        TPCSS["trackerpage.css"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        subgraph "Login Controller"
            loginJS["loginpage.js"]:::logic
        end
        subgraph "Tracker Controller Modules"
            FC["FormController"]:::logic
            TC["TransactionController"]:::logic
            DM["DataModel"]:::logic
            SS["StorageService"]:::logic
            UIR["UIRenderer"]:::logic
        end
    end

    %% Persistence Layer
    LS["localStorage"]:::storage

    %% Data Flows - Login
    LPHTML -->|"submitLogin()"| loginJS
    loginJS -->|"renderLoginUI()"| LPHTML

    %% Data Flows - Initialization
    TPHTML -->|"initialize()"| SS
    SS -->|"loadTransactions()"| TC
    TC -->|"renderList()/updateBalances()"| UIR
    UIR -->|"update DOM"| TPHTML

    %% Data Flows - Add Transaction
    TPHTML -->|"addTransaction()"| FC
    FC -->|"add(tx)"| TC
    TC -->|"updateModel()"| DM
    DM -->|"persist()"| SS
    SS -->|"saveToStorage()"| LS

    %% Persistence Feedback
    LS -->|"data" | SS

    %% Render Updated View
    SS -->|"loadedTx"| TC
    TC -->|"renderList()/updateBalances()"| UIR
    UIR -->|"update DOM"| TPHTML

    %% Click Events
    click LPHTML "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/loginpage.html"
    click LPCSS "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/loginpage.css"
    click loginJS "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/loginpage.js"
    click TPHTML "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.html"
    click TPCSS "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.css"
    click FC "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.js"
    click TC "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.js"
    click DM "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.js"
    click SS "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.js"
    click UIR "https://github.com/kajjayamadithya/expense-tracker-website/blob/main/trackerpage.js"

    %% Styles
    classDef ui fill:#D6EAF8,stroke:#1B4F72,color:#1B2631
    classDef logic fill:#D5F5E3,stroke:#196F3D,color:#1B2631
    classDef storage fill:#FAD7A0,stroke:#B9770E,color:#1B2631
```
