bert.hausmans/crewli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: complete email infrastructure with queue, templates, logging, and API

Browse Source 
Adds the full transactional email system:
- Redis queue (QUEUE_CONNECTION=redis), SES config in .env.example
- 3 migrations: organisation_email_settings, organisation_email_templates, email_logs
- EmailTemplateType and EmailLogStatus enums with Dutch defaults
- EmailService as central entry point for all email sending
- SendTransactionalEmail queued job with retries and idempotency
- TransactionalMail mailable with responsive HTML + plain text templates
- Organisation-level branding (colors, logo, footer, reply-to)
- Per-type template overrides with {variable} substitution
- Email log with filtering by status, type, date range, recipient
- Preview and send-test endpoints for template management
- API endpoints: email-settings, email-templates (CRUD), email-logs (read-only)
- Integrated into existing flows: invitations, password reset, email
  verification, registration approval/rejection
- 37 new tests across 4 test files, all existing tests updated

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
bert.hausmans
2026-04-15 20:12:21 +02:00
parent c64875b6ef
commit 65978104d8
42 changed files with 2420 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

162
api/tests/Feature/Email/EmailLogControllerTest.php Normal file
View File

@@ -0,0 +1,162 @@
<?php
declare(strict_types=1);
namespace Tests\Feature\Email;
use App\Enums\EmailLogStatus;
use App\Enums\EmailTemplateType;
use App\Models\EmailLog;
use App\Models\Event;
use App\Models\Organisation;
use App\Models\User;
use Database\Seeders\RoleSeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class EmailLogControllerTest extends TestCase
{
use RefreshDatabase;
private User $orgAdmin;
private User $outsider;
private Organisation $organisation;
private Organisation $otherOrganisation;
protected function setUp(): void
{
parent::setUp();
$this->seed(RoleSeeder::class);
$this->organisation = Organisation::factory()->create();
$this->otherOrganisation = Organisation::factory()->create();
$this->orgAdmin = User::factory()->create();
$this->organisation->users()->attach($this->orgAdmin, ['role' => 'org_admin']);
$this->outsider = User::factory()->create();
$this->otherOrganisation->users()->attach($this->outsider, ['role' => 'org_admin']);
}
public function test_index_returns_paginated_logs(): void
{
EmailLog::factory()->count(3)->create([
'organisation_id' => $this->organisation->id,
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs");
$response->assertOk();
$this->assertCount(3, $response->json('data.data'));
}
public function test_filter_by_status(): void
{
EmailLog::factory()->sent()->create([
'organisation_id' => $this->organisation->id,
]);
EmailLog::factory()->failed()->create([
'organisation_id' => $this->organisation->id,
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs?status=sent");
$response->assertOk();
$this->assertCount(1, $response->json('data.data'));
$this->assertEquals('sent', $response->json('data.data.0.status'));
}
public function test_filter_by_template_type(): void
{
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'template_type' => EmailTemplateType::INVITATION->value,
]);
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'template_type' => EmailTemplateType::PASSWORD_RESET->value,
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs?template_type=invitation");
$response->assertOk();
$this->assertCount(1, $response->json('data.data'));
$this->assertEquals('invitation', $response->json('data.data.0.template_type'));
}
public function test_filter_by_date_range(): void
{
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'created_at' => '2026-04-10 12:00:00',
]);
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'created_at' => '2026-04-15 12:00:00',
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs?from=2026-04-14&to=2026-04-16");
$response->assertOk();
$this->assertCount(1, $response->json('data.data'));
}
public function test_search_by_recipient_email(): void
{
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'recipient_email' => 'needle@example.com',
]);
EmailLog::factory()->create([
'organisation_id' => $this->organisation->id,
'recipient_email' => 'other@example.com',
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs?search=needle");
$response->assertOk();
$this->assertCount(1, $response->json('data.data'));
$this->assertEquals('needle@example.com', $response->json('data.data.0.recipient_email'));
}
public function test_denied_for_non_org_admin(): void
{
Sanctum::actingAs($this->outsider);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs");
$response->assertForbidden();
}
public function test_cannot_see_other_org_logs(): void
{
EmailLog::factory()->count(2)->create([
'organisation_id' => $this->otherOrganisation->id,
]);
Sanctum::actingAs($this->orgAdmin);
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs");
$response->assertOk();
$this->assertCount(0, $response->json('data.data'));
}
public function test_unauthenticated_returns_401(): void
{
$response = $this->getJson("/api/v1/organisations/{$this->organisation->id}/email-logs");
$response->assertUnauthorized();
}
}