# Testy integracyjne - dokumentacja

## Spis treści

- [Wprowadzenie](<#wprowadzenie>)
- [Klasa bazowa BaseIntegrationTest](<#klasa-bazowa-baseintegrationtest>)
- [Mockowanie odpowiedzi HTTP](<#mockowanie-odpowiedzi-http>)

## Wprowadzenie

Testy integracyjne powinny być wykonywane w środowisku, które nie jest zależne od zewnętrznych serwisów.

### Główne cechy

- Mockowanie API Marcos za pomocą `MarcosMockApiEngine`
- Brak mockowania połączenia RabbitMQ (wymagany lokalny RabbitMQ)
- Izolacja testów od zewnętrznych zależności
- Możliwość testowania scenariuszy błędów
- Redukcja obciążenia zewnętrznego API podczas testów

## Klasa bazowa BaseIntegrationTest

### Opis

`BaseIntegrationTest` to podstawowa klasa dla testów integracyjnych, która dostarcza wspólną infrastrukturę testową.

### Funkcjonalności

- Konfiguracja środowiska testowego z pliku 'application.yaml' (w module testów)
- Ustawienie mocka `MarcosApi` przy użyciu `MarcosMockApiEngine`
- Zapewnienie czystego środowiska dla każdego testu

### Przykład implementacji

```
class MyIntegrationTest : BaseIntegrationTest() {
    @Test
    fun `test endpoint behavior`() = withTestApplication {
        // Kod testu
    }
}
```

### Metoda withTestApplication

```
protected fun withTestApplication(block: suspend ApplicationTestBuilder.() -> Unit)
```

#### Parametry

- `block` - kod testu do wykonania w kontekście aplikacji, zapewnia dostęp do `ApplicationTestBuilder`

## Mockowanie odpowiedzi HTTP

### Struktura mocków

Odpowiedzi HTTP można mockować poprzez tworzenie klas dziedziczących po `BaseMockResponse`.

### Przykład mocka odpowiedzi

```
object LoadsMockResponse : BaseMockResponse() {
    override fun invoke(): String {
        return """
            {
                "@odata.context": "https://hoffmann.e-mbis.eu:1228/odata/${'$'}metadata#LoadsForPlaces",
                "value": [
                    {
                        "GrossWeight": 0.000,
                        "GrossWeightKg": 0.000,
                        "Amount": 25.000,
                        "Amount2": null,
                        "Id": 100000324,
                        "Weight": null,
                        "WeightGross": 0.000,
                        "WeightGrossKg": 0.000,
                        "Quantity": 25.000,
                        "Lenght": 0.00,
                        "Height": 0.00,
                        "Width": 0.00,
                        "Name": "Gips",
                        "Package": "luz",
                        "LoadingMeters": null,
                        "Volume": null
                        ...
                    }
                ]
            }
        """
    }
}
```
