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

27 lines
1.9 KiB
Markdown

# 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.