agroplan-ai-cli 1.0.0

package/README.md

@@ -0,0 +1,95 @@
+# 🌱 AgroPlan AI - CLI
+
+**CLI global para modo local acelerado do AgroPlan AI**
+
+O AgroPlan AI é um sistema inteligente de planejamento agrícola que usa algoritmos genéticos para otimizar o plantio. Esta CLI permite executar o backend localmente para melhor performance.
+
+## 🚀 Instalação
+
+**Requer [Bun ≥ 1.0](https://bun.sh/) instalado**
+
+```bash
+# Instalar CLI globalmente
+bun add -g agroplan-ai-cli
+
+# Configurar API local
+agroplan setup
+
+# Iniciar servidor local
+agroplan serve on
+
+# Abrir no navegador
+agroplan open
+```
+
+## 📋 Comandos
+
+### Configuração
+```bash
+agroplan setup          # Configura API local em ~/.agroplan
+agroplan doctor         # Verifica configuração do sistema
+```
+
+### Servidor Local
+```bash
+agroplan serve on       # Inicia API em http://localhost:8000
+agroplan serve off      # Para o servidor local
+agroplan serve status   # Mostra status Local + Render
+agroplan serve logs     # Exibe logs do servidor
+```
+
+### Utilitários
+```bash
+agroplan open           # Abre AgroPlan AI no navegador
+```
+
+## 🎯 Vantagens do Modo Local
+
+- **⚡ Performance**: ~0.1s vs ~0.3s+ do Render
+- **🔄 Disponibilidade**: Não depende do Render acordar
+- **🛠️ Desenvolvimento**: Ideal para uso diário
+- **🌐 Híbrido**: Frontend detecta automaticamente Local vs Render
+
+## 🏗️ Como Funciona
+
+1. **Setup**: Copia backend para `~/.agroplan/backend`
+2. **Ambiente**: Cria `.venv` e instala dependências Python
+3. **Servidor**: Executa FastAPI em `localhost:8000`
+4. **Frontend**: Detecta API local automaticamente
+
+## 🔧 Estrutura Criada
+
+```
+~/.agroplan/
+├── backend/              # Backend FastAPI local
+│   ├── api.py           # API principal
+│   ├── core/            # Algoritmos (genético, força bruta)
+│   ├── data/            # Dados simulados (CSV)
+│   ├── requirements.txt # Dependências Python
+│   └── .venv/           # Ambiente virtual
+├── agroplan-api.pid     # PID do processo
+└── logs/
+    └── api.log          # Logs do servidor
+```
+
+## 🌐 Arquitetura Híbrida
+
+- **Online**: Frontend (Vercel) + Backend (Render) - universal
+- **Local**: Frontend (Vercel) + Backend (localhost) - acelerado
+- **Auto**: Tenta local primeiro, fallback para Render
+
+## 🛠️ Requisitos
+
+- **Bun**: ≥ 1.0 ([instalar](https://bun.sh/))
+- **Python**: ≥ 3.8 (para ambiente virtual)
+- **Sistema**: Windows, macOS, Linux
+
+## 🔗 Links
+
+- **Aplicação**: https://agroplan-ai.vercel.app
+- **Repositório**: https://github.com/Kuuhaku-Allan/agroplan-ai
+- **Documentação**: [docs/LOCAL_MODE.md](https://github.com/Kuuhaku-Allan/agroplan-ai/blob/main/docs/LOCAL_MODE.md)
+
+## 📄 Licença
+
+MIT © Kuuhaku Allan

package/backend-template/.env.example

@@ -0,0 +1,21 @@
+# Backend Configuration
+
+# Server
+HOST=0.0.0.0
+PORT=8000
+
+# CORS - Allowed origins (comma-separated)
+# Local development
+CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
+# Production (update with your Vercel URL)
+# CORS_ORIGINS=https://your-frontend.vercel.app,http://localhost:3000
+
+# Data Mode
+# simulated: Uses CSV files with simulated data
+# real: Uses real APIs (future implementation)
+DATA_MODE=simulated
+
+# Cache Administration (optional)
+# If set, /cache/limpar endpoint requires X-Cache-Token header
+# Leave empty to disable protection (not recommended for production)
+CACHE_ADMIN_TOKEN=your-secret-token-here

package/backend-template/Dockerfile

@@ -0,0 +1,21 @@
+# Use Python 3.11 slim image
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Expose port (Render will override with PORT env var)
+EXPOSE 8000
+
+# Run the application
+# Use shell form to allow environment variable substitution
+CMD sh -c "uvicorn api:app --host 0.0.0.0 --port ${PORT:-8000}"

package/backend-template/README.md

@@ -0,0 +1,274 @@
+# AgroPlan AI - Backend
+
+Backend FastAPI para o Sistema Inteligente de Planejamento de Plantio.
+
+## 🚀 Tecnologias
+
+- **FastAPI** - Framework web moderno e rápido
+- **Python 3.11+** - Linguagem de programação
+- **Pandas** - Manipulação de dados
+- **NumPy** - Computação numérica
+- **Uvicorn** - Servidor ASGI
+
+## 📋 Pré-requisitos
+
+- Python 3.11 ou superior
+- pip (gerenciador de pacotes Python)
+
+## 🔧 Instalação Local
+
+1. **Clone o repositório** (se ainda não fez):
+```bash
+git clone <seu-repositorio>
+cd agroplan/backend
+```
+
+2. **Crie um ambiente virtual**:
+```bash
+python -m venv venv
+
+# Windows
+venv\Scripts\activate
+
+# Linux/Mac
+source venv/bin/activate
+```
+
+3. **Instale as dependências**:
+```bash
+pip install -r requirements.txt
+```
+
+4. **Configure as variáveis de ambiente**:
+```bash
+# Copie o arquivo de exemplo
+cp .env.example .env
+
+# Edite .env conforme necessário
+```
+
+5. **Execute o servidor**:
+```bash
+python api.py
+```
+
+O servidor estará disponível em `http://localhost:8000`
+
+## 📚 Documentação da API
+
+Após iniciar o servidor, acesse:
+
+- **Swagger UI**: http://localhost:8000/docs
+- **ReDoc**: http://localhost:8000/redoc
+
+## 🔌 Endpoints Principais
+
+### Health Check
+```http
+GET /health
+```
+Verifica o status da API e retorna informações sobre os dados carregados.
+
+### Dashboard
+```http
+GET /dashboard
+```
+Retorna resumo completo do dashboard com plano recomendado.
+
+### Talhões
+```http
+GET /talhoes
+```
+Lista todos os talhões disponíveis.
+
+### Culturas
+```http
+GET /culturas
+```
+Lista todas as culturas disponíveis com suas regras.
+
+### Cenários
+```http
+GET /cenarios
+```
+Retorna comparação entre diferentes cenários de plantio.
+
+### Otimizar
+```http
+POST /otimizar
+Content-Type: application/json
+
+{
+  "objetivo": "equilibrado",
+  "seed": 42,
+  "geracoes": 100,
+  "populacao": 50
+}
+```
+Executa o Algoritmo Genético para otimização.
+
+**Objetivos disponíveis**: `equilibrado`, `lucro`, `risco`, `sustentavel`
+
+### Validar
+```http
+POST /validar
+Content-Type: application/json
+
+{
+  "objetivo": "equilibrado",
+  "seed": 42
+}
+```
+Valida o resultado do AG comparando com força bruta (quando viável).
+
+### Rodadas
+```http
+POST /rodadas
+Content-Type: application/json
+
+{
+  "objetivo": "equilibrado",
+  "rodadas": 5
+}
+```
+Executa múltiplas rodadas do AG para análise de estabilidade.
+
+### Relatório
+```http
+POST /relatorio
+Content-Type: application/json
+
+{
+  "objetivo": "equilibrado",
+  "formato": "md"
+}
+```
+Gera relatório completo em Markdown ou TXT.
+
+**Formatos disponíveis**: `md`, `txt`
+
+## 🐳 Docker
+
+### Build da imagem:
+```bash
+docker build -t agroplan-backend .
+```
+
+### Executar container:
+```bash
+docker run -p 8000:8000 \
+  -e CORS_ORIGINS="http://localhost:3000" \
+  agroplan-backend
+```
+
+## 🌍 Variáveis de Ambiente
+
+| Variável | Descrição | Padrão |
+|----------|-----------|--------|
+| `HOST` | Host do servidor | `0.0.0.0` |
+| `PORT` | Porta do servidor | `8000` |
+| `CORS_ORIGINS` | Origens permitidas (separadas por vírgula) | `http://localhost:3000` |
+| `DATA_MODE` | Modo de dados (`simulated` ou `real`) | `simulated` |
+
+### Exemplo de configuração para produção:
+```bash
+HOST=0.0.0.0
+PORT=8000
+CORS_ORIGINS=https://seu-frontend.vercel.app,http://localhost:3000
+DATA_MODE=simulated
+```
+
+## 📁 Estrutura de Dados
+
+O backend utiliza arquivos CSV localizados em `data/`:
+
+- **culturas.csv** - Informações sobre culturas (10 culturas)
+- **talhoes.csv** - Informações sobre talhões (10 talhões)
+- **regras_culturas.csv** - Regras de compatibilidade
+
+## 🧬 Algoritmo Genético
+
+O sistema utiliza um Algoritmo Genético para otimização do planejamento:
+
+- **População**: 50 indivíduos (configurável)
+- **Gerações**: 100 (configurável)
+- **Seleção**: Torneio
+- **Crossover**: Ponto único
+- **Mutação**: Aleatória com taxa adaptativa
+
+### Objetivos de Otimização:
+
+1. **Equilibrado**: Balanceia lucro, risco e sustentabilidade
+2. **Lucro**: Prioriza retorno financeiro
+3. **Risco**: Minimiza exposição ao risco
+4. **Sustentável**: Prioriza compatibilidade e diversidade
+
+## 🔍 Validação
+
+O sistema oferece dois métodos de validação:
+
+1. **Força Bruta**: Para espaços de busca pequenos (≤10.000 combinações)
+2. **Múltiplas Rodadas**: Para espaços grandes, executa várias rodadas e analisa estabilidade
+
+## 📊 Relatórios
+
+Relatórios são gerados em `reports/` com:
+
+- Resumo executivo
+- Características do plano
+- Comparação com cenários
+- Detalhes do Algoritmo Genético
+- Validação e estabilidade
+- Justificativa técnica
+
+## 🚀 Deploy
+
+### Render (Recomendado)
+
+1. Conecte seu repositório GitHub ao Render
+2. Crie um novo Web Service
+3. Configure:
+   - **Root Directory**: `backend`
+   - **Build Command**: (deixe vazio, usa Dockerfile)
+   - **Start Command**: (deixe vazio, usa CMD do Dockerfile)
+4. Adicione variáveis de ambiente:
+   - `CORS_ORIGINS`: URL do seu frontend
+5. Deploy!
+
+### Outras plataformas
+
+O backend é compatível com qualquer plataforma que suporte:
+- Docker
+- Python 3.11+
+- Variável de ambiente `PORT`
+
+## 🐛 Troubleshooting
+
+### Erro de CORS
+Verifique se `CORS_ORIGINS` inclui a URL do seu frontend.
+
+### Porta já em uso
+Altere a variável `PORT` ou encerre o processo usando a porta 8000.
+
+### Módulos não encontrados
+Execute `pip install -r requirements.txt` novamente.
+
+## 📝 Limitações Atuais
+
+- Dados simulados (CSV estáticos)
+- Sem banco de dados
+- Sem autenticação
+- Sem APIs externas reais
+
+## 🔮 Próximas Funcionalidades
+
+- Integração com APIs reais (clima, preços, etc.)
+- Banco de dados PostgreSQL
+- Autenticação e autorização
+- Cache Redis
+- Webhooks para notificações
+- Suporte a múltiplas propriedades
+
+## 📄 Licença
+
+Este projeto é parte do AgroPlan AI.