z230

2026-06-17 15:05:10 +02:00
parent de959d849d
commit 4884117227
85 changed files with 34611 additions and 0 deletions
@@ -0,0 +1,47 @@
+# sipiq_import_v1.1 — import SIPIQ odpovědí do MongoDB (folder workflow)
+
+**Verze:** 1.1 · **Datum:** 2026-06-17 · **Studie:** 77242113UCO3002 (ICONIC / DAWN)
+
+## Změny proti v1.0
+- **FOLDER WORKFLOW** (`--folder`): sebere všechna `*.csv` ve složce, naimportuje (delta)
+  a po úspěšném zpracování **přesune soubor do podsložky `Zpracováno`**.
+  Default složka = `U:\PythonProject\Janssen\Feasibility\77242113UCO2001\ImportSIPIQcompled`.
+  Vzor Incoming/Processed (jako IWRS / Panorama). Stará v1.0 → `Feasibility\TRASH`.
+
+## Účel a kolekce
+(stejné jako v1.0) Import Qualtrics CSV exportu do db `feasibility`:
+- `sipiq_questions` — slovník dotazníku (rekonstrukce SIPIQ jako v PDF).
+- `sipiq_responses` — 1 dok = 1 odpověď (`_id`=ResponseId), ploché `answers{}`,
+  soft-link `investigator_oid`, delta + `history[]`.
+
+Zdroj = CSV (ř.1 Qcode, ř.2 text otázky, ř.3 ImportId=QID). XML neobsahuje text otázky.
+
+## Delta import (přepíše JEN změněná data)
+nová→INSERT; beze změn (shodný `content_sha256`)→jen `last_seen_at`;
+změna→`$set` jen změněných polí + `$push` do `history[]`.
+
+## Soft-link na investigators (nedestruktivní)
+pi_email → email/email2 (lower), pak recipient_email, fallback příjmení (bez diakritiky)+země.
+
+## Použití
+```
+# folder režim (default složka): zpracuje vše a přesune do Zpracováno
+.venv\Scripts\python.exe Feasibility\sipiq_import_v1.1.py --dry-run
+.venv\Scripts\python.exe Feasibility\sipiq_import_v1.1.py --apply
+# jiná složka
+.venv\Scripts\python.exe Feasibility\sipiq_import_v1.1.py --folder "<cesta>" --apply
+# jediný soubor (NEpřesouvá)
+.venv\Scripts\python.exe Feasibility\sipiq_import_v1.1.py --csv "<cesta.csv>" --apply
+```
+`--scope czsk` (default) / `all`. Default = dry-run, ostrý = `--apply`.
+Přesun do `Zpracováno` proběhne JEN v `--apply` a JEN ve folder režimu (ne u `--csv`).
+Kolize jmen v Zpracováno → přípona `_N`.
+
+## Workflow (domluva 17JUN2026)
+Uživatel pokládá kompletní SIPIQ reporty (Qualtrics CSV) do `ImportSIPIQcompled\`.
+Po zpracování skript přesune soubor do `ImportSIPIQcompled\Zpracováno\`. Delta zajistí,
+že opakovaný/rozšířený export jen doplní nové/změněné odpovědi (zbytek beze změny).
+
+## Stav 17JUN2026
+Folder + Zpracováno připraveny. Iniciální import (15 CZ+SK z 06.06 exportu) proveden ještě v1.0:
+`sipiq_questions`:56, `sipiq_responses`:15, soft-link 15/15 přes e-mail = KROK 7.