From c91eeac0a08ced01509796f44034a02dbc97fbaf Mon Sep 17 00:00:00 2001 From: sysops Date: Wed, 24 Jun 2026 23:16:34 +0200 Subject: [PATCH] =?UTF-8?q?docs(PROJ-58):=20batch=5Fmode=20f=C3=BCr=20Neui?= =?UTF-8?q?nstallationen=20standardm=C3=A4=C3=9Fig=20aktivieren?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit config.docker.yml.example setzt index.batch_mode/ocr.batch_mode jetzt auf true statt es nur kommentiert zu zeigen, damit neue Installationen direkt mit Cron-Batch-Verarbeitung statt Dauerbetrieb starten. Bestehende Installationen (131/132) sind unberührt, da ihre config.yml unabhängig vom Repo-Beispiel ist. Co-Authored-By: Claude Sonnet 4.6 --- config/config.docker.yml.example | 20 ++++++++++++-------- features/PROJ-58-cron-batch-index-ocr.md | 3 +++ 2 files changed, 15 insertions(+), 8 deletions(-) diff --git a/config/config.docker.yml.example b/config/config.docker.yml.example index 62f70b0..01edeea 100644 --- a/config/config.docker.yml.example +++ b/config/config.docker.yml.example @@ -30,12 +30,14 @@ index: backend: xapian batch_size: 100 async_queue_size: 1000 - # PROJ-58: batch_mode (optional, default false). + # PROJ-58: batch_mode (optional, Default false wenn weggelassen). # true = der Dauerbetrieb-Index-Worker wird NICHT gestartet; neue Mails # bleiben indexed_at IS NULL bis der Cron-Job 'archivmail index-pending' - # sie verarbeitet (siehe deploy/cron.d/archivmail). Glättet Schreiblast. - # false (Default) = sofortige, fortlaufende Indexierung wie bisher. - # batch_mode: false + # sie verarbeitet (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar). + # Glättet Schreiblast auf der Festplatte. false = sofortige, fortlaufende + # Indexierung. Für Neuinstallationen ist batch_mode hier standardmäßig + # aktiviert — bei Bedarf einfach auf false setzen. + batch_mode: true api: bind: "0.0.0.0:8080" @@ -68,13 +70,15 @@ imap_server: # ocr: # paused_hours: [8, 18] # OCR pausiert während der Geschäftszeiten # -# PROJ-58: ocr.batch_mode (optional, default false). +# PROJ-58: ocr.batch_mode (optional, Default false wenn weggelassen). # true = der Dauerbetrieb-OCR-Worker wird NICHT gestartet; neue Mails bleiben # ocr_status='pending' bis der Cron-Job # 'archivmail ocr-reprocess --status pending' sie verarbeitet -# (siehe deploy/cron.d/archivmail). false (Default) = sofortige Verarbeitung. -# ocr: -# batch_mode: false +# (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar). false = sofortige +# Verarbeitung. Für Neuinstallationen ist batch_mode hier standardmäßig +# aktiviert — bei Bedarf einfach auf false setzen. +ocr: + batch_mode: true # PROJ-56: IMAP-Sync-Jitter (optional). # jitter_seconds verteilt den tatsächlichen Sync-Start jedes Accounts diff --git a/features/PROJ-58-cron-batch-index-ocr.md b/features/PROJ-58-cron-batch-index-ocr.md index 9fcb399..479062d 100644 --- a/features/PROJ-58-cron-batch-index-ocr.md +++ b/features/PROJ-58-cron-batch-index-ocr.md @@ -59,6 +59,9 @@ Aktuell laufen Indexierung (`internal/index/tenant_worker.go`) und OCR (`interna - Minor-Finding behoben: `index-pending` fehlte in `printHelp()` (cmd_import.go) — ergänzt. - Keine Critical/High-Findings. Server 192.168.1.131 nicht angefasst während der QA. +## Nachtrag (2026-06-24): batch_mode als Default für Neuinstallationen +Auf Nutzerwunsch ist `index.batch_mode: true` und `ocr.batch_mode: true` jetzt aktiv (nicht mehr auskommentiert) in `config/config.docker.yml.example` gesetzt, damit neue Installationen direkt mit Cron-Batch statt Dauerbetrieb starten. Bestehende Installationen (wie 192.168.1.131/132) sind davon nicht betroffen, da deren `/etc/archivmail/config.yml` unabhängig vom Repo-Beispiel ist und weiterhin ohne `batch_mode`-Einträge (= Dauerbetrieb) läuft. + ## Out of Scope - Kein Wechsel der bestehenden Mechanismen für Installationen, die `batch_mode` nicht setzen. - Kein UI/Admin-Schalter im Frontend — Konfiguration ausschließlich über `config.yml` + `cron.d`.