# davilb64/projeto-tp1 architecture

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

- Interactive diagram: https://gitdiagram.com/davilb64/projeto-tp1
- Repository: https://github.com/davilb64/projeto-tp1

## Overview

##### Project Type and Purpose
- This is a standalone desktop **full-stack** application built with **Java 22**, **JavaFX**, and **Maven**, following an **MVC** architecture.
- Its goal is to automate HR processes (user authentication, candidate management, interviews, payroll, contracts, reports) using CSV files for persistence and FXML/CSS for UI.

##### File Structure
- Top-level modules:
- src/main/java/app/humanize/controller → JavaFX controllers (UI logic)
- src/main/java/app/humanize/model → Domain entities (Usuario, Vaga, Candidatura, etc.)
- src/main/java/app/humanize/repository → Persistence layer (CSV read/write)
- src/main/java/app/humanize/service → Business logic, validation and report-generation strategies
- src/main/java/app/humanize/util → Utilities (screen navigation, session, external API lookup)
- src/main/resources/view → FXML UI definitions
- src/main/resources/css → Application styles
- CSV files under resources → Data store
- Patterns: MVC separation, **Strategy** for formatters and report generators, factory for reports, custom exceptions, internationalization via resource bundles.

##### README Insights
- Confirms layers, tech stack, feature set (authentication, candidate/vacancy management, contracts, payroll, PDF/CSV reports).
- No external database: persistence via CSV.
- Entry points: `Launcher.java` and `Main.java`.

##### Components
a. UI Layer
– FXML Views + CSS
– JavaFX Controllers
b. Domain Model
– Entity classes (Usuario, Candidato, Vaga, etc.)
c. Service Layer
– Business services (`LoginService`, validation under `service/validacoes`, report-generation under `service/relatorios`, formatters under `service/formatters`)
d. Persistence Layer
– Repositories (`BaseRepository`, `UsuarioRepository`, etc.) reading/writing CSV files
e. Data Store
– CSV files in `src/main/resources`
f. Utility & External Integration
– `EnderecoViaCep` (calls external CEP API)
– `ScreenController`, `UserSession`

##### Relationships & Data Flow
1. User interacts with a **View (FXML + CSS)**
2. **Controller** handles UI events → invokes **Service** methods
3. **Service** applies business rules, calls **Validators** or **Report Generators** (Strategy)
4. **Service** calls **Repository** to read/write domain data
5. **Repository** reads/writes **CSV files** (local filesystem)
6. **Service** may return formatted data (PDF/CSV) via **Formatters**
7. **Controller** updates the **View** with results

##### Architectural Patterns & Principles
- MVC separation: UI, Controller, Model
- Single Responsibility: each package/layer has a clear role
- Strategy Pattern: interchangeable formatters (PdfFormatter, CsvFormatter) and report generators
- Factory Pattern: dynamic report instantiation
- Dependency Injection via constructors or service locators (ScreenController)
- Internationalization: resource bundle lookups in controllers and views

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        Views["FXML Views"]:::ui
        CSS["CSS Stylesheet"]:::ui
        Launcher["Launcher"]:::ui
        Main["Main"]:::ui
        Controllers["JavaFX Controllers"]:::ui
    end

    %% Service Layer
    subgraph "Service Layer"
        LoginService["LoginService"]:::service
        Validators["Validators (Strategy)"]:::service
        Formatters["Formatters (Strategy)"]:::service
        ReportGenerators["Report Generators (Strategy)"]:::service
    end

    %% Domain Model
    subgraph "Domain Model"
        Entities["Domain Entities"]:::domain
        ReportFactory["Report Factory"]:::domain
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        BaseRepo["BaseRepository"]:::repo
        UsuarioRepo["UsuarioRepository"]:::repo
        VagaRepo["VagaRepository"]:::repo
        CandidatoRepo["CandidatoRepository"]:::repo
        OtherRepos["Other Repositories"]:::repo
    end

    %% Data Store
    subgraph "Data Store"
        CSVFiles["CSV Files"]:::data
    end

    %% Utilities & External
    subgraph "Utilities / External"
        ScreenCtrl["ScreenController"]:::util
        UserSession["UserSession"]:::util
        EnderecoCEP["EnderecoViaCep"]:::util
    end

    %% Relationships
    Views --> Controllers
    CSS --> Controllers
    Launcher --> Controllers
    Main --> Controllers

    Controllers -->|invokes| LoginService
    Controllers -->|invokes| ReportGenerators
    Controllers -->|navigates via| ScreenCtrl

    LoginService -->|uses| Validators
    ReportGenerators -->|uses| ReportFactory
    LoginService -->|calls| UsuarioRepo

    LoginService -->|calls| VagaRepo
    LoginService -->|calls| CandidatoRepo

    Validators -->|throws| Controllers

    ServiceLayerSubgraph[hidden] --- ServiceLayerSubgraph

    BaseRepo --> CSVFiles
    UsuarioRepo --> CSVFiles
    VagaRepo --> CSVFiles
    CandidatoRepo --> CSVFiles
    OtherRepos --> CSVFiles

    LoginService -->|formats via| Formatters
    ReportGenerators -->|formats via| Formatters

    Controllers -->|accesses| UserSession
    Validators -->|uses| EnderecoCEP

    %% Click Events
    click Views "https://github.com/davilb64/projeto-tp1/tree/main/src/main/resources/view"
    click CSS "https://github.com/davilb64/projeto-tp1/blob/main/src/main/resources/css/style.css"
    click Controllers "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/controller"
    click Launcher "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/Launcher.java"
    click Main "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/Main.java"
    click Entities "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/model"
    click ReportFactory "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/model/factories/RelatorioFinanceiro.java"
    click BaseRepo "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/repository/BaseRepository.java"
    click UsuarioRepo "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/repository/UsuarioRepository.java"
    click VagaRepo "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/repository/VagaRepository.java"
    click CandidatoRepo "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/repository/CandidatoRepository.java"
    click OtherRepos "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/repository"
    click LoginService "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/service/LoginService.java"
    click Validators "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/service/validacoes"
    click Formatters "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/service/formatters"
    click ReportGenerators "https://github.com/davilb64/projeto-tp1/tree/main/src/main/java/app/humanize/service/relatorios"
    click ScreenCtrl "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/util/ScreenController.java"
    click UserSession "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/util/UserSession.java"
    click EnderecoCEP "https://github.com/davilb64/projeto-tp1/blob/main/src/main/java/app/humanize/util/EnderecoViaCep.java"
    click CSVFiles "https://github.com/davilb64/projeto-tp1/blob/main/src/main/resources/usuarios.csv"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef service fill:#DFFFD0,stroke:#34A853,color:#34A853;
    classDef domain fill:#FFE4B3,stroke:#FB8C00,color:#FB8C00;
    classDef repo fill:#E0E0E0,stroke:#5F6368,color:#5F6368;
    classDef data fill:#F5F5F5,stroke:#888888,color:#888888;
    classDef util fill:#F3E6FF,stroke:#A142F4,color:#A142F4;
```
