# sipiq_import_v1.2 — import SIPIQ odpovědí (folder workflow + provenance)

**Verze:** 1.2 · **Datum:** 2026-06-17 · **Studie:** 77242113UCO3002 (ICONIC / DAWN)

## Změny
- **v1.2:** ke každé odpovědi `source_exported_at` = **datum/čas reportu podle filesystému**
  (mtime CSV souboru). Mimo content-hash → nezpůsobuje zbytečné UPDATE; backfilluje se i na
  "beze změny" cestě. v1.1 → `Feasibility\TRASH`.
- **v1.1:** FOLDER workflow (`--folder`) — sebere *.csv, delta import, přesun do `Zpracováno`.

## Kolekce
- `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`, `source_file` + `source_exported_at`, delta + `history[]`.

Zdroj = Qualtrics **CSV** (ř.1 Qcode, ř.2 text otázky, ř.3 ImportId=QID). Export labels,
desetinná tečka, recode unanswered vypnuté.

## Delta (přepíše JEN změněná data)
nová→INSERT; beze změn (shodný `content_sha256`)→jen `last_seen_at` + `source_file` + `source_exported_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í
```
.venv\Scripts\python.exe Feasibility\sipiq_import_v1.2.py --dry-run     # folder režim, default složka
.venv\Scripts\python.exe Feasibility\sipiq_import_v1.2.py --apply
.venv\Scripts\python.exe Feasibility\sipiq_import_v1.2.py --folder "<cesta>" --apply
.venv\Scripts\python.exe Feasibility\sipiq_import_v1.2.py --csv "<cesta.csv>" --apply   # jediný soubor, NEpřesouvá
```
Default složka `…\77242113UCO2001\ImportSIPIQcompled`; přesun do `Zpracováno` jen v `--apply` + folder režimu.
`--scope czsk` (default) / `all`. Default = dry-run.

## Workflow
Uživatel pokládá kompletní SIPIQ reporty (Qualtrics CSV, název
`ICONIC+Phase+3b+UC+Study+(77242113UCO3002)_SipIQ_V1_13MAY2026_<datum>_<čas>.csv`) do
`ImportSIPIQcompled\`. Po `--apply` se naimportují (delta) a přesunou do `Zpracováno\`.
`source_exported_at` se bere z mtime souboru (datum/čas reportu dle filesystému).