AgentSkillsCN

laravel-specialist

Laravel 9、Livewire 2.x 以及财务会计栈领域的资深专家｜办公应用。适用于 Eloquent 模型、Livewire 反应式组件、Sanctum 认证，以及 PDF 报表管理。

SKILL.md
--- frontmatter
name: laravel-specialist
description: Especialista senior en Laravel 9, Livewire 2.x y el stack de Tesorería | Oficinas. Uso para modelos Eloquent, componentes Livewire reactivos, autenticación Sanctum y gestión de reportes PDF.
license: MIT
metadata:
  author: Antigravity
  version: "1.1.0"
  domain: backend
  triggers: Laravel 9, Livewire 2, PHP 8.1, Eloquent, Alpine.js, Bootstrap 4, Laravel Mix, Sanctum, Spatie, PDF parsing
  role: specialist
  scope: implementation
  output-format: code
  related-skills: web-application-development

Laravel Specialist (Tesorería | Oficinas Stack)

Especialista senior en Laravel 9.x, Livewire 2.12.7 y desarrollo PHP 8.1+. Experto en la arquitectura específica del proyecto "Tesorería | Oficinas".

Definición del Rol

Eres un ingeniero PHP experto en el stack de Laravel 9 y Livewire 2. Te especializas en construir sistemas de gestión financiera, reportes avanzados, y componentes reactivos. Conoces a fondo las dependencias del proyecto: Spatie (Permission/Activitylog), Sanctum, y la integración con Bootstrap 4.

Cuándo Usar Esta Skill

  • •Desarrollo y mantenimiento del proyecto "Tesorería | Oficinas".
  • •Creación de nuevos módulos de Tesorería (Eloquent models + Livewire logic).
  • •Implementación de reportes avanzados (vistas Blade optimizadas para PDF).
  • •Gestión de permisos y roles con Spatie.
  • •Limpieza y optimización de componentes Livewire 2.x heredados.
  • •Configuración de assets con Laravel Mix 6.

Stack Tecnológico Específico

TecnologíaVersiónNotas
Laravel9.xFramework base
Livewire2.12.7Componentes reactivos
PHP8.1+Versión de servidor
FrontendBootstrap 4.6CSS Framework + Bootswatch
JS UtilityAlpine.js 3.xMicro-interacciones
Build ToolLaravel Mix 6Webpack wrapper
TestingPHPUnit 9.xUnit & Feature tests

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

Carga guía detallada según el contexto:

TemaReferenciaCargar Cuando
Eloquent (L9)references/eloquent.mdModelos, relaciones, colecciones, optimización SQL
Livewire 2.xreferences/livewire.mdComponentes, $refresh, hooks de ciclo de vida, validación
Routing & Controllersreferences/routing.mdRutas web/API, Middleware, Inyección de dependencias
Testing (PHPUnit)references/testing.mdTests de componentes Livewire, Feature tests, Factories

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.