📖 14주차 01강: 단위 & 기능 테스트(Pest/PHPUnit), 데이터베이스 테스트 & 모킹(Mocking)

<?php

namespace Tests\Unit;

use App\Models\Book;
use PHPUnit\Framework\TestCase;

class BookTest extends TestCase
{
    /**
     * 정상 가격과 판매 가격이 주어졌을 때 할인율 텍스트가 정확히 계산되는지 검증
     */
    public function test_it_calculates_discount_rate_correctly(): void
    {
        $book = new Book([
            'title' => '라라벨 11 실전 마스터',
            'original_price' => 40000,
            'price' => 36000, // 10% 할인
        ]);

        $this->assertEquals('10% 할인', $book->discount_rate_text);
    }

    /**
     * 할인 없이 정가 그대로 판매할 경우 할인율 배지가 null인지 검증
     */
    public function test_it_returns_null_discount_badge_when_no_discount(): void
    {
        $book = new Book([
            'title' => '정가 도서',
            'original_price' => 20000,
            'price' => 20000,
        ]);

        $this->assertNull($book->discount_rate_text);
    }
}

<?php

namespace Tests\Feature;

use App\Events\OrderPlaced;
use App\Models\Book;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Http;
use Tests\TestCase;

class CheckoutFeatureTest extends TestCase
{
    use RefreshDatabase; // 매 테스트마다 DB 테이블 자동 생성 및 초기화

    public function test_authenticated_user_can_checkout_books_successfully(): void
    {
        // 1. 이벤트 디스패치 모킹 (실제 큐/메일 발송 방지)
        Event::fake([OrderPlaced::class]);

        // 2. 외부 토스페이먼츠 PG사 결제 승인 API 모킹
        Http::fake([
            'https://api.tosspayments.com/v1/payments/confirm' => Http::response([
                'status' => 'DONE',
                'paymentKey' => 'mock_payment_key_12345',
                'orderId' => 'ORD-TEST-001',
                'totalAmount' => 35000,
            ], 200),
        ]);

        // 3. 테스트 데이터 생성 (독자 1명, 도서 1권 - 재고 10권)
        $user = User::factory()->create();
        $book = Book::factory()->create([
            'title' => '라라벨 아키텍처',
            'price' => 35000,
            'stock' => 10,
            'is_sold_out' => false,
        ]);

        // 4. 회원 로그인 상태로 결제 요청 전송
        $response = $this->actingAs($user)->post('/checkout/process', [
            'book_id' => $book->id,
            'quantity' => 2,
            'shipping_address' => '서울시 강남구 테헤란로 123',
            'payment_key' => 'mock_payment_key_12345',
        ]);

        // 5. HTTP 응답 검증 (주문 완료 페이지로 리다이렉트)
        $response->assertStatus(302);
        $response->assertSessionHas('status', '도서 주문이 성공적으로 완료되었습니다!');

        // 6. 데이터베이스 반영 검증
        // 도서 재고가 10권 -> 8권으로 차감되었는지 검증
        $this->assertDatabaseHas('books', [
            'id' => $book->id,
            'stock' => 8,
        ]);

        // 주문 테이블에 해당 유저의 주문 레코드가 생성되었는지 검증
        $this->assertDatabaseHas('orders', [
            'user_id' => $user->id,
            'total_amount' => 70000,
            'status' => 'paid',
        ]);

        // 7. OrderPlaced 도메인 이벤트가 정확히 1번 발행되었는지 검증
        Event::assertDispatched(OrderPlaced::class);
    }

    public function test_checkout_fails_when_book_is_out_of_stock(): void
    {
        $user = User::factory()->create();
        $soldOutBook = Book::factory()->create([
            'stock' => 0,
            'is_sold_out' => true,
        ]);

        $response = $this->actingAs($user)->post('/checkout/process', [
            'book_id' => $soldOutBook->id,
            'quantity' => 1,
        ]);

        // 품절 도서 주문 시 422 또는 세션 에러 검증
        $response->assertSessionHasErrors(['book_id']);
    }
}

<?php

namespace Tests\Feature;

use App\Models\Book;
use App\Models\Order;
use App\Models\OrderItem;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class CancelUnpaidOrdersCommandTest extends TestCase
{
    use RefreshDatabase;

    public function test_it_cancels_orders_older_than_24_hours_and_restores_stock(): void
    {
        $book = Book::factory()->create(['stock' => 5]);

        // 25시간 전에 생성된 미결제 주문 생성
        $expiredOrder = Order::factory()->create([
            'status' => 'pending',
            'created_at' => now()->subHours(25),
        ]);

        OrderItem::create([
            'order_id' => $expiredOrder->id,
            'book_id' => $book->id,
            'quantity' => 2,
            'unit_price' => 20000,
        ]);

        // 콘솔 명령어 실행 및 터미널 출력/상태코드 검증
        $this->artisan('shop:cancel-unpaid-orders', ['--hours' => 24])
            ->expectsOutputToContain('미결제 상태인 주문 취소 배치를 시작합니다')
            ->expectsOutputToContain('1건의 미결제 주문이 성공적으로 취소되고 재고가 복구되었습니다')
            ->assertSuccessful();

        // 주문 상태가 cancelled로 변경되었는지 검증
        $this->assertDatabaseHas('orders', [
            'id' => $expiredOrder->id,
            'status' => 'cancelled',
        ]);

        // 도서 재고가 다시 5 + 2 = 7권으로 복원되었는지 검증
        $this->assertEquals(7, $book->fresh()->stock);
    }
}

Mail::fake();      // 실제 메일 발송 차단 -> Mail::assertQueued(OrderReceiptMail::class);
Queue::fake();     // 실제 큐 워커 실행 차단 -> Queue::assertPushed(ProcessBookWatermarkJob::class);
Notification::fake(); // 알림 발송 차단 -> Notification::assertSentTo($user, OrderShippedNotification::class);
Storage::fake('public'); // 실제 로컬 디스크 파일 생성 차단 (메모리 가상 디스크 사용)

$this->travel(25)->hours(); // 현재 시각을 미래 25시간 뒤로 이동!
// 이 상태에서 테스트 수행
$this->travelBack(); // 원래 시간으로 복귀