# 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.