Translate lab documentation to English
Some checks failed
Repo Quality / structure (push) Has been cancelled
Terraform Validate / validate (push) Has been cancelled

This commit is contained in:
Rodrigo Pace
2026-05-08 14:50:52 -03:00
parent cde150b705
commit 52bf971b8b
33 changed files with 939 additions and 702 deletions

View File

@@ -1,8 +1,8 @@
# Contribuindo Com Novos Labs
# Contributing New 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.
Treat this repository as an internal enablement product. Each scenario should be independent, resettable, easy to present, and clear enough for a consultant who is not a database specialist.
## Fluxo Git Sugerido
## Suggested Git Flow
```bash
git checkout -b feature/scenario-05-rag-vector-access
@@ -11,32 +11,33 @@ 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:
Open a pull request to `main` with:
- Objetivo do cenário.
- Evidências esperadas.
- Impacto esperado em infraestrutura.
- Testes positivos e negativos executados.
- Limitações conhecidas.
- scenario objective
- expected evidence
- expected infrastructure impact
- positive and negative tests executed
- known limitations
## Checklist Para Novo Cenário
## New Scenario Checklist
- `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.
- `README.md` with business narrative and execution instructions.
- `RUNBOOK.md` with before/after steps, evidence, and official references.
- `metadata.yaml` with ID, criticality, dependencies, and estimated time.
- `sql/00_schema.sql`, when creating scenario-specific objects.
- `sql/01_seed_data.sql`, when seed data is needed.
- `sql/02_identities.sql`, when creating local end users or data roles.
- `sql/03_data_grants.sql`, for Oracle Deep Data Security policies.
- `sql/04_test_queries.sql`, for demo queries.
- `sql/99_reset.sql`, for rollback.
- `tests/positive_tests.sql`.
- `tests/negative_tests.sql`.
- `evidence/expected-results.md`.
## Regras
## Rules
- Do not commit passwords, wallets, `.tfvars`, private keys, or real customer evidence.
- Keep SQL idempotent where possible.
- Separate Oracle Deep Data Security product demos from complementary controls such as TDE, Database Vault, Data Safe, and AVDF.
- Use simple language in guides; the demo must work for both CISO and DBA audiences.
- 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.