Esta página é o reflexo conceitual do repositório GitHub Diagnosis.

A ideia não é copiar o código linha por linha. É funcionar como um mapa humano do sistema: cada área explica para que serve, o que entra e o que sai, e como ela se conecta às demais.

Como navegar

As páginas abaixo representam os principais blocos do repositório. Abra uma delas para entender sua função e depois siga as conexões entre os blocos.

• AI — regras, contratos e protocolos de inteligência/pesquisa.
• Js — o código executável e os motores do Diagnosys.
• knowledge_base — conhecimento estruturado usado pelo sistema.
• medical_library — biblioteca clínica utilizada na construção dos casos.
• catalogs — catálogos e registros auxiliares.
• WIKI — documentação interna.
• tests — validações e experimentos.
• Drafts-and-Draws — rascunhos, diagramas e material visual de construção.

Mapa de alto nível

                         DIAGNOSYS
                             │
                    ┌────────┴────────┐
                    │                 │
              PREPARAÇÃO          EXECUÇÃO
                    │                 │
          ┌─────────┴─────────┐       │
          │                   │       │
   Catálogo clínico      Pesquisa      │
   jogável               MSD/PCDT      │
          │                   │        │
          └─────────┬─────────┘        │
                    ▼                  │
               CaseBuilder             │
                    │                  │
                    ▼                  │
          Clinical Case Model         │
                    │                  │
          ┌─────────┴─────────┐        │
          ▼                   ▼        │
     verdade interna     exames        │
     do paciente         pré-prontos   │
          └─────────┬─────────┘        │
                    ▼                  │
               Engine clínico ◄────────┘
                    │
          ┌─────────┼──────────┐
          ▼         ▼          ▼
       história   exames    tratamento
                    │
                    ▼
              hipótese / fim
                    │
                    ▼
                 avaliação

Base Científica ──► Gemini Provider ──► Worker ──► Gemini API
                         │
                         └── camada externa; não é a verdade clínica

Princípio estrutural

O caso clínico é construído antes da conversa. O médico investiga uma realidade interna já definida pelo sistema. A IA externa pode pesquisar e sintetizar conhecimento, mas não deve substituir a verdade do paciente nem o motor clínico.

Reflexo do GitHub

A organização desta Wiki acompanha os grandes blocos atualmente presentes no repositório. Quando a arquitetura mudar, esta Wiki deve ser atualizada junto com ela.

Regra de ouro: código explica como o sistema funciona; esta Wiki explica por que cada peça existe e como as peças conversam entre si.

📁 AI — Inteligência e contratos