# dev-michaelcruz/api-carros-java-angular architecture

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

- Interactive diagram: https://gitdiagram.com/dev-michaelcruz/api-carros-java-angular
- Repository: https://github.com/dev-michaelcruz/api-carros-java-angular

## Overview

##### Project Type and Purpose
- This is a full-stack CRUD web application (“api-carros-java-angular”) with:
- Frontend: Angular SPA (Single Page Application)
- Backend: Java Spring Boot REST API
- Database: relational (initialized via schema.sql)

##### File Structure
- Top level folders:
- api/ → Spring Boot app
- frontend/ → Angular client
- In api/:
- src/main/java/com/michaelcruz/api/controllers → REST controllers (Carro, Marca, Cor)
- …/services & …/services/impl → business logic
- …/repositories → Spring Data JPA repos
- …/entities → JPA entities
- resources/application.properties & schema.sql → DB config
- In frontend/:
- src/app/components & pages → Angular UI components/pages
- src/app/services → HTTP client services for Carro, Marca, Cor
- src/app/model → TypeScript models
- angular.json, package.json → build config

##### Key README Insights
- Purpose: demonstrate CRUD operations on “carros”
- Stack: Java + Spring Boot + Angular

##### Detailed Breakdown of Components
- Frontend zone:
- UI Pages: Home, Lista, Cadastro-Form
- Shared Components: Card-Inicio
- Services: CarroService, MarcaService, CorService
- Models: Carro.ts, Marca.ts, Cor.ts
- Backend zone:
- REST Controllers: CarroController, MarcaController, CorController
- Service Layer: CarroServiceImpl (implements CarroService), MarcaService, CorService
- Persistence Layer: CarroRepository, MarcaRepository, CorRepository
- Entities: Carro, Marca, Cor
- Util: CarroUtil for mapping or DTO logic
- Config: application.properties (DB URL, credentials), schema.sql

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Angular SPA - port 4200)"
        direction TB
        AngularSPA["Angular SPA"]:::frontend
        subgraph "UI Pages"
            direction TB
            Home["HomeComponent"]:::frontend
            Lista["ListaComponent"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            CadastroForm["CadastroFormComponent"]:::frontend
            CardInicio["CardInicioComponent"]:::frontend
        end
        subgraph "Angular Services"
            direction TB
            CarroService["CarroService"]:::frontend
            MarcaService["MarcaService"]:::frontend
            CorService["CorService"]:::frontend
        end
        subgraph "Models"
            direction TB
            CarroModel["Carro.ts"]:::frontend
            MarcaModel["Marca.ts"]:::frontend
            CorModel["Cor.ts"]:::frontend
        end
    end

    %% Server Layer
    subgraph "Server (Spring Boot App - port 8080)"
        direction TB
        SpringApp["Spring Boot App"]:::server
        subgraph "Controllers"
            direction TB
            CarroController["CarroController"]:::server
            MarcaController["MarcaController"]:::server
            CorController["CorController"]:::server
        end
        subgraph "Service Layer"
            direction TB
            CarroServiceIF["CarroService (interface)"]:::server
            CarroServiceImpl["CarroServiceImpl"]:::server
            MarcaServiceIF["MarcaService (interface)"]:::server
            CorServiceIF["CorService (interface)"]:::server
        end
        subgraph "Repositories"
            direction TB
            CarroRepo["CarroRepository"]:::server
            MarcaRepo["MarcaRepository"]:::server
            CorRepo["CorRepository"]:::server
        end
        subgraph "Entities"
            direction TB
            CarroEntity["Carro"]:::server
            MarcaEntity["Marca"]:::server
            CorEntity["Cor"]:::server
        end
        Util["CarroUtil"]:::server
        Config["application.properties"]:::server
        Schema["schema.sql"]:::server
    end

    %% Database
    Database["Relational Database"]:::database

    %% Frontend interactions
    AngularSPA -->|uses| Home
    AngularSPA -->|uses| Lista
    AngularSPA -->|uses| CadastroForm
    AngularSPA -->|uses| CardInicio
    Home -->|injects| CarroService
    Home -->|injects| MarcaService
    Home -->|injects| CorService
    Lista -->|injects| CarroService
    CadastroForm -->|injects| CarroService
    CardInicio -->|injects| MarcaService
    CarroService -->|HTTP GET/POST| CarroController
    MarcaService -->|HTTP GET/POST| MarcaController
    CorService -->|HTTP GET/POST| CorController

    %% Backend flow
    CarroController -->|calls| CarroServiceIF
    MarcaController -->|calls| MarcaServiceIF
    CorController -->|calls| CorServiceIF
    CarroServiceIF -->|implemented by| CarroServiceImpl
    CarroServiceImpl -->|uses| CarroRepo
    MarcaServiceIF -->|uses| MarcaRepo
    CorServiceIF -->|uses| CorRepo
    CarroRepo -->|manages| CarroEntity
    MarcaRepo -->|manages| MarcaEntity
    CorRepo -->|manages| CorEntity
    CarroServiceImpl -->|utilizes| Util
    Config -->|configures| Database
    Schema -->|initializes| Database
    CarroRepo -->|reads/writes| Database
    MarcaRepo -->|reads/writes| Database
    CorRepo -->|reads/writes| Database

    %% Click Events Frontend
    click AngularSPA "https://github.com/dev-michaelcruz/api-carros-java-angular/tree/main/frontend/src/app"
    click Home "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/pages/home/home.component.ts"
    click Lista "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/pages/lista/lista.component.ts"
    click CadastroForm "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/components/cadastro-form/cadastro-form.component.ts"
    click CardInicio "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/components/card-inicio/card-inicio.component.ts"
    click CarroService "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/services/carro-service.service.ts"
    click MarcaService "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/services/marca.service.ts"
    click CorService "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/services/cor.service.ts"
    click CarroModel "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/model/Carro.ts"
    click MarcaModel "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/model/Marca.ts"
    click CorModel "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/frontend/src/app/model/Cor.ts"

    %% Click Events Backend
    click SpringApp "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/ApiApplication.java"
    click CarroController "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/controllers/CarroController.java"
    click MarcaController "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/controllers/MarcaController.java"
    click CorController "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/controllers/CorController.java"
    click CarroServiceIF "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/services/CarroService.java"
    click CarroServiceImpl "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/services/CarroServiceImpl.java"
    click MarcaServiceIF "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/services/MarcaService.java"
    click CorServiceIF "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/services/CorService.java"
    click CarroRepo "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/repositories/CarroRepository.java"
    click MarcaRepo "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/repositories/MarcaRepository.java"
    click CorRepo "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/repositories/CorRepository.java"
    click CarroEntity "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/entities/Carro.java"
    click MarcaEntity "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/entities/Marca.java"
    click CorEntity "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/entities/Cor.java"
    click Util "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/java/com/michaelcruz/api/util/CarroUtil.java"
    click Config "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/resources/application.properties"
    click Schema "https://github.com/dev-michaelcruz/api-carros-java-angular/blob/main/api/src/main/resources/schema.sql"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#007B8F,color:#004D40
    classDef server fill:#E8F5E9,stroke:#388E3C,color:#1B5E20
    classDef database fill:#FFF3E0,stroke:#FFA000,color:#E65100
```
