# Feature Traceability Matrix

The agent must maintain this mapping as implementation progresses.

| Feature Area | Primary Routes/Screens | Primary UI | Domain Components | API Dependencies | Key States |
|---|---|---|---|---|---|
| Storefront | `/` | Nuxt UI layout/navigation/cards | ProductCard, PromoBanner if needed | storefront/content/products | loading, empty, error |
| Authentication | `/login`, `/register`, recovery | Nuxt UI forms/alerts | AuthForm only if needed | auth/session | validating, invalid, pending |
| Account | `/account/*` | Nuxt UI forms/tables | minimal account domain components | customer/users/addresses | loading, validation, error |
| Catalog | `/catalog/*`, `/products/*`, `/search` | Nuxt UI navigation/data/display | ProductPrice, ProductCard if needed | products/categories/brands/search | loading, empty, error |
| B2B pricing | product/catalog/cart | Nuxt UI display/badges | PriceDisplay, TierPricing | prices/promotions | unavailable, expired, changed |
| Quick order | `/quick-order` | Nuxt UI form/table | QuickOrderGrid if genuinely needed | products/prices/availability | row errors, valid rows |
| Import | `/order-import` | Nuxt UI upload/table | ImportPreview | import/products/availability | parsing, row errors |
| Cart | `/cart` | Nuxt UI table/alerts | CartItem, OrderSummary | cart/pricing | price changed, MOQ, unavailable |
| Checkout | `/checkout` | Nuxt UI forms/step/navigation | CheckoutSummary | checkout/shipping/payment | validation, changed cart |
| Payments | `/payments/:id` | Nuxt UI status/alerts/upload | PaymentInstructions | payments | pending, paid, failed |
| Orders | `/orders/*` | Nuxt UI table/timeline | OrderStatusTimeline | orders | status/error/empty |
| Shipping | order/checkout screens | Nuxt UI cards/timeline | ShipmentTimeline | shipping/tracking | pending/in transit/delivered |
| Notifications | `/notifications` | Nuxt UI list/badge | NotificationItem if needed | notifications | unread/empty/error |
| Support | support routes | Nuxt UI forms | SupportForm if needed | support/tickets | validation/error |
| Returns/refunds | order routes | Nuxt UI forms/status | ReturnRequest if needed | returns/refunds | eligibility/status |
| Customer documents | order/payment routes | Nuxt UI list/buttons | DocumentViewer if needed | documents | unavailable/loading |
| E-commerce admin | `/admin/*` | Nuxt UI dashboard/table/forms | domain-specific only | admin commerce APIs | permission/error |
| Analytics | `/admin` | Nuxt UI tables | none | analytics | no data/error |

The agent must expand this matrix into a per-feature implementation checklist and update it if approved requirements change.