feat(mail): introduce MailService for tenant-specific SMTP handling and update related tests

- Created MailTestController to handle email sending requests.
- Added SendTestMailRequest for validating email input.
- Developed MailTestService to manage email sending logic.
- Introduced TestMail Mailable for formatting test emails.
- Defined API route for sending test emails.
- Created EmailIntegrationSeeder to seed email integration settings.
- Updated DatabaseSeeder to include EmailIntegrationSeeder.
- Added MailTestControllerTest to ensure email sending functionality works as expected.

.env.example

@@ -51,10 +51,10 @@ REDIS_HOST=127.0.0.1
 REDIS_PASSWORD=null
 REDIS_PORT=6379
 
-MAIL_MAILER=log
-MAIL_SCHEME=null
-MAIL_HOST=127.0.0.1
-MAIL_PORT=2525
+MAIL_MAILER=smtp
+MAIL_SCHEME=smtp
+MAIL_HOST=smtp.gmail.com
+MAIL_PORT=587
 MAIL_USERNAME=null
 MAIL_PASSWORD=null
 MAIL_FROM_ADDRESS="hello@example.com"

app/Domains/Integration/Services/MailService.php

@@ -0,0 +1,147 @@
+<?php
+
+namespace App\Domains\Integration\Services;
+
+use App\Domains\Tenant\Models\Tenant;
+use Exception;
+use Illuminate\Contracts\Mail\Factory as MailFactory;
+use Illuminate\Contracts\Mail\Mailer;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\MailManager;
+use Illuminate\Support\Facades\Blade;
+use InvalidArgumentException;
+
+class MailService extends BaseIntegrationService
+{
+    private const REQUIRED_SMTP_FIELDS = [
+        'MAIL_HOST',
+        'MAIL_PORT',
+        'MAIL_USERNAME',
+        'MAIL_PASSWORD',
+        'MAIL_FROM_ADDRESS',
+    ];
+
+    protected string $integrationCode = 'email';
+
+    private readonly MailFactory $mailFactory;
+
+    private ?Mailer $mailer = null;
+
+    private ?Tenant $tenant = null;
+
+    public function __construct(?MailFactory $mailFactory = null)
+    {
+        $this->mailFactory = $mailFactory ?? app(MailFactory::class);
+    }
+
+    public function forTenant(string $tenantCode): self
+    {
+        parent::forTenant($tenantCode);
+
+        $this->tenant = Tenant::query()
+            ->where('codigo', $tenantCode)
+            ->firstOrFail();
+        $this->mailer = $this->resolveMailer();
+
+        return $this;
+    }
+
+    public function getHeaders(): array
+    {
+        return [];
+    }
+
+    public function send(string|array $recipient, string $subject, string $content): void
+    {
+        if (! $this->mailer || ! $this->tenant) {
+            throw new Exception('MailService no está configurado. Llamá a forTenant() primero.');
+        }
+
+        $this->tenant->loadMissing(['headerLogo', 'footerLogo']);
+
+        $html = Blade::render(
+            <<<'BLADE'
+                <x-mail.branded-layout :tenant="$tenant" :header-logo-url="$headerLogoUrl" :footer-logo-url="$footerLogoUrl">
+                    {!! $content !!}
+                </x-mail.branded-layout>
+                BLADE,
+            [
+                'tenant' => $this->tenant,
+                'headerLogoUrl' => $this->tenant->headerLogo?->getTemporaryUrl(1440),
+                'footerLogoUrl' => $this->tenant->footerLogo?->getTemporaryUrl(1440),
+                'content' => $content,
+            ],
+        );
+
+        $mail = (new Mailable)
+            ->subject($subject)
+            ->html($html);
+
+        $this->mailer->to($recipient)->send($mail);
+    }
+
+    public function mailerName(): string
+    {
+        return 'tenant-smtp';
+    }
+
+    public function onSetup(): void
+    {
+        if (! $this->tenant) {
+            throw new Exception('MailService no está configurado. Llamá a forTenant() primero.');
+        }
+
+        $recipient = $this->getIntegrationSetting('MAIL_FROM_ADDRESS');
+
+        if (! is_string($recipient) || $recipient === '') {
+            throw new InvalidArgumentException('Falta MAIL_FROM_ADDRESS en la configuración SMTP del tenant.');
+        }
+
+        $this->send(
+            $recipient,
+            'Configuración de correo validada',
+            '<h1 style="margin: 0 0 20px;">Configuración de correo validada</h1>'
+                .'<p>La integración SMTP de '.e($this->tenant->nombre).' fue configurada correctamente.</p>'
+                .'<p style="color: #64748b; font-size: 13px;">Este mensaje fue enviado automáticamente para validar las credenciales de correo.</p>',
+        );
+    }
+
+    private function resolveMailer(): Mailer
+    {
+        $data = $this->tenantIntegration?->integration_data;
+
+        if (! is_array($data)) {
+            throw new InvalidArgumentException('La configuración SMTP del tenant no es válida.');
+        }
+
+        foreach (self::REQUIRED_SMTP_FIELDS as $field) {
+            if (! array_key_exists($field, $data) || $data[$field] === null || $data[$field] === '') {
+                throw new InvalidArgumentException("Falta {$field} en la configuración SMTP del tenant.");
+            }
+        }
+
+        // MailFake implements MailFactory but cannot build transports.
+        if (! $this->mailFactory instanceof MailManager) {
+            return $this->mailFactory->mailer();
+        }
+
+        $mailer = $this->mailFactory->build([
+            'name' => "tenant-smtp-{$this->tenantCode}",
+            'transport' => 'smtp',
+            'scheme' => $data['MAIL_SCHEME'] ?? null,
+            'host' => $data['MAIL_HOST'],
+            'port' => (int) $data['MAIL_PORT'],
+            'username' => $data['MAIL_USERNAME'],
+            'password' => $data['MAIL_PASSWORD'],
+            'timeout' => isset($data['MAIL_TIMEOUT']) ? (int) $data['MAIL_TIMEOUT'] : null,
+            'local_domain' => $data['MAIL_EHLO_DOMAIN'] ?? null,
+        ]);
+
+        $mailer->alwaysFrom(
+            $data['MAIL_FROM_ADDRESS'],
+            $data['MAIL_FROM_NAME'] ?? $this->tenant?->nombre,
+        );
+
+        return $mailer;
+    }
+}

app/Domains/Integration/Services/TenantIntegrationService.php

@@ -47,6 +47,8 @@ class TenantIntegrationService
     protected function resolveService(string $integrationCode): ?BaseIntegrationService
     {
         switch ($integrationCode) {
+            case 'email':
+                return new MailService;
             case 'telepagos':
             case 'telepagos_homo':
                 return new TelepagosIntegrationService($integrationCode);

app/Domains/MailTest/Controllers/MailTestController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Domains\MailTest\Controllers;
+
+use App\Domains\MailTest\Requests\SendTestMailRequest;
+use App\Domains\MailTest\Services\MailTestService;
+use App\Domains\Tenant\Models\Tenant;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+
+class MailTestController extends Controller
+{
+    public function __construct(
+        protected MailTestService $mailTestService,
+    ) {}
+
+    public function __invoke(SendTestMailRequest $request, string $tenantCode): JsonResponse
+    {
+        $tenant = Tenant::query()
+            ->where('codigo', $tenantCode)
+            ->firstOrFail();
+
+        return response()->json(
+            $this->mailTestService->send(
+                $tenant,
+                $request->validated('to'),
+                $request->validated('subject'),
+                $request->validated('message'),
+            )
+        );
+    }
+}

app/Domains/MailTest/Mailables/TestMail.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Domains\MailTest\Mailables;
+
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+class TestMail extends Mailable
+{
+    use Queueable, SerializesModels;
+
+    public function __construct(
+        public readonly string $mailSubject,
+        public readonly string $mailMessage,
+        public readonly Tenant $tenant,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(subject: $this->mailSubject);
+    }
+
+    public function content(): Content
+    {
+        $this->tenant->loadMissing(['headerLogo', 'footerLogo']);
+
+        return new Content(
+            view: 'mail.test',
+            with: [
+                'tenant' => $this->tenant,
+                'headerLogoUrl' => $this->tenant->headerLogo?->getTemporaryUrl(1440),
+                'footerLogoUrl' => $this->tenant->footerLogo?->getTemporaryUrl(1440),
+            ],
+        );
+    }
+}

app/Domains/MailTest/Requests/SendTestMailRequest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Domains\MailTest\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class SendTestMailRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, array<int, string>>
+     */
+    public function rules(): array
+    {
+        return [
+            'to' => ['required', 'string', 'email', 'max:255'],
+            'subject' => ['nullable', 'string', 'max:255'],
+            'message' => ['nullable', 'string', 'max:5000'],
+        ];
+    }
+}

app/Domains/MailTest/Services/MailTestService.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Domains\MailTest\Services;
+
+use App\Domains\Integration\Services\MailService;
+use App\Domains\Tenant\Models\Tenant;
+
+class MailTestService
+{
+    /**
+     * @return array<string, string>
+     */
+    public function send(Tenant $tenant, string $recipient, ?string $subject = null, ?string $message = null): array
+    {
+        $subject ??= 'Prueba de correo de Shopit';
+        $message ??= 'Este es un correo de prueba enviado desde Shopit.';
+
+        $mailService = (new MailService)->forTenant($tenant->codigo);
+        $mailService->send(
+            $recipient,
+            $subject,
+            '<h1 style="margin: 0 0 20px;">'.e($subject).'</h1>'
+                .'<p>'.nl2br(e($message)).'</p>',
+        );
+
+        return [
+            'message' => 'Correo de prueba enviado correctamente.',
+            'recipient' => $recipient,
+            'tenant_code' => $tenant->codigo,
+            'mailer' => $mailService->mailerName(),
+            'sent_at' => now()->toIso8601String(),
+        ];
+    }
+}

app/Domains/MailTest/routes/api.php

@@ -0,0 +1,6 @@
+<?php
+
+use App\Domains\MailTest\Controllers\MailTestController;
+use Illuminate\Support\Facades\Route;
+
+Route::post('{tenant_code}/mail-test/send', MailTestController::class);

database/seeders/DatabaseSeeder.php

@@ -30,6 +30,7 @@ class DatabaseSeeder extends Seeder
             ProductCatalogFromImagesSeeder::class,
             FiestaFutbolInfantilProductSeeder::class,
             TelepagosIntegrationSeeder::class,
+            EmailIntegrationSeeder::class,
             MenuSeeder::class,
         ]);
     }

database/seeders/EmailIntegrationSeeder.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Domains\Integration\Models\Integration;
+use Illuminate\Database\Seeder;
+
+class EmailIntegrationSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        Integration::updateOrCreate(
+            ['integration_code' => 'email'],
+            [
+                'name' => 'Email',
+                'url' => null,
+                'integration_data_schema' => [
+                    'MAIL_MAILER' => 'required|string|in:smtp',
+                    'MAIL_SCHEME' => 'required|string|in:smtp',
+                    'MAIL_HOST' => 'required|string',
+                    'MAIL_PORT' => 'required|integer|in:587',
+                    'MAIL_USERNAME' => 'required|email',
+                    'MAIL_PASSWORD' => 'required|string',
+                    'MAIL_FROM_ADDRESS' => 'required|email',
+                    'MAIL_FROM_NAME' => 'nullable|string|max:255',
+                ],
+            ]
+        );
+    }
+}

resources/views/components/mail/branded-layout.blade.php

@@ -0,0 +1,49 @@
+@props(['tenant', 'headerLogoUrl' => null, 'footerLogoUrl' => null])
+
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="color-scheme" content="light">
+    <title>{{ $tenant->nombre }}</title>
+    <style>
+        @media only screen and (max-width: 620px) {
+            .mail-container { width: 100% !important; }
+            .mail-content { padding: 32px 24px !important; }
+        }
+    </style>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f1f5f9; color: #334155; font-family: Arial, Helvetica, sans-serif;">
+<table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f1f5f9;">
+    <tr>
+        <td align="center" style="padding: 32px 12px;">
+            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" class="mail-container" style="width: 600px; max-width: 600px; background-color: #ffffff; border-top: 4px solid {{ $tenant->primary_color }}; border-radius: 8px; overflow: hidden; box-shadow: 0 2px 8px rgba(15, 23, 42, 0.08);">
+                <tr>
+                    <td align="center" bgcolor="{{ $tenant->header_bg_color }}" style="padding: 24px 32px; background-color: {{ $tenant->header_bg_color }};">
+                        @if ($headerLogoUrl)
+                            <img src="{{ $headerLogoUrl }}" alt="{{ $tenant->nombre }}" width="180" style="display: block; width: auto; max-width: 180px; max-height: 64px; border: 0;">
+                        @else
+                            <span style="color: {{ $tenant->primary_color }}; font-size: 24px; font-weight: 700; line-height: 1.2;">{{ $tenant->nombre }}</span>
+                        @endif
+                    </td>
+                </tr>
+                <tr>
+                    <td class="mail-content" style="padding: 40px 48px; font-size: 16px; line-height: 1.6;">
+                        {{ $slot }}
+                    </td>
+                </tr>
+                <tr>
+                    <td align="center" bgcolor="{{ $tenant->footer_bg_color }}" style="padding: 24px 32px; background-color: {{ $tenant->footer_bg_color }}; color: #ffffff; font-size: 12px; line-height: 1.5;">
+                        @if ($footerLogoUrl)
+                            <img src="{{ $footerLogoUrl }}" alt="{{ $tenant->nombre }}" width="140" style="display: block; width: auto; max-width: 140px; max-height: 48px; margin: 0 auto 16px; border: 0;">
+                        @endif
+                        {{ $footer ?? 'Este correo fue enviado por '.$tenant->nombre.'.' }}
+                    </td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+</body>
+</html>

resources/views/mail/test.blade.php

@@ -0,0 +1,11 @@
+<x-mail.branded-layout :tenant="$tenant" :header-logo-url="$headerLogoUrl" :footer-logo-url="$footerLogoUrl">
+    <h1 style="margin: 0 0 20px; color: {{ $tenant->primary_color }}; font-size: 26px; line-height: 1.3;">
+        Prueba de correo de Shopit
+    </h1>
+
+    <p style="margin: 0 0 16px;">{!! nl2br(e($mailMessage)) !!}</p>
+
+    <p style="margin: 24px 0 0; color: #64748b; font-size: 13px;">
+        Si recibiste este mensaje, la configuración de correo funciona correctamente.
+    </p>
+</x-mail.branded-layout>

routes/api.php

@@ -4,6 +4,7 @@ require __DIR__.'/../app/Domains/Auth/routes/api.php';
 require __DIR__.'/../app/Domains/Catalog/routes/api.php';
 require __DIR__.'/../app/Domains/Cart/routes/api.php';
 require __DIR__.'/../app/Domains/StorageTest/routes/api.php';
+require __DIR__.'/../app/Domains/MailTest/routes/api.php';
 require __DIR__.'/../app/Domains/Purchase/routes/api.php';
 require __DIR__.'/../app/Domains/Tenant/routes/api.php';
 require __DIR__.'/../app/Domains/Integration/routes/api.php';

tests/Feature/Integration/MailServiceTest.php

@@ -0,0 +1,147 @@
+<?php
+
+namespace Tests\Feature\Integration;
+
+use App\Domains\Attachable\Enums\AttachmentType;
+use App\Domains\Attachable\Models\Attachment;
+use App\Domains\Integration\Models\Integration;
+use App\Domains\Integration\Models\TenantIntegration;
+use App\Domains\Integration\Services\MailService;
+use App\Domains\Integration\Services\TenantIntegrationService;
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailer;
+use Illuminate\Mail\MailManager;
+use Illuminate\Support\Facades\Mail;
+use Mockery;
+use Tests\TestCase;
+
+class MailServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_it_builds_an_isolated_smtp_mailer_from_the_tenant_integration(): void
+    {
+        $tenant = $this->createTenant();
+        $this->createEmailIntegration();
+        TenantIntegration::create([
+            'tenant_code' => $tenant->codigo,
+            'integration_code' => 'email',
+            'integration_data' => $this->emailData(),
+        ]);
+
+        $mailer = Mockery::mock(Mailer::class);
+        $mailer->shouldReceive('alwaysFrom')
+            ->once()
+            ->with('store@example.com', 'Acme Mail');
+
+        $manager = Mockery::mock(MailManager::class);
+        $manager->shouldReceive('build')
+            ->once()
+            ->with(Mockery::on(fn (array $config): bool => $config === [
+                'name' => 'tenant-smtp-acme',
+                'transport' => 'smtp',
+                'scheme' => 'smtp',
+                'host' => 'smtp.example.com',
+                'port' => 587,
+                'username' => 'mailer@example.com',
+                'password' => 'secret',
+                'timeout' => null,
+                'local_domain' => null,
+            ]))
+            ->andReturn($mailer);
+
+        $service = (new MailService($manager))->forTenant($tenant->codigo);
+
+        $this->assertSame('tenant-smtp', $service->mailerName());
+    }
+
+    public function test_on_setup_sends_a_branded_test_email_to_the_configured_sender(): void
+    {
+        Mail::fake();
+        $tenant = $this->createTenant();
+        $this->createEmailIntegration();
+        TenantIntegration::create([
+            'tenant_code' => $tenant->codigo,
+            'integration_code' => 'email',
+            'integration_data' => $this->emailData(),
+        ]);
+
+        (new MailService)->forTenant($tenant->codigo)->onSetup();
+
+        Mail::assertSent(Mailable::class, function (Mailable $mail) use ($tenant): bool {
+            $html = $mail->render();
+
+            return $mail->hasTo('store@example.com')
+                && $mail->subject === 'Configuración de correo validada'
+                && str_contains($html, $tenant->nombre)
+                && str_contains($html, 'background-color: #112233')
+                && str_contains($html, 'background-color: #445566');
+        });
+    }
+
+    public function test_configuring_the_email_integration_runs_its_setup_hook(): void
+    {
+        Mail::fake();
+        $tenant = $this->createTenant();
+        $integration = $this->createEmailIntegration();
+
+        app(TenantIntegrationService::class)->updateOrCreateIntegration(
+            $tenant->codigo,
+            $integration,
+            $this->emailData(),
+        );
+
+        Mail::assertSent(Mailable::class, 1);
+    }
+
+    private function createTenant(): Tenant
+    {
+        $logo = Attachment::create([
+            'path' => 'tenants/logo.png',
+            'filename' => 'logo.png',
+            'type' => AttachmentType::Image,
+            'mime_type' => 'image/png',
+            'extension' => 'png',
+        ]);
+
+        return Tenant::create([
+            'codigo' => 'acme',
+            'nombre' => 'Acme Store',
+            'dominio' => 'acme.example.com',
+            'primary_color' => '#778899',
+            'secondary_color' => '#64748b',
+            'danger_color' => '#dc2626',
+            'success_color' => '#16a34a',
+            'header_bg_color' => '#112233',
+            'footer_bg_color' => '#445566',
+            'header_logo_id' => $logo->id,
+            'footer_logo_id' => $logo->id,
+        ]);
+    }
+
+    private function createEmailIntegration(): Integration
+    {
+        return Integration::create([
+            'integration_code' => 'email',
+            'name' => 'Email',
+        ]);
+    }
+
+    /**
+     * @return array<string, string|int>
+     */
+    private function emailData(): array
+    {
+        return [
+            'MAIL_SCHEME' => 'smtp',
+            'MAIL_HOST' => 'smtp.example.com',
+            'MAIL_PORT' => 587,
+            'MAIL_USERNAME' => 'mailer@example.com',
+            'MAIL_PASSWORD' => 'secret',
+            'MAIL_FROM_ADDRESS' => 'store@example.com',
+            'MAIL_FROM_NAME' => 'Acme Mail',
+        ];
+    }
+}

tests/Feature/MailTest/MailTestControllerTest.php

@@ -0,0 +1,189 @@
+<?php
+
+namespace Tests\Feature\MailTest;
+
+use App\Domains\Attachable\Enums\AttachmentType;
+use App\Domains\Attachable\Models\Attachment;
+use App\Domains\Integration\Models\Integration;
+use App\Domains\Integration\Models\TenantIntegration;
+use App\Domains\MailTest\Mailables\TestMail;
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Mail\Mailable;
+use Illuminate\Support\Facades\Mail;
+use Tests\TestCase;
+
+class MailTestControllerTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_it_sends_a_test_email(): void
+    {
+        Mail::fake();
+        $tenant = $this->createTenant();
+
+        $response = $this->postJson('/api/acme/mail-test/send', [
+            'to' => 'recipient@example.com',
+            'subject' => 'SMTP test',
+            'message' => 'Test message',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('message', 'Correo de prueba enviado correctamente.')
+            ->assertJsonPath('recipient', 'recipient@example.com')
+            ->assertJsonPath('tenant_code', 'acme')
+            ->assertJsonPath('mailer', 'tenant-smtp')
+            ->assertJsonStructure(['sent_at']);
+
+        Mail::assertSent(Mailable::class, function (Mailable $mail) use ($tenant): bool {
+            return $mail->hasTo('recipient@example.com')
+                && $mail->subject === 'SMTP test'
+                && str_contains($mail->render(), 'Test message')
+                && str_contains($mail->render(), $tenant->nombre);
+        });
+    }
+
+    public function test_it_uses_default_content_when_optional_fields_are_omitted(): void
+    {
+        Mail::fake();
+        $this->createTenant();
+
+        $this->postJson('/api/acme/mail-test/send', [
+            'to' => 'recipient@example.com',
+        ])->assertOk();
+
+        Mail::assertSent(Mailable::class, function (Mailable $mail): bool {
+            return $mail->subject === 'Prueba de correo de Shopit'
+                && str_contains($mail->render(), 'Este es un correo de prueba enviado desde Shopit.');
+        });
+    }
+
+    public function test_it_validates_the_recipient(): void
+    {
+        Mail::fake();
+        $this->createTenant();
+
+        $this->postJson('/api/acme/mail-test/send', [
+            'to' => 'invalid-email',
+        ])->assertUnprocessable()
+            ->assertJsonValidationErrors(['to']);
+
+        Mail::assertNothingSent();
+    }
+
+    public function test_the_mail_template_uses_the_tenant_branding(): void
+    {
+        $tenant = new Tenant([
+            'codigo' => 'tenant-store',
+            'nombre' => 'Tenant Store',
+            'primary_color' => '#778899',
+            'header_bg_color' => '#112233',
+            'footer_bg_color' => '#445566',
+        ]);
+
+        $tenant->setRelation('headerLogo', new class extends Attachment
+        {
+            public function getTemporaryUrl(int $expiresInMinutes = 10): string
+            {
+                return 'https://example.com/header-logo.png';
+            }
+        });
+        $tenant->setRelation('footerLogo', new class extends Attachment
+        {
+            public function getTemporaryUrl(int $expiresInMinutes = 10): string
+            {
+                return 'https://example.com/footer-logo.png';
+            }
+        });
+
+        $mail = new TestMail(
+            'Branded email',
+            'Tenant message',
+            $tenant,
+        );
+
+        $html = $mail->render();
+
+        $this->assertStringContainsString('https://example.com/header-logo.png', $html);
+        $this->assertStringContainsString('https://example.com/footer-logo.png', $html);
+        $this->assertStringContainsString('background-color: #112233', $html);
+        $this->assertStringContainsString('background-color: #445566', $html);
+        $this->assertStringContainsString('color: #778899', $html);
+        $this->assertStringContainsString('Tenant Store', $html);
+        $this->assertStringContainsString('Tenant message', $html);
+    }
+
+    public function test_it_returns_not_found_for_an_unknown_tenant(): void
+    {
+        Mail::fake();
+
+        $this->postJson('/api/unknown/mail-test/send', [
+            'to' => 'recipient@example.com',
+        ])->assertNotFound();
+
+        Mail::assertNothingSent();
+    }
+
+    public function test_it_does_not_resolve_the_tenant_by_id(): void
+    {
+        Mail::fake();
+        $tenant = $this->createTenant();
+
+        $this->postJson("/api/{$tenant->id}/mail-test/send", [
+            'to' => 'recipient@example.com',
+        ])->assertNotFound();
+
+        Mail::assertNothingSent();
+    }
+
+    private function createTenant(): Tenant
+    {
+        $headerLogo = Attachment::create([
+            'path' => 'tenants/header.png',
+            'filename' => 'header.png',
+            'type' => AttachmentType::Image,
+            'mime_type' => 'image/png',
+            'extension' => 'png',
+        ]);
+        $footerLogo = Attachment::create([
+            'path' => 'tenants/footer.png',
+            'filename' => 'footer.png',
+            'type' => AttachmentType::Image,
+            'mime_type' => 'image/png',
+            'extension' => 'png',
+        ]);
+
+        $tenant = Tenant::create([
+            'codigo' => 'acme',
+            'nombre' => 'Acme Store',
+            'dominio' => 'acme.example.com',
+            'primary_color' => '#778899',
+            'secondary_color' => '#64748b',
+            'danger_color' => '#dc2626',
+            'success_color' => '#16a34a',
+            'header_bg_color' => '#112233',
+            'footer_bg_color' => '#445566',
+            'header_logo_id' => $headerLogo->id,
+            'footer_logo_id' => $footerLogo->id,
+        ]);
+
+        Integration::create([
+            'integration_code' => 'email',
+            'name' => 'Email',
+        ]);
+        TenantIntegration::create([
+            'tenant_code' => $tenant->codigo,
+            'integration_code' => 'email',
+            'integration_data' => [
+                'MAIL_SCHEME' => 'smtp',
+                'MAIL_HOST' => 'smtp.example.com',
+                'MAIL_PORT' => 587,
+                'MAIL_USERNAME' => 'mailer@example.com',
+                'MAIL_PASSWORD' => 'secret',
+                'MAIL_FROM_ADDRESS' => 'store@example.com',
+            ],
+        ]);
+
+        return $tenant;
+    }
+}