# Changelog — IAPTEL Todas as alterações relevantes serão documentadas neste arquivo. ## [0.6.1-apresentacao] — Pacote de Apresentação Executiva **Data:** 2026-05-13 ### Adicionado - Migração `sql/009_release_061_apresentacao.sql`: tabelas `TB_APRESENTACAO_*`, parâmetros `APRESENTACAO_ATIVA`, `APRESENTACAO_VERSAO`, `APRESENTACAO_MODO_REUNIAO`, módulo `apresentacao` e permissões; seeds referenciais (Gantt 44 semanas, roadmap 36 meses, orçamento, compras, riscos, decisões); release **0.6.1-apresentacao**. - Painel: `adminx/apresentacao*.php` (visão, Gantt, orçamento, compras, riscos, decisões, exportar, PDF em stream, download seguro); `config/apresentacao_lib.php`; `assets/css/apresentacao.css`, `assets/js/apresentacao.js`; exportação para `storage_private/generated/apresentacao/AAAA/MM/` (HTML, CSV, MD, manifesto; PDF/ZIP opcionais). - `config/funcoes.php`: `apresentacao_ativa()`, `path_seguro_apresentacao()`. - `core/header.php` / `core/footer.php`: carregamento condicional de CSS/JS de apresentação. - Documentação: `docs/FONTES_OFICIAIS_APRESENTACAO.md`, `docs/APRESENTACAO_LACUNAS_FONTES.md` (pasta `/fontes` ausente no repositório). - Menu lateral: secção **Apresentação** imediatamente após o Dashboard. ## [0.6.0] — APIs oficiais, validação territorial, análise fluvial, capítulos automáticos e pacote final **Data:** 2026-05-13 ### Adicionado - Migração `sql/008_release_060.sql`: `TB_APIS_OFICIAIS`, `TB_API_COLETAS`, `TB_API_COLETA_ITENS`, `TB_COORDENADAS_VALIDACOES`, `TB_ROTAS_FLUVIAIS`, `TB_ANALITICO_CORREDOR`, `TB_PROJETO_CAPITULOS` (24 capítulos estruturais), `TB_PROJETO_MASTERS`, `TB_PACOTES_GERADOS`; parâmetros de activação 0.6.0; release **0.6.0**; módulos e permissões (Integrações, Validação territorial, Análises, Projeto executivo); extensão de enums de versionamento e workflow para `PROJETO_CAPITULO`. - Painel: APIs oficiais e coletas manuais (`apis_oficiais.php`, `api_oficial_*.php`); validação de coordenadas (`coordenadas_validar.php`, `coordenadas_validacao_*.php`); rotas fluviais, importação CSV e comparativo (`rotas_fluviais*.php`, `rota_fluvial_form.php`); analítico por corredor (`analitico_corredor.php`, `analitico_corredor_dados.php`); capítulos do projeto, editor, master (`projeto_*.php`); pacote ZIP com manifesto SHA-256 (`pacote_final.php`, `pacote_final_gerar.php`, `pacotes_gerados.php`, `pacote_download.php`); scripts CLI opcionais `scripts/cron_coletas_oficiais.php`, `scripts/cron_validacao_coordenadas.php` (desactivados por omissão). - `config/funcoes.php`: HTTP seguro, coordenadas, sinuosidade, manifesto/ZIP; `config/analitico_corredor_lib.php`; `config/projeto_capitulos_lib.php`. - Dashboard: KPIs 0.6.0 e bloco «Inteligência territorial»; menu com novos grupos; `core/version.php` **0.6.0**. ### Observação - Chamadas a APIs externas apenas sob acção explícita (ex.: botão «Executar» nas coletas). PDF/DOCX do master e ZIP dependem de Dompdf, PHPWord e extensão `zip` do PHP, respectivamente. ## [0.5.0] — Fontes oficiais, geodados, versionamento probatório e anexos **Data:** 2026-05-13 ### Adicionado - Migração `sql/007_release_050.sql`: `TB_FONTES_OFICIAIS`, `TB_FONTES_OFICIAIS_IMPORTACOES`, `TB_FONTES_OFICIAIS_LINHAS`, `TB_GEOCAMADAS`, `TB_GEOFEATURES`, `TB_REGISTRO_VERSOES`, `TB_DOCUMENTO_REVISOES`, `TB_ASSINATURAS_DOCUMENTOS`, `TB_RELATORIO_ANEXOS`; parâmetros `VERSIONAMENTO_REGISTROS_ATIVO`, `ASSINATURA_INTERNA_ATIVA`, `RELATORIO_INCLUIR_ANEXOS`, `GEOCAMADAS_ATIVAS`, `FONTES_OFICIAIS_ATIVAS`; seeds de fontes oficiais (cadastro, sem dados fictícios de operação); release **0.5.0**; módulos e permissões associados. - Painel: fontes oficiais e importação assistida (`fontes_oficiais*.php`, `fonte_oficial_*.php`); geocamadas e upload (`geocamada_*.php`, `api_geocamadas.php`); versionamento (`versoes_registro.php`, `versao_registro_*.php`); documentos e revisões (`documento_*.php`); assinatura interna (`assinaturas.php`, `assinar_documento.php`, `assinatura_detalhes.php`); anexos de relatório (`relatorio_anexos.php`). - `config/funcoes.php`: helpers de versionamento, hashes para assinatura e listagem de anexos; mapa com camadas opcionais; relatório executivo com seções probatórias e índice de anexos. - `adminx/dashboard.php`: KPIs e tabelas da base probatória 0.5.0. - `core/menu.php`: grupos Dados Oficiais, Geodados, Documentação Técnica; item Versões de Registros em Governança. ### Observação - Assinatura interna não substitui ICP-Brasil. Dompdf/PHPWord continuam opcionais (`composer.json`). ## [0.4.0] — Governança, permissões, workflow e relatório executivo consolidado **Data:** 2026-05-13 ### Adicionado - Migração `sql/006_release_040.sql`: `TB_MODULOS_SISTEMA`, `TB_PERFIL_PERMISSOES`, `TB_WORKFLOW_APROVACOES`, `TB_WORKFLOW_HISTORICO`, `TB_RELATORIOS_GERADOS`; parâmetros `VERSAO_ATUAL`, `WORKFLOW_APROVACAO_ATIVO`, `RELATORIO_GERAR_DOCX`, `RELATORIO_GERAR_PDF`, `PERMISSOES_GRANULARES_ATIVAS`; seeds de módulos e matriz de perfis (`admin`, `engenharia`, `pesquisa`, `regulatorio`, `financeiro`, `auditor`, `consulta`); release **0.4.0**. - Permissões: `adminx/permissoes.php`, `perfil_permissoes.php`, `acesso_negado.php`; funções `tem_permissao`, `exigir_permissao`, `registrar_acesso_negado`, `biblioteca_phpword_disponivel` e geração DOCX opcional em `config/funcoes.php`; checagens graduais em módulos indicados (dossiês, financeiro, regulatório, riscos, relatório). - Workflow: `aprovacoes.php`, `aprovacao_detalhes.php`, `solicitar_aprovacao.php`, `aprovar_registro.php`; partial de governança nas fichas e `dossie_corredor.php`. - Relatório executivo: `relatorio_executivo.php`, `relatorio_executivo_gerar.php`, `relatorios_gerados.php`, `relatorio_download.php`; biblioteca `config/relatorio_executivo_lib.php`; armazenamento em `storage_private/generated` com hash. - Dashboard com KPIs e tabelas de governança; menu com grupos **Governança**, **Relatórios** e **Administração** (incluindo Logs onde aplicável). - `composer.json`: dependência opcional `phpoffice/phpword` (^1.3) além de `dompdf/dompdf`. ### Observação - Composer não é obrigatório para uso do painel; PDF e DOCX dependem das bibliotecas instaladas e das flags em `TB_CONFIG_SISTEMA`. ## [0.3.0] — Engenharia executiva, FMEA, regulatório, financeiro e geração de dossiês **Data:** 2026-05-13 ### Adicionado - Migração `sql/005_release_030.sql`: `TB_RISCOS_FMEA`, `TB_REGULATORIO_REQUISITOS`, `TB_FINANCEIRO_ITENS`, `TB_FINANCEIRO_CENARIOS`, `TB_FINANCEIRO_CENARIO_ITENS`, `TB_DOSSIES_GERADOS`; extensão de `TB_EVIDENCIAS_VINCULOS` para tipos `RISCO_FMEA`, `REQUISITO_REGULATORIO`, `FINANCEIRO_ITEM`; parâmetros FMEA, financeiro e dossiê em `TB_CONFIG_SISTEMA`; release **0.3.0**; requisitos regulatórios seed (texto genérico, status `NAO_INICIADO`); cenários financeiros vazios A/B/C. - Módulo FMEA: `adminx/riscos.php`, `risco_form.php`, `riscos_matriz.php`; funções `calcular_npr_fmea`, `classificar_npr_fmea`, `montar_badge_nivel_risco` em `config/funcoes.php`. - Módulo regulatório: `adminx/regulatorio.php`, `regulatorio_form.php`, `regulatorio_matriz.php`. - Módulo financeiro: `adminx/financeiro.php`, `financeiro_form.php`, `financeiro_resumo.php`, `financeiro_cenarios.php`; totais e formatação em `config/funcoes.php`. - Geração de dossiê: `adminx/dossie_gerar.php`, `dossie_download.php`, `dossies_gerados.php`; HTML em `storage_private/generated/AAAA/MM/` com hash SHA-256; PDF opcional via Dompdf quando instalado; `config/dossie_corredor_lib.php` para dados/HTML reutilizáveis; dossiê por corredor ampliado (FMEA, regulatório, financeiro, lacunas, sumário). - Dashboard com KPIs executivos; menu com grupos Engenharia, Regulatório, Financeiro e Documentos; `vinculo_form.php` aceita evidências nos novos tipos de entidade. - `composer.json` na raiz com `dompdf/dompdf` opcional. ### Observação - PDF depende de `composer install` e da biblioteca Dompdf; sem ela apenas HTML é gerado, com aviso explícito na interface. ## [0.2.0] — Matriz territorial, importação CSV, mapas e cálculo em lote de rotas **Data:** 2026-05-13 ### Adicionado - Migração `sql/004_release_020.sql`: `TB_IMPORTACOES`, `TB_IMPORTACAO_LINHAS`, `TB_EVIDENCIAS_VINCULOS`, `TB_ROTAS_LOTES`, `TB_ROTAS_LOTES_ITENS`; release **0.2.0**; parâmetros de distância e mapa em `TB_CONFIG_SISTEMA`. - Importação CSV de comunidades (`importar_comunidades.php`, preview, salvar), histórico (`importacoes.php`, `importacao_detalhes.php`) e modelo `docs/modelo_importacao_comunidades.csv`. - Cálculo em lote de rotas (`rotas_calcular_lote.php`, `rotas_lote_resultado.php`) com haversine, classificação por zona, limite 200 km e registro em lote. - Mapa Leaflet (`mapa.php`, `api_mapa_dados.php`). - Vínculos de evidências (`vinculos.php`, `vinculo_form.php`) e seção nas fichas de comunidade, nó, rota e corredor. - Dossiê HTML por corredor (`dossie_corredor.php`). - Funções auxiliares em `config/funcoes.php` (texto/CSV, entidades, badges, validação de coordenadas, vínculos, limite km). - Dashboard ampliado, menu lateral atualizado, versão **0.2.0** em `core/version.php`. ## [0.1.0] — Núcleo auditável IAPTEL **Data:** 2026-05-13 ### Adicionado - Schema MySQL inicial (`sql/001_schema_inicial.sql`) com tabelas de usuários, logs, releases, corredores, comunidades, nós logísticos, rotas, fontes, arquivos, documentos (seções), configuração. - Painel administrativo em `adminx/` com Bootstrap 5, DataTables, sidebar escura (#2f3237), cor de destaque (#d6dc1f). - Login com bloqueio temporário após tentativas falhas, `password_hash` / `password_verify`, CSRF e sessão segura. - Dashboard com indicadores de engenharia e contadores territoriais. - Módulos: corredores, comunidades, nós logísticos (bases), rotas (haversine, classificação por zona, limite 200 km, BVLOS automático), fontes, repositório de arquivos (upload com SHA-256, download controlado), usuários, releases, logs, perfis (documentação). - Seeds: script PHP `scripts/seed_admin.php` para administrador; `sql/003_release_010.sql` com corredores iniciais, config e release 0.1.0. - Documentação de instalação em `docs/README.md`. ### Observação - Evolução: releases **0.2.0** (matriz territorial) e **0.3.0** (engenharia executiva) nas seções acima.