# grraghav120/expense-tracker architecture

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

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

## Overview

##### Project type and purpose
- This is a full-stack web application (“ExpenseTracker”) comprising an Angular single-page application (SPA) front end and a Node.js/Express back end.
- Its purpose is to let authenticated users track expenses by creating, viewing, editing, importing (CSV) expenses and categories, see charts, and manage their profile.

##### File structure
- **Top-level**
- angular.json, src/ (Angular code), backend/ (Express code), package.json
- **Frontend (src/)**
- app/ – Angular modules & components (welcome, auth, header, home, shared, services)
- environments/ – dev/prod endpoints
- assets/, styles.scss, index.html, main.ts
- **Backend (backend/)**
- server.js, app.js – Express app entry points
- routes/ – expense.js, user.js
- middleware/ – expenseMiddleWare.js
- models/ – createExpense.js, saveData.js, userModel.js
- package.json
- **Config & build**
- .gitignore, tsconfig*.json, .editorconfig, GitHub issue templates

##### README
- Describes features: signup/login, dashboard, add/edit/view expenses, import CSV, charts (bar/pie), user profile.
- Mentions tech stack: Angular, Node.js, Express.js, likely MongoDB (see “Database” image).

a. Main components
1) Client (Browser/Angular SPA)
2) API Server (Node.js + Express)
3) Database (MongoDB)
4) External services (e.g., CSV parser, authentication/JWT library)
b. Relationships & interactions
- Angular issues HTTP(S) requests via AuthInterceptor → Express endpoints (/api/user, /api/expense).
- Express middleware validates JWT → route handlers call Mongoose models → MongoDB.
- Express returns JSON responses → Angular services update UI.
- On import: Angular uploads CSV to Express → server parses CSV → bulk insert into DB.
c. Architectural patterns & principles
- **Client-server** separation: Single Page Application vs. REST API
- **Modular** code: Angular modules (Auth, Header, Home, Shared) & Express routers
- **Middleware** chain for cross-cutting concerns (auth, logging)
- **MVC-like** on server: routes → controllers/models → database
d. Key technologies
- Frontend: Angular CLI, Angular Router, HTTPClient, Angular Material, Bootstrap
- Backend: Node.js, Express.js, Mongoose (assumed), JSON Web Tokens, CSV parser library

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Angular SPA)" 
        style Frontend fill:#E3F2FD,stroke:#42A5F5
        SPA["Angular SPA"]:::frontend
        AppRouting["App Routing Module"]:::frontend
        AppModule["App Module"]:::frontend
        AppComponent["App Component"]:::frontend
        subgraph "Auth Module"
            AuthService["Auth Service"]:::frontend
            AuthGuard["Auth Guard"]:::frontend
            AuthInterceptor["Auth Interceptor"]:::frontend
        end
        subgraph "Welcome Module"
            WelcomeModule["Welcome Module"]:::frontend
            WelcomeComp["Welcome Component"]:::frontend
            LoginComp["Login Component"]:::frontend
            SignupComp["Signup Component"]:::frontend
        end
        subgraph "Header Module"
            HeaderModule["Header Module"]:::frontend
            HeaderComp["Header Component"]:::frontend
            AddExpenseComp["Add-Expense Component"]:::frontend
            AddCategoryComp["Add-Category Component"]:::frontend
            ImportComp["Import Component"]:::frontend
            DashboardComp["Dashboard Component"]:::frontend
        end
        subgraph "Home Module"
            HomeModule["Home Module"]:::frontend
            HomeComp["Home Component"]:::frontend
            ViewExpensesComp["View-Expenses Component"]:::frontend
            ViewExpenseModel["View-Expense Model"]:::frontend
            ViewSingleComp["View-Single Component"]:::frontend
            ShowChartComp["Show-Chart Component"]:::frontend
        end
        subgraph "Shared Module"
            SharedModule["Shared Module"]:::frontend
            AlertBoxComp["Alert-Box Component"]:::frontend
            LoaderComp["Loader Component"]:::frontend
            FooterComp["Footer Component"]:::frontend
            ProfileComp["Profile Component"]:::frontend
            RatingComp["Rating Component"]:::frontend
            WelcomeLoaderComp["Welcome-Loader Component"]:::frontend
        end
        BusinessService["Business Data Service"]:::frontend
        EnvConfig["Environment Configs"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Express API)" 
        style Backend fill:#FFF3E0,stroke:#FB8C00
        ExpressServer["Express Server"]:::backend
        AppJS["app.js"]:::backend
        ServerJS["server.js"]:::backend
        subgraph "Middleware"
            ExpenseMW["Expense Middleware"]:::backend
        end
        subgraph "Routes"
            UserRoute["User Routes"]:::backend
            ExpenseRoute["Expense Routes"]:::backend
        end
        subgraph "Models"
            UserModel["User Model"]:::backend
            CreateExpense["Create Expense Model"]:::backend
            SaveData["Save Data Model"]:::backend
        end
        BackPkg["backend/package.json"]:::backend
    end

    %% Database Layer
    subgraph "Database (MongoDB)"
        style Database fill:#E8F5E9,stroke:#43A047
        MongoDB["MongoDB"]:::database
        UsersColl["Users Collection"]:::database
        ExpensesColl["Expenses Collection"]:::database
        CategoriesColl["Categories Collection"]:::database
    end

    %% External Services
    subgraph "External Libraries/Services"
        style External fill:#ECEFF1,stroke:#78909C
        CSVParser["CSV Parser"]:::external
        JWTLib["JWT Library"]:::external
    end

    %% Data Flow
    SPA -->|bootstrap| AppModule
    AppModule --> AppRouting
    AppModule --> AppComponent
    AppComponent --> WelcomeModule
    AppComponent --> HeaderModule
    AppComponent --> HomeModule
    AppComponent --> SharedModule
    AuthInterceptor -->|intercepts| BusinessService
    LoginComp -->|POST /api/user/login| BusinessService
    SignupComp -->|POST /api/user/signup| BusinessService
    AddExpenseComp -->|POST /api/expense| BusinessService
    AddCategoryComp -->|POST /api/expense/category| BusinessService
    ImportComp -->|POST /api/expense/import| BusinessService
    BusinessService -->|HTTP| ExpressServer
    ExpressServer -->|use auth| ExpenseMW
    ExpenseMW -->|validates JWT| JWTLib
    ExpressServer --> UserRoute
    ExpressServer --> ExpenseRoute
    ExpenseRoute --> CreateExpense
    ExpenseRoute --> SaveData
    UserRoute --> UserModel
    CreateExpense --> MongoDB
    SaveData --> MongoDB
    UserModel --> MongoDB
    MongoDB --> UsersColl
    MongoDB --> ExpensesColl
    MongoDB --> CategoriesColl
    ImportComp -->|sends CSV| CSVParser
    CSVParser -->|bulk insert| ExpenseRoute

    %% Click Events - Frontend
    click SPA "https://github.com/grraghav120/expense-tracker/tree/main/src/"
    click AppRouting "https://github.com/grraghav120/expense-tracker/blob/main/src/app/app-routing.module.ts"
    click AppModule "https://github.com/grraghav120/expense-tracker/blob/main/src/app/app.module.ts"
    click AppComponent "https://github.com/grraghav120/expense-tracker/blob/main/src/app/app.component.ts"
    click AuthService "https://github.com/grraghav120/expense-tracker/blob/main/src/app/auth/auth.service.ts"
    click AuthGuard "https://github.com/grraghav120/expense-tracker/blob/main/src/app/auth/auth.guard.ts"
    click AuthInterceptor "https://github.com/grraghav120/expense-tracker/blob/main/src/app/auth/auth-interceptor.ts"
    click WelcomeModule "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/welcome/welcome.module.ts"
    click WelcomeComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/welcome/welcome.component.ts"
    click LoginComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/welcome/login/login.component.ts"
    click SignupComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/welcome/signup/signup.component.ts"
    click HeaderModule "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/header.module.ts"
    click HeaderComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/header.component.ts"
    click AddExpenseComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/add-expense/add-expense.component.ts"
    click AddCategoryComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/add-category/add-category.component.ts"
    click ImportComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/import/import.component.ts"
    click DashboardComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/header/dashboard/dashboard.component.ts"
    click HomeModule "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/home.module.ts"
    click HomeComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/home.component.ts"
    click ViewExpensesComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/view-expenses/view-expenses.component.ts"
    click ViewExpenseModel "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/view-expenses/view-expense.model.ts"
    click ViewSingleComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/view-single/view-single.component.ts"
    click ShowChartComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/component/home/show-chart/show-chart.component.ts"
    click SharedModule "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/shared.module.ts"
    click AlertBoxComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/alert-box/alert-box.component.ts"
    click LoaderComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/loader/loader.component.ts"
    click FooterComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/footer/footer.component.ts"
    click ProfileComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/profile/profile.component.ts"
    click RatingComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/rating/rating.component.ts"
    click WelcomeLoaderComp "https://github.com/grraghav120/expense-tracker/blob/main/src/app/shared/welcome-loader/welcome-loader.component.ts"
    click BusinessService "https://github.com/grraghav120/expense-tracker/blob/main/src/app/services/business-data.service.ts"
    click EnvConfig "https://github.com/grraghav120/expense-tracker/blob/main/src/environments/environment.ts"

    %% Click Events - Backend
    click ServerJS "https://github.com/grraghav120/expense-tracker/blob/main/backend/server.js"
    click AppJS "https://github.com/grraghav120/expense-tracker/blob/main/backend/app.js"
    click UserRoute "https://github.com/grraghav120/expense-tracker/blob/main/backend/routes/user.js"
    click ExpenseRoute "https://github.com/grraghav120/expense-tracker/blob/main/backend/routes/expense.js"
    click ExpenseMW "https://github.com/grraghav120/expense-tracker/blob/main/backend/middleware/expenseMiddleWare.js"
    click UserModel "https://github.com/grraghav120/expense-tracker/blob/main/backend/models/userModel.js"
    click CreateExpense "https://github.com/grraghav120/expense-tracker/blob/main/backend/models/createExpense.js"
    click SaveData "https://github.com/grraghav120/expense-tracker/blob/main/backend/models/saveData.js"
    click BackPkg "https://github.com/grraghav120/expense-tracker/blob/main/backend/package.json"

    classDef frontend fill:#BBDEFB,stroke:#0D47A1
    classDef backend fill:#FFE0B2,stroke:#E65100
    classDef database fill:#C8E6C9,stroke:#1B5E20
    classDef external fill:#CFD8DC,stroke:#37474F
```
