Corpen Platform Architecture and Module Overview

Browser / PWA client
       │
       ▼
   Apache (port 80 in container, 83 on host)
       │
       ▼
   Laravel 11 HTTP Kernel
   ├── Global middleware: TrustHosts, TrustProxies, StartSession
   ├── Web group: EncryptCookies, AddQueuedCookiesToResponse, SubstituteBindings
   ├── Route middleware aliases:
   │   ├── auth          → Illuminate\Auth\Middleware\Authenticate
   │   ├── can           → Illuminate\Auth\Middleware\Authorize
   │   └── candirect     → App\Http\Middleware\CanDirect  ← custom
       │
       ▼
   Route groups (web.php — 1 266 lines)
   Each module: Route::prefix(…)->middleware(['auth'])->group(…)
       │
       ▼
   Controllers (app/Http/Controllers/<Module>/)
       │
       ├── Eloquent Models (app/Models/<Module>/)
       ├── Exports/Imports (app/Exports/, app/Imports/)
       ├── Livewire components (resources/views/livewire/ if present)
       └── Blade views (resources/views/<module>/)

app/
├── Actions/
│   ├── Fortify/          # Jetstream/Fortify authentication actions
│   └── Jetstream/        # Profile photo, team actions
├── Console/
│   ├── Kernel.php
│   └── Commands/
│       └── Reservas/     # Scheduled commands for reservation auto-cancellation
├── Enums/
│   ├── AcuerdoEstadoEnum.php
│   └── NotificacionEstadoEnum.php
├── Exports/
│   ├── Asociado/
│   ├── Demografia/
│   ├── ReporteSiniestrosExport.php
│   └── TransaccionesExport.php
├── Http/
│   ├── Controllers/      # One subdirectory per module (see table above)
│   ├── Middleware/
│   │   └── CanDirect.php # Custom direct-permission guard
│   └── Requests/
├── Imports/
│   ├── Asociado/
│   ├── Cartera/
│   ├── Contabilidad/
│   ├── Demografia/
│   ├── ExcelExport.php
│   ├── ExcelImport.php
│   └── PolizasImport.php
├── Mail/
│   ├── FlujoNotificacion.php
│   ├── ReservaInmueble.php
│   └── SoporteEscaladoMail.php
├── Models/               # Mirroring controller namespaces:
│   ├── Archivo/          # GdoArea, GdoCargo, GdoEmpleado, GdoFuncion, GdoTipoDocumento…
│   ├── Asociado/         # MaeAsociado
│   ├── Cartera/          # CarComprobantePago, Acuerdo
│   ├── Cinco/            # MoviContCinco, Retiros, Terceros, CuentasContables…
│   ├── Contabilidad/     # ConCuentaBancaria, ConExtractoTransaccion
│   ├── Correspondencia/  # Correspondencia, FlujoDeTrabajo, Proceso, Plantilla, Trd, ComunicacionSalida…
│   ├── Creditos/         # Credito, LineaCredito, Garantia, Etapa, Escritura…
│   ├── Demografia/
│   ├── Exequiales/
│   ├── Flujo/            # Workflow, Task, TaskHistory, TaskComment
│   ├── Indicators/
│   ├── Interacciones/    # Interaction, IntChannel, IntType, IntOutcome, IntNextAction…
│   ├── Inventario/       # InvActivo, InvCompra, InvMovimiento, InvMantenimiento…
│   ├── Maestras/         # MaeTerceros, MaeTipos, MaeCongregacion, MaeMunicipios
│   ├── Recaudo/
│   ├── Reserva/          # Res_reserva, Res_inmueble, Res_status, Res_condicion…
│   ├── Seguros/          # SegPoliza, SegPlan, SegBeneficiario, SegCobertura, SegConvenio, SegReclamaciones…
│   ├── Soportes/         # ScpSoporte, ScpCategoria, ScpEstado, ScpPrioridad, ScpTipo…
│   ├── Tesoreria/        # Pago
│   ├── Vistas/           # VisitaCorpen
│   ├── User.php          # Uses HasRoles, HasApiTokens, Notifiable
│   ├── Role.php
│   ├── Permisos.php
│   ├── Action.php
│   └── auditoria.php
├── Policies/
│   └── UserPolicy.php
├── Providers/
│   ├── AppServiceProvider.php
│   ├── AuthServiceProvider.php
│   ├── FortifyServiceProvider.php
│   └── JetstreamServiceProvider.php
└── Services/
    └── GoogleDriveService.php

// app/Models/User.php
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasApiTokens;
    use Notifiable;
    use HasRoles;
    // ...
}

// database/seeders/RoleSeeder.php
Role::create(['name' => 'admin']);
Role::create(['name' => 'exequial']);
Role::create(['name' => 'creditos']);
Role::create(['name' => 'seguros']);
Role::create(['name' => 'read']);

Route::get('/offline', function () {
    return view('vendor.laravelpwa.offline');
});