# jhonsgomez/sistemastg architecture

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

- Interactive diagram: https://gitdiagram.com/jhonsgomez/sistemastg
- Repository: https://github.com/jhonsgomez/sistemastg

## Overview

##### Project type and purpose
- This is a full-stack web application built on the Laravel PHP framework.
- Purpose: an academic project-management portal for handling user registration/authentication (via Fortify & Jetstream), role/permission management, project proposals (“banco”), deadlines and reminders (via Console Commands), historical reporting, file uploads/downloads, and email notifications.

##### File structure
- Top-level:
- app/ – core PHP code (Models, Controllers, Actions, Mailables, Importers, Middleware, Console Commands)
- config/ – environment and package configs (database, queue, mail, Fortify, Jetstream)
- database/ – migrations & seeders defining schemas (users, roles & permissions, solicitudes, campos, valores, actas, historico)
- resources/ – frontend assets: CSS/JS (Vite), Blade views (layouts, components, pages, email templates)
- public/ – entry point (index.php), static assets (js compiled, pdf examples, formatos, images)
- routes/ – routing definitions (web.php, api.php, console.php, channels.php)
- storage/ & bootstrap/cache/ – compiled views, logs, file uploads, cache
- tests/ – Feature & Unit tests using PHPUnit
- Architectural patterns:
- MVC: app/Http/Controllers ↔ resources/views ↔ app/Models
- Service providers for bootstrapping services (app/Providers)
- Console commands & Scheduler for background jobs (app/Console, config/queue.php, Kernel.php)
- Mailables & Queues for asynchronous email dispatch

##### README for additional insights
- The README is the default Laravel boilerplate; it confirms use of core Laravel features but provides no domain-specific architecture details.
- Domain logic lives in custom Controllers, Actions (Fortify & Jetstream overrides), Console Commands, and Mail classes.

##### Final advice
- Essential elements: routing, middleware, controllers, jobs, mailers, data stores.
- Avoid overcomplication: represent each logical layer clearly.
- Where custom business modules live (e.g., ProyectosController, Recordatorio commands, BaseDocumental).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Client (Browser)"]:::external
        Browser -->|"HTTP Request"| WebServer
    end

    %% Web Server
    subgraph "Web Server"
        direction TB
        WebServer["Nginx/Apache + PHP-FPM"]:::infra
        WebServer -->|"index.php"| LaravelApp
    end

    %% Application Layer
    subgraph "Laravel Application"
        direction TB

        %% HTTP Layer
        subgraph "HTTP Layer"
            direction TB
            Routes["Routing (web.php, api.php)"]:::app
            Middleware["Middleware"]:::app
            Controllers["Controllers"]:::app
            Models["Eloquent Models"]:::app
            Views["Blade Views"]:::app
            Routes -->|invoke| Middleware
            Middleware -->|calls| Controllers
            Controllers -->|uses| Models
            Controllers -->|renders| Views
        end

        %% Console Layer
        subgraph "Console & Queue"
            direction TB
            Scheduler["Scheduler (Kernel.php)"]:::app
            Commands["Console Commands"]:::app
            QueueWorker["Queue Worker"]:::app
            Mailables["Mailables & Jobs"]:::app
            Scheduler -->|schedules| Commands
            Commands -->|dispatch| Mailables
            Mailables -->|queued to| QueueWorker
        end

        %% Service Providers
        Providers["Service Providers"]:::app
        Routes --> Providers
        Providers --> Controllers
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        Database["Database (MySQL/PostgreSQL)"]:::datastore
        Cache["Cache/Session Store (Redis)"]:::datastore
        QueueStore["Queue Backend (Redis/DB)"]:::datastore
        Storage["File Storage (local/S3)"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        SMTP["SMTP / Mail Provider"]:::external
    end

    %% Data Flows
    LaravelApp -->|DB queries| Database
    LaravelApp -->|cache/session| Cache
    LaravelApp -->|filesystem| Storage
    QueueWorker -->|process jobs| Storage
    Mailables -->|send email| SMTP

    %% Click Events - Authentication
    click CreateNewUser "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Fortify/CreateNewUser.php"
    click ResetUserPassword "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Fortify/ResetUserPassword.php"
    click UpdateUserPassword "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Fortify/UpdateUserPassword.php"
    click UpdateUserProfileInformation "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Fortify/UpdateUserProfileInformation.php"
    click PasswordValidationRules "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Fortify/PasswordValidationRules.php"
    click DeleteUser "https://github.com/jhonsgomez/sistemastg/blob/main/app/Actions/Jetstream/DeleteUser.php"
    click FortifyConfig "https://github.com/jhonsgomez/sistemastg/blob/main/config/fortify.php"
    click JetstreamConfig "https://github.com/jhonsgomez/sistemastg/blob/main/config/jetstream.php"
    click FortifyProvider "https://github.com/jhonsgomez/sistemastg/blob/main/app/Providers/FortifyServiceProvider.php"
    click JetstreamProvider "https://github.com/jhonsgomez/sistemastg/blob/main/app/Providers/JetstreamServiceProvider.php"
    click AuthViews "https://github.com/jhonsgomez/sistemastg/tree/main/resources/views/auth"
    click WebRoutes "https://github.com/jhonsgomez/sistemastg/blob/main/routes/web.php"

    %% Click Events - Role & Permission
    click RoleController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/RoleController.php"
    click PermissionController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/PermissionController.php"
    click PermissionConfig "https://github.com/jhonsgomez/sistemastg/blob/main/config/permission.php"
    click RolesPermissionsMigration "https://github.com/jhonsgomez/sistemastg/blob/main/database/migrations/2024_11_20_192330_create_roles_and_permissions_table.php"
    click RolesAndPermissionsSeeder "https://github.com/jhonsgomez/sistemastg/blob/main/database/seeders/RolesAndPermissionsSeeder.php"
    click CheckPermission "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Middleware/CheckPermission.php"
    click RoleViews "https://github.com/jhonsgomez/sistemastg/tree/main/resources/views/roles"

    %% Click Events - Proposals
    click SolicitudBancoController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/SolicitudBancoController.php"
    click BancoViews "https://github.com/jhonsgomez/sistemastg/tree/main/resources/views/banco"
    click PropuestaBancoMail "https://github.com/jhonsgomez/sistemastg/blob/main/app/Mail/PropuestaBancoMail.php"
    click SolicitudesMigration "https://github.com/jhonsgomez/sistemastg/blob/main/database/migrations/2024_11_25_145421_create_solicitudes_table.php"

    %% Click Events - Deadlines & Reminders
    click VencimientoPropuesta "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Commands/VencimientoPropuesta.php"
    click VencimientoInforme "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Commands/VencimientoInforme.php"
    click EnviarRecordatorioPropuesta "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Commands/EnviarRecordatorioPropuesta.php"
    click EnviarRecordatorioInforme "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Commands/EnviarRecordatorioInforme.php"
    click RecordatorioRevision "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Commands/RecordatorioRevision.php"
    click ConsoleKernel "https://github.com/jhonsgomez/sistemastg/blob/main/app/Console/Kernel.php"
    click QueueConfig "https://github.com/jhonsgomez/sistemastg/blob/main/config/queue.php"
    click ConsoleRoutes "https://github.com/jhonsgomez/sistemastg/blob/main/routes/console.php"

    %% Click Events - Historical Reporting
    click HistoricoController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/HistoricoController.php"
    click HistoricoModel "https://github.com/jhonsgomez/sistemastg/blob/main/app/Models/Historico.php"
    click HistoricoMigration "https://github.com/jhonsgomez/sistemastg/blob/main/database/migrations/2025_04_28_075619_create_historico_table.php"
    click ReportesMail "https://github.com/jhonsgomez/sistemastg/blob/main/app/Mail/ReportesMail.php"
    click HistoricoViews "https://github.com/jhonsgomez/sistemastg/blob/main/resources/views/historico/index.blade.php"

    %% Click Events - File Uploads
    click BaseDocumentalController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/BaseDocumentalController.php"
    click FilesystemsConfig "https://github.com/jhonsgomez/sistemastg/blob/main/config/filesystems.php"
    click StoragePublic "https://github.com/jhonsgomez/sistemastg/tree/main/storage/app/public"
    click DocumentalViews "https://github.com/jhonsgomez/sistemastg/blob/main/resources/views/documental/index.blade.php"
    click FormatTemplates "https://github.com/jhonsgomez/sistemastg/tree/main/public/formatos"

    %% Click Events - Email Notifications
    click BaseMailable "https://github.com/jhonsgomez/sistemastg/blob/main/app/Mail/BaseMailable.php"
    click RecordatorioPropuestaMail "https://github.com/jhonsgomez/sistemastg/blob/main/app/Mail/RecordatorioPropuesta.php"
    click EmailsFolder "https://github.com/jhonsgomez/sistemastg/tree/main/resources/views/emails"

    %% Click Events - General MVC
    click ProyectoGradoController "https://github.com/jhonsgomez/sistemastg/blob/main/app/Http/Controllers/ProyectoGradoController.php"
    click UserModel "https://github.com/jhonsgomez/sistemastg/blob/main/app/Models/User.php"

    %% Click Events - Routes
    click ApiRoutes "https://github.com/jhonsgomez/sistemastg/blob/main/routes/api.php"
    click ChannelsRoutes "https://github.com/jhonsgomez/sistemastg/blob/main/routes/channels.php"

    %% Styles
    classDef app fill:#D6E9F8,stroke:#003366,color:#003366
    classDef datastore fill:#DFF0D8,stroke:#336633,color:#336633
    classDef external fill:#FCF8E3,stroke:#665500,color:#665500
    classDef infra fill:#F2DEDE,stroke:#993333,color:#993333
```
