# Vysvětlení původu lékařských dat

> Co záznam o původu obsahuje při každém zápisu do záznamu FHIR R4 — typ autora, osobu, organizaci, zdrojový systém, verze — jak jej nastavit pomocí hlaviček, jak jej číst a jak označuje data poskytovaná modelům AI.

Source: https://developers.anpheros.com/cs/guides/medical-data-provenance

**Původ je záznam o tom, odkud pochází kus lékařských dat: kdo jej zapsal, jménem které organizace, z jakého systému, kdy a co se změnilo v každé verzi.** V záznamu, který shromažďuje data od pacientů, zařízení, klinik, laboratoří a AI, je původ tím, co činí hodnotu důvěryhodnou: hodnota krevního tlaku zadaná doma a hodnota naměřená na klinice vypadají bez něj identicky. V Anpherosu každý zápis do záznamu HL7 FHIR R4 automaticky vytváří FHIR `Provenance` zdroj. Tato stránka vysvětluje, co obsahuje, jak jej správně vyplnit a jak jej číst.

## Proč na původu dat záleží

- **Klinická důvěra.** Lékař posuzuje laboratorní výsledek jinak než hodnotu zadanou pacientem nebo číslo extrahované AI z fotografie.
- **Bezpečnost AI.** Model, kterému je předán záznam, musí vědět, které položky jsou fakta a které jsou poznámky napsané jiným modelem. Bez označení je považuje za stejné.
- **Opravy a spory.** Když se hodnota změní, všichni musí vědět, jaká byla předtím, kdo ji změnil a proč.
- **Odpovědnost.** Podle GDPR a European Health Data Space musí organizace být schopna prokázat, co s osobními zdravotními údaji pacienta provedla.
- **Sdílení.** Když pacient dovolí druhé klinice přečíst si jeho záznam, tato klinika musí vědět, které údaje napsala první klinika.

## Co Anpheros zaznamenává při každém zápisu

| Otázka | Kde je zaznamenáno | Jak ji nastavit |
|---|---|---|
| Jaký typ autora? | `agent.who.identifier` (typ autora) | `author_type` v `/v1`, nebo hlavička `X-Anpheros-Author-Type`: `patient`, `practitioner`, `device`, `import`, `ai` |
| Která osoba? | `agent.who.reference` | `X-Anpheros-Author-Ref: Practitioner/<id>`, nebo `X-Anpheros-Acting-As` |
| Pro kterou organizaci? | `agent.onBehalfOf` | organizace `PractitionerRole`, nebo `X-Anpheros-On-Behalf-Of: Organization/<id>` |
| Z jakého systému? | `entity` s rolí `source` | `X-Anpheros-Source-System: <name>` |
| Jaký záznam v daném systému? | origin id | `X-Anpheros-Origin-Id: <id>` |
| Kdy a co se stalo? | `recorded`, `activity` (CREATE, UPDATE, DELETE) | automaticky |
| Která verze? | `target` odkazuje na `<Resource>/<id>/_history/<version>` | automaticky |

Pokud neuvedete, kdo je autorem, platforma zaznamená `import`. Nikdy nepředpokládá `patient`, protože hodnota nesprávně připsaná pacientovi je horší než hodnota poctivě označená jako importovaná.

## Zápis s plnou historií původu

Kardiolog na klinice zaznamená srdeční frekvenci během návštěvy prostřednictvím softwaru kliniky:

```bash
curl -X POST https://platform.anpheros.com/fhir/R4/Observation -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: practitioner" \
     -H "X-Anpheros-Acting-As: PractitionerRole/$ROLE" \
     -H "X-Anpheros-Source-System: ccn-emr" \
     -d '{ "resourceType": "Observation", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]}, … }'
```

Historie původu, kterou platforma zapíše:

```json
{"resourceType": "Provenance",
 "target": [{"reference": "Observation/8660eb7c-…/_history/1"}],
 "recorded": "2026-10-12T20:41:47.469000Z",
 "activity": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-DataOperation", "code": "CREATE"}]},
 "agent": [{"type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type", "code": "author"}]},
            "who": {"reference": "PractitionerRole/e6d8c227-…",
                    "identifier": {"system": "https://anpheros.com/fhir/CodeSystem/author-type", "value": "practitioner"}},
            "onBehalfOf": {"reference": "Organization/c3a56a4b-…", "display": "Clinica Cardio Nord"}}],
 "entity": [{"role": "source", "what": {"identifier": {"system": "ccn-emr"}}}]}
```

Role lékaře, jeho klinika, typ autora a zdrojový systém jsou zde uvedeny ve standardním formátu FHIR. `PractitionerRole` musí existovat ve vašem projektovém adresáři a být aktivní. Požadavek pojmenovávající praktického lékaře někoho jiného je zamítnut:

```json
{"resourceType": "OperationOutcome", "issue": [{"severity": "error", "code": "invalid",
  "diagnostics": "Unknown or inactive Practitioner in X-Anpheros-Acting-As."}]}
```

Nastavení adresáře je popsáno v [Jak integrovat klinické systémy s FHIR backendem](https://developers.anpheros.com/cs/guides/integrate-clinic-systems-fhir).

## Verze: nic není tiše přepsáno

Každá aktualizace vytvoří novou verzi zdroje a nový záznam Provenance pro ni. Po opravě srdeční frekvence z 92 na 88:

```bash
curl https://platform.anpheros.com/fhir/R4/Observation/$OBS/_history -H "Authorization: Bearer $KEY"
```

vrátí verzi 2 (88) a verzi 1 (92). Pohled REST shrnuje Provenance každé verze:

```bash
curl https://platform.anpheros.com/v1/patients/$PID/provenance/Observation/$OBS -H "Authorization: Bearer $KEY"
```

```json
{"data": [
  {"version": 1, "activity": "CREATE", "recorded": "2026-10-12T20:41:47.469000Z", "author_type": "practitioner", "author": "PractitionerRole/e6d8c227-…", "source_system": "ccn-emr", "fhir": "Provenance/6ed91529-…"},
  {"version": 2, "activity": "UPDATE", "recorded": "2026-10-12T20:41:47.500000Z", "author_type": "practitioner", "fhir": "Provenance/3fbf270f-…"}],
 "total": 2}
```

Smazání jsou měkká: smazaný zdroj zmizí z vyhledávání, ale jeho historie a Provenance zůstávají.

## Čtení původu

```bash
# who wrote this resource (all versions)
GET /fhir/R4/Provenance?target=Observation/{id}
# everything a practitioner recorded
GET /fhir/R4/Provenance?agent=PractitionerRole/{id}
# the same, summarised, per resource
GET /v1/patients/{pid}/provenance/Observation/{id}
```

## Provenience v kontextech AI

[API kontextu](https://developers.anpheros.com/cs/guides/llm-healthcare-data) přenáší provenienci do každé položky, kterou poskytuje modelu, jako `author_type` a `source`. V textové podobě:

```
- Type 2 diabetes mellitus (E11), active, onset 2024-10-15 [import/anpheros-sandbox]
- Metformin 1000 mg 1 tablet twice daily with meals, active [patient/anpheros-sandbox]
- Glucose [Mass/volume] in Blood: 2026-09-16: 140.0 mg/dL [device/anpheros-sandbox]
```

Měření zapsaná pomocí `author_type: ai` se nikdy neobjeví mezi těmito fakty. Jsou uvedena samostatně pod `ai_notes` a označena jako neověřená, takže model nemůže zaměnit odhad předchozího modelu za měření. Řekněte modelu, co štítky znamenají, a požádejte ho, aby na ně odkazoval; [Jak vytvořit zdravotnickou aplikaci s umělou inteligencí a backendem FHIR](https://developers.anpheros.com/cs/guides/build-ai-healthcare-app) ukazuje příklad promptu, který to dělá.

## Co vidí pacient

Provenance je také to, co vidí pacient. Jeho záznam ukazuje, kdo přidal každou položku, a jeho seznam připojení ukazuje, pro každou aplikaci, kdo co přístupoval, jménem, když praktikující jednal ("Dr. Ana Popescu · Clinica Cardio Nord si přečetl vaše laboratorní výsledky"). Viz [Model souhlasu a přístupu](https://developers.anpheros.com/cs/guides/consent).

## Pravidla, která činí původ užitečným

1. **Vždy nastavte typ autora.** Stojí to jedno pole a je to nejdůležitější označení v záznamu.
2. **Uveďte jméno osoby, pokud ji napsala osoba.** Použijte `X-Anpheros-Acting-As` pro klinický personál.
3. **Uveďte název zdrojového systému** a předejte vlastní ID zdroje jako ID původu, pokud existuje.
4. **Opravujte aktualizací, nikdy mazáním a opětovným vytvářením.** Aktualizace zachovává spojení mezi starou a novou hodnotou.
5. **Označte výstup AI jako `ai`**, včetně hodnot, které model extrahoval z dokumentu. Hodnoty odvozené z dokumentu mohou také odkazovat zpět na něj pomocí `derived_from`.

## Často kladené dotazy

### Co jsou data o původu v oblasti zdravotnictví?
Zdokumentovaný původ a historie dat o zdravotním stavu: kdo je vytvořil nebo změnil, jménem koho, z jakého systému a kdy. V HL7 FHIR je reprezentován zdrojem `Provenance`, který odkazuje na přesnou verzi zdroje, který popisuje.

### Je původ totéž co auditní záznam?
Ne. Původ popisuje data: kdo napsal každou verzi. Auditní záznam popisuje přístup: kdo co kdy přečetl nebo zapsal, pod jakým souhlasem. Anpheros uchovává obojí; pacient vidí záznam o přístupu pro každou aplikaci připojenou k jeho záznamu.

### Mohu si vytvořit vlastní zdroje původu?
Anpheros vytváří jeden pro každý create, update a delete, takže obvykle nemusíte. Použijte výše uvedené hlavičky, aby byly přesné. Původ dodaný klientem musí cílit na zdroje jednoho pacienta.

## Související

- [Model souhlasu a přístupu](https://developers.anpheros.com/cs/guides/consent)
- [Jak integrovat klinické systémy s FHIR backendem](https://developers.anpheros.com/cs/guides/integrate-clinic-systems-fhir)
- [Jak normalizovat lékařská data](https://developers.anpheros.com/cs/guides/normalize-medical-data)
- [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability)
- [Zabezpečení, soukromí a rezidence dat](https://developers.anpheros.com/cs/guides/security)