How arllekws/saldinho works
Project Type and Purpose
• SALDINHO is a Java-based, object-oriented, layered (MVC-style) personal finance management application.
• It provides CRUD operations on financial entities (expenses, recipes/income, financial goals, users) with persistent storage via JDBC (MySQL/PostgreSQL).
High-Level Architectural Overview
SALDINHO follows a classic 3-layer architecture:
a. Presentation Layer (UI/Entry Point)
• src/Program/app/Main.java
• Responsible for reading user commands (console or GUI stub), invoking services.
b. Business Logic Layer (Services)
• src/Program/{Expense,Goal,Recipe,User}/*Service.java
• Enforces business rules, orchestrates operations on domain entities.
c. Data Access / Persistence Layer
• src/Program/Util/Conexao.java (JDBC connection factory)
• CRUD via Service classes using JDBC to interact with the database.
d. Domain Model (Entities)
• src/Entities/*.java (Expense, Recipe, FinancialGoal, User, Transacao)
• Encapsulate data attributes and domain methods.
Main Components
• Client / User Interface (CLI or future GUI)
• Main Application Entry (Main.java)
• Service Components (ExpenseService, GoalService, RecipeService, UserService)
• Domain Entities (models)
• Persistence Connector (Conexao)
• Relational Database (MySQL/PostgreSQL)
Relationships and Data Flow
• User → Main: issues commands.
• Main → [X]Service: triggers business operations.
• [X]Service ↔ Entities: manipulates domain objects.
• [X]Service → Conexao: opens connections, executes SQL.
• Conexao ↔ Database: reads/writes tables.
• Services return results/entities → Main → User.
Architectural Patterns & Principles
• Layered Architecture (Presentation → Business → Persistence).
• SOLID principles in service and entity classes (single responsibility, dependency inversion via Conexao).
• Test coverage via corresponding Test classes in each package (ExpenseTest, ServiceTest, etc.).
Technologies & Frameworks
• Java 11+ (or compatible)
• JDBC for database interaction
• MySQL/PostgreSQL (configurable via .env)
• JUnit for testing