# gautam23145032/personalfinancetracker architecture

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

- Interactive diagram: https://gitdiagram.com/gautam23145032/personalfinancetracker
- Repository: https://github.com/gautam23145032/personalfinancetracker

## Overview

##### Project Type & Purpose
- This is a full-stack personal finance tracker web app.
- Frontend: static HTML/CSS/JS (index.html, style.css, script.js).
- Backend: Node.js + Express REST API (server.js, routes/transactions.js), Mongoose models for MongoDB.
- Purpose: allow users to add, view, delete transactions, filter by date, and calculate summary stats.

##### File Structure Analysis
- Top-level:
- backend/ – server code, API routes, Mongoose models, environment config
- frontend/ – client‐side UI and logic
- Patterns:
- MVC-lite on backend (models/, routes/, server entry point)
- Client–server separation (vanilla JS calling HTTP endpoints)
- Deployment/config:
- .env for MONGO_URI & PORT
- package.json scripts for startup
- No containerization files (can be added later)

a. Frontend
- Browser or static‐hosted UI
- script.js makes HTTP requests to `/api/transactions`
b. Backend
- Express server (server.js)
- Route layer (transactions.js)
- Model layer (Transaction.js via Mongoose)
- Middleware: CORS, dotenv
c. Database
- MongoDB Atlas (external service)
- Connected via MONGO_URI
d. External Services (optional)
- Static file host (GitHub Pages or similar)
- Future: Auth service (JWT), Chart.js, CSV/PDF export library

##### Relationships & Data Flow
1. User opens index.html in browser
2. script.js → HTTP GET/POST/DELETE → Express API (`http://localhost:3000/api/transactions`)
3. Express routes invoke Mongoose models → MongoDB queries
4. MongoDB returns data → Express sends JSON response → script.js updates UI
5. UI renders transaction list & summary

##### Architectural Patterns & Design Principles
- Separation of concerns: UI vs API vs data persistence
- RESTful API design for CRUD operations
- Environment-driven configuration (dotenv)
- Model abstraction with Mongoose schemas
- CORS to allow cross-origin frontend calls

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        index["index.html"]:::presentation
        stylecss["style.css"]:::presentation
        scriptjs["script.js"]:::presentation
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        server["Express Server<br>server.js"]:::application
        routes["API Routes<br>transactions.js"]:::application
        model["Mongoose Model<br>Transaction.js"]:::application
        env["Environment Config<br>.env"]:::applicationConfig
        pkgjson["package.json"]:::applicationConfig
        pkglock["package-lock.json"]:::applicationConfig
        nodemod["node_modules"]:::applicationConfig
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        db["MongoDB Atlas"]:::database
    end

    %% Data Flow
    index -->|"loads"| stylecss
    index -->|"loads"| scriptjs
    scriptjs -->|"GET/POST/DELETE /api/transactions (HTTP/HTTPS, port 3000)"| server
    server -->|"uses routes"| routes
    routes -->|"invokes model"| model
    model -->|"queries"| db
    db -->|"returns data"| model
    model -->|"responds"| routes
    routes -->|"sends JSON"| server
    server -->|"response"| scriptjs

    %% Click Events
    click index "https://github.com/gautam23145032/personalfinancetracker/blob/main/frontend/index.html"
    click stylecss "https://github.com/gautam23145032/personalfinancetracker/blob/main/frontend/style.css"
    click scriptjs "https://github.com/gautam23145032/personalfinancetracker/blob/main/frontend/script.js"
    click server "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/server.js"
    click routes "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/routes/transactions.js"
    click model "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/models/Transaction.js"
    click env "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/.env"
    click pkgjson "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/package.json"
    click pkglock "https://github.com/gautam23145032/personalfinancetracker/blob/main/backend/package-lock.json"
    click nodemod "https://github.com/gautam23145032/personalfinancetracker/tree/main/backend/node_modules"

    %% Styles
    classDef presentation fill:#D0E8FF,stroke:#0B74DE,color:#000
    classDef application fill:#DFF5D0,stroke:#4CAF50,color:#000
    classDef applicationConfig fill:#FFF2CC,stroke:#F0AD4E,color:#000
    classDef database fill:#F0F0F0,stroke:#888,color:#000
```
