Docs v2.0.0: capítulos 11 e 12 (evolução de schema + view/procedure)

- docs/11-v2-evolucao-schema.html: documenta o Passo 1
  (sql/03_v2_ddl_schema_evolution.sql) — o quê, por quê, script resumido,
  como rodar, validação, rollback. Callout deixa explícito que ainda está
  em validação, não é procedimento definitivo.
- docs/12-v2-view-procedure.html: documenta o Passo 2
  (sql/04_v2_view_procedure_update.sql), mesmo formato, com dependência
  explícita do capítulo 11.
- Nav lateral (sidebar) atualizada nas 12 páginas do doc set para incluir
  os capítulos novos; pillnav do capítulo 10 ganhou link 'next' para o 11.

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

docs/02-arquitetura.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/03-pre-requisitos-credenciais.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

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

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

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

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/06-validacao-testes.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/07-seguranca-boas-praticas.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/08-glossario-roadmap.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/09-operacao-observabilidade.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>

docs/10-carga-cmdb-vulnerabilidades.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>
@@ -154,7 +156,7 @@ COMMIT;</code></pre>
   </ul>
 </div>
 
-    <div class="pillnav"><a class="prev" href="09-operacao-observabilidade.html">&larr; Operação & observabilidade</a></div>
+    <div class="pillnav"><a class="prev" href="09-operacao-observabilidade.html">&larr; Operação & observabilidade</a><a class="next" href="11-v2-evolucao-schema.html">v2.0.0 — Evolução de schema &rarr;</a></div>
   </main>
 </div>
 <script src="assets/main.js"></script>

docs/11-v2-evolucao-schema.html

@@ -0,0 +1,143 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>ampmInsights &middot; v2.0.0 — Evolução de schema</title>
+<meta name="description" content="Passo 1 da v2.0.0: colunas novas em TB_26AI_TECH_V2/CMDB para CVE, pacotes e remediação chegarem ao AI Insight.">
+<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 V2 &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="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
+<li><a class="active" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
+    </ul>
+    <div class="sidebar-footer">
+      Vulnerability &amp; Audit AI Insights<br>
+      Oracle AI Database 26ai &middot; AI Vector Search<br>
+      Versão V2 &middot; em desenvolvimento, ainda não validada
+    </div>
+  </aside>
+  <main class="content">
+    <p class="page-kicker">v2.0.0 &middot; Passo 1</p>
+    <h1>Evolução de schema: CVE, CVSS, solução e mais</h1>
+    <p class="lede">Promove os campos "Tier 1" do Tenable e do ServiceNow — hoje fora do banco — a colunas novas em <code>TB_26AI_TECH_V2</code> e <code>TB_26AI_TECH_CMDB</code>, para que o AI Insight consiga citar CVE, pacote afetado e remediação por ativo.</p>
+
+<div class="callout warning">
+  <div class="callout-title">Status: em validação, ainda não roda em produção</div>
+  <p>Este capítulo documenta um passo já implementado no script (<code>sql/03_v2_ddl_schema_evolution.sql</code>), mas ainda <strong>não confirmado em nenhum ambiente</strong>. Não use este passo como procedimento definitivo até a seção 5 (Validação) ter sido de fato executada e conferida.</p>
+</div>
+
+<h2>1. Por que isto era necessário</h2>
+<p><code>PRC_26AI_TECH</code> (geração do AI Insight) monta o JSON enviado ao LLM inteiramente a
+partir da <code>view V_26AI_TECH</code>, que só expõe as colunas que existem em
+<code>TB_26AI_TECH_V2</code>/<code>TB_26AI_TECH_CMDB</code>. Antes da v2.0.0, apenas 18 das 99
+colunas do export Tenable chegavam ao banco — nenhum campo de CVE, CVSS, EPSS, CISA KEV, pacote
+afetado ou solução sugerida existia na tabela. Não era um problema de prompt: o modelo nunca via
+esses dados porque eles simplesmente não estavam disponíveis.</p>
+
+<h2>2. O que foi adicionado</h2>
+<p>Estratégia híbrida: colunas tipadas para os campos que realmente importam para o "plano de
+ação" do AI Insight, <strong>mais</strong> uma coluna <code>RAW_JSON</code> por linha guardando o
+export completo — assim nada da planilha se perde, mesmo o que não virou coluna tipada.</p>
+
+<div class="table-wrap">
+<table>
+<tr><th>Tabela</th><th>Colunas novas</th><th>Destaque</th></tr>
+<tr><td><code>TB_26AI_TECH_V2</code><br>(vulnerabilidades Tenable)</td><td>23 colunas</td><td><code>DEFINITION_CVE</code>, <code>DEFINITION_SOLUTION</code>, <code>DEFINITION_DESCRIPTION</code>, <code>SOFTWARE_VULNS</code>, <code>DEFINITION_CVSS3_BASE_SCORE</code>, <code>DEFINITION_EPSS_SCORE</code>, <code>CISA_KEV_FLAG</code>, <code>RAW_JSON</code></td></tr>
+<tr><td><code>TB_26AI_TECH_CMDB</code><br>(CMDB ServiceNow)</td><td>12 colunas</td><td><code>U_FIM_DO_SUPORTE</code> (EOL), <code>ATTESTATION_SCORE</code>/<code>_STATUS</code>, <code>INSTALL_STATUS</code>, <code>RAW_JSON</code></td></tr>
+</table>
+</div>
+
+<div class="callout info">
+  <div class="callout-title">100% aditivo — nenhum DROP</div>
+  <p>Todas as colunas são novas e <code>NULL</code>able. Nenhuma tabela é recriada, nenhuma coluna
+  existente é alterada, nenhum dado é apagado. A carga e a aplicação atuais continuam funcionando
+  exatamente como antes — os campos novos só ficam vazios até um perfil de carga novo alimentá-los
+  (ver capítulo 13, ainda não publicado). Decisão deliberada: um release aditivo, não um
+  drop/recriação, para a v2.0.0 chegar ao ambiente do cliente sem impacto no que já roda.</p>
+</div>
+
+<h2>3. Script</h2>
+<p>Arquivo completo: <code>sql/03_v2_ddl_schema_evolution.sql</code> no repositório. Resumo do que ele faz:</p>
+<div class="code-block">
+  <div class="code-bar">
+    <span class="code-label">sql/03_v2_ddl_schema_evolution.sql (resumo)</span>
+    <button class="copy-btn" type="button">Copiar</button>
+  </div>
+  <pre><code class="lang-sql">ALTER TABLE TB_26AI_TECH_V2 ADD (
+    DEFINITION_CVE VARCHAR2(4000), DEFINITION_DESCRIPTION CLOB,
+    DEFINITION_SOLUTION CLOB, DEFINITION_SYNOPSIS VARCHAR2(4000),
+    SOFTWARE_VULNS CLOB, DEFINITION_CVSS3_BASE_SCORE NUMBER,
+    DEFINITION_CVSS3_BASE_VECTOR VARCHAR2(255), DEFINITION_CPE VARCHAR2(4000),
+    DEFINITION_EPSS_SCORE NUMBER, CISA_KEV_FLAG NUMBER(1),
+    EXPLOITED_BY_MALWARE_FLAG NUMBER(1), EXPLOITED_BY_NESSUS_FLAG NUMBER(1),
+    PORT NUMBER, ASSET_OPERATING_SYSTEM VARCHAR2(255),
+    LAST_FIXED TIMESTAMP(9) WITH TIME ZONE, TIME_TO_FIX NUMBER,
+    VULN_SLA_DATE TIMESTAMP(9) WITH TIME ZONE,
+    PATCH_PUBLISHED TIMESTAMP(9) WITH TIME ZONE,
+    VULNERABILITY_PUBLISHED TIMESTAMP(9) WITH TIME ZONE,
+    SOURCE_SCAN VARCHAR2(100), SCAN_ID VARCHAR2(255), SCAN_TARGET VARCHAR2(255),
+    RAW_JSON CLOB
+);
+
+ALTER TABLE TB_26AI_TECH_CMDB ADD (
+    INSTALL_STATUS VARCHAR2(100), LIFE_CYCLE_STAGE_STATUS VARCHAR2(100),
+    ASSIGNED_TO VARCHAR2(255), ATTESTATION_SCORE NUMBER,
+    ATTESTATION_STATUS VARCHAR2(100), ATTESTED_FLAG VARCHAR2(10),
+    ATTESTED_BY VARCHAR2(255), U_FIM_DO_SUPORTE DATE, LOCATION VARCHAR2(255),
+    ASSET_TAG VARCHAR2(100), U_SERVER_ROLE VARCHAR2(255), RAW_JSON CLOB
+);</code></pre>
+</div>
+<p>O arquivo real tem, além disso, o <code>ANNOTATIONS("LLM_DESCRIPTION_PT_BR" ...)</code> em cada
+coluna (padrão já usado em todo o schema, ajuda o Select AI a entender o dado) e um checkpoint de
+validação embutido — use o arquivo do repositório para rodar, não este resumo.</p>
+
+<h2>4. Como rodar</h2>
+<ol>
+  <li>Abra Database Actions (ou SQL Developer/SQLcl) conectado como o schema <code>AMPMINSIGHTS</code> — nunca como <code>ADMIN</code>.</li>
+  <li>Confirme que está no ambiente correto antes de rodar (o script tem um aviso explícito sobre isso no topo).</li>
+  <li>Cole e rode <code>sql/03_v2_ddl_schema_evolution.sql</code> inteiro, de uma vez — é idempotente, pode rodar de novo sem erro se uma coluna já existir.</li>
+</ol>
+
+<h2>5. Validação</h2>
+<p>O próprio script termina com este checkpoint — rode e confira <code>STATUS = 'OK'</code> nas duas linhas:</p>
+<div class="code-block">
+  <div class="code-bar">
+    <span class="code-label">Checkpoint de validação</span>
+    <button class="copy-btn" type="button">Copiar</button>
+  </div>
+  <pre><code class="lang-sql">SELECT table_name, /* ... */ status, colunas_novas_encontradas
+FROM ( /* ver script completo */ );
+-- Esperado: TB_26AI_TECH_V2 -> OK (23) | TB_26AI_TECH_CMDB -> OK (12)</code></pre>
+</div>
+
+<div class="callout danger">
+  <div class="callout-title">Rollback, se precisar desfazer</div>
+  <p>Todas as colunas são novas e nullable — para desfazer, um <code>ALTER TABLE ... DROP COLUMN</code> por coluna adicionada (lista completa no final do script). Nenhum dado existente é afetado ao reverter.</p>
+</div>
+
+    <div class="pillnav"><a class="prev" href="10-carga-cmdb-vulnerabilidades.html">&larr; Carga: CMDB & Vulnerabilidades</a><a class="next" href="12-v2-view-procedure.html">v2.0.0 — View & Procedure &rarr;</a></div>
+  </main>
+</div>
+<script src="assets/main.js"></script>
+</body>
+</html>

docs/12-v2-view-procedure.html

@@ -0,0 +1,117 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>ampmInsights &middot; v2.0.0 — View & Procedure</title>
+<meta name="description" content="Passo 2 da v2.0.0: V_26AI_TECH e prc_26ai_tech passam a enviar CVE, pacote e remediação ao LLM.">
+<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 V2 &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="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="active" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
+    </ul>
+    <div class="sidebar-footer">
+      Vulnerability &amp; Audit AI Insights<br>
+      Oracle AI Database 26ai &middot; AI Vector Search<br>
+      Versão V2 &middot; em desenvolvimento, ainda não validada
+    </div>
+  </aside>
+  <main class="content">
+    <p class="page-kicker">v2.0.0 &middot; Passo 2</p>
+    <h1>Expondo os dados novos ao AI Insight</h1>
+    <p class="lede">Ter as colunas novas na tabela não basta — <code>V_26AI_TECH</code> e o <code>json_object</code> de <code>prc_26ai_tech</code> precisam repassar esses campos até o LLM. Este é o passo que faz isso.</p>
+
+<div class="callout warning">
+  <div class="callout-title">Status: em validação, ainda não roda em produção</div>
+  <p>Documenta um passo já implementado (<code>sql/04_v2_view_procedure_update.sql</code>), mas ainda não confirmado em nenhum ambiente. Depende do <a href="11-v2-evolucao-schema.html">capítulo 11</a> já ter sido aplicado e validado no mesmo ambiente.</p>
+</div>
+
+<h2>1. Por que este passo é separado do anterior</h2>
+<p>A coluna existir na tabela e o LLM receber o dado são duas coisas diferentes. O AI Insight
+("Gerar Insight") lê o registro através de <code>V_26AI_TECH</code>, e o texto que vai pro modelo
+é montado campo a campo dentro de um <code>json_object(...)</code> em <code>prc_26ai_tech</code>.
+Sem tocar nesses dois objetos, os campos do <a href="11-v2-evolucao-schema.html">capítulo 11</a>
+ficariam na tabela mas invisíveis para a IA.</p>
+
+<h2>2. O que muda</h2>
+<div class="table-wrap">
+<table>
+<tr><th>Objeto</th><th>Mudança</th></tr>
+<tr><td><code>V_26AI_TECH</code></td><td>+35 colunas (23 de <code>TB_26AI_TECH_V2</code> + 12 de <code>TB_26AI_TECH_CMDB</code>). As colunas antigas ficam exatamente como estavam — só houve acréscimo no final da lista. <code>RAW_JSON</code> de cada tabela vira <code>RAW_JSON_TENABLE</code>/<code>RAW_JSON_CMDB</code> na view, para não colidir nome.</td></tr>
+<tr><td><code>prc_26ai_tech</code></td><td>Só o <code>json_object</code> do ramo <code>p_source_type = 'VUL'</code> ganhou os campos novos. O ramo <code>'SYS'</code> (syslog), o texto do prompt, a vetorização, o log e o tratamento de erro ficam <strong>idênticos</strong> ao script original.</td></tr>
+</table>
+</div>
+
+<div class="callout info">
+  <div class="callout-title">O prompt não mudou</div>
+  <p>O texto enviado ao LLM (<code>v_pre_prompt</code>) já pedia "recomendações" e "plano de ação"
+  desde a v1.x — ele só não recebia matéria-prima suficiente para cumprir isso. Este passo resolve
+  isso enriquecendo os <strong>dados</strong>, sem precisar reescrever o prompt.</p>
+</div>
+
+<h2>3. Como rodar</h2>
+<ol>
+  <li>Mesmo ambiente/schema (<code>AMPMINSIGHTS</code>) onde o <a href="11-v2-evolucao-schema.html">capítulo 11</a> já foi validado — a view não compila sem as colunas de lá existirem.</li>
+  <li>Cole e rode <code>sql/04_v2_view_procedure_update.sql</code> inteiro, de uma vez.</li>
+</ol>
+
+<h2>4. Validação</h2>
+<p>Dois checkpoints, sem gastar nenhuma chamada de LLM:</p>
+<div class="code-block">
+  <div class="code-bar">
+    <span class="code-label">1) Compilação dos objetos</span>
+    <button class="copy-btn" type="button">Copiar</button>
+  </div>
+  <pre><code class="lang-sql">SELECT object_name, object_type, status
+FROM user_objects
+WHERE object_name IN ('V_26AI_TECH', 'PRC_26AI_TECH')
+ORDER BY object_name;
+-- Esperado: as duas linhas com STATUS = 'VALID'.</code></pre>
+</div>
+<div class="code-block">
+  <div class="code-bar">
+    <span class="code-label">2) Os campos novos chegam pela view</span>
+    <button class="copy-btn" type="button">Copiar</button>
+  </div>
+  <pre><code class="lang-sql">SELECT cid, asset_name, definition_cve, definition_solution,
+       sistema_operacional, u_fim_do_suporte
+FROM V_26AI_TECH
+FETCH FIRST 3 ROWS ONLY;
+-- Pode vir tudo NULL se ainda não recarregou dado com o Tenable/ServiceNow
+-- novos (normal) - o que importa aqui é a coluna existir e ser lida.</code></pre>
+</div>
+<p>Um teste completo de ponta a ponta (o AI Insight citando CVE/pacote/remediação de fato) só faz
+sentido depois do capítulo 13 (perfis de carga novos, ainda não publicado) — ver
+<code>TASKS.md</code> no repositório para o board de tarefas atualizado.</p>
+
+<div class="callout danger">
+  <div class="callout-title">Rollback, se precisar desfazer</div>
+  <p>Rode de novo o <code>CREATE OR REPLACE VIEW</code>/<code>PROCEDURE</code> originais (<code>sql/01_ampminsights_db_setup.sql</code>, trechos <code>V_26AI_TECH</code> e <code>prc_26ai_tech</code>) — como são <code>CREATE OR REPLACE</code>, isso restaura o comportamento anterior sem afetar dado nenhum (view e procedure não guardam estado).</p>
+</div>
+
+    <div class="pillnav"><a class="prev" href="11-v2-evolucao-schema.html">&larr; v2.0.0 — Evolução de schema</a></div>
+  </main>
+</div>
+<script src="assets/main.js"></script>
+</body>
+</html>

docs/index.html

@@ -27,6 +27,8 @@
 <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>
+<li><a class="" href="11-v2-evolucao-schema.html"><span class="step-no">11</span>v2.0.0 — Evolução de schema</a></li>
+<li><a class="" href="12-v2-view-procedure.html"><span class="step-no">12</span>v2.0.0 — View & Procedure</a></li>
     </ul>
     <div class="sidebar-footer">
       Vulnerability &amp; Audit AI Insights<br>