oracle-deep-data-security-lab/CONTRIBUTING.md

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

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.
• RUNBOOK.md com passo a passo antes/depois, evidencias e referencias oficiais.
• 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.