# Contribuindo Com Novos Labs

Use este repositório como produto interno de enablement. O padrão é simples: cada cenário precisa ser independente, resetável e fácil de apresentar.

## Fluxo Git Sugerido

```bash
git checkout -b feature/scenario-05-rag-vector-access
git add .
git commit -m "Add RAG vector access lab scenario"
git push -u origin feature/scenario-05-rag-vector-access
```

Abra um pull request para `main` com:

- Objetivo do cenário.
- Evidências esperadas.
- Impacto esperado em infraestrutura.
- Testes positivos e negativos executados.
- Limitações conhecidas.

## Checklist Para Novo Cenário

- `README.md` com narrativa de negócio e execução.
- `metadata.yaml` com ID, criticidade, dependências e tempo estimado.
- `sql/00_schema.sql`, quando criar objetos próprios.
- `sql/01_seed_data.sql`, quando precisar de dados.
- `sql/02_identities.sql`, quando criar end users/data roles locais.
- `sql/03_data_grants.sql`, para políticas Deep Data Security.
- `sql/04_test_queries.sql`, para demonstração.
- `sql/99_reset.sql`, para rollback.
- `tests/positive_tests.sql`.
- `tests/negative_tests.sql`.
- `evidence/expected-results.md`.

## Regras

- Não commitar senhas, wallets, `.tfvars`, chaves privadas ou evidências reais de cliente.
- Manter SQL idempotente sempre que possível.
- Separar demonstração de produto de controles complementares como TDE, Database Vault, Data Safe e AVDF.
- Usar linguagem simples nos guias; a demo precisa funcionar para CISO e DBA.