Files
Refood-One/docs/user-stories/00-Generic/US10-nome-beneficiario-botao.md
2026-05-31 20:22:50 +01:00

1.9 KiB

US10 - Nome do Beneficiário no Botão de Entrega

Como Voluntário do RefoodOne Quero que o primeiro nome do beneficiário seja exibido por baixo do seu número no botão de registo de entrega Para facilitar a identificação visual rápida do beneficiário antes de clicar e reduzir a probabilidade de enganos no registo.

Descrição do Fluxo

Ao aceder ao ecrã de registo de entregas ("Entregas"), o voluntário vê a grelha de botões táteis. Cada botão agora exibe não apenas o número do beneficiário (ex: "#124"), mas também o seu primeiro nome (ex: "João") logo abaixo do número, numa fonte menor e legível.

Critérios de Aceitação

1. Interface Gráfica (UI)

  • Rótulo do Botão (Button Label):
    • O Número do Beneficiário continua a ser exibido em destaque na parte superior do botão.
    • O Primeiro Nome do beneficiário deve ser exibido logo abaixo do número, centralizado, com estilo de texto menor (ex: classe Bootstrap small ou text-muted).
  • Tratamento do Nome:
    • Deve ser exibido apenas o primeiro nome (a primeira palavra do campo name na base de dados). Exemplo: "Maria Eduarda Santos" deve ser exibido como "Maria".
    • O texto do nome deve ser ajustado ou truncado se necessário, para garantir que não quebre o layout quadrado do botão tátil.

2. Comportamento e Regras de Negócio

  • O sistema deve extrair de forma robusta o primeiro nome a partir do nome completo registado na tabela beneficiaries.
  • Se o campo do nome contiver apenas um nome, exibe esse nome normalmente.
  • Se o nome contiver espaços ou hífens, extrai a primeira palavra delimitada por espaços.

3. Integração de Dados

  • Os dados do beneficiário (name e number) são os mesmos carregados a partir da tabela beneficiaries no servidor. Não são necessárias alterações no modelo de dados da base de dados SQLite.