Sistema completo de gestão para pequenas propriedades pecuárias
Sustentabilidade • Otimização • Inovação
O Farm-IT é uma solução completa desenvolvida para ajudar pequenos produtores rurais a gerenciar suas propriedades de forma sustentável e eficiente. O sistema permite controle total sobre rebanho, alimentação, comercialização de subprodutos e finanças.
- ✅ 100% Web - Acesse de qualquer dispositivo
- ✅ Mobile-First - Interface otimizada para celular
- ✅ Gratuito - Open source e sem custos
- ✅ Fácil de Usar - Interface intuitiva
- ✅ Completo - Todas as funcionalidades em um só lugar
- Cadastro e controle de vacas e porcos
- Monitoramento de peso e saúde
- Histórico completo de cada animal
- Estatísticas do rebanho
- Registro de alimentação por animal ou geral
- Controle de custos com ração
- Gestão de estoque de alimentos
- Análise de consumo
- Registro de produção de esterco
- Gestão de vendas e clientes
- Controle de pagamentos
- Receita adicional sustentável
- Controle de receitas e despesas
- Relatórios financeiros completos
- Análise de rentabilidade
- Gráficos e estatísticas
- Registro e login seguros
- Gestão de perfil de usuário
- Proteção de dados com JWT
- Visão geral da propriedade
- Indicadores em tempo real
- Métricas de sustentabilidade
|
|
- Node.js v16+
- PostgreSQL v12+
# 1. Navegue até o diretório
cd /farm-it
# 2. Instale as dependências
npm run install-all
# 3. Configure o banco de dados
psql -U postgres -c "CREATE DATABASE farm_it;"
# 4. Configure o arquivo .env
cd backend
cp .env.example .env
# Edite o .env com suas credenciais
# 5. Execute as migrations
npm run migrate
# 6. Inicie o sistema
cd ..
npm run dev🎉 Pronto! Acesse http://localhost:3000
| Documento | Descrição |
|---|---|
| 📖 QUICK_START.md | Guia rápido em 5 minutos |
| ⚙️ SETUP.md | Instalação completa e detalhada |
| 📱 USAGE_GUIDE.md | Como usar todas as funcionalidades |
| 🔌 API_DOCUMENTATION.md | Documentação técnica da API |
| 📋 PROJECT_SUMMARY.md | Resumo completo do projeto |
farm-it/
├── 📄 Documentação
│ ├── README.md # Este arquivo
│ ├── QUICK_START.md # Início rápido
│ ├── SETUP.md # Guia de instalação
│ ├── USAGE_GUIDE.md # Manual do usuário
│ ├── API_DOCUMENTATION.md # Documentação API
│ └── PROJECT_SUMMARY.md # Resumo do projeto
│
├── 🔧 Backend (Node.js + Express + PostgreSQL)
│ ├── config/ # Configurações
│ ├── controllers/ # Lógica de negócio
│ ├── routes/ # Rotas da API
│ ├── middleware/ # Autenticação
│ ├── migrations/ # Banco de dados
│ └── server.js # Servidor principal
│
└── ⚛️ Frontend (React)
├── public/ # Arquivos estáticos
└── src/
├── components/ # Componentes reutilizáveis
├── pages/ # Páginas da aplicação
├── contexts/ # Estado global (Auth)
└── services/ # Cliente API
| Serviço | URL | Descrição |
|---|---|---|
| 🖥️ Frontend | http://localhost:3000 | Interface do usuário |
| 🔌 Backend | http://localhost:5000 | API REST |
| ✅ Health Check | http://localhost:5000/api/health | Status da API |
- ✅ Senhas criptografadas com bcrypt
- ✅ Autenticação via JWT (válido 7 dias)
- ✅ Proteção contra SQL Injection
- ✅ Validação de dados de entrada
- ✅ CORS configurado
- ✅ Rotas protegidas
Interface totalmente adaptável:
| Dispositivo | Resolução | Status |
|---|---|---|
| 🖥️ Desktop | 1920x1080+ | ✅ Otimizado |
| 💻 Laptop | 1366x768+ | ✅ Otimizado |
| 📱 Tablet | 768x1024 | ✅ Otimizado |
| 📱 Mobile | 375x667+ | ✅ Otimizado |
Pequenos produtores rurais enfrentam dificuldades em:
- ❌ Controlar custos de alimentação
- ❌ Gerenciar dados de rebanho
- ❌ Aproveitar subprodutos
- ❌ Organizar finanças
- ✅ Registro preciso de alimentação e custos
- ✅ Histórico completo de cada animal
- ✅ Comercialização de esterco
- ✅ Dashboard financeiro completo
- ✅ Decisões baseadas em dados
- Acesse http://localhost:3000/register
- Crie sua conta
- Faça login
- Atualize seu perfil
- Cadastre seus animais
- Registre o estoque de ração
- Registre a alimentação
- Acompanhe o dashboard
- Lance receitas e despesas
- Registre vendas de esterco
- 📊 Confira o dashboard diariamente
- 📝 Registre alimentação assim que ocorrer
- 💰 Lance transações no mesmo dia
- 🔄 Atualize peso dos animais semanalmente
- ♻️ Registre produção e venda de esterco
# Depois de instalar, teste:
# 1. Crie sua conta
Acesse: http://localhost:3000/register
# 2. Cadastre um animal
Menu > Rebanho > + Adicionar Animal
# 3. Registre alimentação
Menu > Alimentação > + Novo Registro
# 4. Veja suas estatísticas
Menu > DashboardPara testar o sistema com dados de exemplo:
cd backend
psql -U postgres -d farm_it -f migrations/seed_data_example.sqlImportante: Edite o arquivo SQL e substitua user_id = 1 pelo ID do seu usuário.
Contribuições são muito bem-vindas!
- Fork o projeto
- Crie uma branch (
git checkout -b feature/MinhaFeature) - Commit suas mudanças (
git commit -m 'Adiciona MinhaFeature') - Push para a branch (
git push origin feature/MinhaFeature) - Abra um Pull Request
Este projeto está sob a licença ISC.
Encontrou algum problema? Veja nossa documentação:
O Farm-IT promove:
- ♻️ Reciclagem de resíduos orgânicos
- 🌱 Redução de desperdício de ração
- 💚 Sustentabilidade na produção
- 📊 Eficiência no uso de recursos
- 🌍 Consciência ambiental
Todas as funcionalidades foram implementadas e testadas!
Versão: 1.0.0
Data: Outubro 2025
Status: Produção
Desenvolvido com 💚 para promover a sustentabilidade no campo
Farm-IT - Gestão Inteligente para o Futuro do Agronegócio
🌾 🐄 ♻️ 💰 📊