Specifikationer

OpenOnco är ett första projekt med specifikationer. Varje detalj om arkitektur, klinisk och styrning finns i ett dokument 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 gethub.com/romeo111/OpenOnco/specs.

Sannhetshierarki (från CLAUDE.md): När specs konflikter, bindande order är 1. CHARTER.md → 2. andra specs/*.md → 3. KLAUDE.md → 4. README.md. Allt under legacy/ inte är auktoriserat.

Aktiva specifikationer (10)

Styrelseformer CHARTER.md

Stadga och styrelseformer

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

Kliniskt CLINICAL_CONTENT_STANDARDS.md

Standarder för kliniskt innehåll

Standarder för kliniskt innehåll: citeringsformat (source_id + position + parafras + sida), evidens-nivå taksonomi (TIER 1-6), verifierings-avslöjningsarbetsflöde, STUB → reviderade övergångskriterier. Varje krav i en indikation / Regimen / RedFlag länkar till en källenhet.

Läs på GitHub → Råmarkering

Uppgifter DATA_STANDARDS.md

Datastandarder – patientmodell

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

Schema KNOWLEDGE_SCHEMA_SPECIFICATION.md

Specifikation av kunskapsschemat

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

Källor SOURCE_INGESTION_SPEC.md

Källintag och licensiering

Hur vi intar källor: värdmatrisen (referens kontra värd kontra blandad) med H1-H5-begrundning, licensklassningsportar, checklistan för tilläggs-a-källa (§8), checklista för värd-källan (§20) och SourceClientprotokollet för levande API.

Läs på GitHub → Råmarkering

Testning REFERENCE_CASE_SPECIFICATION.md

Referensfall – "Patient Zero"

Ett syntetiskt HCV-MZL-referensfall som P0-acceptanstest. Definierar alla erforderliga patientprofilfält (§2-mallar), de kritiska strukturella påståendena för Plan reproducering (§1.3) och milstolpar M1-M6 för expanderande täckning.

Läs på GitHub → Råmarkering

Motor MDT_ORCHESTRATOR_SPEC.md

MDT Orkester + beslutsprovenu

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-fas MDT (prebiopsi)

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

Kliniskt WORKUP_METHODOLOGY_SPEC.md

Arbetssätt Forskningsmetodik

Hur vi bygger upp en grundläggande arbetsplats för alla onkologiska områden. Källhierarki (Tier 1: NCCN/ESMO/EHA/BSH/WHO/ASH), Test/Arbetsfullständighet checklistor, 7-stegsprocessen för att utöka täckning till en ny domän, anti-mönster.

Läs på GitHub → Råmarkering

Motor SKILL_ARCHITECTURE_SPEC.md

Skill-orienterad arkitektur (MDT Roller som färdigheter)

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

Reglerande källa (PDF)

Regulatorisk PDF Guidance-Clinical-Decision-Software_5.pdf

FDA Kliniskt beslut Stöd för programvaruvägledning

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.

Visa PDF på GitHub →

Hur vi uppdaterar specifikationerna

Solo-projektet. En underhållare levererar uppdateringar med automatiska kontroller och källspårbarhet. Extern klinisk granskning är valfri och registreras separat.

Alla specifikationer är skrivna ukrainska-först (gränssnittet och de kliniska granskarna är UA), men tekniska villkor och licensnamn stanna på engelska inline. Versioning är via git: varje spec bär v0.1 (draft) i rubriken och stötas på mindre/stor beroende på att förändringarna bryts.

Överensstämmelse + integritet (snabb visning)

Garanti	Specifikation	Vad det betyder
FDA non-device CDS	`CHARTER.md §15`	Stadgan beskriver designmål; den fastställer varken regulatorisk klassificering eller klinisk validering.
No patient data	`CHARTER.md §9.3`	`patient_plans/` och alla patienter HTML är gitignorerade. Alla exempel är syntetiska.
Leverans av solo- underhållare	`CHARTER.md §6.1`	Utvecklare kontrollerar källor och tester; extern klinisk granskning är valfri.
No LLM clinical judgment	`CHARTER.md §8.3`	LLMs väljer inte regimer, inte generera doser, och tolkar inte biomarkörer för val av behandling.
No treatment without histology	`CHARTER.md §15.2 C7`	Motorn vägrar att generera en behandlingsplan utan `disease.id` or `icd_o_3_morphology` – endast en diagnosplan.
Antiautomation-bias	`CHARTER.md §15.2 C6`	≥2 alternativa spår visas alltid sida vid sida, alternativet är aldrig dold.
Källvärdighetsstandard = refererad	`SOURCE_INGESTION_SPEC.md §1.4`	Vi duplicerar inte externa databaser; hosting kräver uttrycklig H1-H5-berättigelse.
Fria offentliga resurser → icke-kommersiella	`CHARTER.md §2`	Många licenser (ESMO CC-BY-NC-ND, OncokB akademiker, ATC) är beroende av detta. Ett betalat nivå skulle utlösa en licensrevision.
automatisk val av IP-baserat språk	`client-side, opt-out`	För att visa gränssnittet på ditt språk, din webbläsare upp ditt land från din IP via en tredjepartstjänst (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.