Files
fast-next-template/frontend/e2e/admin-dashboard.spec.ts
Felipe Cardoso 570848cc2d Refactor e2e tests for improved reliability and consistency
- Updated `auth-guard.spec.ts` to configure localStorage before navigation using `context.addInitScript`.
- Enhanced test stability with explicit `waitForLoadState` calls after page reloads.
- Refactored `admin-dashboard.spec.ts` for more descriptive test names aligning with chart updates. Adjusted lazy-loading behavior in the analytics section.
- Reworked `homepage.spec.ts` tests to improve headline and badge visibility checks. Added scroll-triggered animation handling for stats section.
- Enhanced MSW handler in `auth.ts` with mock data for user growth and registration activity charts. Added organization and user status distribution data.
2025-11-24 20:55:04 +01:00

192 lines
8.2 KiB
TypeScript

/**
* E2E Tests for Admin Dashboard
* Tests dashboard statistics and analytics charts
*/
import { test, expect } from '@playwright/test';
import { setupSuperuserMocks } from './helpers/auth';
test.describe('Admin Dashboard - Page Load', () => {
test.beforeEach(async ({ page }) => {
await setupSuperuserMocks(page);
// Auth already cached in storage state (loginViaUI removed for performance)
await page.goto('/en/admin');
});
test('should display admin dashboard page', async ({ page }) => {
await expect(page).toHaveURL('/en/admin');
await expect(page.getByRole('heading', { name: 'Admin Dashboard' })).toBeVisible();
await expect(page.getByText('Manage users, organizations, and system settings')).toBeVisible();
});
test('should display page title', async ({ page }) => {
await expect(page).toHaveTitle('Admin Dashboard');
});
});
test.describe('Admin Dashboard - Statistics Cards', () => {
test.beforeEach(async ({ page }) => {
await setupSuperuserMocks(page);
// Auth already cached in storage state (loginViaUI removed for performance)
await page.goto('/en/admin');
});
test('should display all stat cards', async ({ page }) => {
// Wait for stats to load
await page.waitForSelector('[data-testid="dashboard-stats"]');
// Check all stat cards are visible using data-testid to avoid ambiguity
const statCards = page.getByTestId('stat-title');
await expect(statCards.filter({ hasText: 'Total Users' })).toBeVisible();
await expect(statCards.filter({ hasText: 'Active Users' })).toBeVisible();
await expect(statCards.filter({ hasText: 'Organizations' })).toBeVisible();
await expect(statCards.filter({ hasText: 'Active Sessions' })).toBeVisible();
});
test('should display stat card values', async ({ page }) => {
// Wait for stats to load
await page.waitForSelector('[data-testid="dashboard-stats"]');
// Stats should have numeric values (from mock data)
// Mock returns: 2 users (MOCK_USER + MOCK_SUPERUSER), 3 orgs, 45 sessions
const statsContainer = page.locator('[data-testid="dashboard-stats"]');
await expect(statsContainer).toContainText('2'); // Total users (from mock pagination.total)
await expect(statsContainer).toContainText('3'); // Organizations (from MOCK_ORGANIZATIONS.length)
await expect(statsContainer).toContainText('45'); // Sessions (from mock pagination.total)
});
});
test.describe('Admin Dashboard - Quick Actions', () => {
test.beforeEach(async ({ page }) => {
await setupSuperuserMocks(page);
// Auth already cached in storage state (loginViaUI removed for performance)
await page.goto('/en/admin');
});
test('should display quick actions section', async ({ page }) => {
await expect(page.getByText('Quick Actions')).toBeVisible();
});
test('should display all quick action cards', async ({ page }) => {
// Scope to Quick Actions section to avoid matching sidebar links
const quickActionsSection = page.locator('h2:has-text("Quick Actions")').locator('..');
// Use heading role to match only the card titles, not descriptions
await expect(
quickActionsSection.getByRole('heading', { name: 'User Management' })
).toBeVisible();
await expect(quickActionsSection.getByRole('heading', { name: 'Organizations' })).toBeVisible();
await expect(
quickActionsSection.getByRole('heading', { name: 'System Settings' })
).toBeVisible();
});
test('should navigate to users page when clicking user management', async ({ page }) => {
const userManagementLink = page.getByRole('link', { name: /User Management/i });
await Promise.all([page.waitForURL('/en/admin/users'), userManagementLink.click()]);
await expect(page).toHaveURL('/en/admin/users');
});
test('should navigate to organizations page when clicking organizations', async ({ page }) => {
// Scope to Quick Actions section to avoid matching sidebar link
const quickActionsSection = page.locator('h2:has-text("Quick Actions")').locator('..');
const organizationsLink = quickActionsSection.getByRole('link', { name: /Organizations/i });
await Promise.all([page.waitForURL('/en/admin/organizations'), organizationsLink.click()]);
await expect(page).toHaveURL('/en/admin/organizations');
});
});
test.describe('Admin Dashboard - Analytics Charts', () => {
test.beforeEach(async ({ page }) => {
await setupSuperuserMocks(page);
// Auth already cached in storage state (loginViaUI removed for performance)
await page.goto('/en/admin');
});
test('should display analytics overview section', async ({ page }) => {
await expect(page.getByText('Analytics Overview')).toBeVisible();
});
test('should display user growth chart', async ({ page }) => {
// Scroll to charts section and wait for it to load
const chartsHeading = page.getByRole('heading', { name: 'Analytics Overview' });
await chartsHeading.scrollIntoViewIfNeeded();
await page.waitForTimeout(500); // Wait for any lazy-loaded components
const userGrowthHeading = page.getByText('User Growth');
await expect(userGrowthHeading).toBeVisible({ timeout: 10000 });
await expect(page.getByText('Total and active users over the last 30 days')).toBeVisible();
});
test('should display registration activity chart', async ({ page }) => {
await expect(page.getByText('User Registration Activity')).toBeVisible();
await expect(page.getByText('New user registrations over the last 14 days')).toBeVisible();
});
test('should display organization distribution chart', async ({ page }) => {
await expect(page.getByText('Organization Distribution')).toBeVisible();
await expect(page.getByText('Member count by organization')).toBeVisible();
});
test('should display user status chart', async ({ page }) => {
await expect(page.getByText('User Status Distribution')).toBeVisible();
await expect(page.getByText('Breakdown of users by status')).toBeVisible();
});
test('should display all four charts in grid layout', async ({ page }) => {
// Scroll to charts section and wait for lazy-loaded components
const chartsHeading = page.getByRole('heading', { name: 'Analytics Overview' });
await chartsHeading.scrollIntoViewIfNeeded();
await page.waitForTimeout(500);
// All charts should be visible
const userGrowthChart = page.getByText('User Growth');
const registrationActivityChart = page.getByText('User Registration Activity');
const orgDistributionChart = page.getByText('Organization Distribution');
const userStatusChart = page.getByText('User Status Distribution');
await expect(userGrowthChart).toBeVisible({ timeout: 10000 });
await expect(registrationActivityChart).toBeVisible({ timeout: 10000 });
await expect(orgDistributionChart).toBeVisible({ timeout: 10000 });
await expect(userStatusChart).toBeVisible({ timeout: 10000 });
});
});
test.describe('Admin Dashboard - Accessibility', () => {
test.beforeEach(async ({ page }) => {
await setupSuperuserMocks(page);
// Auth already cached in storage state (loginViaUI removed for performance)
await page.goto('/en/admin');
});
test('should have proper heading hierarchy', async ({ page }) => {
// H1: Admin Dashboard
await expect(page.getByRole('heading', { level: 1, name: 'Admin Dashboard' })).toBeVisible();
// H2: Quick Actions
await expect(page.getByRole('heading', { level: 2, name: 'Quick Actions' })).toBeVisible();
// H2: Analytics Overview
await expect(page.getByRole('heading', { level: 2, name: 'Analytics Overview' })).toBeVisible();
});
test('should have accessible links for quick actions', async ({ page }) => {
// Scope to Quick Actions section to avoid matching sidebar links
const quickActionsSection = page.locator('h2:has-text("Quick Actions")').locator('..');
const userManagementLink = quickActionsSection.getByRole('link', { name: /User Management/i });
const organizationsLink = quickActionsSection.getByRole('link', { name: /Organizations/i });
const settingsLink = quickActionsSection.getByRole('link', { name: /System Settings/i });
await expect(userManagementLink).toBeVisible();
await expect(organizationsLink).toBeVisible();
await expect(settingsLink).toBeVisible();
});
});