z230

EmailsImport/DockerCustomApp/app.md

@@ -58,7 +58,7 @@ Bearer token: `13e1bb01-9fd5-44a8-8ce9-4ee27133d340`
 
 | Endpoint | Přijímá | Chování |
 |---|---|---|
-| `POST /upload` | `.msg` / `.emsg` | `.emsg` Fernet dešifruje → uloží `.msg` do `/msgs`, přeskočí pokud existuje; volitelně import do Graphu |
+| `POST /upload` | `.msg` / `.emsg` | `.emsg` Fernet dešifruje → uloží `.msg` do `/msgs`, přeskočí pokud existuje; volitelně import do Graphu. **v2.4:** form pole `overwrite=1` → existující `.msg` **přepíše** (re-upload změněného e-mailu z `jnj_mailbox_sync >= v1.3`); při overwrite se Graph re-import nedělá |
 | `POST /upload-db` | `.db` / `.db.xz.enc` | **v2.1:** `.db.xz.enc` Fernet dešifruje + lzma rozbalí → plain `.db`; pak smaže staré `.db` v `/msgs/db` a uloží. Plain `.db` bere i nadále (zpětná kompatibilita) |
 | `POST /upload-dropbox` | cokoliv | Nahraje do Dropboxu (overwrite) |
 
@@ -68,6 +68,16 @@ Bearer token: `13e1bb01-9fd5-44a8-8ce9-4ee27133d340`
 > (stdlib) — ověřeno v kontejneru. Nasazení = jen restart (app.py je bind-mount),
 > bez rebuildu.
 
+> **v2.4 (2026-06-16):** `/upload` — nové form pole `overwrite=1`. Když `.msg`
+> už v `/msgs` existuje, místo `{"status":"exists"}` ho **přepíše** a vrátí
+> `{"status":"overwritten"}`. Bez pole zůstává původní idempotentní skip (žádná
+> regrese). Slouží pro re-upload **změněného** e-mailu z `jnj_mailbox_sync >= v1.3`
+> (detekce změny obsahu — např. dopsaná chyba `SendAsDenied` do neodeslané Sent
+> položky). Při overwrite se **Graph re-import nedělá** (klient posílá `folder=""`,
+> takže nevznikne duplikát v Graph zrcadle); přepsaný soubor má novější mtime →
+> Tower (`jnj_tower_ingest`) ho přeparsuje a upsertne dokument v Mongu dle `_id`.
+> Nasazení = jen `docker restart` (bind-mount).
+
 > **v2.3 (2026-06-10):** `/item/{token}` — při `Accept: application/json`
 > (klient `janssenpc_file_receive >= v1.2`) vrací `{"data": "<fernet_b64>"}`
 > místo binární přílohy. Důvod: JNJ filtr (Zscaler/SiteMinder) blokoval binární