# kevinjaimesguaman/prueba1 architecture

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

- Interactive diagram: https://gitdiagram.com/kevinjaimesguaman/prueba1
- Repository: https://github.com/kevinjaimesguaman/prueba1

## Overview

##### Project type and purpose
- Full-stack web application for managing university olympiads (“Olimpiadas ¡oh sansi!”).
- Frontend: React.js SPA (Vite-powered), handles user roles (admin, gestor, tutor, competidor) and UI flows.
- Backend: Laravel 8 REST API, implements business logic, data persistence, authentication/authorization, notifications.

##### File structure
- Top level: two siblings, **backend/** and **frontend/**.
- backend/: standard Laravel MVC (app/Models, app/Http/Controllers, resources/views, routes/, config/, database/migrations & seeders). Uses Sanctum for auth, queues/events for notifications.
- frontend/: React project (src/components, src/page, src/routes, assets, context/hooks). Uses React Router for client-side routing, CSS modules, JSON configs (notificacion.json, tutores.json).

##### Main components
a. Frontend SPA
- React Router layer (AppRouter, AppRouteLogin, AppRouteTutor, etc.)
- Page containers (HomeAdmin, HomeRespGest, TutorHome, Login)
- Reusable UI components (tables, modals, cards, search bar)
- State/context/hooks layer (authentication context, data hooks)
b. API Server (Laravel)
- HTTP entrypoint (public/index.php, server.php)
- Routing layer (routes/api.php)
- Controllers (app/Http/Controllers/Api/*Controller.php)
- Resources/Transformers (app/Http/Resources/*Resource.php)
- Models/Eloquent (app/Models/*.php)
- Middleware (auth, CORS, CSRF, etc.)
- Service providers (bootstrapping, events)
- Jobs/Events/Notifications (if applicable)
c. Data Layer
- MySQL database (tables for Area, Boleta, Competidor, Tutor, Competencia, Notificacion, etc.)
- Migrations & seeders (database/migrations, database/seeders)
d. External Services
- Mailer (SMTP or mail‐service)
- (Optional) Caching or queue backends (Redis, if configured)
- Storage (local filesystem under storage/, could be S3 in prod)

##### Relationships and data flow
- User’s browser ←→ React SPA (HTTP/HTTPS)
- React SPA → Laravel API endpoints (RESTful JSON calls via fetch or Axios)
- Laravel Controllers → Models (Eloquent ORM) → MySQL
- Laravel → Notification/Mailer (email or in-app notifications)
- Authentication: React obtains JWT/token from Laravel Sanctum, stores in context, attaches to API calls.

##### Architectural patterns and design principles
- Backend: MVC with clear separation of routing, controllers (business logic), models (data), and resources (presentation).
- Frontend: Component-based UI with container/page components for each role, global context for auth/state, React Router for navigation.
- RESTful API contract decouples frontend and backend.
- Use of migrations/seeders enforces schema versioning and reproducible test data.
- Dependency injection and service providers in Laravel for extensibility.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Frontend (React SPA)"
        Browser["User Browser"]:::external
        ReactSPA["React SPA"]:::frontend
        Router["AppRouter"]:::frontend
        RouteLogin["AppRouteLogin"]:::frontend
        RouteTutor["AppRouteTutor"]:::frontend
        RouteRespGest["AppRouteRespGest"]:::frontend
        HomeAdmin["HomeAdmin"]:::frontend
        HomeRespGest["HomeRespGest"]:::frontend
        TutorHome["TutorHome"]:::frontend
        LoginPage["Login"]:::frontend
        TableComp["TablaCompetidores"]:::component
        ModalDelete["ModalConfirmDelete"]:::component
        ModalArea["ModalAreaInfo"]:::component
        ModalElimCat["ModalEliminarCategoria"]:::component
        SearchBar["SearchBar"]:::component
        CompetidorCard["CompetidorCard"]:::component
        PagoDetails["VerDetallesPago"]:::component
        VisualPagos["VisualizarTablaPagos"]:::component
        Context["Context"]:::component
        Hooks["Hooks"]:::component
    end

    subgraph "Backend (Laravel API)"
        IndexPHP["public/index.php"]:::backend
        ServerScript["server.php"]:::backend
        APIRoutes["routes/api.php"]:::backend
        Controllers["Controllers (Api/*Controller)"]:::backend
        Resources["Resources/Transformers"]:::backend
        Models["Models"]:::backend
        Middleware["Middleware"]:::backend
        Providers["ServiceProviders"]:::backend
        Jobs["Jobs/Events/Notifications"]:::backend
    end

    Database["MySQL Database\n(tables: area, competidor, tutor, etc.)"]:::database

    subgraph "External Services"
        Mailer["Mailer/Notification Service"]:::external
        CacheQueue["Cache/Queue (Redis)"]:::external
    end

    Browser --> ReactSPA
    ReactSPA --> Router
    Router --> RouteLogin
    Router --> RouteTutor
    Router --> RouteRespGest
    Router --> HomeAdmin
    Router --> HomeRespGest
    Router --> TutorHome
    Router --> LoginPage
    ReactSPA --> TableComp
    ReactSPA --> ModalDelete
    ReactSPA --> ModalArea
    ReactSPA --> ModalElimCat
    ReactSPA --> SearchBar
    ReactSPA --> CompetidorCard
    ReactSPA --> PagoDetails
    ReactSPA --> VisualPagos
    ReactSPA --> Context
    ReactSPA --> Hooks

    ReactSPA -->|HTTP/JSON| IndexPHP
    ReactSPA -->|HTTP/JSON| ServerScript
    IndexPHP --> APIRoutes
    ServerScript --> APIRoutes
    APIRoutes --> Controllers
    Controllers --> Resources
    Resources --> Models
    Models --> Database
    Controllers -->|send emails| Mailer
    Controllers -->|queue jobs| CacheQueue

    click frontend/src/routes/AppRouter.jsx Router
    click frontend/src/routes/AppRouteLogin.jsx RouteLogin
    click frontend/src/routes/AppRouteTutor.jsx RouteTutor
    click frontend/src/routes/AppRouteRespGest.jsx RouteRespGest
    click frontend/src/page/administrador/HomeAdmin.jsx HomeAdmin
    click frontend/src/page/reponsableGestion/HomeRespGest.jsx HomeRespGest
    click frontend/src/page/tutor/HomeTutor/TutorHome.jsx TutorHome
    click frontend/src/page/home/login.jsx LoginPage
    click frontend/src/components/tablaCompetidores/TablaCompetidores.jsx TableComp
    click frontend/src/components/ModalConfirmDelete.jsx ModalDelete
    click frontend/src/components/ModalAreaInfo.jsx ModalArea
    click frontend/src/components/ModalEliminarCategoria.jsx ModalElimCat
    click frontend/src/components/searchBar\(hu12\)/SearchBar.jsx SearchBar
    click frontend/src/components/competidorCard/CompetidorCard.jsx CompetidorCard
    click frontend/src/components/verDetallesPago/VerDetallesPago.jsx PagoDetails
    click frontend/src/components/visualizarTablaPagos/VisualizarTablaPagos.jsx VisualPagos
    click frontend/src/context Context
    click frontend/src/hooks Hooks
    click backend/public/index.php IndexPHP
    click backend/server.php ServerScript

    classDef frontend fill:#DAE8FC,stroke:#6C8EBF,color:#1A237E
    classDef backend fill:#D5E8D4,stroke:#82B366,color:#1B5E20
    classDef component fill:#E1D5E7,stroke:#9673A6,color:#4A148C
    classDef database fill:#FFE6CC,stroke:#D79B00,color:#BF360C
    classDef external fill:#F8CECC,stroke:#B85450,color:#4E342E
```
