Introdução ao Sistema Trevo
O Trevo é uma plataforma completa de gerenciamento para instalações de Medicina Nuclear e Radiodiagnóstico, desenvolvida para garantir conformidade com as regulamentações da CNEN (Comissão Nacional de Energia Nuclear).
O que é o Sistema Trevo?
O sistema Trevo oferece uma solução integrada para gerenciar todos os aspectos operacionais de instalações que trabalham com radioisótopos e equipamentos de diagnóstico por imagem, incluindo:
- Gestão de Instalações (Facilities): Cadastro completo de instalações com informações de endereço, CNPJ, departamento, e configurações CNEN
- Controle de Equipamentos: Registro de equipamentos com informações técnicas, localização e histórico de manutenção
- Gerenciamento de Usuários: Sistema de permissões baseado em roles com diferentes níveis de acesso
- Testes de Equipamentos: Registro e acompanhamento de testes periódicos específicos para cada tipo de equipamento
- Documentação: Upload, assinatura digital e liberação de documentos com workflow de aprovação
- Conformidade CNEN: Gestão de licenças, radioisótopos autorizados e práticas regulamentadas
Para Quem é Destinado?
O sistema Trevo atende três perfis principais de usuários:
Usuários Finais (Clientes)
- Visualizam documentos liberados de suas instalações
- Acompanham validade de documentos e testes
- Acesso somente leitura aos dados de suas instalações
Administradores RAD
- Gerenciam instalações, equipamentos e usuários
- Realizam upload, assinatura e liberação de documentos
- Controlam conformidade CNEN e permissões
- Agendam notificações por email
Desenvolvedores
- Mantêm e evoluem o sistema
- Realizam deployment e monitoramento
- Integram com serviços externos (AWS S3, MongoDB, Mailgun)
Principais Funcionalidades
Gerenciamento de Instalações
- Cadastro de dados básicos (nome, CNPJ, endereço, telefone)
- Configuração de departamento (Medicina Nuclear ou Radiodiagnóstico)
- Definição de responsabilidades (Titular, Responsável Técnico, Substituto, Supervisor)
- Registro de matrícula CNEN
- Configuração de práticas autorizadas
- Gestão de radioisótopos autorizados por semana com quantidades em mCi
Controle de Equipamentos
Suporte para diferentes tipos de equipamentos:
- Calibradores de Dose (Dose Calibrator)
- Câmara Gama (Gamma Camera)
- Contador Geiger (Geiger Counter)
- Equipamentos EPI
Cada tipo possui testes específicos com formulários personalizados.
Sistema de Documentos
Workflow completo de aprovação:
- Upload: RAD faz upload do documento PDF com conclusão (Satisfatório/Insatisfatório)
- Correção (opcional): Comentários podem ser adicionados solicitando correções
- Assinatura: RAD Físico ou RAD Admin assina o documento
- Liberação: RAD Admin libera o documento
- Notificação: Email pode ser agendado para notificar clientes
- Acesso: Clientes visualizam apenas documentos liberados
Gerenciamento de Usuários
Tipos de usuário com permissões específicas:
- administrador: Acesso completo ao sistema
- rad admin: Tarefas administrativas RAD
- rad fisico: Operações de física médica
- rad laudos: Gerenciamento de relatórios
- cliente: Acesso somente leitura
- cliente MN: Cliente com acesso específico para Medicina Nuclear
Conformidade CNEN
- Upload de licenças AN (Autorização Nuclear) e FM (Física Médica)
- Números de licença no formato AA-0000
- Controle de validade de licenças
- Radioisótopos autorizados: C(11), Cr(51), F(18), Ga(67), Ga(68), I(123), I(125), I(131), In(111), Lu(177), Ra(233), Sm(153), Tc(99m), Tl(201), Y(90)
- Práticas autorizadas: Terapia com Internação, Terapia Ambulatorial, Diagnóstico
Tecnologias Utilizadas
Frontend
- Framework: Nuxt.js 3.17.2 com Vue 3.5.13
- UI: PrimeVue 4.3.4 + Tailwind CSS 4.1.6
- State Management: Pinia 3.0.2
- HTTP Client: Axios 1.9.0
- Deployment: Vercel
Backend
- Runtime: Node.js 20
- Framework: Express com TypeScript
- Database: MongoDB Atlas
- File Storage: AWS S3
- Email: Mailgun
- Deployment: Render
Pré-requisitos
Para usar o sistema, você precisa:
- Acesso ao Sistema: Credenciais fornecidas por um administrador
- Navegador Moderno: Chrome, Firefox, Safari ou Edge (versão recente)
- Conexão à Internet: Para acessar a aplicação web
Para desenvolvedores:
- Node.js 20 ou superior
- pnpm (gerenciador de pacotes)
- Git
- Acesso aos repositórios GitHub
Próximos Passos
- Como fazer Login - Aprenda a acessar o sistema
- Navegação - Entenda a estrutura de navegação
- Guia do Usuário - Guias detalhados de uso
- Guia Administrativo - Procedimentos administrativos
- Guia do Desenvolvedor - Documentação técnica