Files
ampmInsights/README.md
Antonio Sergio Rodrigues Figueiredo e519811f80 Adiciona ROADMAP_AGENTICO.md: análise para v3.0.0 (sistema agêntico)
- Diagnóstico do padrão atual (PRC_26AI_TECH single-shot) vs. padrão de
  agentes/tasks/tools/teams de um case bancário de referência
  (DBMS_CLOUD_AI_AGENT, Property Graph, Blockchain Table, VPD, Knowledge
  Graph chain).
- Mapeamento de analogia Persona/Agente/Task/Tools aplicado ao domínio de
  vulnerability management do AMPM.
- Achado prático destacado: padrão fn_analise_carteira_json (separar
  cálculo determinístico de narrativa da IA) — não depende de agentes,
  pode entrar como v2.1.0.
- Achado de acelerador: app pronto da Oracle 'Ask Oracle Select AI
  Chatbot' já expõe builder visual de agentes sobre o mesmo
  DBMS_CLOUD_AI_AGENT.
- Sequenciamento: v3.0.0 depende do v2.0.0 estar em produção primeiro.
  Nenhuma mudança no trabalho em andamento do v2.0.0.
- README.md e TASKS.md referenciam o novo doc.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-09 16:19:20 -03:00

2.1 KiB
Raw Permalink Blame History

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) — nunca DROP+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 .gitignore e a seção de segurança em docs/07-seguranca-boas-praticas.html.