Pular para o conteúdo principal

Piloto Esteio - DeFarm

Visão Geral​

O Piloto Esteio é um projeto piloto da DeFarm focado na Identidade Animal & Rastreabilidade de bovídeos usando arquitetura unificada.

🎯 Conceito Chave​

Uma única API resolve tudo: POST /assets

  • ✅ Criação de animais
  • ✅ Atualizações e eventos
  • ✅ Deduplicação automática
  • ✅ Tokenização blockchain
  • ✅ Histórico completo IPFS

O sistema processa qualquer dado enviado através de um pipeline inteligente que detecta automaticamente se é um animal novo, atualização ou evento, consolidando tudo sem intervenção manual.

Arquitetura do Sistema​

O diagrama abaixo ilustra a arquitetura completa do sistema:

┌─────────────────┐    ┌──────────────────────┐    ┌─────────────────────┐
│    Produtores   │    │     Integração      │    │    DeFarm Core      │
│                 │    │                      │    │                     │
│ ┌─────────────┐ │    │ ┌─────────────────┐  │    │ ┌─────────────────┐ │
│ │  Produtor   │ │    │ │ Base Centralizada│  │    │ │ DeFarm Process  │ │
│ └─────────────┘ │    │ │                 │  │    │ │ Rastreabilidade │ │
│       │         │    │ │ (Recebe ID +    │  │    │ └─────────────────┘ │
│ ┌─────────────┐ │    │ │  Eventos)       │  │    │         │           │
│ │ App Produtor│ │────┼─│                 │──┼────┼─────────│           │
│ │ mobile/web  │ │    │ └─────────────────┘  │    │ ┌─────────────────┐ │
│ └─────────────┘ │    │                      │    │ │ Base Off-chain  │ │
│       │         │    └──────────────────────┘    │ │ Postgres/       │ │
│ ┌─────────────┐ │                                │ │ Supabase        │ │
│ │Sistema ERP  │ │                                │ └─────────────────┘ │
│ └─────────────┘ │                                └─────────────────────┘
│       │         │                                          │
│ ┌─────────────┐ │                                          │
│ │  Bovídeos   │ │                                          ▼
│ │ (rebanho)   │ │                                ┌─────────────────────┐
│ └─────────────┘ │                                │     Blockchain      │
└─────────────────┘                                │  (Stellar/Soroban)  │
                                                   │                     │
                                                   │ ┌─────────────────┐ │
                                                   │ │ NFT Animal      │ │
                                                   │ │ Token           │ │
                                                   │ └─────────────────┘ │
                                                   │ ┌─────────────────┐ │
                                                   │ │ IPCM Mapping    │ │
                                                   │ │ (CID ➜ Hash)    │ │
                                                   │ └─────────────────┘ │
                                                   │ ┌─────────────────┐ │
                                                   │ │ Árvore Merkle   │ │
                                                   │ │ (Registros)     │ │
                                                   │ └─────────────────┘ │
                                                   └─────────────────────┘

Como Funciona - Pipeline Unificado​

1. Entrada Única​

  • Endpoint único: POST /assets (nunca mais /livestock)
  • API Key governamental: Autenticação Esteio
  • Payload flexível: Qualquer estrutura de dados de animal

2. Inteligência Automática​

  • Detecção: Sistema identifica se é animal novo ou existente via SISBOV
  • Deduplicação: Consolida dados automaticamente sem conflitos
  • Validação: Schema validation + compliance SISBOV obrigatório
  • Roteamento: Pipeline inteligente baseado no conteúdo

3. Processamento Paralelo​

  • Verification Pipeline: Múltiplas verificações simultâneas
  • IPFS Upload: Versionamento automático dos dados
  • Tokenização: NFT + IPCM mapping para blockchain
  • Status Tracking: Acompanhamento em tempo real

4. Consolidação Automática​

  • Asset único: Um animal = um registro consolidado
  • Histórico completo: Todas as atualizações preservadas
  • Blockchain immutable: Evidências criptográficas permanentes
  • Dashboard sync: Dados aparecem automaticamente

5. Resposta Unificada​

A DeFarm sempre retorna:

  • Asset ID: Identificador único do sistema
  • Status: pending → processing → tokenized
  • IPFS CID: Hash do conteúdo versionado
  • Blockchain Hash: Transação confirmada

Fluxo Simplificado​

Esteio → POST /assets → Pipeline DeFarm → Blockchain + IPFS → Dashboard
  1. Envio: POST /assets com dados do animal
  2. Pipeline: Detecção automática + verificação + deduplicação
  3. Tokenização: NFT + IPFS + blockchain automaticamente
  4. Dashboard: Dados aparecem em tempo real
  5. Resposta: Asset ID + status + hashes

Principais Componentes​

API Gateway Unificada​

  • Endpoint único: POST /assets para todos os tipos de dados
  • Rate limiting: 100 requests/hora por organização
  • Authentication: API key governamental Esteio
  • Schema validation: Validação automática + SISBOV obrigatório

Pipeline Inteligente de Verificação​

  • Asset detection: Novo vs existente via SISBOV/ear_tag
  • Deduplicação: Consolidação automática de dados duplicados
  • Verification engines: Múltiplas verificações paralelas
  • Status tracking: Acompanhamento em tempo real

Blockchain + IPFS Layer​

  • IPFS: Versionamento imutável de todos os dados
  • NFTs: Token único por animal (ownership + identity)
  • IPCM: Mapeamento CID → Asset para histórico completo
  • Smart contracts: Stellar/Soroban para tokenização

Dashboard Web Governamental​

  • Visualização unificada: Todos os assets consolidados
  • Histórico completo: Timeline de eventos por animal
  • Status pipeline: Acompanhamento de processamento
  • Export/API: Dados acessíveis via API

Benefícios da Arquitetura Unificada​

✅ Para Esteio (Cliente)​

  • API única: POST /assets resolve qualquer cenário
  • Zero complexidade: Sistema decide automaticamente o que fazer
  • Sem duplicatas: Deduplicação automática por SISBOV
  • Compliance garantido: SISBOV obrigatório + validação automática

✅ Para Governança​

  • Auditoria simples: Endpoint único para monitorar
  • Dados consolidados: Visão unificada de todos os assets
  • Rastreabilidade total: Blockchain + IPFS automáticos
  • Regulamentação: Compliance automático com normas

✅ Para o Sistema​

  • Escalabilidade: Pipeline pode processar volume alto
  • Integridade: Blockchain + IPFS garantem imutabilidade
  • Performance: Processamento paralelo otimizado
  • Manutenção: Arquitetura simplificada

Implementação Piloto Esteio​

Etapas de Implementação​

  1. Setup API

    • Receber API key governamental
    • Configurar base URL: https://defarm-mvp.onrender.com/api
    • Testar com GET /test

  2. Integração Dados

    • Mapear dados existentes para schema DeFarm
    • Garantir SISBOV em todos os registros
    • Preparar payloads JSON

  3. Teste Pipeline

    • Enviar animal de teste via POST /assets
    • Verificar processamento no dashboard
    • Validar tokenização blockchain

  4. Produção

    • Migração gradual dos dados históricos
    • Monitoramento contínuo
    • Auditoria regular via dashboard

Suporte Técnico​

  • Documentação: API Guide
  • Dashboard: Visualização automática pós-processamento
  • Support: Equipe técnica DeFarm disponível