@codigodoleo/wp-kit 1.0.0

package/modules/docs/templates/docs/Getting-Started.md

@@ -0,0 +1,493 @@
+# 🚀 Getting Started
+
+Guia completo para configurar o ambiente de desenvolvimento local do site Pipefy.
+
+## 📋 **Pré-requisitos**
+
+### Obrigatórios
+- **[Lando](https://lando.dev/)** (v3.0+) - Ambiente de desenvolvimento local
+- **[Docker](https://docker.com/)** (v20.0+) - Containerização
+- **[Git](https://git-scm.com/)** - Controle de versão
+- **Acesso ao GitLab** - Para download do banco de dados
+
+### Recomendados
+- **[Visual Studio Code](https://code.visualstudio.com/)** - Editor recomendado
+- **[GitLab CLI](https://gitlab.com/gitlab-org/cli)** - Para interação com GitLab
+
+### Verificação dos Pré-requisitos
+```bash
+# Verificar instalações
+lando version          # v3.0+
+docker --version       # v20.0+
+git --version          # Qualquer versão recente
+```
+
+## 🏁 **Setup Inicial**
+
+### 1. **Clone do Repositório**
+```bash
+# SSH (recomendado)
+git clone git@gitlab.com:pipefy/wordpress/pipefy-website.git
+cd pipefy-website
+
+# HTTPS (alternativo)
+git clone https://gitlab.com/pipefy/wordpress/pipefy-website.git
+cd pipefy-website
+```
+
+### 2. **📥 Download do Banco de Dados (OBRIGATÓRIO)**
+
+**⚠️ Importante**: Antes de inicializar o Lando, você precisa baixar o banco de dados de produção.
+
+#### No GitLab:
+1. **Acesse**: [CI/CD → Schedules](https://gitlab.com/pipefy/wordpress/pipefy-website/-/pipeline_schedules)
+2. **Execute**: Clique no botão ▶️ (play) no pipeline **"Download Prod Database"**
+3. **Aguarde**: O pipeline executar completamente
+4. **Acesse**: Recarregue a página (Ctrl+F5) e clique no **Pipeline ID** na coluna "Last Pipeline"
+5. **Download**: Na aba **"Jobs"**, clique no ícone de download 📥 do artifact
+6. **Extraia**: Descompacte o arquivo baixado
+7. **Mova**: Coloque o arquivo `.sql` na pasta `database/` na raiz do projeto
+
+```bash
+# Estrutura esperada após download
+pipefy-website/
+├── 📂 database/
+│   └── 📄 production-dump-YYYY-MM-DD.sql  # Arquivo baixado
+├── 📄 .lando.yml
+└── ... outros arquivos
+```
+
+### 3. **Inicialização do Lando**
+```bash
+# Inicializar ambiente
+lando start
+
+# Verificar status
+lando info
+```
+
+### 4. **💾 Restauração do Banco de Dados**
+```bash
+# Importar banco de produção ANTES da inicialização
+lando db-import database/production-dump-YYYY-MM-DD.sql
+
+# Verificar importação
+lando wp db check
+```
+
+### 5. **⚡ Configuração WordPress (Tooling Customizado)**
+```bash
+# Usar nosso tooling para inicialização
+lando init-wp --user=seu-email@pipefy.com
+
+# Aguardar conclusão da configuração
+```
+
+### 6. **Verificação do Setup**
+```bash
+# Verificar se WordPress está funcionando
+curl -I https://pipefy.lndo.site
+
+# Deve retornar HTTP/2 200
+
+# Verificar se dados de produção estão disponíveis
+lando wp post list --post_type=page --posts_per_page=5
+```
+
+## 🔄 **Sincronização com Produção**
+
+> **📌 Nota Importante**: Sempre que precisar sincronizar seu ambiente local com a produção (dados atualizados, novos conteúdos, etc.), repita os seguintes passos:
+
+### Processo de Sincronização:
+```bash
+# 1. Download do banco atualizado
+# Repita os passos da seção "Download do Banco de Dados"
+
+# 2. Restauração do banco
+lando db-import database/production-dump-NOVA-DATA.sql
+
+# 3. Re-inicialização usando nosso tooling
+lando init-wp --user=seu-email@pipefy.com
+
+# 4. Verificação
+lando wp post list --post_type=page --posts_per_page=5
+```
+
+### Quando Sincronizar:
+- **🗓️ Semanalmente**: Para ter conteúdo sempre atualizado
+- **🚀 Antes de features**: Que dependem de dados específicos de produção
+- **🔧 Troubleshooting**: Quando houver problemas com dados locais
+- **📊 Testes**: Quando precisar testar com dados reais
+
+## 🌐 **Acessos Locais**
+
+| Serviço | URL | Credenciais |
+|---------|-----|-------------|
+| **Site Frontend** | [https://pipefy.lndo.site](https://pipefy.lndo.site) | - |
+| **WordPress Admin** | [https://pipefy.lndo.site/wp-admin](https://pipefy.lndo.site/wp-admin) | Definidas no setup |
+| **Database (phpMyAdmin)** | [https://pipefy.lndo.site:8080](https://pipefy.lndo.site:8080) | Ver `.lando.yml` |
+| **MailHog** | [https://pipefy.lndo.site:8025](https://pipefy.lndo.site:8025) | - |
+
+## 🛠️ **Comandos Essenciais**
+
+### Lando Básico
+```bash
+# Iniciar ambiente
+lando start
+
+# Parar ambiente
+lando stop
+
+# Reiniciar ambiente
+lando restart
+
+# Reconstruir ambiente (quando mudar .lando.yml)
+lando rebuild
+
+# Destruir ambiente
+lando destroy
+```
+
+### ⚡ **Toolings Customizados (Configurados no .lando.yml)**
+```bash
+# Inicialização completa do WordPress
+lando init-wp --user=seu-email@pipefy.com
+
+# Acesso ao bash do container
+lando bash
+
+# Logs em tempo real
+lando logs-live
+
+# Backup rápido do banco
+lando backup-db
+
+# Limpeza de cache
+lando clear-cache
+```
+
+### WordPress via Lando
+```bash
+# WP-CLI (todas as ferramentas dentro do container)
+lando wp --help
+lando wp user list
+lando wp plugin list
+
+# Logs
+lando logs
+```
+
+### Database
+```bash
+# Backup usando nosso tooling
+lando backup-db
+
+# Restaurar banco específico
+lando db-import database/production-dump-YYYY-MM-DD.sql
+
+# Acesso direto ao MySQL
+lando mysql
+
+# Verificar integridade do banco
+lando wp db check
+
+# Reparar tabelas (se necessário)
+lando wp db repair
+```
+
+### Ferramentas de Build
+```bash
+# Node.js/NPM dentro do container
+lando node --version
+lando npm --version
+
+# Build usando nossos toolings (se configurado)
+lando build-theme
+lando watch-theme
+
+# Ou comandos tradicionais para o tema
+lando bash -c "cd /app/dist/wp-content/themes/pipefy-2020 && npm install"
+lando bash -c "cd /app/dist/wp-content/themes/pipefy-2020 && npm run dev"
+```
+
+## 📁 **Estrutura de Desenvolvimento**
+
+### Arquivos Importantes
+```
+pipefy-website/
+├── 📄 .lando.yml              # ⭐ Configuração com toolings customizados
+├── 📄 .env.example            # Variáveis de ambiente exemplo
+├── 📂 database/               # Dumps do banco de dados
+│   ├── 📄 production-dump-2025-06-05.sql
+│   ├── 📄 production-dump-2025-05-29.sql
+│   └── 📄 backup-local.sql
+├── 📂 development/
+│   ├── 📄 config/             # Configurações específicas
+│   └── 📄 scripts/            # Scripts de automação (usados pelos toolings)
+├── 📂 dist/                   # WordPress core
+│   └── 📂 wp-content/
+│       ├── 📂 themes/pipefy-2020/  # Tema principal
+│       ├── 📂 plugins/             # Plugins
+│       └── 📂 uploads/             # Media files
+└── 📂 logs/                   # Logs locais
+```
+
+### Workflow de Desenvolvimento
+```bash
+# 1. Sincronizar com produção (quando necessário)
+# Baixar nova versão via GitLab CI/CD → Schedules
+lando db-import database/production-dump-YYYY-MM-DD.sql
+
+# 2. Criar nova feature
+git checkout development
+git pull origin development
+git checkout -b feature/nova-funcionalidade
+
+# 3. Desenvolver localmente
+# Fazer alterações nos arquivos
+# Usar nossos toolings para build/watch se necessário
+lando watch-theme  # Se configurado
+
+# 4. Testar em https://pipefy.lndo.site
+
+# 5. Commit e push
+git add .
+git commit -m "feat: adicionar nova funcionalidade"
+git push origin feature/nova-funcionalidade
+
+# 6. Criar Merge Request
+# Via GitLab interface ou CLI
+```
+
+## 🔧 **Configurações Avançadas**
+
+### Variáveis de Ambiente
+```bash
+# Copiar arquivo exemplo
+cp .env.example .env
+
+# Editar conforme necessário
+nano .env
+```
+
+### Customizar .lando.yml (se necessário)
+```yaml
+# Exemplo de override local
+# .lando.local.yml
+services:
+  appserver:
+    xdebug: true
+    config:
+      php: development/config/php.ini
+
+# Adicionar novos toolings
+tooling:
+  meu-comando:
+    service: appserver
+    cmd: /app/development/scripts/meu-script.sh
+```
+
+### Xdebug (Debugging)
+```bash
+# Habilitar Xdebug
+lando xdebug-on
+
+# Desabilitar Xdebug
+lando xdebug-off
+
+# Status do Xdebug
+lando php -m | grep xdebug
+```
+
+## 🎨 **Desenvolvimento do Tema**
+
+### Estrutura do Tema Pipefy 2020
+```
+themes/pipefy-2020/
+├── 📄 style.css              # CSS principal
+├── 📄 functions.php          # Funções do tema
+├── 📄 index.php              # Template principal
+├── 📂 assets/                # CSS, JS, imagens
+├── 📂 blocks/                # Blocos Gutenberg customizados
+├── 📂 inc/                   # Includes e utilitários
+└── 📂 templates/             # Templates de página
+```
+
+### Build Process (usando nossos toolings)
+```bash
+# Usar toolings customizados (se configurados)
+lando build-theme     # Build de produção
+lando watch-theme     # Watch para desenvolvimento
+lando clear-cache     # Limpeza de cache
+
+# Ou acesso direto ao bash
+lando bash
+
+# Dentro do container
+cd /app/dist/wp-content/themes/pipefy-2020/
+npm install
+npm run dev
+npm run watch
+```
+
+## 🧪 **Testes Locais**
+
+### Verificações de Saúde
+```bash
+# Testar URLs principais
+curl -I https://pipefy.lndo.site/
+curl -I https://pipefy.lndo.site/wp-admin/
+
+# Verificar plugins ativos
+lando wp plugin list --status=active
+
+# Verificar temas
+lando wp theme list
+
+# Verificar se dados de produção foram importados
+lando wp post list --post_type=page --posts_per_page=5
+
+# Verificar URLs internas (devem apontar para local)
+lando wp option get home
+lando wp option get siteurl
+```
+
+### Performance Local
+```bash
+# Verificar queries pesadas (Query Monitor plugin)
+# Acessar: https://pipefy.lndo.site/?qm_debug=1
+
+# Logs de erro PHP usando nosso tooling
+lando logs-live
+
+# Logs WordPress específicos
+lando bash -c "tail -f /app/dist/wp-content/debug.log"
+```
+
+## 🆘 **Troubleshooting Comum**
+
+### Problemas com Banco de Dados
+```bash
+# Erro na importação
+lando db-import database/dump.sql --no-autocommit
+
+# Banco corrompido
+lando mysql -e "REPAIR TABLE wp_posts;"
+
+# URLs erradas após importação
+lando wp search-replace 'www.pipefy.com' 'pipefy.lndo.site'
+lando wp search-replace 'https://www.pipefy.com' 'https://pipefy.lndo.site'
+
+# Reset completo usando nossos toolings
+lando destroy -y
+lando start
+lando db-import database/production-dump-YYYY-MM-DD.sql
+lando init-wp --user=seu-email@pipefy.com
+```
+
+### Problemas de SSL
+```bash
+# Regenerar certificados SSL
+lando poweroff
+lando start
+
+# Verificar certificados
+lando info | grep ssl
+```
+
+### Problemas de Permissões
+```bash
+# Usar tooling para corrigir permissões (se configurado)
+lando fix-permissions
+
+# Ou comandos manuais
+lando bash -c "find /app/dist/ -type f -exec chmod 644 {} \;"
+lando bash -c "find /app/dist/ -type d -exec chmod 755 {} \;"
+lando bash -c "chmod 600 /app/dist/wp-config.php"
+```
+
+### Cache Issues
+```bash
+# Usar nosso tooling para limpeza
+lando clear-cache
+
+# Limpar cache WordPress específico
+lando wp cache flush
+
+# Limpar cache do navegador
+# Ctrl+Shift+R (hard refresh)
+
+# Rebuild completo do Lando
+lando rebuild -y
+```
+
+### Debug e Logs
+```bash
+# Usar nosso tooling para logs em tempo real
+lando logs-live
+
+# Logs específicos
+lando bash -c "tail -f /var/log/apache2/error.log"
+lando bash -c "tail -f /app/dist/wp-content/debug.log"
+
+# Verificar configuração PHP
+lando bash -c "php -i | grep -i memory"
+```
+
+## 🚀 **Toolings Disponíveis**
+
+Confira todos os toolings configurados no nosso `.lando.yml`:
+
+```bash
+# Ver todos os comandos disponíveis
+lando --help
+
+# Nossos toolings customizados incluem:
+# - lando init-wp       # Inicialização completa
+# - lando bash          # Acesso ao container
+# - lando logs-live     # Logs em tempo real
+# - lando backup-db     # Backup rápido
+# - lando clear-cache   # Limpeza de cache
+# - lando build-theme   # Build do tema (se configurado)
+# - lando watch-theme   # Watch do tema (se configurado)
+# - lando fix-permissions # Correção de permissões (se configurado)
+```
+
+## ✅ **Verificação Final**
+
+Após completar o setup, verifique:
+
+- [ ] ✅ **Banco baixado** da produção via GitLab CI/CD
+- [ ] ✅ **Banco restaurado** ANTES da inicialização
+- [ ] ✅ **WordPress inicializado** com `lando init-wp`
+- [ ] ✅ **Site carrega** em `https://pipefy.lndo.site`
+- [ ] ✅ **Admin acessível** em `https://pipefy.lndo.site/wp-admin`
+- [ ] ✅ **Tema Pipefy 2020** ativo
+- [ ] ✅ **Plugins principais** instalados
+- [ ] ✅ **Dados de produção** visíveis (posts, páginas)
+- [ ] ✅ **URLs corretas** (apontando para local)
+- [ ] ✅ **Sem erros** no console do navegador
+- [ ] ✅ **Emails capturados** no MailHog
+
+## 🎯 **Próximos Passos**
+
+Agora que seu ambiente está funcionando:
+
+1. **[Arquitetura](Arquitetura)** - Entenda a estrutura do projeto
+2. **[Desenvolvimento](Desenvolvimento)** - Guias de desenvolvimento
+3. **[Deploy Pipeline](Deploy-Pipeline)** - Como fazer deploy
+
+## 📞 **Precisa de Ajuda?**
+
+- **Issues técnicos**: [GitLab Issues](https://gitlab.com/pipefy/wordpress/pipefy-website/-/issues)
+- **Dúvidas**: Confira [FAQ](FAQ) ou [Troubleshooting](Troubleshooting)
+- **Equipe**: Consulte [CODEOWNERS](https://gitlab.com/pipefy/wordpress/pipefy-website/-/blob/master/CODEOWNERS)
+
+---
+
+📝 **Tempo estimado de setup**: 15-30 minutos (usando nossos toolings)  
+🔄 **Última atualização**: Junho 2025  
+✨ **Ambiente local**: `pipefy.lndo.site`  
+💾 **Banco de dados**: Produção via GitLab CI/CD Schedules  
+🔄 **Sincronização**: Processo repetível para manter ambiente atualizado  
+⚡ **Toolings**: Usando comandos customizados do `.lando.yml`

package/modules/docs/templates/docs/Infraestrutura.md

@@ -0,0 +1,211 @@
+# 🏗️ Infraestrutura
+
+Documentação da infraestrutura do Pipefy Website, incluindo componentes, configurações e pontos que necessitam detalhamento pela equipe SRE.
+
+## 🌍 **Visão Geral da Infraestrutura**
+
+### **Cloud Provider**
+- **Provedor**: Oracle Cloud Infrastructure (OCI)
+- **Região**: `[SRE_DETAIL: Especificar região e availability zones]`
+- **Recursos principais**: Compute instances, Load Balancer, Block Storage
+
+### **Arquitetura de Rede**
+- **VPC**: `[SRE_DETAIL: CIDR blocks e subnets configuradas]`
+- **Load Balancer**: OCI Load Balancer
+- **CDN**: CloudFlare
+- **DNS**: `[SRE_DETAIL: Configuração DNS e subdominios]`
+
+## 🎛️ **Kubernetes Cluster**
+
+### **Cluster Configuration**
+- **Tipo**: `[SRE_DETAIL: Managed ou self-hosted]`
+- **Versão**: `[SRE_DETAIL: Versão atual do K8s]`
+- **Node Groups**: `[SRE_DETAIL: Tipos de instância e scaling policies]`
+- **Networking**: `[SRE_DETAIL: CNI, Network policies, Ingress controller]`
+
+### **Namespaces**
+| Namespace | Ambiente | Finalidade |
+|-----------|----------|------------|
+| `website-dev` | Development | Testes contínuos |
+| `website-stg` | Staging | Homologação |
+| `website-prod` | Production | Site oficial |
+
+### **Recursos por Ambiente**
+| Recurso | Development | Staging | Production |
+|---------|-------------|---------|------------|
+| **Replicas** | 1 | 1 | `[SRE_DETAIL: Número de réplicas]` |
+| **CPU** | `[SRE_DETAIL: Requests/Limits]` | `[SRE_DETAIL: Requests/Limits]` | `[SRE_DETAIL: Requests/Limits]` |
+| **Memory** | `[SRE_DETAIL: Requests/Limits]` | `[SRE_DETAIL: Requests/Limits]` | `[SRE_DETAIL: Requests/Limits]` |
+| **Storage** | `[SRE_DETAIL: Tamanho PVC]` | `[SRE_DETAIL: Tamanho PVC]` | `[SRE_DETAIL: Tamanho PVC]` |
+
+## 💾 **Persistência de Dados**
+
+### **Banco de Dados**
+- **Tipo**: `[SRE_DETAIL: MySQL managed service ou self-hosted]`
+- **Versão**: `[SRE_DETAIL: Versão do MySQL]`
+- **Configuração**: `[SRE_DETAIL: Instance type, storage, backup policy]`
+- **High Availability**: `[SRE_DETAIL: Multi-AZ, read replicas]`
+- **Backup**: `[SRE_DETAIL: Frequência, retenção, restore procedures]`
+
+### **Armazenamento de Arquivos**
+- **WordPress Uploads**: `[SRE_DETAIL: Object Storage ou PVC]`
+- **Assets Estáticos**: CloudFlare CDN
+- **Logs**: `[SRE_DETAIL: Centralized logging solution]`
+- **Backup de Arquivos**: `[SRE_DETAIL: Backup strategy para uploads]`
+
+## 🔐 **Segurança**
+
+### **Network Security**
+- **Firewall**: `[SRE_DETAIL: Regras de firewall OCI]`
+- **WAF**: CloudFlare Web Application Firewall
+- **DDoS Protection**: CloudFlare
+- **VPN Access**: `[SRE_DETAIL: VPN configuration para acesso interno]`
+
+### **Authentication & Authorization**
+- **RBAC**: `[SRE_DETAIL: Kubernetes RBAC policies]`
+- **Service Accounts**: `[SRE_DETAIL: K8s service accounts configurados]`
+- **Secrets Management**: `[SRE_DETAIL: Kubernetes secrets ou external vault]`
+- **Image Security**: `[SRE_DETAIL: Registry scanning, admission controllers]`
+
+### **SSL/TLS**
+- **Certificados**: `[SRE_DETAIL: Let's Encrypt ou certificados próprios]`
+- **Renovação**: `[SRE_DETAIL: Processo automático de renovação]`
+- **Cipher Suites**: `[SRE_DETAIL: Configurações de segurança SSL]`
+
+## 📊 **Monitoramento e Observabilidade**
+
+### **Monitoring Stack**
+- **Metrics**: `[SRE_DETAIL: Prometheus, CloudWatch, ou OCI Monitoring]`
+- **Logging**: `[SRE_DETAIL: ELK, Fluentd, ou solução OCI]`
+- **APM**: `[SRE_DETAIL: Application Performance Monitoring solution]`
+- **Dashboards**: `[SRE_DETAIL: Grafana ou OCI Console]`
+
+### **Alerting**
+- **Notification Channels**: `[SRE_DETAIL: Slack, email, PagerDuty]`
+- **Alert Rules**: `[SRE_DETAIL: Métricas críticas e thresholds]`
+- **Escalation**: `[SRE_DETAIL: Escalation policies]`
+- **Runbooks**: `[SRE_DETAIL: Automated remediation procedures]`
+
+### **Health Checks**
+- **Liveness Probes**: `[SRE_DETAIL: Endpoint e configuração]`
+- **Readiness Probes**: `[SRE_DETAIL: Endpoint e configuração]`
+- **External Monitoring**: `[SRE_DETAIL: Uptime monitoring service]`
+
+## 🔄 **Backup e Disaster Recovery**
+
+### **Backup Strategy**
+- **Database Backups**: `[SRE_DETAIL: Automated backup schedule]`
+- **File System Backups**: `[SRE_DETAIL: PVC snapshot policy]`
+- **Configuration Backups**: `[SRE_DETAIL: K8s manifests backup]`
+- **Cross-Region Backup**: `[SRE_DETAIL: Geographic redundancy]`
+
+### **Disaster Recovery**
+- **RTO (Recovery Time Objective)**: `[SRE_DETAIL: Target recovery time]`
+- **RPO (Recovery Point Objective)**: `[SRE_DETAIL: Acceptable data loss]`
+- **DR Site**: `[SRE_DETAIL: Secondary region or provider]`
+- **Failover Process**: `[SRE_DETAIL: Automated or manual procedures]`
+
+## 🚀 **Performance e Scaling**
+
+### **Auto Scaling**
+- **HPA (Horizontal Pod Autoscaler)**: `[SRE_DETAIL: Métricas e thresholds]`
+- **VPA (Vertical Pod Autoscaler)**: `[SRE_DETAIL: Se habilitado]`
+- **Cluster Autoscaler**: `[SRE_DETAIL: Node scaling policies]`
+- **Load Testing**: `[SRE_DETAIL: Performance benchmarks]`
+
+### **CDN Configuration**
+- **Cache Rules**: `[SRE_DETAIL: CloudFlare cache policies]`
+- **Purge Strategy**: `[SRE_DETAIL: Cache invalidation process]`
+- **Geographic Distribution**: `[SRE_DETAIL: Edge locations]`
+- **Performance Metrics**: `[SRE_DETAIL: CDN analytics e reporting]`
+
+## 🔧 **DevOps Tools**
+
+### **CI/CD**
+- **GitLab CI/CD**: Pipeline configuration
+- **Container Registry**: `[SRE_DETAIL: GitLab Registry ou external]`
+- **Image Scanning**: `[SRE_DETAIL: Security scanning tools]`
+- **Deployment Strategy**: `[SRE_DETAIL: Blue/Green, Rolling, Canary]`
+
+### **Infrastructure as Code**
+- **Terraform**: `[SRE_DETAIL: Estado atual da IaC]`
+- **Kubernetes Manifests**: `[SRE_DETAIL: Estrutura dos manifests]`
+- **Helm Charts**: `[SRE_DETAIL: Planejamento para migração]`
+- **GitOps**: `[SRE_DETAIL: ArgoCD ou similar]`
+
+## 🌐 **Rede e Conectividade**
+
+### **External Connectivity**
+- **Public IPs**: `[SRE_DETAIL: IP addresses e DNS records]`
+- **Domain Management**: `[SRE_DETAIL: DNS provider e configuração]`
+- **API Gateways**: `[SRE_DETAIL: Rate limiting, authentication]`
+- **Third-party Integrations**: `[SRE_DETAIL: External services connectivity]`
+
+### **Internal Networking**
+- **Service Mesh**: `[SRE_DETAIL: Istio, Linkerd, ou similar]`
+- **Network Policies**: `[SRE_DETAIL: Pod-to-pod communication rules]`
+- **Internal DNS**: `[SRE_DETAIL: CoreDNS configuration]`
+- **Service Discovery**: `[SRE_DETAIL: Internal service communication]`
+
+## 💰 **Custos e Otimização**
+
+### **Cost Management**
+- **Resource Allocation**: `[SRE_DETAIL: Current resource usage]`
+- **Cost Monitoring**: `[SRE_DETAIL: Billing alerts e budgets]`
+- **Optimization Opportunities**: `[SRE_DETAIL: Right-sizing recommendations]`
+- **Reserved Instances**: `[SRE_DETAIL: Long-term commitment strategy]`
+
+## 🔄 **Migração para Helm (Planejado)**
+
+### **Current State**
+- **Deployment Method**: Kubernetes manifests diretos
+- **Configuration Management**: Kustomize ou similar
+- **Challenges**: `[SRE_DETAIL: Pontos de dor atuais]`
+
+### **Target State**
+- **Helm Version**: 3.x
+- **Chart Structure**: `[SRE_DETAIL: Estrutura planejada]`
+- **Migration Plan**: `[SRE_DETAIL: Cronograma e etapas]`
+- **Benefits Expected**: `[SRE_DETAIL: Melhorias esperadas]`
+
+## 📋 **Action Items para SRE**
+
+### **🔴 Crítico (Documentação Necessária)**
+- [ ] Especificar configurações de rede (VPC, subnets, security groups)
+- [ ] Detalhar configuração do banco de dados (versão, backup, HA)
+- [ ] Documentar estratégia de monitoramento e alertas
+- [ ] Definir políticas de backup e disaster recovery
+
+### **🟡 Importante (Melhoria)**
+- [ ] Implementar Infrastructure as Code com Terraform
+- [ ] Configurar monitoring stack completo
+- [ ] Estabelecer políticas de auto-scaling
+- [ ] Planejar migração para Helm
+
+### **🟢 Desejável (Futuro)**
+- [ ] Implementar service mesh
+- [ ] Configurar GitOps com ArgoCD
+- [ ] Otimizar custos de infraestrutura
+- [ ] Implementar chaos engineering
+
+## 📞 **Contatos e Responsabilidades**
+
+### **Equipes Responsáveis**
+- **SRE Team**: Infraestrutura, monitoramento, DR
+- **DevOps Team**: CI/CD, deployments, automação
+- **Security Team**: Políticas de segurança, compliance
+- **Development Team**: Application requirements, troubleshooting
+
+### **Escalation**
+- **Incidentes P1**: `[SRE_DETAIL: Procedimento de escalação]`
+- **Mudanças de Infraestrutura**: `[SRE_DETAIL: Change management process]`
+- **Emergency Access**: `[SRE_DETAIL: Break-glass procedures]`
+
+---
+
+📝 **Última atualização**: Junho 2025  
+☁️ **Cloud Provider**: Oracle Cloud Infrastructure (OCI)  
+🎛️ **Orquestração**: Kubernetes  
+🔄 **Estado**: Migração para Helm planejada  
+📊 **Documentação SRE**: Detalhamentos técnicos necessários  
+🎯 **Próximos passos**: Preenchimento dos `[SRE_DETAIL]` pela equipe especializada