nexarch/internal/moduledirectory/directory.go

// Package moduledirectory implementiert API-22: einen unauthentifizierten
// Discovery-Endpunkt, ueber den ein Client, der nur die Server-Grundadresse
// kennt, die tatsaechlichen Basis-Adressen der Fachmodule ermitteln kann.
// Die Modulliste kommt aus einer serverseitig gepflegten JSON-Datei (analog
// zu web/portal/config/modules.json aus SHL-02, aber server- statt
// clientseitig), damit neue Module ohne Codeaenderung ergaenzt werden koennen.
package moduledirectory

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

// Module ist bewusst auf Key und BaseURL beschraenkt (Akzeptanzkriterium 3):
// keine Zugangsdaten, keine internen Pfade.
type Module struct {
	Key     string `json:"key"`
	BaseURL string `json:"base_url"`
}

// LoadFile liest und validiert die Modulverzeichnis-Konfiguration.
func LoadFile(path string) ([]Module, error) {
	data, err := os.ReadFile(path)
	if err != nil {
		return nil, fmt.Errorf("modulverzeichnis lesen: %w", err)
	}

	var modules []Module
	if err := json.Unmarshal(data, &modules); err != nil {
		return nil, fmt.Errorf("modulverzeichnis parsen: %w", err)
	}
	for _, m := range modules {
		if m.Key == "" || m.BaseURL == "" {
			return nil, fmt.Errorf("modulverzeichnis: key und base_url sind fuer jeden eintrag pflicht")
		}
	}
	return modules, nil
}

type discoveryResponse struct {
	Modules []Module `json:"modules"`
}

// Handler liefert die Modulliste unauthentifiziert aus (Akzeptanzkriterium 1).
func Handler(modules []Module) http.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Content-Type", "application/json")
		w.WriteHeader(http.StatusOK)
		json.NewEncoder(w).Encode(discoveryResponse{Modules: modules})
	}
}