​

Admin-Organizer Linking Commands

​

🎯 Purpose

​

🛠️ Available Commands

​

Artisan Command: admin:link-organizer

​

Syntax

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

​

Available Actions

1. Link - Link admin with organizer

# Link with the default name
php artisan admin:link-organizer link

# Link with a custom name
php artisan admin:link-organizer link --name="Mi Organizador Personalizado"

• Looks up the existing admin user (a-oceanman@mail.com)
• Creates a new organizer or reuses an existing one
• Assigns the first available tariff in the system
• Links the admin with the organizer
• Shows detailed information about the process

2. Status - Check current status

php artisan admin:link-organizer status

• Checks whether the admin is linked to an organizer
• Shows information about the associated organizer
• Provides details of the link status

3. Unlink - Unlink admin from the organizer

php artisan admin:link-organizer unlink

• Unlinks the admin from the current organizer
• Keeps the organizer in the system
• Clears the reference on the admin user

​

🌱 Seeder: AdminOrganizerLinkSeed

​

Usage

# Run the specific seeder
php artisan db:seed --class=AdminOrganizerLinkSeed

# Or include it in DatabaseSeeder.php for automatic execution

​

Functionality

• Checks the current link status
• Performs the link if not already linked
• Shows informational messages about the process
• Prevents duplicates

​

🔧 Service: AdminOrganizerLinkService

​

Main Methods

​

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";
}

​

📋 Prerequisites

​

1. Existing Admin User

• The admin user must exist (created by UsersSeed)
• Email: a-oceanman@mail.com
• Password: oceanman

​

2. Available Tariffs

• At least one tariff must exist in the system
• Tariffs are created automatically with TarifasSeed

​

3. Database

• users table with the organizador_id field
• organizadores table with all required fields
• tarifas table with at least one record

​

🔍 Status Verification

​

Before Linking

php artisan admin:link-organizer status

​

After Linking

php artisan admin:link-organizer status

​

Verify in the Database

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

-- Verify linked organizer
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');

​

🚨 Troubleshooting

​

Error: “Admin user not found”

• Verify that UsersSeed has been run
• Confirm that a user exists with the email a-oceanman@mail.com

​

Error: “No tarifas available in the system”

• Run TarifasSeed to create tariffs
• Verify that active tariffs exist in the tarifas table

​

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

• Verify that the Organizador model has tarifas_id in $fillable
• Confirm that the tarifas_id migration has been run

​

Error: “Admin user is already linked”

• The admin is already linked to an organizer
• Use status to check the current status
• Use unlink if you want to change the link

​

📝 Logs and Auditing

// Log location
storage/logs/laravel.log

// Search by:
grep "Admin user linked" storage/logs/laravel.log
grep "Admin user unlinked" storage/logs/laravel.log

​

🔄 Recommended Workflow

​

Initial Installation

1. Run migrations: php artisan migrate
2. Run basic seeds: php artisan db:seed --class=UsersSeed
3. Run tariff seeds: php artisan db:seed --class=TarifasSeed
4. Link admin: php artisan admin:link-organizer link

​

Post-Installation Verification

1. Check status: php artisan admin:link-organizer status
2. Test login with admin in the system
3. Confirm access to organizer functionality

​

Maintenance

• Use status to verify the link
• Use unlink and link to change the organizer if needed
• Review logs periodically for auditing

​

📞 Support

1. Check logs at storage/logs/laravel.log
2. Run php artisan admin:link-organizer status
3. Review this document for troubleshooting
4. Contact the development team if issues persist