# Manual de Utilização da Superplataforma
## Atlas Inteligente do Corpo Humano & Estação Radiológica 3D Multiplanar

**Cylinder Biomedical Systems & Clinical Care**  
*Documento de Referência Técnica e Operacional • Versão 2.5.0*  
*Conferência Internacional:* **Nursing & Inclusive Care 2026** (23 a 29 de novembro de 2026)

---

> [!IMPORTANT]
> **Aviso Legal & Isenção de Responsabilidade Médica (Medical Disclaimer):**  
> *Ferramenta estritamente informacional, educacional e de catálogo baseada no Visible Human Project (NIH), sem substituir o diagnóstico ou julgamento clínico profissional.*  
> Todas as correlações anatómicas, reconstruções volumétricas tridimensionais, traçados eletrocardiográficos e simulações fisiológicas contidas nesta plataforma destinam-se exclusivamente à capacitação técnica, literacia em saúde e ensino universitário.

---

## 1. Visão Geral e Arquitetura do Ecossistema

O **Atlas Inteligente do Corpo Humano** é uma superplataforma biomédica de visualização anatómica, simulação fisiológica e correlação imagiológica desenvolvida segundo o paradigma **Zero-DB** (*Zero-Database Architecture*). 

### 1.1 Características de Engenharia
- **Autonomia 100% Offline-First:** Toda a base de conhecimento ontológico (26 órgãos, 10 sistemas, 174 fatias e referências imagiológicas) reside em ficheiros estáticos de alta densidade (`data/anatomia_completa.json` e `data/anatomia_data.js`), sem necessidade de bases de dados relacionais, servidores SQL ou chamadas a APIs na nuvem.
- **Visualização Radiológica Multiplanar (MPR):** Motor próprio baseado no **Kitware VTK.js** e na especificação **WebGL 2.0**, permitindo fatiamento ortogonal síncrono nos eixos Axial, Sagital e Coronal a 60 FPS com renderização volumétrica 3D contínua.
- **Síntese Sonora Procedural sem Latência:** Motor bioacústico com a **Web Audio API** que sintetiza proceduralmente batimentos valvulares cardíacos (B1 e B2 com estalidos mecânicos), murmúrio vesicular respiratório e ruídos hidroaéreos intestinais (borborigmos) sem recorrer a ficheiros de áudio pesados.
- **Portabilidade Extrema:** Executável diretamente em qualquer computador pessoal, tablet hospitalar ou estação PACS através de qualquer navegador web moderno (Edge, Chrome, Firefox, Safari).

---

## 2. Inicialização e Modos de Execução

A plataforma pode ser executada localmente em computadores pessoais ou através de servidores estáticos na nuvem (ex.: Vercel).

### 2.1 Modo Servidor Local (Recomendado para Treino e Formação)
Para tirar partido de todas as funcionalidades de aceleração WebGL, descompressão de fatias de alta resolução e ausência de restrições de segurança do navegador, inicie o servidor local otimizado:

1. Abra a linha de comandos ou terminal na pasta do projeto:
   ```bash
   cd Atlas-inteligente-Corpo-Humano-main
   ```
2. Instale as dependências (caso seja a primeira execução):
   ```bash
   npm install
   ```
3. Inicie o servidor estático de alta performance:
   ```bash
   npm start
   ```
   *(ou `npm run dev`)*
4. Abra o navegador web no endereço indicado:
   ```text
   http://localhost:3000
   ```

O servidor local injeta automaticamente os cabeçalhos permissivos `Access-Control-Allow-Origin: *` e mapeia com rigor os tipos MIME de buffers binários (`.vti`, `.bin`, `.json`, `.png`, `.wav`).

### 2.2 Modo de Execução Direta via Duplo-Clique (`file://`)
Se abrir diretamente o ficheiro `index.html` ou `laboratorio-3d/index.html` a partir do explorador de ficheiros do Windows, o sistema ativa automaticamente um módulo de segurança preventivo:
- Um banner informativo dourado surge no topo:  
  *«Aviso de Execução Local (file://): Para evitar restrições de CORS do navegador no carregamento dos buffers 3D do VTK.js e fatias do Visible Human, execute npm start»*.
- Os catálogos 2D, as fichas clínicas de enfermagem, o sintetizador acústico e as simulações funcionam a 100% mesmo neste modo direto.

### 2.3 Modo Nuvem (Vercel)
A plataforma inclui um script de compilação estática (`build-root.cjs`) que sintetiza todo o ecossistema na pasta `dist/` pronta para implantação autónoma:
```bash
npm run build
```

---

## 3. Guia de Operação da Estação Radiológica 3D (PACS / VTK.js)

A Estação Radiológica Multiplanar pode ser acedida a partir do botão superior **«Estação 3D (VTK.js) ↗»** ou diretamente no URL `/laboratorio-3d/`.

```
+-----------------------------------------------------------------------------------------+
| [Header PACS] Barra de Ferramentas: Modalidade | Preset Janelamento | Órgão | Vistas     |
+-----------------------------------------------------------------------------------------+
| [Vista Axial (Z)]               | [Vista Sagital (X)]                                    |
| - Fatias craniocaudais          | - Reconstrução lateral síncrona                        |
| - Cursor em cruz (Crosshair)    | - Marcador de profundidade                             |
+-----------------------------------------------------------------------------------------+
| [Vista Coronal (Y)]             | [Volume 3D WebGL VTK.js]                               |
| - Reconstrução anteroposterior  | - Órbita 3D livre com rato                             |
| - Projeção ortogonal            | - Ajuste de opacidade: osso, vísceras, pele            |
+-----------------------------------------------------------------------------------------+
| [HUD PACS] Z=1674mm (Tórax) | Voxel: 0.33×0.33×1.0mm | Janelamento W:400 / L:40          |
+-----------------------------------------------------------------------------------------+
```

### 3.1 Comandos de Navegação e Interação
- **Navegação Craniocaudal no Eixo Z:**  
  Rode a **roda do rato** sobre a janela axial ou arraste o slider inferior para percorrer as fatias anatómicas desde a abóbada craniana até aos membros inferiores.
- **Reposicionamento Ortogonal (Crosshairs):**  
  Clique com o **botão esquerdo do rato** em qualquer estrutura visível no corte axial para mover o centro da mira. As vistas sagital e coronal reconstroem-se instantaneamente para cruzar a estrutura anatómica selecionada.
- **Janelamento Radiológico Dinâmico (Window Width / Window Level):**  
  Clique com o **botão direito do rato** (ou prima **Shift + Botão Esquerdo**) e arraste:
  - *Mover horizontalmente:* Altera o contraste (Window Width).
  - *Mover verticalmente:* Altera o brilho médio (Window Level).
- **Presets de Janelamento Predefinidos:**  
  No seletor superior, escolha entre:
  - `Tecidos Moles / Vísceras` (W: 400 / L: 40)
  - `Esqueleto / Osso` (W: 1800 / L: 400)
  - `Parênquima Pulmonar` (W: 1500 / L: -600)
  - `RMN Contraste Padrão` (W: 600 / L: 300)
  - `Crioseção Real a Cores` (W: 255 / L: 128)
- **Manipulação Tridimensional do Volume (VTK.js):**  
  Na janela inferior direita, arraste o cursor para rodar a órbita 3D. Na barra lateral direita (aba *Definições VTK*), utilize os potenciómetros para dosear a opacidade das estruturas ósseas, tecidos moles e contorno cutâneo.

---

## 4. Exploração Anatómica e Dossiers dos 26 Órgãos

O catálogo anatómico na aba principal **«🧬 Anatomia & Sistemas»** disponibiliza 26 órgãos completamente indexados.

### 4.1 Órgãos Catalogados
1. **Encéfalo e Sistema Nervoso:** Cérebro, Cerebelo, Tronco Encefálico, Medula Espinhal.
2. **Órgãos dos Sentidos e Endócrino:** Olhos, Glândula Tiroide.
3. **Cardiovascular e Linfático:** Coração, Grandes Vasos Arteriais e Venosos, Baço.
4. **Respiratório:** Pulmões, Traqueia e Brónquios, Diafragma.
5. **Digestivo:** Fígado, Estômago, Pâncreas, Intestino Delgado, Intestino Grosso.
6. **Urinário:** Rins, Bexiga Urinária.
7. **Tegumentar e Locomotor:** Pele, Esqueleto Humano, Sistema Muscular.
8. **Reprodutor (Totalmente Integrado):** Útero e Trompas Uterinas, Ovários, Testículos e Epidídimo, Próstata e Vesículas Seminais.

### 4.2 Fichas Clínicas Individuais em `/fichas/`
Cada órgão possui uma ficha clínica detalhada que pode ser consultada no botão **«Ver Ficha Completa →»** ou impressa em papel:
- **Identificação e Ontologia:** Nome em português europeu, nome em latim, código FMA (*Foundational Model of Anatomy*) e identificador BodyParts3D.
- **Fisiologia & Biomarcadores:** Débito de perfusão tecidual, consumo basal de oxigénio ($VO_2$), pressões e tabela de valores laboratoriais de referência com significado clínico.
- **Avaliação de Enfermagem:** Intervenções prioritárias e 3 sinais de alarme críticos (*Red Flags*).
- **Cuidados Inclusivos no Ciclo de Vida:** Protocolos específicos para Pediatria, Geriatria, Doente Crítico (UCI) e Comunicação Adaptada.
- **Desafio Clínico Interativo:** Cenário de treino simulado com indicação do corte milimétrico no Visible Human e conduta esperada.

---

## 5. Módulo de Auscultação Estetoscópica ("Toque, Escute & Confira")

Na aba **«🩺 Toque, Escute & Confira»**, a plataforma oferece uma estação interativa de treino bioacústico:

1. **Seleção de Focos Anatómicos:**  
   Clique nos marcadores pulsantes posicionados sobre o manequim torácico e abdominal:
   - *Foco Mitral (Ápex Cardíaco):* B1 muito nítido e vigoroso com encerramento das cúspides mitral e tricúspide.
   - *Foco Aórtico (2º Espaço Intercostal Direito):* B2 estalante de encerramento das válvulas aórtica e pulmonar.
   - *Campo Pulmonar:* Murmúrio vesicular suave gerado pelo fluxo de ar nos alvéolos.
   - *Triângulo Carotídeo:* Sopro arterial expansivo da onda de pulso sístólica.
   - *Quadrante Abdominal:* Borborigmos irregulares do trânsito de quimo e gás.
2. **Visualizador Bioacústico:** O osciloscópio superior desenha em tempo real as componentes harmónicas do som reproduzido.
3. **Questionários Formativos:** Responda ao desafio interativo apresentado para consolidar o raciocínio diagnóstico de auscultação.

---

## 6. Simulador Homeostático e Monitor ECG Contínuo

Na aba **«🧪 Simulador Fisiológico»**, o utilizador pode alternar entre cenários patológicos e observar as respostas homeostáticas em cascata:
- **Cenários Disponíveis:** Repouso Basal, Exercício Intenso, Choque Hipovolémico, Insuficiência Cardíaca Descompensada e Sépsis Grave.
- **Parâmetros Monitorizados:** Frequência Cardíaca (bpm), Pressão Arterial Sistólica/Diastólica (mmHg), Débito Cardíaco (L/min), Saturação Periférica de Oxigénio ($SpO_2$) e Temperatura Corporal.
- **Monitor ECG Dinâmico:** Traçado eletrocardiográfico vetorial renderizado continuamente a 60 FPS com morfologia de onda P, complexo QRS e onda T condizentes com o estado hemodinâmico ativo.

---

## 7. Requisitos de Sistema & Resolução de Dúvidas Técnicas

- **Navegadores Recomendados:** Google Chrome (v110+), Microsoft Edge (v110+), Mozilla Firefox (v115+), Apple Safari (v16+).
- **Aceleração Gráfica:** Recomenda-se placa gráfica com suporte para WebGL 2.0 ativado nas definições do navegador.
- **Áudio no Navegador:** Se não ouvir som imediatamente ao abrir a aba de auscultação, dê um clique em qualquer ponto da página para desbloquear a política de autoplay do navegador.

---
*© 2026 Cylinder Biomedical Systems & Clinical Care • Desenvolvido para a Conferência Internacional Nursing & Inclusive Care 2026.*