# mmahesh7/smart-expense-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/mmahesh7/smart-expense-tracker
- Repository: https://github.com/mmahesh7/smart-expense-tracker

## Overview

##### Project type and purpose
- This is a full-stack Java EE web application named “Smart Expense Tracker.”
- Purpose: personal finance management—users register/login, add/view/delete expenses, set budgets, and see visual reports.

##### File structure
- Top-level: pom.xml (Maven), database_setup.sql, preview media.
- src/main/java/com/expense:
- dao/ → Data Access Objects (BudgetDAO, CategoryDAO, ExpenseDAO, UserDAO)
- model/ → Business entities (Budget, Category, Expense, User)
- servlets/ → Controllers handling HTTP requests (LoginServlet, DashboardServlet, etc.)
- filters/ → Servlet filters (AuthenticationFilter, CharacterEncodingFilter)
- util/ → Helpers (DBConnection, PasswordUtil)
- src/main/webapp:
- WEB-INF/web.xml → Servlet configuration
- index.jsp + views/*.jsp → JSP front-end
- js/ (charts.js, validation.js) → client logic
- database_setup.sql defines the MySQL schema.

##### README for additional insights
- Confirms MVC architecture, DAO pattern, Servlet/JSP stack, MySQL database layer.
- Highlights Chart.js, Tailwind CSS, security features (SHA-256, prepared statements, session filters).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Browser (Client)" 
        style Browser fill:#cce5ff,stroke:#333,stroke-width:1px
        Browser["Client Browser"]:::external
        StaticResources["Static Resources (charts.js, validation.js)"]:::presentation
        Tailwind["Tailwind CSS"]:::presentation
        ChartJS["Chart.js"]:::presentation
        subgraph "UI (JSP Views)" 
            style UI fill:#cce5ff,stroke:#333,stroke-width:1px
            Index["index.jsp"]:::presentation
            AddExpenseJSP["add-expense.jsp"]:::presentation
            BudgetJSP["budget.jsp"]:::presentation
            DashboardJSP["dashboard.jsp"]:::presentation
            ErrorJSP["error.jsp"]:::presentation
            LoginJSP["login.jsp"]:::presentation
            RegisterJSP["register.jsp"]:::presentation
            ViewExpensesJSP["view-expenses.jsp"]:::presentation
        end
    end

    Browser -->|"User Request (HTTP)"| CEF
    ChartJS -.->|"AJAX Data"| DashboardCtl

    %% Server Layer
    subgraph "Apache Tomcat 9+" 
        style Tomcat fill:#e6ffe6,stroke:#333,stroke-width:1px
        CEF["CharacterEncodingFilter"]:::controller
        AuthF["AuthenticationFilter"]:::controller
        CEF --> AuthF

        subgraph "Controller Layer"
            style Controllers fill:#e6ffe6,stroke:#333,stroke-width:1px
            LoginCtl["LoginServlet"]:::controller
            RegisterCtl["RegisterServlet"]:::controller
            DashboardCtl["DashboardServlet"]:::controller
            AddExpenseCtl["AddExpenseServlet"]:::controller
            ViewExpensesCtl["ViewExpensesServlet"]:::controller
            DeleteExpenseCtl["DeleteExpenseServlet"]:::controller
            BudgetCtl["BudgetServlet"]:::controller
            LogoutCtl["LogoutServlet"]:::controller
        end
        AuthF --> LoginCtl
        AuthF --> RegisterCtl
        AuthF --> DashboardCtl
        AuthF --> AddExpenseCtl
        AuthF --> ViewExpensesCtl
        AuthF --> DeleteExpenseCtl
        AuthF --> BudgetCtl
        AuthF --> LogoutCtl

        subgraph "Service & DAO Layer"
            style ServiceDAO fill:#ffe6cc,stroke:#333,stroke-width:1px
            DBConn["DBConnection"]:::util
            PwdUtil["PasswordUtil"]:::util
            DBConn --> PwdUtil
            subgraph "DAO Layer"
                style DAO fill:#ffe6cc,stroke:#333,stroke-width:1px
                UserDAO["UserDAO"]:::dao
                ExpenseDAO["ExpenseDAO"]:::dao
                CategoryDAO["CategoryDAO"]:::dao
                BudgetDAO["BudgetDAO"]:::dao
            end
            DBConn --> UserDAO
            DBConn --> ExpenseDAO
            DBConn --> CategoryDAO
            DBConn --> BudgetDAO
        end

        subgraph "Data Layer"
            style Database fill:#e6e6ff,stroke:#333,stroke-width:1px
            Schema["MySQL Database"]:::database
        end

        UserDAO -->|"SQL Queries"| Schema
        ExpenseDAO -->|"SQL Queries"| Schema
        CategoryDAO -->|"SQL Queries"| Schema
        BudgetDAO -->|"SQL Queries"| Schema

        %% Back to Views
        LoginCtl -->|"forward"| LoginJSP
        RegisterCtl -->|"forward"| RegisterJSP
        DashboardCtl -->|"forward"| DashboardJSP
        AddExpenseCtl -->|"forward"| AddExpenseJSP
        ViewExpensesCtl -->|"forward"| ViewExpensesJSP
        DeleteExpenseCtl -->|"forward"| DashboardJSP
        BudgetCtl -->|"forward"| BudgetJSP
        AuthF -->|"error"| ErrorJSP
    end

    %% Click Events
    click StaticResources "https://github.com/mmahesh7/smart-expense-tracker/tree/main/src/main/webapp/js"
    click Index "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/index.jsp"
    click AddExpenseJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/add-expense.jsp"
    click BudgetJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/budget.jsp"
    click DashboardJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/dashboard.jsp"
    click ErrorJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/error.jsp"
    click LoginJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/login.jsp"
    click RegisterJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/register.jsp"
    click ViewExpensesJSP "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/webapp/views/view-expenses.jsp"
    click CEF "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/filters/CharacterEncodingFilter.java"
    click AuthF "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/filters/AuthenticationFilter.java"
    click LoginCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/LoginServlet.java"
    click RegisterCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/RegisterServlet.java"
    click DashboardCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/DashboardServlet.java"
    click AddExpenseCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/AddExpenseServlet.java"
    click ViewExpensesCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/ViewExpensesServlet.java"
    click DeleteExpenseCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/DeleteExpenseServlet.java"
    click BudgetCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/BudgetServlet.java"
    click LogoutCtl "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/servlets/LogoutServlet.java"
    click DBConn "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/util/DBConnection.java"
    click PwdUtil "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/util/PasswordUtil.java"
    click UserDAO "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/dao/UserDAO.java"
    click ExpenseDAO "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/dao/ExpenseDAO.java"
    click CategoryDAO "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/dao/CategoryDAO.java"
    click BudgetDAO "https://github.com/mmahesh7/smart-expense-tracker/blob/main/src/main/java/com/expense/dao/BudgetDAO.java"
    click Schema "https://github.com/mmahesh7/smart-expense-tracker/blob/main/database_setup.sql"
    click pom "https://github.com/mmahesh7/smart-expense-tracker/blob/main/pom.xml"
    click Demo "https://github.com/mmahesh7/smart-expense-tracker/blob/main/preview/videos/SET_Demo.mp4"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef controller fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef util fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef dao fill:#ffdab3,stroke:#333,stroke-width:1px
    classDef database fill:#e6e6ff,stroke:#333,stroke-width:1px
    classDef external fill:#ffffff,stroke:#333,stroke-width:1px
```
