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.
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.