Initial Email-Forwarder scaffold

Codex-Briefing.md

@@ -0,0 +1,115 @@
+# Codex-Briefing — Email-Forwarder
+
+Du baust ein Go-Single-Binary im Hausstil (wie WatchDove): `main.go` als
+Orchestrator, nummerierte `backend/NN-*.go`, Server-gerendertes HTML + HTMX,
+`config.json`, SQLite via `modernc.org/sqlite` (kein cgo). Das Gerüst steht;
+fülle die `// TODO Codex`-Stellen. **Lies zuerst `Projektbeschreibung.md` – die
+5 harten Regeln sind bindend.**
+
+## Bibliotheken (lean, keine Lawine)
+
+- IMAP: `github.com/emersion/go-imap/v2` (+ `imapclient`)
+- Parsen (Message-ID, Header, Text/HTML für Viewer): `github.com/emersion/go-message`
+- SQLite: `modernc.org/sqlite`
+- POP3-Fallback: `github.com/knadh/go-pop3`
+- SMTP-Weiterleiten: `net/smtp` (stdlib) — keine Extra-Dependency
+
+`go mod tidy` + `go mod vendor` (Offline-Bunker, wie im Template).
+
+## Modul-Landkarte
+
+| Datei | Inhalt |
+|---|---|
+| `main.go` | Flags (`--run`, `--watch`), LoadConfig→ConnectDB→InitAuth, Web oder CLI |
+| `backend/00-router.go` | Routen + `renderShell` (Outlook-2013-Dreispalter) — **da steht schon das Layout** |
+| `backend/01-config.go` | `config.json` (App + Forward-SMTP). Konten NICHT hier, sondern DB |
+| `backend/02-database.go` | Schema + Account-CRUD + `copied`-Cache (Idempotenz) |
+| `backend/03-auth.go` | Login + `AuthMiddleware` |
+| `backend/04-imap-source.go` | Quelle: Ordnerbaum + Fetch `BODY[] FLAGS INTERNALDATE` |
+| `backend/05-imap-target.go` | Ziel: `EnsureFolder` + `Append` (Flags + INTERNALDATE) |
+| `backend/06-mbox.go` | mbox schreiben (Umzug) **und** lesen (Viewer) |
+| `backend/07-migrate.go` | Motor: pro Konto/Ordner/Mail, Dedup, Doppel-Write, Fortschritt |
+| `backend/08-viewer.go` | mbox im Browser: Liste, Lesen, Weiterleiten |
+| `backend/09-smtp.go` | SMTP nur fürs Weiterleiten |
+| `backend/10-pop3.go` | POP3-Fallback-Quelle (nur INBOX, nie DELE) |
+
+## DB-Schema (SQLite)
+
+```
+accounts(id, name,
+         src_host, src_port, src_security, src_insecure, src_user, src_pass, src_proto,
+         dst_host, dst_port, dst_security, dst_insecure, dst_user, dst_pass,
+         mbox_dir, active)
+folder_map(id, account_id, src_folder, dst_folder)   -- optional, Vorrang vor Rollen-Automatik
+copied(account_id, folder, message_id UNIQUE)        -- Delta-Cache
+jobs(id, account_id, started, finished, total, done, errors, state)
+```
+
+`src_security`/`dst_security` = `"tls"` | `"starttls"` | `"none"`.
+`src_insecure`/`dst_insecure` = ungültige Zerts akzeptieren.
+
+## Der Umzugs-Kern (07-migrate.go), Schritt für Schritt
+
+1. Quelle öffnen: `src_proto=imap` → `OpenIMAPSource`, sonst `OpenPOP3Source`.
+2. `Folders()` → rekursiver Ordnerbaum.
+3. Pro Ordner: Zielordner via `MapSourceToTarget` (11-folders.go) bestimmen —
+   Rollen-Zuordnung gegen die vorhandenen Ziel-Ordner (keine Dubletten),
+   Trenner umhängen, `folder_map` als Override. Dann `EnsureFolder`.
+4. `Fetch(folder)` streamend. Pro Mail: `AlreadyCopied(id,folder,msgID)`?
+   → ja: überspringen. Nein: **beide** schreiben — `TargetMailbox.Append`
+   (IMAP, mit Flags+INTERNALDATE) **und** `MboxWriter.Append` (lokal), dann
+   `MarkCopied`. Fehler pro Mail zählen, nicht den ganzen Lauf abbrechen.
+5. `jobs` fortschreiben (Browser pollt `/migrate/status` alle 3 s).
+6. `--watch`: Schleife mit Pause; dank `copied` kopiert jeder Durchlauf nur Neues.
+
+## UI — Outlook 2013 (Vorlage)
+
+Look sitzt schon in `frontend-js/dist/style.css` + `renderShell`:
+**Ribbon** (Outlook-Blau `#0072c6`) mit Reitern *Umzug · Postfächer · Betrachten
+· Einstellungen*, darunter **Dreispalter**: links Ordnerbaum (Konto → Ordner),
+Mitte Nachrichtenliste (ungelesen = fett blau), rechts Lesebereich; unten
+Statusleiste. Flach, Segoe UI, blaue Auswahlzeile `#cde6f7`. Panes per HTMX
+nachladen (`#tree` / `#list` / `#read`). Klassen stehen im CSS: `.tree-node`,
+`.msg-row(.unread/.active)`, `.read-*`, `.grid/.input/.btn`.
+
+Reiter **Postfächer** = Konten-CRUD (Formular wie WatchDove `targetForm`, Quelle-
+und Ziel-Block, „Test"-Button prüft beide Logins). Reiter **Umzug** = Konten
+starten + Fortschritt. Reiter **Betrachten** = mbox-Viewer, im Lesebereich ein
+„Weiterleiten"-Button (öffnet Formular → `09-smtp.go`).
+
+`frontend-js/dist/htmx.min.js` per Bun holen (wie Template) und mit einchecken.
+
+## Sonderfälle — die drei Umzugs-Fallen (zwingend)
+
+1. **Unverschlüsselte Alt-Provider.** Verbinden nach `src_security`:
+   `tls`=DialTLS (993), `starttls`=DialStartTLS (143), `none`=Dial (reiner
+   Klartext). `src_insecure` → `tls.Config{InsecureSkipVerify:true}` für
+   kaputte/selbstsignierte Zerts. Muss ohne TLS funktionieren — alte Hoster
+   können oft nichts anderes. (04/05-imap-*.go, POP3 analog 110/995.)
+2. **Sonderzeichen in Ordnernamen.** IMAP-Ordner sind auf der Leitung
+   modified-UTF-7 (`Gelöschte`→`Gel&APY-schte`). go-imap dekodiert/kodiert das —
+   intern IMMER mit dem Klartext-Namen arbeiten, **nie doppelt kodieren**.
+   Hierarchie-Trenner (`.` vs `/`) je Server aus LIST lesen und beim Umhängen
+   übersetzen (`11-folders.go`).
+3. **Standardordner nicht doppeln.** `11-folders.go` bildet jeden Ordner auf
+   eine Rolle ab (SPECIAL-USE `\Sent \Drafts \Junk \Trash \Archive`, sonst
+   mehrsprachige Namensliste). `MapSourceToTarget` sortiert Gesendet/Entwürfe/
+   Spam/Papierkorb/Archiv/Posteingang in den **vorhandenen** Rollen-Ordner des
+   Ziels statt „Gesendete Objekte" **neben** „Gesendete Elemente" zu legen.
+   Manuelles `folder_map` schlägt die Automatik.
+
+## Sicherheit
+
+Tool hält fremde IMAP-Passwörter und kann Mails senden. Default `bind=127.0.0.1`
++ Login. Falls je remote (hinter Caddy): `/vadmin`-Mail-2FA-Muster aus dem
+Web-Deploy-Kit vorschalten. `config.json`/DB nie committen (`.gitignore` steht).
+
+## Fertig-Kriterien (Durchstich zuerst)
+
+1. **Durchstich:** ein Konto, nur `INBOX`, Quelle→Ziel-`APPEND` + mbox,
+   Message-ID-Dedup, zweimal laufbar ohne Dubletten.
+2. Alle Ordner rekursiv + `EnsureFolder` im Ziel.
+3. Konten-CRUD + Test-Button im Browser.
+4. Viewer (Liste/Lesen) + Weiterleiten.
+5. `--watch`-Delta-Schleife.
+6. Optional: POP3-Fallback.