Skip to content

Delivery Backlog And BDD Starter - 2026-02-08

Purpose

Define the first executable delivery backlog and BDD suite for the new Symfony migration program, based on the migration specification set completed on 2026-02-07 and 2026-02-08.

This document is the execution bridge between: - migration analysis/spec docs, - implementation tasks per island, - runnable BDD feature files.

Source Documents Used

  • docs/migration/00-overview.md
  • docs/migration/02-island-boundaries-and-performance.md
  • docs/migration/05-architecture-conformance-pass-2026-02-07-followup.md
  • docs/migration/06-priority-h-delivery-batch-2026-02-07.md
  • docs/migration/07-checklist-completion-summary-2026-02-07.md
  • docs/migration/08-performance-implementation-backlog-2026-02-08.md
  • docs/migration/99-missing-feature-checklist.md
  • island specs under docs/migration/webshop/, docs/migration/stock-import/, docs/migration/platform-export/, docs/migration/vehicle-data/, docs/migration/operations/, docs/migration/erp-middleware/, and docs/migration/libraries/

Execution Guardrails (Must Hold For Every Task)

  1. Max deployables stays at five: webshop, stock-import, platform-export, vehicle-data, erp-middleware.
  2. Internal shared packages stay capped at three: atraxion/contracts, atraxion/integration-sdk, atraxion/foundation.
  3. Cross-island writes use outbox/inbox + idempotency keys.
  4. Read-heavy flows use projection-first models for stock, fitment, and sets.
  5. Every H task gets at least one acceptance scenario in the BDD starter suite.

Delivery Waves

  1. Wave F0: foundation and runtime controls.
  2. Wave H1: core commerce and customer flows.
  3. Wave H2: admin high-priority surface.
  4. Wave H3: platform, supplier, queue, and cron runtime.
  5. Wave H4: vehicle, ERP, and shared integration clients.

Backlog Tasks (Start Here)

F0 - Foundation And Runtime

Task Island(s) Migration IDs Deliverable Depends On
F0-01 Bootstrap islands and quality toolchain All AR guardrails Symfony skeletons, shared coding standards, PHPStan/PHPUnit/Behat baselines none
F0-02 Shared package scaffolding Shared AR-001, AR-006 atraxion/contracts, atraxion/integration-sdk, atraxion/foundation with versioning rules F0-01
F0-03 Outbox/inbox and idempotency middleware All OP-006, CR-006 reusable message envelope, idempotency store, replay-safe handlers F0-02
F0-04 Queue topology and scheduler baseline Shared Ops OP-006, CR-005, CR-006 queue classes, worker command skeletons, overlap locks F0-03
F0-05 Observability baseline Shared Platform Concern OP-004, OP-005, OP-012 metrics, traffic capture policy, Sentry tags, heartbeat endpoint F0-01
F0-06 Projection schema and index migrations Webshop, Vehicle Data PERF-002 core projection tables/indexes from performance backlog F0-01
F0-07 Replay and reconciliation command set Shared Ops PERF-006, PERF-010 queue:replay, projection:reconcile, projection:rebuild command stubs F0-04, F0-06

H1 - Core Commerce And Customers

Task Island(s) Migration IDs Deliverable Depends On
H1-01 Customer registration and approval flow Webshop WF-002 B2B/B2C registration with tenant policy and VAT validation hooks F0-01
H1-02 Authentication, 2FA, password reset Webshop WF-003, WF-005, WF-006, DM-004 login/logout, trusted devices, reset tokens, lockout controls H1-01
H1-03 Product detail and catalog route family Webshop WF-010, WF-011, WF-012, WF-013, WF-015 canonical routing and unified filter contracts per vertical F0-06
H1-04 Set projection and set detail flow Webshop, Vehicle Data WF-014, API-010 deterministic set_key, set list/detail read model and hash validation F0-06
H1-05 Pricing hierarchy implementation Webshop DM-005 tenant override + customer margin resolution with precedence tests H1-03
H1-06 Cart and checkout pipeline Webshop WF-019 idempotent cart mutations, merge-on-login, stock recheck at place-order H1-03, H1-05
H1-07 Shipping integration Webshop INT-012, AD-003 Transsmart adapter, fallback calculator, checkout step integration H1-06
H1-08 Payment integration and callbacks Webshop WF-026, INT-013, AD-004 Pay.nl create/status/callback handling with idempotent transitions H1-06
H1-09 Order aggregate and customer history APIs Webshop OR-001, WF-021, API-005, DM-001 order lifecycle + list/detail/invoice read APIs H1-06, H1-08
H1-10 Invoice API and ERP pull-through Webshop, ERP WF-022, API-006, INT-001 invoice listing/pdf with ownership guard and ERP contract client H1-09
H1-11 Returns and RMA flows Webshop WF-023, OR-003, DM-002 return eligibility + submit/deny/received pages and persistence H1-09
H1-12 Order document security + malware workflow Webshop WF-029, OR-005, OR-006, OR-007, DM-012 tokenized portal, scan lifecycle, quarantine and notify pipeline H1-09
H1-13 EDI endpoints and alias parity Webshop API-001, API-002 /edi + /tyrestream contract-compatible processing pipeline H1-09
H1-14 Notification template core Webshop MK-001, DM-015 3-layer template resolution and render pipeline H1-01, H1-09

H2 - Admin High-Priority Surface

Task Island(s) Migration IDs Deliverable Depends On
H2-01 Admin authz baseline and role matrix Webshop Admin AD-002, AD-005 role/voter system and route guards F0-01
H2-02 Order/customer dashboards and validation queue Webshop Admin AD-002, AD-009 order overview and border-patrol state transitions H2-01, H1-09
H2-03 Tenant/channel management Webshop Admin AD-008 mini-shop and channel config management with domain mapping H2-01, H1-01
H2-04 Product master-data admin Webshop Admin AD-014, AD-017, AD-020 wheels/tyres/accessories quality, duplicates, SEO tooling H2-01, H1-03
H2-05 Coupons admin and export Webshop Admin AD-033 coupon CRUD, export, usage tracking views H2-01, H1-06
H2-06 Email template and system settings admin Webshop Admin AD-037, AD-040 template/layout CRUD + typed settings and cache actions H2-01, H1-14
H2-07 Supplier stock settings control plane Stock Import/Admin AD-011 supplier config and stock inspection linked to import runtime H2-01, H3-01
H2-08 Vehicle metadata admin Vehicle Data Admin AD-012 brand/type/logo management and publish to vehicle APIs H4-02

H3 - Platform, Supplier, Queue, Cron

Task Island(s) Migration IDs Deliverable Depends On
H3-01 Supplier import command suite Stock Import SI-001, SI-002, CR-009, CR-010 all-supplier and scoped-supplier imports with checkpoints F0-04, F0-07
H3-02 Stock normalization and export handoff Stock Import, Platform Export SI-003, CR-002 normalized stock projection and export payload contract H3-01, F0-06
H3-03 Platform updater architecture Platform Export PX-001, PX-002 adapter orchestrator and channel-specific updater dispatch F0-03, H3-02
H3-04 Platform order pull and deserialization Platform Export PX-011, PX-012, CR-008 checkpointed polling + deserializer pipeline + idempotent handoff H3-03, F0-07
H3-05 Autodoc API contract implementation Platform Export API-014, API-015, PX-013 inventory/order/status/cancel endpoints with auth and versioning H3-03
H3-06 Queue cleanup and stale processing controls Shared Ops CR-005, CR-006, OP-006 retention cleanup + stuck job restart + overlap protection F0-04

H4 - Vehicle, ERP, Shared Integrations

Task Island(s) Migration IDs Deliverable Depends On
H4-01 DriveRight client adapter package usage Vehicle Data INT-014, VD-001, CR-012 provider client, staged sync command, normalized DTOs F0-02
H4-02 Vehicle hierarchy and fitment projection Vehicle Data VD-002, API-003 brand/model/variant model + fitment projection + query APIs H4-01, F0-06
H4-03 Manual vehicle override workflow Vehicle Data Admin VD-003 manual vehicle CRUD and precedence over source data H4-02
H4-04 Webshop vehicle lookup integration Webshop WF-017, WF-018 plate lookup and fitment-driven catalog filters via Vehicle Data API H4-02, H1-03
H4-05 ERP middleware sync contracts ERP Middleware, Webshop INT-001, OR-001, OR-007 customer/order/invoice sync API+event handlers with idempotency F0-03, H1-09

Wave Exit Criteria

  1. Every H task above has at least one passing scenario in docs/migration/bdd/*.feature.
  2. No cross-island flow ships without idempotency and replay behavior.
  3. Performance gates G0 and G1 are complete before checkout/payment rollout.
  4. H1 can only be production-enabled when H1-06 to H1-10 scenarios are green.
  5. H3 and H4 rollouts require DLQ/replay operational drill evidence.

BDD Starter Suite Mapping

Feature File Main Scope Primary IDs Covered
docs/migration/bdd/00-foundation-and-ops.feature runtime reliability and operations controls OP-006, CR-005, CR-006, OP-004, OP-005, OP-012
docs/migration/bdd/01-core-commerce-h1.feature storefront/customer/order/payment core WF-002/003/005/006/010/014/019/021/022/023/026/029, API-001/002/005/006, OR-001/003/005/007
docs/migration/bdd/02-admin-h2.feature admin high-priority modules AD-002/003/004/005/008/009/014/017/020/033/037/040
docs/migration/bdd/03-platform-stock-ops-h3.feature stock import, platform runtime, cron/queue SI-001/002/003, PX-001/002/011/012/013, API-014/015, CR-002/005/006/008/009/010
docs/migration/bdd/04-vehicle-erp-integrations-h4.feature vehicle data, ERP sync, shared clients WF-017/018, API-003, VD-001/002/003, CR-012, INT-001/012/013/014

First Sprint Recommendation (Immediate Start)

  1. Execute F0-01 to F0-05 in parallel across island teams.
  2. Start H1-01, H1-03, and H1-06 once foundation CI and messaging baseline are green.
  3. Run BDD by tags @foundation and @H1 first; keep @H2/@H3/@H4 as pending target suites until underlying modules are scaffolded.