Repository navigation
User Stories
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.
| 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.
| 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 |
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.brentram 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
statedo OAuth para impedir CSRF de login.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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).
Como admin, quero cadastrar, editar e excluir os destinos do leite, para manter a lista atualizada.
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.
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.
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.
- 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.