Skip to content

User Stories

jota edited this page Nov 17, 2026 · 2 revisions

📋 User Stories – QuaLact

Histórias de usuário do QuaLact no modelo atual do IFPE Campus Belo Jardim (v0.9.0): um admin fixo cuida do sistema e todo mundo que entra com o e-mail institucional vira vaqueiro. Todas as contas trabalham sobre o mesmo rebanho.

Formato: Como [papel], quero [ação], para [benefício], seguido dos critérios de aceitação. A coluna Status indica o que já está em produção em https://alexandrejota.me.

Papéis

Papel Quem é Como entra
Admin Responsável pelo sistema no campus (conta fixa, criada na implantação). E-mail e senha.
Vaqueiro Estudante ou servidor que registra a produção no dia a dia. Botão "Entrar com Google", com e-mail @ifpe.edu.br ou um e-mail externo liberado pelo admin.

Não existe cadastro público: ninguém cria conta sozinho.

Resumo

ID Épico História Status
US-01 Acesso Entrar com o Google institucional ✅ Em produção
US-02 Acesso Liberar e-mails de fora do IFPE ✅ Em produção
US-03 Acesso Admin entrar com e-mail e senha ✅ Em produção
US-04 Acesso Recuperar a senha do admin ✅ Em produção
US-05 Equipe Gerenciar os funcionários ✅ Em produção
US-06 Equipe Ver o histórico de atividade de um funcionário ✅ Em produção
US-07 Rebanho Cadastrar e editar animais ✅ Em produção
US-08 Rebanho Manter tipos de animal e raças ✅ Em produção
US-09 Rebanho Acompanhar a lactação de cada vaca ✅ Em produção
US-10 Coleta Registrar a coleta diária ✅ Em produção
US-11 Coleta Registrar o teste da caneca e o CMT por vaca ✅ Em produção
US-12 Coleta Informar o destino do leite ✅ Em produção
US-13 Coleta Manter os destinos do leite ✅ Em produção
US-14 Coleta Consultar e corrigir coletas registradas ✅ Em produção
US-15 Indicadores Ver o painel inicial ✅ Em produção
US-16 Indicadores Gerar o relatório mensal ✅ Em produção

Épico 1 – Acesso

US-01 – Entrar com o Google institucional

Como vaqueiro, quero entrar com a minha conta Google do IFPE, para usar o sistema sem criar e decorar outra senha.

Critérios de aceitação

  • A tela de login mostra o botão "Entrar com Google" e não oferece "Criar conta".
  • E-mails @ifpe.edu.br entram direto; no primeiro acesso a conta é criada como vaqueiro.
  • E-mails de outros domínios só entram se estiverem na lista liberada pelo admin (US-02); os demais veem uma mensagem de acesso negado.
  • O fluxo usa o parâmetro state do OAuth para impedir CSRF de login.

US-02 – Liberar e-mails de fora do IFPE

Como admin, quero liberar e-mails específicos que não são @ifpe.edu.br, para que colaboradores externos também possam registrar a produção.

Critérios de aceitação

  • O admin adiciona e remove e-mails numa lista.
  • Um e-mail liberado consegue entrar com Google e vira vaqueiro.
  • Ao remover um e-mail, a pessoa deixa de conseguir entrar.

US-03 – Admin entrar com e-mail e senha

Como admin, quero entrar com e-mail e senha, para administrar o sistema mesmo sem conta Google institucional.

Critérios de aceitação

  • Senha com no mínimo 8 caracteres, letra maiúscula, minúscula, número e caractere especial.
  • Tentativas em excesso são limitadas (rate limit por usuário e por IP) e mostram quanto tempo esperar.
  • Credenciais erradas mostram "Email ou senha incorretos", sem dizer qual dos dois está errado.

US-04 – Recuperar a senha do admin

Como admin, quero receber um código por e-mail para trocar a senha, para recuperar o acesso se eu a esquecer.

Critérios de aceitação

  • O código tem 6 dígitos e expira.
  • A nova senha segue as mesmas regras da US-03 e precisa ser confirmada.

Épico 2 – Equipe

US-05 – Gerenciar os funcionários

Como admin, quero ver, editar, inativar e reativar os funcionários, para controlar quem pode registrar dados.

Critérios de aceitação

  • A tela de Funcionários lista todos os vaqueiros em cartões.
  • O admin pode inativar e reativar uma conta; uma conta inativa não consegue entrar.
  • Um vaqueiro não acessa a tela de Funcionários nem altera o papel de ninguém (proteção contra escalada de privilégio).

US-06 – Ver o histórico de atividade de um funcionário

Como admin, quero ver o que cada funcionário fez e quando, para acompanhar o trabalho e investigar registros estranhos.

Critérios de aceitação

  • O histórico mostra login, coletas e animais criados ou editados, com data e hora.
  • A lista é paginada.
  • Só o admin vê o histórico.

Épico 3 – Rebanho

US-07 – Cadastrar e editar animais

Como vaqueiro, quero cadastrar e editar os animais do rebanho, para ter a ficha de cada vaca em um só lugar.

Critérios de aceitação

  • A ficha tem brinco, nome, tipo de animal, raça, idade (0 a 30 anos), mãe e pai.
  • Animais que saíram do rebanho podem ser inativados sem perder o histórico.
  • Todas as contas veem o mesmo rebanho.

US-08 – Manter tipos de animal e raças

Como admin, quero cadastrar os tipos de animal e as raças, para padronizar as fichas.

Critérios de aceitação

  • Só o admin cria, edita e exclui tipos e raças; o vaqueiro apenas escolhe da lista.

US-09 – Acompanhar a lactação de cada vaca

Como vaqueiro, quero registrar o número da cria e a data do último parto, para saber em que fase da lactação cada vaca está.

Critérios de aceitação

  • A ficha da vaca mostra o estágio de lactação e os dias desde o parto.
  • A curva de lactação mostra a produção da vaca ao longo dos dias desde o parto.

Épico 4 – Coleta

US-10 – Registrar a coleta diária

Como vaqueiro, quero registrar a produção do dia em um formulário por etapas, para lançar a ordenha de forma rápida, inclusive pelo celular.

Critérios de aceitação

  • A coleta tem data, quantidade total, número de animais e de ordenhas, se houve ração, local da ordenha (Aberto, Curral ou Ambos) e assistência técnica.
  • A produção pode ser lançada vaca por vaca, indicando a ordenha (1ª ou 2ª).
  • A coleta fica ligada a quem a registrou.

US-11 – Registrar o teste da caneca e o CMT por vaca

Como vaqueiro, quero marcar o teste da caneca e o CMT de cada vaca, para identificar sinais de mastite cedo.

Critérios de aceitação

  • Teste da caneca: Negativo ou Positivo.
  • CMT: Normal, Suspeito ou Positivo.
  • Os dois testes são registrados separadamente, por vaca.

US-12 – Informar o destino do leite

Como vaqueiro, quero escolher para onde foi o leite ao terminar a coleta, para que o campus saiba o que foi feito com a produção.

Critérios de aceitação

  • A última etapa da coleta mostra os destinos cadastrados (US-13).

US-13 – Manter os destinos do leite

Como admin, quero cadastrar, editar e excluir os destinos do leite, para manter a lista atualizada.

US-14 – Consultar e corrigir coletas registradas

Como admin, quero ver todas as coletas com autor e destino, para conferir a produção e corrigir lançamentos errados.

Critérios de aceitação

  • A lista mostra data, autor, quantidade e destino, com filtros.
  • O admin pode editar ou excluir uma coleta.

Épico 5 – Indicadores

US-15 – Ver o painel inicial

Como usuário, quero ver um resumo do rebanho e da produção ao entrar, para saber como está o dia sem abrir outras telas.

US-16 – Gerar o relatório mensal

Como admin, quero gerar o relatório de produção do mês e exportá-lo, para prestar contas e acompanhar a evolução.

Critérios de aceitação

  • O relatório mostra a produção total e por animal no mês escolhido.
  • Pode ser exportado em CSV e PDF.

Fora do escopo atual

  • Cadastro público de produtores e funcionários.
  • Associações e cooperativas (recurso removido na v0.9.0).
  • Mais de um rebanho ou mais de um admin.

Clone this wiki locally