soleprint/atlas/book/feature-flow/CLAUDE.md

Feature Flow Book

Purpose

Presentation showing the feature standardization pipeline.

The Pipeline

┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│  OPS TEMPLATES   │ -> │   BDD/GHERKIN    │ -> │     TESTS        │
│                  │    │                  │    │                  │
│  Non-technical   │    │  .feature files  │    │  Backend:        │
│  User flows      │    │  Given/When/Then │    │    API contracts │
│  From support    │    │  Human readable  │    │    Workflows     │
│                  │    │                  │    │  Frontend:       │
│                  │    │                  │    │    Page Objects  │
│                  │    │                  │    │    E2E specs     │
└──────────────────┘    └──────────────────┘    └──────────────────┘

Files

• index-en.html - English slide presentation (8 slides, arrow keys)
• index-es.html - Spanish slide presentation (8 slides, arrow keys)

Slides Structure

1. Title
2. Pipeline Overview (3 columns)
3. Ops Templates
4. BDD/Gherkin
5. Gherkin File Organization (best practices)
6. Backend Tests (amar_django_back structure)
7. Frontend Tests (amar_frontend structure)
8. Per-Feature Checklist

Sources

Ops Templates

• album/template/ops-flow/plantilla-flujo.md
• def/work_plan/21-plantilla-flujos-usuario.md

BDD/Gherkin Examples

• def/work_plan/10-flow-turnero.md (full gherkin + tests example)

Test Structure References

• amar_django_back/tests/contracts/README.md
• amar_frontend/tests/README.md

Editing

Edit index-en.html or index-es.html directly. Slides are <section> elements. Arrow keys to navigate.

Flow Checklist (per feature)

• Ops template filled by support team
• Convert to .feature file (Gherkin spec)
• Backend: API contract tests per endpoint
• Backend: Workflow test (composition)
• Frontend: Page Object (if new page)
• Frontend: E2E spec (Playwright)
• Wire to CI