115 lines
3.2 KiB
Markdown
115 lines
3.2 KiB
Markdown
# 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
|
|
|
|
```xml
|
|
<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
|
|
|
|
```php
|
|
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
|
|
|
|
```php
|
|
$this->emailOnceRepository
|
|
->expects($this->exactly(2))
|
|
->method('wasSent')
|
|
->willReturnOnConsecutiveCalls(false, true);
|
|
|
|
$this->emailService
|
|
->expects($this->once())
|
|
->method('send');
|
|
```
|
|
|
|
### Exception Testing
|
|
|
|
```php
|
|
$this->expectException(AllegroApiException::class);
|
|
$this->expectExceptionMessage('Podaj ID zamowienia');
|
|
$this->service->importSingleOrder('');
|
|
```
|
|
|
|
### Retry Logic Testing
|
|
|
|
```php
|
|
$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
|
|
|
|
```php
|
|
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.
|