escopo.md

@@ -61,16 +61,87 @@
 ## Requisitos
 
 ### Requisitos funcionais
-*(a definir)*
+
+**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
-*(a definir)*
+**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
-*(a definir)*
+**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
-*(a definir)*
+**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