​

Admin-Organizer Linking Commands

​

🎯 Propósito

​

🛠️ Comandos Disponibles

​

Comando Artisan: admin:link-organizer

​

Sintaxis

php artisan admin:link-organizer {action} [options]

​

Acciones Disponibles

1. Link - Vincular admin con organizador

# Vincular con nombre por defecto
php artisan admin:link-organizer link

# Vincular con nombre personalizado
php artisan admin:link-organizer link --name="Mi Organizador Personalizado"

• Busca el usuario admin existente (a-oceanman@mail.com)
• Crea un organizador nuevo o reutiliza uno existente
• Asigna la primera tarifa disponible del sistema
• Vincula el admin con el organizador
• Muestra información detallada del proceso

2. Status - Verificar estado actual

php artisan admin:link-organizer status

• Verifica si el admin está vinculado a un organizador
• Muestra información del organizador asociado
• Proporciona detalles del estado de vinculación

3. Unlink - Desvincular admin del organizador

php artisan admin:link-organizer unlink

• Desvincula el admin del organizador actual
• Mantiene el organizador en el sistema
• Limpia la referencia en el usuario admin

​

🌱 Seeder: AdminOrganizerLinkSeed

​

Uso

# Ejecutar el seeder específico
php artisan db:seed --class=AdminOrganizerLinkSeed

# O incluirlo en DatabaseSeeder.php para ejecución automática

​

Funcionalidad

• Verifica el estado actual de vinculación
• Ejecuta la vinculación si no está ya vinculado
• Muestra mensajes informativos del proceso
• Previene duplicaciones

​

🔧 Servicio: AdminOrganizerLinkService

​

Métodos Principales

​

linkAdminWithOrganizer($organizerName = null)

$service = new AdminOrganizerLinkService();
$result = $service->linkAdminWithOrganizer('Mi Organizador');

if ($result['success']) {
    echo "Vinculado exitosamente: " . $result['message'];
    echo "Organizador ID: " . $result['organizer_id'];
}

​

getAdminOrganizerStatus()

$service = new AdminOrganizerLinkService();
$status = $service->getAdminOrganizerStatus();

if ($status['is_linked']) {
    echo "Admin vinculado a organizador ID: " . $status['organizer_id'];
} else {
    echo "Admin no está vinculado a ningún organizador";
}

​

unlinkAdminFromOrganizer()

$service = new AdminOrganizerLinkService();
$result = $service->unlinkAdminFromOrganizer();

if ($result['success']) {
    echo "Desvinculado exitosamente";
}

​

📋 Requisitos Previos

​

1. Usuario Admin Existente

• El usuario admin debe existir (creado por UsersSeed)
• Email: a-oceanman@mail.com
• Password: oceanman

​

2. Tarifas Disponibles

• Debe existir al menos una tarifa en el sistema
• Las tarifas se crean automáticamente con TarifasSeed

​

3. Base de Datos

• Tabla users con campo organizador_id
• Tabla organizadores con todos los campos requeridos
• Tabla tarifas con al menos un registro

​

🔍 Verificación de Estado

​

Antes de Vincular

php artisan admin:link-organizer status

​

Después de Vincular

php artisan admin:link-organizer status

​

Verificar en Base de Datos

-- Verificar usuario admin
SELECT id, name, email, organizador_id FROM users WHERE email = 'a-oceanman@mail.com';

-- Verificar organizador vinculado
SELECT o.*, t.name as tarifa_name 
FROM organizadores o 
LEFT JOIN tarifas t ON o.tarifas_id = t.id 
WHERE o.id = (SELECT organizador_id FROM users WHERE email = 'a-oceanman@mail.com');

​

🚨 Solución de Problemas

​

Error: “Admin user not found”

• Verificar que UsersSeed se haya ejecutado
• Confirmar que existe el usuario con email a-oceanman@mail.com

​

Error: “No tarifas available in the system”

• Ejecutar TarifasSeed para crear tarifas
• Verificar que existan tarifas activas en la tabla tarifas

​

Error: “Field ‘tarifas_id’ doesn’t have a default value”

• Verificar que el modelo Organizador tenga tarifas_id en $fillable
• Confirmar que la migración de tarifas_id se haya ejecutado

​

Error: “Admin user is already linked”

• El admin ya está vinculado a un organizador
• Usar status para verificar el estado actual
• Usar unlink si se desea cambiar la vinculación

​

📝 Logs y Auditoría

// Ubicación de logs
storage/logs/laravel.log

// Buscar por:
grep "Admin user linked" storage/logs/laravel.log
grep "Admin user unlinked" storage/logs/laravel.log

​

🔄 Flujo de Trabajo Recomendado

​

Instalación Inicial

1. Ejecutar migraciones: php artisan migrate
2. Ejecutar seeds básicos: php artisan db:seed --class=UsersSeed
3. Ejecutar seeds de tarifas: php artisan db:seed --class=TarifasSeed
4. Vincular admin: php artisan admin:link-organizer link

​

Verificación Post-Instalación

1. Verificar estado: php artisan admin:link-organizer status
2. Probar login con admin en el sistema
3. Confirmar acceso a funcionalidades de organizador

​

Mantenimiento

• Usar status para verificar vinculación
• Usar unlink y link para cambiar organizador si es necesario
• Revisar logs periódicamente para auditoría

​

📞 Soporte

1. Verificar logs en storage/logs/laravel.log
2. Ejecutar php artisan admin:link-organizer status
3. Revisar este documento para solución de problemas
4. Contactar al equipo de desarrollo si persisten los problemas