AUD-01: zentrales-audit-log-modell

internal/audit: eigenes, strukturiertes Audit-Datenmodell (Akteur, Aktion,
Zielobjekt, Zeitpunkt, Tenant) in der Registry-DB, getrennt von jedem
allgemeinen Anwendungs-Log (eigenes Paket, eigene Tabelle audit_events,
kein Logging-Framework). Log.Record ist der EINE zentrale Schreibpfad —
es gibt keine zweite Schreibmoeglichkeit, ueber die ein Handler die
Validierung umgehen koennte.

Fehlender Tenant-Bezug wird zweifach verhindert (Akzeptanzkriterium 2):
Log.Record weist leeren TenantSlug direkt ab (ErrMissingTenant), zusaetzlich
erzwingt eine CHECK-Constraint in der Migration dasselbe auf Datenbankebene,
selbst wenn Log.Record umgangen wuerde. Mandantenuebergreifende Ereignisse
(z.B. Superadmin-Aktionen) nutzen den reservierten Wert audit.SystemTenant
statt NULL oder leerem String — es gibt keinen Weg, ganz ohne Tenant-Bezug
zu schreiben.

Pruefungen (ausgefuehrt auf root@192.168.1.131, go build/vet/test PASS):
1. Automatisierter Test belegt genau einen Audit-Eintrag pro
sicherheitsrelevantem Vorgang — TestRecord_PersistsExactlyOneEventPerSecurityIncident
(simulierter fehlgeschlagener Login), Feldinhalte verifiziert. PASS.
2. Fehlender Tenant-Bezug durch Constraint/Test verhindert —
TestRecord_RejectsMissingTenant (App-Ebene) UND
TestConstraint_RejectsMissingTenantAtDatabaseLevel (direkter INSERT unter
Umgehung von Log.Record, durch CHECK-Constraint abgewiesen). PASS.
3. Datenmodell von zweiter Person gegen Dokumentation geprueft — NICHT
durchgefuehrt (keine zweite Person in dieser Session verfuegbar). Offen.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

This commit is contained in:

sysops

2026-08-27 19:22:50 +02:00

co-authored by

Claude Sonnet 5

parent 8da9c67d08

commit b12d53f469

8 changed files with 331 additions and 0 deletions

									
										go.mod
									
		+9
		
												View File
												
				@@ -3,3 +3,12 @@ module gitea.perlbach24.de/scripte/nexarch

				go 1.22

				require github.com/jackc/pgx/v5 v5.6.0

				require (

					github.com/jackc/pgpassfile v1.0.0 // indirect

					github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a // indirect

					github.com/jackc/puddle/v2 v2.2.1 // indirect

					golang.org/x/crypto v0.17.0 // indirect

					golang.org/x/sync v0.1.0 // indirect

					golang.org/x/text v0.14.0 // indirect

				)