Files

T

Sylvain Duchesne 6f9b3ece34 Data-layer BDD testing infrastructure and steps/frontend → steps/ui rename

- Rename steps/frontend/ to steps/ui/ across all modules and shared
- Add data-layer test harness (mock + real broker modes) with Playwright
- Add inscription data-layer steps (@data scenarios)
- Add test auth setup script and browser debug script
- Update docs (architecture, BDD testing, data-layer testing)
- Add ADR for headless wallet creation decision

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-12 18:01:46 +01:00

3.3 KiB

Raw Blame History

BDD Testing

Cucumber/Gherkin BDD specs in French with multi-layer step definitions.

Overview

26 feature files (US-1 to US-26), all in French
Categories: EVENT, WORKSHOP, USER, MEETING, NOTIF
Priorities: 0 (Impossible), 1 (Haute), 2 (Moyenne), 3 (Basse)
Current results: 51 passed, 7 failed, 75 skipped (133 scenarios total)

Multi-Layer BDD

Each module has step directories for three test layers:

src/modules/event/steps/
  ui/           # UI/screen assertions (active)
  data/         # Data layer assertions
  e2e/          # Full integration (planned)

Shared steps (cross-domain) live in src/shared/steps/ui/.

Feature Files

Collocated with their module:

src/modules/event/features/us-13-creer-evenement.feature
src/modules/user/features/us-23-connexion-utilisateurs.feature
src/modules/workshop/features/us-1-visualiser-atelier-termine.feature
...

Tagged with @CATEGORY @priority-N for filtering.

Step Definitions

Shared Steps (`src/shared/steps/ui/`)

File	Purpose
`navigation.steps.ts`	Screen navigation, authentication, click/select actions, section/button/field assertions
`form.steps.ts`	Form field validation, required fields, import/duplicate detection
`screen.steps.ts`	Screen content assertions (participants, events, profiles, QR codes)

How UI Steps Work

Steps analyze screen source code (not rendered DOM):

world.ts loads screen .tsx file content via loadScreenSource()
Steps use regex patterns on JSX source to verify UI elements
screenFileMap in world.ts maps screen IDs to file paths (e.g., 'home' → 'src/modules/home/screens/HomeScreen.tsx')
screenFieldDetectors define per-screen regex patterns for field verification
screenExpectedContent lists expected text content per screen

Screen Name Resolution

French names in .feature files map to screen IDs via screenNameMap:

"accueil" → home
"détail événement" → event-detail
"mon profil" → profile
"relayer un événement" → create-event

Cucumber Configuration

cucumber.json:

{
  "default": {
    "import": [
      "src/shared/support/**/*.ts",
      "src/shared/steps/**/*.ts",
      "src/modules/*/steps/**/*.ts"
    ],
    "paths": ["src/modules/*/features/**/*.feature"],
    "language": "fr"
  }
}

Requires tsx loader: node --import tsx/esm node_modules/.bin/cucumber-js

Auto-Generated Files

Scripts in scripts/ parse features and steps into TypeScript data files consumed by the prototyping tool:

Script	Input	Output
`parse-features.ts`	`src/modules//features/.feature`	`src/shared/data/features.ts`
`parse-test-results.ts`	`reports/cucumber-report.json`	`src/shared/data/testResults.ts`
`extract-step-definitions.ts`	`src/shared/steps/ui/*.ts`	`src/shared/data/stepDefinitions.ts`

Run all: bun run test:cucumber

Data-Layer Testing

@data scenarios test through the real NextGraph broker. See data-layer-testing for full architecture.

Adding New Steps

Module-specific: Create in src/modules/{module}/steps/ui/
Cross-domain: Add to src/shared/steps/ui/
Import FestipodWorld type from ../../support/world (shared) or adjust relative path
Run bun run steps:extract to regenerate tooltip data

3.3 KiB Raw Blame History