docs: padroniza PT-BR e reforca onboarding

Author: Thiago-code-lab

.github/ISSUE_TEMPLATE/aws_update.md

@@ -0,0 +1,23 @@
+---
+name: AWS update
+about: Sugerir atualização por mudança de serviço ou recurso novo da AWS
+labels: aws-update
+---
+
+## Serviço AWS impactado
+Informe o serviço e, se possível, a feature específica.
+
+## O que mudou
+Descreva a mudança de comportamento, limite, nomenclatura ou recomendação.
+
+## Arquivos afetados
+Liste os links/paths dos arquivos que precisam ser atualizados.
+
+## Referências oficiais
+Adicione links para documentação oficial, release notes ou anúncios AWS.
+
+## Impacto no material
+Explique como essa mudança afeta explicações, labs, questões ou cheatsheets.
+
+## Proposta de atualização
+Descreva a alteração sugerida no conteúdo.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Relatar erro técnico ou de conteúdo
+labels: bug
+---
+
+## Descrição do problema
+Descreva o erro de forma objetiva.
+
+## Arquivos afetados
+Liste os links/paths dos arquivos impactados.
+
+## Comportamento atual
+Explique o que está incorreto hoje.
+
+## Comportamento esperado
+Explique como deveria estar.
+
+## Contexto adicional
+Inclua evidências, referências oficiais da AWS e capturas quando necessário.
+
+## Proposta de correção
+Descreva a alteração sugerida (ou passos para reproduzir/corrigir).

.github/ISSUE_TEMPLATE/pedagogy_suggestion.md

@@ -0,0 +1,20 @@
+---
+name: Pedagogy suggestion
+about: Sugerir melhoria didática de explicação, diagrama, fluxo ou lab
+labels: pedagogy
+---
+
+## Sugestão pedagógica
+Descreva a melhoria proposta de forma clara.
+
+## Arquivos afetados
+Liste os links/paths dos arquivos relacionados.
+
+## Problema atual para o estudante
+Explique por que o ponto atual pode gerar dúvida, confusão ou dificuldade.
+
+## Proposta de melhoria
+Descreva como a explicação, estrutura, diagrama ou exercício pode ficar melhor.
+
+## Contexto adicional
+Inclua exemplos, referências e público-alvo (iniciante/intermediário/avançado).

06-Amazon-S3-e-Armazenamento/README.md

@@ -1,5 +1,19 @@
 # Módulo 05 — Amazon S3 e Armazenamento
 
+## Objetivo
+
+Neste módulo, você vai dominar decisões de arquitetura de armazenamento na AWS, escolhendo serviços e classes de armazenamento com base em custo, latência, durabilidade, segurança e requisitos de recuperação para cenários de prova e de produção.
+
+## Serviços AWS principais
+
+- Amazon S3
+- Amazon EFS
+- Amazon FSx
+- AWS Storage Gateway
+- AWS DataSync
+
+## Arquitetura e trade-offs
+
 ## Classes de Armazenamento do S3
 
 O Amazon S3 oferece um espectro de classes que equilibram custo, durabilidade e latência de acesso:
@@ -175,7 +189,7 @@ Dispara notificações em operações de objeto (`s3:ObjectCreated:*`, `s3:Objec
 
 ---
 
-## Dicas de Prova
+## Armadilhas comuns na prova
 
 - **S3 Standard por padrão** — sempre resposta segura quando sem requisitos de custo
 - **One Zone-IA** apenas para dados **reproduzíveis** (thumbnails, transcodificados) — não usar para backup crítico
@@ -186,3 +200,17 @@ Dispara notificações em operações de objeto (`s3:ObjectCreated:*`, `s3:Objec
 - **CRR requer versioning em ambos os buckets**
 - FSx for Lustre: integra com S3 como data repository — HPC lê/escreve direto no Lustre, sincroniza com S3
 - EFS: cobrado por uso real; EBS: cobrado por capacidade provisionada
+
+## Lab hands-on
+
+Para prática guiada, utilize o laboratório de S3 avançado em [07-S3-Avancado-Labs/lab.md](../07-S3-Avancado-Labs/lab.md).
+Notas de custo: priorize arquivos pequenos para testes de lifecycle/replicação, use poucos objetos por etapa e remova buckets, versões e replication rules ao final.
+
+## Questões práticas
+
+- [questoes.md](./questoes.md)
+
+## Revisão rápida / cheatsheet
+
+- [cheatsheet.md](./cheatsheet.md)
+- [flashcards.md](./flashcards.md)

08-VPC-e-Redes/README.md

@@ -1,5 +1,19 @@
 # Módulo 07 — VPC e Redes
 
+## Objetivo
+
+Neste módulo, você vai aprender a desenhar redes VPC seguras, resilientes e escaláveis, escolhendo conectividade, segmentação, roteamento e acesso privado corretos para cenários cobrados no exame.
+
+## Serviços AWS principais
+
+- Amazon VPC
+- AWS Transit Gateway
+- AWS Direct Connect
+- AWS Site-to-Site VPN
+- AWS PrivateLink (Interface Endpoints)
+
+## Arquitetura e trade-offs
+
 ## Fundamentos da VPC
 
 Uma VPC (Virtual Private Cloud) é uma rede virtual isolada logicamente dentro da AWS. Cada conta recebe uma **Default VPC** por região.
@@ -184,7 +198,7 @@ Interface de rede virtual que pode ser:
 
 ---
 
-## Dicas de Prova
+## Armadilhas comuns na prova
 
 - **Security Group = stateful** — não precisa de regra de retorno; **NACL = stateless** — precisa de regra de entrada E saída
 - **VPC Peering não é transitivo** — cada par precisa de peering próprio; para muitas VPCs, use TGW
@@ -196,3 +210,17 @@ Interface de rede virtual que pode ser:
 - **Egress-only IGW** = NAT para IPv6 (apenas saída, sem entrada pública)
 - **VPC Flow Logs** não captura conteúdo dos pacotes — apenas metadados (IP, porta, ação)
 - Flow Logs com REJECT = SG ou NACL bloqueou; Flow Logs com ACCEPT mas problema de conectividade = problema na aplicação ou SO
+
+## Lab hands-on
+
+Para prática guiada de rede, utilize [09-VPC-e-Redes-Labs/lab.md](../09-VPC-e-Redes-Labs/lab.md).
+Notas de custo: prefira janelas curtas de teste para NAT Gateway e endpoints, valide rotas com poucos recursos e faça teardown completo ao encerrar.
+
+## Questões práticas
+
+- [questoes.md](./questoes.md)
+
+## Revisão rápida / cheatsheet
+
+- [cheatsheet.md](./cheatsheet.md)
+- [flashcards.md](./flashcards.md)

10-Banco-de-Dados/README.md

@@ -1,5 +1,19 @@
 # Módulo 06 — Banco de Dados
 
+## Objetivo
+
+Neste módulo, você vai escolher o serviço de banco de dados correto para cada cenário, equilibrando consistência, escala, latência, disponibilidade e custo em decisões típicas do SAA-C03.
+
+## Serviços AWS principais
+
+- Amazon RDS
+- Amazon Aurora
+- Amazon DynamoDB
+- Amazon ElastiCache
+- Amazon Redshift
+
+## Arquitetura e trade-offs
+
 ## Amazon RDS
 
 Serviço gerenciado para bancos de dados relacionais. Suporta MySQL, PostgreSQL, MariaDB, Oracle, SQL Server e Amazon Aurora.
@@ -210,7 +224,7 @@ MongoDB workload migrado?
 
 ---
 
-## Dicas de Prova
+## Armadilhas comuns na prova
 
 - **RDS Multi-AZ ≠ Read Replica**: Multi-AZ é HA síncrona (standby não lê); Read Replica é escala assíncrona (legível)
 - **Aurora armazena 6 cópias em 3 AZs**, quorum 4/6 para escrita
@@ -222,3 +236,17 @@ MongoDB workload migrado?
 - **Redshift Spectrum** = query em S3 sem carregar no cluster (serverless query on data lake)
 - **QLDB** = ledger imutável — perguntas sobre auditoria de histórico financeiro
 - **RDS Proxy** = conexão pool — ideal para Lambda + RDS
+
+## Lab hands-on
+
+Para prática de banco relacional e modelagem, utilize [11-RDS-e-Bancos-Relacionais-Labs/lab.md](../11-RDS-e-Bancos-Relacionais-Labs/lab.md) e [12-DynamoDB/lab.md](../12-DynamoDB/lab.md).
+Notas de custo: use classes pequenas, mantenha retenção de backup mínima para laboratório e remova instâncias, snapshots e tabelas de teste ao final.
+
+## Questões práticas
+
+- [questoes.md](./questoes.md)
+
+## Revisão rápida / cheatsheet
+
+- [cheatsheet.md](./cheatsheet.md)
+- [flashcards.md](./flashcards.md)

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+Todas as mudanças relevantes deste repositório serão documentadas aqui.
+
+## [0.1.0] - 2026-04-08
+### Adicionado
+- Estrutura inicial com módulos 01 a 31 cobrindo os principais tópicos do exame AWS SAA-C03.
+- Plano de estudos em 9 semanas para progressão de teoria, prática e revisão.
+- Conteúdos de apoio por módulo: cheatsheets, flashcards, questões, labs e links oficiais.

CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Como contribuir
+
+Obrigado por querer contribuir com este repositório.
+O objetivo aqui é manter um material claro, técnico e atualizado para preparação no exame AWS SAA-C03.
+
+## Como abrir issues
+Abra uma issue quando identificar:
+- bugs técnicos, comandos incorretos ou inconsistências no conteúdo
+- mudanças relevantes em serviços AWS que impactem explicações, labs ou questões
+- melhorias pedagógicas (didática, exemplos, diagramas, sequência de estudo)
+
+Ao abrir a issue, inclua:
+- descrição clara do problema ou sugestão
+- links para arquivos afetados
+- contexto técnico (documentação oficial AWS, release notes, comportamento observado)
+
+Use os templates em .github/ISSUE_TEMPLATE para facilitar a triagem.
+
+## Como propor novos labs ou questões
+Para sugerir conteúdo novo:
+- explique o objetivo de aprendizado
+- indique pré-requisitos
+- descreva o cenário arquitetural
+- aponte cuidados de custo e teardown
+- informe o nível de dificuldade (iniciante, intermediário, avançado)
+
+Para questões de prática, inclua:
+- enunciado
+- 4-5 alternativas
+- resposta correta
+- justificativa curta das alternativas incorretas
+
+## Fluxo básico de contribuição (fork e pull request)
+1. Faça um fork do repositório.
+2. Crie uma branch com nome descritivo.
+   Exemplo: feat/atualiza-route53 ou fix/correcao-questao-s3
+3. Faça mudanças pequenas e focadas.
+4. Revise links e consistência de Markdown.
+5. Abra um pull request com:
+   - resumo do que mudou
+   - motivo da mudança
+   - links de issues relacionadas
+   - referência oficial da AWS quando aplicável
+
+## Boas práticas
+- Mantenha o texto em PT-BR.
+- Preserve precisão técnica e contexto de prova.
+- Prefira clareza e objetividade.
+- Evite mudanças grandes sem contexto.
+
+Contribuições são muito bem-vindas. Obrigado por ajudar a melhorar este material.