Archive outdated journal logs and documents. Add Postman Runbook structure and centralize API testing documentation. Update Flyway configuration for ping-service with service-specific schema history.

This commit is contained in:
2026-04-03 21:48:32 +02:00
parent b9ec070993
commit 35f8b46e6c
78 changed files with 291 additions and 260 deletions
@@ -1,109 +1,20 @@
# 🧪 Postman Tests — Vollständige Dokumentation
> **Stand:** 3. April 2026
> **Erstellt von:** 👷 Backend Developer & 🧐 QA Specialist
> **Collection-Datei:**
`backend/infrastructure/gateway/src/main/resources/static/docs/postman/Meldestelle_API_Collection.json`
---
## Inhaltsverzeichnis
1. [Setup & Variablen](#1-setup--variablen)
2. [Smoke-Tests: System & Health](#2-smoke-tests-system--health)
3. [Ping Service](#3-ping-service)
4. [Authentication Context](#4-authentication-context)
5. [Master Data: Countries](#5-master-data-countries)
6. [Horse Registry (Pferde)](#6-horse-registry-pferde)
7. [ZNS Import Service](#7-zns-import-service)
8. [Empfohlene Test-Reihenfolge](#8-empfohlene-test-reihenfolge)
type: Note
status: REDIRECT
owner: Curator
last_update: 2026-04-03
---
# 🧪 Postman Tests — Vollständige Dokumentation (verschoben)
## 1. Setup & Variablen
Diese ausführliche Arbeitsversion wurde konsolidiert und in das zentrale Runbook für Betriebsanleitungen überführt.
### Collection importieren
Aktuelle Fassung:
- `docs/07_Infrastructure/runbooks/POSTMAN_API_Tests_Runbook.md`
1. Postman öffnen → **Import** → Datei auswählen:
```
backend/infrastructure/gateway/src/main/resources/static/docs/postman/Meldestelle_API_Collection.json
```
2. Collection `Meldestelle API Collection` erscheint im linken Panel.
Archiv:
- Zusammenfassung im Archiv: `docs/04_Agents/_archive/Postman_Tests_Dokumentation_2026-04-03.md`
### Environment-Variablen anlegen
In Postman ein **Environment** `Meldestelle Local` anlegen mit folgenden Variablen:
| Variable | Initial Value | Beschreibung |
|-------------|-------------------------|------------------------------------|
| `baseUrl` | `http://localhost:8081` | API-Gateway (Haupt-Einstiegspunkt) |
| `pingUrl` | `http://localhost:8082` | Ping-Service direkt (ohne Gateway) |
| `znsUrl` | `http://localhost:8095` | ZNS-Import-Service direkt |
| `authToken` | *(leer, wird befüllt)* | JWT-Token nach Login |
| `horseId` | *(leer, wird befüllt)* | ID eines angelegten Pferdes |
| `countryId` | *(leer, wird befüllt)* | ID eines angelegten Landes |
| `horseId1` | *(leer)* | Für Batch-Delete Tests |
| `horseId2` | *(leer)* | Für Batch-Delete Tests |
> ⚠️ **Wichtig:** Sicherstellen dass alle Services laufen bevor Tests gestartet werden (siehe Betriebsanleitung).
---
## 2. Smoke-Tests: System & Health
> **Zweck:** Schnell prüfen ob das API-Gateway und alle Services erreichbar sind. Immer zuerst ausführen!
---
### 2.1 API Gateway Info
| Feld | Wert |
|-------------|----------------|
| **Methode** | `GET` |
| **URL** | `{{baseUrl}}/` |
| **Auth** | Keine |
**Erwartete Antwort:** `200 OK`
```json
{
"service": "Meldestelle API Gateway",
"version": "...",
"status": "running"
}
```
**Wozu:** Bestätigt dass das Gateway läuft und auf Anfragen antwortet.
---
### 2.2 Health Check (Gateway)
| Feld | Wert |
|-------------|----------------------|
| **Methode** | `GET` |
| **URL** | `{{baseUrl}}/health` |
| **Auth** | Keine |
**Erwartete Antwort:** `200 OK`
```json
{
"status": "UP"
}
```
---
### 2.3 API Documentation
| Feld | Wert |
|-------------|-------------------|
| **Methode** | `GET` |
| **URL** | `{{baseUrl}}/api` |
| **Auth** | Keine |
**Erwartete Antwort:** `200 OK` — OpenAPI JSON-Dokumentation
Hinweis: Diese Datei bleibt als Weiterleitung bestehen, damit bestehende Links nicht brechen.
---
@@ -0,0 +1,17 @@
---
type: Archive
status: ARCHIVED
owner: QA Specialist
last_update: 2026-04-03
---
# 🧪 Postman Tests — Vollständige Dokumentation (ARCHIV)
Diese ausführliche Arbeitsversion wurde am 03.04.2026 im Rahmen einer QA/BackendSession erstellt.
Sie wurde inzwischen zu einem leicht verständlichen, zentralen Runbook konsolidiert.
Aktuelle Fassung:
- `docs/07_Infrastructure/runbooks/POSTMAN_API_Tests_Runbook.md`
Hinweis:
- Diese Archivdatei behält keinen Volltext der alten Fassung, um Duplikate zu vermeiden.
- Alle relevanten Inhalte sind im Runbook enthalten bzw. wurden aktualisiert.