Eritelmät
OpenOnco on ensimmäinen spesifikaatioprojekti, jonka jokainen arkkitehtoninen, kliininen ja hallintoon liittyvä yksityiskohta on merkitty markdown-asiakirjaan alla. 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/spekts.
specs/*.md → 3. CLAUDE.md → 4. LUEME.Md. Kaikki alla legacy/ ei ole arvovaltainen.
Aktiiviset vaatimukset (10)
CHARTER.md
Peruskirja ja hallintotapa
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).
CLINICAL_CONTENT_STANDARDS.md
Kliinistä sisältöä koskevat vaatimukset
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.
DATA_STANDARDS.md
Tietostandardit – potilasmalli
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.
KNOWLEDGE_SCHEMA_SPECIFICATION.md
Tietohermoston erittely
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.
SOURCE_INGESTION_SPEC.md
Lähdesyöminen ja lisenssit
Miten syömme lähteitä: hosting-matriisi (viittaus vs. isäntä vs yhdistelmä) H1-H5-perustelulla, lisenssien luokitteluporteilla, lisälähdeluettelolla (kohta 8), isännöidyllä lähdeluettelolla (20 kohta) ja SourceClient-protokollalla live-API-rajapintoja varten.
REFERENCE_CASE_SPECIFICATION.md
Viitetapaus – "Patient Zero"
Synteettinen HCV-MZL-viitetapaus P0-hyväksymistestinä. Määrittelee kaikki potilasprofiilin vaatimukset (perustiedot 2 §), kriittiset rakenteelliset väitteet Plan render -lähtöön (kohta 1.3) ja virstanpylväät M1-M6 kattavuuden laajentamiseksi.
MDT_ORCHESTRATOR_SPEC.md
MDT Orkesteri + päätöstodistus
Orchestrate_mdt-säännöt (R1-R9 hoitoon, D1-D6 diagnostiikkaan), roolin aktivointilogiikka (vaaditaan / suositellaan / annetaan valinnaisia), Open Questions -mekanismi (Q1-Q6 + DQ1-DQ4 – moottori kieltäytyy päättämästä ilman vaadittuja tietoja) ja päätös-todentamiskaavio tilintarkastusluokan selitykseksi.
DIAGNOSTIC_MDT_SPEC.md
Diagnostinen vaihe MDT (ennen biopsiaa)
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.
WORKUP_METHODOLOGY_SPEC.md
Työtutkimusmetodit
Miten rakennamme perustutkimuksen kaikille onkologia-alueille. Lähdehierarkia (Tier 1: NCCN/ESMO/EHA/BSH/WHO/ASH), Test/Workup-täyttötarkistukset, 7-vaiheinen prosessi, jolla kattavuus ulotetaan uudelle alueelle, mallinvastaiset.
SKILL_ARCHITECTURE_SPEC.md
Osaamislähtöinen arkkitehtuuri (MDT Roolit taidoina)
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.
Sääntelylähde (PDF)
Guidance-Clinical-Decision-Software_5.pdf
FDA:n kliinisen päätöksen tukiohjelmistojen ohjeistus
FDA:n virallinen ohjeistus, joka koskee luottoriskinvaihtosopimusten luokittelua muihin kuin laitteisiin 520 artiklan 1 kohdan E alakohdan mukaisesti. specs/ as a PDF. CHARTER §15 cites concrete criteria 1-4 from this document to justify OpenOnco's non-device positioning.
Miten päivitämme spesifikaatiot
Yksi ylläpitäjistä toimittaa päivityksiä automaattisella tarkastuksella ja lähteen jäljityksellä. Ulkoinen kliininen arviointi on valinnainen ja se kirjataan erikseen.
Kaikki tiedot on kirjoitettu ukrainalaisesti (rajapinta ja kliiniset arvioijat ovat UA), mutta tekniset termit ja lisenssinimet pysyvät englanninkielisinä. Versiointi on kautta git: every spec cards v0.1 (draft) Otsikkoon ja se on törmätty pieniin/suuriin, riippuen murroksesta.
Noudattaminen + yksityisyys (nopea näkymä)
| Takaus | Eritelmä | Mitä se tarkoittaa |
|---|---|---|
| FDA:n muut kuin laitteet | CHARTER.md §15 |
Peruskirja kuvaa suunnittelutavoitteita; se ei vahvista sääntelyluokitusta eikä kliinistä validointia. |
| Ei potilastietoja | CHARTER.md §9.3 |
patient_plans/ Kaikki potilasHTML-tuotteet ovat synteettisiä. |
| Yksinhuoltajan toimitus | CHARTER.md §6.1 |
Ylläpitäjä tarkistaa lähteet ja testit, ulkoinen kliininen arviointi on valinnainen. |
| Ei LLM:n kliinistä arviointia | CHARTER.md §8.3 |
LLMs do not pick regimens, do not generate doses, and do not interpret biomarkers for therapy selection. |
| Ei hoitoa ilman histologiaa | CHARTER.md §15.2 C7 |
Moottori kieltäytyy laatimasta hoitosuunnitelmaa ilman disease.id or icd_o_3_morphology – vain diagnostinen suunnitelma. |
| Automatisaation vastaiset hyökkäykset | CHARTER.md §15.2 C6 |
≥ 2 vaihtoehtoista rataa näytetään aina vierekkäin; vaihtoehto ei koskaan ole piilossa. |
| Lähdekoodin oletus = viite | SOURCE_INGESTION_SPEC.md §1.4 |
We do not duplicate external databases; hosting requires explicit H1-H5 justification. |
| Free public resource → non-commercial | CHARTER.md §2 |
Monet lisenssit (ESMO CC-BY-NC-ND, OncoKB-akateeminen, ATC) ovat riippuvaisia tästä. Maksava taso käynnistäisi lisenssitarkastuksen. |
| IP-pohjainen kieli automaattisesti valittuna | client-side, opt-out |
Näyttääkseen rajapinnan omalla kielelläsi selaimesi etsii maasi Internetistä kolmannen osapuolen palvelun kautta (GeoJS, 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. |