Módulo de Fazenda¶

Sigla: FAZ (Fazenda)
Status:
✅ Revisado
✅ Aprovado
Implementação:
⬜ Backend
⬜ Frontend
⬜ Mobile
⬜ Backoffice

Legenda: ⬜ Pendente | ✅ Realizado | ⚠️ Ponto de atenção | ❌ Não se aplica

Descrição¶

O módulo de Fazenda gerencia a estrutura física e organizacional das propriedades rurais no sistema BoiView, estabelecendo uma hierarquia clara entre fazendas, retiros e pastos. Esta estrutura possibilita a organização eficiente e a segmentação lógica de todas as operações e recursos do sistema, garantindo o controle preciso sobre os ativos produtivos.

Escopo Inicial¶

Definição da estrutura hierárquica: Fazendas → Retiros → Pastos
Implementação de mapeamento geoespacial com suporte a arquivos KML
Cadastro detalhado de informações em cada nível hierárquico

Funcionalidades¶

Gestão de Fazendas: Cadastro completo e gerenciamento de propriedades rurais
Administração de Retiros: Controle de subdivisões territoriais com suas especificidades
Gerenciamento de Pastos: Cadastro e visualização integrada aos respectivos retiros
Controle de Instalações: Registro de estruturas como cochos, bebedouros, cercas e galpões
Georreferenciamento Avançado: Importação e visualização de dados geoespaciais via arquivos KML/KMZ, suporte a coordenadas GPS, integração com APIs de mapas e sistemas GIS externos
Gestão de Responsáveis: Designação de responsáveis para cada nível hierárquico e ativo
Registro de Características Físicas: Documentação das características do solo, relevo, vegetação e recursos hídricos em cada unidade
Visualização Espacial Integrada: Interface unificada para visualizar todos os elementos georreferenciados da propriedade

Requisitos Funcionais¶

RF-FAZ-001: Restrição e Permissão conforme permissão
Descrição: Este módulo define funções de usuários dos quais ele deve ter a devida permissão para realizar certas ações.
Critério de aceitação: Usuários só acessam funcionalidades liberadas para seu perfil.
Prioridade: Alta
Dependência:
- Módulo de RBAC
RF-FAZ-002: Cadastro de Fazenda
Descrição: O sistema deve possibilitar o registro completo de propriedades rurais.
Critério de aceitação: Incluir campos para nome, localização, área total, dados do proprietário e documentação pertinente.
Critério de aceitação: Permitir operações completas de CRUD (criar, ler, atualizar e excluir) para as informações cadastrais.
Prioridade: Alta
Dependência:
- Módulo de RBAC
RF-FAZ-003: Cadastro de Retiro
Descrição: O sistema deve gerenciar as subdivisões territoriais das propriedades.
Critério de aceitação: Garantir o vínculo obrigatório entre retiros e suas respectivas fazendas.
Critério de aceitação: Possibilitar a consulta de todos os retiros associados a uma determinada fazenda.
Prioridade: Alta
Dependência:
- Cadastro de fazendas
RF-FAZ-004: Integração com Sistemas de Georreferenciamento
Descrição: O sistema deve suportar a importação de arquivos KML/KMZ e integração com sistemas geo-referenciados externos para representação geoespacial completa.
Critério de aceitação: Validar e processar corretamente arquivos KML/KMZ, exibindo-os de forma integrada aos mapas do sistema.
Critério de aceitação: Fornecer feedback claro sobre o status da importação.
Critério de aceitação: Compatibilidade com APIs de mapeamento padrão de mercado (Google Maps, Mapbox, ESRI).
Critério de aceitação: Capacidade de exportar dados geoespaciais para outros sistemas GIS.
Prioridade: Média
Dependência:
- Cadastro de Fazenda
- Módulo de Sincronização
RF-FAZ-005: Cadastro de Pasto vinculado à fazenda ou retiro
Descrição: O sistema deve permitir o cadastro de pastos vinculados às respectivas fazendas ou retiros.
Critério de aceitação: Deve ser possível cadastrar e listar pastos com vínculo a um retiro e exibir sua área e categoria de uso.
Prioridade: Alta
Dependência:
- Cadastro de retiros
RF-FAZ-006: Cadastro de Instalação vinculada ao pasto ou retiro
Descrição: O sistema deve permitir o cadastro de instalações fixas com tipo, localização, estado e vínculo ao pasto ou retiro.
Critério de aceitação: Deve ser possível consultar e editar as informações de cada instalação.
Critério de aceitação: Instalações devem ser categorizadas por tipo (permanente ou temporária) e finalidade.
Critério de aceitação: O sistema deve permitir a diferenciação clara entre instalações fixas (gerenciadas por este módulo) e maquinário móvel (gerenciado pelo módulo de Maquinário).
Prioridade: Alta
Dependência: Cadastro de pastos ou retiros

Requisitos Não Funcionais¶

RNF-FAZ-001: Desempenho de Mapas
Descrição: Garantir experiência fluida na visualização de mapas mesmo em condições de conectividade limitada.
Critério de aceitação: Carregamento eficiente em conexões 3G, com tempo máximo de 3 segundos para exibição inicial.
Prioridade: Alta
RNF-FAZ-002: Otimização de Arquivos Geoespaciais
Descrição: Processamento eficiente de arquivos geoespaciais para manutenção do desempenho do sistema.
Critério de aceitação: Tempo máximo de 5 segundos para importação e renderização de arquivos KML/KMZ em conexões estáveis.
Critério de aceitação: Capacidade de processamento de arquivos com até 10MB sem degradação significativa de performance.
Critério de aceitação: Mecanismo de compressão e otimização de arquivos geoespaciais para dispositivos móveis.
Prioridade: Média
RNF-FAZ-003: Compatibilidade com Sistemas GIS
Descrição: Garantir interoperabilidade com sistemas de informação geográfica profissionais.
Critério de aceitação: Suporte a formatos padrão da indústria (KML, KMZ, GeoJSON, Shapefile).
Critério de aceitação: APIs documentadas para integração bidirecional com sistemas GIS externos.
Critério de aceitação: Conformidade com padrões OGC (Open Geospatial Consortium).
Prioridade: Média
RNF-FAZ-004: Arquitetura offline-first para operações em campo
Descrição: O módulo deve implementar uma arquitetura que permita consulta e navegação completa da estrutura territorial, mesmo sem conexão com a Internet, vital para operações em áreas remotas.
Critério de aceitação: Dados completos da estrutura territorial (fazendas, retiros, pastos e instalações) devem ser cacheados localmente com otimização para dispositivos móveis.
Critério de aceitação: Arquivos KML/KMZ e outros dados geoespaciais devem ser pré-processados e armazenados em formato otimizado para consulta rápida offline.
Critério de aceitação: Sistema deve permitir navegação completa pelos mapas e visualização de coordenadas geográficas mesmo sem conexão de rede.
Critério de aceitação: Alterações estruturais (criação, edição ou exclusão de pastos, instalações, etc.) realizadas offline devem ser sincronizadas com o servidor quando a conexão for reestabelecida.
Critério de aceitação: Em caso de conflitos durante a sincronização, o sistema deve priorizar as mudanças mais recentes, mantendo histórico completo de alterações e gerando alertas para análise manual quando necessário.
Prioridade: Alta

Regras de Negócio¶

RN-FAZ-001: Estrutura Hierárquica
Descrição: A organização territorial deve seguir estritamente a hierarquia: Fazenda → Retiro → Pasto.
Prioridade: Alta
RN-FAZ-002: Responsabilidade
Descrição: Todo nível hierárquico deve possuir pelo menos um responsável designado.
Prioridade: Alta
RN-FAZ-003: Vínculo de Retiros
Descrição: Todo retiro deve estar obrigatoriamente associado a uma única fazenda.
Prioridade: Alta
RN-FAZ-004: Múltiplos Retiros
Descrição: Uma fazenda pode conter nenhum ou múltiplos retiros, conforme necessidade operacional.
Prioridade: Média
RN-FAZ-005: Associação de Pastos
Descrição: Cada pasto deve estar vinculado a um único retiro, mantendo a integridade da hierarquia.
Prioridade: Alta
RN-FAZ-006: Localização de Instalações
Descrição: Toda instalação deve estar georreferenciada e associada a uma unidade territorial (pasto ou retiro).
Prioridade: Média
RN-FAZ-007: Delimitação entre Instalações e Maquinário
Descrição: Este módulo gerencia apenas instalações fixas e estruturas permanentes. Equipamentos móveis e maquinário são gerenciados pelo módulo de Maquinário.
Prioridade: Alta
RN-FAZ-008: Precisão Geoespacial
Descrição: Todas as coordenadas e demarcações devem ter precisão mínima de 5 metros para garantir o georreferenciamento adequado das propriedades.
Prioridade: Média

Critérios de Aceitação¶

Cadastro Completo O sistema deve permitir o registro detalhado de todos os ativos (fazendas, retiros, pastos, instalações e máquinas) com seus respectivos atributos obrigatórios.
Visualização Georreferenciada A representação visual deve refletir com precisão os limites territoriais e a localização dos ativos em todas as camadas do mapa.
Gestão de Responsabilidades O sistema deve possibilitar a designação clara de responsáveis para cada elemento da hierarquia e ativos individuais.
Integração KML A funcionalidade de importação deve processar arquivos KML de forma confiável, validando a integridade dos dados geoespaciais.
Controle de Ativos Deve ser possível gerenciar o ciclo de vida completo das instalações e máquinas, incluindo histórico de manutenções e alterações.

Dependências¶

Módulo de RBAC (para controle de acesso e permissões)

Integrações¶

Módulo de RBAC (para autenticação e controle granular de acesso à estrutura territorial)
Módulo de Membros de Fazenda (para designação de responsáveis em cada nível hierárquico)

Integrações¶

Integrações que o módulo Fazenda SOLICITA de outros módulos:¶

Integração com Módulo de Auditoria de Dados: Solicita o registro detalhado de todas as criações, alterações e exclusões na estrutura territorial para fins de auditoria e rastreabilidade.
Integração com Plataformas de Mapas Externas: Solicita visualização geoespacial integrada para renderização de mapas e coordenadas (Google Maps, Mapbox, ESRI).

Integrações que o módulo Fazenda FORNECE para outros módulos:¶

Integração para Módulo de Manejo de Rebanho: Fornece estrutura territorial completa para alocação e movimentação de animais entre pastos, incluindo informações sobre capacidade e características.
Integração para Módulo de Estoque: Disponibiliza localização de instalações para controle de estoque por ponto físico.
Integração para Módulo de Atividades: Fornece referências geoespaciais para planejamento e execução de tarefas vinculadas a locais específicos.
Integração para Módulo de Maquinário: Fornece informações sobre instalações fixas para associação com equipamentos.
Integração com Sistemas GIS Externos: Fornece interfície para importação e exportação de dados geoespaciais em formatos padronizados (KML, KMZ, GeoJSON, Shapefile).

Estas integrações seguem um padrão de API bem documentado, com especificações claras para facilitar o consumo por outros módulos.

Riscos Relacionados a Requisitos¶

Complexidade Técnica: Processamento de arquivos KML extensos pode impactar o desempenho do sistema
Gestão de Responsabilidades: Potencial sobreposição de atribuições entre diferentes níveis hierárquicos
Definição de Limites: Desafios na demarcação precisa de áreas sem referências físicas claras
Atualização de Dados em Campo: Dificuldade em manter o inventário atualizado em tempo real durante operações remotas
Sincronização de Dados Geoespaciais: Potenciais conflitos durante a sincronização de alterações territoriais realizadas em modo offline

Funções e controle de acesso¶

O módulo possui controle de acesso específicos mediante às seguintes funções:

Níveis de Acesso por Operação¶

nenhuma

Níveis de Acesso por Entidade¶

Fazenda: leitura, criação, edição, exclusão
Retiro: leitura, criação, edição, exclusão
Pasto: leitura, criação, edição, exclusão
Instalação: leitura, criação, edição, exclusão
Artefatos de campo: leitura, criação, edição, exclusão, editar QRCodes

Ações Críticas do Sistema¶

Ações que determinam uma atenção a mais, sendo não só específicas de alguns papéis, mas exigindo confirmação de identidades e/ou aprovações.

Aprovação:¶

nenhuma

Confirmação de identidade:¶

Edição de retiros
Exclusão de pastos
Exclusão de fazendas
Exclusão de instalações
Exclusão de artefatos de campo

Indicadores Possíveis¶

Indicadores de Estrutura e Capacidade¶

Área Total Produtiva: Soma da área útil de todos os pastos por fazenda/retiro
Taxa de Ocupação Média: Relação entre área ocupada e área total disponível
Densidade de Instalações: Número de instalações por hectare
Distribuição de Áreas: Percentual de área destinada a pastos, reservas e infraestrutura

Indicadores de Desempenho Operacional¶

Taxa de Utilização de Pastos: Tempo médio que os pastos permanecem ocupados
Índice de Rotatividade de Áreas: Frequência de troca de animais entre pastos
Tempo Médio entre Manutenções: Para instalações e infraestrutura
Eficiência de Uso do Solo: Relação entre área total e área efetivamente produtiva

Indicadores de Gestão¶

Cobertura de Responsáveis: Número de ativos por responsável
Tempo de Atualização Cadastral: Média de dias entre atualizações nas informações
Taxa de Documentação Regular: Percentual de ativos com documentação completa e válida
Índice de Conformidade: Adequação às regras de negócio definidas

Indicadores de Qualidade de Dados¶

Precisão Georreferenciada: Percentual de áreas com demarcação georreferenciada
Atualização de Limites: Frequência de atualização dos limites das propriedades
Completude de Informações: Percentual de campos obrigatórios preenchidos

Oportunidades de Escopos Futuros¶

Considere as oportunidades identificadas apenas como ideias, mas que podem ser distribuídos em outros módulos e em outros domínios.

Gestão de Documentos¶

Digitalização e armazenamento centralizado de documentos oficiais
Controle de validade e alertas para renovação de documentos
Módulo de compliance e conformidade regulatória

Manutenção Predial¶

Sistema de ordens de serviço para manutenções
Controle de custos e histórico de manutenções
Agendamento preventivo baseado em indicadores de desgaste

Controle de Acesso Físico¶

Cadastro de pontos de acesso e controle de entradas/saídas
Integração com sistemas de monitoramento e câmeras
Relatórios de movimentação e acesso

Gestão de Recursos Hídricos¶

Mapeamento de nascentes, córregos e reservatórios
Monitoramento de qualidade e disponibilidade hídrica
Controle de consumo e otimização do uso da água

Planejamento de Uso do Solo¶

Zoneamento de áreas de preservação e produção
Rotação de pastagens e planejamento de piquetes
Análise de aptidão agrícola das áreas

Integração Meteorológica¶

Dados climáticos em tempo real por propriedade
Alertas de eventos climáticos extremos
Histórico climático para análise de produtividade

Módulo de Segurança Patrimonial¶

Controle de rondas e vigilância
Registro de ocorrências e incidentes
Integração com sistemas de monitoramento

Inventário de Bens¶

Controle de bens móveis e imóveis
Gestão de depreciação e seguros
Rastreamento de ativos

Monitoramento Ambiental¶

Indicadores de sustentabilidade
Controle de emissões e resíduos
Monitoramento de áreas de preservação

Automação e IoT¶

Sensores para monitoramento de equipamentos
Automação de processos de alimentação e irrigação
Coleta automática de dados de campo

Análise Preditiva¶

Modelos de previsão de produtividade
Alertas preventivos baseados em dados históricos
Recomendações de manejo baseadas em IA