Troubleshooting
Paneles
| Síntoma |
Revisar |
| No carga el panel |
APP_URL, ADMIN_URL, dominio del tenant y bo_domain |
| Redirige al login |
Sesión/Redis, platforms.*-login, estado del usuario |
| No aparece un resource |
Policy, canAccess(), tenant y navegación |
| 2FA falla |
Hora del servidor, AppAuthentication, códigos de recuperación |
Sesiones y caché
| Síntoma |
Revisar |
| Sesión se pierde |
Redis, SESSION_CONNECTION, SESSION_DRIVER |
| Datos viejos |
TTL y tags de caché; invalidar por tag |
| No usar |
cache:clear o Cache::flush() (borra sesiones) |
Reportes
| Síntoma |
Revisar |
| Reporte vacío |
Rango de fechas y particiones de Athena |
| Error de Athena |
IAM, ATHENA_OUTPUT_LOCATION, base y tabla |
| Lento |
Filtro de particiones y volumen consultado |
| Total en otra moneda |
session('currency') y moneda del usuario |
Assets
| Síntoma |
Revisar |
| Imágenes rotas |
S3, CLOUDFRONT_DOMAIN, AWS_BUCKET |
| Logo/favicon incorrecto |
logos de la plataforma y tipo de logo |
Alertas
| Síntoma |
Revisar |
| No llega ninguna |
ALERTS_ENABLED, alerts.enabled, token y chat IDs |
| Canal equivocado |
TELEGRAM_ALERT_USERS_CHAT_ID |
| No llegan transacciones |
Umbral de la moneda y alerts.send |
| No llega el bloqueo |
failed_logins y worker sqs-alerts |
| Job reintenta |
Logs de Telegram, SQS y credenciales AWS |
Login y bloqueo
| Síntoma |
Revisar |
| Cuenta bloqueada |
status=false, LoginAttemptTracker, ventana de 15 min |
| Demasiados intentos |
Rate limit de 3/min por IP y panel |
| Contador no avanza |
Store de caché (Redis) |
Permisos
| Síntoma |
Revisar |
| Acción no permitida |
Policy, permiso y equipo de plataforma |
| Funciona en Backoffice y no en Admin |
team_foreign_key y PlatformContext |
Logs
php artisan pail
tail -f storage/logs/laravel.log
No registrar tokens, contraseñas ni payloads sensibles.