fix(PROJ-74): Test-/Vet-Signatur-Drift beheben, go build/vet/test wieder grün

archivmail-export nutzte noch die alte storage.New(path string)-Signatur
statt storage.Config (fehlender Keyfile/Compress hätte Rohbytes statt
Klartext-EML exportiert). Toten Self-Assignment-Code in storage.go entfernt.
Testdateien (storage, audit, api, userstore, auth) an aktuelle Signaturen
angeglichen; auth-Tests liefen bisher gegen einen SQLite-Pfad statt Postgres-
DSN und wurden auf das TEST_DATABASE_URL-Schema-Isolationsmuster der übrigen
Pakete umgestellt. api_test.go las den Login-Token noch aus dem JSON-Body
statt aus dem httpOnly-Cookie (Auth-Contract-Drift).

TestParseMissingDate an tatsächliches Verhalten angepasst: der Parser lässt
das Datum bewusst als Zero-Value, der time.Now()-Fallback sitzt in der
Storage-Schicht — damit bleibt nachvollziehbar ob ein Datum aus der Mail
stammt oder vom Archiv gesetzt wurde (GoBD).

Verifiziert auf 192.168.1.132: go build/vet/test ./... komplett grün,
kein Skip (Postgres + Manticore erreichbar).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019j28kGcaJAhBnrYX34hGdt
This commit is contained in:
sysops
2026-08-05 14:07:46 +02:00
co-authored by Claude Sonnet 5
parent 88cdc3eb3e
commit 075afa005a
11 changed files with 247 additions and 34 deletions
+1 -1
View File
@@ -89,7 +89,7 @@
| PROJ-71 | TLS-Pflicht (optional) für eingehenden SMTP-BCC-Journaling-Kanal | Deployed | [PROJ-71](PROJ-71-smtp-require-tls.md) | 2026-07-08 |
| PROJ-72 | Fix Superadmin kann Passwort/Rolle von Superadmin-Peers nicht ändern (Sicherheitsbug) | Deployed | [PROJ-72](PROJ-72-fix-superadmin-peer-patch.md) | 2026-07-27 |
| PROJ-73 | Restliche Crash-Härtung (Upload-Job-Status bei Panic, fehlende nil-Checks) | In Review | [PROJ-73](PROJ-73-restliche-crash-haertung.md) | 2026-08-05 |
| PROJ-74 | Vorbestehende Test-/Vet-Signatur-Drift beheben (go vet/test wieder komplett grün) | Planned | [PROJ-74](PROJ-74-test-suite-signatur-drift.md) | 2026-08-05 |
| PROJ-74 | Vorbestehende Test-/Vet-Signatur-Drift beheben (go vet/test wieder komplett grün) | In Review | [PROJ-74](PROJ-74-test-suite-signatur-drift.md) | 2026-08-05 |
| PROJ-75 | DB-Performance-Audit (Query-Index-Nutzung, Fan-out, pgxpool-Tuning) | Planned | [PROJ-75](PROJ-75-db-performance-audit.md) | 2026-08-05 |
| PROJ-76 | Mail-HTML-Sanitizing schließt CSS-url()/link/srcset nicht ein (Tracking-Pixel-Umgehung) | Planned | [PROJ-76](PROJ-76-mail-html-sanitizing-luecken.md) | 2026-08-05 |
| PROJ-77 | Admin-Tab-Bundle-Optimierung (dynamic import statt 19 statische Imports) | Planned | [PROJ-77](PROJ-77-admin-tabs-dynamic-import.md) | 2026-08-05 |
@@ -68,6 +68,8 @@ Alle Pfade, die eine Zugriffsprüfung machen (Search/Export/OCR), fallen bei
Lokal kein `go build` möglich (kein Go-Toolchain), nur statische Prüfung.
Deployed auf 132 am 2026-08-05.
## Acceptance Criteria
- [x] Upload-Job zeigt nach einem simulierten Panic im Verarbeitungspfad
@@ -0,0 +1,154 @@
---
id: PROJ-74
title: Vorbestehende Test-/Vet-Signatur-Drift beheben (go vet/test wieder komplett grün)
status: In Review
created: 2026-08-05
---
## Problem
Bei der Verifikation von PROJ-73-Vorarbeiten auf 192.168.1.132
(`go build ./... && go vet ./... && go test ./...`) traten mehrere
vorbestehende, vom aktuellen Crash-Härtung-Fix unabhängige Fehler auf:
- `cmd/archivmail-export/main.go:39``storage.New` wird mit einem
`string` statt `storage.Config` aufgerufen. `storage.New`-Signatur wurde
in einem früheren Commit geändert, dieses CLI-Tool nicht nachgezogen.
Build schlägt komplett fehl.
- `internal/storage/storage.go:508` — Self-Assignment, von `go vet`
gemeldet.
- `internal/storage/storage_test.go`, `internal/audit/audit_test.go`,
`internal/api/api_test.go`, `internal/userstore/userstore_test.go`
Testdateien passen nicht mehr zu aktuellen Signaturen (`storage.New`,
`os.Discard`, `UpsertLDAPUser`). Build der Testpakete schlägt fehl.
- `pkg/mailparser/parser_test.go:98` (`TestParseMissingDate`) — Testfall
erwartet Fallback auf `time.Now()` bei fehlendem Date-Header, aktuelles
Verhalten weicht ab. Nicht Teil der Multipart-Depth/strings.Builder-
Änderungen aus PROJ-73-Vorarbeiten.
- `internal/auth`-Tests — `userstore.New: cannot parse .../users.db`,
vermutlich Umgebungs-/Test-DSN-Problem statt Code-Bug.
Solange diese Drift besteht, ist `go vet ./...` / `go test ./...` insgesamt
rot und liefert kein verlässliches Gesamtbild mehr — jede künftige
Verifikation muss den Diff manuell gegen die bekannten Altlasten abgleichen.
## Lösung (Vorschlag)
1. `archivmail-export`: `storage.New`-Aufruf auf aktuelle `storage.Config`-
Signatur anpassen (Config-Feld statt reinem String-Pfad).
2. `storage.go:508` Self-Assignment beheben.
3. Testdateien (`storage_test.go`, `audit_test.go`, `api_test.go`,
`userstore_test.go`) auf aktuelle Signaturen (`storage.New`,
`os.Discard`, `UpsertLDAPUser`) nachziehen.
4. `TestParseMissingDate` klären: ist der Test oder das aktuelle
Date-Fallback-Verhalten falsch? Danach eins von beiden anpassen.
5. `internal/auth`-Test-DSN-Problem auf 132 diagnostizieren (evtl. reines
Testumgebungs-Setup-Problem, kein Code-Bug).
## Implementation Notes
Umgesetzt (lokal, ohne Build/Test — kein Go-Toolchain auf der Workstation;
Verifikation erfolgt separat auf 192.168.1.132).
### 1. `cmd/archivmail-export/main.go:39`
`storage.New(cfg.Storage.StorePath)``storage.New(storage.Config{Dir, Keyfile,
DSN, CompressEnabled})`, analog zu `cmd/archivmail/cmd_export.go:88-93`.
Zusätzlich `defer mailStore.Close()` ergänzt (der Store hält jetzt einen
pgxpool, der bisherige Aufruf kannte noch keine DB-Verbindung).
Ohne `Keyfile`/`Compress` hätte das Tool verschlüsselte bzw. gzip-komprimierte
Mails als Rohbytes exportiert — der Fix stellt das alte Verhalten
("exportiere Klartext-EML") wieder her.
### 2. `internal/storage/storage.go:~506` Self-Assignment
`pm.MessageID = pm.MessageID` war echter toter Code (Kommentar im Original:
"no-op; thread resolved inside insertMeta"). Der komplette `if pm.InReplyTo != ""
|| len(pm.References) > 0`-Block hatte keinerlei Effekt und wurde entfernt; der
erklärende Kommentar bleibt als Doku über `resolveThreadID` stehen. Kein
Verhaltensunterschied.
### 3. Testdateien an aktuelle Signaturen angeglichen
- `internal/storage/storage_test.go`: `storage.New(dir)`
`storage.New(storage.Config{Dir: dir})` (5x); `store.Save(raw, time.Now())`
`store.Save(context.Background(), raw, time.Now(), nil)` (Signatur ist jetzt
`Save(ctx, raw, _ time.Time, tenantID *int64)`); Import `context` ergänzt.
- `internal/audit/audit_test.go`: `os.Discard``io.Discard` (4x), Import `io`
ergänzt (`os` bleibt für `os.Getenv`/`os.Open` nötig). `audit.New`,
`Log`, `Query` waren unverändert.
- `internal/api/api_test.go`: `os.Discard``io.Discard` + Import `io`;
`storage.New(filepath.Join(dir,"store"))`
`storage.New(storage.Config{Dir: ...})`. `api.New`, `auth.New`,
`userstore.Create` gegen den Produktionscode geprüft — unverändert.
- `internal/userstore/userstore_test.go`: `UpsertLDAPUser(username, email, role)`
`UpsertLDAPUser(username, email, role, nil)` (4. Parameter `tenantID *int64`,
`nil` = tenant-loser LDAP-User, entspricht dem alten Verhalten).
### 4. `TestParseMissingDate` — Entscheidung: Test angepasst, Code bleibt
Aktuelles Verhalten in `pkg/mailparser/parser.go:188-191`: Wenn der Date-Header
fehlt oder durch keinen der Fallback-Layouts parsbar ist, bleibt `pm.Date` der
Zero-Value (expliziter Kommentar: "Leave pm.Date as zero — storage will use DB
DEFAULT NOW()"). Der `time.Now()`-Fallback ist bewusst in die Storage-Schicht
gewandert: `internal/storage/storage.go:998-1000` (`insertMeta`) und
`:1034-1036` (`SaveMeta`) setzen `received_at = time.Now()`, wenn `pm.Date`
zero ist.
Das ist die sinnvollere Aufteilung und wird deshalb **nicht** zurückgedreht:
Der Parser bildet die Mail ab, wie sie ist, und erfindet kein Datum — dadurch
bleibt für jeden Konsumenten unterscheidbar, ob ein Datum aus der Mail stammt
oder vom Archiv gesetzt wurde (GoBD-Nachvollziehbarkeit). Ein `time.Now()`
direkt im Parser würde diese Information unwiederbringlich verschlucken.
Der Test prüft nun `p.Date.IsZero() == true` und dokumentiert die Aufteilung
inkl. Verweis auf die Storage-Fallbacks.
### 5. `internal/auth`-Tests — Ursache: veralteter SQLite-DSN
Kein Produktionscode-Bug. `internal/auth/auth_test.go:13` rief
`userstore.New(filepath.Join(t.TempDir(), "users.db"))` auf — ein Relikt aus der
SQLite-Zeit. `userstore.New` erwartet seit der PostgreSQL-Migration einen
pgx-DSN (`userstore.go:71`, `pgxpool.New`), weshalb pgx den Dateipfad mit
"cannot parse .../users.db" ablehnte.
Fix: `newTestAuth` nutzt jetzt dasselbe Muster wie `userstore_test.go` /
`api_test.go``TEST_DATABASE_URL` + pro Test isoliertes Schema
(`authtest_<testname>`, `search_path=`-Suffix am DSN), `t.Skip` wenn
`TEST_DATABASE_URL` nicht gesetzt ist, Cleanup per `DROP SCHEMA ... CASCADE`.
`TestHasRole` ist reine Logik und läuft weiterhin ohne PostgreSQL.
### Geänderte Dateien
- `cmd/archivmail-export/main.go`
- `internal/storage/storage.go`
- `internal/storage/storage_test.go`
- `internal/audit/audit_test.go`
- `internal/api/api_test.go`
- `internal/userstore/userstore_test.go`
- `internal/auth/auth_test.go`
- `pkg/mailparser/parser_test.go`
### Verifikation auf 132 (2026-08-05)
Mit `TEST_DATABASE_URL` gegen die lokale Postgres-Instanz auf 132 (eigenes
Schema pro Testlauf, per `DROP SCHEMA CASCADE` aufgeräumt) und erreichbarem
Manticore: `go build ./...`, `go vet ./...` und `go test ./...` liefen
komplett grün, alle Pakete PASS, keine Skips.
Zwei zusätzliche Fixes waren nötig, über die ursprüngliche Analyse hinaus:
- `internal/api/api_test.go` — ungenutzter Import `"net/http"` entfernt
(von `go vet` gemeldet).
- `internal/api/api_test.go` Helper `login()` las den JWT bisher aus dem
JSON-Response-Body (`resp["token"]`), was zu `nil`-Panic führte. Die
echte API liefert den Token nur noch als httpOnly-Cookie
(`archivmail_session`, siehe `internal/api/auth_handlers.go:81-99`) —
Auth-Contract-Drift, unabhängig von PROJ-73/74. Test liest den Token
jetzt aus `w.Result().Cookies()`.
## Acceptance Criteria
- [x] `CGO_ENABLED=0 go build ./...` auf 132 fehlerfrei (alle Pakete
inkl. `archivmail-export`).
- [x] `go vet ./...` ohne Meldungen.
- [x] `go test ./...` komplett grün (oder verbleibende Fails explizit als
bekannt/erwartet dokumentiert, nicht stillschweigend).