@silasfmartins/testhub 1.0.0

package/scripts/init-scenarios.ts

@@ -0,0 +1,925 @@
+#!/usr/bin/env node
+// @ts-nocheck
+
+import fs from 'node:fs'
+import { execSync } from 'child_process'
+import yaml from 'js-yaml'
+import path from 'path'
+import {
+  generateBiomeConfigString,
+  generatePackageJson,
+  generateTsConfigForProject,
+  getLatestVersions,
+} from './package-versions.js'
+import { setupUltracite } from './ultracite-setup.js'
+
+const root = process.cwd()
+const catalogPath = path.join(root, 'catalog-info.yaml')
+
+if (!fs.existsSync(catalogPath)) {
+  console.error('❌ Arquivo catalog-info.yaml não encontrado.')
+  process.exit(1)
+}
+
+const catalog = yaml.load(fs.readFileSync(catalogPath, 'utf-8')) as any
+const projectName = catalog?.metadata?.name || 'meu-projeto'
+const projectNameUnderscore = projectName.replace(/-/g, '_')
+
+const write = (filePath: string, content: string) => {
+  const fullPath = path.join(root, filePath)
+  fs.mkdirSync(path.dirname(fullPath), { recursive: true })
+  fs.writeFileSync(fullPath, content)
+}
+
+async function main() {
+  console.log('🚀 Inicializando projeto de Cenários com versões atualizadas...')
+  console.log(`📦 Projeto: ${projectName}`)
+  console.log('')
+
+  // ✅ Buscar versões mais recentes
+  const versions = await getLatestVersions()
+
+  // ✅ Gerar package.json com versões atualizadas
+  const packageJsonContent = generatePackageJson(
+    projectName,
+    'scenarios',
+    versions,
+  )
+
+  // ✅ Gerar tsconfig.json baseado no AutoCore
+  const tsconfigContent = generateTsConfigForProject('scenarios')
+
+  // ✅ Gerar biome.json sincronizado com AutoCore
+  const biomeConfigContent = generateBiomeConfigString()
+
+  console.log('📝 Criando arquivos do projeto...')
+
+  // package.json com versões dinâmicas
+  write('package.json', JSON.stringify(packageJsonContent, null, 2))
+
+  // ✅ tsconfig.json sempre sincronizado com o AutoCore
+  write('tsconfig.json', JSON.stringify(tsconfigContent, null, 2))
+
+  // ✅ biome.json sincronizado automaticamente com o AutoCore
+  write('biome.json', biomeConfigContent)
+
+    //env.ts
+  write('env.ts', `import { config } from 'dotenv'
+
+config()
+
+const rawEnv = {
+  ENV: process.env.ENV,
+}
+export const env = rawEnv
+`)
+
+  // playwright.config.ts otimizado para cenários
+  write(
+    'playwright.config.ts',
+    `
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  globalSetup: '@silasfmartins/testhub/setup',
+  reporter: [['list'], ['html', { open: 'never' }], ['@silasfmartins/testhub/reporter']],
+  testDir: './tests',
+  testMatch: ['**/**/*.spec.ts', '**/**/*.test.ts'],
+  timeout: 1_800_000,
+  expect: {
+    timeout: 1_800_000,
+  },
+  fullyParallel: false,
+  workers: 1,
+  retries: 0,
+  use: {
+    baseURL: '',
+  },
+  projects: [
+    // ✅ Projetos "headless" (sem browser) — para SSH, API, Banco, Mobile
+    {
+      name: 'ssh',
+      use: { 
+        browserName: undefined,
+        screenshot: 'off',
+        trace: 'off',
+        video: 'off',
+       },
+    },
+    {
+      name: 'api',
+      use: { 
+        browserName: undefined, 
+        screenshot: 'off',
+        trace: 'off',
+        video: 'off'
+      },
+    },
+    {
+      name: 'banco',
+      use: { 
+        browserName: undefined, 
+        screenshot: 'off',
+        trace: 'off',
+        video: 'off'
+      },
+    },
+    {
+      name: 'mobile',
+      use: { browserName: undefined, 
+        screenshot: 'off',
+        trace: 'off',
+        video: 'off'
+      },
+    },
+
+    // ✅ Projetos de browser — só serão usados se você solicitar via --project
+    {
+      name: 'chromium',
+      use: {
+        browserName: 'chromium',
+        viewport: { width: 1366, height: 768 },
+        headless: process.env.PLAYWRIGHT_HEADLESS === 'true',
+        screenshot: 'on',
+        trace: 'on',
+        video: 'on'
+      },
+    },
+    {
+      name: 'firefox',
+      use: {
+        browserName: 'firefox',
+        viewport: { width: 1366, height: 768 },
+        headless: process.env.PLAYWRIGHT_HEADLESS === 'true',
+        screenshot: 'on',
+        trace: 'on',
+        video: 'on'
+      },
+    },
+    {
+      name: 'webkit',
+      use: {
+        browserName: 'webkit',
+        viewport: { width: 1366, height: 768 },
+        headless: process.env.PLAYWRIGHT_HEADLESS === 'true',
+        screenshot: 'on',
+        trace: 'on',
+        video: 'on'
+      },
+    }
+  ],
+});
+`,
+  )
+
+  // .npmrc
+  write(
+    '.npmrc',
+    `registry=https://pkgs.dev.azure.com/telefonica-vivo-brasil/_packaging/DevOps/npm/registry/`,
+  )
+
+  // .gitignore otimizado para cenários
+  write(
+    '.gitignore',
+    `# Playwright
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+playwright-videos
+/playwright-videos/
+/playwright-videos
+
+# Tests e logs
+/logs
+
+.vscode
+.vscode/
+docs
+docs/
+
+# Environment files
+.env
+.env.preprod
+.env.esteira1
+.env.esteira2
+.env.prodlike
+.env.prod
+# AutoCore específicos
+.test-data-store.json
+.env.lock
+.configlogger.lock
+.rbqa
+.rbqa/
+
+# VS Code
+.vscode/settings.json
+.github/
+.github
+
+# Biome
+.biome.log
+
+# Coverage
+coverage/
+*.lcov
+
+# Cenários específicos
+/evidencias/
+/screenshots/
+/videos/
+/downloads/
+
+# Octane/ALM específicos
+octane-report.json
+alm-results.xml`,
+  )
+
+  // Arquivos de environment mais completos
+  write(
+    '.env.preprod',
+    `# Configurações de ambiente para preprod
+BASE_URL=
+
+# Configurações específicas para cenários
+SCENARIO_TIMEOUT=180000
+WAIT_BETWEEN_SCENARIOS=1000
+
+# Octane/ALM Integration (opcional)
+OCTANE_URL=
+OCTANE_SHARED_SPACE=
+OCTANE_WORKSPACE=
+OCTANE_CLIENT_ID=
+OCTANE_CLIENT_SECRET=
+
+# Base URLs específicas (ajuste conforme necessário)
+BASE_URL_API=
+BASE_URL_TOKEN=
+
+# Database (se necessário para cenários)
+DB_HOST=
+DB_PORT=1521
+DB_SERVICE_NAME=
+DB_USER=
+DB_PASSWORD=
+
+# Adicione suas variáveis específicas aqui`,
+  )
+
+  // Arquivo de environment padrão
+  write(
+    '.env',
+    `# Arquivo que seleciona o ambiente a ser utilizado
+ENV=preprod`,
+  )
+
+  write(
+    '.env.esteira1',
+    `# Configurações de ambiente para esteira1
+BASE_URL=
+
+# Configurações específicas para cenários
+SCENARIO_TIMEOUT=180000
+WAIT_BETWEEN_SCENARIOS=1000
+
+# Base URLs específicas
+BASE_URL_API=
+BASE_URL_TOKEN=
+
+# Octane/ALM Integration (opcional)
+OCTANE_URL=
+OCTANE_SHARED_SPACE=
+OCTANE_WORKSPACE=
+OCTANE_CLIENT_ID=
+OCTANE_CLIENT_SECRET=
+
+# Database (se necessário)
+DB_HOST=
+DB_PORT=1521
+DB_SERVICE_NAME=
+DB_USER=
+DB_PASSWORD=`,
+  )
+
+  write(
+    '.env.esteira2',
+    `# Configurações de ambiente para esteira2
+BASE_URL=
+
+# Configurações específicas para cenários
+SCENARIO_TIMEOUT=180000
+WAIT_BETWEEN_SCENARIOS=1000
+
+# Base URLs específicas
+BASE_URL_API=
+BASE_URL_TOKEN=
+
+# Octane/ALM Integration (opcional)
+OCTANE_URL=
+OCTANE_SHARED_SPACE=
+OCTANE_WORKSPACE=
+OCTANE_CLIENT_ID=
+OCTANE_CLIENT_SECRET=
+
+# Database (se necessário)
+DB_HOST=
+DB_PORT=1521
+DB_SERVICE_NAME=
+DB_USER=
+DB_PASSWORD=`,
+  )
+
+  write(
+    '.env.prodlike',
+    `# Configurações de ambiente para prodlike
+BASE_URL=
+
+# Configurações específicas para cenários
+SCENARIO_TIMEOUT=180000
+WAIT_BETWEEN_SCENARIOS=1000
+
+# Base URLs específicas
+BASE_URL_API=
+BASE_URL_TOKEN=
+
+# Octane/ALM Integration (opcional)
+OCTANE_URL=
+OCTANE_SHARED_SPACE=
+OCTANE_WORKSPACE=
+OCTANE_CLIENT_ID=
+OCTANE_CLIENT_SECRET=
+
+# Database (se necessário)
+DB_HOST=
+DB_PORT=1521
+DB_SERVICE_NAME=
+DB_USER=
+DB_PASSWORD=`,
+  )
+
+  // Exemplo de teste para cenários mais estruturado
+  write(
+    'tests/CN001_ConsultaEndereco.spec.ts',
+    `import { type TestInfo, test, TestAnnotations } from '@silasfmartins/testhub'
+import {
+  StatementsAlocarConfigurar,
+  StatementsConsultaCobertura,
+  StatementsConsultaEndereco,
+  StatementsConsultaEnderecoTecnico,
+  StatementsConsultaQualificacao,
+  StatementsConsultaViabilidade,
+  StatementsReservaQualificacao,
+  StatementsToken,
+} from '@rbqa/test-oss-api'
+
+test.describe('CN001_ConsultaEndereco [octane-@7075_-_ATENDIMENTO_-_FENIX_-_Cancelamento_para_fluxo_com_Portabilidade_linha_vivo_-_Vivo1_-_Parceiro]', () => {
+  TestAnnotations.stopOnFailure() // opcional: para o runner ao falhar um CT
+
+  test('CT001_Requisição do Token', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsToken().getToken()
+  })
+
+  test('CT002_Consultar Endereço', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsConsultaEndereco().consultaEndereco()
+  })
+
+  test('CT003_Consultar Cobertura', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsConsultaCobertura().consultaCobertura()
+  })
+
+  test('CT004_Consultar Endereço Técnico', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsConsultaEnderecoTecnico().consultaEnderecoTecnico()
+  })
+
+  test('CT005_Consultar Viabilidade', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsConsultaViabilidade().consultaViabilidade()
+  })
+
+  test('CT006_Consultar Qualificação', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsConsultaQualificacao().consultaQualificacao()
+  })
+
+  test('CT007_Reserva Qualificação', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsReservaQualificacao().reservaQualificacao()
+  })
+
+  test('CT008_Alocar e Configurar', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Api.testInfo = testInfo
+    await TestAnnotations.setSystem('MEU_SISTEMA')
+    await new StatementsAlocarConfigurar().alocarConfigurar()
+  })
+})
+`,
+  )
+
+  // Azure DevOps pipeline
+  write(
+    '.azuredevops/azure-pipeline.yml',
+    `name: Testes OSS
+
+trigger:
+  batch: true
+  branches:
+    include:
+    - '*'
+  paths:
+    exclude:
+    - '*'
+
+parameters:
+- name: env
+  displayName: Escolha o ambiente pra rodar E2E
+  type: string
+  default: preprod
+  values:
+  - preprod
+  - esteira1
+  - esteira2
+  - prodlike
+  
+- name: browser
+  displayName: Escolha o navegador para os testes
+  type: string
+  default: chromium
+  values:
+  - chromium
+  - firefox
+  - webkit
+
+- name: testWithScreenShots
+  displayName: Ativar capturas de tela
+  type: boolean
+  default: true
+
+- name: test
+  displayName: Testes específicos para executar
+  type: string
+  default: "CN001_ConsultaEndereco.spec.ts"
+  values:
+    - "CN001_ConsultaEndereco.spec.ts"
+    - "CN002_FluxoCompleto.spec.ts"
+    - "all"
+
+resources:
+  repositories:
+    - repository: CorePipelines
+      name: DevOps/Vivo.Core.Pipelines
+      type: git
+      ref: feat/qa_execuca_cenarios_b2b
+      endpoint: CorePipelines
+
+extends:
+  template: /provisioners/qa/trunkbased/node/scenarios_default/provisioner_entry.yml@CorePipelines
+  parameters:
+    node:
+      name_test: "\${{ parameters.test }}"
+      browser: "\${{ parameters.browser }}"
+      testWithScreenShots: \${{ parameters.testWithScreenShots }}
+      environment: "\${{ parameters.env }}"
+      description: "Cenários E2E Automatizados"
+      scenariosName: "autocore"
+      scenariosType: "e2e"
+`,
+  )
+
+  // README.md
+  write(
+    'README.md',
+    `# ${projectName}
+
+Projeto de automação de cenários E2E baseado no AutoCore com suporte completo a múltiplos tipos de teste.
+
+## 🚀 Como usar
+
+### Instalação de dependências
+\`\`\`bash
+npm install
+\`\`\`
+
+### Instalar navegadores
+\`\`\`bash
+npx playwright install
+\`\`\`
+
+### Executar testes
+\`\`\`bash
+# Ambiente preprod
+npm run test:preprod
+
+# Ambiente esteira1
+npm run test:esteira1
+
+# Ambiente esteira2
+npm run test:esteira2
+
+# Ambiente prodlike
+npm run test:prodlike
+
+# Apenas Chromium
+npm run test:preprod:chromium
+
+# Interface visual
+npm run ui:preprod
+
+# Modo debug
+npm run debug:preprod
+\`\`\`
+
+# Sincronizar Projetos de Sistemas com o de cenários
+npm run sync
+
+## 📋 Configuração de ambiente
+
+### Variáveis essenciais nos arquivos \`.env.*\`:
+
+\`\`\`bash
+# URLs principais
+BASE_URL=https://your-app.com
+BASE_URL_API=https://api.your-app.com
+BASE_URL_TOKEN=https://auth.your-app.com
+
+# Timeouts (em milissegundos)
+NAVIGATION_TIMEOUT=30000
+ACTION_TIMEOUT=15000
+SCENARIO_TIMEOUT=180000
+
+# Screenshots e evidências
+WAIT_BETWEEN_SCENARIOS=1000
+SLOW_MO=0
+
+# Database (se necessário)
+DB_HOST=oracle-host
+DB_PORT=1521
+DB_SERVICE_NAME=service_name
+DB_USER=username
+DB_PASSWORD=password
+NODE_ORACLEDB_DRIVER_MODE=thick
+
+# Octane/ALM Integration (opcional)
+OCTANE_URL=https://your-octane.com
+OCTANE_SHARED_SPACE=12345
+OCTANE_WORKSPACE=67890
+OCTANE_CLIENT_ID=client_id
+OCTANE_CLIENT_SECRET=client_secret
+\`\`\`
+
+## 📂 Estrutura do projeto
+
+\`\`\`
+${projectName}/
+├── tests/                      # Cenários de teste
+│   ├── CN001_ConsultaEndereco.spec.ts
+│   └── CN002_FluxoCompleto.spec.ts
+├── .env.*                     # Variáveis por ambiente
+├── playwright.config.ts       # Configuração otimizada para cenários
+├── tsconfig.json             # TypeScript sincronizado com AutoCore
+├── biome.json              # Linting sincronizado com AutoCore
+├── .azuredevops/            # Pipeline CI/CD
+│   ├── azure-pipeline.yml
+│   └── sonar-project.properties
+└── README.md               # Esta documentação
+\`\`\`
+
+## 🔧 Desenvolvimento
+
+### Tecnologias e ferramentas:
+- **TypeScript**: Configurado e sincronizado com AutoCore
+- **Playwright**: Framework E2E com suporte multi-browser
+- **AutoCore**: Sistema unificado (API + Frontend + Mobile + SSH + Banco)
+- **Biome**: Linting e formatação sincronizados
+- **Ultracite**: Experiência de desenvolvimento aprimorada
+
+### Padrões implementados:
+- **Mixed Test Context**: Cenários podem usar API, Frontend, Mobile, SSH e Banco
+- **Data Store**: Compartilhamento de dados entre fases do cenário
+- **Screenshot automático**: Em falhas e quando habilitado
+- **Timeouts configuráveis**: Por tipo de ação e cenário
+- **Retry logic**: Configurável por ambiente
+- **Evidências organizadas**: Screenshots, vídeos, downloads
+
+## 🧪 Exemplos de Uso
+
+### Cenário básico com API e Interface:
+\`\`\`typescript
+test('CT001 - Cenário misto', async ({ page }, testInfo) => {
+  TestAnnotations.Mixed.testInfo = testInfo;
+  
+  // 1. Obter token via API
+  const tokenResponse = await ApiActions.post(tokenRequest, 'Obtenção de token');
+  DataStore.set('TOKEN', tokenResponse.body.access_token);
+  
+  // 2. Usar interface
+  await WebActions.navegarPara('/app', 'Navegação');
+  await WebActions.preencherCampo(searchInput, 'busca', 'Preenchimento');
+  
+  // 3. Validar via banco (se disponível)
+  const dbResults = await BancoHelper.executarQuery(query);
+  expect(dbResults.length).toBeGreaterThan(0);
+});
+\`\`\`
+
+### Cenário com múltiplas fases:
+\`\`\`typescript
+test('Fluxo E2E completo', async () => {
+  // Fase 1: Autenticação
+  await authenticateViaAPI();
+  
+  // Fase 2: Navegação e interação
+  await performUIInteractions();
+  
+  // Fase 3: Validação de dados
+  await validateDataConsistency();
+  
+  // Fase 4: Cleanup e relatório
+  await generateEvidences();
+});
+\`\`\`
+
+### Cenário com SSH e Banco:
+\`\`\`typescript
+test('Validação de infraestrutura', async () => {
+  // Verificar serviços via SSH
+  await SSHActions.write('systemctl status myapp');
+  
+  // Validar dados no banco
+  await BancoActions.executarQuery('SELECT 1 FROM dual');
+  
+  // Validar interface está acessível
+  await WebActions.navegarPara('/health', 'Health check');
+});
+\`\`\`
+
+## 🎯 Comandos Avançados
+
+\`\`\`bash
+# Execução específica por browser
+npm run test:preprod -- --project=chromium
+npm run test:preprod -- --project=firefox
+npm run test:preprod -- --project=webkit
+
+# Execução com parâmetros específicos
+SLOW_MO=1000 npm run debug:preprod
+
+# Execução de cenários específicos
+npm run test:preprod -- --grep "CT001"
+npm run test:preprod -- --grep "ConsultaEndereco"
+
+# Execução com retry personalizado
+npm run test:preprod -- --retries=3
+
+# Execução em modo headed (visual)
+npm run test:preprod -- --headed
+
+# Geração de relatórios
+npm run octane:generate
+npm run octane:send
+
+# Debug e desenvolvimento
+npm run debug:preprod    # Debug interativo
+npm run ui:preprod      # Interface visual dos testes
+\`\`\`
+
+## 📊 Relatórios e Evidências
+
+### Playwright nativo:
+- \`playwright-report/\` - Relatório HTML interativo
+- \`test-results/\` - Resultados detalhados e artifacts
+- Screenshots automáticos em falhas
+
+### Evidências customizadas:
+- \`evidencias/\` - Screenshots manuais
+- \`screenshots/\` - Screenshots automáticos
+- \`videos/\` - Gravações de execução
+- \`downloads/\` - Arquivos baixados durante testes
+
+### Integração Octane/ALM:
+- \`octane-report.json\` - Relatório no formato Octane
+- Mapeamento de IDs de teste (CT001, CT002, etc.)
+
+## 🔄 Sincronização com AutoCore
+
+Este projeto mantém sincronização automática com o AutoCore para:
+
+- **tsconfig.json**: Configuração TypeScript
+- **biome.json**: Linting e formatação
+- **Versões de dependências**: Sempre atualizadas
+- **Configurações de teste**: Playwright otimizado para cenários
+
+Para sincronizar manualmente:
+\`\`\`bash
+npx autocore-sync-configs
+\`\`\`
+
+## 📈 Monitoramento e Métricas
+
+### Métricas coletadas automaticamente:
+- **Duração total por cenário**
+- **Tempo por fase** (autenticação, navegação, validação)
+- **Taxa de sucesso** por ambiente
+- **Performance de carregamento** de páginas
+- **Uso de recursos** (CPU, memória)
+
+### Logs estruturados:
+- **Logs por fase** do cenário
+- **Correlação entre API e UI**
+- **Evidências automáticas** em falhas
+- **Rastreabilidade completa** das ações
+
+## 🆘 Resolução de Problemas
+
+### Timeouts de cenário:
+\`\`\`bash
+# Aumentar timeout específico
+SCENARIO_TIMEOUT=300000 npm run test:preprod  # 5 minutos
+
+# Aumentar timeout de navegação
+NAVIGATION_TIMEOUT=60000 npm run test:preprod  # 1 minuto
+\`\`\`
+
+### Problemas de sincronização:
+\`\`\`bash
+# Adicionar espera entre cenários
+WAIT_BETWEEN_SCENARIOS=3000 npm run test:preprod  # 3 segundos
+
+# Modo lento para debug
+SLOW_MO=2000 npm run debug:preprod  # 2 segundos por ação
+\`\`\`
+
+### Problemas de browser:
+\`\`\`bash
+# Reinstalar browsers
+npx playwright install --force
+
+# Executar apenas Chromium
+npm run test:preprod:chromium
+
+# Modo headed para visualizar
+npm run test:preprod -- --headed
+\`\`\`
+
+### Problemas de banco/API:
+\`\`\`bash
+# Verificar conectividade
+telnet $DB_HOST $DB_PORT
+curl -I $BASE_URL_API/health
+
+# Logs detalhados
+DEBUG=autocore:* npm run test:preprod
+\`\`\`
+
+### Performance lenta:
+\`\`\`bash
+# Reduzir workers
+npm run test:preprod -- --workers=1
+
+# Executar apenas cenários críticos
+npm run test:preprod -- --grep "CT001|CT002"
+\`\`\`
+
+## 📝 Boas Práticas
+
+### Estrutura de cenários:
+1. **Nomenclatura consistente**: CN001, CN002 para cenários; CT001, CT002 para casos de teste
+2. **Fases bem definidas**: Autenticação → Navegação → Validação → Cleanup
+3. **Data Store**: Compartilhar dados entre fases usando DataStore
+4. **Evidências**: Screenshots automáticos em falhas, manuais em pontos críticos
+5. **Timeouts**: Configurar adequadamente para cada tipo de ação
+
+### Desenvolvimento:
+1. **Mixed Context**: Use TestAnnotations.Mixed para cenários completos
+2. **Error Handling**: Capturar screenshots e logs em falhas
+3. **Retry Logic**: Configurar retry apenas onde faz sentido
+4. **Cleanup**: Sempre limpar dados/estado entre cenários
+5. **Documentação**: Documentar dependências e pré-condições
+
+### CI/CD:
+1. **Ambientes isolados**: Configurações específicas por ambiente
+2. **Parallelização**: Cuidado com cenários que têm dependências
+3. **Evidências**: Sempre coletar artifacts em builds
+4. **Notificações**: Integrar com Octane/ALM para rastreabilidade
+5. **Monitoramento**: Acompanhar métricas de execução
+
+## 📚 Referências
+
+- [AutoCore Website](http://brtlvlty0559pl:3002/)
+- [Playwright Documentation](https://playwright.dev/)
+- [Playwright Best Practices](https://playwright.dev/docs/best-practices)
+- [Azure DevOps Pipelines](https://docs.microsoft.com/azure/devops/pipelines/)
+
+---
+
+**Gerado automaticamente pelo AutoCore v${versions?.dependencies?.['@silasfmartins/testhub'] || 'latest'}**
+
+## 🎯 Próximos passos após geração:
+
+1. **Configure ambientes**: Edite os arquivos \`.env.*\` com suas URLs e credenciais
+2. **Teste conectividade**: Execute \`npm run test:preprod\` para validar configuração
+3. **Personalize cenários**: Adapte os exemplos CN001 e CN002 para seus casos de uso
+4. **Configure Octane**: Se usar ALM/Octane, configure as variáveis de integração
+5. **Ajuste pipeline**: Personalize \`.azuredevops/azure-pipeline.yml\` conforme necessário
+
+🚀 **Seu projeto de cenários está pronto para desenvolvimento avançado!**
+`,
+  )
+
+  // 📦 Instalação de dependências NPM
+  console.log('📦 Instalando dependências NPM...')
+  try {
+    execSync('npm install', {
+      stdio: 'inherit',
+      cwd: root,
+    })
+    console.log('✅ Dependências NPM instaladas com sucesso')
+  } catch (error) {
+    console.warn('⚠️ Erro ao instalar dependências automaticamente')
+    console.log('💡 Execute manualmente: npm install')
+  }
+
+  // 🎭 CRÍTICO: Sempre instalar browsers Playwright
+  console.log('🎭 Instalando browsers Playwright...')
+  try {
+    execSync('npx playwright install', {
+      stdio: 'inherit',
+      cwd: root,
+    })
+    console.log('✅ Browsers Playwright instalados com sucesso')
+  } catch (error) {
+    console.warn('⚠️ Erro ao instalar browsers automaticamente')
+    console.log('💡 Execute manualmente: npx playwright install')
+  }
+
+  // ✅ Configurar Ultracite automaticamente
+  console.log('🤖 Configurando ambiente de desenvolvimento...')
+  await setupUltracite(root)
+
+  // ✅ Garantir sincronização final do biome.json
+  console.log('🔧 Sincronizando configuração do Biome...')
+  const finalBiomeConfig = generateBiomeConfigString()
+  write('biome.json', finalBiomeConfig)
+
+  // ✅ Instalação finalizada com sucesso
+
+  console.log('')
+  console.log('🎉 Projeto de Cenários E2E gerado com sucesso!')
+  console.log('')
+  console.log('📋 Próximos passos:')
+  console.log('   1. Configure suas variáveis de ambiente nos arquivos .env.*')
+  console.log('   2. Adicione URLs da aplicação, API e autenticação')
+  console.log('   3. Configure banco de dados se necessário')
+  console.log('   4. Execute: npm run test:preprod')
+  console.log('   5. O Ultracite está configurado para VS Code')
+  console.log('')
+  console.log('🛠️ Comandos úteis:')
+  console.log('   npm run test:preprod          - Executar cenários em preprod')
+  console.log(
+    '   npm run test:preprod:screenshots - Com screenshots habilitados',
+  )
+  console.log('   npm run ui:preprod            - Interface visual dos testes')
+  console.log('   npm run debug:preprod         - Modo debug interativo')
+  console.log('   npm run octane:generate       - Gerar relatório Octane')
+  console.log('   npx biome check              - Verificar código com Biome')
+  console.log('   npx biome format             - Formatar código com Biome')
+  console.log('')
+  console.log('✅ Configurações sincronizadas com AutoCore:')
+  console.log('   📝 tsconfig.json - Compilação TypeScript')
+  console.log('   🎨 biome.json - Linting e formatação (SINCRONIZADO)')
+  console.log('   🤖 Ultracite - Experiência de desenvolvimento')
+  console.log('   📦 Dependências - Versões mais recentes')
+  console.log('   🎭 Playwright - Configuração otimizada para cenários')
+  console.log(
+    '   🔄 Mixed Context - Suporte a API + Frontend + Mobile + SSH + Banco',
+  )
+  console.log('   🐙 Octane/ALM - Scripts de integração incluídos')
+  console.log('')
+  console.log(
+    '🚀 Projeto pronto para desenvolvimento de cenários E2E avançados!',
+  )
+  console.log('')
+  console.log('💡 Dicas importantes:')
+  console.log('   • Use TestAnnotations.Mixed para cenários completos')
+  console.log('   • Configure timeouts adequados para cenários longos')
+  console.log('   • Aproveite o DataStore para compartilhar dados entre fases')
+  console.log('   • Screenshots automáticos em falhas estão habilitados')
+  console.log('   • Relatórios HTML detalhados são gerados automaticamente')
+}
+
+// Executar função principal
+main().catch((error) => {
+  console.error('❌ Erro durante inicialização:', error)
+  process.exit(1)
+})