O cliente e o contexto
Um hospital 100% SUS dentro de uma rede que atende os dois sistemas.
O Instituto Mário Penna é uma instituição de oncologia de Belo Horizonte. A maior parte do que faz é pelo SUS, que funciona para eles como um convênio na mesma prateleira dos planos privados, com um serviço praticamente igual nos dois blocos. O Hospital Luxemburgo, onde o dispensário entra, atende somente pelo SUS.
Eles não têm equipe própria de redes nem de segurança da informação, mas têm marcenaria, eletrônica e engenharia biomédica na casa. Isso desenha o projeto: o gabinete e a instalação podem ser feitos lá dentro, e o sistema não pode depender de um time de TI para funcionar no dia a dia.
Como funciona hoje
- O profissional vai até a farmácia central.
- Bipa o crachá e bipa o medicamento.
- Leva o item e deixa na mesa de cabeceira do leito.
O registro de quem pegou o quê e quando já existe. O gargalo é a fila no balcão central e o trecho entre a retirada e a administração, que fica sem controle.
Como fica com o dispensário
- A logística repõe o armário da ala duas vezes ao dia.
- O profissional se identifica no próprio armário.
- A porta abre, ele retira, fecha, e cada passo vira um evento.
O estoque chega mais perto do paciente, a fila central diminui e cada abertura deixa evidência consultável.
As dores declaradas
- A operação de levar o medicamento da farmácia ao paciente é complexa demais.
- Há controle forte de custo e pouco controle de uso.
- É difícil comprovar que o medicamento chegou ao paciente.
- Medicamentos com faixa de temperatura específica já ficaram fora da condição ideal.
- As soluções do mercado são de poucas empresas e chegam a cerca de R$ 4 milhões.
Escopo do protótipo
A fronteira entre o equipamento e o sistema que o hospital já tem.
| O equipamento faz | O sistema do hospital continua fazendo | Fora do protótipo |
|---|---|---|
| Autentica o profissional (digital, senha como alternativa) · libera e trava a porta · percebe abertura e fechamento · avisa porta aberta com som discreto · registra cada evento com horário confiável · envia os eventos | Prescrição · baixa dos itens · saldo e reposição do subestoque · identificação do paciente | Climatização e itens refrigerados · trava por gaveta · reconhecimento facial · vídeo contínuo |
A topologia é em estrela: cada dispensário é isolado e fala só com a farmácia central ou com a subfarmácia responsável. Um dispensário nunca consulta nem abastece outro. Quem se autentica alcança todo o conteúdo do módulo, sem trava individual por compartimento.
Um monitor sensível ao toque mostrando a prescrição do paciente foi classificado pelo cliente como desejável, não essencial, e depende da API do hospital.
Requisitos funcionais
Linha de base da Fase 1 (26/08/2026). Marcados os que dependem de decisão externa.
| Código | Requisito | Situação |
|---|---|---|
| RF01 | Autenticação biométrica. Identificar individualmente o profissional autorizado por leitor de impressão digital. | no protótipo |
| RF02 | Autenticação alternativa. Permitir senha quando a leitura biométrica não estiver disponível ou não for concluída. | no protótipo |
| RF03 | Controle da porta. Liberar a fechadura só após autenticação válida e mantê-la bloqueada quando o acesso não for autorizado. | no protótipo |
| RF04 | Registro de acesso. Registrar cada tentativa com dispensário, profissional, data, horário, método e resultado. | no protótipo |
| RF05 | Monitoramento da porta. Identificar os estados aberto e fechado e registrar cada mudança. | no protótipo |
| RF06 | Alerta de porta aberta. Aviso sonoro discreto quando a porta passa do tempo definido. | no protótipo tempo a validar |
| RF07 | Associação ao paciente. Quando a integração permitir, ligar a abertura ao paciente e à movimentação. | depende da API |
| RF08 | Envio de eventos. Transmitir ao sistema institucional os eventos de acesso, abertura e fechamento. | servidor próprio no lugar da API |
| RF09 | Integração de estoque. Entregar o contexto da operação, deixando baixa, saldo e reposição no sistema do hospital. | fluxo a validar |
| RF10 | Integração institucional. Gravar os registros no banco do Instituto pela API fornecida. | depende da API |
| RF11 | Correlação de evidências. Registrar horário e identificadores suficientes para cruzar cada abertura com a câmera institucional. | NTP + foto por acesso |
| RF12 | Acesso ao conteúdo. Após autenticação, liberar todo o conteúdo, sem bloqueio por compartimento. | no protótipo |
| RF13 | Consulta de prescrição. Mostrar a prescrição num monitor sensível ao toque. | desejável |
Requisitos não funcionais
| Código | Requisito |
|---|---|
| RNF01 | Segurança de acesso. Só profissionais autorizados liberam a porta; senha, biometria e dado de paciente seguem as permissões do Instituto. |
| RNF02 | Rastreabilidade. Cada registro preserva dispensário, profissional, evento, data e horário. |
| RNF03 | Interoperabilidade. Comunicação pela API do Instituto, tratando o sistema hospitalar como fonte oficial. |
| RNF04 | Confiabilidade. Falha de comunicação não apaga evento já confirmado no equipamento. |
| RNF05 | Usabilidade. Instruções claras, poucas ações, autenticação rápida. |
| RNF06 | Conforto acústico. O alerta é ouvido perto do equipamento sem incomodar pacientes. |
| RNF07 | Adequação física. Adaptável à parede, aos pontos de energia e rede e à circulação; subdivisões internas configuráveis. |
| RNF08 | Continuidade elétrica. Compatível com nobreak e gerador; volta a um estado seguro depois de reiniciar. |
| RNF09 | Manutenibilidade. Arquitetura modular e componentes substituíveis pelas equipes internas. |
| RNF10 | Viabilidade econômica. Bem mais barato que as alternativas comerciais, sem perder os controles essenciais. |
| RNF11 | Escopo. As funções essenciais não dependem de câmera nem de climatização. |
| RNF12 | Compatibilidade de rede. Opera no segmento autorizado para equipamentos hospitalares, nunca na rede de pacientes. |
| RNF13 | Integridade temporal. Relógio sincronizado para cruzar abertura, eventos e imagens. |
| RNF14 | Isolamento. Cada unidade é um subestoque independente e fala só com a farmácia responsável. |
Contrato entre hardware e software
O que o programa recebe, o que ele comanda e o que todo evento carrega.
Entradas
- Biometria: sucesso, não reconhecida, leitura incompleta, erro, indisponível.
- Teclado: dígito, apagar, cancelar, confirmar.
- Porta: aberta, fechada, possível falha ou desconexão.
- Rede: aceito, rejeitado, não autorizado, indisponível, tempo esgotado.
- Relógio: sincronizado, sem sincronia, horário local com deslocamento.
Saídas
- Trava: liberar e bloquear.
- Alerta: ligar, desligar, padrão configurado.
- Tela: instrução, sucesso, negação, aviso de porta, falha de comunicação.
- Comunicação: publicar evento, consultar envio, repetir pendente.
Todo evento carrega um identificador único (para repetir o envio sem duplicar), o dispensário, o profissional quando conhecido, o tipo, o método de autenticação, o resultado e o horário com a origem dele. Nunca carrega senha, imagem de digital ou modelo biométrico.
Máquina de estados
Proposta de engenharia para que as regras não fiquem espalhadas pelo código.
- Acesso negado volta para Bloqueado.
- Porta aberta sem autorização gera evento crítico e alarme até fechar.
- Falha de rede não para nada: o evento entra na fila e é reenviado.
- Depois de reiniciar, o sistema começa travado e confere os sensores antes de aceitar nova operação.
Critérios de aceite
Como saber que cada requisito foi cumprido.
| Código | Critério |
|---|---|
| CA01 | Digital autorizada libera a trava e gera eventos completos. |
| CA02 | Digital não reconhecida não libera e gera tentativa negada. |
| CA03 | Falha do leitor permite autenticar por senha. |
| CA04 | Senha certa libera; senha errada não libera e respeita o limite de tentativas. |
| CA05 | Cada sensor altera só o estado da sua porta. |
| CA06 | Porta aberta além do tempo dispara som discreto e evento de alerta. |
| CA07 | Fechar interrompe o alerta, registra o fechamento e devolve a trava ao estado seguro. |
| CA08 | Abertura sem autorização gera evento crítico e não se confunde com acesso normal. |
| CA09 | Servidor fora do ar não apaga eventos, e o reenvio não duplica. |
| CA10 | Reiniciar volta a um estado seguro. limite do protótipo a fila fica em RAM e se perde num reinício, decisão aceita para a demonstração. |
| CA11 | Nenhum registro revela senha ou conteúdo biométrico. |
| CA12 | O horário registrado permite cruzar com uma fonte externa de tempo. |
Decisões que dependem do cliente
Ficam em aberto e não bloqueiam a demonstração, mas bloqueiam a versão real.
Integração
- Documentação, autenticação, ambiente de teste e contato técnico da API.
- Biometria validada no equipamento ou no servidor, e onde ficam os modelos.
- Cadastro e revogação de profissionais.
Operação
- Como o sistema sabe o que saiu: leitura do item, declaração na tela ou detecção.
- Crachá junto com a digital, por causa das luvas de procedimento.
- Sem rede, o equipamento trava ou libera com sincronização posterior.
Instalação
- Rede cabeada ou Wi-Fi, segmento autorizado e fonte de horário.
- Tempo, volume e silenciamento do alerta.
- Dimensões finais e teto de custo por unidade.
Riscos
A API é dependência externa e é o caminho crítico. Sem equipe de redes e segurança no cliente, ninguém do lado deles vai escrever os requisitos de segurança pelo grupo: isso precisa vir do projeto.