feat(kontakte): Vorbereich "Aus Mails" mit Dublettenabgleich

Der Postfachabgleich hat gefundene Personen bisher direkt in den
Kontaktbestand geschrieben. Damit wächst eine gepflegte Liste ungefragt
mit jeder Adresse aus jeder Mail - genau daran ist das Altsystem
gescheitert.

Funde landen jetzt in einem Vorbereich (crm_leads.mail_pool = 1), der als
Unterpunkt "Aus Mails" unter dem Menüpunkt Kontakte aufklappt. Der
Kontaktbestand bleibt unberührt, bis dort jemand entscheidet; in
Opportunities, Kalender und Netzwerk tauchen die Funde nicht auf.

Eine Spalte statt einer zweiten Tabelle, weil crm_mail_links und
crm_mail_contact_candidates per Fremdschlüssel auf crm_leads zeigen - so
behält der Vorbereich seine Mailbezüge.

Übernehmen kennt zwei Wege:
- neue Person: Kopie mit mail_pool = 0, die Mailverknüpfungen wandern mit
- Dublette (Adresse, sonst voller Name): gold markiert, abweichende
  Felder mit altem und neuem Wert; die Feldauswahl schreibt sie in den
  vorhandenen Kontakt. Vorausgewählt sind nur Lücken - ein Wert aus einer
  alten Signatur soll nichts Gepflegtes stillschweigend ersetzen.

db.js verschiebt beim ersten Start die vorhandenen Kontakte mit
source = 'Mail' in den Vorbereich, einmalig über den Merker
leads_mail_pool_migrated in crm_settings.

Die Sidebar-Gruppe ist dabei generisch geworden (MenuGroup) - Kontakte
und Scanner benutzen jetzt denselben Code.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs/11-postfach.md

@@ -192,8 +192,8 @@ flowchart TD
     F -->|"Person"| C["Vorschlag mit Zuversicht"]
 
     C --> Z{"E-Mail vorhanden<br/>und Zuversicht &ge; 70?"}
-    Z -->|ja, Automatik an| N["Kontakt anlegen<br/>source = 'Mail'"]
-    Z -->|Adresse existiert| G["vorhandenen Kontakt ergaenzen"]
+    Z -->|ja, Automatik an| N["Eintrag in 'Aus Mails'<br/>mail_pool = 1"]
+    Z -->|"Adresse dort schon"| G["Eintrag ergaenzen"]
     Z -->|nein| R["bleibt zur Durchsicht"]
 ```
 
@@ -216,9 +216,51 @@ Zwei Entscheidungen, die die Trefferqualitaet tragen:
   `k.mueller@…` wird der Vorname aus der Adresse genommen, der Nachname aber aus
   dem Anzeigenamen - dort stehen die Umlaute richtig.
 
-Uebernommene Kontakte tragen `crm_leads.source = 'Mail'`. Das ist die
-„Unterkategorie": die Kontaktliste hat dafuer einen Herkunftsfilter, ein eigenes
-Feld war nicht noetig.
+## Vorbereich „Aus Mails"
+
+Der Hintergrundlauf schreibt **nicht** in den Kontaktbestand. Was er findet,
+landet in einem Vorbereich: `crm_leads.mail_pool = 1`. Die Kontaktansicht zeigt
+nur `mail_pool = 0`, der Vorbereich steht als Unterpunkt *Aus Mails* unter dem
+Menuepunkt *Kontakte*.
+
+Der Grund ist Pflegbarkeit: die Kontaktliste ist eine gepflegte Liste, an der
+Opportunities, Kalender und Netzwerk haengen. Ein Abgleich, der ungefragt jede
+Adresse aus jeder Mail hineinschreibt, macht sie unbrauchbar - genau daran ist
+das Altsystem gescheitert. Deshalb sind Funde aus Mails Rohmaterial, bis jemand
+entscheidet.
+
+Eine Spalte statt einer zweiten Tabelle, weil `crm_mail_links` und
+`crm_mail_contact_candidates` per Fremdschluessel auf `crm_leads` zeigen: der
+Vorbereich behaelt damit seine Mailbezuege, ohne dass es zwei Wege gibt, eine
+Person mit einer Mail zu verbinden.
+
+```mermaid
+flowchart LR
+    P["Aus Mails<br/>mail_pool = 1"] --> D{"Person schon<br/>in den Kontakten?"}
+    D -->|nein| NEU["In Kontakte uebernehmen<br/>Kopie mit mail_pool = 0"]
+    D -->|"ja - Adresse oder Name"| GOLD["gold markiert<br/>Abweichungen hervorgehoben"]
+    GOLD --> M["Felder einzeln in den<br/>vorhandenen Kontakt uebernehmen"]
+    GOLD --> N2["trotzdem neu anlegen"]
+    P --> W["entfernen"]
+```
+
+Der Abgleich gegen die Kontakte laeuft im Browser (`mailPool.ts`): erst ueber die
+E-Mail-Adresse, sonst ueber den vollen Namen. Telefonnummern werden dabei ueber
+ihre Ziffern verglichen, damit „0221 123-4" und „02211234" nicht als Abweichung
+erscheinen.
+
+Beim Uebernehmen sind nur die **Luecken** vorausgewaehlt - Felder, in denen der
+Kontakt noch nichts hat. Werte, die einen gepflegten Eintrag ersetzen wuerden,
+sind als *ueberschreibt* gekennzeichnet und muessen bewusst angehakt werden: der
+Mailfund kann aus einer alten Signatur stammen.
+
+Uebernommene Kontakte tragen weiterhin `crm_leads.source = 'Mail'` - die
+Kontaktliste hat dafuer den Herkunftsfilter *Aus Mails uebernommen*.
+
+Bestandsumstellung: `db.js` verschiebt beim ersten Start alle vorhandenen
+Kontakte mit `source = 'Mail'` in den Vorbereich. Das laeuft genau einmal,
+festgehalten im Merker `leads_mail_pool_migrated` in `crm_settings` - sonst
+wanderten uebernommene Kontakte bei jedem Neustart zurueck.
 
 ## Anzeige des Mailtexts
 
@@ -251,8 +293,21 @@ Alle unter `/api/mail`, alle hinter `requireAuth`.
 | POST | `/messages/:id/links` | alle | an Kontakt und/oder Opportunity haengen |
 | DELETE | `/links/:id` | alle | Zuordnung loesen |
 | GET | `/candidates` | alle | Kontakt-Vorschlaege, `status` waehlbar |
-| POST | `/candidates/:id/adopt` | alle | Kontakt anlegen bzw. ergaenzen |
+| POST | `/candidates/:id/adopt` | alle | Kontakt anlegen bzw. ergaenzen; `target: 'pool'` legt in „Aus Mails" ab |
 | POST | `/candidates/:id/reject` | alle | Vorschlag verwerfen |
+
+Der Vorbereich haengt an den Kontakten und hat seine Endpunkte deshalb unter
+`/api/leads`:
+
+| Methode | Pfad | Zweck |
+| --- | --- | --- |
+| GET | `/leads/mail-pool/sources` | Herkunft je Eintrag: Mailanzahl, letzter Betreff, Zuversicht |
+| POST | `/leads/mail-pool/promote` | mehrere Eintraege als neue Kontakte anlegen |
+| POST | `/leads/:id/promote` | einen Eintrag uebernehmen; mit `target_lead_id` und `fields` in einen vorhandenen Kontakt |
+
+`keep_pool: true` behaelt den Eintrag in „Aus Mails"; ohne das verschwindet er
+dort, sobald er als Kontakt gefuehrt wird. In beiden Faellen wandern die
+Mailverknuepfungen mit an den Zielkontakt.
 | GET | `/settings` | admin | verstellbare Einstellungen |
 | POST | `/settings` | admin | Einstellungen speichern |
 | POST | `/test` | admin | Anmeldung **und** Postfachzugriff pruefen |