GitLab

Requisitos

Requisitos funcionais

• RF01 – Cadastro de produtores
  O sistema deve permitir cadastrar produtores de hortifrúti, incluindo dados pessoais, contato, endereço e informações básicas da propriedade.

• RF02 – Cadastro e gestão de áreas de plantio
  O sistema deve permitir criar, editar, visualizar e excluir áreas de plantio, associando cada área a um produtor.

• RF03 – Mapeamento das áreas no mapa
  O sistema deve permitir desenhar polígonos no mapa (Google Maps) representando as áreas de plantio, bem como exibir essas áreas sobre o mapa para consulta.

• RF04 – Cadastro e edição de safras
  O sistema deve permitir registrar safras para cada área de plantio, incluindo cultura, datas de plantio e colheita, área utilizada e tipo de cultivo (monocultura/policultura).

• RF05 – Histórico de safras
  O sistema deve permitir consultar o histórico de safras por produtor, por área e por cultura, apresentando dados consolidados em tela de histórico.

• RF06 – Tela inicial de controle de safra
  O sistema deve fornecer uma visão geral das safras ativas e recentes, com informações resumidas por produtor/área/cultura.

• RF07 – Relatórios gerenciais de produção
  O sistema deve gerar relatórios gerenciais sobre a produção.

Requisitos não funcionais

• RNF01 – Arquitetura em camadas
  A aplicação backend deve seguir arquitetura em camadas (Controllers, Services, Repositories, DTOs), promovendo separação de responsabilidades e manutenibilidade.

• RNF02 – Escalabilidade
  A solução deve ser implantada em infraestrutura escalável na AWS (ex.: Lambda, PostgreSQL gerenciado), suportando aumento de carga sem grandes mudanças estruturais.

• RNF03 – Disponibilidade
  O sistema deve utilizar serviços gerenciados da AWS para reduzir indisponibilidades e garantir funcionamento contínuo em ambiente de produção.

• RNF04 – Segurança

  • Comunicação com o backend via HTTPS.
  • Controle de acesso à infraestrutura via AWS IAM (perfis e permissões).

• RNF05 – Desempenho
  Consultas às principais telas (lista de produtores, áreas, relatórios) devem ter tempo de resposta adequado para uso em operação (na ordem de poucos segundos em cenários típicos).

• RNF06 – Usabilidade e responsividade
  O frontend deve ser responsivo e com navegação intuitiva, permitindo uso em diferentes tamanhos de tela (desktop/notebook/tablet).

• RNF07 – Testabilidade
  A arquitetura deve permitir criação de testes unitários (mockando repositórios) e testes de fluxo/interface (ex.: Cypress), aumentando a confiabilidade das entregas.

• RNF08 – Observabilidade e logs
  A aplicação deve registrar logs de erros e eventos relevantes, facilitando monitoramento e investigação de problemas.

Não está no escopo do projeto

NS01 – Aplicativo mobile nativo para produtores
Não faz parte do escopo desenvolver app nativo (Android/iOS) dedicado ao produtor; o foco é um sistema web responsivo.

• NS02 – Integração com sistemas de comercialização/mercado
  Integrações com ERPs, cooperativas, marketplaces ou plataformas de venda de hortifrúti não estão contempladas nesta versão.

• NS03 – Módulo financeiro e de faturamento
  Funcionalidades como emissão de notas fiscais, controle de receitas/despesas e fluxo de caixa não fazem parte deste projeto.

• NS04 – Sensoriamento IoT e automação de campo
  Integração com sensores de campo, estações meteorológicas ou dispositivos IoT não está incluída no escopo atual.

• NS05 – Módulo de recomendação com IA avançada
  Algoritmos avançados de recomendação (ex.: sugestão automática de culturas, predição de pragas) não foram implementados nesta fase.

User Stories

• US01 – Cadastro de produtor
  Como Usuário do sistema, eu quero cadastrar meu usuário de hortifrúti com as informações básicas, para manter um registro organizado das propriedades e responsáveis.

• US02 – Cadastro de área de plantio
  Como usuário autenticado, eu quero cadastrar áreas de plantio associadas a um produtor, desenhando a área no mapa, para ter uma visão espacial das áreas cultivadas.

• US03 – Registro de safra
  Como usuário do sistema, eu quero registrar uma safra vinculada a uma área (cultura, datas de plantio/colheita, área utilizada), para acompanhar o ciclo produtivo de cada plantio.

• US04 – Consulta ao histórico de safras
  Como produtor ou técnico, eu quero visualizar o histórico de safras por produtor/área/cultura, para analisar resultados anteriores e apoiar decisões futuras.

• US05 – Relatórios analíticos de safra
  Como gestor, eu quero acessar relatórios analíticos com indicadores consolidados de safra, para identificar tendências, gargalos e oportunidades de melhoria na produção.

Sprints

Sprint 1

(a definir)

Sprint 2

(a definir)

Sprint 3

(a definir)

Sprint 4

(a definir)