# jmarcosz/pasantiasrd architecture

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

- Interactive diagram: https://gitdiagram.com/jmarcosz/pasantiasrd
- Repository: https://github.com/jmarcosz/pasantiasrd

## Overview

##### Project Type and Purpose
- This is a full-stack web application built with Laravel (PHP) on the backend and Vue.js via Inertia.js on the frontend.
- The domain is an internship/job portal connecting students and companies, with features for vacancies, applications, company profiles, chat messaging, favorites, user profiles, and authorization (roles: student vs. company).

##### File Structure
- Top‐level:
- public/ – entry point (index.php), static assets (images, fonts).
- resources/js/ – Vue components, pages, layouts, app.js (bootstraps Inertia & Vue).
- resources/views/ – Blade templates (Inertia root view).
- app/Http/Controllers/ – Laravel controllers implementing routing logic (web + API).
- app/Models/ – Eloquent ORM models mapping to database tables.
- app/Http/Middleware/ – request filtering (role-based access for Empresa/Estudiante, Inertia handler).
- routes/ – route definitions (web.php for pages, api.php for JSON endpoints).
- database/ – migrations (schema), seeders, factories.
- config/, bootstrap/, storage/, etc. – configuration, caching, sessions, file storage.

##### Extract Additional Insights from README
- We infer typical Laravel patterns: MVC, Eloquent ORM, Inertia SPAs, event broadcasting (MessageSent event).

##### Detailed Component Breakdown
- Browser / Vue.js SPA
- Inertia.js adapter
- NGINX or Apache + PHP-FPM
- Laravel Middleware chain (auth, Empresa/Estudiante)
- Controllers & FormRequests
- Policies & Gates
- Eloquent Models & Relationships
- Database schema (main tables)
- File storage path
- Cache/Session store
- Queue workers (if used)
- Mail & Broadcast providers

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        VueSPA["Vue.js SPA"]:::frontend
        InertiaBoot["Inertia.js Adapter"]:::frontend
        InertiaRoot["Inertia Root Blade View"]:::frontend
    end

    %% Web Server Layer
    subgraph "Web Server Layer"
        direction TB
        PublicIndex["public/index.php"]:::backend
        PHPFPM["NGINX/Apache + PHP-FPM"]:::backend
        LaravelBoot["Laravel Application Bootstrap"]:::backend
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        RoutesWeb["routes/web.php"]:::backend
        RoutesAPI["routes/api.php"]:::backend
        MiddlewareChain["Middleware Chain"]:::backend
        Controllers["Controllers"]:::backend
        FormRequests["Form Request Validation"]:::backend
        Policies["Policies & Gates"]:::backend
        Models["Eloquent Models"]:::backend
        Events["Event Broadcasting"]:::backend
        QueueWorker["Queue Worker"]:::backend
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Database["Relational Database"]:::datastore
        FileStorage["File Storage"]:::datastore
        CacheSession["Cache & Session Store"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        MailProvider["Mail Provider"]:::external
        BroadcastServer["Pusher/Redis Broadcast"]:::external
    end

    %% Flows
    VueSPA -->|"Vue + Inertia" | InertiaBoot
    InertiaBoot -->|Visits| InertiaRoot
    InertiaRoot -->|Loads SPA| PublicIndex
    PublicIndex -->|Bootstraps App| LaravelBoot
    LaravelBoot -->|Registers Routes| RoutesWeb
    LaravelBoot -->|Registers API| RoutesAPI
    RoutesWeb -->|Handles HTTP| MiddlewareChain
    RoutesAPI -->|Handles JSON| MiddlewareChain
    MiddlewareChain -->|Auth & Roles| Controllers
    Controllers -->|Validate| FormRequests
    Controllers -->|Authorize| Policies
    Controllers -->|Read/Write| Models
    Models -->|Persist| Database
    Controllers -->|Dispatch| Events
    Events -->|Broadcast| BroadcastServer
    BroadcastServer -->|Push to Client| VueSPA
    Controllers -->|Dispatch Jobs| QueueWorker
    QueueWorker -->|Send Emails| MailProvider
    Controllers -->|Store Files| FileStorage
    MiddlewareChain -->|Load/Save| CacheSession

    %% Click Events
    click VueSPA "https://github.com/jmarcosz/pasantiasrd/blob/main/resources/js/app.js"
    click InertiaBoot "https://github.com/jmarcosz/pasantiasrd/blob/main/resources/js/bootstrap.js"
    click InertiaRoot "https://github.com/jmarcosz/pasantiasrd/blob/main/resources/views/app.blade.php"
    click PublicIndex "https://github.com/jmarcosz/pasantiasrd/blob/main/public/index.php"
    click LaravelBoot "https://github.com/jmarcosz/pasantiasrd/blob/main/bootstrap/app.php"
    click RoutesWeb "https://github.com/jmarcosz/pasantiasrd/blob/main/routes/web.php"
    click RoutesAPI "https://github.com/jmarcosz/pasantiasrd/blob/main/routes/api.php"
    click Controllers "https://github.com/jmarcosz/pasantiasrd/tree/main/app/Http/Controllers/"
    click MiddlewareChain "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Middleware/HandleInertiaRequests.php"
    click MiddlewareChain "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Middleware/EmpresaMiddleware.php"
    click MiddlewareChain "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Middleware/EstudianteMiddleware.php"
    click FormRequests "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Requests/StoreVacancyRequest.php"
    click FormRequests "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Requests/UpdateVacancyRequest.php"
    click FormRequests "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Http/Requests/StoreApplicationRequest.php"
    click Policies "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Policies/VacancyPolicy.php"
    click Policies "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Policies/ApplicationPolicy.php"
    click Policies "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Policies/CompanyPolicy.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/User.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/Vacancy.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/Application.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/Company.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/Chat.php"
    click Models "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Models/Mensaje.php"
    click Events "https://github.com/jmarcosz/pasantiasrd/blob/main/app/Events/MessageSent.php"
    click Database "https://github.com/jmarcosz/pasantiasrd/blob/main/database/migrations/2024_06_18_200214_create_vacancies_table.php"
    click Database "https://github.com/jmarcosz/pasantiasrd/blob/main/database/migrations/create_applications_table.php"
    click Database "https://github.com/jmarcosz/pasantiasrd/blob/main/database/migrations/create_chats_table.php"
    click Database "https://github.com/jmarcosz/pasantiasrd/blob/main/database/migrations/create_mensajes_table.php"
    click Database "https://github.com/jmarcosz/pasantiasrd/tree/main/database/seeders/"
    click Database "https://github.com/jmarcosz/pasantiasrd/tree/main/database/factories/"
    click FileStorage "https://github.com/jmarcosz/pasantiasrd/tree/main/storage/app/public/"
    click FileStorage "https://github.com/jmarcosz/pasantiasrd/tree/main/public/storage"
    click CacheSession "https://github.com/jmarcosz/pasantiasrd/tree/main/storage/framework/cache/"
    click CacheSession "https://github.com/jmarcosz/pasantiasrd/tree/main/storage/framework/sessions/"
    click QueueWorker "https://github.com/jmarcosz/pasantiasrd/blob/main/config/queue.php"
    click MailProvider "https://github.com/jmarcosz/pasantiasrd/blob/main/config/mail.php"
    click BroadcastServer "https://github.com/jmarcosz/pasantiasrd/blob/main/config/broadcasting.php"
    click BroadcastServer "https://github.com/jmarcosz/pasantiasrd/blob/main/config/services.php"
    click MiddlewareChain "https://github.com/jmarcosz/pasantiasrd/blob/main/config/session.php"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0277BD,color:#000
    classDef backend fill:#D0F2D0,stroke:#2E7D32,color:#000
    classDef datastore fill:#FFE0B2,stroke:#EF6C00,color:#000
    classDef external fill:#E0E0E0,stroke:#616161,color:#000
```
