Repository navigation
Documento de Visão
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.
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.
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.
| 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:
- centralizar os dados cadastrais e produtivos em uma única fonte de informação;
- 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;
- registrar a contribuição individual dos animais e o resultado opcional do teste CMT;
- manter a identificação e a genealogia básica do rebanho;
- oferecer dashboards, histórico, métricas mensais e ranking de produtores;
- apoiar a comunicação entre associações e associados por convites e notificações;
- assegurar segregação de acesso entre administradores, funcionários e organizações;
- manter a aplicação utilizável em computadores e celulares;
- garantir qualidade por meio de testes, revisão contínua e controles automatizados de segurança.
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.
| 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. |
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.
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.
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.