Especificações

OpenOnco é um projeto de especificações-primeiro. Cada detalhe arquitetônico, clínico e de governança é preso em um documento de marcação abaixo 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.

Gerarquia da fonte da verdade (de CLAUDE.md): quando especifica em conflito, a ordem vinculativa é 1. CARTA.md → 2. Outros specs/*.md → 3. CLAUDE.md → 4. README.MD. Qualquer coisa abaixo legacy/ Não é autoritário.

Especificações ativas (10)

Governação CHARTER.md

Carta e Governação

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

Ler em GitHub → Ponto de redução bruto

Clínica CLINICAL_CONTENT_STANDARDS.md

Padrões de Conteúdo Clínico

Padrões de conteúdo clínico: formato de citação (source_id + posição + parafrase + página), taxonomia de nível de evidência (Tier 1-6), fluxo de trabalho de aprovação do revisor, STUB → reviu critérios de transição. Cada reivindicação em uma Indicação / Regime / RedFlag links para uma entidade Fonte.

Ler em GitHub → Ponto de redução bruto

Dados DATA_STANDARDS.md

Padrões de dados — Modelo de paciente

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.

Ler em GitHub → Ponto de redução bruto

Esquema KNOWLEDGE_SCHEMA_SPECIFICATION.md

Especificação do esquema de conhecimento

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.

Ler em GitHub → Ponto de redução bruto

Fontes SOURCE_INGESTION_SPEC.md

Ingestão e Licença de Fonte

Como ingerimos fontes: a matriz de hospedagem (referido vs hosted vs mixed) com justificação H1-H5, portões de classificação de licença, a checklist add-a-source (§8), a Checklist hosped-source(§20) e o protocolo SourceClient para APIs ao vivo.

Ler em GitHub → Ponto de redução bruto

Teste REFERENCE_CASE_SPECIFICATION.md

Caso de referência — "Paciente Zero"

Um caso de referência sintético VHC-MZL como o teste de aceitação P0. Define cada campo necessário para perfil de paciente (§2 modelos), as asserções estruturais críticas para a saída do render do Plano (§1.3), e marcos M1-M6 para a expansão da cobertura.

Ler em GitHub → Ponto de redução bruto

Motor MDT_ORCHESTRATOR_SPEC.md

Orquestrador MDT + Procedência da decisão

Regras Orchestrate_mdt (R1-R9 para tratamento, D1-D6 para diagnóstico), lógica de ativação de funções (requerida / recomendada / opcional), mecanismo de perguntas abertas (Q1-Q6 + DQ1 - DQ4 — o motor se recusa a decidir sem os dados necessários), e um gráfico de prova de decisão para a explicação do grau de auditoria.

Ler em GitHub → Ponto de redução bruto

Motor DIAGNOSTIC_MDT_SPEC.md

MDT de fase diagnóstica (pré-biopsia)

Modo pré-biopsia: quando a histologia ainda não está disponível, o motor emite um DiagnosticPlan com um breve de workup em vez de um plano de tratamento. CARTER §15.2 Regra dura C7. DiagnosticoWorkup + DiagnostPlan esquemas, generate_diagnostic_brief(), polimórfico orchestrate_mdt com regras DQ1-DQ4.

Ler em GitHub → Ponto de redução bruto

Clínica WORKUP_METHODOLOGY_SPEC.md

Metodologia de Pesquisa de Trabalho

Como nós construimos um trabalho básico para qualquer área de oncologia. Gerarquia de fonte (Nível 1: NCCN/ESMO/EHA/BSH/WHO/ASH), Teste/Workup completality checklists, o processo de 7-pass para ampliar a cobertura para um novo domínio, anti-patterns.

Ler em GitHub → Ponto de redução bruto

Motor SKILL_ARCHITECTURE_SPEC.md

Arquitetura orientada para a competência (Funções de MDT como competências)

Formaliza papéis de MDT (hematologista/patologista / radiologista/ etc.) como habilidades clinicamente verificadas — cada habilidade carrega versão, fontes, last_reviewed, clinical_lead. Horizonte de dimensionamento (~12-15 MVP → 50-60 abrangente), layout de 8 domínios, plano de refator de 5 fases.

Ler em GitHub → Ponto de redução bruto

Fonte regulamentar (PDF)

PDF regulamentar Guidance-Clinical-Decision-Software_5.pdf

FDA Orientação de Software de Suporte à Decisão Clínica

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.

Ver PDF no GitHub →

Como atualizamos as especificações

Projeto individual. Uma pessoa responsável publica as atualizações com verificações automáticas e rastreabilidade das fontes. A revisão clínica externa é opcional e registada separadamente.

Todas as especificações são escritas ucraniano-primeiro (a interface e os revisores clínicos são UA), mas termos técnicos e nomes de licença permanecem em inglês inline. v0.1 (draft) no cabeçalho e é chocado em menor/maio, dependendo de quebras de mudanças.

Conformidade + privacidade (visualização rápida)

Garantia	Especificação	O que significa
FDA non-device CDS	`CHARTER.md §15`	A Carta descreve objetivos de conceção; não estabelece uma classificação regulamentar nem uma validação clínica.
Não existem dados sobre o doente	`CHARTER.md §9.3`	`patient_plans/` e qualquer paciente HTML é gitignored. Todos os exemplos são sintéticos.
Solo maintainer delivery	`CHARTER.md §6.1`	The maintainer verifies sources and tests; external clinical review is optional.
Sem julgamento clínico LLM	`CHARTER.md §8.3`	Os LLMs não escolhem regimes, não geram doses e não interpretam biomarcadores para seleção terapêutica.
Não há tratamento sem histologia	`CHARTER.md §15.2 C7`	O motor se recusa a gerar um plano de tratamento sem `disease.id` or `icd_o_3_morphology` — apenas um plano diagnóstico.
Antiautomação-bias	`CHARTER.md §15.2 C6`	≥2 pistas alternativas são sempre apresentadas lado a lado; a alternativa nunca é oculta.
O hospedagem de fonte é padrão = referência	`SOURCE_INGESTION_SPEC.md §1.4`	Não duplicamos bases de dados externas; hospedagem requer justificação explícita H1-H5.
Free public resource → non-commercial	`CHARTER.md §2`	Muitas licenças (ESMO CC-BY-NC-ND, OncoKB academic, ATC) dependem disso. Um nível pago iria desencadear uma auditoria de licenças.
Selecione automaticamente a linguagem baseada em IP	`client-side, opt-out`	Para mostrar a interface em seu idioma, seu navegador procura o seu país a partir do seu IP através de um serviço de terceiros (GeoJS, com 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.