feat(api): Phase 2 — REST-API MVP + CRUD für Domains/Backends/Routing

REST-API mit Response-Envelope (1:1 mail-gateway), HS256-JWT-Signer
(Secret persistent unter /var/lib/edgeguard/.jwt_fingerprint),
Setup-Wizard (Bcrypt-Admin-Passwort in setup.json), Auth-Middleware
(Cookie + Bearer), Setup-Gate. Update-Banner-Endpoints
/system/package-versions + /system/upgrade ab Tag 1 wired (Pattern
aus enconf-management-agent: systemd-run detached, HTTP-Response
geht VOR dem Self-Replace raus).

CRUD-Repos für domains/backends/routing_rules mit pgxpool +
handgeschriebenem SQL (mail-gateway-Pattern, kein GORM zur Laufzeit).
Audit-Log-Schreiber auf jede Mutation, NodeID aus /etc/machine-id.
DB-Pool öffnet best-effort — ohne erreichbare PG bleiben CRUD-Routen
unregistriert, Auth/Setup/System antworten weiter (Dev ohne PG).

End-to-end live-getestet gegen lokale postgres-16: Setup → Login →
POST/PUT/DELETE Backends + Domains + Routing-Rules → audit_log
schreibt 5 Zeilen mit korrektem actor/action/subject. Graceful
degrade ohne DB ebenfalls verifiziert.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Debian
2026-05-09 09:56:10 +02:00
parent 106ef95f6d
commit 0a6f81beaa
18 changed files with 1925 additions and 10 deletions

View File

@@ -0,0 +1,72 @@
package response
import (
"encoding/json"
"errors"
"net/http"
"net/http/httptest"
"testing"
"github.com/gin-gonic/gin"
)
func init() { gin.SetMode(gin.TestMode) }
func run(handler gin.HandlerFunc) *httptest.ResponseRecorder {
r := gin.New()
r.GET("/x", handler)
rec := httptest.NewRecorder()
req, _ := http.NewRequest(http.MethodGet, "/x", nil)
r.ServeHTTP(rec, req)
return rec
}
func decodeEnv(t *testing.T, rec *httptest.ResponseRecorder) Envelope {
t.Helper()
var env Envelope
if err := json.Unmarshal(rec.Body.Bytes(), &env); err != nil {
t.Fatalf("decode: %v (body=%s)", err, rec.Body.String())
}
return env
}
func TestOK_Wraps200AndMessage(t *testing.T) {
rec := run(func(c *gin.Context) { OK(c, map[string]int{"n": 7}) })
if rec.Code != http.StatusOK {
t.Fatalf("status: %d", rec.Code)
}
env := decodeEnv(t, rec)
if env.Error != nil {
t.Errorf("error should be nil, got %q", *env.Error)
}
if env.Message != "OK" {
t.Errorf("message: %q", env.Message)
}
}
func TestErr_SerialisesErrorAndMessage(t *testing.T) {
rec := run(func(c *gin.Context) { Err(c, http.StatusBadRequest, errors.New("boom")) })
if rec.Code != http.StatusBadRequest {
t.Fatalf("status: %d", rec.Code)
}
env := decodeEnv(t, rec)
if env.Error == nil || *env.Error != "boom" {
t.Errorf("error: %v", env.Error)
}
if env.Message != "boom" {
t.Errorf("message: %q", env.Message)
}
if env.Data != nil {
t.Errorf("data should be nil on error, got %v", env.Data)
}
}
func TestNoContent_NoBody(t *testing.T) {
rec := run(func(c *gin.Context) { NoContent(c) })
if rec.Code != http.StatusNoContent {
t.Fatalf("status: %d", rec.Code)
}
if rec.Body.Len() != 0 {
t.Errorf("204 should have empty body, got %q", rec.Body.String())
}
}