Requisitos

Do problema ao critério de aceite

O que o Instituto Mário Penna pediu, o que o protótipo precisa provar e como cada exigência vira um teste. Base: entrevista de 20/08/2026, Fase 1 (26/08) e o documento de componentes e requisitos de software (08/09).

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

  1. O profissional vai até a farmácia central.
  2. Bipa o crachá e bipa o medicamento.
  3. 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

  1. A logística repõe o armário da ala duas vezes ao dia.
  2. O profissional se identifica no próprio armário.
  3. 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

O caso que fixa a urgência: para um paciente diabético, uma hora de diferença na aplicação de insulina já muda o quadro. Velocidade de acesso é requisito, não conforto.

Escopo do protótipo

A fronteira entre o equipamento e o sistema que o hospital já tem.

O equipamento fazO sistema do hospital continua fazendoFora 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ódigoRequisitoSituação
RF01Autenticação biométrica. Identificar individualmente o profissional autorizado por leitor de impressão digital.no protótipo
RF02Autenticação alternativa. Permitir senha quando a leitura biométrica não estiver disponível ou não for concluída.no protótipo
RF03Controle 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
RF04Registro de acesso. Registrar cada tentativa com dispensário, profissional, data, horário, método e resultado.no protótipo
RF05Monitoramento da porta. Identificar os estados aberto e fechado e registrar cada mudança.no protótipo
RF06Alerta de porta aberta. Aviso sonoro discreto quando a porta passa do tempo definido.no protótipo tempo a validar
RF07Associação ao paciente. Quando a integração permitir, ligar a abertura ao paciente e à movimentação.depende da API
RF08Envio de eventos. Transmitir ao sistema institucional os eventos de acesso, abertura e fechamento.servidor próprio no lugar da API
RF09Integração de estoque. Entregar o contexto da operação, deixando baixa, saldo e reposição no sistema do hospital.fluxo a validar
RF10Integração institucional. Gravar os registros no banco do Instituto pela API fornecida.depende da API
RF11Correlação de evidências. Registrar horário e identificadores suficientes para cruzar cada abertura com a câmera institucional.NTP + foto por acesso
RF12Acesso ao conteúdo. Após autenticação, liberar todo o conteúdo, sem bloqueio por compartimento.no protótipo
RF13Consulta de prescrição. Mostrar a prescrição num monitor sensível ao toque.desejável

Requisitos não funcionais

CódigoRequisito
RNF01Segurança de acesso. Só profissionais autorizados liberam a porta; senha, biometria e dado de paciente seguem as permissões do Instituto.
RNF02Rastreabilidade. Cada registro preserva dispensário, profissional, evento, data e horário.
RNF03Interoperabilidade. Comunicação pela API do Instituto, tratando o sistema hospitalar como fonte oficial.
RNF04Confiabilidade. Falha de comunicação não apaga evento já confirmado no equipamento.
RNF05Usabilidade. Instruções claras, poucas ações, autenticação rápida.
RNF06Conforto acústico. O alerta é ouvido perto do equipamento sem incomodar pacientes.
RNF07Adequação física. Adaptável à parede, aos pontos de energia e rede e à circulação; subdivisões internas configuráveis.
RNF08Continuidade elétrica. Compatível com nobreak e gerador; volta a um estado seguro depois de reiniciar.
RNF09Manutenibilidade. Arquitetura modular e componentes substituíveis pelas equipes internas.
RNF10Viabilidade econômica. Bem mais barato que as alternativas comerciais, sem perder os controles essenciais.
RNF11Escopo. As funções essenciais não dependem de câmera nem de climatização.
RNF12Compatibilidade de rede. Opera no segmento autorizado para equipamentos hospitalares, nunca na rede de pacientes.
RNF13Integridade temporal. Relógio sincronizado para cruzar abertura, eventos e imagens.
RNF14Isolamento. 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.

E1 Bloqueadotrava fechada E2 Autenticandodigital ou senha E3 Autorizadoevento criado E4 Destravadoespera abrir (60 s) E5 Porta abertaconta 5 min E6 Alertabipe + vermelho E7 Fechandotrava volta E8 Falhasensor, trava, leitor, relógio ou rede negado expirou sem abrir

Critérios de aceite

Como saber que cada requisito foi cumprido.

CódigoCritério
CA01Digital autorizada libera a trava e gera eventos completos.
CA02Digital não reconhecida não libera e gera tentativa negada.
CA03Falha do leitor permite autenticar por senha.
CA04Senha certa libera; senha errada não libera e respeita o limite de tentativas.
CA05Cada sensor altera só o estado da sua porta.
CA06Porta aberta além do tempo dispara som discreto e evento de alerta.
CA07Fechar interrompe o alerta, registra o fechamento e devolve a trava ao estado seguro.
CA08Abertura sem autorização gera evento crítico e não se confunde com acesso normal.
CA09Servidor fora do ar não apaga eventos, e o reenvio não duplica.
CA10Reiniciar 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.
CA11Nenhum registro revela senha ou conteúdo biométrico.
CA12O 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.

AnteriorVisão geralPróximaEngenharia de software