# mausmisinha/fintrack architecture

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

- Interactive diagram: https://gitdiagram.com/mausmisinha/fintrack
- Repository: https://github.com/mausmisinha/fintrack

## Overview

##### Project Type and Purpose
- This repository contains a Java Spring Boot backend service (“FinTrack”) for a personal finance tracking application.
- Although the README mentions a frontend stack (Oracle JET + JS), the code delivered here is purely the backend API, plus the bundled MySQL Connector library.

##### File‐Structure Analysis
- Top‐level:
- Db Schema.sql, Dummy Data for db.sql, Endpoint doc.txt – your database schema and endpoint specification.
- FinTrack/ – the Maven‐based Spring Boot application.
- mysql-connector-j-9.0.0/ – third-party MySQL driver source/jar (external library).
- Inside FinTrack/:
- pom.xml, .mvn/ – build configuration (Maven).
- src/main/java/com/fintrack/FinTrack/
– config/: Spring Security & JWT filter setup.
– filter/: JwtFilter for request authentication.
– controller/: REST controllers and their Impl classes (Budget_allocController, ExpenseController, etc.).
– service/: service interfaces and implementations (ExpenseServiceImpl, JWTService, MyUserDetailsService, etc.).
– repository/: Spring Data JPA repositories.
– entity/: JPA entity classes mapping to MySQL tables.
- src/main/resources/application.properties – DB, security and other configs.
- src/test/java/... – unit tests for application.

a. Main Components
- Frontend (Browser / Oracle JET + JS)
- API Gateway / Spring Boot Application
- Security Layer: SecurityConfig + JwtFilter + JWTService + MyUserDetailsService
- Controller Layer: Budget_allocController, ExpenseController, etc.
- Service (Business) Layer: ExpenseService, UserService, etc.
- Data Access Layer: Spring Data JPA Repositories
- Database: MySQL
- External Library: MySQL Connector/J

b. Relationships & Data Flows
1. User Agent (Browser or Postman) sends HTTP(S) → Spring Security filter chain (JwtFilter)
2. If authenticated, request → appropriate Controller
3. Controller delegates → Service layer
4. Service uses → Repository to perform CRUD on MySQL
5. Repository uses → MySQL Connector/J → communicates with MySQL DB
6. Response bubbles back Controller → HTTP response → User Agent

c. Architectural Patterns & Principles
- Layered (3-Tier) Architecture: Presentation (controllers), Domain (services), Persistence (repositories).
- Spring Security with JWT‐based stateless authentication.
- Dependency Injection via Spring Boot.
- Maven for build/dependency management.
- JPA for ORM mapping.

d. Key Technologies & Frameworks
- Spring Boot, Spring MVC, Spring Security, Spring Data JPA
- JWT (JSON Web Tokens)
- MySQL (8.0)
- MySQL Connector/J
- Maven

## Diagram (Mermaid)

```mermaid
flowchart TD
    UA["User Agent (Browser/Postman)"]:::frontend

    subgraph "Backend (API Gateway - Spring Boot)"
        entry["FinTrackApplication"]:::backend
        subgraph "Security Layer"
            secConfig["SecurityConfig"]:::backend
            jwtFilter["JwtFilter"]:::backend
            jwtService["JWTService"]:::backend
            userDetails["MyUserDetailsService"]:::backend
        end
        subgraph "Controller Layer"
            bAllocCtrl["Budget_allocController"]:::backend
            expCtrl["ExpenseController"]:::backend
            expDescCtrl["ExpensesDescController"]:::backend
            fixedCtrl["Fixed_chargesController"]:::backend
            investCtrl["InvestmentController"]:::backend
            userCtrl["UserController"]:::backend
            hello["Hello"]:::backend
        end
        subgraph "Service Layer"
            bAllocSvc["Budget_allocServiceImpl"]:::backend
            expSvc["ExpenseServiceImpl"]:::backend
            expDescSvc["ExpensesDescServiceImpl"]:::backend
            fixedSvc["Fixed_chargesServiceImpl"]:::backend
            invSvc["InvestmentServiceImpl"]:::backend
            userSvc["UserServiceImpl"]:::backend
        end
        subgraph "Repository Layer"
            bAllocRepo["Budget_allocRepository"]:::backend
            expRepo["ExpenseRepository"]:::backend
            expDescRepo["ExpensesDescRepository"]:::backend
            fixedRepo["Fixed_chargesRepository"]:::backend
            invRepo["InvestmentRepository"]:::backend
            userRepo["UserRepository"]:::backend
        end

        entry --> secConfig
        secConfig --> jwtFilter
        jwtFilter --> bAllocCtrl
        jwtFilter --> expCtrl
        jwtFilter --> expDescCtrl
        jwtFilter --> fixedCtrl
        jwtFilter --> investCtrl
        jwtFilter --> userCtrl
        jwtFilter --> hello

        bAllocCtrl --> bAllocSvc
        expCtrl --> expSvc
        expDescCtrl --> expDescSvc
        fixedCtrl --> fixedSvc
        investCtrl --> invSvc
        userCtrl --> userSvc
        hello --> entry

        bAllocSvc --> bAllocRepo
        expSvc --> expRepo
        expDescSvc --> expDescRepo
        fixedSvc --> fixedRepo
        invSvc --> invRepo
        userSvc --> userRepo
    end

    subgraph "Database"
        DB["MySQL Database"]:::db
    end

    subgraph "External Library"
        jdbc["MySQL Connector/J"]:::ext
    end

    UA -->|"HTTP/HTTPS + JWT"| jwtFilter
    bAllocRepo -->|"JDBC"| jdbc -->|"TCP"| DB

    click entry "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/FinTrackApplication.java"
    click secConfig "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/config/SecurityConfig.java"
    click jwtFilter "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/filter/JwtFilter.java"
    click jwtService "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/JWTService.java"
    click userDetails "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/MyUserDetailsService.java"
    click bAllocCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/Budget_allocController.java"
    click expCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/ExpenseController.java"
    click expDescCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/ExpensesDescController.java"
    click fixedCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/Fixed_chargesController.java"
    click investCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/InvestmentController.java"
    click userCtrl "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/UserController.java"
    click hello "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/controller/Hello.java"
    click bAllocSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/Budget_allocServiceImpl.java"
    click expSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/ExpenseServiceImpl.java"
    click expDescSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/ExpensesDescServiceImpl.java"
    click fixedSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/Fixed_chargesServiceImpl.java"
    click invSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/InvestmentServiceImpl.java"
    click userSvc "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/service/UserServiceImpl.java"
    click bAllocRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/Budget_allocRepository.java"
    click expRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/ExpenseRepository.java"
    click expDescRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/ExpensesDescRepository.java"
    click fixedRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/Fixed_chargesRepository.java"
    click invRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/InvestmentRepository.java"
    click userRepo "https://github.com/mausmisinha/fintrack/blob/main/FinTrack/src/main/java/com/fintrack/FinTrack/repository/UserRepository.java"
    click jdbc "https://github.com/mausmisinha/fintrack/tree/main/mysql-connector-j-9.0.0/"

    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#FFE4B2,stroke:#D2691E,color:#D2691E
    classDef db fill:#D5F5E3,stroke:#27AE60,color:#27AE60
    classDef ext fill:#E0E0E0,stroke:#7F8C8D,color:#7F8C8D
```
