Spesifikasjoner

OpenOnco er et første prosjekt med spesifikasjoner. Alle detaljer om arkitektur, kliniske og styringer er satt inn 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.

Sannhetskilder (fra CLAUDE.md): når det oppstår konflikt, er bindende rekkefølge 1. CHARTER.md → 2. annet specs/*.md → 3. KLAUDE.md → 4. README.md. Alt under legacy/ er ikke autoritativ.

Aktive spesifikasjoner (10)

Styring CHARTER.md

Charter og styring

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

Les på GitHub → Råmarkering

Klinisk CLINICAL_CONTENT_STANDARDS.md

Standarder for klinisk innhold

Clinical content standards: citation format (source_id + position + paraphrase + page), evidence-level taxonomy (Tier 1-6), reviewer sign-off workflow, STUB → reviewed transition criteria. Every claim in an Indication / Regimen / RedFlag links to a Source entity.

Les på GitHub → Råmarkering

Data DATA_STANDARDS.md

Datastandarder — pasientmodell

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.

Les på GitHub → Råmarkering

Skjema KNOWLEDGE_SCHEMA_SPECIFICATION.md

Spesifikasjon av kunnskapsskjema

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.

Les på GitHub → Råmarkering

Kilder SOURCE_INGESTION_SPEC.md

Kildeinntak og lisensiering

Hvordan vi inntar kilder: vertsmatrisen (referanser versus vertsmod blandet) med begrunnelse for H1-H5, lisens-klassifiseringsporter, sjekkliste for add-a-kilde (§8), sjekklisten for verts-kilde(§20) og SourceClient-protokollen for levende API-er.

Les på GitHub → Råmarkering

Prøving REFERENCE_CASE_SPECIFICATION.md

Referansetilfelle — «Småstor null»

Et syntetisk HCV-MZL-referansetilfelle som P0-aksepttest. Definerer alle påkrevde patientprofilfelter (§2-maler), kritiske strukturelle påstander for utgivelse av planer (§1.3) og milepæler M1-M6 for å utvide dekningen.

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

Les på GitHub → Råmarkering

Motor DIAGNOSTIC_MDT_SPEC.md

Diagnostisk fase-MDT (prebiologisk)

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.

Les på GitHub → Råmarkering

Klinisk WORKUP_METHODOLOGY_SPEC.md

Forskningsmetoder til opparbeiding

Hvordan vi bygger opp et grunnleggende arbeid for alle onkologiområder. Kildehierarki (Tier 1: NCCN/ESMO/EHA/BSH/WHO/ASH), sjekklister for test/arbeidsoppfylling, 7-trinnsprosessen for å utvide dekningen til et nytt domene, anti-mønster.

Les på GitHub → Råmarkering

Motor SKILL_ARCHITECTURE_SPEC.md

Ferdighetsorientert arkitektur (MDT-roller som ferdigheter)

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.

Les på GitHub → Råmarkering

Kilde til regulering (PDF)

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

Veiledning i programvare til støtte for FDA-Klinical Project

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 oppdaterer vi spesifikasjonene?

Et solprosjekt. En vedlikeholder leverer oppdateringer med automatiske kontroller og kildesporbarhet. Ekstern klinisk gjennomgang er valgfri og registreres separat.

Alle spesifikasjoner er skrevet ukrainsk- first (grensesnittet og de kliniske reviewerne er UA), men tekniske vilkår og lisensnavn blir værende på engelsk i teksten. Versjonen skjer via git: every spec har v0.1 (draft) i overskriften og er knuffet på mindre/store avhengig av hvordan endringene brytes.

Overholdelse + personvern (rask visning)

Garanti	Spesifikasjon	Hva det betyr
FDA non-device CDS	`CHARTER.md §15`	Charteret beskriver designmål; det fastslår verken regulatorisk klassifisering eller klinisk validering.
No patient data	`CHARTER.md §9.3`	`patient_plans/` og alle pasient- HTML- er blir gitignorert. Alle eksempler er syntetiske.
Levering av solvedlikeholder	`CHARTER.md §6.1`	Vedlikeholderen kontrollerer kilder og prøvinger. Ekstern klinisk gjennomgåelse er valgfritt.
No LLM clinical judgment	`CHARTER.md §8.3`	LLM-er plukker ikke behandling, skaper ikke doser, og tolker ikke biomarkører for valg av terapi.
No treatment without histology	`CHARTER.md §15.2 C7`	Motoren nekter å utarbeide en behandlingsplan uten `disease.id` or `icd_o_3_morphology` — bare en diagnoseplan.
Skjeve antiautomatisering	`CHARTER.md §15.2 C6`	≥ 2 alternative spor vises alltid side-ved-side, alternativet er aldri skjult.
Standard kildeverter = referert	`SOURCE_INGESTION_SPEC.md §1.4`	Vi kopierer ikke eksterne databaser. Vert krever uttrykkelig H1- H5- begrunnelse.
Free public resource → non-commercial	`CHARTER.md §2`	Mange lisenser (ESMO CC-BY-NC-ND, OncoKB akademisk, ATC) er avhengige av dette. Et betalt nivå ville utløse en lisensrevisjon.
Automatisk valg av IP-basert språk	`client-side, opt-out`	For å vise grensesnittet på språket ditt, ser du opp i landet ditt via en tredjepartstjeneste (GeoJSmed 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.