Passo 3 v2.0.0: templates de amostra + caminho de distribuição sem App Builder pro cliente

- Achado: DL_TECH_CMDB_V1/DL_TECH_VULNERABILIDADE_V2 vivem dentro de
  sql/02_ampminsights_apex_app.sql via wwv_flow_imp_shared (API interna
  de export/import do APEX) — não escrever isso à mão fora de um
  import completo.
- templates/sample_DL_TECH_CMDB_V2.xlsx (27 col.) e
  templates/sample_DL_TECH_VULNERABILIDADE_V3.xlsx (40 col.): arquivos
  de amostra só-cabeçalho pra criar os perfis via upload no wizard do
  APEX, em vez de preencher campo a campo.
- docs/13 reescrito: seção 5 usa o fluxo de upload de amostra; nova
  seção 7 explica que só o desenvolvedor toca em App Builder uma vez,
  e o cliente recebe um export completo novo (mesmo fluxo de release
  já usado sempre) — nunca precisa saber o que é Data Load Definition.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-09 19:12:43 -03:00
parent df0d775540
commit 0e7d75db27
4 changed files with 57 additions and 14 deletions

View File

@@ -43,10 +43,16 @@ teste — a menos que você peça explicitamente o contrário.
(bloco grande) foi pulado na primeira passada — o checkpoint de compilação deu `VALID`
porque a view *antiga* (46 colunas) já era válida antes. Resolvido rodando o bloco
explicitamente; segunda checagem confirmou as 81 colunas.
- [ ] **Mapeamento pronto e confirmado contra export real** (ver
[docs/13-v2-perfis-carga.html](docs/13-v2-perfis-carga.html)) — falta só criar os dois
perfis de fato no App Builder (não é scriptável, precisa ser feito na UI). `RAW_JSON`
deliberadamente fora do escopo deste item — depende do item de staging abaixo.
- [ ] **Mapeamento pronto + templates de amostra prontos** (ver
[docs/13-v2-perfis-carga.html](docs/13-v2-perfis-carga.html) e `templates/`) — falta criar
os dois perfis no App Builder (uma vez, seu acesso, não do cliente — upload dos templates de
amostra, não preenchimento campo a campo) e depois gerar um export completo novo da
Application 100 (captura os perfis automaticamente, com IDs corretos). O cliente só importa
esse export, nunca toca em Data Load Definitions — mesmo fluxo de sempre. **Achado
importante:** essas definições vivem dentro de `sql/02_ampminsights_apex_app.sql` via API
interna do APEX (`wwv_flow_imp_shared`) — não escrever isso à mão fora de um import
completo, risco de corromper os Shared Components. `RAW_JSON` deliberadamente fora do
escopo deste item — depende do item de staging abaixo.
- [ ] Pipeline de staging: bucket → `TB_26AI_TECH_V2_STG` via `DBMS_CLOUD.COPY_DATA` (tabela nova,
não mexe nas existentes)
- [ ] `MERGE` com histórico (`LOAD_BATCH_ID`, `TB_26AI_TECH_V2_HIST` — tabela nova), honrando o