FarmAnalytics · Workspace
FA-WORKSPACE-2026-06-16

Espaço compartilhado para retomar o desenvolvimento de FarmAnalytics — plataforma de telemetria agrícola multi-tenant baseada na base Farm24 Terraviva. Qualquer pessoa autorizada pode editar os arquivos `.md` neste workspace e continuar de onde paramos.

! Status

🟡 Em planejamento Plano de desenvolvimento em elaboração. Banco já mapeado (38 tabelas · 5M linhas). Pronto para definir arquitetura final e iniciar sprints.

Última atualização: 2026-06-16 por Juliano Rodrigues + Claude.

1 Briefing

O que o Juliano pediu

Plataforma SaaS multi-tenant para análise de telemetria agrícola, baseada nas visões PowerBI da Farm24. Multi-empresa, multi-filial, RBAC + ABAC, SSO Microsoft, Google login social, dashboards drill-down com gráficos animados, cadastro de máquinas com foto + consumo de diesel por estado operacional, apps Android/iOS com Push.

Ambiente alvo: VPS 45.235.27.9 · agromizer.com/dev/farmanalytics

2 Stack

Tecnologia proposta

  • Frontend: React + Vite + TS + Tailwind + shadcn/ui
  • Mobile: Capacitor (1 codebase iOS+Android) + FCM Push
  • Backend: FastAPI + SQLAlchemy 2.0 + Pydantic v2
  • DB: PostgreSQL 17 + PostGIS 3.6 + Redis
  • Auth: JWT + Argon2id + Casbin (RBAC/ABAC) + OIDC (MS) + OAuth (Google)
  • Infra: Docker Compose + nginx + Let's Encrypt + MinIO

3 Dashboards mapeados

12 dashboards em 4 personas

  • Gerente Agrícola: D1 Status do dia · D2 Avanço da safra · D3 Mapa operacional
  • Encarregado de Frota: D4 Performance · D5 Eficiência por máquina · D6 Manutenção
  • Diretoria: D7 Custo/ha por cultura · D8 Produtividade por talhão · D9 Janela ótima
  • ESG: D10 Pegada operacional · D11 Eficiência hídrica · D12 Rastreabilidade

4 Banco de dados

Farm24 Terraviva — clone local

  • PostgreSQL 17.6 + PostGIS 3.6.4
  • farm24_terraviva · 1.925 MB · 38 tabelas
  • 5.011.917 linhas totais
  • Período: 03/mar/2026 → 10/jun/2026 (93 dias)
  • Top tabelas: activity_values (2.4M) · machine_activity (1.1M)
  • Cliente operacional: Fazenda Terraviva (5.550 ha · 223 talhões · 5 culturas · 69 máquinas)

5 Arquivos deste workspace

Localização no VPS: /home/opc/workspaces/farmanalytics/

📄README.mdentry point
📋BRIEFING.mdpedido + requisitos + decisões
🔬farm24_study.mdestudo técnico de 38 tabelas + 12 dashboards
📊STATE.mdstatus atual (atualize ao avançar)

6 Próximos passos

  • 🟡 EM ANDAMENTO   Escrever Plano_FarmAnalytics.html (14-18 seções A4 padrão NAI)
  • ⏳ A FAZER   Rodar cofre.py → gerar versão protegida com senha F@rm24#@nalytics@2026
  • ⏳ A FAZER   Publicar em https://social.myncc.com.br/propostas/farmanalytics/
  • ⏳ A FAZER   Setup do VPS 4Innovare (nginx + docker + postgres + certbot)
  • ⏳ A FAZER   Apontar DNS agromizer.com para 4Innovare
  • ⏳ A FAZER   Restore do dump PostgreSQL no VPS
  • ⏳ A FAZER   Bootstrap do repositório Git (monorepo)
  • ⏳ A FAZER   Sprint 1 · 2 semanas · D1 Status do dia + D2 Avanço da safra

? Decisões pendentes (precisam de Juliano)

  1. Stack mobile: Capacitor (PWA wrapper) ou React Native?
  2. Storage de fotos: MinIO local ou AWS S3 / Oracle Object Storage?
  3. Push: FCM ou OneSignal?
  4. SSO Microsoft: direto via Entra OU via Identity One da NAI como wrapper?
  5. Cronograma: manter 4 sprints (8 sem) ou ajustar?
  6. Modelo comercial: SaaS direto Terraviva OU licenciamento via Farm24?