feat(email): Send to test email

Author: pan93412

config/services.php

@@ -18,6 +18,7 @@
         ->set('app.redis_uri', env('REDIS_URI'))
         ->set('app.openai_api_key', env('OPENAI_API_KEY'))
         ->set('app.server-mail', env('SERVER_EMAIL'))
+        ->set('app.server-email-for-test', env('SERVER_EMAIL_FOR_TEST'))
         ->set('app.mail.bcc-chunk', 10)
         ->set('app.features.hint', true)
         ->set('app.features.editable-profile', true)
@@ -52,6 +53,7 @@
 
     $services->set(EmailService::class)
         ->arg('$serverMail', param('app.server-mail'))
+        ->arg('$serverMailForTest', param('app.server-email-for-test'))
         ->arg('$chunkLimit', param('app.mail.bcc-chunk'))
     ;
 

src/Service/EmailService.php

@@ -12,19 +12,26 @@
 final readonly class EmailService
 {
     private Address $fromAddress;
+    private Address $testAddress;
 
     /**
      * @param int<1, max> $chunkLimit
      */
     public function __construct(
         private MailerInterface $mailer,
         private string $serverMail,
+        private string $serverMailForTest,
         private int $chunkLimit,
     ) {
         $this->fromAddress = new Address(
             address: $this->serverMail,
             name: '資料庫練功房'
         );
+
+        $this->testAddress = new Address(
+            address: $this->serverMailForTest,
+            name: '資料庫練功房 - 測試信箱'
+        );
     }
 
     /**
@@ -58,4 +65,15 @@ public function send(EmailDto $emailDto): void
             $this->mailer->send($email);
         }
     }
+
+    /**
+     * Send an email with the given {@link EmailDto} to the test email address.
+     */
+    public function sendToTest(EmailDto $emailDto): void
+    {
+        $emailDtoCloned = clone $emailDto;
+        $emailDtoCloned->setToAddress($this->testAddress);
+        $email = $emailDtoCloned->toEmail()->from($this->fromAddress);
+        $this->mailer->send($email);
+    }
 }

tests/Service/EmailServiceTest.php

@@ -33,7 +33,7 @@ public function testSendWithoutBcc(): void
             })
         ;
 
-        $emailService = new EmailService($mailer, 'test@example.com', 10);
+        $emailService = new EmailService($mailer, 'test@example.com', '', 10);
         $emailDto = (new EmailDto())
             ->setSubject('Test')
             ->setToAddress('test2@gmail.com')
@@ -60,7 +60,7 @@ public function testSendWithBcc(): void
             })
         ;
 
-        $emailService = new EmailService($mailer, 'test@example.com', 10);
+        $emailService = new EmailService($mailer, 'test@example.com', '', 10);
         $emailDto = (new EmailDto())
             ->setSubject('Test')
             ->setToAddress('test2@gmail.com')
@@ -107,7 +107,7 @@ public function testSendWithChunkedBcc(): void
             })
         ;
 
-        $emailService = new EmailService($mailer, 'test@example.com', 10);
+        $emailService = new EmailService($mailer, 'test@example.com', '', 10);
         $emailDto = (new EmailDto())
             ->setSubject('Test')
             ->setToAddress('test@example.com')
@@ -122,4 +122,30 @@ public function testSendWithChunkedBcc(): void
 
         $emailService->send($emailDto);
     }
+
+    public function testSendToTestEmail(): void
+    {
+        $mailer = $this->createMock(MailerInterface::class);
+        $mailer->expects(self::once())
+            ->method('send')
+            ->willReturnCallback(static function (Email $email): void {
+                self::assertSame('Test', $email->getSubject());
+                self::assertSame('test@example.com', $email->getFrom()[0]->getAddress());
+                self::assertSame('test+target@example.com', $email->getTo()[0]->getAddress());
+                self::assertSame('Test TEXT', $email->getTextBody());
+                self::assertSame('Test HTML', $email->getHtmlBody());
+            })
+        ;
+
+        $emailService = new EmailService($mailer, 'test@example.com', 'test+target@example.com', 10);
+
+        $emailDto = (new EmailDto())
+            ->setSubject('Test')
+            ->setKind(EmailKind::Test)
+            ->setText('Test TEXT')
+            ->setHtml('Test HTML')
+        ;
+
+        $emailService->sendToTest($emailDto);
+    }
 }