Skip to main content

User Stories

  No método ágil, a satisfação do usuário ocupa um papel central, e uma das formas de torná-la visível é por meio das User Stories ou histórias de usuário (Domingo, 2021). Essas histórias são frases curtas, específicas e objetivas que funcionam como requisitos do usuário (Domingo, 2021; Cohn, 2019).

  Geralmente, essa histórias seguem o seguinte formato: "Eu, enquanto [tipo de usuário], quero [algum objetivo] para que [alguma razão]" (Cohn, 2019). Esse modelo incentiva a empatia dos desenvolvedores, que passam a enxergar as necessidades do usuário, não obstante a realização ou não de uma UX research (Domingo, 2021).

  Segundo Jeffries (2001, apud Cohn, 2019), uma boa User Story segue a estrutura conhecida como "Card, Conversation, Confirmation". No contexto deste documento, essas categorias correspondem às seguintes definições:

  • User Story: descrição curta utilizando o formato padrão;
  • Critérios de Aceite: detalhes que definem quando uma história pode ser considerada completa;
  • Testes de aceitação: testes para validar os critérios de aceite mencionados.

  Essas informações foram organizadas em formato de tabela, apresentando as necessidades dos usuários no projeto de automação PharmaBot.

Técnico de Farmácia: Roberto Dias

Tabela 1 - User Story 001
IdentificaçãoUS001
User StoryEu, enquanto técnico de farmácia, quero ter um acesso pessoal na plataforma para que eu acesse apenas as páginas que me competem.
Critérios de aceite 1Existe uma página de login que possibilita inserir email e senha.
Teste de AceitaçãoO técnico abre a plataforma.
T01A: Aparece uma página de login em que é possível inserir dois inputs: email e senha.
T01B: Não aparece uma página de login ou a página de login não contém os campos de email e senha. Errado, precisa ser corrigido
Critério de aceite 2Há um pop-up que orienta o usuário em caso de esquecimento de senha.
Teste de AceitaçãoO técnico aperta em "Esqueci a senha".
T02A: Aparece um pop-up escrito "Comunique a administração".
T02B: Não aparece um pop-up ou a informação contida nele está incorreta. Errado, precisa ser corrigido
Critério de aceite 3A página de login redireciona o usuário para outra página.
Teste de AceitaçãoO técnico insere seu email e senha cadastrados e clica em "Entrar".
T03A: O usuário é redirecionado para outra página.
T03B: O usuário não é redirecionado para outra página. Errado, precisa ser corrigido
Critério de aceite 4O usuário é redirecionado para sua página pessoal.
Teste de AceitaçãoO técnico aperta em "Entrar" na página de login.
T04A: O usuário é redirecionado para sua página pessoal.
T04B: O usuário não é redirecionado para sua página pessoal. Errado, precisa ser corrigido
Critério de aceite 5A página de login orienta o usuário, caso ele tenha inserido dados errados.
Teste de AceitaçãoO técnico aperta em "Entrar" tendo inserido com informações incorretas de cadastro.
T05A: A página exibe o erro "Email e/ou senha incorretos".
T05B: A página não exibe um erro ou redireciona o usuário para outra página. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 2 - User Story 002
IdentificaçãoUS002
User StoryEu, enquanto técnico de farmácia, quero poder parar o robô via software a qualquer momento para que eu possa fazer alterações manuais nas fitas.
Critérios de aceite 1A página inicial exibe o estado do robô.
Teste de AceitaçãoO técnico se loga na plataforma.
T01A: A página inicial exibe "Ativo", "Inativo" ou "Desligado" a depender do estado do robô
T01B: A página inicial não exibe qualquer estado ou exibe um estado inconsistente com a realidade. Errado, precisa ser corrigido
Critério de aceite 2Existe um botão para parar o robô.
Teste de AceitaçãoO robô está separando remédios.
T02A: O estado do robô exibe "Ativo" e existe um botão ativo escrito "Parar".
T02B: O botão "Parar" está inativo quando o estado está ativo ou está ativo quando o robô está em outros estados. Errado, precisa ser corrigido
Critério de aceite 3O botão para o robô.
Teste de AceitaçãoO técnico aperta em "Parar".
T03A: O estado muda para "Inativo" e o robô para de separar fitas.
T03B: O estado não muda ou o robô não para de separar. Errado, precisa ser corrigido
Critério de aceite 4O estado atual de separação da fita de medicamentos fica salvo quando o robô é parado
Teste de AceitaçãoO técnico aperta em "Parar".
T04A: A fita de medicamentos atual é posta em estado de espera.
T04B: A fita de medicamentos não é salva, a fita de medicamentos não fica em espera. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 3 - User Story 003
IdentificaçãoUS003
User StoryEu, enquanto técnico de farmácia, quero ver a fita que está atualmente em separação pelo robô para que eu possa ter uma melhor compreensão do processo.
Critérios de aceite 1A página inicial exibe a prescrição completa que está sendo separada
Teste de AceitaçãoO técnico se loga na plataforma.
T01A: A página inicial exibe a prescrição completa que está sendo preparada.
T01B: A página inicial não exibe qualquer prescrição ou a prescrição está incompleta. Errado, precisa ser corrigido
Critério de aceite 2A prescrição atual corresponde a fita sendo separada
Teste de AceitaçãoO robô está separando os remédios.
T02A: O robô está separando os remédios da prescrição exibida na página inicial.
T02B: O robô não está separando os remédios da prescrição atual. Errado, precisa ser corrigido
Critério de aceite 3A prescrição atual sinaliza visualmente qual remédio está sendo separado
Teste de AceitaçãoO robô está separando os remédios.
T03A: A página exibe o remédio que o robô está separando.
T03B: A página não sinaliza qual remédio está sendo separado ou o remédio que está sendo exibido não corresponde com a atualidade. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 4 - User Story 004
IdentificaçãoUS004
User StoryEu, enquanto técnico de farmácia, quero filtrar as últimas fitas separadas para que eu possa checar as separações.
Critérios de aceite 1Todas as prescrições são guardadas na plataforma
Teste de AceitaçãoO técnico navega até o histórico sem filtrar.
T01A: É possível verificar todos os últimos pedidos guardados na plataforma.
T01B: O histórico não exibe nenhum dados ou exibe dados inconsistentes com as últimas prescrições enviadas. Errado, precisa ser corrigido
Critério de aceite 2É possível filtrar as prescrições com base em remédio contido
Teste de AceitaçãoO técnico seleciona um remédio no filtro de histórico.
T02A: Apenas as prescrições que contém aquele remédio aparecem.
T02B: Nenhuma prescrição aparece ou prescrições que não contém aquele remédio também aparecem. Errado, precisa ser corrigido
Critério de aceite 3As prescrições estão ordenadas por data
Teste de AceitaçãoO técnico navega até histórico.
T03A: As prescrições estão ordenadas do mais recente ao mais antigo
T03B: As prescrições estão ordenadas de qualquer outro modo que não do mais recente ao mais antigo. Errado, precisa ser corrigido
Critério de aceite 4As prescrições contém uma identificação
Teste de AceitaçãoO técnico navega até histórico.
T04A: As prescrições contém um id que é a primeira coluna do histórico
T04B: As prescrições não exibem o id ou este id não é a primeira coluna. Errado, precisa ser corrigido
Critério de aceite 5É possível filtrar por período
Teste de AceitaçãoO técnico navega até histórico e seleciona filtro por período.
T05A: As prescrições podem ser filtradas por uma data personalizada
T05B: As presções não podem ser filtradas por período ou a data não é personalizável. Errado, precisa ser corrigido
Critério de aceite 6Os itens do histórico são interativos
Teste de AceitaçãoO técnico seleciona um item do histórico.
T06A: Um pop-up aparece, contendo: data e hora recebida, data e hora separada, itens requisitados e itens separados.
T06B: Não é possível selecionar um item, o pop-up não aparece ou as informações estão incompletas. Errado, precisa ser corrigido
Critério de aceite 7O histórico contém paginação
Teste de AceitaçãoO técnico navega até o histórico.
T07A: As prescrições estão separadas em páginas, limitando os resultados exibidos por página padronizadamente.
T07B: As prescrições não estão separadas por página ou um número limite padrão de itens não está estabelecido. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 5 - User Story 005
IdentificaçãoUS005
User StoryEu, enquanto técnico de farmácia, quero poder retomar a operação do robô para que ele continue a separação
Critérios de aceite 1A página inicial exibe o estado do robô.
Teste de AceitaçãoO técnico se loga na plataforma.
T01A: A página inicial exibe "Ativo", "Inativo" ou "Desligado" a depender do estado do robô
T01B: A página inicial não exibe qualquer estado ou exibe um estado inconsistente com a realidade. Errado, precisa ser corrigido
Critério de aceite 2Existe um botão para retomar o robô.
Teste de AceitaçãoO robô está parado.
T02A: O estado do robô exibe "Inativo" e existe um botão ativo escrito "Retomar".
T02B: O botão "Retomar" está inativo quando o estado está inativo ou está ativo quando o robô está em outros estados. Errado, precisa ser corrigido
Critério de aceite 3O botão retoma a operação do robô.
Teste de AceitaçãoO técnico aperta em "Retomar".
T03A: O estado muda para "Ativo" e o robô volta a separar a fita em espera.
T03B: O estado não muda, o robô não volta a separar ou não volta a separar a fita de medicamentos em espera. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 6 - User Story 006
IdentificaçãoUS006
User StoryEu, enquanto técnico de farmácia, quero ver as fitas que ainda serão separadas para que eu possa ter maior controle da operação
Critérios de aceite 1A página aceita diversas requisições
Teste de AceitaçãoO farmacêutico tria um medicamento e envia para a plataforma.
T01A: A página recebe e guarda corretamente a requisição do farmacêutico
T01B: A página não recebe a requisição do farmacêutico ou a requisição está incompleta. Errado, precisa ser corrigido
Critério de aceite 2A fila de fita de medicamentos a serem separados aparecem na tela inicial
Teste de AceitaçãoO técnico entra na página inicial.
T02A: A página inicial exibe as requisições de separação enviadas pelo farmacêutico que ainda não foram separadas.
T02B: A página não exibe as requisições de separação enviadas pelo farmacêutico ou as prescrições exibidas já foram separadas. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 7 - User Story 007
IdentificaçãoUS007
User StoryEu, enquanto técnico de farmácia, quero poder configurar as bins de cada remédio para que eu possa adaptar o sistema quando necessário
Critérios de aceite 1Existe uma página de configuração
Teste de AceitaçãoO técnico navega até a página de configuração.
T01A: A página exibe a localização atual do robô e permite que o farmacêutico responda itens de uma lista para o envio de uma nova localização de remédio
T01B: A página não exibe a localização atual do robô ou não permite que o farmacêutico insira novas localizações. Errado, precisa ser corrigido
Critério de aceite 2Os itens para determinar uma localização podem ser preenchidos manualmente
Teste de AceitaçãoO técnico navega até a página de configuração.
T02A: Na seção "Enviar Novas Localizações" é possível enviar o nome do remédio e as coordenadas x, y, z dos bins.
T02B: Os itens "nome do remédio", "x", "y", "z" não constam ou não podem ser preenchidos pelo usuário. Errado, precisa ser corrigido
Critério de aceite 3O preenchimento manual das localizações tem restrições de segurança
Teste de AceitaçãoO técnico tenta enviar uma coordernada contendo uma letra.
T03A: O sistema exibe um aviso indicando erro no preenchimento do formulário.
T03B: A localização é enviada para o microcontrolador ou não é enviada, mas nenhum aviso é exibido. Errado, precisa ser corrigido
Critério de aceite 4É possível enviar mais de uma localização
Teste de AceitaçãoO técnico preenche uma localização.
T04A: Aparece um botão indicando a possibilidade de criar mais um item na lista que quando clicado exibe um novo formulário.
T04B: Não aparece um botão para adicionar item na lista ou quando clicado ele não exibe um novo formulário. Errado, precisa ser corrigido
Critério de aceite 5O robô recebe uma lista contendo as localizações x,y,z de cada remédio
Teste de AceitaçãoO técnico envia as localizações de cada remédio clicando em "Enviar" na página de configuração.
T05A: O microcontrolador recebe as novas localizações, guarda-as e substitui as localizações de um mesmo remédio pelas novas.
T05B: O microcontrolador não recebe as novas localizações ou não substitui as antigas localizações de remédios com novas localizações. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 8 - User Story 008
IdentificaçãoUS008
User StoryEu, enquanto técnico de farmácia, quero que o robô emita um som caso não consiga achar um remédio para que eu possa auxiliar no processo.
Critérios de aceite 1O robô tenta procurar o remédio com localização conhecida
Teste de AceitaçãoO robô inicia a separação de um remédio.
T01A: O braço robótico vai até a localização correspondente ao remédio no seu sistema
T01B: O braço robótico não vai até a localização correspondente ao remédio no seu sistema. Errado, precisa ser corrigido
Critério de aceite 2O robô emite um som após um minuto de tentativa
Teste de AceitaçãoPor um minuto, o sensor de infravermelho não reconheceu que o robô pegou um remédio.
T02A: O buzzer na protoboard emite um som curto.
T02B: O buzzer na protoboard não emite som ou o som é longo. Errado, precisa ser corrigido
Critério de aceite 3O robô tenta por mais um minuto após emitir o som
Teste de AceitaçãoO buzzer emitiu um som por não encontrar um remédio de localização conhecida.
T03A: O robô continua tentando encontrar o remédio na localização requisitada durante um minuto
T03B: O robô não continua tentando encontrar o remédio ou não para de procurá-lo após um minuto. Errado, precisa ser corrigido
Critério de aceite 4O robô emite um som se não conhecer a localização de um remédio
Teste de AceitaçãoO robô tenta separar um remédio com localização desconhecida.
T04A: O buzzer na protoboard emite um som longo.
T04B: O buzzer na protoboard não emite som ou o som é curto. Errado, precisa ser corrigido
Critério de aceite 5O robô passa para o próximo item
Teste de AceitaçãoO robô não encontrou um item durante dois minutos ou não conhece sua localização.
T05A: O robô começa a separar o próximo remédio da lista.
T05B: O robô não começa a separar o próximo item da lista. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 9 - User Story 009
IdentificaçãoUS009
User StoryEu, enquanto técnico de farmácia, quero que o sistema sinalize as separações incompletas para que eu possa ajustá-las manualmente.
Critérios de aceite 1Na fita de medicamentos atual, remédios não encontrados são sinalizados
Teste de AceitaçãoO robô não conseguiu localizar um medicamento contido na prescrição atual.
T01A: O sistema sinaliza de forma clara o medicamento que não foi separado
T01B: O sistema não sinaliza de forma clara o medicamento que não foi separado. Errado, precisa ser corrigido
Critério de aceite 2Remédios não separados são sinalizados no histórico
Teste de AceitaçãoO técnico seleciona um item do histórico que está incompleto.
T02A: Os remédios que o robô não conseguiu separar são claramente sinalizados.
T02B: Os remédios que o robô não conseguiu separar não são claramente sinalizados. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Farmacêutica: Lara Oliveira

Tabela 10 - User Story 010
IdentificaçãoUS010
User StoryEu, como farmacêutica, quero ter acesso a informações do estoque em tempo real para que eu possa saber a quantidade disponível de cada medicamento
Critérios de aceite 1O site exibe uma página que mostra uma tabela com dados do estoque de medicamentos em tempo real
Teste de AceitaçãoA farmacêutica se loga na plataforma e vai até a página de estoque.
T01A: a página de estoque mostra uma tabela com todos os medicamentos cadastrados no estoque, as informações do medicamento mostradas incluem ID, nome do medicamento, data de validade, lote, data de entrada, quantidade e ID do bin em que está localizado
T01B: a página de estoque não mostra a tabela com medicamentos, ou os dados estão incompletos, incorretos ou desatualizados. Errado, precisa ser corrigido
Critério de aceite 2Existe uma barra de pesquisa para pesquisar medicamentos específicos
Teste de AceitaçãoConsigo pesquisar medicamentos específicos pelo nome ou lote
T02A: É possível encontrar e clicar na barra de pesquisa, mostrando o resultado da pesquisa na tabela após digitar o nome ou lote de algum medicamento
T02B: Não é possível encontrar a barra de pesquisa ou a pesquisa retorna resultados errados/incompletos. Errado, precisa ser corrigido
Critério de aceite 3A farmacêutica deseja registrar manualmente o registro de saída de um kit de medicamentos
Teste de AceitaçãoA farmacêutica faz o registro da quantidade e dos medicamentos que foram retirados do estoque manualmente
T03A: o registro é enviado ao banco de dados e as informações do estoque de medicamentos são atualizadas
T03B: o registro não é enviado ao banco de dados, ou é enviado com informações incorretas/incompletas. Errado, precisa ser corrigido
Critério de aceite 4A farmacêutica deseja registrar manualmente a chegada de uma nova leva de medicamentos no estoque
Teste de AceitaçãoA farmacêutica faz o registro da quantidade e dos medicamentos que chegaram no estoque
T04A: o registro é enviado ao banco de dados e as informações do estoque de medicamentos são atualizadas
T04B: o registro não é enviado ao banco de dados, ou é enviado com informações incorretas/incompletas. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 11 - User Story 011
IdentificaçãoUS011
User StoryEu, como farmacêutica, quero checar informações sobre o processo de bipagem automática para que eu tenha conhecimento sobre qualquer ocorrido fora do comum no processo de separação, como falta de medicamentos ou outros problemas no processo de separação
Critérios de aceite 1Através da página inicial, é possível ver os kits em que a separação e bipagem já foram concluidas
Teste de AceitaçãoA farmacêutica abre a página inicial, visando verificar as informações do sistema
T01A: A página inicial exibe todas as informações relacionadas ao estado atual do robô e a fila de pedidos
T01B: A página inicial não exibe as informações, ou exibe informações incompletas ou desatualizadas. Errado, precisa ser corrigido
Critério de aceite 2Ao analisar a lista de kits com medicamentos separados e bipados, é possível saber quais kits precisam passar pelo processo de triagem
Teste de AceitaçãoA farmacêutica checa no sistema a lista de kits concluídos
T02A: A página mostra em tempo real a lista de kits que já foram separados e bipados
T02B: A página não mostra os kits que já foram separados ou bipados, ou mostra as informações desatualizadas ou erradas. Errado, precisa ser corrigido
Critério de aceite 3A farmacêutica faz a triagem manual dos kits, com a lista fornecida pelo sistema
Teste de AceitaçãoA farmacêutica faz a triagem, pegando cada medicamento do kit e verificando se ele condiz com a receita
T03A: A triagem é concluída com sucesso, garantindo que o kit foi montado corretamente
T03B: A triagem não é concluída, ou, após a triagem, a farmacêutica chega a conclusão que o kit foi montado de forma incorreta. Errado, precisa ser corrigido
Critério de aceite 4O processo de triagem é concluído, e agora os kits estão prontos para envio aos pacientes
Teste de AceitaçãoA farmacêutica libera o kit de medicamentos para envio aos pacientes
T04A: O kit é liberado para uso dos pacientes
T04B: O kit não é liberado, por uma variedade de motivos, como kit incompleto, medicamentos fora da validade e etc. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 12 - User Story 012
IdentificaçãoUS012
User StoryEu, como farmacêutica, quero registrar a devolução de medicamentos não utilizados para que eles sejam contabilizados novamente no estoque
Critérios de aceite 1Através da página de estoque, é possível abrir uma requisição de retorno de medicamentos ao estoque
Teste de AceitaçãoA página de estoque exibe a opção de registrar a devolução de medicamentos ao estoque
T01A: A página de estoque permite que você encontre a opção de devolver medicamentos
T01B: A página de estoque não exibe todas as funcionalidades, ou não permite o acesso. Errado, precisa ser corrigido
Critério de aceite 2A farmacêutica, registra os medicamentos que estão sendo devolvidos, e envia o registro.
Teste de AceitaçãoExiste uma página para envio dos dados dos medicamentos devolvidos
T02A: O registro de devolução de medicamentos foi enviado e cadastrado com sucesso
T02B: A página não permite o registro da devolução de medicamentos. Errado, precisa ser corrigido
Critério de aceite 3Os medicamentos são cadastrados como devoluções, são armazenados no estoque, e o sistema volta a contabilizar-los.
Teste de AceitaçãoO sistema cadastra a devolução e registra os medicamentos no estoque
T03A: O banco de dados do estoque é atualizado, e os medicamentos são marcados como devolução
T03B: O banco de dados não é atualizado, ou os medicamentos não são marcados como devolução. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 13 - User Story 013
IdentificaçãoUS013
User StoryEu, como farmacêutica, quero fazer pedidos de reposição do estoque para que eu possa manter o estoque sempre abastecido
Critérios de aceite 1Através da página de estoque, é possível registrar a entrada de uma nova leva de medicamentos
Teste de AceitaçãoA farmacêutica abre a página de estoque
T01A: A página de estoque exibe as informações do estoque e as funcionalidades disponíveis
T01B: A página de estoque não exibe as informações, ou não permite utilizar as funcionalidades da página. Errado, precisa ser corrigido
Critério de aceite 2A farmacêutica preenche os dados dos medicamentos que chegaram no estoque.
Teste de AceitaçãoO sistema permite o preenchimento das informações sobre a nova leva de medicamentos
T02A: A página mostra o formulário de preenchimento das informações
T02B: A página não permite preencher as informações, ou não envia o registro. Errado, precisa ser corrigido
Critério de aceite 3A farmacêutica registra a nova leva de medicamentos e checa a adição deles ao banco de dados do estoque
Teste de AceitaçãoO sistema confirma o registro dos medicamentos e atualiza tanto o banco de dados quanto a página de estoque com os medicamentos e quantidades atualizadas
T03A: A farmacêutica consegue visualizar na página de estoque as alterações no banco de dados após o registro da nova leva de medicamentos
T03B: Não é possível visualizar os novos medicamentos cadastrados, ou a página está desatualizada. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).

Tabela 14 - User Story 014
IdentificaçãoUS014
User StoryEu, como farmacêutica, desejo exportar um relatório do estoque para que eu possa compartilhar as informações com outros departamentos
Critérios de aceite 1Através da página de estoque, é possível selecionar a opção de exportar relatório
Teste de AceitaçãoA farmacêutica abre a página de estoque
T01A: A página de estoque exibe a opção de exportar relatório
T01B: A página de estoque não exibe a opção de exportar relatório. Errado, precisa ser corrigido
Critério de aceite 2A farmacêutica pode escolher o formato do relatório (PDF, Excel, etc)
Teste de AceitaçãoO sistema permite a seleção do formato do relatório
T02A: A página exibe opções de formato para exportação
T02B: A página não exibe opções de formato para exportação. Errado, precisa ser corrigido
Critério de aceite 3A farmacêutica pode filtrar as informações que deseja incluir no relatório
Teste de AceitaçãoO sistema permite a seleção de filtros para o relatório
T03A: A página exibe opções de filtros para personalizar o relatório
T03B: A página não exibe opções de filtros para personalizar o relatório. Errado, precisa ser corrigido
Critério de aceite 4O relatório é gerado e disponibilizado para download
Teste de AceitaçãoO sistema gera o relatório e disponibiliza para download
T04A: O relatório é gerado e um link para download é exibido
T04B: O relatório não é gerado ou o link para download não é exibido. Errado, precisa ser corrigido
Fonte: Autoria Própria (2025).