From b54fcb4f38039b5caaddad89ba8571b41b50bcff Mon Sep 17 00:00:00 2001 From: Antonio Sergio Rodrigues Figueiredo Date: Wed, 9 Sep 2026 11:38:05 -0300 Subject: [PATCH] =?UTF-8?q?Adiciona=20README.md:=20mapa=20do=20reposit?= =?UTF-8?q?=C3=B3rio=20(branches,=20tags,=20por=20onde=20come=C3=A7ar)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 5 --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..5b04d98 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# 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](TASKS.md) +- **Histórico de versões da V2:** [CHANGELOG.md](CHANGELOG.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/) — + `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`.