Pular para conteúdo

RER DSP — Documentação

Portal de documentação da Data Sharing Platform (DSP) do ecossistema RER (Rural Environmental Registry).

RER e DSP em uma frase cada

O RER (Rural Environmental Registry) é um bem público digital (DPG) para o cadastro de informações ambientais geoespaciais declaradas em propriedades rurais. O sistema do Cadastro Ambiental Rural (CAR), aprimorado em parceria com a Dataprev, foi lançado na COP30 pelo MGI sob essa nomenclatura como o primeiro bem público digital do governo brasileiro no catálogo internacional da Digital Public Goods Alliance (DPGA).

No contexto brasileiro, o módulo de cadastro do RER equivale ao Módulo de Cadastro Pré-Preenchido do SICAR: é por ele que proprietários e responsáveis cadastram e atualizam imóveis rurais de forma facilitada, com dados pré-preenchidos e integração entre bases públicas.

Módulo de cadastro RER — mapa na tela de registro de propriedade

Legenda: interface do módulo de cadastro do RER (cadastro pré-preenchido), com mapa para localizar e registrar o imóvel rural.

O DSP (Data Sharing Platform) é a plataforma que compartilha, visualiza e publica esses dados ambientais para o público geral. Embora atenda ao RER, sua aplicação não se limita a ele, podendo ser utilizada em outros contextos de forma simples e sem complicações. Para isso, sua arquitetura combina uma API REST, um frontend web, bancos PostgreSQL/PostGIS, GeoServer e rotinas de migração e sincronização de dados.

No contexto brasileiro, o DSP equivale à consulta pública do CAR: interface em que qualquer pessoa consulta no mapa os dados ambientais declarados nos imóveis rurais cadastrados, com filtros, indicadores e camadas geográficas.

Consulta pública do DSP — tela inicial com mapa e filtros

Legenda: tela inicial da consulta pública do DSP — mapa, hierarquia territorial e busca de imóveis (equivalente à consulta pública do CAR no contexto brasileiro).

Arquitetura em alto nível

flowchart LR
  browser["BROWSER<br/>Consulta pública no mapa."]
  gw["GATEWAY<br/>nginx · entrada HTTP única.<br/>/dsp/ · /dsp-backend/ · GeoServers."]

  srcDb[("SEU DATABASE<br/>Banco da sua organização que você quer migrar os dados.<br/>Fonte a migrar para o DSP.")]
  jobMig["JOB-DATA-MIGRATION<br/>ETL Spring Batch.<br/>origem → dsp-db + geoserver-db."]
  jobGeo["JOB-GEO-FILE-GENERATION<br/>Pré-gera os arquivos de download.<br/>"]
  core["CORE<br/>CONFIG · SETUP · START.<br/>Prepara bancos e orquestra os demais módulos."]

  dspDb[("DSP DB<br/>Operacional: negócio + bbox/centroid.")]
  gsDb[("GEOSERVER DB<br/>Geometria completa dsp.*<br/>Lido pelos dois GeoServers.")]
  objStor[("OBJECT STORAGE<br/>SeaweedFS S3.<br/>")]

  be["DSP BACKEND<br/>API REST e regras de negócio."]
  fe["DSP FRONTEND<br/>Interface web da plataforma.<br/>Consulta, mapas e compartilhamento."]

  gsEx["GEOSERVER-EXHIBITION<br/>Publica layers para visualização.<br/>Serviço WMS/WFS de mapa."]
  gsDl["GEOSERVER-DOWNLOAD<br/>WFS para exportação de downloads.<br/>Consumido pelo backend."]

  browser --> gw
  gw -->|/dsp/| fe
  gw -->|/dsp-backend/| be
  gw -->|/geoserver-exhibition/| gsEx

  jobMig -->|leitura| srcDb
  jobMig -->|"negócio + bbox/centroid"| dspDb
  jobMig -->|"geom completa"| gsDb
  core -.config/schema/build.-> jobMig
  core -.-> jobGeo
  core -.-> dspDb
  core -.-> gsDb
  core -.-> objStor
  core -.-> gw
  core -.-> be
  core -.-> fe
  core -.-> gsEx
  core -.-> gsDl

  dspDb --> be
  gsDb --> gsEx
  gsDb --> gsDl
  gsDb --> jobGeo
  jobGeo -->|"CSV pré-gerado"| objStor
  be -->|WFS downloads| gsDl
  be -->|CSV quando disponível| objStor

  classDef app fill:#0f766e22,color:#115e59,stroke:#0f766e,stroke-width:2px
  classDef geoCls fill:#16653422,color:#14532d,stroke:#166534,stroke-width:2px
  classDef db fill:#b4530922,color:#92400e,stroke:#b45309,stroke-width:2px
  classDef job fill:#7c2d1222,color:#7c2d12,stroke:#9a3412,stroke-width:2px
  classDef coreCls fill:#312e8122,color:#312e81,stroke:#4338ca,stroke-width:2px
  classDef entryCls fill:#1e3a5f22,color:#1e3a5f,stroke:#2563eb,stroke-width:2px
  classDef storageCls fill:#4c1d9522,color:#4c1d95,stroke:#7c3aed,stroke-width:2px

  class fe,be app
  class gsEx,gsDl geoCls
  class dspDb,gsDb,srcDb db
  class jobMig,jobGeo job
  class core coreCls
  class browser,gw entryCls
  class objStor storageCls

Por onde começar

O ponto de entrada operacional é o repositório dsp-core: use ./config.sh, ./setup.sh e ./start.sh para subir a stack com Docker Compose (bancos PostgreSQL/PostGIS, gateway nginx, GeoServers Exhibition e Download, backend, frontend e job de migração).

Na instalação com fonte JDBC real, o core também sobe object storage (SeaweedFS) e o job geo-file (CSV de download pré-gerado), via profile Compose object-storage. No Começando rápido (demo com seed sintético) esses dois serviços não entram — os downloads usam o GeoServer Download.

Por onde começar

Objetivo Página
Entender o que é o DSP e se ele serve para sua organização O que é o DSP
Conhecer os 6 módulos e como se conectam Módulos do DSP
Testar o DSP: rodar uma demo local em poucos minutos (seed sintético, só para avaliação) Começando rápido
Instalar tudo em infraestrutura própria Instalação completa

Mapa da documentação

Seção Conteúdo
O que é o DSP Propósito, problema resolvido, cenários de uso
Módulos do DSP Responsabilidade e tecnologia de cada módulo
Começando rápido Demo local para testes — seed sintético, sem banco externo
Guias de instalação Instalação completa com fonte JDBC real
Arquitetura Camadas, fluxo de dados, bancos
Referência dos módulos Detalhe técnico de cada repositório

Esta documentação (dsp-docs) é a única fonte de documentação técnica do ecossistema DSP — os demais repositórios não mantêm pastas docs/ próprias.