@nextsparkjs/theme-default 0.1.0-beta.31 → 0.1.0-beta.35

package/tests/cypress/e2e/{_selectors → _utils/selectors}/settings-profile.cy.ts

@@ -14,33 +14,31 @@
  * - Assert elements exist in DOM (no form submissions)
  * - Fast execution (< 30 seconds per describe block)
  *
- * NOTE: Some selectors from CORE_SELECTORS are NOT implemented in the component:
- * - settings-profile (component uses profile-main)
- * - profile-avatar, profile-avatar-upload (not in current implementation)
- * - profile-first-name, profile-last-name, profile-email (native inputs, no data-cy)
- * These are documented for future implementation.
+ * Test IDs:
+ * - SEL_PROF_001: Profile Page Selectors
+ *
+ * NOTE: Only 2 selectors are NOT implemented (feature doesn't exist):
+ * - profile-avatar, profile-avatar-upload (avatar feature not in current implementation)
  */
 
-import { SettingsPOM } from '../../src/features/SettingsPOM'
-import { loginAsDefaultOwner } from '../../src/session-helpers'
+import { SettingsPOM } from '../../../src/features/SettingsPOM'
+import { loginAsDefaultDeveloper } from '../../../src/session-helpers'
 
-describe('Settings Profile Selectors Validation', { tags: ['@ui-selectors'] }, () => {
+describe('Settings Profile Selectors Validation', { tags: ['@ui-selectors', '@settings'] }, () => {
   const settings = SettingsPOM.create()
 
   beforeEach(() => {
-    loginAsDefaultOwner()
+    loginAsDefaultDeveloper()
     settings.visitProfile()
     // Wait for profile page to load - use profile form as indicator
     cy.get(settings.selectors.profileForm, { timeout: 15000 }).should('be.visible')
   })
 
   // ============================================
-  // PROFILE SELECTORS (9 selectors in CORE_SELECTORS)
-  // Currently only 3 are implemented in component
+  // SEL_PROF_001: PROFILE PAGE SELECTORS
   // ============================================
-  describe('Profile Page Selectors', () => {
-    // NOTE: CORE_SELECTORS defines 'settings-profile' but component uses 'profile-main'
-    it.skip('should find profile container (selector mismatch: CORE uses settings-profile, component uses profile-main)', () => {
+  describe('SEL_PROF_001: Profile Page Selectors', { tags: '@SEL_PROF_001' }, () => {
+    it('should find profile container', () => {
       cy.get(settings.selectors.profileContainer).should('exist')
     })
 
@@ -57,16 +55,15 @@ describe('Settings Profile Selectors Validation', { tags: ['@ui-selectors'] }, (
       cy.get(settings.selectors.profileAvatarUpload).should('exist')
     })
 
-    // NOTE: Native inputs don't have data-cy selectors
-    it.skip('should find first name input (native input, no data-cy)', () => {
+    it('should find first name input', () => {
       cy.get(settings.selectors.profileFirstName).should('exist')
     })
 
-    it.skip('should find last name input (native input, no data-cy)', () => {
+    it('should find last name input', () => {
       cy.get(settings.selectors.profileLastName).should('exist')
     })
 
-    it.skip('should find email input (native input, no data-cy)', () => {
+    it('should find email input', () => {
       cy.get(settings.selectors.profileEmail).should('exist')
     })
 

package/tests/cypress/e2e/_utils/selectors/settings-teams.bdd.md

@@ -0,0 +1,130 @@
+---
+feature: Settings Teams UI Selectors Validation
+priority: high
+tags: [selectors, settings, teams, ui-validation]
+grepTags: [ui-selectors, settings, SEL_STMS_001, SEL_STMS_002]
+coverage: 2
+---
+
+# Settings Teams UI Selectors Validation
+
+> Validates that settings teams selectors exist in the DOM. This is a lightweight test that ONLY checks selector presence, not functionality. Runs as Phase 12 sub-gate before functional tests.
+
+## @test SEL_STMS_001: Teams Page Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** settings, teams, management
+- **Grep:** `@ui-selectors` `@SEL_STMS_001`
+- **Status:** Active (6 passing, 0 skipped)
+
+```gherkin:en
+Scenario: Teams settings page has required selectors
+
+Given I am logged in as developer
+And I navigate to the teams settings page
+Then I should find the teams main container
+And I should find the teams header
+And I should find the teams list
+And I should find at least one team item in the list
+And I should find the create team button
+When I click on a team item
+Then I should find the team details section
+```
+
+```gherkin:es
+Scenario: La pagina de settings de teams tiene los selectores requeridos
+
+Given estoy logueado como developer
+And navego a la pagina de settings de teams
+Then deberia encontrar el contenedor principal de teams
+And deberia encontrar el header de teams
+And deberia encontrar la lista de teams
+And deberia encontrar al menos un item de equipo en la lista
+And deberia encontrar el boton de crear equipo
+When hago click en un item de equipo
+Then deberia encontrar la seccion de detalles del equipo
+```
+
+### Expected Results
+- `teams-settings-main` selector exists ✅
+- `teams-settings-header` selector exists ✅
+- `teams-settings-teams-list` selector exists ✅
+- `team-item-{id}` selector exists for team items ✅
+- `teams-settings-team-details` selector exists when team selected ✅
+- `create-team-button` selector exists ✅
+
+---
+
+## @test SEL_STMS_002: Create Team Dialog Documentation
+
+### Metadata
+- **Priority:** Medium
+- **Type:** Documentation
+- **Tags:** settings, teams, dialog
+- **Grep:** `@ui-selectors` `@SEL_STMS_002`
+- **Status:** Active (1 passing, 0 skipped)
+
+```gherkin:en
+Scenario: Create Team Dialog selectors are documented
+
+Given the Create Team Dialog can be opened from teams settings
+Then the following selectors are documented:
+| Selector | Value |
+| create-team-dialog | Dialog container |
+| team-name-input | Name input field |
+| team-slug-input | Slug input field |
+| team-description-input | Description input |
+| cancel-create-team | Cancel button |
+| submit-create-team | Submit button |
+```
+
+```gherkin:es
+Scenario: Los selectores del dialogo de crear equipo estan documentados
+
+Given el dialogo de crear equipo puede abrirse desde settings de teams
+Then los siguientes selectores estan documentados:
+| Selector | Valor |
+| create-team-dialog | Contenedor del dialogo |
+| team-name-input | Campo de nombre |
+| team-slug-input | Campo de slug |
+| team-description-input | Campo de descripcion |
+| cancel-create-team | Boton cancelar |
+| submit-create-team | Boton enviar |
+```
+
+### Expected Results
+- Create Team Dialog selectors are documented for reference ✅
+- Actual dialog testing done in teams.cy.ts (SEL_TEAM_003)
+
+### Notes
+The Create Team Dialog selectors are shared between:
+- Teams settings page (`/dashboard/settings/teams`)
+- Team switcher create button
+
+This test documents the selectors for cross-reference with teams.cy.ts.
+
+---
+
+## Related Components
+
+| Component | File | Selectors |
+|-----------|------|-----------|
+| TeamsSettings | `packages/core/templates/app/dashboard/settings/teams/page.tsx` | teams-settings-main, teams-settings-header, teams-settings-teams-list, teams-settings-team-details, team-item-{id} |
+| CreateTeamDialog | `packages/core/src/components/teams/CreateTeamDialog.tsx` | create-team-dialog, cancel-create-team, submit-create-team |
+
+## Related POMs
+
+| POM | File | Usage |
+|-----|------|-------|
+| SettingsPOM | `themes/default/tests/cypress/src/features/SettingsPOM.ts` | Teams settings page selectors |
+| TeamSwitcherPOM | `themes/default/tests/cypress/src/components/TeamSwitcherPOM.ts` | Create team dialog selectors |
+
+## Test Summary
+
+| Test ID | Description | Status | Tests |
+|---------|-------------|--------|-------|
+| SEL_STMS_001 | Teams Page Selectors | Active | 6 |
+| SEL_STMS_002 | Create Team Dialog Documentation | Active | 1 |
+| **Total** | | **All Active** | **7** |

package/tests/cypress/e2e/{_selectors → _utils/selectors}/settings-teams.cy.ts

@@ -13,25 +13,29 @@
  * - Navigate to teams settings page (requires login)
  * - Assert elements exist in DOM (no form submissions)
  * - Fast execution (< 30 seconds per describe block)
+ *
+ * Test IDs:
+ * - SEL_STMS_001: Teams Page Selectors
+ * - SEL_STMS_002: Create Team Dialog (documentation only)
  */
 
-import { SettingsPOM } from '../../src/features/SettingsPOM'
-import { loginAsDefaultOwner } from '../../src/session-helpers'
+import { SettingsPOM } from '../../../src/features/SettingsPOM'
+import { loginAsDefaultDeveloper } from '../../../src/session-helpers'
 
-describe('Settings Teams Selectors Validation', { tags: ['@ui-selectors'] }, () => {
+describe('Settings Teams Selectors Validation', { tags: ['@ui-selectors', '@settings'] }, () => {
   const settings = SettingsPOM.create()
 
   beforeEach(() => {
-    loginAsDefaultOwner()
+    loginAsDefaultDeveloper()
     cy.visit('/dashboard/settings/teams', { timeout: 60000 })
     // Wait for teams page to load - either main or loading should appear
     cy.get('[data-cy="teams-settings-main"], [data-cy="teams-settings-loading"]', { timeout: 15000 }).should('exist')
   })
 
   // ============================================
-  // TEAMS SETTINGS SELECTORS (6 selectors in CORE_SELECTORS)
+  // SEL_STMS_001: TEAMS PAGE SELECTORS
   // ============================================
-  describe('Teams Page Selectors', () => {
+  describe('SEL_STMS_001: Teams Page Selectors', { tags: '@SEL_STMS_001' }, () => {
     it('should find teams main container', () => {
       // Wait for loading to finish
       cy.get('[data-cy="teams-settings-main"]', { timeout: 15000 }).should('exist')
@@ -41,22 +45,18 @@ describe('Settings Teams Selectors Validation', { tags: ['@ui-selectors'] }, ()
       cy.get('[data-cy="teams-settings-header"]', { timeout: 15000 }).should('exist')
     })
 
-    // Note: Loading skeleton appears briefly during initial load
-    it.skip('should find loading skeleton (only visible during loading)', () => {
-      cy.get('[data-cy="teams-settings-loading"]').should('exist')
-    })
-
-    // Note: Single user message only appears for users not in any team
-    it.skip('should find single user message (only for users without teams)', () => {
-      cy.get('[data-cy="teams-settings-single-user"]').should('exist')
-    })
-
     it('should find teams list', () => {
       cy.get('[data-cy="teams-settings-teams-list"]', { timeout: 15000 }).should('exist')
     })
 
-    // Note: Team details only appears when a team is selected
-    it.skip('should find team details section (only when team is selected)', () => {
+    it('should find team item in list', () => {
+      cy.get('[data-cy^="team-item-"]', { timeout: 15000 }).should('have.length.at.least', 1)
+    })
+
+    it('should find team details section when team is selected', () => {
+      // Click on first team to select it
+      cy.get('[data-cy^="team-item-"]').first().click()
+      // Team details should appear
       cy.get('[data-cy="teams-settings-team-details"]', { timeout: 15000 }).should('exist')
     })
 
@@ -65,4 +65,22 @@ describe('Settings Teams Selectors Validation', { tags: ['@ui-selectors'] }, ()
       cy.get('[data-cy="create-team-button"]', { timeout: 15000 }).should('exist')
     })
   })
+
+  // ============================================
+  // SEL_STMS_002: CREATE TEAM DIALOG
+  // Tested in teams.cy.ts, documented here for reference
+  // ============================================
+  describe('SEL_STMS_002: Create Team Dialog Documentation', { tags: '@SEL_STMS_002' }, () => {
+    it('should document create team dialog selectors', () => {
+      cy.log('Create Team Dialog selectors are tested in teams.cy.ts')
+      cy.log('Dialog selectors:')
+      cy.log('- create-team-dialog')
+      cy.log('- team-name-input')
+      cy.log('- team-slug-input')
+      cy.log('- team-description-input')
+      cy.log('- cancel-create-team')
+      cy.log('- submit-create-team')
+      cy.wrap(true).should('be.true')
+    })
+  })
 })

package/tests/cypress/e2e/_utils/selectors/superadmin.bdd.md

@@ -0,0 +1,261 @@
+---
+feature: Superadmin UI Selectors Validation
+priority: high
+tags: [selectors, superadmin, ui-validation, admin-panel]
+grepTags: [ui-selectors, superadmin, SEL_SADM_001, SEL_SADM_002, SEL_SADM_003, SEL_SADM_004, SEL_SADM_005, SEL_SADM_006]
+coverage: 6
+---
+
+# Superadmin UI Selectors Validation
+
+> Validates that superadmin area selectors exist in the DOM. This is a lightweight test that ONLY checks selector presence, not functionality. Runs as Phase 12 sub-gate before functional tests.
+
+## @test SEL_SADM_001: Superadmin Dashboard Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** superadmin, dashboard, container
+- **Grep:** `@ui-selectors` `@SEL_SADM_001`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Superadmin dashboard has required selectors
+
+Given I am logged in as superadmin
+And I navigate to the superadmin dashboard
+Then I should find the superadmin container
+And I should find the dashboard container
+```
+
+```gherkin:es
+Scenario: El dashboard de superadmin tiene los selectores requeridos
+
+Given estoy logueado como superadmin
+And navego al dashboard de superadmin
+Then deberia encontrar el contenedor de superadmin
+And deberia encontrar el contenedor del dashboard
+```
+
+### Expected Results
+- `superadmin.container` selector exists (superadmin-container)
+- `superadmin.dashboard.container` selector exists (superadmin-dashboard)
+
+---
+
+## @test SEL_SADM_002: Superadmin Navigation Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** superadmin, navigation, sidebar
+- **Grep:** `@ui-selectors` `@SEL_SADM_002`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Superadmin navigation has all required links
+
+Given I am logged in as superadmin
+And I navigate to the superadmin area
+Then I should find the dashboard nav link
+And I should find the users nav link
+And I should find the teams nav link
+And I should find the team-roles nav link
+And I should find the subscriptions nav link
+And I should find the exit to dashboard link
+```
+
+```gherkin:es
+Scenario: La navegacion de superadmin tiene todos los links requeridos
+
+Given estoy logueado como superadmin
+And navego al area de superadmin
+Then deberia encontrar el link de navegacion a dashboard
+And deberia encontrar el link de navegacion a users
+And deberia encontrar el link de navegacion a teams
+And deberia encontrar el link de navegacion a team-roles
+And deberia encontrar el link de navegacion a subscriptions
+And deberia encontrar el link de salir al dashboard
+```
+
+### Expected Results
+- `superadmin.navigation.dashboard` selector exists (superadmin-nav-dashboard)
+- `superadmin.navigation.users` selector exists (superadmin-nav-users)
+- `superadmin.navigation.teams` selector exists (superadmin-nav-teams)
+- `superadmin.navigation.teamRoles` selector exists (superadmin-nav-team-roles)
+- `superadmin.navigation.subscriptions` selector exists (superadmin-nav-subscriptions)
+- `superadmin.navigation.exitToDashboard` selector exists (superadmin-sidebar-exit-to-dashboard)
+
+---
+
+## @test SEL_SADM_003: Superadmin Users Page Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** superadmin, users, management
+- **Grep:** `@ui-selectors` `@SEL_SADM_003`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Superadmin users page has required selectors
+
+Given I am logged in as superadmin
+And I navigate to the superadmin users page
+Then I should find the users container
+And I should find the users table
+And I should find the users search input
+```
+
+```gherkin:es
+Scenario: La pagina de usuarios de superadmin tiene los selectores requeridos
+
+Given estoy logueado como superadmin
+And navego a la pagina de usuarios de superadmin
+Then deberia encontrar el contenedor de usuarios
+And deberia encontrar la tabla de usuarios
+And deberia encontrar el input de busqueda de usuarios
+```
+
+### Expected Results
+- `superadmin.users.container` selector exists (superadmin-users-container)
+- `superadmin.users.table` selector exists (superadmin-users-table)
+- `superadmin.users.search` selector exists (superadmin-users-search)
+
+---
+
+## @test SEL_SADM_004: Superadmin Teams Page Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** superadmin, teams, management
+- **Grep:** `@ui-selectors` `@SEL_SADM_004`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Superadmin teams page has required selectors
+
+Given I am logged in as superadmin
+And I navigate to the superadmin teams page
+Then I should find the teams container
+And I should find the teams table
+And I should find the teams search input
+```
+
+```gherkin:es
+Scenario: La pagina de equipos de superadmin tiene los selectores requeridos
+
+Given estoy logueado como superadmin
+And navego a la pagina de equipos de superadmin
+Then deberia encontrar el contenedor de equipos
+And deberia encontrar la tabla de equipos
+And deberia encontrar el input de busqueda de equipos
+```
+
+### Expected Results
+- `superadmin.teams.container` selector exists (superadmin-teams-container)
+- `superadmin.teams.table` selector exists (superadmin-teams-table)
+- `superadmin.teams.search` selector exists (superadmin-teams-search)
+
+---
+
+## @test SEL_SADM_005: Superadmin Subscriptions Page Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** superadmin, subscriptions, billing
+- **Grep:** `@ui-selectors` `@SEL_SADM_005`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Superadmin subscriptions page has required selectors
+
+Given I am logged in as superadmin
+And I navigate to the superadmin subscriptions page
+Then I should find the subscriptions container
+And I should find the MRR stat card
+And I should find the plan distribution section
+And I should find the active count stat card
+```
+
+```gherkin:es
+Scenario: La pagina de suscripciones de superadmin tiene los selectores requeridos
+
+Given estoy logueado como superadmin
+And navego a la pagina de suscripciones de superadmin
+Then deberia encontrar el contenedor de suscripciones
+And deberia encontrar la tarjeta de estadisticas MRR
+And deberia encontrar la seccion de distribucion de planes
+And deberia encontrar la tarjeta de conteo activo
+```
+
+### Expected Results
+- `superadmin.subscriptions.container` selector exists (superadmin-subscriptions-container)
+- `superadmin.subscriptions.mrr` selector exists (superadmin-subscriptions-mrr)
+- `superadmin.subscriptions.planDistribution` selector exists (superadmin-subscriptions-plan-distribution)
+- `superadmin.subscriptions.activeCount` selector exists (superadmin-subscriptions-active-count)
+
+---
+
+## @test SEL_SADM_006: Dynamic Selectors (Pattern Validation)
+
+### Metadata
+- **Priority:** Medium
+- **Type:** Selector Validation
+- **Tags:** superadmin, dynamic, patterns
+- **Grep:** `@ui-selectors` `@SEL_SADM_006`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Dynamic selectors return valid patterns
+
+Given I am logged in as superadmin
+And I navigate to the superadmin users page
+Then the userRow selector should return a valid pattern
+And the userView selector should return a valid pattern
+And the teamRow selector should return a valid pattern
+And the subscriptionsPlanCount selector should return a valid pattern
+```
+
+```gherkin:es
+Scenario: Los selectores dinamicos retornan patrones validos
+
+Given estoy logueado como superadmin
+And navego a la pagina de usuarios de superadmin
+Then el selector userRow deberia retornar un patron valido
+And el selector userView deberia retornar un patron valido
+And el selector teamRow deberia retornar un patron valido
+And el selector subscriptionsPlanCount deberia retornar un patron valido
+```
+
+### Expected Results
+- `superadmin.users.row` pattern includes 'superadmin-user-row'
+- `superadmin.users.viewButton` pattern includes 'superadmin-user-view'
+- `superadmin.teams.row` pattern includes 'superadmin-team-row'
+- `superadmin.subscriptions.planCount` pattern includes 'superadmin-subscriptions-plan-count'
+
+### Notes
+These tests validate that dynamic selector functions (those that accept parameters like `id` or `plan`) return correctly formatted selector strings. They do not test actual DOM elements.
+
+---
+
+## Related Components
+
+| Component | File | Selectors |
+|-----------|------|-----------|
+| SuperadminLayout | `packages/core/templates/app/superadmin/layout.tsx` | superadmin-container |
+| SuperadminSidebar | `packages/core/src/components/superadmin/layouts/SuperadminSidebar.tsx` | superadmin-nav-* |
+| SuperadminDashboard | `packages/core/templates/app/superadmin/page.tsx` | superadmin-dashboard |
+| UsersPage | `packages/core/templates/app/superadmin/users/page.tsx` | superadmin-users-* |
+| TeamsPage | `packages/core/templates/app/superadmin/teams/page.tsx` | superadmin-teams-* |
+| SubscriptionsPage | `packages/core/templates/app/superadmin/subscriptions/page.tsx` | superadmin-subscriptions-* |
+| UsersTable | `packages/core/src/components/users/tables/UsersTable.tsx` | superadmin-users-table, superadmin-user-row-{id} |
+| TeamsTable | `packages/core/src/components/superadmin/tables/TeamsTable.tsx` | superadmin-teams-table, superadmin-team-row-{id} |
+
+## Related POMs
+
+| POM | File | Usage |
+|-----|------|-------|
+| SuperadminPOM | `themes/default/tests/cypress/src/features/SuperadminPOM.ts` | Superadmin area interactions and selectors |

package/tests/cypress/e2e/{_selectors → _utils/selectors}/superadmin.cy.ts

@@ -14,19 +14,27 @@
  * - Assert elements exist in DOM (no form submissions)
  * - Fast execution (< 30 seconds per describe block)
  *
+ * Test IDs:
+ * - SEL_SADM_001: Superadmin Dashboard Selectors
+ * - SEL_SADM_002: Superadmin Navigation Selectors
+ * - SEL_SADM_003: Superadmin Users Page Selectors
+ * - SEL_SADM_004: Superadmin Teams Page Selectors
+ * - SEL_SADM_005: Superadmin Subscriptions Page Selectors
+ * - SEL_SADM_006: Dynamic Selectors (Pattern Validation)
+ *
  * NOTE: Requires superadmin role to access /superadmin/* pages.
  */
 
-import { SuperadminPOM } from '../../src/features/SuperadminPOM'
-import { loginAsDefaultSuperadmin } from '../../src/session-helpers'
+import { SuperadminPOM } from '../../../src/features/SuperadminPOM'
+import { loginAsDefaultSuperadmin } from '../../../src/session-helpers'
 
-describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
+describe('Superadmin Selectors Validation', { tags: ['@ui-selectors', '@superadmin'] }, () => {
   const superadmin = SuperadminPOM.create()
 
   // ============================================
-  // SUPERADMIN DASHBOARD (2 selectors)
+  // SEL_SADM_001: SUPERADMIN DASHBOARD
   // ============================================
-  describe('Superadmin Dashboard', () => {
+  describe('SEL_SADM_001: Superadmin Dashboard', { tags: '@SEL_SADM_001' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin', { timeout: 60000, failOnStatusCode: false })
@@ -43,9 +51,9 @@ describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // SUPERADMIN NAVIGATION (6 selectors)
+  // SEL_SADM_002: SUPERADMIN NAVIGATION
   // ============================================
-  describe('Superadmin Navigation', () => {
+  describe('SEL_SADM_002: Superadmin Navigation', { tags: '@SEL_SADM_002' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin', { timeout: 60000, failOnStatusCode: false })
@@ -78,9 +86,9 @@ describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // SUPERADMIN USERS PAGE (3 selectors)
+  // SEL_SADM_003: SUPERADMIN USERS PAGE
   // ============================================
-  describe('Superadmin Users Page', () => {
+  describe('SEL_SADM_003: Superadmin Users Page', { tags: '@SEL_SADM_003' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin/users', { timeout: 60000, failOnStatusCode: false })
@@ -101,9 +109,9 @@ describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // SUPERADMIN TEAMS PAGE (4 selectors)
+  // SEL_SADM_004: SUPERADMIN TEAMS PAGE
   // ============================================
-  describe('Superadmin Teams Page', () => {
+  describe('SEL_SADM_004: Superadmin Teams Page', { tags: '@SEL_SADM_004' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin/teams', { timeout: 60000, failOnStatusCode: false })
@@ -124,9 +132,9 @@ describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // SUPERADMIN SUBSCRIPTIONS PAGE (4 selectors)
+  // SEL_SADM_005: SUPERADMIN SUBSCRIPTIONS PAGE
   // ============================================
-  describe('Superadmin Subscriptions Page', () => {
+  describe('SEL_SADM_005: Superadmin Subscriptions Page', { tags: '@SEL_SADM_005' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin/subscriptions', { timeout: 60000, failOnStatusCode: false })
@@ -151,10 +159,10 @@ describe('Superadmin Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // DYNAMIC SELECTORS (require specific data)
+  // SEL_SADM_006: DYNAMIC SELECTORS (PATTERN VALIDATION)
   // These test the selector pattern, not actual elements
   // ============================================
-  describe('Dynamic Selectors (Pattern Validation)', () => {
+  describe('SEL_SADM_006: Dynamic Selectors (Pattern Validation)', { tags: '@SEL_SADM_006' }, () => {
     beforeEach(() => {
       loginAsDefaultSuperadmin()
       cy.visit('/superadmin/users', { timeout: 60000, failOnStatusCode: false })