README

🛠️ FilamentKit

Kit de inicio para construir paneles profesionales con Filament 4 sobre Laravel 12. Incluye autenticación social, gestión de permisos, monitoreo de correos, exportación a Excel, impersonación, guardián de inactividad y comandos automatizados para preparar cualquier entorno en minutos.

✨ Características destacadas

🧰 Paquetes incluidos

📦 Compatibilidad

🚀 Instalación guiada

Sigue cada paso en orden; los comandos resaltados son obligatorios para que Shield genere navegación y permisos correctamente.

1. Crear el proyecto

   composer create-project --prefer-dist jrivera/filamentkit nombre-del-proyecto
   cd nombre-del-proyecto

2. Configurar variables ```dotenv cp .env.example .env APP_URL=https://tu-dominio.test

    GITHUB_CLIENT_ID=...
    GITHUB_CLIENT_SECRET=...
    GITHUB_REDIRECT_URI="${APP_URL}/admin/oauth/callback/github"
   
    GOOGLE_CLIENT_ID=...
    GOOGLE_CLIENT_SECRET=...
    GOOGLE_REDIRECT_URI="${APP_URL}/admin/oauth/callback/google"
   
    MICROSOFT_CLIENT_ID=...
    MICROSOFT_CLIENT_SECRET=...
    MICROSOFT_REDIRECT_URI="${APP_URL}/admin/oauth/callback/microsoft"
   

   MICROSOFT_TENANT=common

   MAIL_MAILER=smtp MAIL_HOST=... MAIL_USERNAME=... MAIL_PASSWORD=...

3. Preparar dependencias y assets

   composer install           # por si agregas dependencias extra
   bun install && bun run build

4. Inicializar la aplicación (orden recomendado)

   php artisan key:generate
   php artisan storage:link
   php artisan project:init   # migra en limpio, crea roles base y asigna super admin
   php artisan shield:setup   # asistente interactivo para ajustar Shield (recomendado)

5. Actualizar tras cada cambio estructural

   • Nuevos recursos, páginas o migraciones → php artisan project:update
   • Cambios de configuración o helpers → php artisan project:cache y/o php artisan project:recache
   • Necesitas tipados/IDE helpers → php artisan dev:init
   • Permisos puntuales sin recrear todo → php artisan shield:generate --all

6. Checklist post-despliegue

   • Revisar config/filament-inactivity-guard.php según políticas de sesión.
   • Crear tu usuario administrador y otorgarle el rol super_admin.
   • Verificar que el nuevo Panel administrativo (menú Administración) muestre métricas y registros.

🗺️ Módulos del panel

• Dashboard principal: limpio, sin widgets intrusivos, ideal para que agregues tus propios KPIs.
• Panel administrativo: nueva página que agrupa Overlook (estadísticas de usuarios) y la tabla de accesos recientes.
• Roles & Permissions: expuesto vía Filament Shield listo para administrar el RBAC.
• Filament Mails: monitor de envíos, eventos y reenvíos desde el mismo panel.

📡 Integraciones explicadas

• Socialite extendido – GitHub, Google y Microsoft listos; agrega dominios permitidos desde FilamentSocialitePlugin::authorizeUserUsing.
• Filament Mails – Ejecuta php artisan vendor:publish --tag="filament-mails-config" si necesitas personalizar recursos o rutas.
• Excel & Exportaciones – Acción masiva disponible en UserResource; puedes añadirla a cualquier tabla con una sola línea.
• Inactivity Guard – Valor por defecto: 15 min de inactividad + 60 s de alerta antes del logout. Personaliza en config/filament-inactivity-guard.php.

🧾 Automatizaciones y cuándo usarlas

💡 Sugerencia: crea scripts en tu CI/CD que corran project:init y project:cache para mantener los ambientes sincronizados.

🤝 Contribuciones y soporte

• Ajusta o extiende los comandos en app/Console/Commands según las políticas de tu organización.
• Crea widgets propios en App\Filament\Admin\Widgets y añádelos al Panel administrativo.
• ¿Necesitas multi-tenant? Shield y Socialite ya soportan esa arquitectura; sólo habilita el modo correspondiente.

📄 Licencia & Autor

FilamentKit se distribuye bajo la licencia MIT.

Autor: John Rivera González
Correo: johnriveragonzalez7@gmail.com
GitHub: @Johnrivera7

Si este kit te ahorra tiempo, ¡déjame una ⭐️ en GitHub!