timebank-cc-public/references/ARTISAN-EMAIL-COMMAND-SUMMARY.md

Artisan Email Testing Command - Summary

New Artisan Command Created

php artisan email:send-test - A comprehensive command for testing all transactional emails in the system.

Features

13 Email Types Supported

1. Inactive Profile Warnings

   • inactive-warning-1 - First warning (2 weeks remaining)
   • inactive-warning-2 - Second warning (1 week remaining)
   • inactive-warning-final - Final warning (24 hours remaining)

2. Account Management

   • user-deleted - User account deleted notification
   • verify-email - Email verification request
   • profile-link-changed - Profile name/link changed
   • profile-edited-by-admin - Admin edited profile notification

3. Transactions

   • transfer-received - Payment/transfer received notification

4. Reservations

   • reservation-created - New reservation created
   • reservation-cancelled - Reservation cancelled
   • reservation-updated - Reservation updated

5. Social

   • reaction-created - New comment/reaction on post
   • tag-added - Tag added to profile

Multiple Receiver Types

• user - Individual user profiles
• organization - Organization profiles
• admin - Admin profiles
• bank - Bank profiles

Command Modes

1. Direct Command

php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102

2. Interactive Mode

php artisan email:send-test
# Presents menu to select email type, receiver type, and ID

3. List Mode

php artisan email:send-test --list
# Shows all available email types with descriptions

4. Queue Mode

php artisan email:send-test --type=transfer-received --receiver=user --id=102 --queue
# Sends via queue instead of immediately

Quick Start Examples

Send a Single Email

php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102

Test All Warning Emails

./test-warning-emails.sh 102

Or manually:

php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102
php artisan email:send-test --type=inactive-warning-2 --receiver=user --id=102
php artisan email:send-test --type=inactive-warning-final --receiver=user --id=102

List All Available Emails

php artisan email:send-test --list

Interactive Mode

php artisan email:send-test
# Follow the prompts

Test Data Generation

The command automatically generates realistic test data for each email type:

• Account balances: Uses actual account data from the receiver's profile
• Time remaining: Realistic values based on email type
• Transaction amounts: Sample formatted amounts
• Dates: Future dates for reservations
• Names/URLs: Generated test data with proper formatting

Files Created

1. app/Console/Commands/SendTestEmail.php - Main artisan command
2. EMAIL-TESTING-GUIDE.md - Comprehensive usage guide
3. test-warning-emails.sh - Quick script to test all 3 warning emails
4. ARTISAN-EMAIL-COMMAND-SUMMARY.md - This summary

Advantages Over Tinker Script

1. Type Safety: Validates email types and receiver types before sending
2. Error Handling: Clear error messages for invalid inputs
3. User-Friendly: Interactive mode for easy selection
4. Comprehensive: Supports 13 different email types
5. Flexible: Multiple receiver types (user, organization, admin, bank)
6. Queue Support: Option to send via queue
7. List View: Easy discovery of all available email types
8. Professional CLI: Proper command structure and help text

Migration from Tinker Script

Old Way (Tinker)

php artisan tinker --execute="include 'send-test-warnings.php'; sendTestWarnings(102);"

New Way (Artisan Command)

# Single email
php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102

# All warnings
./test-warning-emails.sh 102

# Or interactive
php artisan email:send-test

Next Steps

1. Test all email types - Verify each email renders correctly
2. Test different receivers - Try with user, organization profiles
3. Test themes - Send emails with different TIMEBANK_THEME values
4. Test languages - Verify emails in all supported languages (en, nl, de, es, fr)
5. Review email content - Approve English text for translation
6. Create translation keys - Add approved text to language files

Usage Tips

1. Find User IDs:

   php artisan tinker --execute="echo App\Models\User::where('email', 'user@example.com')->first()->id;"
   

2. Test Theme Colors:

   TIMEBANK_THEME=uuro php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102
   

3. Test Language:

   # Change user's language first
   php artisan tinker --execute="\$u = App\Models\User::find(102); \$u->lang_preference = 'nl'; \$u->save();"
   
   # Then send email
   php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102
   

4. Batch Testing:

   # Queue multiple emails
   php artisan email:send-test --type=inactive-warning-1 --receiver=user --id=102 --queue
   php artisan email:send-test --type=inactive-warning-2 --receiver=user --id=102 --queue
   php artisan email:send-test --type=inactive-warning-final --receiver=user --id=102 --queue
   
   # Process queue
   php artisan queue:work --stop-when-empty
   

Documentation

See EMAIL-TESTING-GUIDE.md for comprehensive documentation including:

• All available email types
• Command options
• Usage examples
• Troubleshooting guide
• Theme and language testing
• Batch testing scripts