Skip to content

Documento de Visão

Valéria Cristina Galindo de Lima edited this page Sep 9, 2026 · 2 revisions

Documento de Visão - QuaLeiDer

1. Introdução

1.1 Contexto

A produção leiteira de pequeno e médio porte depende do registro frequente de informações sobre o rebanho, as ordenhas e o volume produzido. Quando esses dados são mantidos em cadernos, planilhas isoladas ou apenas na memória dos trabalhadores, tornam-se mais suscetíveis a perdas, inconsistências e atrasos. Esse cenário dificulta o acompanhamento da produtividade, a identificação de variações, a prestação de contas e a tomada de decisão por produtores e organizações rurais.

O QuaLeiDer surge no contexto do Instituto Federal de Pernambuco (IFPE) como uma solução digital voltada à gestão da produção leiteira. O projeto aproxima tecnologia, educação e desenvolvimento rural ao oferecer uma plataforma centralizada para produtores, funcionários e associações. Sua identidade visual considera os padrões institucionais do IFPE e as boas práticas de acessibilidade, responsividade e experiência do usuário aplicáveis a serviços digitais públicos.

1.2 Visão Geral do Projeto

O QuaLeiDer é uma plataforma web responsiva para gestão de produtores, funcionários, associações, rebanhos e coletas diárias de leite. O sistema permite registrar a produção total e individual por animal, manter dados de identificação, espécie, raça e parentesco do rebanho, consultar históricos, acompanhar indicadores e gerar relatórios gerenciais.

A plataforma atende dois contextos complementares:

  • propriedades rurais, nas quais administradores gerenciam o rebanho e podem cadastrar funcionários com permissões limitadas;
  • associações, que reúnem produtores, enviam convites, acompanham associados e rebanhos, emitem notificações e consultam relatórios consolidados.

O acesso é protegido por autenticação, recuperação de senha e controle de autorização por perfil. Administradores possuem prerrogativas de gestão, enquanto funcionários atuam somente nos recursos operacionais permitidos e não podem executar ações administrativas, como cadastrar usuários, inativar animais ou alterar recursos de terceiros.

Tecnicamente, a solução é composta por frontend em Next.js e React, API REST em NestJS, persistência em PostgreSQL por meio do Prisma ORM e infraestrutura conteinerizada. O processo de entrega utiliza integração contínua, testes automatizados, análise estática e verificação de vulnerabilidades.

2. Objetivos do Projeto

2.1 Objetivo Geral

Disponibilizar uma plataforma web segura, acessível e responsiva que centralize a gestão da produção leiteira, melhore a rastreabilidade dos dados do rebanho e das coletas e apoie produtores e associações na tomada de decisões operacionais e gerenciais.

2.2 Objetivos Específicos (SMART)

Critério Descrição
Específico Digitalizar o cadastro de produtores, funcionários, associações e animais; o registro diário da produção; o acompanhamento histórico; e a geração de indicadores e relatórios.
Mensurável Permitir que 100% das coletas cadastradas sejam vinculadas ao usuário responsável e, quando informada a produção individual, aos respectivos animais; manter histórico consultável; e acompanhar disponibilidade, falhas de validação, cobertura de testes e vulnerabilidades críticas ou altas.
Atingível Utilizar uma arquitetura web e tecnologias consolidadas, com entregas incrementais, validações automatizadas, documentação da API, conteinerização e implantação em infraestrutura de nuvem compatível com o projeto.
Relevante Reduzir registros dispersos e retrabalho, ampliar a confiabilidade das informações e oferecer dados úteis para produtores, funcionários e associações rurais.
Temporal Consolidar as funções essenciais a cada ciclo de versão; revisar qualidade e segurança antes de cada release; e avaliar os indicadores de uso, desempenho e confiabilidade ao fim de cada semestre letivo ou ciclo institucional definido pelo projeto.

Como resultados específicos, o projeto busca:

  1. centralizar os dados cadastrais e produtivos em uma única fonte de informação;
  2. permitir o registro diário da quantidade de leite, número de animais, ordenhas, lactação, alimentação, local de ordenha e assistência técnica;
  3. registrar a contribuição individual dos animais e o resultado opcional do teste CMT;
  4. manter a identificação e a genealogia básica do rebanho;
  5. oferecer dashboards, histórico, métricas mensais e ranking de produtores;
  6. apoiar a comunicação entre associações e associados por convites e notificações;
  7. assegurar segregação de acesso entre administradores, funcionários e organizações;
  8. manter a aplicação utilizável em computadores e celulares;
  9. garantir qualidade por meio de testes, revisão contínua e controles automatizados de segurança.

3. Justificativa do Projeto

A qualidade das decisões na atividade leiteira depende da qualidade dos registros disponíveis. Processos manuais dificultam a comparação entre períodos, a identificação de animais mais produtivos, o acompanhamento do rebanho e a consolidação de informações de diversos produtores. Também aumentam o risco de registros incompletos, duplicados ou inacessíveis no momento em que são necessários.

O QuaLeiDer é relevante porque transforma dados operacionais em informação organizada e rastreável. Para o produtor, facilita o acompanhamento diário da propriedade. Para o funcionário, fornece um fluxo padronizado de registro. Para a associação, oferece uma visão consolidada dos associados e da produção, favorecendo planejamento, assistência e comunicação. Para o IFPE, o projeto constitui uma aplicação prática de ensino, pesquisa, extensão e inovação relacionada às necessidades da comunidade rural.

A adoção de uma solução web responsiva reduz a barreira de acesso, pois permite o uso em computadores e celulares sem exigir a instalação de um aplicativo nativo. A arquitetura modular e a automação de testes, builds, análises de código e scans de dependências contribuem para evolução sustentável, segurança e manutenção do sistema.

4. Stakeholders

4.1 Identificação de Stakeholders

Stakeholder Descrição Interesses
Produtores/Administradores Responsáveis pela propriedade e pela administração de usuários, animais e produção. Controle do rebanho, confiabilidade dos registros, indicadores de produção, facilidade de uso e segurança dos dados.
Funcionários/Vaqueiros Usuários operacionais vinculados a um administrador e responsáveis por atividades de registro autorizadas. Cadastro rápido e correto das coletas, consulta das informações necessárias e interface adequada ao uso móvel.
Associações e cooperativas Organizações que agregam produtores e acompanham informações consolidadas. Gestão de associados, convites, comunicação, métricas de rebanho, relatórios mensais e ranking de produção.
Gestores e técnicos do setor rural Profissionais que apoiam planejamento, acompanhamento e assistência aos produtores. Dados consistentes, histórico, indicadores e relatórios que apoiem decisões e ações técnicas.
Alunos Discentes participantes do desenvolvimento, da validação ou do uso acadêmico do projeto. Aprendizagem prática, aplicação de conhecimentos, produção de evidências acadêmicas e impacto social.
Orientadores Docentes responsáveis pela orientação técnica, científica e metodológica. Coerência entre problema e solução, qualidade acadêmica, viabilidade e evolução controlada do projeto.
Banca avaliadora Professores e especialistas responsáveis pela avaliação acadêmica. Clareza dos objetivos, fundamentação, qualidade da implementação, resultados e contribuição do trabalho.
Coordenação do curso/campus Área institucional que acompanha atividades acadêmicas e projetos desenvolvidos no IFPE. Alinhamento institucional, cumprimento de requisitos acadêmicos e geração de valor para a comunidade.
Biblioteca Setor responsável por orientar normalização, catalogação e depósito da produção acadêmica. Conformidade documental, referências adequadas, preservação e disponibilização do trabalho.
Desenvolvedores e mantenedores Equipe responsável por análise, implementação, testes, implantação, segurança e manutenção. Requisitos claros, arquitetura sustentável, qualidade do código, automação, observabilidade e redução de riscos técnicos.
IFPE Instituição à qual o projeto está vinculado e cuja identidade é representada na solução. Uso correto da identidade institucional, contribuição educacional e social, acessibilidade e aderência às boas práticas institucionais.
Titulares dos dados Pessoas e organizações cujos dados cadastrais e produtivos são processados. Privacidade, transparência, integridade, disponibilidade e uso legítimo das informações.

5. Escopo do Projeto

5.1 Escopo Inclusões

O escopo do QuaLeiDer contempla:

  • cadastro, autenticação e recuperação de senha de usuários;
  • perfis de administrador e funcionário, com autorização baseada em função e vínculo com a propriedade;
  • cadastro e manutenção de produtores, funcionários, associações e cooperativas;
  • verificação de unicidade de e-mail, CPF/CNPJ e identificadores relevantes;
  • cadastro, consulta, edição e inativação de animais por usuários autorizados;
  • gestão de espécies, raças, identificação, idade, tipo e parentesco dos animais;
  • registro de coletas diárias, produção total e produção individual por animal;
  • registro de informações da ordenha e de resultado CMT quando aplicável;
  • consulta, edição controlada e histórico das coletas;
  • dashboards com indicadores e visualizações da produção;
  • métricas de associados e rebanhos para associações;
  • relatórios mensais, filtros, exportação e ranking de produtores;
  • convites para vinculação de produtores a associações, com prazo e estado de resposta;
  • notificações internas e controle de leitura;
  • interface responsiva para computadores e celulares, alinhada à identidade institucional adotada;
  • API documentada e validação dos dados de entrada;
  • banco de dados relacional com rastreabilidade de criação e atualização;
  • implantação conteinerizada e automação de integração, testes, releases e verificações de segurança;
  • tratamento de falhas no envio de e-mails e mecanismos de acompanhamento operacional.

5.2 Escopo Exclusões

Não fazem parte do escopo atual:

  • controle financeiro, contábil, fiscal, folha de pagamento ou emissão de notas fiscais;
  • compra e venda de leite, animais, insumos ou serviços por marketplace;
  • processamento de pagamentos ou integração bancária;
  • diagnóstico veterinário automático ou substituição de avaliação profissional;
  • prescrição de medicamentos, gestão clínica completa ou prontuário veterinário;
  • integração direta com sensores, ordenhadeiras, balanças ou dispositivos de Internet das Coisas;
  • rastreamento geográfico em tempo real dos animais;
  • gestão completa de estoque, alimentação, reprodução ou cadeia logística;
  • aplicativo móvel nativo ou operação integral sem conexão com a internet;
  • integração automática com sistemas governamentais, laboratórios, laticínios ou ERPs externos;
  • disponibilização pública de dados pessoais ou produtivos;
  • garantia de conectividade, equipamentos ou suporte técnico presencial nas propriedades;
  • análises preditivas ou recomendações automatizadas baseadas em inteligência artificial.

Esses itens poderão ser avaliados em versões futuras mediante validação com os stakeholders, análise de viabilidade, requisitos de privacidade e definição formal de novo escopo.

6. Conclusão

O QuaLeiDer apresenta uma visão integrada para a gestão da produção leiteira, conectando registros de campo, controle do rebanho e acompanhamento gerencial em uma plataforma única. O projeto responde a uma necessidade concreta de organização e rastreabilidade, ao mesmo tempo que cria oportunidades de ensino, pesquisa, extensão e inovação no IFPE.

A visão definida neste documento orienta a evolução do produto e estabelece limites para evitar expansão não controlada do escopo. O sucesso da solução depende não apenas da implementação das funcionalidades, mas também da adoção pelos usuários, da qualidade dos dados registrados, da proteção das informações e da revisão contínua dos objetivos com produtores, associações e representantes institucionais.

Clone this wiki locally