# cristianbatista/ponto-inteligente-api architecture

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

- Interactive diagram: https://gitdiagram.com/cristianbatista/ponto-inteligente-api
- Repository: https://github.com/cristianbatista/ponto-inteligente-api

## Overview

##### Project type and purpose
- This is a backend‐only, Spring Boot REST API named “Ponto Inteligente Api,” implemented in Java, built with Maven. Its purpose is to manage time‐clock data (empresas, funcionários, lançamentos).

##### File structure
- Top‐level files:
- pom.xml / .mvn / mvnw(.cmd): Maven build config and wrapper
- README.md / .travis.yml: Project description and CI config
- src/main/java/com/cursojava/pontointeligente/api:
- PontoInteligenteApplication.java: Spring Boot “main”
- entities/: domain data models (Empresa, Funcionario, Lancamento)
- enums/: supporting enumeration types (PerfilEnum, TipoEnum)
- src/main/resources/application.properties: runtime properties (DB connection, ports)
- No explicit “controller,” “service,” or “repository” packages—these will exist or should be created following standard layering.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Client
    Client["External Client"]:::external

    %% Ponto Inteligente API Boundary
    subgraph "Ponto Inteligente API"
        PIApp["PontoInteligenteApplication"]:::boot

        subgraph "Controller Layer"
            Controllers["REST Controllers"]:::controllers
        end

        subgraph "Service Layer"
            Services["Service Classes"]:::services
        end

        subgraph "Repository Layer"
            Repositories["Repository Interfaces"]:::repositories
        end

        subgraph "Domain Model"
            Empresa["Empresa"]:::domain
            Funcionario["Funcionario"]:::domain
            Lancamento["Lancamento"]:::domain
            PerfilEnum["PerfilEnum"]:::domain
            TipoEnum["TipoEnum"]:::domain
        end

        Config["application.properties"]:::config
    end

    %% Database
    DB["Relational Database"]:::db

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        Travis["Travis CI"]:::ci
        Tests["Application Tests"]:::ci
        Artifact["Build Artifact"]:::ci
    end

    Production["Production Environment"]:::external

    %% Data Flow
    Client -->|HTTP Request| Controllers
    PIApp -->|bootstraps| Controllers
    Controllers -->|calls| Services
    Services -->|calls| Repositories
    Repositories -->|reads\/writes| DB
    Services -->|uses| Empresa
    Services -->|uses| Funcionario
    Services -->|uses| Lancamento

    %% CI Flow
    Travis -->|runs| Tests
    Travis -->|builds| Artifact
    Artifact -->|deploys| Production

    %% Click Events
    click PIApp "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/PontoInteligenteApplication.java"
    click Empresa "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/entities/Empresa.java"
    click Funcionario "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/entities/Funcionario.java"
    click Lancamento "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/entities/Lancamento.java"
    click PerfilEnum "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/enums/PerfilEnum.java"
    click TipoEnum "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/java/com/cursojava/pontointeligente/api/enums/TipoEnum.java"
    click Config "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/main/resources/application.properties"
    click pom.xml "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/pom.xml"
    click mvnw "https://github.com/cristianbatista/ponto-inteligente-api/tree/master/mvnw"
    click mvnw.cmd "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/mvnw.cmd"
    click MavenJar "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/.mvn/wrapper/maven-wrapper.jar"
    click MavenProps "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/.mvn/wrapper/maven-wrapper.properties"
    click Travis "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/.travis.yml"
    click Tests "https://github.com/cristianbatista/ponto-inteligente-api/blob/master/src/test/java/com/cursojava/pontointeligente/api/PontoInteligenteApplicationTests.java"

    %% Styles
    classDef controllers fill:#cce5ff,stroke:#004085
    classDef services fill:#d4edda,stroke:#155724
    classDef repositories fill:#fff3cd,stroke:#856404
    classDef domain fill:#e2e3e5,stroke:#6c757d
    classDef db fill:#d1ecf1,stroke:#0c5460
    classDef external fill:#f8d7da,stroke:#721c24
    classDef ci fill:#f5c6cb,stroke:#721c24
    classDef config fill:#e2f0cb,stroke:#4b8b3b
    classDef boot fill:#e0e0e0,stroke:#000000
```
