Volver al Web CV
Arquitectura Full-Stack6 min de lectura

Cómo estructurar un sistema pericial en producción con Laravel 13, Filament 5, PostgreSQL 18 y Docker

Separación de ciclo de vida de evidencias, colas con Redis 8, permisos granulares y operación en contenedores.

Experiencia acreditada · Sistema Grupo Benorte SAC

  • Laravel 13
  • PHP 8.4
  • Filament 5
  • PostgreSQL 18
  • Redis 8
  • Docker

Lecciones de arquitectura al construir un sistema de gestión empresarial para administrar clientes, casos periciales, inspecciones, evidencias georreferenciadas e informes técnicos con Filament 5 y PostgreSQL 18.

1. Trazabilidad del flujo operativo y ciclo de vida de evidencias

Cuando una empresa pericial gestiona expedientes, inspecciones en campo y evidencias multimedia, mezclar lógica de negocio dentro de formularios o controladores vuelve frágil cada cambio. La solución parte de modelar estados claros en PostgreSQL 18 y desacoplar el almacenamiento de archivos con Flysystem (S3) del registro transaccional.

Con Filament 5 + Livewire 4 el equipo operativo obtiene flujos rápidos con tablas filtrables, calendario de inspecciones (FullCalendar) y ubicación con Leaflet sin sacrificar control de permisos por rol (Spatie Permission).

  • Separación en servicios y acciones de dominio para mantener delgados los Resources de Filament.
  • Procesamiento asíncrono de notificaciones y exportaciones Excel (maatwebsite/excel) mediante colas en Redis 8.
  • Respaldos programados en contenedor dedicado dentro de Docker Compose junto a Nginx y PostgreSQL.

2. Reglas explícitas en PHP 8.4/8.5 y pruebas con PHPUnit

Tipar firmas de retorno, encapsular transiciones de estado y validar reglas de acceso mediante políticas evita inconsistencias entre el panel administrativo, las colas en segundo plano y los reportes generados.

CaseEvidenceTransition.phpphp
public function attachVerifiedEvidence(CaseFile $case, array $payload): Evidence
{
    return DB::transaction(function () use ($case, $payload): Evidence {
        $evidence = $case->evidences()->create([
            'disk' => config('filesystems.default'),
            'path' => $payload['path'],
            'captured_at' => $payload['captured_at'],
        ]);

        DispatchNotificationJob::dispatch($case->id, $evidence->id);

        return $evidence;
    });
}

3. Multi-servicio reproducible con Docker Compose

Dividir la ejecución en servicios aislados (`app`, `nginx`, `db`, `redis`, `queue`, `exports`, `scheduler`, `backup`) asegura que la generación pesada de reportes o el envío de alertas nunca bloquee las peticiones interactivas de los inspectores.