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:
@@ -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/Backend‑Session 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.
|
||||
Reference in New Issue
Block a user