Engenharia do
Vetorizador

Fluxo arquitetural principal

As 4 fontes de candidatos

Helpers do pipeline novos

Variáveis globais críticas

let _selecaoMemorialAtiva = false;       // true quando aguardando clique para memorial
let _selecaoMemorialClickHandler = null;  // handler registrado durante seleção de memorial
let selectedFeatureId = null;            // feature ativa (single)
const selectedFeatureIds = new Set();     // features selecionadas (multi)
let sigefSelectedIds = new Set();         // índices SIGEF selecionados
let suppressMapClickDeselectUntil = 0;   // timestamp para suprimir deselect

Singleton

Evidências: app-boundary-manager.js mantém estado da camada de referência em escopo de módulo; CONFIG em app.js é fonte única de parâmetros; cache de módulos dinâmicos em _modulosDinamicos.

Strategy

Evidências: seleção de comportamento por preset (cobertura, uso_solo, manual); guardrails por cenário em geo-postprocess.js; pontuação de cena em scene-classifier.js.

Status de melhoria: PresetManager já extraído com contrato estável. Estratégias de pipeline ainda espalhadas como condicionais em app.js.

Template Method

Evidências: pipeline principal com sequência fixa (captura → Sobel → Otsu → morfologia → DBSCAN → WASM → pós-processamento → exportação); scene-classifier.js com roteiro estável; vetoriza/src/lib.rs com sequência determinística.

Factory Method

Evidências: createAppBoundaryManager(), createFeatureFlagManager(), createPresetManager(deps), createStateManager(), createVectorizationPipeline({ executeCore }) — todos recebem dependências injetadas e retornam instâncias com API pública estável.

Observer

Evidências: listeners de eventos Leaflet (layer.on('click'), map.on('draw:created')); interceptação de console.* pelo sistema de diagnóstico; window.addEventListener para erros globais e beforeunload.

Runtime desktop (Electron v41)

Proxies do backend local

SIGEF & Memorial (módulos independentes)

Lógica de escolherComDesambiguacaoGlobal()

Promise-based. Recebe array de candidatos { key, source, feature, label, featureId?, boundaryIdx?, featureIdx? }, ordena por área crescente (menor = mais específico primeiro) e exibe swatches de cor 44×44 px em grid. Cancela com reject(); escolha com resolve(item).

DIAG registra 3 fases: modal-aberto, escolhido e cancelado.

Estilo de seleção

aplicarEstiloSelecao(baseStyle, isSelected) retorna: color: '#00e5ff', weight+2, opacity: 1, dashArray: null (sem tracejado — borda sólida).

SIGEF selecionado: SIGEF_STYLE_SELECTED = { color: '#b71c1c', fillColor: '#ef5350', fillOpacity: 0.50, weight: 3 }.

Variáveis de controle

let _snapShiftAutoActive = false;  // Shift pressionado = auto-inserção ativa
let _snapLastAutoPoint = null;     // último ponto auto-inserido (deduplicação)

Ciclo de vida

Estrutura CONFIG (app.js)

Fonte única de parâmetros do pipeline. Todo novo campo exige atualização em 4 lugares.

Estado de sessão (state-manager.js)

IndexedDB — vetorizador_learning_db

IndexedDB — vetorizador_diagnostic_archive_db

Chaves localStorage

Assinatura

vetorizar_imagem(base64_png: string) → string // JSON serializado

Saída — FeatureCollection GeoJSON

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {
      "type": "Polygon",
      "coordinates": [[[lon, lat], ..., [lon, lat]]]
    },
    "properties": {}
  }]
}

Invariantes garantidos

Inicialização

// index.html — ordem crítica
<script src="vetoriza/pkg/vetoriza.js"></script>

// app.js
await wasm_bindgen(wasmUrl);
vetorizar_imagem = wasm_bindgen.vetorizar_imagem;

Rebuild WASM após mudanças em vetoriza/src/lib.rs: wasm-pack build --target no-modules --release

Capacidades

Categorias de log registradas

Etapas de modularização

O que precisa ser protegido

Principais passivos arquiteturais

Comandos principais

npm install           # instalar dependências
npm run dev           # servidor de desenvolvimento Vite
npm run lint          # ESLint
npm run build         # build produção
npm run preview       # preview do build
npm run desktop:dev   # Electron + Vite em desenvolvimento
npm run desktop:start # Electron sobre build existente
npm run dist:win      # empacotamento Windows (.exe)

Rebuild do WASM

Sempre que houver mudança em vetoriza/src/lib.rs:

cd vetoriza
wasm-pack build --target no-modules --release

Após o rebuild, validar novamente o build do frontend com npm run lint && npm run build.

Runbooks de diagnóstico rápido