# priyanka8637kumari/expense-tracker-mern- architecture

> Architecture diagram of the GitHub repository priyanka8637kumari/expense-tracker-mern-, 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/priyanka8637kumari/expense-tracker-mern-
- Repository: https://github.com/priyanka8637kumari/expense-tracker-mern-

## Overview

##### Project Type and Purpose
- This is a full-stack MERN (MongoDB, Express.js, React, Node.js) expense-tracker application called “MoneyMate.”
- Purpose: provide users with secure authentication, CRUD operations on transactions, visual summaries (charts), and analytics tracking in a responsive, accessible SPA.

##### File-Structure Analysis
- Top-level split:
- frontend/ – React SPA (Vite, Tailwind CSS, React Router, react-ga4)
- backend/ – Node + Express REST API
- backend layers:
- config/db.js – MongoDB connection
- models/Users.js, Transactions.js – Mongoose schemas
- controllers/…Controller.js – business logic for users & transactions
- middleware/…Validation.js – request validation via Joi
- routes/…Router.js – Express routes for user & transaction endpoints
- server.js – app entrypoint (Express setup, CORS, dotenv)
- frontend layers:
- src/components – reusable UI pieces (Navbar, Chart, About)
- src/pages – route-based views (Home, Login, SignUp, TransactionList/Form/Summary)
- src/utils.jsx, analytics.jsx – helper functions & Google Analytics integration
- public/index.html + vite.config.js – bundler/config

##### README Insights
- Confirms use of MongoDB, bcrypt for hashing, js-cookie for sessions
- Emphasizes accessibility (semantic HTML, ARIA) and SEO
- Mentions analytics (react-ga4) for SPA pageview tracking
- Environment variables: PORT, MONGODB_URI, VITE_API_BASE_URL

##### Main Components
a. Client (Web Browser)
- React SPA served by Vite Dev Server or static host
- React Router for navigation (routes: /login, /signup, /home, /transactions, etc.)
- UI Components & Pages
- Google Analytics (react-ga4) for pageview & event tracking
b. API Layer (Backend Server)
- Express.js application
- Authentication & Session (bcrypt, js-cookie)
- Validation middleware (Joi)
- Controllers for user & transaction logic
- RESTful routes (/api/users, /api/transactions)
c. Database
- MongoDB (transactions & users collections)
d. External Services
- MongoDB Atlas or local Mongo instance
- (Optional future) HTTP-only cookies, CDNs for static assets

##### Relationships & Data Flow
- Browser → (HTTP) → React Router / App.jsx → UI → API calls to `VITE_API_BASE_URL`
- React → (fetch/Axios) → Express endpoints → middleware → controllers → models → MongoDB
- MongoDB → (query) → controllers → Express → React
- React-ga4 sends analytics to Google Analytics on route changes or interaction events

##### Architectural Patterns & Design Principles
- Client-Server separation
- MVC pattern in backend (Models, Controllers, Routes = Views)
- Component-based architecture in frontend
- Layered validation/security (input validation, hashing, CORS)
- Environment-driven configuration (dotenv)
- Modular structure for testability and maintainability

##### Final Advice
- Maintain clarity: don’t overcrowd—use multiple views if needed
- Iterate with the team to ensure all interactions (e.g., cookie-based auth, validation flows) are represented accurately

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        ReactSPA["React SPA"]:::frontend
        subgraph "SPA Details"
            direction TB
            ReactRouter["React Router"]:::frontend
            Navbar["Navbar Component"]:::frontend
            Chart["Chart Component"]:::frontend
            About["About Component"]:::frontend
            Home["Home Page"]:::frontend
            LogIn["Login Page"]:::frontend
            SignUp["SignUp Page"]:::frontend
            TransactionForm["Transaction Form Page"]:::frontend
            TransactionList["Transaction List Page"]:::frontend
            TransactionSummary["Transaction Summary Page"]:::frontend
            Utils["General Helpers"]:::frontend
            Analytics["Google Analytics Integration"]:::frontend
        end
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        ExpressAPI["Express API"]:::backend
        subgraph "Routes"
            direction TB
            UserRoutes["User Routes"]:::backend
            TransactionRoutes["Transaction Routes"]:::backend
        end
        subgraph "Middleware"
            direction TB
            UserValidation["User Validation"]:::backend
            TransactionValidation["Transaction Validation"]:::backend
        end
        subgraph "Controllers"
            direction TB
            UserController["User Controller"]:::backend
            TransactionController["Transaction Controller"]:::backend
        end
        subgraph "Models"
            direction TB
            UserModel["User Schema"]:::backend
            TransactionModel["Transaction Schema"]:::backend
        end
        DBConfig["DB Connection"]:::backend
    end

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

    %% External Services
    GoogleAnalytics["Google Analytics"]:::ext

    %% Connections
    ReactSPA --> ReactRouter
    ReactRouter --> Home
    ReactRouter --> LogIn
    ReactRouter --> SignUp
    ReactRouter --> TransactionForm
    ReactRouter --> TransactionList
    ReactRouter --> TransactionSummary
    ReactSPA --> Navbar
    ReactSPA --> Chart
    ReactSPA --> About
    ReactSPA --> Utils
    ReactSPA --> Analytics
    ReactSPA --> ExpressAPI

    Analytics --> GoogleAnalytics

    ExpressAPI --> UserRoutes
    ExpressAPI --> TransactionRoutes
    ExpressAPI --> DBConfig
    UserRoutes --> UserValidation
    TransactionRoutes --> TransactionValidation
    UserValidation --> UserController
    TransactionValidation --> TransactionController
    UserController --> UserModel
    TransactionController --> TransactionModel
    UserModel --> DB
    TransactionModel --> DB
    DBConfig --> DB

    %% Click Events
    click ReactSPA "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/App.jsx"
    click ReactRouter "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/App.jsx"
    click Navbar "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/components/Navbar.jsx"
    click Chart "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/components/Chart.jsx"
    click About "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/components/About.jsx"
    click Home "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/Home.jsx"
    click LogIn "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/LogIn.jsx"
    click SignUp "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/SignUp.jsx"
    click TransactionForm "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/TransactionForm.jsx"
    click TransactionList "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/TransactionList.jsx"
    click TransactionSummary "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/pages/TransactionSummary.jsx"
    click Utils "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/utils.jsx"
    click Analytics "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/frontend/src/analytics.jsx"
    click ExpressAPI "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/server.js"
    click DBConfig "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/config/db.js"
    click UserModel "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/models/Users.js"
    click TransactionModel "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/models/Transactions.js"
    click UserController "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/controllers/userController.js"
    click TransactionController "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/controllers/transactionController.js"
    click UserValidation "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/middleware/userValidation.js"
    click TransactionValidation "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/middleware/transactionValidation.js"
    click UserRoutes "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/routes/userRouter.js"
    click TransactionRoutes "https://github.com/priyanka8637kumari/expense-tracker-mern-/blob/main/backend/routes/transactionRouter.js"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1
    classDef backend fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    classDef db fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef ext stroke-dasharray: 5 5,stroke:#FF7043,color:#BF360C,fill:none
```
