NORMAS GOST v1.0.0-draft // OPEN SOURCE

Orquestrador Declarativo de Documentos & Heredogramas Clínicos

Transforme Markdown declarativo em PDFs acadêmicos vetoriais estritamente formatados conforme a ABNT NBR 14724, com renderização de heredogramas clínicos (NSGC) e diagramas multi-engine integrados.

🌲

Heredogramas Clínicos (NSGC)

Geração automatizada de heredogramas genéticos no padrão internacional da National Society of Genetic Counselors via motor de cálculo e plotagem R (kinship2).

⚡

Tipografia Vetorial com Typst

Diagramação moderna de alta performance com templates ABNT NBR 14724 e suporte a perfis bibliográficos CSL (ABNT e Vancouver).

📊

Diagramas Declarativos (Kroki)

Suporte transparente a blocos Mermaid, PlantUML, Graphviz e Vega-Lite através da integração isolada com o gateway Kroki.

🛡️

Hermeticidade e Padrão GOST

Ambiente conteinerizado multi-stage OCI rodando com usuário não privilegiado e suíte de testes com cobertura superior a 90%.

🚀 Inicialização Rápida no Ambiente Local

O Joaju provê interfaces prontas para o fluxo de trabalho integrado com o cccp:

Terminal (Bash)
# 1. Iniciar servidor com recarga contínua (hot watcher):
cccp serve --dev
# ou: npm run dev

# 2. Executar demonstração com dados semeados (Exposição VDNKh):
cccp serve --demo
# ou: npm run demo

# 3. Executar suíte completa de testes unitários e de cobertura:
npm test
npm run test:coverage

🧬 Sintaxe Declarativa de Heredograma

Escreva dados genealógicos tabulares simples diretamente em blocos de código com diretivas visuais:

Markdown (Heredograma Clínico)
```heredograma
%% layout.width=90% layout.max_width=550pt cex=0.85
id,pai,mae,sex,fenotipo,label
1,0,0,M,wt,I.1 (Avô)
2,0,0,F,wt,I.2 (Avó)
3,1,2,M,het,II.1 (Pai Portador)
4,0,0,F,wt,II.2 (Mãe Não-Afetada)
5,3,4,F,hom,III.1 (Probanda Afetada)
6,3,4,M,wt,III.2 (Irmão Hígido)
```

📡 Referência da API Local

GET /health

Sonda de integridade operacional retornando status: "ok", versão atual e tempo de atividade.

POST /render

Renderização rápida de fragmentos declarativos (heredograma ou Mermaid) devolvendo SVG vetorial para visualização interativa instantânea.

POST /compile

Pipeline completo de compilação: pré-processa diagramas, executa filtros Pandoc e compila o documento ABNT final em PDF vetorial de alta resolução.