Integração inteligente entre protocolos DICOM e sistemas de saúde modernos
Bem-vindo à Documentação#
Esta documentação técnica detalha a API do Plugin DICOM, uma solução desenvolvida pela Zscan Software para integrar protocolos DICOM TCP/IP com comunicações HTTP/JSON/XML em sistemas de saúde.
🎯 Visão Geral#
O Plugin DICOM atua como uma ponte essencial entre sistemas HIS/RIS (Hospital Information System/Radiology Information System) e PACS (Picture Archiving and Communication System), oferecendo:✅ Conversão bidirecional de imagens (DCM ↔️ PNG/JPEG)
✅ Gerenciamento inteligente de worklists
✅ Edição e manipulação de estudos DICOM
✅ Integração nativa com ZscanEvo
✅ Conformidade total com HIPAA e LGPD
🏗️ Arquitetura#
Stack Tecnológico#
Frontend: React + Electron (LTS)
Backend: Java Spring Boot
Database: MySQL (local)
Protocol: DCM4CHE (DICOM TCP/IP)
Security: JWT + AES-256
Componentes Principais#
| Camada | Tecnologia | Responsabilidade |
|---|
| Apresentação | React + Electron | Interface desktop multi-idioma (PT/EN/ES) |
| API REST | Spring Boot | Endpoints HTTP/JSON para integração |
| DICOM Core | DCM4CHE | Comunicação TCP/IP e conversão de imagens |
| Persistência | MySQL | Armazenamento de configurações e logs |
| Segurança | JWT + AES | Autenticação e criptografia de dados PHI |
📋 Funcionalidades Core#
🔐 Autenticação e Segurança#
Autenticação via JWT com suporte a OAuth
Bloqueio automático após 3 tentativas falhas
Criptografia AES-256 para dados sensíveis (PHI)
Logs imutáveis para conformidade regulatória
⚙️ Configuração DICOM#
Gerenciamento de conex ões HIS/RIS e PACS
Configuração de AE Title, Host e Port
Timeout customizável e retry policy
Testes de conectividade em tempo real (C-ECHO)
Biblioteca completa de tags DICOM standard
Seleção granular por categoria (Paciente/Estudo)
Validação de unicidade e compatibilidade
Restauração para configuração padrão
🔗 WebHooks#
Notificações HTTP para eventos de estudos
Suporte a headers customizados
Retry policy com alertas de falha
📊 Dashboard e Monitoramento#
Métricas em tempo real (atualização a cada 60s)
Status de conexões ativas
Contadores de estudos processados
Visão simplificada de auditoria
🔍 Auditoria e Compliance#
Registro automático de todos os acessos PHI
Retenção de logs por 60 dias
Alertas em tempo real para violações HIPAA
Exportação de relatórios em CSV
O Plugin DICOM oferece integração nativa com os seguintes módulos do ZscanEvo:| Módulo | Capacidade |
|---|
| Agenda | Sincronização de worklists do RIS/HIS com filtros por modalidade/data |
| Paciente | Importação de estudos, vinculação de ID externo, gestão de imagens |
| Captura | Envio automático para PACS ao finalizar captura |
| Laudos | Anexação de laudos a estudos, status "Enviado PACS" |
| Importação | Upload batch de estudos completos via arquivo |
🎯 Casos de Uso Principais#
Para Administradores de Clínicas#
Configuração centralizada de conexões DICOM
Geração de relatórios de conformidade HIPAA
Gestão de webhooks para integrações externas
Monitoramento de métricas operacionais
Para Técnicos de Radiologia#
Gerenciamento de tags DICOM por categoria
Configuração de eventos e notificações
Testes de conectividade e diagnóstico
Para Médicos#
Visualização integrada de estudos no ZscanEvo
Importação simplificada de imagens DICOM
Anexação de laudos com rastreabilidade completa
Tempo de resposta: < 200ms para queries DICOM
Conexões simultâneas: Suporte a 100 conexões
Conversão de imagens: Preservação de qualidade em 95%+ dos casos
Cache local: Otimização para configurações frequentes
📊 Métricas de Qualidade#
| Métrica | Meta | Status |
|---|
| Cobertura de testes | 90% | 🎯 Obrigatório |
| Testes unitários | JUnit | ✅ Implementado |
| Testes de integração | Postman + Zephyr | ✅ Implementado |
| Testes E2E | Playwright | ✅ Implementado |
| NPS do usuário | > 8/10 | 🎯 Meta |
HIPAA Compliance#
✅ Criptografia obrigatória para dados PHI
✅ Logs imutáveis de todos os acessos
✅ Relatórios automáticos mensais
✅ Alertas em tempo real para violações
LGPD Compliance#
✅ Consentimento explícito para tratamento de dados
✅ Direito ao esquecimento (auto-deleção após 60 dias)
✅ Portabilidade de dados via exportação CSV
✅ Transparência total no uso de informações
📚 Navegação da Documentação#
Explore os recursos disponíveis:WebHooks - Eventos e integrações externas
🛠️ Suporte Técnico#
Versão atual: 1.0 (MVP - Novembro 2025)
Próxima versão: 2.0 (Fevereiro 2026)Para questões técnicas, consulte:📧 Email de suporte técnico
🎓 Começando#
Pronto para integrar? Siga nosso Guia de Quick Start para ter seu ambiente rodando em menos de 10 minutos.
Desenvolvido com ❤️ pela Zscan SoftwareTransformando a comunicação entre sistemas de saúde
