Antonio Sergio Rodrigues Figueiredo
0e7d75db27
- 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>
ampmInsights
Oracle APEX + AI Vector Search (Select AI / ONNX embeddings) para gestão de vulnerabilidades e CMDB do cliente AM/PM (grupo Ultrapar). Repositório central do projeto — antes disso, o trabalho vivia em pastas locais soltas, sem remoto.
Estrutura deste repositório
| Branch | O que é | Status |
|---|---|---|
main |
V2 — segunda geração, trabalho ativo. Fork de V1 (09/09/2026) + overhaul de schema (v2.0.0) para expor CVE/pacote/remediação ao AI Insight. | 🚧 Em desenvolvimento, nada executado em banco ainda |
v1-cliente-frozen (ver branch src/branch/v1-cliente-frozen) |
V1 — pacote cliente-facing, tags v1.0.0→v1.3.0. É exatamente o que está implementado e validado no ambiente do cliente hoje. |
🔒 Congelado, só leitura — não editar |
Tags v1.0.0–v1.3.0 (na branch v1-cliente-frozen) e v2.0.0-fork-baseline (nesta branch)
preservam o histórico completo de releases.
Por onde começar
- Board de tarefas / próximos passos: TASKS.md
- Histórico de versões da V2: CHANGELOG.md
- Roadmap agêntico (v3.0.0, ainda não iniciado): ROADMAP_AGENTICO.md
- Mapeamento de gap de schema (v1.4.0→v2.0.0):
../ANALISE_DADOS_v1.4.0_gap_schema.md(fora deste repo por enquanto — planejamento interno, ainda não movido para cá) - Documentação passo a passo (instalação, arquitetura, operação): docs/ —
docs/index.html, publicado também como página única navegável (ver TASKS.md para o link quando existir) - Regra de ouro do release: v2.0.0 chega ao ambiente do cliente por evolução aditiva
(
ALTER TABLE, tabelas novas,MERGE) — nuncaDROP+recriação.
O que NÃO fazer
- Não editar a branch
v1-cliente-frozen— ela precisa continuar espelhando exatamente o que está validado e rodando no cliente. - Não commitar segredos: tokens, senhas de banco/wallet, exports brutos de CMDB/Vulnerabilidades
(contêm dados reais de outras empresas do grupo Ultrapar — Ipiranga, Ultrapar, Iconic). Ver
.gitignoree a seção de segurança emdocs/07-seguranca-boas-praticas.html.