1. Visão Geral do Ecossistema Integrado
Arquitetura unificada MAPA 24H & Holter QuoreOne com prontuário Medware e Telemedicina
O sistema integra quatro pilares essenciais da cardiologia diagnóstica da Ergoscan em um fluxo contínuo e 100% sem papel:
Medware Clinicas (HIS)
Prontuário eletrônico institucional, agendamento de pacientes, faturamento e arquivo permanente de laudos PDF.
Diário Digital Ergoscan
Acesso Web móvel do paciente via WhatsApp para aceite do Termo de Comodato (SHA-256), registro de Sono, Medicamentos e Sintomas.
Nuvem Quoretech & QuoreOne
Gravador Bluetooth 3 canais, inteligência artificial para detecção de arritmias e emissão de laudos de telemedicina.
Meta WhatsApp Cloud API
Disparos automatizados de link do diário, lembretes de 23h, conclusão de 24h e alertas inteligentes de atraso.
Mapeamento Oficial de Procedimentos Suportados:
| Código Medware | Procedimento | Monitor Utilizado | Destino do Exame |
|---|---|---|---|
11074 |
MAPA 24H (Monitoração Ambulatorial de Pressão) | Cardios / DynaMAPA | Servidor Local (Arquivo .awp / PDF) |
11073 |
HOLTER 24 H (3 Canais) | QuoreOne | Nuvem Quoretech (api.quore.tech) |
12351 |
HOLTER DIGITAL 3 CANAIS (Multidias / 7 dias) | QuoreOne | Nuvem Quoretech (api.quore.tech) |
11072 |
HOLTER EVENTOS (Looper / Gravador de Eventos) | QuoreOne | Nuvem Quoretech (api.quore.tech) |
2. Fluxo Operacional da Recepção (Admissão e Instalação)
Automação completa na chegada do paciente: Disparo WhatsApp e Criação Automática no QuoreOne
Automação Total na Admissão
A recepcionista não precisa digitar dados no aplicativo QuoreOne nem reenviar mensagens manualmente. A simples alteração de status no Medware executa todas as integrações.
Chegada do Paciente no Balcão
Ao atender o paciente na recepção, abra o Medware Clinicas na agenda do dia e mude o status do agendamento para "3 - Chegou / Confirmado Recepção".
Envio Automático do WhatsApp (Diário Digital)
O Robô detecta o status 3 e dispara imediatamente o template oficial mapa_diario_digital para o WhatsApp do paciente com o link personalizado do Diário e do Termo de Comodato.
Criação Automática do Exame na Nuvem Quoretech
Se o exame for de Holter (11073, 12351 ou 11072), o sistema cria instantaneamente o exame na nuvem Quoretech via POST /v2/exams/new, transmitindo Nome, CPF, Data Nasc, Sexo, Peso, Altura, Médico Solicitante (CRM/UF) e injeta o link médico seguro do Diário em reasons.
3. Guia Operacional do Técnico: Gravador QuoreOne
Instalação rápida e pareamento Bluetooth sem digitação cadastral no aplicativo
Com a criação automática na admissão, o técnico economiza tempo e elimina 100% dos erros de digitação de nomes, CPFs e datas:
Abra o Aplicativo QuoreOne
No celular ou tablet da clínica, abra o app QuoreOne. O paciente admitido pela recepção já estará listado na tela inicial no status "Instalar".
Pareamento Bluetooth com o Monitor
Ligue o gravador QuoreOne, selecione o nome do paciente no app e efetue o pareamento Bluetooth.
Posicionamento dos Eletrodos e Início da Gravação
Fixe os eletrodos descartáveis nos pontos anatômicos recomendados (3 canais), confira o teste de impedância na tela do app e clique em "Iniciar Gravação".
4. O Diário Digital e a Experiência do Paciente
Registro intuitivo de Sono, Medicamentos e Sintomas com Sincronização em Tempo Real
O paciente não precisa instalar nenhum aplicativo pesado. Basta clicar no link recebido pelo WhatsApp:
Sono e Vigília
Botões de 1 clique para "Fui Dormir" e "Acordei", essenciais para cálculo do descenso noturno.
Medicamentos
Registro do nome do remédio, dosagem e horário exato de ingestão durante as 24 horas.
Sintomas Cardíacos
Relato de palpitações, tontura, dor no peito ou falta de ar, registrando o momento exato para correlação com o traçado.
Sincronização Nuvem
Cada evento cadastrado atualiza imediatamente a ficha do exame na Quoretech via PATCH /exams/{uid}.
5. Radar de Devoluções e as 5 Travas de Interrupção de Atraso
Monitoramento semafórico em tempo real e proteção contra disparos indevidos
Semáforos Operacionais do Radar:
| Semáforo | Critério de Tempo | Ação Automática do Robô |
|---|---|---|
| 🟢 EM USO | 0h até 22h59 de exame | Monitoramento passivo de circulação do equipamento. |
| 🟡 TÉRMINO PRÓXIMO | 23h00 de exame atingidas | Disparo automático do template mapa_lembrete_23h_v1 com botão de Check-in. |
| 🟠 CONCLUSÃO 24H | 24h00 de exame atingidas | Disparo automático do template mapa_conclusao_24h_v1 solicitando devolução. |
| 🔴 ATRASADO | 24h30 de exame ultrapassadas | Disparo único do alerta de urgência mapa_alerta_atraso_v1. |
| 🔵 A CAMINHO | Paciente acionou Check-in GPS | Exibe tempo estimado de trânsito (ETA) e cancela alertas de atraso. |
| ✅ ENTREGUE | Aparelho recebido / baixado | Equipamento liberado e todas as mensagens são interrompidas. |
🛡️ As 5 Travas Automáticas de Interrupção de Atraso:
Check-in "A Caminho" ou "Entregue"
Quando o paciente clica no link do WhatsApp e confirma que saiu de casa ou quando a recepção confirma a entrega na tela, o robô interrompe imediatamente os alertas.
Mudança para Status 4 (Realizado) no Medware
Ao dar baixa na devolução do gravador no Medware, o exame sai da esteira de cobrança tanto para MAPA quanto para Holter.
Descarregamento Físico do Gravador
No MAPA, a geração do arquivo .awp marca o aparelho como Devolvido. No Holter, o envio dos pacotes de gravação conclui a circulação.
Trava de Idempotência (Máximo 1 Disparo)
O alerta de atraso é enviado no máximo 1 única vez por paciente. O sistema nunca dispara cobranças em loop repetitivo.
Cutoff Absoluto de Segurança (36 Horas)
Se o exame foi iniciado há mais de 36 horas, o robô bloqueia permanentemente qualquer disparo para não importunar o paciente em dias posteriores.
6. Devolução e Lançamento de Diário pela Equipe
Procedimento operacional para pacientes idosos ou que não utilizaram o celular
Recebimento do Aparelho
Receba o gravador e recolha as anotações em papel ou o relato verbal do paciente (horários de sono, remédios tomados e sintomas sentidos).
Lançamento no Painel do Diário
Acesse o painel do Diário (`http://localhost:5000/`), localize o agendamento do paciente e clique em "➕ Adicionar Evento".
Sincronização Instantânea com a Quoretech
Ao salvar os eventos, o sistema grava no prontuário do Medware e dispara a atualização para a nuvem Quoretech em segundo plano.
Baixa no Medware
Mude o status do agendamento no Medware Clinicas para 4 - Realizado.
7. Barreira de Segurança de Fases da Quoretech
Proteção de integridade que impede sobrescrita indevida de dados em laudos médicos assinados
Antes de enviar qualquer evento ou atualização para a Quoretech, a API valida a fase atual do exame:
| Fase na Quoretech | Status da API | Envio de Eventos | Comportamento do Sistema |
|---|---|---|---|
| Instalando | created |
LIBERADO | Dados gravados para a abertura inicial do exame. |
| Em Execução | receiving_packets |
LIBERADO | Sincronização em tempo real conforme o paciente preenche. |
| I.A. (Processando) | creating_annotations |
LIBERADO | Dados entregues prontos para a triagem técnica. |
| Revisar (Em Análise) | ready_to_report |
LIBERADO (CRÍTICO) | O analista técnico da Quoretech visualiza sono e sintomas na tela de minuta. |
| Assinar (Aguardando Médico) | ready_to_sign |
LIBERADO | O cardiologista laudador lê as anotações antes da assinatura final. |
| Finalizado (Laudado) | report_signed |
BLOQUEADO | ⛔ Barreira Ativa: Laudo já assinado. Exige solicitação de Recall / Retificação. |
8. Telemedicina Quoretech & Retorno Automático de Laudos
Entrega de laudo PDF assinado via Webhook direto no prontuário do Medware
Assinatura Médica na Nuvem Quoretech
O cardiologista laudador da Quoretech analisa o traçado de ECG com o Diário integrado e assina digitalmente o laudo.
Disparo do Webhook Seguro (Base64)
A Quoretech dispara um Webhook autenticado (Bearer Token) para POST /api/webhooks/quoretech contendo o arquivo PDF em Base64.
Gravação Automática no Medware
A API Ergoscan decodifica o PDF, grava o arquivo físico na pasta institucional do Medware e vincula os registros nas tabelas LAUDO, PARTICIPACAOLAUDO e AGENDAMENTO.
9. Termo de Comodato Digital & Conformidade LGPD
Segurança jurídica patrimonial dos gravadores com assinatura eletrônica e Hash SHA-256
Para proteger o patrimônio dos gravadores e atender rigorosamente à LGPD, todo paciente aceita o Termo antes de iniciar:
Hash SHA-256 Imutável
Gera um hash criptográfico do texto do termo no momento exato do aceite.
Georreferenciamento e IP
Registra coordenadas GPS (com consentimento), IP de origem e User-Agent do dispositivo.
Comprovação Probatória
Armazenamento permanente no banco de dados para auditoria jurídica e proteção contra extravios.
10. Templates Oficiais de WhatsApp (Meta Cloud API)
Modelos homologados com botões interativos e variáveis dinâmicas de procedimento
| Momento do Disparo | Nome do Template | Variáveis Enviadas |
|---|---|---|
| Instalação / Início | mapa_diario_digital |
{{1}} Nome Paciente • {{2}} Procedimento (MAPA/Holter) • {{3}} Link Diário |
| Lembrete 23h | mapa_lembrete_23h_v1 |
{{1}} Nome Paciente • {{2}} Procedimento • {{3}} Horário Previsto |
| Conclusão 24h | mapa_conclusao_24h_v1 |
{{1}} Nome Paciente • {{2}} Procedimento |
| Alerta Atraso 24h30 | mapa_alerta_atraso_v1 |
{{1}} Nome Paciente • {{2}} Procedimento • {{3}} Horário Previsto |
11. Arquitetura Autônoma e Serviços Windows
Três processos independentes com auto-recuperação e tolerância a falhas
1. MAPA_Servico_API (api.py)
Servidor Web e API REST (Waitress WSGI) na porta 5000 servindo o Diário Digital e Webhooks.
2. MAPA_Servico_Robo (robot.py)
Monitor contínuo do Medware, varredura de pastas de laudos e disparo das notificações WhatsApp.
3. MAPA_Servico_Watchdog (watchdog_api.py)
Sentinela autônomo que testa a integridade da API a cada 30 segundos e auto-recupera o serviço.
12. Resolução de Problemas Frequentes (FAQ & Troubleshooting)
Respostas rápidas para dúvidas do dia a dia da recepção e suporte técnico
O agendamento foi feito no Medware mas não apareceu no aplicativo QuoreOne. O que fazer?
Solução: Certifique-se de que o paciente está com Status 3 (Confirmado Recepção) no Medware. Se for agendamento de dias anteriores ou se desejar forçar, acesse o painel Web e clique no botão "⚡ Criar no QuoreOne".
O paciente devolveu o gravador de Holter mas o radar ainda mostra "Em Uso" ou "Atrasado".
Solução: No Medware Clinicas, mude o status do agendamento para 4 - Realizado. O sistema reconhece a devolução e cancela imediatamente qualquer alerta.
O laudo foi finalizado na Quoretech mas ainda não consta no Medware.
Solução: No painel do Diário, filtre por "❤️ Holter", selecione o paciente e clique em "📥 Sincronizar Agora". O robô baixará o PDF da Quoretech e anexará ao prontuário.
Como reiniciar os serviços caso o painel pare de responder?
Solução: Execute o script PowerShell d:\Automacoes\MAPA\mapa-robot\ReiniciarAPI.ps1. O servidor será reiniciado e voltará a responder em 3 segundos.
13. Portal de Laudos & Anexos de Exames Externos
Gestão unificada de laudos anexados (Espirometria, Doppler, Ultrassom, Holter, Tilt) com extração OCR e sincronização atômica no Medware
O Portal de Laudos & Anexos foi desenvolvido para digitalizar e unificar a recepção de laudos emitidos por equipamentos externos ou laudos manuais em PDF, integrando-os diretamente ao prontuário eletrônico institucional (Medware) e ao faturamento.
Controle de Acesso Dinâmico
Respeita o campo nativo USUARIO.TODOSMEDICOS do Medware. Usuários irrestritos (-1) acessam todos os módulos; usuários restritos (0) visualizam estritamente os procedimentos autorizados ao seu médico vinculado.
Upload de Múltiplos Arquivos
Suporte a arrastar e soltar (Drag & Drop) e seleção múltipla de arquivos PDF para o mesmo agendamento, consolidando exames com laudo e traçados complementares.
Extração Automática de Texto (OCR)
Motor integrado com PyMuPDF (fitz) que realiza a leitura e extração instantânea do texto e da conclusão diagnóstica em todas as páginas do PDF ao anexar o arquivo.
Sincronização Atômica Medware
Atualização simultânea em transação protegida nas tabelas LAUDO, TEXTOFINAL, TEXTOLAUDO, VARIAVELLAUDO, PARTICIPACAOLAUDO e AGENDAMENTO.
Tempo Médio de Laudo Dinâmico
Cálculo estatístico em tempo real do tempo médio decorrido entre o atendimento do paciente e a conclusão/assinatura do laudo, integrado diretamente ao lado do filtro de período de atendimento.
Regras de Controle de Acesso e Perfis de Usuário:
Configuração TODOSMEDICOS |
Módulos Permitidos | Filtro de Procedimentos | Comportamento no Sistema |
|---|---|---|---|
TODOSMEDICOS = -1 (Acesso Geral / Dr. José Carlos) |
Modo Paciente, Visão Clínica, Portal de Anexos, Configurações | Todos os procedimentos (MAPA, Holter, Doppler, Espirometria) | Permite alternância livre entre todas as visões do sistema e auditoria global. |
TODOSMEDICOS = 0 (Acesso Restrito / Médicos Específicos) |
Apenas Portal de Laudos & Anexos | Procedimentos vinculados ao CODMEDICO logado |
Bloqueia botões de Modo Paciente e Visão Clínica; direciona automaticamente para a fila de exames de sua especialidade. |
Passo a Passo: Como Anexar e Gravar um Laudo Externo
Localizar o Agendamento na Fila
Na aba "📋 Laudos & Anexos" ou "Visão Clínica", selecione o período desejado (7d, 30d, 60d, 90d ou Todos) e a ordem de exibição por data ("⬆️ Mais Antigos 1º" como padrão para fila FIFO, ou "⬇️ Mais Recentes 1º"). Localize o paciente e clique no botão "📎 Anexar Laudos".
Selecionar ou Arrastar o(s) Arquivo(s) PDF
Arraste o arquivo PDF emitido pelo equipamento para a área pontilhada ou clique na caixa de upload. É possível selecionar múltiplos arquivos complementares (ex: traçado técnico + laudo assinado).
Revisão da Extração Automática de Texto
O sistema processa o PDF em tempo real com motor PyMuPDF, preenchendo automaticamente o campo de texto/conclusão diagnóstica. O médico pode editar, complementar ou digitar observações adicionais livremente.
Gravação Atômica no Medware
Ao clicar em "💾 Salvar e Gravar no Medware", o sistema:
• Salva fisicamente o PDF na rede oficial: \\192.168.15.254\Medware Clinicas\arquivos\a{grupo}\{cod_agendamento}\
• Identifica dinamicamente o CODSCRIPTLAUDO em SCRIPTLAUDO_PROCEDIMENTO (ex: Script 80 para Espirometria/Doppler).
• Grava o stream multichave Delphi em LAUDO.LAUDO (VR_LAUDOFINAL, VR_LAUDO, VR_TEXTOLAUDO, etc.).
• Sincroniza TEXTOLAUDO e VARIAVELLAUDO com chave primária protegida.
• Registra PARTICIPACAOLAUDO (CODSTATUSLAUDO = 4 → Finalizado).
• Atualiza o AGENDAMENTO para CODSTATUSAGENDAMENTO = 5 (Liberado) com carimbo de liberação e usuário.
Controle de Ordenação por Data (Fila FIFO)
Tanto no Portal de Laudos & Anexos quanto na Visão Clínica, a listagem exibe por padrão os Mais Antigos Primeiro (⬆️), garantindo que atendimentos prioritários há mais tempo pendentes fiquem no topo da fila. É possível alternar instantaneamente para os Mais Recentes Primeiro (⬇️) com apenas um clique.
Sinalização e Destaque de Filtros Ativos (Períodos em Ação)
A interface destaca visualmente os filtros padrão com a tag PADRÃO (Período: 60 dias, Status: Pendentes de Laudo, Ordem: Mais Antigos 1º). Uma barra dinâmica "🎯 Filtro em Ação" no topo das tabelas resume em tempo real todos os parâmetros ativos e a contagem exata de exames exibidos.
Garantia Multichave Delphi Universal
Graças ao empacotamento multichave (VR_LAUDOFINAL, VR_LAUDO, VR_TEXTOLAUDO, VR_LAUDO_AUTOMATICO, VR_CONCLUSAO, VR_DIAGNOSTICO, VR_TEXTO), o laudo é 100% legível por qualquer módulo ou relatório de impressão (.MRD / .DLL) do Medware, eliminando qualquer ocorrência de tela em branco.