> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.medemerge.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Como o coletor funciona
> O agente que lê o banco do hospital e envia o resultado para a plataforma, sem VPN e sem porta de entrada.
O coletor é um processo leve que roda **dentro da rede do hospital**. Ele se conecta ao banco de dados, executa as consultas de coleta e envia o resultado para a plataforma por HTTPS.
```mermaid theme={null}
flowchart LR
A[Banco do hospital] -->|leitura| B[Coletor]
B -->|HTTPS de saída, porta 443| C[api.medemerge.com.br]
```
Toda conexão parte do coletor para fora. O hospital não abre nenhuma porta de entrada, não configura VPN e não dá à MedEmerge acesso à máquina.
## O que fica no hospital, e o que vem do servidor
Na máquina do hospital fica apenas a **identidade do agente**: dois valores, `public_id` e `agent_secret`, num arquivo `credentials.yaml`.
Todo o resto chega do servidor a cada minuto:
* quais consultas rodar, e com que frequência;
* o endereço e o usuário do banco;
* a senha do banco, que o coletor guarda só em memória.
Por isso, mudar o que é coletado, ajustar um intervalo ou trocar a senha do usuário de leitura **não exige mexer na instalação**. A MedEmerge faz a mudança na plataforma, e o coletor a aplica no ciclo seguinte.
## Dois ciclos de coleta
| Ciclo | Frequência padrão | Para quê |
| - | - | - |
| **Tempo real** | a cada 1 minuto | O que muda durante o plantão: fila de espera, ocupação de leitos, pacientes em atendimento |
| **Lote** | uma vez por dia | O histórico completo: atendimentos, internações, cirurgias |
As frequências são combinadas com cada organização e configuradas pela MedEmerge.
## Se a rede cair
Cada envio é gravado num buffer local **antes** de sair, e só é apagado quando a plataforma confirma o recebimento. Se a conexão com a internet cair, o coletor continua coletando, acumula os envios e os reenvia quando a rede voltar. Reenviar é seguro: a plataforma reconhece um envio repetido e não duplica o dado.
## Quem enxerga os problemas
O coletor envia à plataforma o próprio registro de funcionamento (sem dado clínico e sem senhas), e a MedEmerge é avisada quando uma coleta falha ou quando o agente para de dar sinal. Na maior parte dos casos, o suporte diagnostica o problema **sem pedir acesso à máquina do hospital**.
Se a sua organização não pode manter uma máquina com Docker na rede interna, fale com a MedEmerge
em [suporte@medemerge.com.br](mailto:suporte@medemerge.com.br). Há formatos em que o agente roda
na infraestrutura da MedEmerge.
## Próximos passos
Máquina, rede e usuário de banco.
O passo a passo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.