From eddb6da4a69f5ab4d7c477c5da483e95c6a9068d Mon Sep 17 00:00:00 2001 From: sysops Date: Sun, 30 Aug 2026 09:27:51 +0200 Subject: [PATCH] RET-09: modul-adapter-dienst-starten - archive/cmd/moduleadapter-api: startet den fertigen RET-05 RegisterHandler als eigenstaendigen HTTP-Dienst, Port 8095 - reines Wiring, kein Diff an internal/moduleadapter/ (verifiziert) - real deployed auf 131, end-zu-ende per curl: Registrierung + Idempotenz-Nachweis (widerspruechliche zweite Werte werden ignoriert, urspruengliche Registrierung bleibt bestehen) Pruefungen siehe archive/docs/RET-09-PRUEFPROTOKOLL.md --- archive/cmd/moduleadapter-api/main.go | 43 ++++++++++++++ archive/docs/RET-09-PRUEFPROTOKOLL.md | 57 +++++++++++++++++++ ...rch-archive-moduleadapter-api.service.tmpl | 14 +++++ 3 files changed, 114 insertions(+) create mode 100644 archive/cmd/moduleadapter-api/main.go create mode 100644 archive/docs/RET-09-PRUEFPROTOKOLL.md create mode 100644 deploy/systemd/nexarch-archive-moduleadapter-api.service.tmpl diff --git a/archive/cmd/moduleadapter-api/main.go b/archive/cmd/moduleadapter-api/main.go new file mode 100644 index 0000000..b9368a7 --- /dev/null +++ b/archive/cmd/moduleadapter-api/main.go @@ -0,0 +1,43 @@ +// moduleadapter-api ist der Aufrufpunkt fuer RET-09: startet den bereits +// fertigen archive/internal/moduleadapter.RegisterHandler (RET-05) als +// eigenstaendigen HTTP-Dienst. REINES WIRING — keine Aenderung an +// moduleadapter.go/handler.go, keine neue Logik. +package main + +import ( + "context" + "log" + "net/http" + "os" + + "github.com/jackc/pgx/v5/pgxpool" + + "gitea.perlbach24.de/scripte/nexarch/archive/internal/moduleadapter" +) + +func main() { + dsn := os.Getenv("NEXARCH_MODULEADAPTER_TENANT_DSN") + if dsn == "" { + log.Fatal("NEXARCH_MODULEADAPTER_TENANT_DSN muss gesetzt sein") + } + addr := os.Getenv("NEXARCH_MODULEADAPTER_API_LISTEN_ADDR") + if addr == "" { + addr = "127.0.0.1:8095" + } + + ctx := context.Background() + pool, err := pgxpool.New(ctx, dsn) + if err != nil { + log.Fatalf("datenbankverbindung: %v", err) + } + defer pool.Close() + + mux := http.NewServeMux() + mux.HandleFunc("/register", moduleadapter.RegisterHandler(pool)) + mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) }) + + log.Printf("moduleadapter-api: listening on %s", addr) + if err := http.ListenAndServe(addr, mux); err != nil { + log.Fatalf("http server: %v", err) + } +} diff --git a/archive/docs/RET-09-PRUEFPROTOKOLL.md b/archive/docs/RET-09-PRUEFPROTOKOLL.md new file mode 100644 index 0000000..dc872fb --- /dev/null +++ b/archive/docs/RET-09-PRUEFPROTOKOLL.md @@ -0,0 +1,57 @@ +# RET-09 – Prüfprotokoll: Modul-Adapter-Dienst starten (RET-05 als laufender HTTP-Endpunkt) + +Voraussetzung RET-05 – bereits Fertig, hier UNVERÄNDERT. + +## Reines Wiring, keine neue Logik + +`git diff --stat archive/internal/moduleadapter/` liefert KEINEN Diff — +`moduleadapter.go`/`handler.go` sind byteidentisch zum RET-05-Stand. +RET-09 fügt ausschließlich `cmd/moduleadapter-api/main.go` (startet +`RegisterHandler` auf einem Port) und die systemd-Einheit hinzu. +Gleiches Muster wie RBAC-06/CFG-05, aber kleiner: kein neuer +Auth-Mechanismus (RET-05s eigene AC verlangte keinen), kein neuer +Vertrag, nur Betrieb des bereits Fertigen. + +## Umsetzung + +- `archive/cmd/moduleadapter-api/main.go` – eigenständiger HTTP-Dienst, + Port 8095. +- `deploy/systemd/nexarch-archive-moduleadapter-api.service.tmpl`. + +## Prüfungen + +| # | Prüfung | Ergebnis | +|---|---|---| +| 1 | Dienst startet und bleibt stabil (systemctl status aktiv) | **bestanden** – real auf 131: `nexarch-archive-moduleadapter-api.service` aktiv, `Restart=on-failure` | +| 2 | Realer POST /register von einem externen Testclient liefert die erwartete Registrierung (idempotent, wie in RET-05 getestet) | **bestanden** – real per `curl`: erste Registrierung liefert neue ID mit übergebenen Werten (HTTP 200); zweiter Aufruf mit ABWEICHENDEN Werten (anderer `retention_class`/`callback_url`) liefert DIESELBE ID mit den URSPRÜNGLICHEN Werten unverändert zurück — RET-05s Idempotenz-/Überschreibschutz real über den laufenden Dienst bestätigt, Testdaten anschließend entfernt | +| 3 | Code-Review: keine Änderung an moduleadapter.go/handler.go selbst, nur main.go+systemd neu | **bestanden** – `git diff --stat archive/internal/moduleadapter/` liefert leeren Diff gegenüber dem RET-05-Stand | + +## Echte Verdrahtung auf 192.168.1.131 + +- `moduleadapter-api` gebaut nach `/opt/nexarch-archive/bin/` +- `/etc/nexarch/archive-moduleadapter-api.env` (0600) +- `nexarch-archive-moduleadapter-api.service` installiert/aktiviert + (dauerhaft, `Restart=on-failure`) +- End-zu-Ende-Nachweis: `curl POST /register` zweimal mit + widersprüchlichen Werten beim zweiten Aufruf, beide Male HTTP 200, + zweite Antwort bestätigt die erste (Idempotenz), Testzeile + anschließend entfernt. + +## Build/Test-Ergebnis (192.168.1.131) + +``` +go build ./... -> clean +go vet ./... -> clean +golangci-lint run ./cmd/moduleadapter-api/... -> 0 issues +``` + +Keine neuen Go-Tests nötig (kein neuer Code außer main.go, das nur +verdrahtet) – die eigentliche Logik ist bereits durch RET-05s eigene +Tests abgedeckt. + +## Gesamtergebnis + +**Bestanden.** RET-05 ist jetzt ein real laufender, über systemd +verwalteter Dienst. DOC-16 und ARC-11 können sich jetzt gegen einen +echten Test-RET-05-Endpunkt verdrahten, statt gegen unverdrahteten +Go-Code oder einen reinen In-Process-Mock zu testen. diff --git a/deploy/systemd/nexarch-archive-moduleadapter-api.service.tmpl b/deploy/systemd/nexarch-archive-moduleadapter-api.service.tmpl new file mode 100644 index 0000000..250e82c --- /dev/null +++ b/deploy/systemd/nexarch-archive-moduleadapter-api.service.tmpl @@ -0,0 +1,14 @@ +[Unit] +Description=NEXARCH Archive - Modul-Adapter-Registrierung (RET-05/RET-09) +After=network.target postgresql.service + +[Service] +Type=simple +User=nexarch +EnvironmentFile=/etc/nexarch/archive-moduleadapter-api.env +ExecStart=__INSTALL_DIR__/bin/moduleadapter-api +Restart=on-failure +StandardOutput=journal + +[Install] +WantedBy=multi-user.target