Documentação do Sistema Atines
Guia completo de uso, funcionalidades e referência técnica.
Visão Geral
O Atines é uma solução completa para gestão e monitoramento de aviários, focada em otimizar o manejo, controlar a mortalidade e garantir o bem-estar animal através de tecnologia de ponta.
O sistema permite o acompanhamento em tempo real de indicadores cruciais, gestão de lotes, controle de jejum pré-abate e alertas automatizados via WhatsApp.
Página Inicial do Sistema
Acesso ao Sistema
O acesso é restrito a usuários cadastrados. Existem diferentes níveis de permissão (Administrador, Gerente, Operador) que determinam quais funcionalidades estão disponíveis.
- Login: Utilize seu e-mail e senha cadastrados.
- Recuperação de Senha: Disponível na tela de login caso esqueça suas credenciais.
- Segurança: As senhas são criptografadas e o acesso é monitorado.
Dashboard
O Dashboard é o painel de controle principal. Ele oferece uma visão panorâmica do status das granjas e aviários.
Destaque: Gráficos interativos mostram a evolução da mortalidade e outros indicadores chave (KPIs) em tempo real.
Gestão de Usuários
O módulo de usuários permite o cadastro e controle de acesso de todos os operadores do sistema.
Listagem de Usuários
Cadastrando um Novo Usuário
- Acesse o menu Usuários e clique no botão Novo Usuário.
- Preencha o Nome completo do usuário.
- Informe um E-mail válido (será usado para login).
- Defina uma Senha segura e confirme-a.
- Selecione o Perfil de acesso (ex: Administrador, Gerente, Operador).
- Clique em Salvar para concluir o cadastro.
Formulário de Cadastro
Perfis e Permissões
Gerencie os níveis de acesso através dos Perfis. Cada perfil possui um conjunto de permissões específicas.
Granjas e Aviários
A estrutura do sistema é hierárquica: Cooperativa > Granja > Aviário. É necessário cadastrar nesta ordem.
Listagem de Granjas
1. Cadastro de Cooperativas
As cooperativas são as entidades principais.
- Acesse o menu Cooperativas e clique em Nova Cooperativa.
- Preencha o Nome e o CNPJ.
- Clique em Salvar.
2. Cadastro de Granjas
Cada granja pertence a uma cooperativa e possui um proprietário (Dono).
- Acesse o menu Granjas e clique em Nova Granja.
- Selecione a Cooperativa vinculada.
- Selecione o Dono responsável.
- Informe o Nome da Granja.
- Clique em Salvar.
3. Cadastro de Aviários
Os aviários são os galpões físicos dentro de uma granja.
- Acesse o menu Aviários e clique em Novo Aviário.
- Selecione a Granja onde o aviário está localizado.
- Informe o Nome/Identificação do aviário (ex: Galpão 01).
- Preencha os detalhes técnicos (capacidade, dimensões, etc) se solicitado.
- Clique em Salvar.
Monitoramento e Lotes
Cadastro de Lotes
Um lote representa um grupo de aves alojadas em um aviário específico por um período de tempo.
- Acesse o menu Lotes e clique em Novo Lote.
- Selecione o Aviário de destino.
- Informe o Código do Lote (identificador único).
- Defina a Data de Início (alojamento).
- Informe a Quantidade Inicial de aves.
- Clique em Salvar.
Controle de Jejum
Módulo crítico para o manejo pré-abate. Permite registrar o início do jejum e acompanhar o tempo até o carregamento.
Iniciando um Jejum
- Acesse o menu Jejum e clique em Novo Jejum.
- Selecione o Lote que entrará em jejum.
- O sistema preencherá automaticamente o Aviário e a Quantidade de Aves.
- Informe a Data/Hora de Início do jejum.
- Clique em Salvar.
Acompanhamento e Finalização
Na listagem de jejuns, você pode visualizar o status de cada lote. Ao clicar em Visualizar (ícone de olho), você terá acesso aos detalhes completos.
Detalhes do Jejum Realizado
A tela de detalhes exibe o tempo total de jejum, gráficos de consumo de água (se houver sensores) e o registro do carregamento.
Dispositivos (Sensores)
O cadastro de dispositivos permite vincular sensores (IoT) aos aviários para monitoramento automático.
- Acesse o menu Dispositivos e clique em Novo Dispositivo.
- Informe o Identificador (ID) do dispositivo físico.
- Selecione o Aviário onde ele está instalado.
- Defina o Tipo de sensor (Temperatura, Umidade, CO2, etc).
- Clique em Salvar.
Controle de Mortalidade
Registro diário de mortalidade e eliminação de aves.
- Acesse o menu Mortalidade.
- Selecione o Lote ativo.
- Informe a quantidade de aves mortas e eliminadas.
- O sistema calcula automaticamente o saldo de aves.
- Clique em Salvar.
Alertas e Parâmetros
Configuração de Alertas
Defina regras para envio de notificações automáticas via WhatsApp.
Parâmetros do Sistema
Ajuste os parâmetros globais de funcionamento, como limites de temperatura e umidade ideais.
Arquitetura do Sistema
O Atines é construído sobre o framework Laravel (PHP), seguindo o padrão MVC (Model-View-Controller).
Frontend
Blade Templates, Tailwind CSS, JavaScript (Vanilla + Anime.js)
Backend
Laravel 10+, PHP 8.1+
Database
MySQL / MariaDB
Banco de Dados
Principais tabelas e relacionamentos:
- users (id, name, email, password, perfil_id)
- cooperativas (id, nome, cnpj)
- granjas (id, nome, cooperativa_id, dono_id)
- aviarios (id, nome, granja_id)
- lotes (id, codigo, aviario_id, data_inicio)
- jejum (id, lote_id, inicio_at, fim_at)