nexarch/workflow/internal/contracttest/contracttest.go

// Package contracttest implementiert Workflow QA-06: Vertragstests fuer die
// beiden von DMS/Mail konsumierten Workflow-Schnittstellen -- ENG-02 (Push:
// Modul-Adapter-Registrierung) und VOR-04 (Pull: Rueckkanal-API). Jeder Test
// prueft die TATSAECHLICHE Antwort einer echten Workflow-Komponente gegen
// ihr dokumentiertes Schema -- eine entfernte oder umbenannte Pflichteigenschaft
// laesst den jeweiligen Test fehlschlagen, BEVOR sie ein konsumierendes Modul
// bricht. Gleiches Muster wie Archive QA-06 (archive/internal/contracttest,
// RET-05), hier fuer zwei getrennte Richtungen statt einer gespiegelt.
package contracttest

import (
	"encoding/json"
	"fmt"
)

// RequireJSONFields dekodiert data als JSON-Objekt und prueft, dass ALLE
// angegebenen Top-Level-Schluessel vorhanden sind. Liefert die fehlenden
// Schluessel zurueck -- leer bedeutet: Vertrag eingehalten.
func RequireJSONFields(data []byte, required []string) (missing []string, err error) {
	var decoded map[string]any
	if err := json.Unmarshal(data, &decoded); err != nil {
		return nil, fmt.Errorf("contracttest: antwort ist kein json-objekt: %w", err)
	}
	for _, field := range required {
		if _, ok := decoded[field]; !ok {
			missing = append(missing, field)
		}
	}
	return missing, nil
}