# manoloracine/project354 architecture

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

- Interactive diagram: https://gitdiagram.com/manoloracine/project354
- Repository: https://github.com/manoloracine/project354

## Overview

##### Project type and purpose
- This is a Docker-based full-stack application consisting of:
- A Spring Boot Java backend (service name: backend354)
- A React + Vite frontend (service name: frontend354)
- Purpose: Expose REST endpoints (documented via Swagger) that leverage ImageMagick for image processing, and provide a live-reload React UI to call those endpoints.

##### File structure
Top-level:
- docker-compose.dev.yml – orchestrates both frontend and backend containers
- Backend354/ – Spring Boot project, with Maven wrapper, pom.xml, Dockerfile
└ src/main/java/com/project/backend354/
├ Backend354Application.java (application entry point)
└ TestController.java (example REST controller)
- frontend354/ – Vite-powered React app, with package.json, tsconfig, Dockerfile, docker-compose.dev.yml

Notable patterns and files:
- Separate Dockerfiles in each service directory
- Swagger UI auto-configuration via Springdoc (implied by README swagger-ui link)
- Live-reload support in the frontend container
- ImageMagick installed inside the backend container

##### README for additional insights
- docker-compose.dev.yml brings up both services together
- Swagger UI on port 8080 for backend API testing
- React UI on port 5173 with hot-reload
- Backend container bundles ImageMagick for on-the-fly image operations

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Orchestration Layer
    DC["Docker Compose (dev)"]:::devops
    DC -->|"orchestrates"| FE_Container
    DC -->|"orchestrates"| BE_Container

    %% Frontend Container
    subgraph "Frontend Container" 
        direction TB
        FE_Dockerfile["Dockerfile"]:::devops
        FE_Package["package.json"]:::frontend
        FE_Vite["vite.config.ts"]:::frontend
        FE_TSConfig["tsconfig.json / app / node.json"]:::frontend
        FE_MainTSX["src/main.tsx"]:::frontend
        FE_AppTSX["src/App.tsx"]:::frontend
        FE_Public["public/"]:::frontend
        FE_Assets["src/assets/"]:::frontend
        FE_HTML["index.html"]:::frontend
        FE_CSS["src/index.css / App.css"]:::frontend
        FE_DevCompose["docker-compose.dev.yml"]:::devops
        FE_Readme["README.md"]:::devops
        FE_HotReload["Hot-reload (file watcher)"]:::external
        FE_Container --> FE_Dockerfile
        FE_Container --> FE_Package
        FE_Container --> FE_Vite
        FE_Container --> FE_TSConfig
        FE_Container --> FE_MainTSX
        FE_Container --> FE_AppTSX
        FE_Container --> FE_Public
        FE_Container --> FE_Assets
        FE_Container --> FE_HTML
        FE_Container --> FE_CSS
        FE_Container --> FE_DevCompose
        FE_Container --> FE_Readme
        FE_Container --> FE_HotReload
    end

    %% Backend Container
    subgraph "Backend Container"
        direction TB
        BE_Dockerfile["Dockerfile"]:::devops
        BE_Pom["pom.xml"]:::backend
        BE_Mvnw["mvnw & mvnw.cmd"]:::backend
        BE_Wrapper["maven-wrapper.properties"]:::backend
        BE_Properties["application.properties"]:::backend
        BE_App["Backend354Application.java"]:::backend
        BE_Controller["TestController.java"]:::backend
        BE_ImageMagick["ImageMagick CLI"]:::external
        BE_Container --> BE_Dockerfile
        BE_Container --> BE_Pom
        BE_Container --> BE_Mvnw
        BE_Container --> BE_Wrapper
        BE_Container --> BE_Properties
        BE_Container --> BE_App
        BE_Container --> BE_Controller
        BE_Container --> BE_ImageMagick
    end

    %% User and Flows
    User["User's Browser"]:::external
    User -->|"HTTP request"| FE_Container
    FE_Container -->|"REST API calls"| BE_Container
    BE_Controller -->|"invokes CLI"| BE_ImageMagick
    BE_Container -.->|"Swagger UI (port 8080)"| User

    classDef frontend fill:#1f77b4,stroke:#333,stroke-width:1px,color:#fff;
    classDef backend fill:#2ca02c,stroke:#333,stroke-width:1px,color:#000;
    classDef devops fill:#ff7f0e,stroke:#333,stroke-width:1px,color:#000;
    classDef external fill:#d62728,stroke:#333,stroke-width:1px,color:#fff;

    %% Click Events
    click DC "https://github.com/manoloracine/project354/blob/master/docker-compose.dev.yml"
    click FE_Dockerfile "https://github.com/manoloracine/project354/tree/master/frontend354/Dockerfile"
    click FE_Package "https://github.com/manoloracine/project354/blob/master/frontend354/package.json"
    click FE_Vite "https://github.com/manoloracine/project354/blob/master/frontend354/vite.config.ts"
    click FE_TSConfig "https://github.com/manoloracine/project354/blob/master/frontend354/tsconfig.json"
    click FE_TSConfig "https://github.com/manoloracine/project354/blob/master/frontend354/tsconfig.app.json"
    click FE_TSConfig "https://github.com/manoloracine/project354/blob/master/frontend354/tsconfig.node.json"
    click FE_MainTSX "https://github.com/manoloracine/project354/blob/master/frontend354/src/main.tsx"
    click FE_AppTSX "https://github.com/manoloracine/project354/blob/master/frontend354/src/App.tsx"
    click FE_Public "https://github.com/manoloracine/project354/tree/master/frontend354/public/"
    click FE_Assets "https://github.com/manoloracine/project354/tree/master/frontend354/src/assets/"
    click FE_HTML "https://github.com/manoloracine/project354/blob/master/frontend354/index.html"
    click FE_CSS "https://github.com/manoloracine/project354/blob/master/frontend354/src/index.css"
    click FE_CSS "https://github.com/manoloracine/project354/blob/master/frontend354/src/App.css"
    click FE_DevCompose "https://github.com/manoloracine/project354/blob/master/frontend354/docker-compose.dev.yml"
    click FE_Readme "https://github.com/manoloracine/project354/blob/master/frontend354/README.md"
    click BE_Dockerfile "https://github.com/manoloracine/project354/tree/master/Backend354/Dockerfile"
    click BE_Pom "https://github.com/manoloracine/project354/blob/master/Backend354/pom.xml"
    click BE_Mvnw "https://github.com/manoloracine/project354/tree/master/Backend354/mvnw"
    click BE_Mvnw "https://github.com/manoloracine/project354/blob/master/Backend354/mvnw.cmd"
    click BE_Wrapper "https://github.com/manoloracine/project354/blob/master/Backend354/.mvn/wrapper/maven-wrapper.properties"
    click BE_Properties "https://github.com/manoloracine/project354/blob/master/Backend354/src/main/resources/application.properties"
    click BE_App "https://github.com/manoloracine/project354/blob/master/Backend354/src/main/java/com/project/backend354/Backend354Application.java"
    click BE_Controller "https://github.com/manoloracine/project354/blob/master/Backend354/src/main/java/com/project/backend354/TestController.java"
```
