Antonio Sergio Rodrigues Figueiredo
f8595435e0
Checkpoint rodado pelo usuário no ambiente AMPMINSIGHTS confirmou STATUS = 'OK' nas duas tabelas. TASKS.md marca o item como concluído; docs/11 troca o aviso de 'em validação' por confirmação. 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.