Adding Tests

Example: Add a New Special Page

1. Register in src/fixtures/page-catalog.ts:

{ path: '/nova-pagina/', priority: 'P2' },

2. Add a POM method in src/pages/special.page.ts:

async assertNovaPaginaContent() {
  await expect(this.page.locator('h1')).toContainText('Nova Página');
}

3. Extend a test in tests/critical-path/special.spec.ts:

if (pageEntry.path === '/nova-pagina/') {
  await specialPage.assertNovaPaginaContent();
}

Example: Add a New Topic Page

Usually just adding the entry to TOPICS in the catalog is enough — topics.spec.ts loops over all P1 topics automatically.

Example: Add a City to Samples

Edit CITY_SAMPLES in src/fixtures/page-catalog.ts:

'sao-paulo': ['campinas', 'santos', 'sao-bernardo-do-campo', 'nova-cidade'],

Make sure the city folder exists in site/public/{scope}/{state}/ before adding.

Expansion Path

• Phase 1 (now): Critical path + sampled regional
• Phase 2: All topic pages + dedicated SEO suite
• Phase 3: Full city enumeration + visual regression
• Phase 4 ✅: Multi-domain matrix via Playwright projects

Phase 4 adds a matrix of Playwright projects that target each worker subdomain independently. See qa/KIMI.md for usage.