Maquinário¶

Sigla: MAQ (Maquinário)
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 Maquinário permite o inventário, controle operacional e acompanhamento dos custos de manutenção das máquinas agrícolas e veículos da fazenda. Visa garantir rastreabilidade, otimização do uso, controle de consumo de combustível, manutenção preventiva e corretiva, bem como fornecer dados para auditoria patrimonial e tomada de decisão.

Escopo Inicial¶

Inventário de máquinas e veículos
Registro de horas de operação (horímetro)
Controle de consumo de combustível
Histórico de manutenções preventivas e corretivas
Relatórios de custos operacionais por máquina
Alertas de manutenção programada

Configurações¶

Tipos de máquinas: Cadastro de categorias (tratores, colheitadeiras, veículos leves, etc.)
Parâmetros de manutenção: Definição de periodicidade, horas de uso e checklists por tipo de máquina
Alertas: Configuração de alertas para manutenção preventiva e vencimento de inspeções
Integração com estoque: Vinculação de peças e insumos usados em manutenções

Funcionalidades¶

Cadastro e Inventário: Cadastro completo de máquinas, veículos e implementos, com dados técnicos e documentos
Registro de Operações: Lançamento de horas trabalhadas, operadores, tarefas e áreas atendidas
Controle de Combustível: Registro de abastecimentos, consumo e custos por máquina
Gestão de Manutenção: Registro de manutenções preventivas e corretivas, peças e insumos utilizados
Alertas e Notificações: Alertas automáticos para manutenções programadas e inspeções obrigatórias
Relatórios Operacionais: Relatórios de custos, disponibilidade, eficiência e histórico de uso

Requisitos Funcionais¶

RF-MAQ-001: Cadastro de máquinas, veículos e implementos agrícolas, com informações técnicas e documentos
RF-MAQ-002: Registro de horas de operação (horímetro) por máquina
RF-MAQ-003: Controle de abastecimento e consumo de combustível por máquina
RF-MAQ-004: Registro de manutenções preventivas e corretivas, com peças e insumos utilizados
RF-MAQ-005: Emissão de alertas automáticos para manutenções programadas
RF-MAQ-006: Relatórios de custos operacionais, disponibilidade e eficiência por máquina

Requisitos Não Funcionais¶

RNF-MAQ-001: Arquitetura offline-first para operações em campo
Descrição: O módulo deve implementar uma arquitetura completa para operações offline em áreas remotas, permitindo o registro e consulta de todas as informações sobre maquinário sem dependência de conexão com a Internet.
Critério de aceitação: Cadastro completo de maquinário, abastecimentos, horímetros, manutenções e operações disponíveis em modo offline.
Critério de aceitação: Cache inteligente que prioriza dados de máquinas ativas e relevantes para a fazenda atual.
Critério de aceitação: Armazenamento eficiente que permita uso por até 30 dias sem necessidade de sincronização.
Prioridade: Alta
RNF-MAQ-002: Sincronização robusta de dados
Descrição: Mecanismo avançado de sincronização para garantir a integridade e consistência dos dados, mesmo após longos períodos offline.
Critério de aceitação: Sincronização automática quando conexão for reestabelecida, com tempo máximo de 2 minutos para datasets completos.
Critério de aceitação: Resolução inteligente de conflitos seguindo regras específicas:
- Para registros de horímetro: manter o histórico cronológico completo
- Para abastecimentos e manutenções: preservar todos os registros de ambos os ambientes
- Para alterações no cadastro: manter a versão mais recente com alerta para revisão
Critério de aceitação: Indicação visual clara do status de sincronização de cada registro.
Prioridade: Alta
RNF-MAQ-003: Interface responsiva para operações em campo
Descrição: Interface otimizada para dispositivos móveis, permitindo rápido lançamento de dados em condições de campo.
Critério de aceitação: Fluxos de lançamento de horímetro e abastecimento em menos de 3 passos.
Critério de aceitação: Formulários adaptativos para diversos tamanhos de tela, garantindo usabilidade em smartphones e tablets.
Prioridade: Alta
RNF-MAQ-004: Integração com módulo de estoque para baixa automática de peças e insumos
Descrição: Integração transparente com estoque para garantir controle de peças e insumos utilizados em manutenções.
Critério de aceitação: Baixa automática no estoque ao registrar manutenção, mesmo em modo offline.
Critério de aceitação: Validação de disponibilidade de peças antes do registro de manutenção.
Prioridade: Média

Regras de Negócio¶

RN-MAQ-001: Não é permitido registrar manutenção sem saldo de peças/insumos no estoque
RN-MAQ-002: Máquinas devem ter manutenção preventiva registrada conforme periodicidade definida
RN-MAQ-003: Abastecimentos devem ser vinculados a máquinas cadastradas e operadores autorizados

Critérios de Aceitação¶

Cadastro de máquinas e implementos deve conter todos os campos obrigatórios
Lançamentos de horas, abastecimentos e manutenções devem ser possíveis online e offline
Alertas e relatórios devem ser gerados corretamente conforme as configurações
Histórico operacional e de custos deve estar disponível para consulta por perfil autorizado

Dependências¶

Módulo de Estoque (para peças e insumos de manutenção)

Integrações¶

Integrações que o módulo Maquinário SOLICITA de outros módulos:¶

Integração com Módulo de Estoque: Solicita informações sobre disponibilidade de peças e insumos e registra baixas automáticas durante manutenções.
Integração com Sistema de Notificações Interno: Solicita envio de alertas para manutenções programadas, inspeções obrigatórias e anomalias detectadas.
Integração com Módulo de Auditoria de Dados: Solicita registro detalhado de todas as operações realizadas para fins de rastreabilidade e auditoria.
Integração com Módulo de Membros de Fazenda: Solicita informações sobre operadores autorizados para cada tipo de máquina e implemento.

Integrações que o módulo Maquinário FORNECE para outros módulos:¶

Integração para Dashboards: Fornece métricas operacionais como disponibilidade, eficiência e custos para dashboards gerenciais.

Todas estas integrações implementam mecanismos de cache e sincronização para garantir o funcionamento adequado em modo offline, permitindo a operação contínua do maquinário mesmo em áreas remotas sem conectividade.

Riscos Relacionados a Requisitos¶

Falha na sincronização de dados: Registros em duplicidade ou ausência de alertas devido a problemas de sincronização entre dispositivos móveis e servidor central
Manutenções não registradas: Falhas operacionais e custos não previstos devido a manutenções realizadas, mas não lançadas no sistema
Consumo excessivo de combustível: Desvios e custos elevados por falta de controle adequado nos abastecimentos
Conflitos de alocação de maquinário: Reservas simultâneas do mesmo equipamento durante operação offline
Perda de dados operacionais: Ausencia de backups adequados dos registros realizados em campo
Acesso indevido a dados de custos: Exposição de informações financeiras sensíveis a perfis não autorizados

Funções e Controle de Acesso¶

O módulo de Maquinário define permissões específicas para cada operação e entidade, garantindo que apenas usuários autorizados possam registrar, editar e consultar informações sensíveis.

Níveis de Acesso por Operação¶

Cadastro de máquinas e implementos: permitido para gestores e técnicos
Registro de operações (horas, abastecimentos): permitido para operadores, técnicos e gestores
Registro de manutenções: permitido para técnicos e gestores
Configuração de parâmetros e alertas: restrito a gestores
Visualização de relatórios e histórico: permitido para todos os perfis autorizados

Níveis de Acesso por Entidade¶

Máquinas e implementos: leitura, criação, edição, exclusão (gestores/técnicos)
Registros operacionais: lançamento, edição (operadores/técnicos/gestores)
Manutenções: registro, edição (técnicos/gestores)
Relatórios e histórico: visualização (todos)
Alertas: visualização (todos), resolução (gestores)

Ações Críticas do Sistema¶

Ações que exigem confirmação adicional ou aprovação para garantir rastreabilidade e evitar erros:

Aprovação¶

Alteração retroativa de registros de operação e manutenção
Ajustes manuais em parâmetros de manutenção

Confirmação de Identidade¶

Exclusão de registros de manutenção
Alteração de cadastro de máquina após início de operação

Indicadores Possíveis¶

Indicadores Operacionais e de Gestão¶

Disponibilidade operacional de cada máquina
Custo por hora trabalhada
Consumo médio de combustível por máquina
Percentual de manutenções realizadas no prazo
Número de falhas operacionais por período
Taxa de sincronização de dados offline

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.

Integração com sensores IoT para monitoramento em tempo real
Implementação de telemetria e rastreamento por GPS
Dashboards de eficiência operacional e custos
Análise preditiva de falhas e manutenções