# ciromontes/clinicaveterinariabackend architecture

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

- Interactive diagram: https://gitdiagram.com/ciromontes/clinicaveterinariabackend
- Repository: https://github.com/ciromontes/clinicaveterinariabackend

## Overview

##### Project type and purpose
- This is a monolithic full-stack application built with Spring Boot (Java) that bundles and serves a React/Vite Single Page App (SPA) from its static resources and exposes REST APIs for user authentication, appointment (cita) management, and pet (mascota) management.
- The README confirms:
- Backend: Spring Boot + Maven
- Frontend: React/Vite compiled into static assets under src/main/resources/static
- Persistent storage: MySQL
- Security: JWT-based authentication

##### File structure
- Top-level:
- pom.xml, mvnw(.cmd): Maven build configuration
- src/main/java/com/sena/clinicaveterinaria: Java source
- src/main/resources/static: built frontend (index.html, assets)
- src/main/resources/application.properties: DB, JWT and server config
- Java packages:
- config: SecurityConfig, SpaRedirectConfig
- controller: REST endpoints (AuthController, CitaController, MascotaController, UsuarioController)
- dto: request/response payloads (LoginRequest, AuthResponse)
- model: JPA entities (Usuario, Mascota, Cita)
- repository: Spring Data JPA interfaces
- service & service/impl: business logic, JWT handling
- Tests: src/test/java covers application startup test

##### Key architectural insights from the README
- Monolithic deployment: single JAR packaging both backend and frontend
- JWT security filter applied to /api/**
- Standard CRUD REST endpoints for citas and mascotas
- Database schema must be pre-created in MySQL

a. Controllers (AuthController, CitaController, MascotaController)
b. Services (JwtService, CitaServiceImpl, MascotaServiceImpl, UsuarioServiceImpl)
c. Repositories (CitaRepository, MascotaRepository, UsuarioRepository)
6. Off to the side, note the static-file serving component (SpaRedirectConfig) that delivers index.html and hashed assets from src/main/resources/static.
- “GET / → index.html”
- “POST /api/auth/login → AuthController.login() → JwtService.generateToken()”
- “GET/POST/PUT/DELETE /api/citas → CitaController → CitaService → CitaRepository → MySQL”
- Blue = HTTP/API layer
- Green = business logic
- Yellow = persistence
- Grey = static resource serving

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    Browser(["Browser / React SPA"]):::frontend
    Assets(["Static Assets"]):::frontend
    Browser -->|"GET /"| SpaRedirectConfig
    SpaRedirectConfig -->|"serves index.html & assets"| Browser
    Browser -->|"POST /api/auth/login"| SecurityConfig
    Browser -->|"API Requests with JWT"| SecurityConfig

    %% Spring Boot Application Entry & Config
    subgraph "Spring Boot Application"
        direction TB
        AppEntry(["GestionCitasApplication"]):::backend
        AppConfig(["application.properties"]):::backend
        SecurityConfig(["JWT Security Filter"]):::security
        SpaRedirectConfig(["SPA Redirect Config"]):::backend

        %% Controllers Layer
        subgraph "Controllers" 
            direction TB
            AuthController(["AuthController"]):::controller
            CitaController(["CitaController"]):::controller
            MascotaController(["MascotaController"]):::controller
            UsuarioController(["UsuarioController"]):::controller
        end

        %% Services Layer
        subgraph "Services"
            direction TB
            JwtService(["JwtService"]):::service
            CitaServiceImpl(["CitaServiceImpl"]):::service
            MascotaServiceImpl(["MascotaServiceImpl"]):::service
            UsuarioServiceImpl(["UsuarioServiceImpl"]):::service
        end

        %% Repositories Layer
        subgraph "Repositories"
            direction TB
            CitaRepository(["CitaRepository"]):::repository
            MascotaRepository(["MascotaRepository"]):::repository
            UsuarioRepository(["UsuarioRepository"]):::repository
        end
    end

    %% Database
    MySQL[(MySQL Database)]:::database

    %% Interactions
    SecurityConfig --> AuthController
    SecurityConfig --> CitaController
    SecurityConfig --> MascotaController
    SecurityConfig --> UsuarioController

    AuthController -->|"login() → generateToken()"| JwtService
    AuthController -->|"calls Service"| UsuarioServiceImpl
    CitaController -->|"calls Service"| CitaServiceImpl
    MascotaController -->|"calls Service"| MascotaServiceImpl
    UsuarioController -->|"calls Service"| UsuarioServiceImpl

    JwtService -->|"optional JPA calls"| UsuarioRepository

    UsuarioServiceImpl -->|"JPA calls"| UsuarioRepository
    CitaServiceImpl -->|"JPA calls"| CitaRepository
    MascotaServiceImpl -->|"JPA calls"| MascotaRepository

    CitaRepository -->|"JPA calls"| MySQL
    MascotaRepository -->|"JPA calls"| MySQL
    UsuarioRepository -->|"JPA calls"| MySQL

    %% Click Events
    click Browser "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/resources/static/index.html"
    click Assets "https://github.com/ciromontes/clinicaveterinariabackend/tree/main/src/main/resources/static/assets"
    click AppEntry "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/GestionCitasApplication.java"
    click AppConfig "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/resources/application.properties"
    click SecurityConfig "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/config/SecurityConfig.java"
    click SpaRedirectConfig "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/config/SpaRedirectConfig.java"
    click AuthController "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/controller/AuthController.java"
    click CitaController "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/controller/CitaController.java"
    click MascotaController "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/controller/MascotaController.java"
    click UsuarioController "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/controller/UsuarioController.java"
    click JwtService "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/service/JwtService.java"
    click CitaServiceImpl "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/service/impl/CitaServiceImpl.java"
    click MascotaServiceImpl "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/service/impl/MascotaServiceImpl.java"
    click UsuarioServiceImpl "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/service/impl/UsuarioServiceImpl.java"
    click CitaRepository "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/repository/CitaRepository.java"
    click MascotaRepository "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/repository/MascotaRepository.java"
    click UsuarioRepository "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/src/main/java/com/sena/clinicaveterinaria/repository/UsuarioRepository.java"
    click MySQL "https://github.com/ciromontes/clinicaveterinariabackend/blob/main/ClinicaVeterinaria_Script_EV03.sql"

    %% Styles
    classDef frontend fill:#D6E9FE,stroke:#0366D6,color:#0366D6
    classDef backend fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32
    classDef controller fill:#BBDEFB,stroke:#1976D2,color:#1976D2
    classDef service fill:#C8E6C9,stroke:#388E3C,color:#388E3C
    classDef repository fill:#FFF9C4,stroke:#F9A825,color:#F9A825
    classDef database fill:#FFE0B2,stroke:#E65100,color:#E65100
    classDef security fill:#EEEEEE,stroke:#616161,color:#616161
```
