Spécifications

OpenOnco est un projet de spécifications-première. Chaque détail architectural, clinique et de gouvernance est coincé dans un document de démarcation sous 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 gythub.com/romeo111/OpenOnco/specs.

Hiérarchie de la source de la vérité (de CLAUDE.md): lorsque les spécifications sont en conflit, l'ordre contraignant est 1. CHARTER.md → 2. autres specs/*.md → 3. CLAUDE.md → 4. README.md. Tout ce qui est sous legacy/ - Il n'est pas autorisé.

Caractéristiques actives (10)

Gouvernance CHARTER.md

Charte et gouvernance

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

Lire sur GitHub → Démarrage brut

Clinique CLINICAL_CONTENT_STANDARDS.md

Normes cliniques de teneur

Normes de contenu clinique : format de citation (source_id + position + paraphrase + page), taxonomie au niveau des preuves (Niveau 1-6), flux de travail d'approbation des examinateurs, STUB → Critères de transition examinés. Chaque revendication dans une indication / Régime / RedFlag liens vers une entité Source.

Lire sur GitHub → Démarrage brut

Données DATA_STANDARDS.md

Normes de données — Modèle de patient

Modèle de données de profil du patient. Alignement FHIR R4/R5 + mCODE sur la feuille de route. Systèmes de code: LOINC + ICD-10/O-3 + RxNorm + CTCAE v5.0. Pas de CT SNOMED et pas de MedDRA dans le MVP (portes de licence). Champs de profil et interopérabilité sémantique.

Lire sur GitHub → Démarrage brut

Schéma KNOWLEDGE_SCHEMA_SPECIFICATION.md

Spécification du schéma des connaissances

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.

Lire sur GitHub → Démarrage brut

Sources SOURCE_INGESTION_SPEC.md

Ingestion et agrément de source

Comment nous ingérer des sources : la matrice d'hébergement (référencée vs hébergée vs mixte) avec la justification H1-H5, les portes de classification de licence, la liste de contrôle add-a-source (§8), la Liste de contrôle hosted-sources (§20) et le protocole SourceClient pour les API en direct.

Lire sur GitHub → Démarrage brut

Essai REFERENCE_CASE_SPECIFICATION.md

Cas de référence — "Patient zéro"

Un cas synthétique de référence VHC-MZL comme le test d'acceptation P0. Définit chaque champ requis du profil patient (modèles §2), les affirmations structurelles critiques pour le rendement de rendu Plan (§1.3), et des jalons M1-M6 pour l'élargissement de la couverture.

Lire sur GitHub → Démarrage brut

Moteur MDT_ORCHESTRATOR_SPEC.md

Orchestrateur MDT + Provenance de la décision

Règles Orchestrate_mdt (R1-R9 pour le traitement, D1-D6 pour le diagnostic), logique d'activation des rôles (requis / recommandé / optionnel), mécanisme de questions ouvertes (Q1-Q6 + DQ1 - DQ4 — le moteur refuse de décider sans les données requises), et un graphique de preuve de décision pour l'explication de niveau audit.

Lire sur GitHub → Démarrage brut

Moteur DIAGNOSTIC_MDT_SPEC.md

TDM diagnostique (prébiopsie)

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.

Lire sur GitHub → Démarrage brut

Clinique WORKUP_METHODOLOGY_SPEC.md

Méthodologie de la recherche d'étude

La hiérarchie des sources (Niveau 1: NCCN/ESMO/EHA/BSH/WHO/ASH), les listes de contrôle d'exhaustivité des tests/travaux, le processus en 7 étapes pour étendre la couverture à un nouveau domaine, les anti-paroles.

Lire sur GitHub → Démarrage brut

Moteur SKILL_ARCHITECTURE_SPEC.md

Architecture axée sur les compétences (Rôles de la TDM comme compétences)

Formalise les rôles de MDT (hématologue / pathologiste / radiologue / etc.) comme compétences cliniquement vérifiées — chaque compétence comporte version, sources, last_reviewed, clinical_lead. horizon de dimensionnement (~12-15 MVP → 50-60 complet), 8-domaines, plan de refacteurs en 5 phases.

Lire sur GitHub → Démarrage brut

Source réglementaire (PDF)

PDF réglementaire Guidance-Clinical-Decision-Software_5.pdf

Guide du logiciel de soutien aux décisions cliniques de la FDA

Les directives officielles de la FDA sur la classification des CDS non-dispositifs sous le § 520(o)(1)(E). specs/ en format PDF. Le §15 du CHARTE cite des critères concrets 1-4 de ce document pour justifier le positionnement d'OpenOnco.

Voir le PDF sur GitHub →

Comment nous mettons à jour les spécifications

Projet individuel. Une personne responsable publie les mises à jour avec des contrôles automatisés et des sources traçables. La relecture clinique externe est facultative et consignée séparément.

Toutes les spécifications sont écrites Ukrainien-Premier (l'interface et les examinateurs cliniques sont UA), mais les termes techniques et les noms de licence restent en ligne en anglais. v0.1 (draft) dans l'en-tête et est bossée sur mineur/majeur selon les changements de rupture.

Conformité + confidentialité (vue rapide)

Garantie	Spécification	Ce que ça veut dire
FDA non-dispositif CDS	`CHARTER.md §15`	La Charte décrit des objectifs de conception ; elle ne détermine ni une classification réglementaire ni une validation clinique.
No patient data	`CHARTER.md §9.3`	`patient_plans/` et tout patient HTML sont gitignoré. Tous les exemples sont synthétiques.
Solo maintainer delivery	`CHARTER.md §6.1`	The maintainer verifies sources and tests; external clinical review is optional.
No LLM clinical judgment	`CHARTER.md §8.3`	Les LLM ne choisissent pas de schémas thérapeutiques, ne génèrent pas de doses et n'interprètent pas les biomarqueurs pour la sélection du traitement.
No treatment without histology	`CHARTER.md §15.2 C7`	Le moteur refuse de générer un plan de traitement sans `disease.id` or `icd_o_3_morphology` — un seul plan diagnostique.
Antiautomatisation-bias	`CHARTER.md §15.2 C6`	≥2 pistes alternatives sont toujours affichées côte à côte; l'alternative n'est jamais cachée.
Hébergement source par défaut = référenced	`SOURCE_INGESTION_SPEC.md §1.4`	Nous ne reproduisons pas les bases de données externes; l'hébergement nécessite une justification explicite H1-H5.
Ressources publiques gratuites → non commerciales	`CHARTER.md §2`	De nombreuses licences (ESMO CC-BY-NC-ND, OncoKB académique, ATC) en dépendent. Un niveau payé déclencherait une vérification des licences.
Auto-sélection de langue IP	`client-side, opt-out`	Pour afficher l'interface dans votre langue, votre navigateur recherche votre pays depuis votre IP via un service tiers (GéoJS, avec 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.