# maricielotz/sistema_legajos architecture

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

- Interactive diagram: https://gitdiagram.com/maricielotz/sistema_legajos
- Repository: https://github.com/maricielotz/sistema_legajos

## Overview

##### Project type and purpose
- From the file tree and README, this is a full-stack Laravel web application (“Sistema de Legajos”) used to manage personnel records (legajos), roles, labor regimes, documents, and user authentication/authorization. It supports two user roles (admin and user), PDF generation (DomPDF), and standard CRUD operations.

##### File structure
- Top-level directories:
- app/ (MVC controllers, models, middleware, providers)
- routes/ (route definitions)
- resources/ (Blade views, CSS, JS)
- public/ (entry point index.php, static assets & admin theme)
- config/, bootstrap/, storage/, database/, tests/
- MVC pattern: Controllers in app/Http/Controllers, Models in app/Models, Views in resources/views.
- Build tools: Vite (vite.config.js), Tailwind (tailwind.config.js), PostCSS, npm/package.json.
- Third-party services: DomPDF (config/dompdf.php), mail & queue (config/mail.php, config/queue.php).
- Authentication guards & middleware: config/auth.php, app/Http/Middleware/IsAdmin.php.

##### README for additional insights
- Minimal README; confirms it is a “Sistema de Legajos” with team members. No further architecture notes, so we derive from file structure.

##### Detail
- Middleware decision points (e.g., route passes through IsAdmin).
- Caching or session storage if used.
- Both synchronous flows (render view) and asynchronous flows (queues).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    subgraph "Clients" 
        direction TB
        BrowserAdmin("Admin Browser"):::client
        BrowserUser("User Browser"):::client
    end

    %% Web Server
    subgraph "Web Server" 
        direction TB
        WebServer("Nginx/Apache + PHP-FPM"):::server
    end

    %% Laravel Application
    subgraph "Laravel Application"
        direction TB

        %% HTTP Layer
        subgraph "HTTP Layer"
            direction TB
            BootstrapApp["bootstrap/app.php"]:::appComp
            IsAdminMW["IsAdmin Middleware"]:::appComp
        end

        %% Routing Layer
        subgraph "Routing Layer"
            direction TB
            WebRoutes["routes/web.php"]:::appComp
            ConsoleRoutes["routes/console.php"]:::appComp
        end

        %% Controller Layer
        subgraph "Controller Layer"
            direction TB
            BaseController["Controller.php"]:::appComp
            LoginController["LoginController"]:::appComp
            RegisterController["RegisterController"]:::appComp
            DashboardController["DashboardController"]:::appComp
            LegajoController["LegajoController"]:::appComp
            CargoLaboralController["CargoLaboralController"]:::appComp
        end

        %% Service Layer
        subgraph "Service Layer"
            direction TB
            DomPDFService["DomPDF Service"]:::appComp
            MailService["Mail Service"]:::appComp
            QueueService["Queue Service"]:::appComp
            AuthConfig["Auth Config"]:::appComp
            AppProvider["AppServiceProvider"]:::appComp
        end

        %% Data Layer
        subgraph "Data Layer"
            direction TB
            UserModel["User Model"]:::appComp
            RolModel["Rol Model"]:::appComp
            DocumentoModel["Documento Model"]:::appComp
            CargoLaboralModel["CargoLaboral Model"]:::appComp
            RegimenLaboralModel["RegimenLaboral Model"]:::appComp
        end
    end

    %% Data Stores
    subgraph "Data Stores & Storage"
        direction TB
        Database["Relational DB (MySQL)"]:::datastore
        FileStorage["File Storage"]:::datastore
        CacheSession["Cache/Session (Redis/File)"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        SMTP["SMTP/Sendgrid"]:::external
        QueueWorker["Queue Workers"]:::external
    end

    %% Asset Pipeline
    subgraph "Asset Pipeline"
        direction TB
        ViteConfig["vite.config.js"]:::asset
        TailwindConfig["tailwind.config.js"]:::asset
        PostCSSConfig["postcss.config.js"]:::asset
        AssetsCSS["app.css"]:::asset
        AssetsJS["app.js"]:::asset
        PublicIndex["public/index.php"]:::asset
        PublicCSS["styles.css"]:::asset
        PublicJS["scripts.js"]:::asset
    end

    %% Connections
    BrowserAdmin -->|HTTP Request| WebServer
    BrowserUser -->|HTTP Request| WebServer
    WebServer -->|forward| BootstrapApp
    BootstrapApp -->|init Kernel & Middleware| IsAdminMW
    IsAdminMW -->|route through| WebRoutes
    WebRoutes -->|match| LoginController
    WebRoutes --> RegisterController
    WebRoutes --> DashboardController
    WebRoutes --> LegajoController
    WebRoutes --> CargoLaboralController
    WebRoutes --> BaseController
    LoginController --> UserModel
    RegisterController --> UserModel
    DashboardController --> RolModel
    LegajoController --> DocumentoModel
    CargoLaboralController --> CargoLaboralModel
    CargoLaboralController --> RegimenLaboralModel
    BaseController --> AppProvider
    LegajoController -->|generate| DomPDFService
    LoginController -->|send mail| MailService
    RegisterController -->|queue job| QueueService
    QueueService --> QueueWorker
    DomPDFService --> FileStorage
    Controllers --> Database
    Controllers --> CacheSession
    Database -->|store| FileStorage
    Controllers -->|dispatch| CacheSession

    %% Asset flow
    ViteConfig --> AssetsCSS
    ViteConfig --> AssetsJS
    AssetsCSS --> PublicCSS
    AssetsJS --> PublicJS
    PublicIndex -->|serves assets| PublicCSS
    PublicIndex --> PublicJS

    %% Data Stores connections
    UserModel --> Database
    RolModel --> Database
    DocumentoModel --> Database
    CargoLaboralModel --> Database
    RegimenLaboralModel --> Database

    %% External
    MailService --> SMTP

    %% Click Events
    click BootstrapApp "https://github.com/maricielotz/sistema_legajos/blob/main/bootstrap/app.php"
    click IsAdminMW "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Middleware/IsAdmin.php"
    click WebRoutes "https://github.com/maricielotz/sistema_legajos/blob/main/routes/web.php"
    click ConsoleRoutes "https://github.com/maricielotz/sistema_legajos/blob/main/routes/console.php"
    click BaseController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Controller.php"
    click LoginController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Backend/Auth/LoginController.php"
    click RegisterController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Backend/Auth/RegisterController.php"
    click DashboardController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Backend/Auth/DashboardController.php"
    click LegajoController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Backend/Auth/LegajoController.php"
    click CargoLaboralController "https://github.com/maricielotz/sistema_legajos/blob/main/app/Http/Controllers/Backend/Auth/CargoLaboralController.php"
    click UserModel "https://github.com/maricielotz/sistema_legajos/blob/main/app/Models/User.php"
    click RolModel "https://github.com/maricielotz/sistema_legajos/blob/main/app/Models/Rol.php"
    click DocumentoModel "https://github.com/maricielotz/sistema_legajos/blob/main/app/Models/Documento.php"
    click CargoLaboralModel "https://github.com/maricielotz/sistema_legajos/blob/main/app/Models/CargoLaboral.php"
    click RegimenLaboralModel "https://github.com/maricielotz/sistema_legajos/blob/main/app/Models/RegimenLaboral.php"
    click AppProvider "https://github.com/maricielotz/sistema_legajos/blob/main/app/Providers/AppServiceProvider.php"
    click DomPDFService "https://github.com/maricielotz/sistema_legajos/blob/main/config/dompdf.php"
    click MailService "https://github.com/maricielotz/sistema_legajos/blob/main/config/mail.php"
    click QueueService "https://github.com/maricielotz/sistema_legajos/blob/main/config/queue.php"
    click AuthConfig "https://github.com/maricielotz/sistema_legajos/blob/main/config/auth.php"
    click ViteConfig "https://github.com/maricielotz/sistema_legajos/blob/main/vite.config.js"
    click TailwindConfig "https://github.com/maricielotz/sistema_legajos/blob/main/tailwind.config.js"
    click PostCSSConfig "https://github.com/maricielotz/sistema_legajos/blob/main/postcss.config.js"
    click AssetsCSS "https://github.com/maricielotz/sistema_legajos/blob/main/resources/css/app.css"
    click AssetsJS "https://github.com/maricielotz/sistema_legajos/blob/main/resources/js/app.js"
    click PublicIndex "https://github.com/maricielotz/sistema_legajos/blob/main/public/index.php"
    click PublicCSS "https://github.com/maricielotz/sistema_legajos/blob/main/public/backend/assets/css/styles.css"
    click PublicJS "https://github.com/maricielotz/sistema_legajos/blob/main/public/backend/assets/js/scripts.js"

    %% Styles
    classDef client fill:#D0E6F6,stroke:#036,stroke-width:1px
    classDef server fill:#D6F5D6,stroke:#060,stroke-width:1px
    classDef appComp fill:#FDE9C9,stroke:#E68A00,stroke-width:1px
    classDef datastore fill:#E5D4F0,stroke:#6A1B9A,stroke-width:1px
    classDef external fill:#F0D4D4,stroke:#A81515,stroke-width:1px
    classDef asset fill:#D4E4F0,stroke:#1A5276,stroke-width:1px
```
