MCPcopy Index your code
hub / github.com/GitAlboBis/Jbudget

github.com/GitAlboBis/Jbudget @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
342 symbols 713 edges 55 files 172 documented · 50%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

relazioneJBudgetAlbertoTuveri123718.pdf

JBudget - Gestione Budget Familiare

📖 Overview

JBudget is a desktop software application developed in Java for managing and controlling family budgets. It was created as an examination project for the "Metodologie di programmazione" (Programming Methodologies) course at UNICAM. The application provides a comprehensive suite of tools to track expenses, manage loans, monitor deadlines, and view financial statistics.

✨ Features

  • Movement Tracking (Movimenti): Record and monitor financial movements.
  • Budget Management: Set up and manage family budgets using the dedicated Budget Calculation Service.
  • Deadline Management (Scadenze): Keep track of upcoming financial deadlines with automatic status updates upon application launch.
  • Loan Management (Prestiti): Manage loans and automatically update overdue payments.
  • Statistics & Reporting: View insights and statistics regarding your financial data.

🛠️ Tech Stack & Architecture

  • Language: Java 21.
  • UI Framework: JavaFX 21 (using javafx.controls and javafx.fxml modules).
  • Build Tool: Gradle.
  • Database: H2 Database Engine (Version 2.2.224).
  • Testing: JUnit 5 (Jupiter API 5.10.0).
  • Architecture: The project follows an MVC-based structure with a custom ServiceFactory handling Dependency Injection to supply database connections and services to the UI controllers (e.g., MainController, MovementController, BudgetController).

🏗️ Application Structure

Upon startup, the application performs the following initializations:

  • Database Setup: Connects to the H2 database via DataSourceFactory and initializes tables via DatabaseInitializer.

  • Dependency Injection: Instantiates services via ServiceFactory.

  • UI Loading: Loads the primary MainView.fxml interface with a default resolution of 1400x900 (minimum 1000x700).

  • ** Data Sync:** Automatically checks and updates overdue "scadenze" and loan payments in the background.

Extension points exported contracts — how you extend this code

BaseRepository (Interface)
Interfaccia base per tutti i repository. Definisce le operazioni CRUD standard. @param Tipo dell'entità @param [5 implementers]
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/BaseRepository.java
BudgetRepository (Interface)
Repository per la gestione dei budget. Estende BaseRepository con query specifiche per i budget. [1 implementers]
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/BudgetRepository.java
ScadenzaRepository (Interface)
Repository per la gestione delle scadenze. Estende BaseRepository con query specifiche per le scadenze. [1 implementers]
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/ScadenzaRepository.java
LoanPaymentRepository (Interface)
Repository per la gestione delle rate dei prestiti. [1 implementers]
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/LoanPaymentRepository.java
MovementRepository (Interface)
Repository per la gestione dei movimenti finanziari. Estende BaseRepository con query specifiche per i movimenti. [1 implementers]
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/MovementRepository.java

Core symbols most depended-on inside this repo

showError
called by 20
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/BaseController.java
getEmoji
called by 18
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/model/LoanType.java
showAlert
called by 15
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/BaseController.java
save
called by 11
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/BaseRepository.java
getInstance
called by 11
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/DataRefreshManager.java
getBudgetsForPeriod
called by 8
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/service/BudgetService.java
createStatsCard
called by 8
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/dialogs/LoanSummaryDialog.java
getMovementsInPeriod
called by 7
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/service/MovementService.java

Shape

Method 286
Class 42
Enum 8
Interface 6

Languages

Java100%

Modules by API surface

src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/BudgetController.java23 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/service/LoanService.java19 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/MovementController.java17 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/StatisticsController.java14 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/dialogs/BudgetManagementDialog.java12 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/controllers/ScadenzeController.java12 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/service/BudgetService.java12 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/dialogs/LoanSummaryDialog.java11 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/JBudgetApplication.java11 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/ui/dialogs/MovementDialog.java10 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/repository/ScadenzaRepository.java10 symbols
src/main/java/it/unicam/cs/mpgc/jbudget123718/jbudget/config/ServiceFactory.java10 symbols

For agents

$ claude mcp add Jbudget \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact