IMP-05: hot-folder-scanner-anbindung

Anbindung eines Hot-Folder/Scanner-Eingangs für E-Mail-Anhänge/
Dokumente außerhalb des IMAP-Postfachs, analog zum Ingestion-Pfad.

- store.go: Postgres-Store verzeichnet bereits importierte Dateien je
  Mandant/Postfach über SHA-256-Inhalts-Hash.
- watcher.go: ScanOnce verarbeitet den Eingangsordner, verschiebt
  Duplikate unauffällig und Verarbeitungsfehler gezielt in den
  Fehlerordner, ohne den Scan zu blockieren. Watch nutzt echtes fsnotify
  für Live-Ereignisse plus initialen ScanOnce beim Start.
- Neue minimale Abhängigkeit github.com/fsnotify/fsnotify ergänzt.

Prüfungen (alle real durchgeführt, siehe mail/docs/IMP-05-PRUEFPROTOKOLL.md):
1. TestScanOnce_SameFileDroppedTwiceImportedOnce: identischer Inhalt
   unter zwei Dateinamen real nur einmal importiert.
2. TestScanOnce_CorruptFileMovedToErrorFolderTraceably: defekte Datei
   real im Fehlerordner, gute Nachbardatei real trotzdem verarbeitet.
3. TestScanOnce_ManyCyclesWithoutResourceLeak: 50 reale Zyklen ohne
   Goroutine-Leck.
Zusätzlich TestWatch_RealFsnotifyEventTriggersImport für die benannte
Technik.

Kein Umbau: kein bestehendes Paket angefasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ

This commit is contained in:

sysops

2026-09-01 00:22:56 +02:00

co-authored by

Claude Sonnet 5

parent dac7854440

commit 6e01cecca7

7 changed files with 542 additions and 0 deletions

									
										mail/internal/hotfolder/migrations/0001_mail_hotfolder_processed.sql
									
		+8
		
												View File
												
				@@ -0,0 +1,8 @@

				CREATE TABLE IF NOT EXISTS mail_hotfolder_processed (

				    tenant_slug   TEXT NOT NULL,

				    mailbox_name  TEXT NOT NULL,

				    content_hash  TEXT NOT NULL,

				    filename      TEXT NOT NULL,

				    processed_at  TIMESTAMPTZ NOT NULL DEFAULT now(),

				    PRIMARY KEY (tenant_slug, mailbox_name, content_hash)

				)