Módulo Coleta (Coleta de Leite)

Sistema de captação e gestão de coleta de leite em propriedades rurais.

---

Famílias de Módulos BPL

Família	Qtd	Tipo
CAP	1	Captação (módulo BPL desktop — source/CAP001/)

Não existem famílias dedicadas MCL/RCL/TCL/CCL no source/. O grosso da funcionalidade de coleta vive no app Android nativo (CaptacaoMobileAPK), na API Spring Boot (CaptacaoMobile) e no Portal Web (módulo coletas/). No desktop ERP, a integração é apoiada pela shared unit jCaptacao (source/jCaptacao/) e por relatórios genéricos.

---

Telas Documentadas

Ainda não existe a pasta docs/telas/coleta/ no knowledge base — as telas desktop do CAP001 não foram exportadas. As funcionalidades de coleta são consumidas principalmente via app mobile e Portal Web (ver seções abaixo).

---

Componentes do Sistema

CaptacaoMobile App (Android)          Portal Web (coletas/)
        │                                    │
        │ REST/JSON                           │ HTTPS
        ▼                                    ▼
CaptacaoMobile API (Spring Boot) ←→ PortalWebAPI
        │
        │ JDBC
        ▼
   Firebird (Banco de Dados)
        │
        ▼
ERP Desktop (módulo CAP + relatórios)

---

Funcionalidades

Coleta em Campo (CaptacaoMobileAPK)

• Registro de coleta por propriedade
• Volume, temperatura, qualidade do leite
• GPS e timestamp
• Sincronização offline → online
• App: source/Mobile/CaptacaoMobile/CaptacaoMobileAPK/
• Package: br.com.junsoft.captacaomobile

Gestão de Rotas

• Definição de rotas de coleta
• Sequência de propriedades
• Sync: source/MilkRouteSync/ — sincroniza rotas desktop ↔ mobile

Análise de Qualidade

• CCS (Contagem de Células Somáticas)
• CPP (Contagem Padrão em Placas)
• Gordura, proteína
• Integração com laboratório

Pagamento a Produtores

• Cálculo do pagamento baseado em:
  • Volume coletado
  • Qualidade (bonificações/descontos)
  • Mês de referência
• Financeiro (geração de títulos a pagar)

Relatórios de Coleta

• Histórico por produtor
• Relatório de qualidade
• Ranking de produtores

---

Portal Web

O Portal Web tem módulo coletas/ para:

• Visualização de coletas do dia
• Detalhe por propriedade
• Filtros por período

---

API Backend

source/Server/CaptacaoMobile/

• CaptacaoMobileAS (Spring Boot)
• CaptacaoMobileModelo (entidades)

---

Integrações

Integração	Descrição
Transporte	Rotas de coleta → MilkRouteSync
Financeiro	Pagamento a produtores
Mobile	CaptacaoMobileAPK
Portal Web	Visualização de coletas
APIs Java	CaptacaoMobile API
Outras Shared	jCaptacao (shared unit)

---

Acesso via API (MCP)

• consultar_coletas — lista coletas por período
• consultar_detalhe_coleta — detalhe de uma coleta

---

Rotina Detalhada

→ Coleta de Leite — Rotas, coleta offline (Android), sync, qualidade, faturamento ao produtor