Test Organization Standards

tests/
├── rls/                    # Row-Level Security tests
│   ├── pf-organizations.rls.test.ts
│   ├── hr-employees.rls.test.ts
│   └── fa-journal-entries.rls.test.ts
│
├── unit/                   # Unit tests (hooks, utilities, business logic)
│   ├── pf/
│   │   ├── formatting-utilities.test.ts
│   │   └── dashboard-preferences.test.tsx
│   ├── hr/
│   │   ├── useEmployees.test.ts
│   │   └── onboarding-wizard-steps.test.tsx
│   └── fa/
│       └── journal-entries.test.ts
│
├── integration/            # Integration tests (cross-component workflows)
│   ├── pf/
│   ├── hr/
│   │   └── onboarding-workflow.test.ts
│   └── fa/
│       └── budget-template-workflow.test.ts
│
├── e2e/                    # End-to-end tests (Playwright)
│   ├── auth/
│   │   └── authentication-flow.test.ts
│   ├── hr/
│   │   └── employee-management.spec.ts
│   └── fa/
│       └── financial-transactions.spec.ts
│
└── utils/                  # Test utilities and helpers
    ├── providers.tsx      # Unified test providers
    ├── test-query-client.tsx
    ├── test-data-factory.ts
    └── cleanup/            # Module-specific cleanup
        ├── pf-cleanup.ts
        ├── hr-cleanup.ts
        └── index.ts

import { describeWithSupabase, itWithSupabase } from '@/tests/setup';
import { createMultiTenantScenario } from '@/tests/utils/rls-test-helpers';

describeWithSupabase('RLS: {table_name}', () => {
  let scenario: Awaited<ReturnType<typeof createMultiTenantScenario>>;
  
  beforeAll(async () => {
    scenario = await createMultiTenantScenario();
  });
  
  describe('Read Access', () => {
    itWithSupabase('org1 admin can only see their own organization', async () => {
      // Test logic
    });
  });
  
  // ... more test cases
});

import { describe, it, expect } from 'vitest';
import { renderHook } from '@testing-library/react';
import { wrapper } from '@/tests/utils/providers';
import { useMyHook } from '@/cores/{core}/hooks/useMyHook';

describe('useMyHook', () => {
  it('should fetch data successfully', async () => {
    const { result } = renderHook(() => useMyHook(), { wrapper });
    // Test logic
  });
});

import { describe, it, expect } from 'vitest';
import { render, screen } from '@testing-library/react';
import { TestProviders } from '@/tests/utils/providers';
import { MyWorkflowComponent } from '@/cores/{core}/components/MyWorkflowComponent';

describe('{Workflow} Workflow', () => {
  it('should complete workflow successfully', async () => {
    render(
      <TestProviders>
        <MyWorkflowComponent />
      </TestProviders>
    );
    // Test workflow steps
  });
});