Integra o passado sem reescrevê-lo. Extrai metadados de sistemas legados, empacota em bundles verificáveis com SHA256, e permite que a EDAP consuma informações legadas com garantia de integridade.
Sistemas legados apresentam desafios únicos que impedem integração segura com plataformas modernas de governança.
Sem extração padronizada de metadados
Schemas, arquivos e processos espalhados
Documentação incompleta ou desatualizada
Sistemas financeiros exigem detecção de tamper
Consumir sem verificação pode corromper sistemas
O Legacy Bridge resolve esses desafios com extração determinística, empacotamento canônico e verificação criptográfica.
Extrai metadados de sistemas sem LLM ou heurísticas. Mesma entrada sempre produz mesma saída.
Estrutura em schemas JSON versionados. Contratos explícitos e imutáveis.
Todos os artefatos têm hash para detecção de tamper. Ledger registra hashes esperados.
Runlogs completos rastreiam cada execução. Compliance verificável por design.
O Legacy Bridge transforma sistemas legados em bundles verificáveis através de um pipeline determinístico de 6 fases.
Collectors extraem dados de SQL DDL, arquivos (CSV/TXT/EDI) e processos humanos (YAML).
Cria legacy_inventory.v1.json e human_process.v1.json com metadados estruturados.
Computa SHA256 canônico para cada artefato (JSON sorted, campos voláteis excluídos).
Cria legacy_contracts.v1.json com hashes esperados (fonte da verdade).
Contract Gate verifica que cada artefato corresponde ao seu próprio hash.
Escreve bundle completo + runlog. Pronto para consumo pelo ISE Engine.
Três adapters especializados para diferentes fontes de dados legados.
Banco de Dados
Extrai schemas de PostgreSQL via DDL. Tabelas, colunas, tipos e chaves primárias.
Arquivos
Escaneia diretórios de arquivos CSV, TXT, EDI. Detecta headers, delimitadores e tamanhos.
Processos Humanos
Parseia definições YAML/JSON de workflows. Steps, aprovadores e evidências.
Cada bundle contém artefatos versionados com hashes SHA256 para rastreabilidade completa.
SQL / Files / YAML
Sistemas
Workflows
Ledger
Auditoria
Catálogo de sistemas, schemas relacionais e arquivos legados com metadados estruturados.
schema_version: "legacy_inventory.v1"Documentação de processos humanos, workflows de aprovação e cadeias de responsabilidade.
schema_version: "human_process.v1"Ledger com hashes esperados de cada artefato. Fonte da verdade para verificação de integridade.
schema_version: "legacy_contracts.v1"Registro completo da execução com timestamps, contagens, flags e bundle_root_hash.
schema_version: "legacy_runlog.v1"Glossário institucional com termos canônicos e definições. Opcional.
schema_version: "legacy_glossary.v1"Mapeamento de equivalência entre termos legados e termos canônicos. Opcional.
schema_version: "legacy_mapping.v1"Três camadas de proteção garantem que bundles não foram adulterados.
SHA256 com serialização JSON determinística.
Fonte da verdade com hashes esperados.
Hash único que representa todo o bundle.
Dois checks independentes para máxima segurança.
Quando o ISE Engine recebe um bundle legado, o Legacy Gate valida integridade antes de consumir qualquer dado.
Extrai hashes esperados do legacy_contracts.v1.json
Confirma que schema_version corresponde ao esperado
Computa SHA256 de cada artefato e compara com ledger
success, legacy_contract_gate_failed, ou schema_invalid
Todos os checks passaram. Bundle válido para consumo.
Hash não corresponde. Possível adulteração detectada.
LEGACY_SCHEMA_INVALID
Schema version ou estrutura não corresponde ao esperado.
LEGACY_INTEGRITY_FAILED
Hash recalculado não corresponde ao registrado no ledger.
Interface CLI para geração e verificação de bundles legados.
# Bundle completo com todas as fontes legacy intake --project meu_sistema --out ./bundle \ --sql schema.sql \ --files data.csv,report.txt \ --human processes.yaml
# Verificar integridade do bundle legacy verify --bundle ./bundle # Output esperado: VALID: legacy_verify_abc123def456 final_status: success flags: inventory_ok: True human_ok: True contracts_ok: True
# Snapshot de banco relacional legacy intake relational-snapshot \ --project erp --out ./bundle \ --dsn "postgresql://user:pass@host/db" # Pasta de arquivos CSV legacy intake csv-folder \ --project reports --out ./bundle \ --src /path/to/files \ --include-glob "*.csv,*.txt" # Processos humanos legacy intake human-process \ --project finance --out ./bundle \ --src /path/to/processes/
Estrutura de diretórios de um bundle Legacy Bridge completo.
legacy_bundle/ ├── legacy_inventory.v1.json # Sistemas & Schemas │ ├── schema_version: "legacy_inventory.v1" │ ├── content_hash_sha256: "5a4e3c..." │ ├── source: "meu_projeto" │ └── systems: [...] │ ├── human_process.v1.json # Workflows Humanos │ ├── schema_version: "human_process.v1" │ ├── content_hash_sha256: "91d65f..." │ ├── process_name: "Aprovação de Despesas" │ └── steps: [...] │ ├── legacy_contracts.v1.json # Ledger (Fonte da Verdade) │ ├── schema_version: "legacy_contracts.v1" │ └── artifacts: │ ├── legacy_inventory: { sha256: "5a4e3c..." } │ └── human_process: { sha256: "91d65f..." } │ ├── legacy_runlog.v1.json # Trilha de Auditoria │ ├── execution_id: "run_abc123" │ ├── final_status: "success" │ ├── bundle_root_hash_sha256: "e7f8a9..." │ └── artifact_counts: {...} │ └── artifacts/ # Arquivos Extras (opcional) ├── ddl/schema.sql ├── files/data.csv └── glossary/glossary.json
Schemas Versionados
Adapters
Checks de Integridade
Algoritmo de Hash
Determinístico
Dependência de LLM