Files
Gnuboard7/plugins/_bundled/sirsoft-message_bizppurio/tests/Unit/Services/SmsChannelDriverTest.php
T
chym1217 4e77d25926 feat(message_bizppurio): 검수 모드 라벨 통일 + 발송 payload 저장 + 알림톡 URL 프로토콜 중복 방지
발송 이력 화면의 "테스트 모드" 표기를 "검수 모드"로 통일하고, 검수 모드 발송 건은
상태 라벨 대신 "검수" 라벨로 표시한다. 설정 미완료 상태에서도 검수 모드 안내가
함께 표시되도록 배너 노출 조건을 수정한다.

발송 요청 payload가 어디에도 저장되지 않아 실패 원인을 사후 재구성할 수 없던 문제를
해결한다. bizppurio_dispatches.request_payload 컬럼을 신설해 발송 시점(성공/실패
무관)에 실제 비즈뿌리오 전송 payload를 저장하되, 다른 컬럼과 중복되는 개인식별
정보(수신번호·치환된 본문 텍스트)는 제외하고 저장한다.

카카오 알림톡 버튼 URL과 완전한 URL 변수(action_url 등, 항상 프로토콜 포함)가
결합될 때 프로토콜이 중복(https://https://...)되어 잘못된 링크로 발송되던 문제를
방지한다.

플러그인 제거 후 재설치 시 sms·alimtalk 채널 템플릿이 재생성되지 않던 문제를
해결한다. 리스너 등록 이력 캐시가 재활성화 후에도 남아있어 재등록이 조용히
스킵되던 것으로, 코어 수정 없이 플러그인 내부에서 리플렉션으로 우회한다.
2026-07-28 12:40:15 +09:00

306 lines
13 KiB
PHP

<?php
namespace Plugins\Sirsoft\MessageBizppurio\Tests\Unit\Services;
use App\Models\NotificationTemplate;
use App\Models\User;
use App\Notifications\GenericNotification;
use App\Notifications\GuestNotifiable;
use App\Services\NotificationTemplateService;
use App\Services\PluginSettingsService;
use Illuminate\Notifications\Notification;
use Illuminate\Support\Facades\Bus;
use Mockery;
use Plugins\Sirsoft\MessageBizppurio\Jobs\SendMessageJob;
use Plugins\Sirsoft\MessageBizppurio\Models\BizppurioDispatch;
use Plugins\Sirsoft\MessageBizppurio\Repositories\BizppurioDispatchRepository;
use Plugins\Sirsoft\MessageBizppurio\Services\DispatchLinkContext;
use Plugins\Sirsoft\MessageBizppurio\Services\MessagePayloadBuilder;
use Plugins\Sirsoft\MessageBizppurio\Services\SmsChannelDriver;
use Plugins\Sirsoft\MessageBizppurio\Services\SmsTypeResolver;
use Plugins\Sirsoft\MessageBizppurio\Tests\PluginTestCase;
/**
* SmsChannelDriver — 전화번호 해석·템플릿 게이트·SMS/LMS 판별·Job 위임 검증.
*
* 발송 Job dispatch 를 Bus::fake 로 관찰한다(실제 발송은 SendMessageJobTest 가 커버).
*/
class SmsChannelDriverTest extends PluginTestCase
{
/**
* 렌더 결과를 반환하는 NotificationTemplate mock 을 만듭니다.
*
* Eloquent 이벤트 재인스턴스화(new static)와 충돌하지 않도록 서브클래스 대신
* Mockery mock 을 사용한다(is_active + replaceVariables 만 stub).
*
* @param array<string, string> $rendered replaceVariables 반환값
*/
private function fakeTemplate(array $rendered = ['subject' => '', 'body' => '주문이 완료되었습니다.']): NotificationTemplate
{
$template = Mockery::mock(NotificationTemplate::class)->makePartial();
$template->is_active = true;
$template->shouldReceive('replaceVariables')->andReturn($rendered);
return $template;
}
/**
* 템플릿 resolve 결과를 지정한 driver 를 만듭니다.
*
* @param NotificationTemplate|null $template resolve 반환값
* @param bool $isTestMode 검수 모드 설정값 (이력 스냅샷 검증용)
*/
private function makeDriver(
?NotificationTemplate $template,
?MessagePayloadBuilder $builder = null,
bool $isTestMode = true,
): SmsChannelDriver {
$templateService = Mockery::mock(NotificationTemplateService::class);
$templateService->shouldReceive('resolve')
->with(Mockery::any(), 'sms')
->andReturn($template);
$pluginSettings = Mockery::mock(PluginSettingsService::class);
$pluginSettings->shouldReceive('get')
->with('sirsoft-message_bizppurio', 'is_test_mode', true)
->andReturn($isTestMode);
return new SmsChannelDriver(
$templateService,
new SmsTypeResolver,
$builder ?? $this->spyBuilder(),
new BizppurioDispatchRepository,
new DispatchLinkContext,
$pluginSettings,
);
}
/**
* build* 호출 인자를 기록하는 payload 빌더 스파이를 만듭니다.
*/
private function spyBuilder(): MessagePayloadBuilder
{
return new class extends MessagePayloadBuilder
{
public array $calls = [];
public function __construct() {}
public function buildSms(string $to, string $message, string $refkey): array
{
$this->calls[] = ['type' => 'sms', 'to' => $to, 'message' => $message, 'refkey' => $refkey];
return ['type' => 'sms', 'to' => $to, 'refkey' => $refkey];
}
public function buildLms(string $to, string $message, string $refkey, ?string $subject = null): array
{
$this->calls[] = ['type' => 'lms', 'to' => $to, 'message' => $message, 'refkey' => $refkey, 'subject' => $subject];
return ['type' => 'lms', 'to' => $to, 'refkey' => $refkey];
}
};
}
private function notification(array $data = []): GenericNotification
{
return new GenericNotification('order_confirmed', 'sirsoft-ecommerce', $data, 'module', 'sirsoft-ecommerce');
}
public function test_템플릿이_없으면_발송하지_않는다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$this->makeDriver(null)->send($member, $this->notification());
Bus::assertNotDispatched(SendMessageJob::class);
}
public function test_회원은_mobile로_발송한다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$builder = $this->spyBuilder();
$this->makeDriver($this->fakeTemplate(), $builder)->send($member, $this->notification());
Bus::assertDispatched(SendMessageJob::class);
$this->assertCount(1, $builder->calls);
$this->assertSame('01012345678', $builder->calls[0]['to'], '하이픈 제거된 회원 mobile 로 발송해야 한다.');
}
public function test_비회원은_data의_전화번호로_발송한다(): void
{
Bus::fake();
$guest = new GuestNotifiable('guest@example.com', '홍길동', 'ko');
$data = [SmsChannelDriver::RECIPIENT_PHONE_KEY => '010-9999-0000'];
$builder = $this->spyBuilder();
$this->makeDriver($this->fakeTemplate(), $builder)->send($guest, $this->notification($data));
Bus::assertDispatched(SendMessageJob::class);
$this->assertSame('01099990000', $builder->calls[0]['to']);
}
public function test_회원_발송_시_pending_이력을_생성하고_회원id를_기록한다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678', 'name' => '김철수']);
$this->makeDriver($this->fakeTemplate())->send($member, $this->notification());
$this->assertDatabaseCount('bizppurio_dispatches', 1);
$dispatch = BizppurioDispatch::first();
$this->assertSame('pending', $dispatch->status->value);
$this->assertSame('01012345678', $dispatch->to_number);
$this->assertSame($member->id, $dispatch->to_user_id, '회원 발송은 to_user_id 를 채워야 한다.');
$this->assertSame('order_confirmed', $dispatch->notification_type);
}
public function test_비회원_발송_이력은_회원id가_null이다(): void
{
Bus::fake();
$guest = new GuestNotifiable('guest@example.com', '홍길동', 'ko');
$data = [SmsChannelDriver::RECIPIENT_PHONE_KEY => '010-9999-0000'];
$this->makeDriver($this->fakeTemplate())->send($guest, $this->notification($data));
$dispatch = BizppurioDispatch::first();
$this->assertNotNull($dispatch);
$this->assertNull($dispatch->to_user_id, '비회원 발송은 to_user_id 가 null 이어야 한다.');
}
public function test_발송_시_실제_전송_payload가_이력에_저장된다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$builder = $this->spyBuilder();
$this->makeDriver($this->fakeTemplate(), $builder)->send($member, $this->notification());
$dispatch = BizppurioDispatch::first();
$this->assertNotNull($dispatch->request_payload, '결함① — 실제 비즈뿌리오 전송 payload 가 이력에 저장돼야 한다.');
$this->assertArrayNotHasKey('to', $dispatch->request_payload, 'to 는 to_number 컬럼과 중복이라 제외돼야 한다.');
}
public function test_이력_저장_payload에서_개인식별_정보는_제외된다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
// 실제 MessagePayloadBuilder(스파이 아님)로 진짜 조립 로직을 태워야 forHistory() 제외
// 규칙(to/refkey/type/message 제거)을 검증할 수 있다.
$pluginSettings = Mockery::mock(PluginSettingsService::class);
$pluginSettings->shouldReceive('get')->andReturn('');
$realBuilder = new MessagePayloadBuilder($pluginSettings);
$this->makeDriver($this->fakeTemplate(), $realBuilder)->send($member, $this->notification());
$dispatch = BizppurioDispatch::first();
$payload = $dispatch->request_payload;
$this->assertArrayNotHasKey('to', $payload, 'to 는 to_number 컬럼과 중복이라 제외돼야 한다.');
$this->assertArrayNotHasKey('refkey', $payload, 'refkey 는 refkey 컬럼과 중복이라 제외돼야 한다.');
$this->assertArrayNotHasKey('type', $payload, 'type 은 channel 컬럼과 중복이라 제외돼야 한다.');
$this->assertArrayNotHasKey('message', $payload['content']['sms'] ?? [], 'message 는 content 컬럼과 중복이라 제외돼야 한다.');
}
public function test_발송하지_않으면_이력도_생성하지_않는다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
// 템플릿 없음 → skip → 이력도 없어야 함
$this->makeDriver(null)->send($member, $this->notification());
$this->assertDatabaseCount('bizppurio_dispatches', 0);
}
public function test_전화번호가_없으면_발송하지_않는다(): void
{
Bus::fake();
$guest = new GuestNotifiable('guest@example.com', '홍길동', 'ko');
// data 에 전화번호 없음 + 게스트라 mobile 속성 없음
$this->makeDriver($this->fakeTemplate())->send($guest, $this->notification([]));
Bus::assertNotDispatched(SendMessageJob::class);
}
public function test_짧은_본문은_sm_s로_긴_본문은_lm_s로_보낸다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '01011112222']);
// SMS (90 byte 이하)
$smsBuilder = $this->spyBuilder();
$this->makeDriver($this->fakeTemplate(['subject' => '제목', 'body' => '짧은 본문']), $smsBuilder)
->send($member, $this->notification());
$this->assertSame('sms', $smsBuilder->calls[0]['type']);
// LMS (90 byte 초과 — 한글 45자 이상 = EUC-KR 90byte 초과)
$longBody = str_repeat('가', 100);
$lmsBuilder = $this->spyBuilder();
$this->makeDriver($this->fakeTemplate(['subject' => '제목', 'body' => $longBody]), $lmsBuilder)
->send($member, $this->notification());
$this->assertSame('lms', $lmsBuilder->calls[0]['type']);
$this->assertSame('제목', $lmsBuilder->calls[0]['subject'], 'LMS 는 subject(코어 제목)를 재사용해야 한다.');
}
public function test_본문이_비어있으면_발송하지_않는다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '01011112222']);
$this->makeDriver($this->fakeTemplate(['subject' => '', 'body' => ' ']))
->send($member, $this->notification());
Bus::assertNotDispatched(SendMessageJob::class);
}
public function test_generic_notification이_아니면_무시한다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '01011112222']);
$other = new Notification;
$this->makeDriver($this->fakeTemplate())->send($member, $other);
Bus::assertNotDispatched(SendMessageJob::class);
}
public function test_정상_조건에서_발송하고_이력을_생성한다(): void
{
// 비활성 확장 채널의 발송 차단은 코어 via() 책임이며 GenericNotificationViaTest 가 검증한다.
// 이 드라이버 테스트는 정상 조건(활성 전제)에서의 발송·이력 생성만 검증한다.
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$this->makeDriver($this->fakeTemplate())->send($member, $this->notification());
Bus::assertDispatched(SendMessageJob::class);
$this->assertDatabaseCount('bizppurio_dispatches', 1);
}
public function test_검수_모드_설정값이_이력에_스냅샷으로_기록된다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$this->makeDriver($this->fakeTemplate(), isTestMode: true)->send($member, $this->notification());
$this->assertTrue(BizppurioDispatch::first()->is_test_mode);
}
public function test_운영_모드_설정값도_이력에_스냅샷으로_기록된다(): void
{
Bus::fake();
$member = User::factory()->create(['mobile' => '010-1234-5678']);
$this->makeDriver($this->fakeTemplate(), isTestMode: false)->send($member, $this->notification());
$this->assertFalse(BizppurioDispatch::first()->is_test_mode);
}
}