# oPJD — oncological Patient Journey Dataset

> oPJD ist ein offener, JSON-Schema-basierter Standard für konsolidierte onkologische
> Patient Journeys: oBDS-Meldungen bleiben als unveränderte Ereignis-Nutzlast erhalten,
> ergänzt um Episoden (klinische Klammern), vier typisierte Relationen, einen
> Metadaten-Layer (Herkunft, Aktualität, Qualität) und eine Austauschhülle
> (Rechtsgrundlage, Verwendungszweck). English: an open German oncology data standard
> layering curated journey structure over unmodified oBDS payloads.

Konventionen für Maschinen: Schlüssel und Enum-Werte sind Englisch (snake_case),
normative Beschreibungen Deutsch. Das Dictionary ist die maschinenlesbare
Bedeutungsschicht — jedes Objekt, Feld und jeder Enum-Wert mit stabiler opjd://-ID,
Definition (de/en), Rationale und oBDS-Mapping. Referenzielle Integrität und die
klinische Grammatik werden bewusst auf Validator-Ebene geprüft, nicht im JSON Schema.
Interpretationsschicht beachten: meta.quality = derived ist ein algorithmischer
Vorschlag, curated eine fachliche Bestätigung.

## Spezifikation

- [Why oPJD](https://opjd.kerscher-lab.org/why-opjd): Problemstellung — warum der oBDS Kontext behauptet, aber nicht tragen kann; die fünf Zutaten
- [Clinical Model](https://opjd.kerscher-lab.org/clinical-model): Verlaufsphasen, Kontextklammern und die vier Relationstypen mit normativer deutscher Lesart
- [Specification](https://opjd.kerscher-lab.org/specification): Kernobjekte, Pflichtfelder, Metadaten-Layer, formaler Kontrakt
- [Data Dictionary](https://opjd.kerscher-lab.org/dictionary): alle Datenelemente mit Ankern je Term
- [Journey-Explorer](https://opjd.kerscher-lab.org/explorer): die Referenzverläufe interaktiv — Zeitstrahl, Klammern als Bänder, Relationen als klickbare Pfeile
- [Data Delivery](https://opjd.kerscher-lab.org/data-delivery): Austauschhülle — Rechtsgrundlage, Verwendungszwecke, Gültigkeit
- [Quality & Validation](https://opjd.kerscher-lab.org/quality): Prüfbarkeit und Lückenerkennung
- [Governance](https://opjd.kerscher-lab.org/governance): Versionierung, Änderungsprozess, Rollen
- [Versionen & Gültigkeit](https://opjd.kerscher-lab.org/versions): Lebenszyklus, Versionsregister, Konformität

## Schema & Dictionary (maschinenlesbar)

- [Manifest](https://opjd.kerscher-lab.org/schema/manifest.json): maschineller Einstiegspunkt — Versionen, URLs, Guide, Feedback-Kontrakt
- [Versionsregister](https://opjd.kerscher-lab.org/schema/versions.json): alle Versionen mit Status (draft/review/released/deprecated/retired)
- [JSON Schema 0.2.0](https://opjd.kerscher-lab.org/schema/0.2.0/opjd-package.schema.json): formaler Kontrakt (Draft 2020-12)
- [Dictionary 0.2.0](https://opjd.kerscher-lab.org/schema/0.2.0/dictionary.json): normative Bedeutung aller Terme (opjd://-IDs, de/en)
- [Dictionary-Metaschema](https://opjd.kerscher-lab.org/schema/dictionary.schema.json): Format des Dictionaries

## Beispiele (synthetisch)

- [NSCLC neoadjuvant + Studienphase](https://opjd.kerscher-lab.org/schema/0.2.0/examples/opjd-example-nsclc.json): validierte Referenzjourney
- [Prostata Active Surveillance](https://opjd.kerscher-lab.org/schema/0.2.0/examples/opjd-example-prostate-as.json): Überwachungsstrategie mit triggers-Relation

## Governance-Dokumente (veröffentlicht)

- [Änderungsprozess](https://opjd.kerscher-lab.org/docs/governance/PROZESS.md) · [Konformität](https://opjd.kerscher-lab.org/docs/governance/KONFORMITAET.md) · [Rollen](https://opjd.kerscher-lab.org/docs/governance/ROLLEN.md)
- [Entscheidungen (ADRs)](https://opjd.kerscher-lab.org/docs/decisions/) · [Release Notes](https://opjd.kerscher-lab.org/docs/releases/) · [Proposal-Vorlage](https://opjd.kerscher-lab.org/docs/proposals/0000-template.md)
- [Changelog](https://opjd.kerscher-lab.org/changelog)

## Werkzeuge & Feedback

- [MCP-Server @kerscher-lab/opjd-mcp](https://www.npmjs.com/package/@kerscher-lab/opjd-mcp): `npx -y @kerscher-lab/opjd-mcp` — Tools: opjd_explain, opjd_validate, opjd_map_obds, opjd_propose_change u. a.
- Änderungsvorschläge: strukturierte E-Mail an alexander.kerscher@kerscher-lab.org nach dem Feedback-Kontrakt (Manifest, feedback.contract); opjd_propose_change erzeugt einen vorbefüllten Entwurf
- [Mitmachen](https://opjd.kerscher-lab.org/contribute): der Weg eines Vorschlags

## Optional

- [llms-full.txt](https://opjd.kerscher-lab.org/llms-full.txt): generierte Vollreferenz — Schema + Dictionary + Beispiele in einem Dokument. Lizenzen: Apache-2.0 (Schemas/Code), CC BY 4.0 (Texte/Dictionary)