Engenharia de software

Do levantamento ao gabarito

Como o grupo levantou, classificou, modelou e rastreou cada requisito, do primeiro encontro com o cliente em 20/08 ao protótipo de 18/11. Treze semanas, cerca de 530 horas de trabalho e um mesmo princípio do começo ao fim: entregar em blocos que se encaixam.

Modelo de ciclo de vidaincremental e iterativo, em blocos
Requisitos13 funcionais, 14 não funcionais, 12 critérios de aceite
Rastreabilidade7 atendidos, 2 de outro jeito, 3 não feitos, 1 além, mais 6 entregas extras
Horas estimadas~533 h no total

O modelo de ciclo de vida

Tijolo por tijolo, com validação a cada volta.

O dispensário seguiu o modelo incremental: o sistema foi dividido em partes pequenas que se juntam, como tijolos num muro. Primeiro a casca do módulo biométrico, depois a interface, depois o armário, a porta, o gaveteiro, a bancada eletrônica, o servidor e a nuvem. Cada incremento foi construído de forma independente e depois integrado ao que já existia.

Dentro de cada incremento o trabalho foi iterativo: construir, avaliar, ajustar e repetir, sem esperar acerto na primeira vez. O chassi passou de três lâminas para duas; a altura do módulo caiu de 1500 para 1000 mm; o leitor de digital teve três formas de fixação até a definitiva. Cada volta levou ao corte de um retalho de teste antes da peça final, que é a prototipagem e o gerenciamento de risco do modelo em espiral aplicados à fabricação.

O cascata não serviria aqui. Os requisitos não estavam 95% mapeados no início: a API do hospital nunca chegou, a câmera saiu e voltou ao escopo, e o cliente precisava ver algo funcionando antes do fim.

FaseFocoNo projeto
Iniciaçãoescopo e visão geralentrevista de 20/08, Fase 1 entregue em 26/08
Elaboraçãoarquiteturacomponentes e contrato hardware/software (09/09), chassi modular (03/09 a 07/10)
Construçãoimplementar e testarcortes de 03/09 a 17/11, bancada de 06/11, servidor de 07/11, mais de 200 testes automáticos
Transiçãoentregar e dar suporteapresentação ao cliente, site, repositórios públicos e documentação

Partes interessadas

Cliente

Instituto Mário Penna, pela Diretoria de Tecnologia, Inovação, Ensino e Pesquisa. Tem o poder de aceite.

Usuários

Profissionais de enfermagem que abrem o armário; farmácia e logística, que repõem duas vezes ao dia; administrador do sistema.

Outros

Pacientes (o alerta não pode incomodar), equipe de TI e redes do hospital, a disciplina e o professor orientador, o próprio grupo.

Elicitação

Como os requisitos foram descobertos.

TécnicaO que foi feito
Entrevista semiestruturadaEncontro de 20/08/2026 com o cliente: roteiro de 9 blocos de perguntas, aberto a assuntos que surgiram na conversa. Gravada.
Gravação e transcrição4 transcrições, 35 páginas, relidas para separar o que é do equipamento e o que é do sistema hospitalar.
Análise de documentosO slide do próprio Instituto sobre o equipamento, a RENAME 2024 do SUS (265 princípios ativos) e datasheets de cada componente.
Especialista do domínioPerguntas de engenharia ao professor da disciplina e conferência dos esquemas elétricos com ele.
Validação por protótipoCada peça cortada primeiro num retalho e encaixada no componente real; cada bloco da bancada testado antes do seguinte.

O que a elicitação revelou, e que mudou o projeto: o hospital controla custo mas não uso; não sabe dizer se o medicamento chegou ao paciente; a operação hoje passa por farmácias centrais com fila; e as soluções comerciais chegam a R$ 4 milhões, fora do alcance de um hospital 100% SUS.

Classificação dos requisitos

Um exemplo real de cada tipo.

TipoExemplo no dispensário
De usuário"Quero abrir o armário rápido, mesmo com o leitor falhando."
De sistema funcionalRF02: aceitar ID + senha de 6 dígitos quando a digital não for lida; travar o teclado por 60 s na 5ª falha seguida.
Não funcionalRNF06: o alerta de porta aberta é ouvido perto do equipamento sem incomodar o paciente (bipe de 250 ms a cada 2 s, só depois de 5 min).
De domínioConfidencialidade dos dados de saúde: nenhum evento carrega senha nem modelo de digital; a senha é guardada como SHA-256 com sal.
De interfaceLCD a 1170 mm do piso e teclado a 910 mm, pela faixa de alcance de normas de acessibilidade; cores do LED com significado fixo.

Métricas usadas nos não funcionais: negociação TLS de ~300 ms e pedidos de 22 a 50 ms (velocidade); fila de 16 eventos no Mega e 8 na câmera (tamanho); reinício sempre em estado travado (robustez); 100 cadastros com IDs nunca reutilizados (confiabilidade do registro).

Matriz de rastreabilidade

Cada requisito da Fase 1 até a solução, com a situação em 18/11/2026.

Matriz: RF01 a RF06 e RF12 atendidos, RF08 e RF10 atendidos de outro jeito, RF07, RF09 e RF13 não feitos, RF11 além do pedido, e seis entregas além do pedido

O que foi pedido e não foi feito, e por quê

O que foi além

Casos de uso

Atores principais à direita, porque iniciam; o secundário à esquerda, porque reage. Cada caso nomeado por verbo e substantivo.

Diagrama de casos de uso com Profissional de Enfermagem, Administrador e Servidor de Auditoria
Caso de uso: Abrir Porta
AtorProfissional de Enfermagem
Pré-condiçõesprofissional cadastrado e ativo; porta fechada; sistema em E1 (Bloqueado)
Fluxo principal1. põe o dedo no leitor. 2. o sistema identifica o ID. 3. o sistema pulsa a fechadura e acende o verde. 4. o profissional abre a porta em até 60 s. 5. o sistema registra a abertura. 6. o profissional retira o item e fecha. 7. o sistema registra o fechamento e trava.
Fluxos alternativosdigital não lida: ID + senha ou crachá. Credencial negada: vermelho, evento de negação, 5ª falha trava o teclado por 60 s. Porta não aberta em 60 s: trava de novo com três bipes. Porta aberta mais de 5 min: alerta até fechar.
Pós-condiçõesporta travada; eventos de acesso, abertura e fechamento registrados com quem, quando, método e dispensário

Diagrama de classes

O modelo conceitual: os elementos centrais e como se relacionam, antes do código.

Diagrama de classes com Dispensario, Profissional, Credencial abstrata e suas especializações Digital, Senha e CartaoRFID, Evento, Foto, Administrador e Comando

Credencial é abstrata e se especializa em Digital, Senha e CartaoRFID (generalização). Profissional é composto pelas credenciais dele: desativar a pessoa desativa as três. Um Dispensario registra de 0 a muitos eventos, e cada Evento anexa no máximo uma Foto. O Administrador não muda a senha direto: ele emite um Comando, que só vale depois que o Mega confirma.

Diagrama de sequência

Um acesso por digital, do dedo ao servidor.

Diagrama de sequência entre Profissional, Leitor, Arduino Mega, Fechadura, ESP32 e Servidor

A decisão de abrir acontece inteira no Mega, antes de qualquer mensagem de rede. A rede entra depois, só para auditoria: se o Wi-Fi cair no meio, a porta já abriu e o evento espera na fila.

Diagrama de estados

Máquina de estados de E1 Bloqueado a E9 Violação

O que cada iteração ensinou

Íamos fazer uma coisa, aprendemos outra, mudamos.

ÍamosAprendemosFizemos
Paredes de 3 lâminas de MDF presas com M336 peças e centenas de furos para um ganho de rigidez que duas lâminas já davam2 lâminas (6 mm) presas por abraçadeira de nylon nos cantos
Armário de 1260 x 1500 mmNão cabe na mesa de 1150 x 1000 da cortadora sem emenda750 x 1000 x 250, que sai inteiro em 6 cargas
Vão do LCD pelo datasheet (~71 x 24)A peça real tinha ~77 x 25Medida tirada da foto da peça com régua
Leitor de digital preso por batentesOs batentes não seguraram no testeGarfo, depois cola quente num vão de 20 x 18
30 gavetas, uma por letraVárias letras vazias; a letra A sozinha tem 29 ativos15 gavetas por faixa de letras, piso de 29 na mais cheia
Parâmetros da tabela da máquinaA máquina rendia abaixo da tabela em tudoMatriz de calibração cortada e lida; corte a 10 mm/s e 74,5%
Leitor de digital falhando a cada 10 sLED sem resistor balançava o terra do leitorDois fios de terra extras e 330 Ω por cor

Horas de trabalho

Estimativa bruta, de 20/08 a 18/11/2026: 13 semanas.

QuemHoras por semanaTotal
Joshua Azze~20~260 h
Beatriz Samaha~7~91 h
Bruna Bento~7~91 h
Marcelo Reis~7~91 h
Total~41~533 h

Em números do próprio trabalho: 134 commits no repositório do gabinete, 39 no de firmware e servidor, 48 projetos do LightBurn e 60 DXF só no armário, mais de 200 testes automáticos no firmware e no servidor e cerca de 12.400 linhas de código e configuração no sistema embarcado.

Quanto custa

Estimativas por preço de varejo de 2026, não por nota fiscal.

O protótipo

ItemR$
Arduino Mega 2560 compatível95
ESP32 DevKit50
ESP32-CAM com OV2640119
Leitor de digital110
Leitor RFID RC522 e cartões20
LCD 1602 e teclado 4x432
Fechadura 12 V e relé82
Fonte 12 V, LM2596 e MB10275
LED, buzzer, botões, transistores, diodo, resistores, fios61
MDF 3 mm (chapas, incluindo testes)350
Acrílico 1,5 mm60
Abraçadeiras, parafusos, porcas, cola60
Servidor na nuvem e domínio0 (crédito)
Total em material~1.114

Corte a laser no laboratório da faculdade, sem custo de máquina. Se as ~533 horas fossem pagas a R$ 40, seriam mais ~R$ 21 mil de trabalho.

Um dispensário aberto, por unidade

ItemR$
Placa única com ESP32-S3 e câmera (PCB própria)250
Leitor de digital e leitor de crachá130
Tela sensível ao toque de 7" para a prescrição350
Fechadura de uso contínuo e sensores magnéticos de porta180
Fonte com bateria (12 V)150
Gabinete e gaveteiro cortados em CNC750
Ferragens150
Montagem (8 h)320
Total por unidade~2.280

Uma unidade atende 20 leitos. O teto de R$ 4 milhões citado para as soluções comerciais pagaria mais de 1.700 dispensários abertos. O servidor é um só para todas as unidades: uma VM pequena custa algo como R$ 60 por mês.

Rumo a um modelo aberto

O protótipo nasceu para um cliente, mas tudo nele pode servir a outros hospitais.

Os arquivos de corte, o gerador paramétrico e o design system já são públicos, sob licenças GPL v2 e MIT. Um hospital com acesso a uma cortadora a laser, ou a uma marcenaria com CNC, consegue reproduzir o gabinete trocando números num JSON. O firmware decide tudo localmente e o servidor não tem nenhuma dependência externa, então cabe numa máquina do próprio hospital.

Para virar um projeto aberto de verdade faltam três coisas: uma placa de circuito única no lugar da protoboard, a integração com sistemas hospitalares por um padrão aberto em vez de uma API específica, e conversas com profissionais de outras instituições para validar os requisitos fora do Mário Penna.

AnteriorRequisitosPróximaEletrônica