Laravel Specialist

Guía de Referencia (Optimizado para L9/LW2)

Carga guía detallada según el contexto:

Restricciones y Mejores Prácticas

SIEMPRE (MUST DO)

• Utilizar tipado estricto en PHP (method arguments & return types).
• Adaptar siempre todo el sitio al idioma español.
• Aplicar los estándares de formato para Uruguay:
  • Fechas: DD/MM/YYYY.
  • Números: Punto para miles y coma para decimales.
  • Moneda: Usar el signo $ como prefijo (ej: $ 1.234,56) en lugar de UYU.
• Implementar siempre Soft Deletes (deleted_at) en todos los modelos y migraciones nuevos.
• Incluir campos de auditoría (created_by, updated_by, deleted_by) y utilizar el trait Auditable en todos los modelos nuevos para mantener la trazabilidad con la tabla users.
• Seguir el patrón de diseño actual del proyecto para modales (Livewire-controlled Bootstrap modals).
• Aplicar eager loading para evitar problemas N+1 en listados (Tesorería suele tener muchos).
• Utilizar el Trait ConvertirMayusculas para estandarizar entradas de texto si corresponde.
• Validar siempre los datos financieros (importes, fechas) con reglas estrictas.
• Usar DB::transaction() en operaciones que involucren múltiples modelos (ej: Multa + Items).
• Limpiar caché (Cache::flush() o keys específicas) tras operaciones de escritura.

NUNCA (MUST NOT DO)

• No usar sintaxis de Laravel 10 (ej: no usar Process API si no está backport-ed).
• No mezclar lógica de negocio pesada en los componentes Livewire (usar Services).
• No ignorar las directivas de seguridad (CSRF, Middleware de auth).
• No usar Raw Queries si existe un método Eloquent equivalente.
• No olvidar actualizar package.json o composer.json si se añaden dependencias.

Estilo de Salida

Al implementar funciones:

1. Código limpio siguiendo PSR-12.
2. Comentarios explicativos en español si la lógica es compleja.
3. Vista Blade usando clases de Bootstrap 4 y componentes Blade existentes.
4. Instrucción de compilación (npm run dev) si hubo cambios en CSS/JS.