@nextsparkjs/theme-default 0.1.0-beta.2 → 0.1.0-beta.21

package/tests/cypress/e2e/_superadmin/dashboard.bdd.md

@@ -0,0 +1,235 @@
+---
+feature: Superadmin Dashboard (Admin Panel)
+priority: critical
+tags: [sector7, superadmin, dashboard, navigation]
+grepTags: [uat, feat-sector7, superadmin, dashboard]
+coverage: 6
+---
+
+# Superadmin Dashboard (Admin Panel)
+
+> Tests for the Admin Panel superadmin dashboard including access control, navigation menu, quick stats display, and navigation to management pages.
+
+## @test ADMIN-DASH-001: Dashboard Access
+
+### Metadata
+- **Priority:** Critical
+- **Type:** Smoke
+- **Tags:** sector7, dashboard, access
+- **Grep:** `@smoke`
+
+```gherkin:en
+Scenario: Superadmin can access Admin Panel dashboard
+
+Given I am logged in as Superadmin (superadmin@nextspark.dev)
+When I visit /admin
+Then the URL should include /admin
+And the sector7 container should be visible
+And the header should display "Super Administrator Control Panel"
+```
+
+```gherkin:es
+Scenario: Superadmin puede acceder al dashboard de Admin Panel
+
+Given estoy logueado como Superadmin (superadmin@nextspark.dev)
+When visito /admin
+Then la URL deberia incluir /admin
+And el contenedor de sector7 deberia estar visible
+And el header deberia mostrar "Super Administrator Control Panel"
+```
+
+### Expected Results
+- Dashboard loads correctly
+- Header displays correct title
+- No access denied errors
+
+---
+
+## @test ADMIN-DASH-002: Navigation Menu
+
+### Metadata
+- **Priority:** Critical
+- **Type:** Smoke
+- **Tags:** sector7, navigation, menu
+- **Grep:** `@smoke`
+
+```gherkin:en
+Scenario: Dashboard displays all navigation items
+
+Given I am logged in as Superadmin
+When I visit /admin
+Then the dashboard nav item should be visible
+And the users nav item should be visible
+And the teams nav item should be visible
+```
+
+```gherkin:es
+Scenario: Dashboard muestra todos los items de navegacion
+
+Given estoy logueado como Superadmin
+When visito /admin
+Then el nav item de dashboard deberia estar visible
+And el nav item de users deberia estar visible
+And el nav item de teams deberia estar visible
+```
+
+### Expected Results
+- All navigation items visible
+- Navigation items are clickable
+
+---
+
+## @test ADMIN-DASH-003: Quick Stats Display
+
+### Metadata
+- **Priority:** High
+- **Type:** Regression
+- **Tags:** sector7, stats, dashboard
+
+```gherkin:en
+Scenario: Dashboard displays system statistics
+
+Given I am logged in as Superadmin
+When I visit /admin
+Then the sector7 container should be visible
+And I should see stats cards (users count, teams count) if available
+```
+
+```gherkin:es
+Scenario: Dashboard muestra estadisticas del sistema
+
+Given estoy logueado como Superadmin
+When visito /admin
+Then el contenedor de sector7 deberia estar visible
+And deberia ver cards de estadisticas (conteo de usuarios, teams) si estan disponibles
+```
+
+### Expected Results
+- Stats section displays or gracefully handles absence
+- Data reflects current system state
+
+---
+
+## @test ADMIN-DASH-004: Navigation to Users
+
+### Metadata
+- **Priority:** High
+- **Type:** Regression
+- **Tags:** sector7, navigation, users
+
+```gherkin:en
+Scenario: Navigate to Users management from dashboard
+
+Given I am logged in as Superadmin
+And I am on /admin
+When I click on the Users nav item
+Then the URL should include /admin/users
+And I should see "User Management" heading
+```
+
+```gherkin:es
+Scenario: Navegar a gestion de Users desde dashboard
+
+Given estoy logueado como Superadmin
+And estoy en /admin
+When hago click en el nav item de Users
+Then la URL deberia incluir /admin/users
+And deberia ver el heading "User Management"
+```
+
+### Expected Results
+- Navigation works correctly
+- Users page loads
+
+---
+
+## @test ADMIN-DASH-005: Navigation to Teams
+
+### Metadata
+- **Priority:** High
+- **Type:** Regression
+- **Tags:** sector7, navigation, teams
+
+```gherkin:en
+Scenario: Navigate to Teams management from dashboard
+
+Given I am logged in as Superadmin
+And I am on /admin
+When I click on the Teams nav item
+Then the URL should include /admin/teams
+And I should see "Team Management" heading
+```
+
+```gherkin:es
+Scenario: Navegar a gestion de Teams desde dashboard
+
+Given estoy logueado como Superadmin
+And estoy en /admin
+When hago click en el nav item de Teams
+Then la URL deberia incluir /admin/teams
+And deberia ver el heading "Team Management"
+```
+
+### Expected Results
+- Navigation works correctly
+- Teams page loads
+
+---
+
+## @test ADMIN-DASH-006: Exit to Main Dashboard
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, navigation, exit
+
+```gherkin:en
+Scenario: Exit Admin Panel to main dashboard
+
+Given I am logged in as Superadmin
+And I am on /admin
+When I click on the exit to dashboard button
+Then the URL should include /dashboard
+And the URL should not include /admin
+```
+
+```gherkin:es
+Scenario: Salir de Admin Panel al dashboard principal
+
+Given estoy logueado como Superadmin
+And estoy en /admin
+When hago click en el boton de salir al dashboard
+Then la URL deberia incluir /dashboard
+And la URL no deberia incluir /admin
+```
+
+### Expected Results
+- Exit button works
+- Returns to main dashboard
+
+---
+
+## UI Elements
+
+| Element | Selector | Description |
+|---------|----------|-------------|
+| Container | `[data-cy="sector7-container"]` | Main Admin Panel container |
+| Nav Dashboard | `[data-cy="sector7-nav-dashboard"]` | Dashboard nav item |
+| Nav Users | `[data-cy="sector7-nav-users"]` | Users nav item |
+| Nav Teams | `[data-cy="sector7-nav-teams"]` | Teams nav item |
+| Stats Users | `[data-cy="sector7-stats-users"]` | Users count stat |
+| Stats Teams | `[data-cy="sector7-stats-teams"]` | Teams count stat |
+| Exit Button | `[data-cy="sector7-sidebar-exit-to-dashboard"]` | Exit to dashboard button |
+
+---
+
+## Summary
+
+| Test ID | Block | Description | Tags |
+|---------|-------|-------------|------|
+| ADMIN-DASH-001 | Access | Dashboard access | `@smoke` |
+| ADMIN-DASH-002 | Navigation | Navigation menu items | `@smoke` |
+| ADMIN-DASH-003 | Stats | Quick stats display | |
+| ADMIN-DASH-004 | Navigation | Navigate to Users | |
+| ADMIN-DASH-005 | Navigation | Navigate to Teams | |
+| ADMIN-DASH-006 | Navigation | Exit to main dashboard | |

package/tests/cypress/e2e/_superadmin/dashboard.cy.ts

@@ -0,0 +1,149 @@
+/// <reference types="cypress" />
+
+/**
+ * Superadmin Dashboard Tests
+ *
+ * Tests the Admin Panel superadmin dashboard:
+ * - Dashboard access and layout
+ * - Navigation menu items
+ * - Quick stats display
+ * - Recent activity
+ *
+ * Tags: @uat, @feat-superadmin, @superadmin, @dashboard
+ */
+
+import * as allure from 'allure-cypress'
+
+import { loginAsDefaultSuperadmin } from '../../src/session-helpers'
+import { SuperadminPOM } from '../../src/features/SuperadminPOM'
+
+describe('Admin - Superadmin Dashboard', {
+  tags: ['@uat', '@feat-superadmin', '@superadmin', '@dashboard']
+}, () => {
+  const superadmin = SuperadminPOM.create()
+
+  beforeEach(() => {
+    allure.epic('Admin')
+    allure.feature('Dashboard')
+    allure.story('Superadmin Dashboard')
+    loginAsDefaultSuperadmin()
+  })
+
+  describe('ADMIN-DASH-001: Dashboard Access', { tags: '@smoke' }, () => {
+    it('should access Admin dashboard', { tags: '@smoke' }, () => {
+      allure.severity('critical')
+
+      // 1. Visit Admin
+      superadmin.visitDashboard()
+
+      // 2. Validate on Superadmin
+      superadmin.assertOnSuperadmin()
+
+      // 3. Validate dashboard container
+      superadmin.assertDashboardVisible()
+
+      // 4. Validate header
+      cy.contains('Super Administrator Control Panel').should('be.visible')
+
+      cy.log('✅ Admin dashboard accessible')
+    })
+  })
+
+  describe('ADMIN-DASH-002: Navigation Menu', { tags: '@smoke' }, () => {
+    it('should display all navigation items', { tags: '@smoke' }, () => {
+      allure.severity('critical')
+
+      // 1. Visit Admin
+      superadmin.visitDashboard()
+
+      // 2. Validate navigation items exist
+      superadmin.assertNavVisible()
+      cy.get(superadmin.selectors.navDashboard).should('be.visible')
+      cy.get(superadmin.selectors.navUsers).should('be.visible')
+      cy.get(superadmin.selectors.navTeams).should('be.visible')
+
+      cy.log('✅ All navigation items visible')
+    })
+  })
+
+  describe('ADMIN-DASH-003: Quick Stats Display', () => {
+    it('should display system statistics', () => {
+      allure.severity('high')
+
+      // 1. Visit Admin dashboard
+      superadmin.visitDashboard()
+
+      // 2. Validate stats cards (if they exist)
+      cy.get(superadmin.selectors.dashboardContainer).then(($container) => {
+        // Check for stats section or cards (defensive)
+        if ($container.find(superadmin.selectors.statsUsers).length > 0) {
+          cy.get(superadmin.selectors.statsUsers).should('be.visible')
+          cy.get(superadmin.selectors.statsTeams).should('be.visible')
+          cy.log('✅ Stats displayed')
+        } else {
+          cy.log('⚠️ Stats cards not found - dashboard uses different layout')
+        }
+      })
+
+      cy.log('✅ Dashboard stats section checked')
+    })
+  })
+
+  describe('ADMIN-DASH-004: Navigation to Users', () => {
+    it('should navigate to Users management', () => {
+      allure.severity('high')
+
+      // 1. Visit Admin
+      superadmin.visitDashboard()
+
+      // 2. Click on Users nav
+      superadmin.clickNavUsers()
+
+      // 3. Validate users page
+      cy.url().should('include', '/superadmin/users')
+      cy.contains('User Management').should('be.visible')
+
+      cy.log('✅ Users navigation works')
+    })
+  })
+
+  describe('ADMIN-DASH-005: Navigation to Teams', () => {
+    it('should navigate to Teams management', () => {
+      allure.severity('high')
+
+      // 1. Visit Admin
+      superadmin.visitDashboard()
+
+      // 2. Click on Teams nav
+      superadmin.clickNavTeams()
+
+      // 3. Validate teams page
+      cy.url().should('include', '/superadmin/teams')
+      cy.contains('Team Management').should('be.visible')
+
+      cy.log('✅ Teams navigation works')
+    })
+  })
+
+  describe('ADMIN-DASH-006: Exit to Main Dashboard', () => {
+    it('should exit Admin to main dashboard', () => {
+      allure.severity('normal')
+
+      // 1. Visit Admin
+      superadmin.visitDashboard()
+
+      // 2. Click exit button (using selector from DevAreaPOM pattern)
+      cy.get('[data-cy="superadmin-sidebar-exit-to-dashboard"]').click()
+
+      // 3. Validate redirect to main dashboard
+      cy.url().should('include', '/dashboard')
+      cy.url().should('not.include', '/superadmin')
+
+      cy.log('✅ Exit to main dashboard works')
+    })
+  })
+
+  after(() => {
+    cy.log('✅ Sector7 dashboard tests completed')
+  })
+})

package/tests/cypress/e2e/_superadmin/subscriptions-overview.bdd.md

@@ -0,0 +1,290 @@
+---
+feature: Superadmin Subscriptions Overview
+priority: high
+tags: [sector7, superadmin, subscriptions, metrics]
+grepTags: [uat, feat-sector7, superadmin, subscriptions]
+coverage: 8
+---
+
+# Superadmin Subscriptions Overview
+
+> Tests for the Admin Panel subscriptions overview page. Superadmin can view platform-wide subscription metrics including revenue, plan distribution, subscription counts, and free vs paid team breakdowns.
+>
+> Note: The route is `/admin/subscriptions` (not `/billing`)
+
+## @test ADMIN-SUBS-001: Subscriptions Page Access
+
+### Metadata
+- **Priority:** Critical
+- **Type:** Smoke
+- **Tags:** sector7, subscriptions, access
+- **Grep:** `@smoke`
+
+```gherkin:en
+Scenario: Superadmin can access subscriptions overview page
+
+Given I am logged in as Superadmin (superadmin@nextspark.dev)
+When I visit /admin/subscriptions
+Then the URL should include /admin/subscriptions
+```
+
+```gherkin:es
+Scenario: Superadmin puede acceder a la pagina de subscriptions overview
+
+Given estoy logueado como Superadmin (superadmin@nextspark.dev)
+When visito /admin/subscriptions
+Then la URL deberia incluir /admin/subscriptions
+```
+
+### Expected Results
+- Subscriptions page loads correctly
+- Container is visible
+
+---
+
+## @test ADMIN-SUBS-002: Revenue Metrics
+
+### Metadata
+- **Priority:** High
+- **Type:** Regression
+- **Tags:** sector7, subscriptions, revenue
+
+```gherkin:en
+Scenario: Display revenue metrics if available
+
+Given I am logged in as Superadmin
+When I visit /admin/subscriptions
+Then I should see MRR (Monthly Recurring Revenue) metric if implemented
+Or the page should load successfully
+```
+
+```gherkin:es
+Scenario: Mostrar metricas de revenue si estan disponibles
+
+Given estoy logueado como Superadmin
+When visito /admin/subscriptions
+Then deberia ver la metrica de MRR (Monthly Recurring Revenue) si esta implementada
+Or la pagina deberia cargar exitosamente
+```
+
+### Expected Results
+- Revenue metric visible (if implemented)
+- Page loads without errors
+
+---
+
+## @test ADMIN-SUBS-003: Plan Distribution
+
+### Metadata
+- **Priority:** High
+- **Type:** Regression
+- **Tags:** sector7, subscriptions, plans
+
+```gherkin:en
+Scenario: Display plan distribution stats if available
+
+Given I am logged in as Superadmin
+When I visit /admin/subscriptions
+Then I should see plan distribution breakdown if implemented
+Or the page should load successfully
+```
+
+```gherkin:es
+Scenario: Mostrar estadisticas de distribucion de planes si estan disponibles
+
+Given estoy logueado como Superadmin
+When visito /admin/subscriptions
+Then deberia ver el desglose de distribucion de planes si esta implementado
+Or la pagina deberia cargar exitosamente
+```
+
+### Expected Results
+- Plan distribution visible (if implemented)
+- All plan tiers represented
+
+---
+
+## @test ADMIN-SUBS-004: Active Subscriptions Count
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, subscriptions, active
+
+```gherkin:en
+Scenario: Display active subscriptions count if available
+
+Given I am logged in as Superadmin
+When I visit /admin/subscriptions
+Then I should see the count of active subscriptions if implemented
+```
+
+```gherkin:es
+Scenario: Mostrar conteo de suscripciones activas si esta disponible
+
+Given estoy logueado como Superadmin
+When visito /admin/subscriptions
+Then deberia ver el conteo de suscripciones activas si esta implementado
+```
+
+### Expected Results
+- Active count visible (if implemented)
+- Reflects current state
+
+---
+
+## @test ADMIN-SUBS-005: Free vs Paid Teams
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, subscriptions, teams
+
+```gherkin:en
+Scenario: Display free vs paid teams breakdown if available
+
+Given I am logged in as Superadmin
+When I visit /admin/subscriptions
+Then I should see the count of free teams if implemented
+And I should see the count of paid teams if implemented
+```
+
+```gherkin:es
+Scenario: Mostrar desglose de teams free vs paid si esta disponible
+
+Given estoy logueado como Superadmin
+When visito /admin/subscriptions
+Then deberia ver el conteo de teams free si esta implementado
+And deberia ver el conteo de teams paid si esta implementado
+```
+
+### Expected Results
+- Free count visible (if implemented)
+- Paid count visible (if implemented)
+
+---
+
+## @test ADMIN-SUBS-006: Trial Teams
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, subscriptions, trials
+
+```gherkin:en
+Scenario: Display teams on trial if available
+
+Given I am logged in as Superadmin
+When I visit /admin/subscriptions
+Then I should see the count of teams on trial if implemented
+```
+
+```gherkin:es
+Scenario: Mostrar teams en periodo de prueba si esta disponible
+
+Given estoy logueado como Superadmin
+When visito /admin/subscriptions
+Then deberia ver el conteo de teams en trial si esta implementado
+```
+
+### Expected Results
+- Trial count visible (if implemented)
+
+---
+
+## @test ADMIN-SUBS-007: Navigate to Teams from Subscriptions
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, navigation
+
+```gherkin:en
+Scenario: Navigate to teams page from subscriptions
+
+Given I am logged in as Superadmin
+And I am on /admin/subscriptions
+When I click on the teams nav item
+Then I should be on /admin/teams
+```
+
+```gherkin:es
+Scenario: Navegar a pagina de teams desde subscriptions
+
+Given estoy logueado como Superadmin
+And estoy en /admin/subscriptions
+When hago click en el nav item de teams
+Then deberia estar en /admin/teams
+```
+
+### Expected Results
+- Navigation works
+- Teams page loads
+
+---
+
+## @test ADMIN-SUBS-008: Navigate Back to Dashboard
+
+### Metadata
+- **Priority:** Normal
+- **Type:** Regression
+- **Tags:** sector7, navigation
+
+```gherkin:en
+Scenario: Navigate back to Admin Panel dashboard
+
+Given I am logged in as Superadmin
+And I am on /admin/subscriptions
+When I click on the dashboard nav item
+Then I should be on /admin
+And the dashboard container should be visible
+```
+
+```gherkin:es
+Scenario: Navegar de vuelta al dashboard de Admin Panel
+
+Given estoy logueado como Superadmin
+And estoy en /admin/subscriptions
+When hago click en el nav item de dashboard
+Then deberia estar en /admin
+And el contenedor del dashboard deberia estar visible
+```
+
+### Expected Results
+- Navigation works
+- Dashboard loads
+
+---
+
+## UI Elements
+
+| Element | Selector | Description |
+|---------|----------|-------------|
+| Container | `[data-cy="sector7-container"]` | Admin Panel main container |
+| MRR Metric | `[data-cy="subscriptions-mrr"]` | Monthly Recurring Revenue |
+| Revenue | `[data-cy="subscriptions-revenue"]` | Total revenue metric |
+| Plan Distribution | `[data-cy="subscriptions-plan-distribution"]` | Plan breakdown chart |
+| Plan Count | `[data-cy="subscriptions-plan-count-{planName}"]` | Individual plan count |
+| Active Count | `[data-cy="subscriptions-active-count"]` | Active subscriptions count |
+| Free Teams | `[data-cy="subscriptions-free-teams"]` | Free teams count |
+| Paid Teams | `[data-cy="subscriptions-paid-teams"]` | Paid teams count |
+| Trial Teams | `[data-cy="subscriptions-trial-teams"]` | Trial teams count |
+| Nav Dashboard | `[data-cy="sector7-nav-dashboard"]` | Dashboard nav item |
+| Nav Teams | `[data-cy="sector7-nav-teams"]` | Teams nav item |
+
+> Note: Many UI elements may not have data-cy selectors yet. Tests are defensive and will pass if page loads correctly.
+
+---
+
+## Summary
+
+| Test ID | Block | Description | Tags |
+|---------|-------|-------------|------|
+| ADMIN-SUBS-001 | Access | Subscriptions page access | `@smoke` |
+| ADMIN-SUBS-002 | Metrics | Revenue metrics | |
+| ADMIN-SUBS-003 | Metrics | Plan distribution | |
+| ADMIN-SUBS-004 | Metrics | Active subscriptions | |
+| ADMIN-SUBS-005 | Metrics | Free vs paid teams | |
+| ADMIN-SUBS-006 | Metrics | Trial teams | |
+| ADMIN-SUBS-007 | Navigation | Navigate to teams | |
+| ADMIN-SUBS-008 | Navigation | Back to dashboard | |