Remove TASKS.md: tracking da v2.0.0 migrou para ampmInsights_V2/

Esta pasta fica congelada como réplica validada, já implementada no
cliente — nenhuma mudança funcional/estrutural a partir de agora. O board
de sprint da v2.0.0 (nova geração) vive em ampmInsights_V2/TASKS.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.gitignore

@@ -5,3 +5,14 @@
 # Continua no pacote (zip de entrega); ver docs/04-passo-a-passo-banco.html para
 # como gerar/obter o arquivo caso precise recriar esta pasta do zero.
 modelo-onnx/*.onnx
+
+# Exports brutos/intermediarios de CMDB e vulnerabilidades - contem dados
+# reais de OUTRAS empresas do grupo Ultrapar (Ipiranga, Ultrapar, Iconic)
+# antes da sanitizacao por nome de servidor (ver docs/10-carga-cmdb-vulnerabilidades.html).
+# So os arquivos finais _AMPM.xlsx dentro de template_limpo_ampm/ sao
+# rastreados - nunca remova este bloco sem confirmar que os brutos nao vao
+# entrar no historico.
+Artefatos/*.csv
+Artefatos/*.xlsx
+Artefatos/template_limpo_ampm/*.csv
+!Artefatos/template_limpo_ampm/*_AMPM.xlsx

CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog — ampmInsights (pacote cliente)
+
+Todas as mudanças notáveis deste pacote (`ampmInsights_V1_Cliente`) ficam registradas aqui.
+Formato baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/) e
+[Versionamento Semântico](https://semver.org/lang/pt-BR/) (`MAJOR.MINOR.PATCH`).
+
+Este pacote é a **V1** do ambiente ampmInsights entregue à AM/PM — os números de versão abaixo
+(`v1.x.x`) versionam correções/evoluções dentro da V1, não uma nova geração da aplicação.
+
+## [Não lançado] — v1.4.0 em andamento
+
+Fechamento da validação de carga de CMDB/Vulnerabilidades iniciada na v1.3.0.
+
+### Pendente
+- [ ] Confirmar upload de `DL_TECH_CMDB_V1_AMPM.xlsx` no ambiente de teste (esperado: 109 linhas).
+- [ ] Confirmar upload de `DL_TECH_VULNERABILIDADE_V2_AMPM.xlsx` (esperado: 1.724 linhas).
+- [ ] Validar visualmente na tela "Insigths sobre Vulnerabilidades" que só aparecem nomes padrão `AM...`.
+- [ ] Decidir sobre `AMPMOCIVWNSP01#DUP` / `AMPMOCIVWNSP02#DUP` (sufixo `#DUP` do ServiceNow — duplicata pendente de revisão).
+- [ ] Confirmar fonte de dados (se houver) para `É_VIRTUAL`, `APPLIANCE`, `EDR` — ficaram em branco por falta de campo equivalente no export do ServiceNow.
+- [ ] Confirmar se `amprotrib` (vulnerabilidade sem match no CMDB) e `aampmocivlfgap02` (excluído por não bater o padrão `AM`) são ativos AMPM reais.
+- [ ] Depois de validado no ambiente de teste, repetir a carga no ambiente real do cliente (primeira carga — sem necessidade de limpeza prévia).
+
+## [v1.3.0] — 2026-07-31
+
+### Adicionado
+- `docs/10-carga-cmdb-vulnerabilidades.html`: guia de como preparar e subir novas cargas de CMDB
+  (ServiceNow) e vulnerabilidades (Tenable), incluindo o critério de sanitização (nome do
+  servidor, não a coluna "Empresa" do export) e o mapeamento completo de colunas para os dois
+  perfis de carga do APEX (`DL_TECH_CMDB_V1`, `DL_TECH_VULNERABILIDADE_V2`).
+- `Artefatos/template_limpo_ampm/DL_TECH_CMDB_V1_AMPM.xlsx` e
+  `DL_TECH_VULNERABILIDADE_V2_AMPM.xlsx` — templates finais, já filtrados e com cabeçalho no
+  formato esperado pela carga.
+
+### Corrigido
+- Export bruto do grupo Ultrapar (ServiceNow/Tenable compartilhados) misturava dados de outras
+  empresas (Ipiranga, Ultrapar, Iconic) com os da AM/PM; a coluna "company"/"empresa" do export
+  não é confiável sozinha (~40% das linhas marcadas AMPM tinham nome de servidor de outra
+  empresa) — critério de sanitização definido e aplicado.
+
+### Segurança
+- `.gitignore` reforçado para nunca versionar exports brutos/intermediários de CMDB/vulnerabilidades
+  (contêm dados reais de outras empresas do grupo) — só os `*_AMPM.xlsx` finais são rastreados.
+
+## [v1.2.0] — 2026-07-24
+
+### Adicionado
+- Critérios de validação após cada etapa crítica do `01_ampminsights_db_setup.sql`, direto no
+  script (não só documentados à parte):
+  - Entre Seção 1→2: confirma troca de sessão para `AMPMINSIGHTS` antes de continuar.
+  - Fim da Seção 2: confere o *tipo* de cada OCID pelo prefixo (`ocid1.compartment.` etc.), não
+    só se foi preenchido.
+  - Fim da Seção 3: lembrete de recriar a credencial `OCI_CRED` se o compartimento mudar depois
+    dela já existir.
+  - Fim da Seção 7: confere `STATUS = VALID` dos objetos novos antes de seguir para o APEX.
+- `docs/09`: seção nova sobre as Application Settings do APEX (`OCI_CREDENTIAL`,
+  `COMPARTMENT_ID`, `REGION`) como fonte de configuração separada da `TB_26AI_TECH_PARAMS` — as
+  duas precisam ser mantidas em sincronia manualmente.
+
+### Motivação
+Formalizado depois de uma sessão real de troubleshooting (schema errado, tipo de OCID errado,
+credencial desatualizada, Application Settings fora de sincronia) — cada causa raiz virou uma
+checagem que roda no momento da etapa, não só um sintoma que aparece bem mais tarde.
+
+## [v1.1.0] — 2026-07-24
+
+### Alterado
+- Região do OCI Generative AI deixou de ser fixa (`us-chicago-1`) e passou a ser configurável via
+  novo parâmetro `GENAI_REGION` em `TB_26AI_TECH_PARAMS`, usado em todos os pontos de chamada
+  (`FNC_26ai_rag`, `fnc_26ai_tech_rag`, `fnc_26ai_embed`, `PRC_26AI_TECH`, testes 5.1/5.2/5.3).
+  Necessário porque tenancies com escopo regional restrito (ex. América Latina) podem não
+  alcançar `us-chicago-1` mesmo com credencial/ACL/compartimento corretos.
+- `docs/04-passo-a-passo-banco.html` (Seções 6 e 7) resincronizada com o `.sql` — estava
+  desatualizada desde a adição do `TB_26AI_TECH_LOG` na v1.0.0.
+
+### Adicionado
+- `docs/09`: entrada de checklist para `ORA-20404` com URL bem formada (modelo aposentado para
+  uso on-demand na região, não só problema de credencial/ACL) — verificável via
+  `oci generative-ai model-collection list-models`.
+
+## [v1.0.0] — 2026-07-24
+
+Baseline: primeira versão do pacote cliente sob controle de versão (`git init` — antes disso as
+mudanças não tinham histórico rastreável).
+
+### Corrigido
+- `ORA-54426` no `LOAD_ONNX_MODEL_CLOUD`: modelo ONNX CLIP convertido corretamente via OML4Py
+  (`oml.utils.ONNXPipeline`), em vez de um export cru com eixos dinâmicos duplicados.
+- `ORA-20404` no SELECT AI (Seção 5.3): região do Generative AI corrigida.
+- Vazamento de erro técnico (`sqlerrm`) direto na coluna `insight_report`, visível ao usuário de
+  negócio — trocado por mensagem amigável, erro completo só no log.
+- Job `JOB_26AI_TECH_VULNERABILIDADE` ("Gerar Insights em Lote") agora se autoencerra quando não
+  há mais registros pendentes, em vez de rodar indefinidamente a cada 20s.
+
+### Adicionado
+- Observabilidade de IA: tabela `TB_26AI_TECH_LOG` + procedure `PRC_26AI_TECH_LOG`,
+  instrumentando todas as chamadas de IA/embeddings (sucesso e erro).
+- `docs/09-operacao-observabilidade.html`: checklist de erros comuns e consultas prontas de
+  troubleshooting/consumo.
+

docs/02-arquitetura.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/03-pre-requisitos-credenciais.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/04-passo-a-passo-banco.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/05-passo-a-passo-apex.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/06-validacao-testes.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/07-seguranca-boas-praticas.html

@@ -26,6 +26,7 @@
 <li><a class="active" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/08-glossario-roadmap.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="active" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/09-operacao-observabilidade.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="active" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>
@@ -168,7 +169,7 @@ independentes, corrigir um não corrige o outro.</p>
   — não deve retornar linha depois que o processamento terminar.</p>
 </div>
 
-    <div class="pillnav"><a class="prev" href="08-glossario-roadmap.html">&larr; Glossário & roadmap</a></div>
+    <div class="pillnav"><a class="prev" href="08-glossario-roadmap.html">&larr; Glossário & roadmap</a><a class="next" href="10-carga-cmdb-vulnerabilidades.html">Carga: CMDB & Vulnerabilidades &rarr;</a></div>
   </main>
 </div>
 <script src="assets/main.js"></script>

docs/10-carga-cmdb-vulnerabilidades.html

@@ -0,0 +1,162 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>ampmInsights &middot; Carga de dados: CMDB e Vulnerabilidades</title>
+<meta name="description" content="Como preparar e subir novas cargas de CMDB (ServiceNow) e vulnerabilidades (Tenable) só com dados da AM/PM.">
+<link rel="stylesheet" href="assets/main.css">
+</head>
+<body>
+<div class="layout">
+  <aside class="sidebar">
+    <div class="brand">
+      <span class="oracle">ORACLE</span>
+      <span class="name">ampmInsights</span>
+    </div>
+    <button class="menu-toggle" type="button">Menu &#9776;</button>
+    <div class="kicker">Documentação V1 &middot; AM/PM</div>
+    <ul class="nav-list">
+      <li><a class="" href="index.html"><span class="step-no">1</span>Visão geral</a></li>
+<li><a class="" href="02-arquitetura.html"><span class="step-no">2</span>Arquitetura</a></li>
+<li><a class="" href="03-pre-requisitos-credenciais.html"><span class="step-no">3</span>Pré-requisitos & credenciais</a></li>
+<li><a class="" href="04-passo-a-passo-banco.html"><span class="step-no">4</span>Passo a passo: banco de dados</a></li>
+<li><a class="" href="05-passo-a-passo-apex.html"><span class="step-no">5</span>Passo a passo: aplicação APEX</a></li>
+<li><a class="" href="06-validacao-testes.html"><span class="step-no">6</span>Validação & testes</a></li>
+<li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
+<li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
+<li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="active" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
+    </ul>
+    <div class="sidebar-footer">
+      Vulnerability &amp; Audit AI Insights<br>
+      Oracle AI Database 26ai &middot; AI Vector Search<br>
+      Versão V1 &middot; ambiente reprodutível do cliente
+    </div>
+  </aside>
+  <main class="content">
+    <p class="page-kicker">Carga de dados</p>
+    <h1>Carga de dados: CMDB e Vulnerabilidades</h1>
+    <p class="lede">Guia rápido para preparar e subir novas cargas de CMDB (ServiceNow) e de vulnerabilidades (Tenable), garantindo que só entram dados da AM/PM.</p>
+
+<div class="callout danger">
+  <div class="callout-title">Por que filtrar antes de subir</div>
+  <p>O ServiceNow e o Tenable do grupo Ultrapar são compartilhados entre todas as empresas
+  (Ipiranga, Ultrapar, Iconic, AM/PM). Um export "bruto" do CMDB ou do Tenable traz ativos de
+  <strong>todas</strong> essas empresas misturados — sem filtrar antes de subir, o ambiente da
+  AM/PM passa a exibir servidores e vulnerabilidades de outras empresas do grupo. Siga os passos
+  abaixo em toda carga nova, não só na primeira.</p>
+</div>
+
+<h2>1. Como identificar o que é da AM/PM</h2>
+<p>O campo "Empresa"/"company" do export <strong>não é totalmente confiável</strong> — em uma
+carga real, cerca de 40% das linhas marcadas como AM/PM na verdade tinham nome de servidor no
+padrão de outra empresa do grupo. O critério que funciona é o <strong>nome do servidor</strong>:</p>
+<div class="table-wrap">
+<table>
+<tr><th>Prefixo do nome</th><th>Empresa</th></tr>
+<tr><td><code>AM...</code></td><td>AM/PM — manter</td></tr>
+<tr><td><code>IP...</code> / <code>I2...</code></td><td>Ipiranga — remover</td></tr>
+<tr><td><code>U2...</code></td><td>Ultragaz — remover</td></tr>
+<tr><td>outros/genéricos (ex.: endereço IP, hash, <code>SERV-*</code>)</td><td>revisar manualmente antes de decidir</td></tr>
+</table>
+</div>
+<p><strong>Regra prática no Excel:</strong> filtre a coluna de nome do servidor pra manter só
+linhas que <em>começam com</em> <code>AM</code> (não importa o que a coluna "Empresa" diga) e
+apague o restante. Revise manualmente linhas com nome fora desse padrão antes de decidir incluir
+ou não — nunca confie só na coluna "Empresa".</p>
+
+<h2>2. Mapeamento de colunas — CMDB</h2>
+<p>O arquivo de CMDB do ServiceNow vem com nomes de coluna em inglês; a carga no ampmInsights
+espera um <strong>XLSX</strong> com os cabeçalhos exatamente como na tabela abaixo (renomeie as
+colunas no Excel antes de subir):</p>
+<div class="table-wrap">
+<table>
+<tr><th>Coluna no export ServiceNow</th><th>Renomear para (cabeçalho esperado)</th></tr>
+<tr><td><code>name</code></td><td><code>NOME</code></td></tr>
+<tr><td><code>operational_status</code></td><td><code>STATUS_OPERACIONAL</code></td></tr>
+<tr><td><code>short_description</code></td><td><code>DESCRIÇÃO</code></td></tr>
+<tr><td><code>environment</code></td><td><code>AMBIENTE</code></td></tr>
+<tr><td><code>company</code></td><td><code>EMPRESA</code> (revise pelo nome do servidor, não copie direto)</td></tr>
+<tr><td><code>managed_by_group</code></td><td><code>GERENCIADO_PELO_GRUPO</code></td></tr>
+<tr><td><code>assignment_group</code></td><td><code>GRUPO_RESPONSÁVEL</code></td></tr>
+<tr><td><code>u_safe_box</code></td><td><code>COFRE</code> (converter Verdadeiro/Falso(a) para 1/0)</td></tr>
+<tr><td><code>u_sox</code></td><td><code>SOX</code> (converter Verdadeiro/Falso(a) para 1/0)</td></tr>
+<tr><td><code>u_tipo_de_rede</code></td><td><code>TIPO_DE_REDE</code></td></tr>
+<tr><td><code>u_grupo_resp_assignment_group</code></td><td><code>GRUPOS_RESPONSÁVEIS</code></td></tr>
+<tr><td><code>u_tenable</code></td><td><code>TENABLE</code> (converter Verdadeiro/Falso(a) para 1/0)</td></tr>
+<tr><td><code>u_siem</code></td><td><code>SIEM</code> (converter Verdadeiro/Falso(a) para 1/0)</td></tr>
+<tr><td><em>sem equivalente no export</em></td><td><code>É_VIRTUAL</code>, <code>APPLIANCE</code>, <code>EDR</code> — deixe em branco</td></tr>
+</table>
+</div>
+
+<h2>3. Mapeamento de colunas — Vulnerabilidades</h2>
+<p>O export do Tenable também precisa ter os cabeçalhos renomeados. Use só as colunas abaixo —
+o restante do export do Tenable (CVE, CVSS, solução, etc.) não é usado nesta carga:</p>
+<div class="table-wrap">
+<table>
+<tr><th>Coluna no export Tenable</th><th>Renomear para (cabeçalho esperado)</th></tr>
+<tr><td><code>age_in_days</code></td><td><code>AGE_IN_DAYS</code></td></tr>
+<tr><td><code>asset.display_ipv4_address</code></td><td><code>ASSET_DISPLAY_IPV4_ADDRESS</code></td></tr>
+<tr><td><code>asset.id</code></td><td><code>ASSET_ID</code></td></tr>
+<tr><td><code>asset.name</code></td><td><code>ASSET_NAME</code></td></tr>
+<tr><td><code>asset.tags</code></td><td><code>ASSET_TAGS</code></td></tr>
+<tr><td><code>definition.exploitability_ease</code></td><td><code>DEFINITION_EXPLOITABILITY_EASE</code></td></tr>
+<tr><td><code>definition.family</code></td><td><code>DEFINITION_FAMILY</code></td></tr>
+<tr><td><code>definition.id</code></td><td><code>DEFINITION_ID</code></td></tr>
+<tr><td><code>definition.name</code></td><td><code>DEFINITION_NAME</code></td></tr>
+<tr><td><code>definition.vpr.score</code></td><td><code>DEFINITION_VPR_SCORE</code></td></tr>
+<tr><td><code>first_observed</code></td><td><code>FIRST_OBSERVED</code></td></tr>
+<tr><td><code>id</code></td><td><code>ID</code></td></tr>
+<tr><td><code>last_seen</code></td><td><code>LAST_SEEN</code></td></tr>
+<tr><td><code>output</code></td><td><code>OUTPUT</code></td></tr>
+<tr><td><code>protocol</code></td><td><code>PROTOCOL</code></td></tr>
+<tr><td><code>resurfaced_date</code></td><td><code>RESURFACED_DATE</code></td></tr>
+<tr><td><code>severity</code></td><td><code>SEVERITY</code></td></tr>
+<tr><td><code>state</code></td><td><code>STATE</code></td></tr>
+</table>
+</div>
+<div class="callout warning">
+  <div class="callout-title">Filtre as vulnerabilidades pelo mesmo critério do CMDB</div>
+  <p>Depois de filtrar o CMDB, filtre também o arquivo de vulnerabilidades: mantenha só as linhas
+  cujo <code>ASSET_NAME</code> começa com <code>AM</code> — mesmo critério do passo 1, aplicado
+  aqui pelo nome do ativo em vez do nome do servidor.</p>
+</div>
+
+<h2>4. Passo a passo da carga</h2>
+<ol>
+  <li><strong>Exportar</strong> o CMDB (ServiceNow) e as vulnerabilidades (Tenable) em CSV, como de costume.</li>
+  <li><strong>Filtrar</strong> as duas planilhas pelo critério do passo 1 (nome começa com <code>AM</code>).</li>
+  <li><strong>Renomear as colunas</strong> conforme as tabelas dos passos 2 e 3, e salvar cada planilha como <code>.xlsx</code>.</li>
+  <li><strong>Se for recarregar dados já existentes</strong> (não uma carga inicial), limpe as tabelas antes — peça ao time técnico para rodar:
+    <div class="code-block">
+      <div class="code-bar">
+        <span class="code-label">Limpeza antes de recarregar (time técnico)</span>
+        <button class="copy-btn" type="button">Copiar</button>
+      </div>
+      <pre><code class="lang-sql">DELETE FROM TB_26AI_TECH_VECTOR WHERE source_type = 'VUL';
+DELETE FROM TB_26AI_TECH_V2;
+DELETE FROM TB_26AI_TECH_CMDB;
+COMMIT;</code></pre>
+    </div>
+  </li>
+  <li><strong>Suba o CMDB primeiro</strong>, pelo menu <strong>Upload CMDB</strong> da aplicação.</li>
+  <li><strong>Suba as vulnerabilidades em seguida</strong> (depois do CMDB, pra já aparecer nome/empresa corretos nos insights).</li>
+  <li><strong>Valide</strong>: confira no CMDB que o total de linhas bate com o esperado e que o filtro "Empresa" só mostra AM/PM; confira na tela de Insights que os nomes de servidor são todos padrão <code>AM...</code>.</li>
+</ol>
+
+<div class="callout info">
+  <div class="callout-title">Casos que sempre merecem revisão manual</div>
+  <ul>
+    <li>Nomes com sufixo <code>#DUP</code> — o ServiceNow já marcou como duplicata pendente de revisão.</li>
+    <li>Nomes duplicados exatos na planilha de CMDB — mantenha a linha com status "Operacional" e descarte a outra.</li>
+    <li>Ativos de vulnerabilidade sem correspondência no CMDB filtrado — ficam sem nome/empresa preenchidos nos insights, mas os dados de vulnerabilidade continuam sendo carregados normalmente.</li>
+  </ul>
+</div>
+
+    <div class="pillnav"><a class="prev" href="09-operacao-observabilidade.html">&larr; Operação & observabilidade</a></div>
+  </main>
+</div>
+<script src="assets/main.js"></script>
+</body>
+</html>

docs/index.html

@@ -26,6 +26,7 @@
 <li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
 <li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
 <li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
+<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>