Specifikationer

OpenOnco er et første projekt med specifikationer. Alle detaljer vedrørende arkitektur, klinisk og styring er fastgjort i et nedslagsdokument under specs/ that is versioned and open to public review. 10 active specifications cover everything from intended-use design constraints to the shape of every YAML entity in the KB. The full text lives at github.com/romeo111/OpenOnco/specs.

Sandhedens kildehierarki (fra CLAUDE.md): Når specs konflikt, bindende ordre er 1. CHARTER.md → 2. andet specs/*.md → 3. KLAUDE.md → 4. README.md. Alt under legacy/ er ikke autoritativ.

Aktive specifikationer (10)

Styring CHARTER.md

Charter og styreformer

Project governance, scope (what it does and what it explicitly does not), intended-use design constraints (§15 with constraints C1-C7), the solo-maintainer workflow for source-traceable content (§6.1), patient-data privacy (§9.3), forbidden prompt patterns for LLMs (§8.3 — LLMs do not make clinical decisions).

Læs på GitHub → Råmarkering

Klinisk CLINICAL_CONTENT_STANDARDS.md

Standarder for klinisk indhold

Standarder for klinisk indhold: citering format (source_id + position + parafrase + side), evidens-niveau taksonomi (Tier 1-6), reviewer afsign-off workflow, STUB → reviderede overgangskriterier.Hver krav i en indikation / Regimen / RedFlag links til en kilde enhed.

Læs på GitHub → Råmarkering

Data DATA_STANDARDS.md

Datastandarder — patientmodel

Patient profile data model. FHIR R4/R5 + mCODE alignment on the roadmap. Code systems: LOINC + ICD-10/O-3 + RxNorm + CTCAE v5.0. No SNOMED CT and no MedDRA in the MVP (license gates). Profile fields and semantic interoperability.

Læs på GitHub → Råmarkering

Skjema KNOWLEDGE_SCHEMA_SPECIFICATION.md

Specifikation af videnskema

Pydantic schemas for every KB entity — Disease / Indication / Regimen / Algorithm / Biomarker / Drug / Test / Workup / RedFlag / Contraindication / MonitoringSchedule / SupportiveCare / Source. Defines fields, validators, referential-integrity rules, and the migration roadmap to PostgreSQL.

Læs på GitHub → Råmarkering

Kilder SOURCE_INGESTION_SPEC.md

Kildeindtagelse og licensudstedelse

Hvordan vi indtager kilder: hosting matrix (referencet vs hoste vs mixed) med H1-H5-begrundelse, licens-klassifikation porte, add-a-source checkliste (§8), hosted-source kontrolliste (+20) og SourceClient protokol for live API'er.

Læs på GitHub → Råmarkering

Prøvning REFERENCE_CASE_SPECIFICATION.md

Referencesag — "Patient Zero"

En syntetisk HCV-MZL referencesag som P0 accept test. Definerer alle krævede patient-profil felt (§2- skabeloner), de kritiske strukturelle påstande for Plan reproducer output (§1.3), og milepæle M1-M6 for at udvide dækning.

Læs på GitHub → Råmarkering

Motor MDT_ORCHESTRATOR_SPEC.md

MDT orkester + beslutningsprøve

Orchestrate_mdt rules (R1-R9 for treatment, D1-D6 for diagnostic), role activation logic (required / recommended / optional), the Open Questions mechanism (Q1-Q6 + DQ1-DQ4 — the engine refuses to decide without the required data), and a decision-provenance graph for audit-grade explanation.

Læs på GitHub → Råmarkering

Motor DIAGNOSTIC_MDT_SPEC.md

Diagnostisk-fase MDT (præbiopsi)

Pre-biopsy mode: when histology is not yet available the engine emits a DiagnosticPlan with a workup brief instead of a treatment Plan. CHARTER §15.2 C7 hard rule. DiagnosticWorkup + DiagnosticPlan schemas, generate_diagnostic_brief(), polymorphic orchestrate_mdt with DQ1-DQ4 rules.

Læs på GitHub → Råmarkering

Klinisk WORKUP_METHODOLOGY_SPEC.md

Arbejdsmiljø Forskningsmetode

Hvordan vi bygger en grundlæggende oparbejdning for alle onkologiområder. Kildehierarki (Tier 1: NCCN/ESMO/EHA/BSH/WHO/ASH), Test/Arbejdsup fuldstændighed checklister, 7-trin proces for at udvide dækning til et nyt domæne, anti-mønstre.

Læs på GitHub → Råmarkering

Motor SKILL_ARCHITECTURE_SPEC.md

Dygtighedsorienteret arkitektur (MDT Roller som færdigheder)

Formalises MDT roles (haematologist / pathologist / radiologist / etc.) as clinically-verified skills — each skill carries version, sources, last_reviewed, clinical_lead. Sizing horizon (~12-15 MVP → 50-60 comprehensive), 8-domain layout, 5-phase refactor plan.

Læs på GitHub → Råmarkering

Forskriftsmæssig kilde (PDF)

Regulerings-PDF Guidance-Clinical-Decision-Software_5.pdf

FDA Klinisk beslutning Støtte Software Vejledning

The official FDA guidance on non-device CDS classification under §520(o)(1)(E). Hosted under specs/ as a PDF. CHARTER §15 cites concrete criteria 1-4 from this document to justify OpenOnco's non-device positioning.

Vis PDF på GitHub →

Hvordan vi opdaterer specifikationerne

Solo-projektet. En vedligeholder leverer opdateringer med automatiske kontroller og kildesporbarhed. Ekstern klinisk gennemgang er valgfri og registreres separat.

Alle specifikationer er skrevet ukrainsk-først (grænsefladen og de kliniske reviewers er UA), men tekniske vilkår og licens navne ophold på engelske inline. Versioning er via git: hver spec bærer v0.1 (draft) i overskriften og er stødt på mindre/stor afhængigt af brud på ændringer.

Overholdelse + privatlivets fred (hurtig visning)

Garanti	Specifikation	Hvad det betyder
FDA non-device CDS	`CHARTER.md §15`	Charteret beskriver designmål; det fastslår hverken en regulatorisk klassifikation eller klinisk validering.
No patient data	`CHARTER.md §9.3`	`patient_plans/` og enhver patient HTML er gitignoreret. Alle eksempler er syntetisk.
Levering af solovedligeholder	`CHARTER.md §6.1`	Vedligeholderen kontrollerer kilder og tests; ekstern klinisk gennemgang er valgfri.
No LLM clinical judgment	`CHARTER.md §8.3`	LLMs ikke vælge regimer, ikke generere doser, og ikke fortolke biomarkører til valg af behandling.
No treatment without histology	`CHARTER.md §15.2 C7`	Motoren nægter at generere en behandlingsplan uden `disease.id` or `icd_o_3_morphology` — kun en diagnosticeringsplan.
Antiautomation-bias	`CHARTER.md §15.2 C6`	≥2 alternative spor vises altid side-ved-side; alternativet er aldrig skjult.
Standard for kildevært = refereret	`SOURCE_INGESTION_SPEC.md §1.4`	Vi dupliserer ikke eksterne databaser; hosting kræver eksplicit H1-H5-begrundelse.
Free public resource → non-commercial	`CHARTER.md §2`	Mange licenser (ESMO CC-BY-NC-ND, OncoKB akademisk, ATC) afhænger af dette. Et betalt niveau ville udløse en licens revision.
Autovalg af IP-baseret sprog	`client-side, opt-out`	For at vise grænsefladen på dit sprog, din browser ser op dit land fra din IP via en tredjeparts service (GeoJS, med ipapi.co as fallback). Only your IP is sent, with no referrer. These direct geo requests do not use the OpenOnco API; the providers determine their own logging and retention policies. The detected country and your manual language choice are stored only in your browser (localStorage) and the manual switch always overrides the IP guess. Ukrainian is shown only for Ukrainian IP addresses; English everywhere else. By using the site you consent to this country lookup — to avoid it, pick a language manually and your choice is remembered.