Testing

Setup

Framework: PHPUnit 11.5
Config: phpunit.xml
Bootstrap: tests/bootstrap.php (PSR-4 autoloader for Tests\ namespace)
Run: composer test → vendor/bin/phpunit -c phpunit.xml --testdox
Helper: dg/bypass-finals — allows mocking final classes

PHPUnit Configuration

<phpunit bootstrap="tests/bootstrap.php"
    cacheDirectory="storage/cache/phpunit"
    colors="true"
    executionOrder="depends,defects"
    failOnWarning="true"
    failOnRisky="true">

Test Files (`tests/Unit/`)

File	Subject	Coverage
`AllegroOrderImportServiceTest.php`	`AllegroOrderImportService`	Import, retry on 401, empty ID guard
`AllegroShipmentServiceTest.php`	`AllegroShipmentService`	Shipment creation
`AllegroStatusSyncServiceTest.php`	`AllegroStatusSyncService`	Status sync
`AllegroTokenManagerTest.php`	`AllegroTokenManager`	Token refresh
`ApaczkaShipmentServiceTest.php`	`ApaczkaShipmentService`	Apaczka API calls
`AutomationServiceTest.php`	`AutomationService`	Email-once guard, condition evaluation
`DeliveryStatusTest.php`	Delivery status mapping	Status translation

No repository, controller, or view tests exist — only service-layer unit tests.

Test Patterns

Mock Setup

final class AllegroOrderImportServiceTest extends TestCase {
    private AllegroIntegrationRepository&MockObject $integrationRepository;
    private AllegroApiClient&MockObject $apiClient;

    protected function setUp(): void {
        $this->apiClient = $this->createMock(AllegroApiClient::class);
        $this->service = new AllegroOrderImportService(
            $this->integrationRepository, $this->tokenManager, $this->apiClient, ...
        );
    }
}

Behavior Verification

$this->emailOnceRepository
    ->expects($this->exactly(2))
    ->method('wasSent')
    ->willReturnOnConsecutiveCalls(false, true);

$this->emailService
    ->expects($this->once())
    ->method('send');

Exception Testing

$this->expectException(AllegroApiException::class);
$this->expectExceptionMessage('Podaj ID zamowienia');
$this->service->importSingleOrder('');

Retry Logic Testing

$callCount = 0;
$this->apiClient->method('getCheckoutForm')
    ->willReturnCallback(function () use (&$callCount): array {
        if (++$callCount === 1) {
            throw new RuntimeException('ALLEGRO_HTTP_401');
        }
        return $payload;
    });

$this->service->importSingleOrder($id);
$this->assertSame(2, $callCount); // retry happened

Test Data Builders

private function buildMinimalPayload(string $id): array {
    return [
        'id' => $id,
        'status' => 'READY_FOR_PROCESSING',
        'payment' => ['id' => 'pay-1', 'type' => 'allegro', ...],
        // all required nested fields
    ];
}

What Is Not Tested

Controllers (no HTTP integration tests)
Repositories (no DB integration tests — no test database configured)
Views (no rendering tests)
Cron handlers
Migration scripts

Manual UAT

Phase summaries note manual UAT steps after feature implementation (e.g., Phase 104 — Apaczka weekend delivery tested via UI). No documented UAT scripts or Postman collections.

3.2 KiB Raw Blame History