Output:
Chunk ID: dd920c
Wall time: 0.0000 seconds
Process exited with code 0
Original token count: 12677
Output:
Total output lines: 260

# Shop Build Progress

## Objective

Build a complete, self-contained Laravel shop system from `specs/*`, with implemented acceptance criteria mapped to evidence, passing automated checks, verified browser flows, independent QA, and meaningful commits.

## Current Status

- Status: in progress
- Active slice: Phase 8 - final verification and completion audit
- Started from: Laravel Livewire/Fortify starter kit with no shop domain tables or models present
- Last updated: 2026-05-04

## Phased Plan

1. Foundation: SQLite config, tenancy tables/models/factories/seeders, store resolution middleware, store scoping, admin/customer auth foundations, policies, and Phase 1 tests.
2. Catalog: product, variant, inventory, collection, media schema/models/services, admin catalog CRUD, storefront browsing, and tests.
3. Storefront theme/layout: theme/page/navigation data, storefront layout, product/collection/search/page views, and smoke browser verification.
4. Cart/checkout/pricing: cart API/UI, discount, shipping, tax, checkout state machine, and tests.
5. Payments/orders/fulfillment: mock PSP, order creation, refunds, fulfillments, customer account order views, and tests.
6. Admin panel: dashboard and all admin list/form/detail pages from Spec 03, with Livewire/Flux interactions.
7. Search/analytics/apps/webhooks: SQLite search, event aggregation, developer token/webhook UI, delivery jobs, and tests.
8. Final verification: full Pest suite, Pint, frontend build, Playwright MCP customer/admin flows, independent QA, fixes, and completion audit.

## Acceptance Checklist

| Area | Criteria Source | Status | Evidence |
| --- | --- | --- | --- |
| Database schema | `specs/01-DATABASE-SCHEMA.md` | partial | Phase 1 tenancy/auth tables, Phase 2 catalog tables, Phase 3 theme/content/navigation tables including `navigation_items.parent_id` nesting, Phase 4 cart/checkout/pricing tables, Phase 5 order/payment/fulfillment tables, and Phase 7 search/analytics/apps/webhooks/export tables are implemented: search_settings, search_queries, SQLite FTS5 `products_fts`, analytics_events, analytics_daily, apps, app_installations, oauth_clients, oauth_tokens, webhook_subscriptions, webhook_deliveries, and data_exports. |
| Routes/API | `specs/02-API-ROUTES.md` | partial | Phase 1 auth routes plus catalog/cart/order/customer/discount/content/settings/search/analytics/apps/developers UI routes exist: `/`, `/collections`, `/collections/{handle}`, `/products/{handle}`, `/cart`, `/checkout`, `/checkout/confirmation/{order}`, `/search`, `/pages/{handle}`, `/account/login`, `/account/register`, `/forgot-password`, `/reset-password/{token}`, `/account/forgot-password`, `/account/reset-password/{token}`, `/account`, `/account/orders`, `/account/orders/{order}`, `/account/addresses`, `/account/logout`, `/admin/login`, `/admin/forgot-password`, `/admin/reset-password/{token}`, `/admin/products`, `/admin/products/create`, `/admin/products/{product}/edit`, `/admin/collections`, `/admin/collections/create`, `/admin/collections/{collection}/edit`, `/admin/inventory`, `/admin/orders`, `/admin/orders/{order}`, `/admin/customers`, `/admin/customers/{customer}`, `/admin/discounts`, `/admin/discounts/create`, `/admin/discounts/{discount}/edit`, `/admin/pages`, `/admin/pages/create`, `/admin/pages/{page}/edit`, `/admin/navigation`, `/admin/themes`, `/admin/themes/{theme}/editor`, `/admin/settings`, `/admin/settings/shipping`, `/admin/settings/taxes`, `/admin/settings/checkout`, `/admin/settings/notifications`, `/admin/search/settings`, `/admin/analytics`, `/admin/apps`, `/admin/apps/{installation}`, and `/admin/developers`. Storefront REST API now includes cart line CRUD, checkout address/shipping/discount/payment-method selection, checkout payment completion, token-gated order lookup, product search, search suggestions, and analytics event ingestion under `/api/storefront/v1`. Admin REST API now includes store-scoped product/customer/order list/detail, collection CRUD, discount CRUD, content page CRUD, store settings read/update, search status/reindex endpoints, analytics summary, order export creation/status, shipping zone/rate settings, tax settings read/update, theme upload/publish/settings update, fulfillment creation, and refund creation under `/api/admin/v1/stores/{store}` with session or scoped bearer-token authentication. `/oauth/authorize`, `/oauth/token`, and `/api/apps/v1/stores/{store}` app routes are registered as explicit `501 Not Implemented` stubs per the deferred OAuth/app ecosystem scope note. |
| Admin UI | `specs/03-ADMIN-UI.md` | partial | Flux/Livewire admin shell now includes dashboard KPI/date-range reporting, analytics reporting with filters/export, catalog/product/collection/inventory management, product option matrix generation, product media upload/alt text/reorder/delete controls, order/customer/discount management, page index/form, nested navigation menu editor with drag sorting and parent selection, theme grid, theme settings editor with iframe preview, theme file list/editor, general settings, domain management, shipping zone/rate management, tax settings, checkout policy settings, notification settings, search settings/reindexing, installed app list/detail, and developer token/webhook management with auth protection and store scoping. |
| Storefront UI | `specs/04-STOREFRONT-UI.md` | partial | Storefront layout with desktop navigation and mobile hamburger flyout, home, collections index/detail, product detail, SQLite-backed search with filters/sort/pagination, breadcrumbs, price display, product cards, DB-backed pages, seeded navigation menus with one-level dropdown children, cached theme settings, product add-to-cart persistence, cart drawer, cart page with discount and shipping estimates plus stock-limit feedback, checkout address/shipping/discount/payment-selection/order-submission UI, order confirmation, customer password reset forms at the spec root paths with account-path aliases, customer account overview/navigation/logout, customer order list/detail views, and customer address book list/create/update/default/delete controls render seeded and runtime data. |
| Business logic | `specs/05-BUSINESS-LOGIC.md` | partial | `ResolveStore`, `BelongsToStore`, `StoreScope`, role checks, customer guard provider, store-scoped `CustomerPasswordResetService`, catalog product lifecycle transitions, SKU uniqueness, variant matrix rebuilding, inventory reserve/release/commit/restock, automatic variant inventory, variant option mapping, media resize/cleanup job, `SearchService` with per-store synonym expansion and stop-word removal, product observer FTS sync, search query logging, search API rate limiting, `AnalyticsService`, analytics event deduplication, daily analytics aggregation, scheduled `AggregateAnalytics`, analytics API rate limiting, `WebhookService`, timestamped HMAC signing/verification, database-queued `DeliverWebhook`, delivery logging/retry backoff metadata, webhook circuit breaker pausing, domain-event webhook dispatch listener, developer token generation backed by `oauth_tokens`, `OrderExportService`, `CartService`, `DiscountService` including one-per-customer code discount redemption checks and automatic/code order-line attribution, `ShippingCalculator`, `TaxCalculator`, `PricingEngine`, checkout transitions through completion, checkout expiration, abandoned cart cleanup, session cart lookup, cart discount handoff to checkout, customer login cart merge, product add-to-cart mutations, storefront cart stock-limit feedback for deny-policy inventory, `PaymentService`, mock PSP, idempotent order creation, checkout UI/API order submission, session/customer/token-gated order confirmation and lookup, customer order-history scoping, customer address book management, customer logout session invalidation, admin dashboard order aggregates, admin analytics reporting, admin customer address management, admin discount rule management, admin content/theme/navigation/settings/search/apps/developers orchestration, admin order UI/API action orchestration, `RefundService`, `FulfillmentService`, bank-transfer payment confirmation, and unpaid bank-transfer cancellation are implemented. |
| Auth/security | `specs/06-AUTH-AND-SECURITY.md` | partial | Admin Livewire login/logout/reset, customer guard/provider, customer login/register/logout, customer password reset GET/POST routes at `/forgot-password` and `/reset-password/{token}` with store-scoped hashed tokens, reset-link throttling, generic reset responses, login rate limiting, session hardening, concrete resource policies, encrypted app client/webhook secrets, one-time display developer token generation, and a compatible hashed bearer-token admin API middleware with store/ability enforcement are implemented. |
| Seed/test data | `specs/07-SEEDERS-AND-TEST-DATA.md` | partial | Seeders create Acme Fashion and Acme Electronics stores/domains/settings/admin access with checkout and notification defaults, 2 apps, 4 app installations, 4 OAuth clients, 4 OAuth tokens, 8 webhook subscriptions, 2 search settings rows, 25 indexed products, 60 analytics_daily rows, 210 analytics_events rows, 6 collections, 127 variants, 127 inventory rows, 206 variant option pivots, 2 themes, 6 theme files with local disk contents and metadata, 2 theme settings rows, 6 pages, 4 navigation menus, 21 navigation items including 6 child items, 2 tax settings rows, 2 shipping zones, 6 shipping rates, 6 discounts, the seeded customer, 1 default seeded customer address, and no product media/runtime carts. Order/payment seed data is still missing. |
| Browser E2E plan | `specs/08-PLAYWRIGHT-E2E-PLAN.md` | partial | Manual Playwright MCP smoke coverage has verified storefront catalog browsing on `shop.test` and `acme-fashion.test`, product detail, add-to-cart, cart drawer/page, checkout through order completion, order confirmation, customer order list/detail, SQLite-backed search and search API JSON, analytics event ingestion API, DB-backed content pages, seeded nested navigation dropdowns, admin dashboard on desktop/mobile, admin analytics, admin app list/detail, admin developers token/webhook flows, admin product/collection/inventory/order/customer/discount/content/navigation/settings/theme/search pages, admin checkout/notification settings pages, admin product media section rendering, admin analytics CSV export, admin customer address creation, admin discount creation/editing/filtering, admin page creation, admin nested navigation rendering/item creation/save, admin theme editor preview, admin theme file list/editor, admin search reindexing, admin fulfillment creation/shipping/delivery, and auth flows without console warnings/errors on successful pages. Automated Pest browser coverage now checks storefront core pages, storefront account auth/reset pages including the customer root reset paths and account aliases, authenticated admin navigation/pages/settings/theme/search/apps/developers surfaces, Suite 2 admin authentication login/validation/redirect/logout/sidebar navigation interactions, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account registration/login/orders/addresses/logout, Suite 11 inventory policy enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile flows, Suite 14 accessibility checks, and mobile storefront rendering for JavaScript errors. The remaining Spec 08 interaction/permutation browser suites are still incomplete. |
| Roadmap phases | `specs/09-IMPLEMENTATION-ROADMAP.md` | in progress | Phase 1 foundation, Phase 2 catalog data/UI, Phase 3 theme/content/navigation data with storefront consumption, Phase 4 cart/checkout/pricing backend foundation, Phase 4 storefront cart/checkout UI through `payment_selected`, the Phase 4 cart/checkout REST API surface, cart-page estimates, Phase 5 order/payment backend foundation, Phase 5 refund/fulfillment services, Phase 5 storefront order completion/customer order surfaces, Phase 5 admin order management, Phase 5 order API surfaces, Phase 6 admin dashboard/customer/discount/content/settings/theme/navigation management, Phase 7 search, Phase 7 analytics, and Phase 7 apps/webhooks are implemented. Final verification and completion audit are next. |

## Verification Evidence

- 2026-05-03: `mcp__laravel_boost__.application_info` confirmed PHP 8.4, Laravel 12.51.0, Livewire 4.1.4, Flux 2.12.0, Pest 4.3.2, SQLite.
- 2026-05-03: `mcp__laravel_boost__.database_schema(summary: true)` returned no tables for the current configured database.
- 2026-05-03: `git status --short` showed no current worktree changes before implementation.
- 2026-05-03: `mcp__laravel_boost__.search_docs` consulted Laravel 12 middleware/auth/authorization/migration docs plus Livewire 4 and Pest 4 docs before code changes.
- 2026-05-03: Planning challenger sub-agent found the repo was still a starter kit and produced the acceptance checklist by vertical slice. Risks added here: missing Sanctum dependency, password_hash/Fortify coordination, route/API absence, and E2E count inconsistencies.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed on real `database/database.sqlite` after creating the missing SQLite file.
- 2026-05-03: `php artisan test --compact` passed: 45 tests, 121 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` passed after formatting changes.
- 2026-05-03: `php artisan route:list --path=admin` showed `/admin`, `/admin/login`, `/admin/logout`; `php artisan route:list --path=account` showed `/account`, `/account/login`, `/account/register`.
- 2026-05-03: Boost schema summary confirmed Phase 1 tables: organizations, stores, store_domains, store_users, store_settings, customers, customer_password_reset_tokens, users with password_hash.
- 2026-05-03: Playwright MCP verified `http://shop.test/` loads, `http://shop.test/admin/login` renders, admin login with `admin@acme.test` / `password` reaches `/admin`, `http://shop.test/account/login` renders with no console warnings/errors after the Livewire layout fix, and customer login with `customer@acme.test` / `password` reaches `/account`.
- 2026-05-03: Independent Phase 2 QA agents reported no critical findings. High findings on lifecycle bypass, child tenant scoping, inventory store mismatch, variant option mapping, simplified seed data, and media status-only processing were addressed in the catalog data layer.
- 2026-05-03: `php artisan test --compact tests/Feature/Catalog` passed: 19 tests, 71 assertions.
- 2026-05-03: `php artisan test --compact` passed: 64 tests, 192 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` fixed import/order/spacing, followed by passing catalog and full Pest suites.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed after the Phase 2 seed update.
- 2026-05-03: Boost schema summary confirmed Phase 2 catalog tables. Boost query counts after fresh seed: stores 2, products 25, variants 127, inventory_items 127, collections 6, product_media 0, variant_option_values 206.
- 2026-05-03: `mcp__laravel_boost__.search_docs` consulted Livewire 4 full-page component routing/testing docs and Flux UI form/input/select/checkbox/button docs before catalog UI changes.
- 2026-05-03: `php artisan route:list --path=admin` showed 10 admin routes including product, collection, and inventory catalog pages. `php artisan route:list --path=collections`, `--path=products`, `--path=search`, and `--path=pages` showed storefront catalog/content routes.
- 2026-05-03: `php artisan test --compact tests/Feature/Catalog/CatalogUiTest.php` passed: 4 tests, 44 assertions.
- 2026-05-03: `php artisan test --compact tests/Feature/Catalog` passed: 23 tests, 115 assertions.
- 2026-05-03: `php artisan test --compact` passed: 68 tests, 236 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` passed after formatting catalog UI changes.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed after catalog UI test changes.
- 2026-05-03: `npm run build` passed with Vite production assets generated under ignored `public/build`.
- 2026-05-03: Playwright MCP verified `http://shop.test/`, `/collections/t-shirts`, `/products/classic-cotton-t-shirt`, `/search?q=Cotton`, `/pages/about`, `/admin/products`, `/admin/products/create`, `/admin/collections`, and `/admin/inventory` render with no console warnings/errors.
- 2026-05-03: `mcp__laravel_boost__.search_docs` consulted Laravel 12 migration/model/factory/seeder/cache docs and Pest 4 database testing docs before Phase 3 data-layer changes.
- 2026-05-03: Phase 3 explorer QA confirmed the required theme/page/navigation migrations, models, enums, factories, seeders, services, and tests; noted the spec tree-navigation mismatch because `navigation_items` has no `parent_id`.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed after adding Phase 3 migrations and seeders.
- 2026-05-03: Boost schema summaries confirmed Phase 3 tables: themes, theme_files, theme_settings, pages, navigation_menus, navigation_items. Boost query counts after fresh seed: themes 2, theme_files 6, theme_settings 2, pages 6, navigation_menus 4, navigation_items 17.
- 2026-05-03: `php artisan test --compact tests/Feature/Storefront/ThemeDataTest.php` passed: 6 tests, 31 assertions.
- 2026-05-03: `php artisan test --compact tests/Feature/Storefront tests/Feature/Catalog` passed: 29 tests, 146 assertions.
- 2026-05-03: `php artisan test --compact` passed: 74 tests, 267 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` passed after Phase 3 changes.
- 2026-05-03: `npm run build` passed after Phase 3 layout changes.
- 2026-05-03: Playwright MCP verified `http://shop.test/` renders seeded main navigation and `http://shop.test/pages/faq` renders DB-backed page content with no console warnings/errors.
- 2026-05-03: `mcp__laravel_boost__.search_docs` consulted Laravel 12 migration/job/scheduling/transaction docs and Pest 4 database testing docs before Phase 4 backend changes.
- 2026-05-03: Phase 4 explorer QA mapped the cart, checkout, discount, shipping, tax, pricing, and cleanup-job boundary; order creation/payment capture were kept for Phase 5 because order/payment tables are not implemented yet.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed after adding Phase 4 migrations and seeders.
- 2026-05-03: Boost schema summary confirmed Phase 4 tables: carts, cart_lines, checkouts, shipping_zones, shipping_rates, tax_settings, discounts. Boost query counts after fresh seed: carts 0, cart_lines 0, checkouts 0, shipping_zones 2, shipping_rates 6, tax_settings 2, discounts 6.
- 2026-05-03: `php artisan test --compact tests/Feature/Cart tests/Feature/Checkout` passed: 11 tests, 55 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` fixed checkout/pricing style and import order, then passed after job test coverage was added.
- 2026-05-03: `php artisan test --compact` passed: 85 tests, 322 assertions.
- 2026-05-03: `mcp__laravel_boost__.search_docs` consulted Livewire 4 full-page components, forms, validation, session, events, redirects, Flux modal/form controls, and Pest docs before Phase 4 cart/checkout UI changes.
- 2026-05-03: `php artisan route:list --path=cart` and `php artisan route:list --path=checkout` confirmed `/cart` and `/checkout` Livewire routes.
- 2026-05-03: `php artisan test --compact tests/Feature/Storefront/CartCheckoutUiTest.php` passed: 4 tests, 19 assertions.
- 2026-05-03: `php artisan test --compact tests/Feature/Storefront tests/Feature/Cart tests/Feature/Checkout tests/Feature/Catalog tests/Feature/Foundation/CustomerAuthTest.php` passed: 47 tests, 236 assertions.
- 2026-05-03: `vendor/bin/pint --dirty --format agent` passed after Phase 4 UI changes.
- 2026-05-03: `php artisan test --compact` passed: 89 tests, 341 assertions.
- 2026-05-03: `php artisan migrate:fresh --seed --no-interaction` passed after the Phas…2677 tokens truncated…026-05-04: `php artisan route:list --name=admin.dashboard` confirmed `/admin` is now the Livewire admin dashboard route.
- 2026-05-04: `npm run build` passed after the admin dashboard Blade changes.
- 2026-05-04: `php artisan test --compact` passed after the admin dashboard changes: 133 tests, 641 assertions.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after the admin dashboard changes.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url(path: "/admin")` resolved `http://shop.test/admin` before browser verification.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin` renders the dashboard on desktop and 390px mobile viewports with KPI cards, chart panel, top-products panel, and funnel counters; current Playwright console checks reported no warnings/errors. Boost `browser_logs` only returned older May 3 account-login warnings from a previously fixed issue.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Livewire 4 full-page/pagination/form/testing docs, Flux UI input/select/button/badge/modal/table docs, Laravel relationship aggregate docs, and Pest docs before the admin customer-management changes.
- 2026-05-04: `php artisan make:livewire Admin/Customers/Index --class --no-interaction`, `php artisan make:livewire Admin/Customers/Show --class --no-interaction`, and `php artisan make:test --pest Admin/CustomerManagementTest --no-interaction` created the admin customer slice files.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the admin customer-management changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/CustomerManagementTest.php` passed: 4 tests, 26 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin` passed after the admin customer-management changes: 11 tests, 69 assertions.
- 2026-05-04: `php artisan route:list --path=admin/customers` confirmed `admin.customers.index` and `admin.customers.show` Livewire routes.
- 2026-05-04: `npm run build` passed after the customer admin Blade/sidebar changes.
- 2026-05-04: `php artisan test --compact` passed after the admin customer-management changes: 137 tests, 667 assertions.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after the admin customer-management changes.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url(path: "/admin/customers")` resolved `http://shop.test/admin/customers` before browser verification.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin/customers` renders the customer table, seeded customer detail renders at `/admin/customers/1`, and the address modal creates a default address; current Playwright console checks reported no warnings/errors.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Livewire 4 full-page/forms/security/testing/persistent-middleware docs, Flux UI radio/checkbox/input/select/button/badge/table/switch docs, Laravel validation/authorization/email-verification docs, Fortify email-verification docs, and Pest docs before the admin discount-management changes.
- 2026-05-04: `php artisan make:livewire Admin/Discounts/Index --class --no-interaction`, `php artisan make:livewire Admin/Discounts/Form --class --no-interaction`, and `php artisan make:test --pest Admin/DiscountManagementTest --no-interaction` created the admin discount slice files.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the admin discount-management changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/DiscountManagementTest.php` passed: 8 tests, 58 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Checkout/PricingServicesTest.php` passed after automatic discount pricing changes: 5 tests, 23 assertions.
- 2026-05-04: `php artisan route:list --name=admin.discounts` confirmed `admin.discounts.index`, `admin.discounts.create`, and `admin.discounts.edit` Livewire routes.
- 2026-05-04: `npm run build` passed after the discount admin Blade/sidebar changes.
- 2026-05-04: `php artisan test --compact` passed after the admin discount-management changes: 147 tests, 733 assertions.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after browser verification to restore the local SQLite database to seeded fixtures.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url(path: "/admin/discounts")` resolved `http://shop.test/admin/discounts` before browser verification.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin/discounts` renders seeded discounts, `/admin/discounts/create` saves a browser-created active code discount through Livewire, the status switch label updates live, `/admin/discounts/{discount}/edit` renders the saved rule controls, search filters to the created discount, the type filter updates the table, Livewire update requests return 200, and current Playwright console checks report no warnings/errors.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Livewire 4 full-page/forms/testing docs, Flux UI input/select/textarea/checkbox/radio/button/table/switch docs, Laravel validation docs, and Pest docs before the admin content/settings/theme/navigation changes.
- 2026-05-04: `php artisan make:livewire` created `Admin/Settings/Index`, `Admin/Settings/Shipping`, `Admin/Settings/Taxes`, `Admin/Pages/Index`, `Admin/Pages/Form`, `Admin/Navigation/Index`, `Admin/Themes/Index`, and `Admin/Themes/Editor`; `php artisan make:test --pest` created `Admin/ContentManagementTest` and `Admin/SettingsManagementTest`.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the admin content/settings/theme/navigation changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/ContentManagementTest.php` passed: 5 tests, 38 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/SettingsManagementTest.php` passed: 4 tests, 29 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin` passed after the admin content/settings/theme/navigation changes: 28 tests, 194 assertions.
- 2026-05-04: `php artisan route:list --name=admin.pages`, `--name=admin.navigation`, `--name=admin.themes`, and `--name=admin.settings` confirmed 9 new Livewire admin routes for pages, navigation, themes, and settings.
- 2026-05-04: `npm run build` passed after the admin content/settings/theme/navigation Blade/sidebar changes.
- 2026-05-04: `php artisan test --compact` passed after the admin content/settings/theme/navigation changes: 156 tests, 800 assertions.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after browser verification to restore the local SQLite database to seeded fixtures.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url(path: "/admin/pages")` resolved `http://shop.test/admin/pages` before browser verification.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin/pages`, `/admin/pages/create`, `/admin/navigation`, `/admin/settings`, `/admin/settings/shipping`, `/admin/settings/taxes`, `/admin/themes`, and `/admin/themes/1/editor`; browser smoke saved a page, added/saved a navigation item, rendered settings/shipping/tax pages, rendered the theme editor iframe preview, and current Playwright console checks reported no warnings/errors. Boost `browser_logs` only returned older May 3 account-login warnings from a previously fixed issue.
- 2026-05-04: `mcp__laravel_boost__.application_info` and schema summary reconfirmed Laravel 12.51.0/PHP 8.4/Livewire 4.1.4/Flux 2.12.0/Pest 4.3.2/SQLite and showed search/analytics/app tables were still missing before the search slice.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 search/rate limiting/JSON API/scheduling docs, Livewire 4 forms/testing docs, Flux UI input/table/badge docs, and Pest 4 JSON testing docs before the search changes.
- 2026-05-04: `php artisan make:model`, `make:migration`, `make:class`, `make:observer`, `make:controller`, `make:request`, `make:resource`, `make:livewire`, and `make:test --pest` created the search settings/query models, FTS migration, search service, product observer, storefront search API classes, admin search settings component, and search tests.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the search changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Search/SearchServiceTest.php tests/Feature/Api/StorefrontSearchApiTest.php tests/Feature/Admin/SearchSettingsTest.php` passed: 10 tests, 46 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Api tests/Feature/Search tests/Feature/Admin/SearchSettingsTest.php tests/Feature/Catalog/CatalogUiTest.php` passed: 25 tests, 201 assertions.
- 2026-05-04: `php artisan route:list --path=api/storefront/v1/search --except-vendor` confirmed `GET /api/storefront/v1/search` and `GET /api/storefront/v1/search/suggest`; `php artisan route:list --path=admin/search` confirmed `GET /admin/search/settings`.
- 2026-05-04: `npm run build` passed after the search Blade/sidebar changes.
- 2026-05-04: `php artisan test --compact` passed after the search changes: 166 tests, 846 assertions.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after the search changes; Boost query counts after browser smoke: search_settings 2, search_queries 2, products_fts 25.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url` resolved `http://shop.test/search?q=Cotton`, `http://shop.test/api/storefront/v1/search?q=Cotton`, and `http://shop.test/admin/search/settings` before browser verification.
- 2026-05-04: Playwright MCP verified the SQLite-backed storefront search page shows 5 Cotton results with filters, the storefront search API returns JSON product/facet data for Cotton, and admin search settings renders and rebuilds the index for 20 products; current Playwright console checks reported no warnings/errors. Boost `browser_logs` only returned older May 3 account-login warnings from a previously fixed issue.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 migration/validation/rate limiting/scheduling/aggregation docs, Livewire 4 form/testing docs, Flux UI select/button/table/badge docs, and Pest 4 docs before the analytics changes.
- 2026-05-04: `php artisan make:enum`, `make:model`, `make:seeder`, `make:class`, `make:job`, `make:controller`, `make:request`, `make:livewire`, and `make:test --pest` created the analytics event enum, models, migrations, seeders, service, aggregation job, storefront analytics API classes, admin analytics component, and analytics tests.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` fixed import/order spacing after the analytics changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Analytics/AnalyticsServiceTest.php tests/Feature/Api/StorefrontAnalyticsApiTest.php tests/Feature/Admin/AnalyticsDashboardTest.php` passed: 7 tests, 35 assertions.
- 2026-05-04: `php artisan route:list --path=api/storefront/v1/analytics --except-vendor` confirmed `POST /api/storefront/v1/analytics/events`; `php artisan route:list --path=admin/analytics` confirmed `GET /admin/analytics`.
- 2026-05-04: `php artisan schedule:list` confirmed `App\Jobs\AggregateAnalytics` is scheduled daily at 01:00 UTC.
- 2026-05-04: `php artisan test --compact tests/Feature/Api tests/Feature/Analytics tests/Feature/Admin/AnalyticsDashboardTest.php tests/Feature/Admin/DashboardTest.php` passed: 24 tests, 185 assertions.
- 2026-05-04: `npm run build` passed after the analytics Blade/sidebar changes.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after the analytics changes.
- 2026-05-04: `php artisan test --compact` passed after the analytics changes: 173 tests, 881 assertions.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url` resolved `http://shop.test/admin/analytics` and `http://shop.test/api/storefront/v1/analytics/events` before browser verification.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin/analytics` renders metrics, charts, top referrers, and CSV export; browser fetch to `/api/storefront/v1/analytics/events` returned 202 with 1 accepted event and current Playwright console checks reported no warnings/errors. Boost `browser_logs` only returned older May 3 account-login warnings from a previously fixed issue.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after browser verification to restore seeded fixtures; Boost query counts after reset: analytics_daily 60, analytics_events 210, search_settings 2, products_fts 25.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 HTTP client, queue, validation, events, and testing docs plus Livewire 4, Flux UI, and Pest 4 docs before the apps/webhooks changes.
- 2026-05-04: `php artisan make:enum`, `make:model`, `make:seeder`, `make:class`, `make:job`, `make:listener`, `make:livewire`, and `make:test --pest` created the app/webhook enums, models, migrations, seeders, webhook service/job/listener, admin apps/developers components, and tests.
- 2026-05-04: `php artisan test --compact tests/Feature/Webhooks/WebhookSignatureTest.php tests/Feature/Webhooks/WebhookDeliveryTest.php tests/Feature/Admin/AppsDevelopersTest.php` passed: 9 tests, 28 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Webhooks tests/Feature/Admin/AppsDevelopersTest.php tests/Feature/Orders tests/Feature/Catalog/ProductServiceTest.php tests/Feature/Admin/AnalyticsDashboardTest.php` passed: 33 tests, 136 assertions.
- 2026-05-04: `php artisan route:list --path=admin/apps` confirmed `/admin/apps` and `/admin/apps/{installation}`; `php artisan route:list --path=admin/developers` confirmed `/admin/developers`; `php artisan event:list` confirmed `DispatchWebhooks` registered for order, refund, fulfillment, and product status events.
- 2026-05-04: Boost query counts after seed confirmed apps 2, app_installations 4, oauth_clients 4, oauth_tokens 4, webhook_subscriptions 8, and webhook_deliveries 0.
- 2026-05-04: `npm run build` passed after the apps/developers Blade/sidebar changes.
- 2026-05-04: Playwright MCP verified `http://shop.test/admin/apps`, `/admin/apps/1`, and `/admin/developers`; browser smoke generated a one-time API token, created a webhook subscription, and current Playwright console checks reported no warnings/errors. Boost `browser_logs` only returned older May 3 account-login warnings from a previously fixed issue.
- 2026-05-04: `php artisan test --compact` passed after the apps/webhooks changes: 182 tests, 909 assertions.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the apps/webhooks changes.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after browser verification and full tests to restore seeded fixtures.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 password reset, notification, validation, and rate limiting docs plus Livewire 4, Flux UI, and Pest 4 docs before the customer password reset gap fix.
- 2026-05-04: `php artisan make:class Services/CustomerPasswordResetService --no-interaction`, `php artisan make:notification CustomerResetPassword --no-interaction`, `php artisan make:livewire Storefront/Account/Auth/ForgotPassword --class --no-interaction`, `php artisan make:livewire Storefront/Account/Auth/ResetPassword --class --no-interaction`, and `php artisan make:test Auth/CustomerPasswordResetTest --pest --no-interaction` created the customer password reset service, notification, Livewire pages, and tests.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` fixed formatting after the customer password reset changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth/CustomerPasswordResetTest.php` passed: 5 tests, 31 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth/CustomerPasswordResetTest.php tests/Feature/Auth/PasswordResetTest.php tests/Feature/Foundation/CustomerAuthTest.php` passed: 12 tests, 55 assertions.
- 2026-05-04: `php artisan test --compact` passed after the customer password reset changes: 187 tests, 940 assertions.
- 2026-05-04: `php artisan route:list | rg "account/(forgot|reset)| forgot-password | reset-password"` confirmed customer reset routes under `/account/*` and existing Fortify reset routes at the root paths remain registered separately.
- 2026-05-04: `npm run build` passed after the customer password reset Blade changes.
- 2026-05-04: Playwright MCP verified `http://shop.test/account/forgot-password` renders in a fresh browser session, submits an unknown email through Livewire, shows the generic reset-link response, and reports no current console warnings/errors.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Livewire 4 file upload/testing docs, Flux file input docs, Laravel file validation/storage testing docs, and Pest 4 docs before the product media admin UI changes.
- 2026-05-04: `php artisan make:test Admin/ProductMediaManagementTest --pest --no-interaction` created focused product media management coverage.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding product form media upload code.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/ProductMediaManagementTest.php` passed: 4 tests, 24 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin/ProductMediaManagementTest.php tests/Feature/Catalog/MediaProcessingTest.php tests/Feature/Catalog/CatalogUiTest.php` passed: 9 tests, 81 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Admin` passed after the product media UI changes: 41 tests, 246 assertions.
- 2026-05-04: `php artisan test --compact` passed after the product media UI changes: 191 tests, 964 assertions.
- 2026-05-04: `npm run build` passed after the product media Blade changes.
- 2026-05-04: `mcp__laravel_boost__.get_absolute_url(path: "/admin/products/1/edit")` resolved `http://shop.test/admin/products/1/edit`; Playwright MCP verified the product edit page renders the Media section and current console checks report no warnings/errors.
- 2026-05-04: `php artisan migrate:fresh --seed --no-interaction` passed after product media browser verification to restore seeded fixtures.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 query/JSON testing docs and Pest 4 dataset/testing docs before the discount redemption-history changes.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the discount service/order allocation changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Checkout/PricingServicesTest.php tests/Feature/Orders/OrderServiceTest.php` passed: 11 tests, 63 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Checkout tests/Feature/Orders tests/Feature/Api/StorefrontCheckoutApiTest.php tests/Feature/Storefront/CartCheckoutUiTest.php` passed after the discount redemption-history changes: 33 tests, 196 assertions.
- 2026-05-04: `php artisan test --compact` passed after the discount redemption-history changes: 192 tests, 966 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 query/database docs and Pest 4 testing docs before the search synonym/stop-word parser changes.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the search synonym/stop-word parser changes.
- 2026-05-04: `php artisan test --compact tests/Feature/Search/SearchServiceTest.php` passed after the search synonym/stop-word parser changes: 5 tests, 15 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Search/SearchServiceTest.php tests/Feature/Api/StorefrontSearchApiTest.php tests/Feature/Admin/SearchSettingsTest.php` passed after the search synonym/stop-word parser changes: 12 tests, 50 assertions.
- 2026-05-04: `php artisan test --compact` passed after the search synonym/stop-word parser changes: 194 tests, 970 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Laravel 12 database/JSON testing docs and Pest 4 docs before the automatic discount attribution changes.


/bin/zsh
-lc
tail -n 160 specs/progress.md

- 2026-05-04: `php artisan test --compact tests/Feature/Auth/PasswordResetTest.php tests/Feature/Auth/CustomerPasswordResetTest.php` passed after adding admin password reset aliases: 10 tests, 45 assertions.
- 2026-05-04: `php artisan route:list --path=admin/forgot-password` and `php artisan route:list --path=admin/reset-password` confirmed the admin forgot-password and reset-password GET/POST routes.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth` passed after adding admin password reset aliases: 24 tests, 78 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding admin password reset aliases: 245 tests, 1456 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Fortify password reset route/view docs, Livewire full-page route docs, and Pest browser testing docs before moving customer password reset to the spec root paths.
- 2026-05-04: `php artisan make:controller Storefront/Account/Auth/CustomerPasswordResetController --no-interaction`, `php artisan make:request Storefront/Auth/RequestCustomerPasswordResetRequest --no-interaction`, and `php artisan make:request Storefront/Auth/ResetCustomerPasswordRequest --no-interaction` created the standard POST route handlers and validation requests for customer password reset.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the customer password reset route changes.
- 2026-05-04: `php artisan route:list` confirmed customer reset routes at `/forgot-password`, `POST /forgot-password`, `/reset-password/{token}`, and `POST /reset-password`, while Fortify's generic user reset routes remain available under `/user/forgot-password` and `/user/reset-password/{token}`.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth/CustomerPasswordResetTest.php tests/Feature/Auth/PasswordResetTest.php` passed after moving customer reset to the spec root paths: 11 tests, 58 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php` passed after adding browser smoke coverage for the customer root reset pages and account aliases: 4 tests, 66 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth` passed after moving customer reset to the spec root paths: 25 tests, 91 assertions.
- 2026-05-04: `php artisan test --compact` passed after moving customer reset to the spec root paths: 246 tests, 1473 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing and Laravel auth/session testing docs before adding the Spec 08 admin authentication browser suite.
- 2026-05-04: `php artisan make:test Browser/Admin/AuthenticationTest --pest --no-interaction` created the admin authentication browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the admin authentication browser suite and admin logout route fix.
- 2026-05-04: `php artisan test --compact tests/Browser/Admin/AuthenticationTest.php` passed for the new Suite 2 admin auth browser coverage: 10 tests, 54 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php` passed after adding the admin auth suite: 14 tests, 120 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding the admin auth browser suite: 256 tests, 1527 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing and Laravel database seeding docs before adding the Spec 08 storefront browsing browser suite.
- 2026-05-04: `php artisan make:test Browser/Storefront/BrowsingTest --pest --no-interaction` created the storefront browsing browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the storefront browsing browser suite.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/BrowsingTest.php` passed for the new Suite 7 storefront browsing coverage: 15 tests, 56 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php` passed after adding the storefront browsing suite: 29 tests, 176 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding the storefront browsing browser suite: 271 tests, 1583 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Livewire form submission, Flux input, and Laravel database seeding docs before adding the Spec 08 cart-flow browser suite and aligning discount fixtures.
- 2026-05-04: `php artisan make:test Browser/Storefront/CartTest --pest --no-interaction` created the cart-flow browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the cart browser suite, spec discount fixtures, and cart/checkout copy updates.
- 2026-05-04: `php art…24546 chars truncated…al, multi-product carts, subtotal/total display, valid/invalid/expired/maxed/free-shipping/fixed discount code handling, domestic/international checkout shipping, checkout discount carryover, address validation, empty-cart checkout protection, credit-card/PayPal/bank-transfer order completion, payment decline handling, payment-method UI switching, customer registration validation, customer login validation, account auth redirects, customer order history/detail, address book create/update, customer logout, deny-policy sold-out blocking, continue-policy backorder add-to-cart, in-stock status display, deny-policy cart stock-limit feedback, storefront product/collection/search store isolation, admin product/order store isolation, customer account store isolation, mobile hamburger navigation, mobile product/cart/checkout flows, mobile collection filtering, tablet admin login/sidebar navigation, console-clean home/cart pages, heading hierarchy, form labels, product image placeholder accessible text, checkout error linkage, keyboard navigation, and search input labeling.
- Pest's per-visit browser `host` option is temporary, so host-sensitive storefront browser tests set the Playwright host for the whole test lifecycle to keep clicked absolute URLs resolving through `shop.test`.
- The discount seeder now includes the Spec 07/08 codes `WELCOME10`, `FLAT5`, `FREESHIP`, `EXPIRED20`, and `MAXED` while preserving the earlier implementation/test fixture codes `SAVE10` and `5OFF`.
- Expired discount codes return an expired validation message before the generic non-active status message so storefront/cart validation can present the expected customer-facing error.
- Shipping seed data now follows the Spec 07/08 checkout fixtures: `Domestic` covers Germany with `Standard Shipping` at 4.99 EUR, while `International` covers AT/CH/US/GB/CA/AU with a 14.99 EUR international rate.
- Storefront seeded tax settings use tax-inclusive pricing so checkout browser totals match the storefront spec examples while tax amounts remain visible as extracted totals.
- The checkout payment UI keeps the existing service-backed reservation path internally, but the browser-facing action is a single payment button (`Pay now`, `Pay with PayPal`, or `Place order`) that calls `placeOrder()`.
- The seeded customer now has a deterministic default `Home` address so account address-book flows and browser tests have a stable read/edit fixture without seeding runtime orders.
- The storefront mobile menu uses a Flux modal flyout with regular `wire:navigate` links; `flux:modal.close` is only used for Flux's own close button because wrapping plain anchors produced Flux JS errors in browser tests.
- Product detail placeholders use `role="img"` and descriptive `aria-label` text until seeded media is available, and the checkout email field has an explicit `aria-describedby` target for validation errors.

## Open Issues

- Full automated browser interaction/permutation suites from Spec 08 are still incomplete beyond the expanded Pest browser smoke coverage, Suite 2 admin authentication, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account flow, Suite 11 inventory enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile, and Suite 14 accessibility.
- The full suite now needs a higher PHP memory limit when all browser suites run in one process; the default `php artisan test --compact` command hits 128 MB in Pest's browser WebSocket client, while `php -d memory_limit=512M vendor/bin/pest --compact` passes.

## Completion Summary

Not complete. Phase 1 foundation, Phase 2 catalog data/UI surfaces, product media processing/admin upload controls, Phase 3 storefront theme/content/navigation data, the Phase 4 cart/checkout/pricing backend foundation, cart/checkout storefront UI through order completion, cart-page estimates, cart/checkout REST APIs, Phase 5 order/payment backend foundation, Phase 5 refund/fulfillment services, customer account order/address/logout views, admin dashboard/order/customer/discount/content/settings/theme-file/navigation/search/analytics/apps/developers management, storefront search and analytics APIs, product/customer/collection/discount/content page/store settings/search/analytics/shipping/tax/theme/order/export API surfaces, deferred OAuth/app route stubs, expanded automated browser smoke coverage, Suite 2 admin authentication browser coverage, Suite 7 storefront browsing browser coverage, Suite 8 cart-flow browser coverage, Suite 9 checkout-flow browser coverage, Suite 10 customer-account browser coverage, Suite 11 inventory-enforcement browser coverage, Suite 12 tenant-isolation browser coverage, Suite 13 responsive/mobile browser coverage, Suite 14 accessibility browser coverage, outbound webhook delivery foundations, spec-root customer password reset routes, and representative database CHECK constraint coverage are implemented, with the remaining full browser-suite gap tracked above.


Output:
Chunk ID: 9c2de8
Wall time: 0.0000 seconds
Process exited with code 0
Original token count: 8637
Output:
- 2026-05-04: `php artisan test --compact tests/Feature/Auth/PasswordResetTest.php tests/Feature/Auth/CustomerPasswordResetTest.php` passed after adding admin password reset aliases: 10 tests, 45 assertions.
- 2026-05-04: `php artisan route:list --path=admin/forgot-password` and `php artisan route:list --path=admin/reset-password` confirmed the admin forgot-password and reset-password GET/POST routes.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth` passed after adding admin password reset aliases: 24 tests, 78 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding admin password reset aliases: 245 tests, 1456 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Fortify password reset route/view docs, Livewire full-page route docs, and Pest browser testing docs before moving customer password reset to the spec root paths.
- 2026-05-04: `php artisan make:controller Storefront/Account/Auth/CustomerPasswordResetController --no-interaction`, `php artisan make:request Storefront/Auth/RequestCustomerPasswordResetRequest --no-interaction`, and `php artisan make:request Storefront/Auth/ResetCustomerPasswordRequest --no-interaction` created the standard POST route handlers and validation requests for customer password reset.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after the customer password reset route changes.
- 2026-05-04: `php artisan route:list` confirmed customer reset routes at `/forgot-password`, `POST /forgot-password`, `/reset-password/{token}`, and `POST /reset-password`, while Fortify's generic user reset routes remain available under `/user/forgot-password` and `/user/reset-password/{token}`.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth/CustomerPasswordResetTest.php tests/Feature/Auth/PasswordResetTest.php` passed after moving customer reset to the spec root paths: 11 tests, 58 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php` passed after adding browser smoke coverage for the customer root reset pages and account aliases: 4 tests, 66 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Auth` passed after moving customer reset to the spec root paths: 25 tests, 91 assertions.
- 2026-05-04: `php artisan test --compact` passed after moving customer reset to the spec root paths: 246 tests, 1473 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing and Laravel auth/session testing docs before adding the Spec 08 admin authentication browser suite.
- 2026-05-04: `php artisan make:test Browser/Admin/AuthenticationTest --pest --no-interaction` created the admin authentication browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the admin authentication browser suite and admin logout route fix.
- 2026-05-04: `php artisan test --compact tests/Browser/Admin/AuthenticationTest.php` passed for the new Suite 2 admin auth browser coverage: 10 tests, 54 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php` passed after adding the admin auth suite: 14 tests, 120 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding the admin auth browser suite: 256 tests, 1527 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing and Laravel database seeding docs before adding the Spec 08 storefront browsing browser suite.
- 2026-05-04: `php artisan make:test Browser/Storefront/BrowsingTest --pest --no-interaction` created the storefront browsing browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the storefront browsing browser suite.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/BrowsingTest.php` passed for the new Suite 7 storefront browsing coverage: 15 tests, 56 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php` passed after adding the storefront browsing suite: 29 tests, 176 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding the storefront browsing browser suite: 271 tests, 1583 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Livewire form submission, Flux input, and Laravel database seeding docs before adding the Spec 08 cart-flow browser suite and aligning discount fixtures.
- 2026-05-04: `php artisan make:test Browser/Storefront/CartTest --pest --no-interaction` created the cart-flow browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the cart browser suite, spec discount fixtures, and cart/checkout copy updates.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/CartTest.php` passed for the new Suite 8 cart-flow browser coverage: 12 tests, 53 assertions.
- 2026-05-04: `php artisan test --compact tests/Feature/Storefront/CartCheckoutUiTest.php tests/Feature/Api/StorefrontCheckoutApiTest.php tests/Feature/Checkout/PricingServicesTest.php` passed after aligning discount fixtures and cart/checkout copy: 13 tests, 91 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php` passed after adding the cart suite: 41 tests, 229 assertions.
- 2026-05-04: `php artisan test --compact` passed after adding the cart-flow browser suite: 283 tests, 1636 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Livewire form validation/submission, and Laravel database seeding docs before adding the Spec 08 checkout-flow browser suite and aligning shipping/tax fixtures.
- 2026-05-04: `php artisan make:test Browser/Storefront/CheckoutTest --pest --no-interaction` created the checkout-flow browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the checkout browser suite, domestic/international shipping fixtures, tax-inclusive storefront defaults, and checkout payment/confirmation UI updates.
- 2026-05-04: `php artisan test --compact tests/Feature/Storefront/CartCheckoutUiTest.php tests/Feature/Api/StorefrontCheckoutApiTest.php tests/Feature/Api/AdminShippingSettingsApiTest.php tests/Feature/Api/AdminTaxSettingsApiTest.php` passed after the shipping/tax checkout changes: 13 tests, 119 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/CheckoutTest.php` passed for the new Suite 9 checkout-flow browser coverage: 13 tests, 90 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php` passed after adding the checkout suite: 54 tests, 319 assertions.
- 2026-05-04: `php artisan test --compact` reached the expanded browser section but failed in Pest's browser WebSocket client at PHP's 128 MB memory limit; `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after the checkout-flow browser suite: 296 tests, 1726 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Laravel customer-guard auth/session logout, Livewire validation/form submission, Flux form/button/select, and Tailwind/Flux dark-mode docs before adding the Spec 08 customer-account browser suite and address book UI.
- 2026-05-04: `php artisan make:livewire Storefront/Account/Addresses/Index --class --no-interaction`, `php artisan make:test Storefront/CustomerAccountTest --pest --no-interaction`, and `php artisan make:test Browser/Storefront/CustomerAccountTest --pest --no-interaction` created the customer address component plus focused feature and browser suites.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding customer account routes, address book UI, seeded default customer address, and Suite 10 browser tests.
- 2026-05-04: `php artisan test --compact tests/Feature/Storefront/CustomerAccountTest.php tests/Feature/Storefront/OrderViewsTest.php tests/Feature/Foundation/CustomerAuthTest.php` passed after customer account changes: 13 tests, 69 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/CustomerAccountTest.php` passed for the new Suite 10 customer-account browser coverage: 12 tests, 67 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php` passed after adding Suite 10: 66 tests, 386 assertions.
- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 10: 314 tests, 1823 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Livewire form action/validation testing, and Laravel transaction/testing docs before adding the Spec 08 inventory browser suite and cart stock-limit feedback.
- 2026-05-04: `php artisan make:test Browser/Storefront/InventoryTest --pest --no-interaction` created the inventory browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding cart stock-limit feedback and the inventory browser suite.
- 2026-05-04: `php artisan test --compact tests/Feature/Storefront/CartCheckoutUiTest.php tests/Feature/Cart/CartServiceTest.php tests/Feature/Catalog/InventoryServiceTest.php` passed after the inventory slice: 11 tests, 60 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/InventoryTest.php` passed for the new Suite 11 inventory browser coverage: 4 tests, 21 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php tests/Browser/Storefront/InventoryTest.php` passed after adding Suite 11: 70 tests, 407 assertions.
- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 11: 319 tests, 1846 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, host/session auth testing, and Laravel database testing docs before adding the Spec 08 tenant-isolation browser suite.
- 2026-05-04: `php artisan make:test Browser/Storefront/TenantIsolationTest --pest --no-interaction` created the tenant-isolation browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the tenant-isolation browser suite.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/TenantIsolationTest.php` passed for the new Suite 12 tenant-isolation browser coverage: 5 tests, 37 assertions.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php tests/Browser/Storefront/InventoryTest.php tests/Browser/Storefront/TenantIsolationTest.php` passed after adding Suite 12: 75 tests, 444 assertions.
- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 12: 324 tests, 1883 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Flux modal, Pest browser viewport, and Tailwind responsive docs before adding the Spec 08 responsive/mobile browser suite and storefront mobile navigation flyout.
- 2026-05-04: `php artisan make:test Browser/Storefront/ResponsiveTest --pest --no-interaction` created the responsive browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the responsive browser suite.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/ResponsiveTest.php` passed for the new Suite 13 responsive/mobile browser coverage: 8 tests, 46 assertions.
- 2026-05-04: `npm run build` passed after the storefront mobile navigation Blade/Tailwind changes.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php tests/Browser/Storefront/InventoryTest.php tests/Browser/Storefront/TenantIsolationTest.php tests/Browser/Storefront/ResponsiveTest.php` passed after adding Suite 13: 83 tests, 490 assertions.
- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 13: 332 tests, 1929 assertions.
- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser accessibility/ARIA/keyboard docs and Livewire/Flux form-label docs before adding the Spec 08 accessibility browser suite and related Blade accessibility fixes.
- 2026-05-04: `php artisan make:test Browser/Storefront/AccessibilityTest --pest --no-interaction` created the accessibility browser test, which was moved into the Spec 08 browser directory structure.
- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the accessibility browser suite and Blade accessibility fixes.
- 2026-05-04: `php artisan test --compact tests/Browser/Storefront/AccessibilityTest.php` passed for the new Suite 14 accessibility browser coverage: 11 tests, 42 assertions.
- 2026-05-04: `npm run build` passed after the storefront accessibility Blade changes.
- 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php tests/Browser/Storefront/InventoryTest.php tests/Browser/Storefront/TenantIsolationTest.php tests/Browser/Storefront/ResponsiveTest.php tests/Browser/Storefront/AccessibilityTest.php` passed after adding Suite 14: 94 tests, 532 assertions.
- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 14: 343 tests, 1971 assertions.

## Decisions

- Follow the roadmap order strictly. Phase 1 is required before catalog, checkout, admin, storefront, and QA flows can be meaningfully implemented.
- Preserve the starter Fortify conventions where they do not conflict with the shop specs.
- Use integer minor units for all money columns and JSON text columns cast through Eloquent as specified.
- Keep `password_hash` as the database column for admin users and customers while exposing `password`/`getAuthPassword()` at the model layer for Fortify/Laravel auth compatibility.
- Seed both `shop.test` and `acme-fashion.test` as storefront domains for the first store so the goal URL and E2E spec URL can both resolve.
- Herd needs a site link for non-project-folder aliases; `acme-fashion.test` is linked to the same local project path as `shop.test` so the seeded domain can be verified in browser E2E flows.
- Customer Livewire auth components persist `storeId` from the initial storefront request because Livewire update requests do not run through the original storefront route middleware.
- The seed specification contains an arithmetic conflict: Acme Fashion's per-product variant table sums to 117 variants, while the prose says 107. The implementation follows the concrete per-product table, resulting in 117 Fashion variants and 10 Electronics variants, 127 total.
- Child catalog models without a `store_id` column are tenant-scoped through their parent product relationship. Inventory keeps its denormalized `store_id` and enforces that it matches the variant product store at save time.
- Storefront content pages now resolve from the `pages` table and only published pages are rendered.
- The catalog admin form intentionally blocks active products without a priced variant and duplicate in-store SKUs during UI edits, mirroring service-layer invariants where the current CRUD surface touches product variants directly.
- The product admin form generates variant rows from the option cartesian product, preserves matching variant edits by option combination, and syncs product option values plus variant pivots on save; stale variants are deleted or archived if order-line history exists.
- Navigation items use a nullable `parent_id` for one-level storefront dropdowns; `NavigationService::buildTree()` groups items recursively by parent while the admin editor enforces top-level parents for child items.
- Cart, checkout, and pricing runtime records are not seeded; only deterministic tax, shipping, and discount configuration is seeded. Runtime carts/checkouts are created by services and tests.
- The cart drawer reads the current session/customer cart without creating an empty cart on every storefront render; carts are created on first add-to-cart or checkout/cart service mutation.
- The checkout UI reserves inventory by selecting a payment method, then submits payment through `CheckoutService::completeCheckout()` so failed card payments can release reservations and return customers to payment selection.
- Order confirmation access is allowed for the authenticated owning customer or for the session that just placed the order via `last_order_id`.
- Customer account order list/detail routes use the `customer` guard and reload orders through explicit store/customer constraints.
- The cart REST API exposes `cart_version` as the public optimistic concurrency field while the service layer keeps its `expectedVersion` argument; `expected_version` remains accepted as a compatibility alias in API requests.
- Cart page discount codes are validated with `DiscountService`, saved in session, and applied to the checkout when the customer proceeds.
- Admin discount forms persist minimum purchase, product eligibility, collection eligibility, and `one_per_customer` in the existing `discounts.rules_json` keys consumed by `DiscountService`; code discounts now check customer order-line allocation history before allowing another use.
- `PricingEngine` applies an explicit checkout discount code first, then active automatic discounts returned by `DiscountService`.
- Order creation replays the same code-then-automatic discount sequence in memory so `order_lines.discount_allocations_json` keeps separate `{discount_id, code, amount}` entries for every line-item discount while preserving aggregate cart line totals.
- `orders.checkout_id` is intentionally added beyond the original schema table to enforce idempotent checkout completion without duplicate orders.
- Failed card payments release reserved inventory and move the checkout back to `shipping_selected` so customers can retry payment selection.
- Bank transfer order completion creates a pending order and payment while keeping inventory reserved until the later admin payment-confirmation flow.
- Inventory commit/release/restock locks by primary key without the current-store global scope because scheduled jobs can operate across stores in one run.
- Admin order Livewire components persist locked `storeId`/`orderId` state and reload orders without global scopes but with explicit store constraints before each service-backed action.
- Admin order actions deliberately delegate to `OrderService`, `RefundService`, and `FulfillmentService` so UI validation cannot bypass payment, refund, fulfillment, or inventory guards.
- Storefront order lookup uses a deterministic HMAC access token derived from store/order identity so confirmation links can be token-gated without adding a new runtime column.
- Admin REST API routes use the `admin.api` middleware with session-authenticated store users or hashed `oauth_tokens` bearer tokens; the current implemented surfaces are read-only products/customers/orders, collection CRUD, discount CRUD, content page CRUD, search status/reindex, analytics summary, shipping zone/rate settings, tax settings read/update, and order fulfillment/refund mutations.
- Admin dashboard sales and top-product metrics are derived from paid or partially refunded orders; the dedicated analytics page now reads analytics event and daily aggregate tables.
- Customer addresses are scoped through the locked customer id because `customer_addresses` intentionally belongs to customers and has no direct `store_id` column.
- Admin/store Livewire route middleware is registered with Livewire persistent middleware so component POST requests keep `current_store` binding and store-role checks after the initial full-page route load.
- Admin routes use a custom `EnsureUserEmailIsVerified` middleware so verified-user gating works for full-page Livewire routes without relying on the stock redirect middleware path that fails during Livewire component redirects in this app.
- Admin settings are split across `/admin/settings`, `/admin/settings/shipping`, `/admin/settings/taxes`, `/admin/settings/checkout`, and `/admin/settings/notifications`; domains are managed on the general settings page because the current route surface does not need a separate domains route.
- The tax settings API accepts the spec-facing `default_tax_rate`/`tax_rates` payload shape and normalizes it to the existing internal `default_rate_bps`/`rates` config consumed by the calculator and admin UI.
- The shipping settings API accepts spec-facing `price_amount`/`tiers` rate config keys and normalizes them to the existing `amount`/`ranges` config consumed by `ShippingCalculator`.
- The theme upload API imports ZIP archives with `theme.json` or `manifest.json`, requires the same core template paths seeded for default themes, stores each imported file on the local disk under the new theme id, and seeds theme settings from the manifest or the store defaults.
- The theme publish API validates required files before switching the store to exactly one published theme and flushing cached theme settings.
- The store settings API exposes the general settings UI surface as `/api/admin/v1/stores/{store}/settings`: store name/currency/locale/timezone fields update the `stores` row, while `settings_json` patches are recursively merged into `store_settings` so checkout and notification defaults are preserved unless explicitly changed.
- The order export API adds a small `data_exports` table to support the spec's export status endpoint; this local app generates CSV synchronously into the local disk, marks the export `completed` inside the create request, and returns a data URL from the status response instead of a cloud presigned URL.
- Checkout and notification settings persist in `store_settings.settings_json`; `bank_transfer_cancel_days` remains a root-level key because the existing cancellation job already consumes it from that location.
- Admin navigation persists nested ordered menu items with Livewire `wire:sort`, up/down sibling controls, and a parent selector; children are saved under their selected top-level parent with per-parent positions.
- The theme editor uses the `ThemeSettingsService` default settings shape as the editable schema and writes back to `theme_settings.settings_json`.
- Theme files are seeded and edited through local disk storage at `theme_files.storage_key`; saving a file updates the stored contents plus `sha256` and `byte_size` metadata.
- Theme duplication copies each file's local disk contents to a new storage key for the copied theme instead of sharing the original file storage path.
- Search uses a local SQLite FTS5 virtual table (`products_fts`) with `SearchService` as the only query/sync boundary; product observer events keep the index synchronized for create/update/delete.
- Admin search reindex API runs the existing local `SearchService::reindex()` synchronously and returns `202 Accepted` with `completed` status because this self-contained app has no separate durable search job state table.
- Search settings apply at query time: per-store stop words are removed, synonym groups expand into sanitized SQLite FTS5 `OR` terms, and terms are joined with explicit `AND`; the admin page can rebuild the per-store index synchronously for this self-contained app.
- Search API rate limiting is registered as `search` (30/minute per IP), analytics ingestion uses the `analytics` limiter (60/minute per IP), and a `webhooks` limiter is registered for future inbound app endpoints.
- Analytics ingestion stores raw events with client-event deduplication and keeps aggregation separate in `analytics_daily`; admin analytics reads pre-aggregated daily metrics for KPIs and raw events for referrers.
- Seeded analytics metrics are deterministic demo data and are not tied to seeded orders because order/payment seed data remains intentionally absent.
- The admin analytics CSV export is generated as a data URL for the self-contained local app rather than creating persistent export files/jobs.
- OAuth/Passport app authorization remains deferred per the roadmap; `/oauth/*` and `/api/apps/v1/*` now return explicit `501 Not Implemented` responses, while the developer token UI uses the existing app installation and `oauth_tokens` schema as a self-contained local token store.
- Admin order API routes use the `admin.api` middleware, which accepts either the existing session-authenticated admin user or a hashed `oauth_tokens` bearer token scoped to the route store; token requests require `read-orders` for GET routes and `write-orders` for refund/fulfillment mutations and update `last_used_at` on successful use.
- Outbound webhook delivery jobs are forced onto the database queue and `webhooks` queue name so domain events enqueue delivery work instead of making external HTTP requests inline when the default queue connection is `sync`.
- Webhook signatures follow the security spec message shape of `{timestamp}.{json_body}` with HMAC-SHA256, while the delivery payload is wrapped with `id`, `api_version`, `event_type`, `store_id`, `occurred_at`, and `data`.
- Webhook circuit breaker state is derived from the latest five delivery rows for a subscription because the schema does not include a dedicated consecutive-failure counter column.
- Customer password resets use a custom store-scoped service instead of Laravel's stock password broker token repository because the `customer_password_reset_tokens` table includes `store_id` in the primary key and the stock repository does not write tenant columns.
- Customer password reset pages now use the spec root routes `/forgot-password` and `/reset-password/{token}` with POST handlers at the same root paths; `/account/forgot-password` and `/account/reset-password/{token}` remain as compatibility aliases, while Fortify's generic starter user reset named routes are preserved under `/user/forgot-password` and `/user/reset-password/{token}`.
- Admin password reset aliases are routed under `/admin/forgot-password` and `/admin/reset-password/{token}` using Fortify's existing password reset controllers; the shared Fortify views post to admin routes when rendered from admin reset pages.
- Admin user-menu logout forms route to `/admin/logout` when rendered on admin routes so browser logout returns to `/admin/login`; the same shared menu keeps Fortify's generic `/logout` route on non-admin starter settings routes.
- Product media uploads use Livewire temporary file uploads on the existing product form, create `ProductMedia` rows in `processing` status, and dispatch the existing `ProcessMediaUpload` job instead of adding a second media-processing path.
- Resource policies now type concrete model parameters for Product, Collection, Customer, Discount, Order, Fulfillment, Refund, Page, and Theme actions; `ChecksStoreRole::storeIdForModel()` stays generic because it is the shared store-id extraction helper.
- Laravel's SQLite `enum()` migrations generate database `CHECK` clauses in this app; `DatabaseConstraintTest` locks representative constraints across tenancy, roles, catalog, orders, tax settings, and exports.
- Automated browser coverage now combines smoke coverage with Suite 2 admin-auth interactions, Suite 7 storefront browsing interactions, Suite 8 cart-flow interactions, Suite 9 checkout-flow interactions, Suite 10 customer-account interactions, Suite 11 inventory-policy interactions, Suite 12 tenant-isolation interactions, Suite 13 responsive/mobile interactions, and Suite 14 accessibility interactions: storefront catalog/content/search/cart, storefront account auth/reset pages, the full authenticated admin navigation surface, admin login validation, protected-route redirects, logout, sidebar navigation, mobile storefront rendering, seeded collection/product/search/static page browsing, sale/compare-at pricing, draft-product visibility guards, stock/backorder messaging, main-navigation clicks, add-to-cart, cart quantity updates/removal, multi-product carts, subtotal/total display, valid/invalid/expired/maxed/free-shipping/fixed discount code handling, domestic/international checkout shipping, checkout discount carryover, address validation, empty-cart checkout protection, credit-card/PayPal/bank-transfer order completion, payment decline handling, payment-method UI switching, customer registration validation, customer login validation, account auth redirects, customer order history/detail, address book create/update, customer logout, deny-policy sold-out blocking, continue-policy backorder add-to-cart, in-stock status display, deny-policy cart stock-limit feedback, storefront product/collection/search store isolation, admin product/order store isolation, customer account store isolation, mobile hamburger navigation, mobile product/cart/checkout flows, mobile collection filtering, tablet admin login/sidebar navigation, console-clean home/cart pages, heading hierarchy, form labels, product image placeholder accessible text, checkout error linkage, keyboard navigation, and search input labeling.
- Pest's per-visit browser `host` option is temporary, so host-sensitive storefront browser tests set the Playwright host for the whole test lifecycle to keep clicked absolute URLs resolving through `shop.test`.
- The discount seeder now includes the Spec 07/08 codes `WELCOME10`, `FLAT5`, `FREESHIP`, `EXPIRED20`, and `MAXED` while preserving the earlier implementation/test fixture codes `SAVE10` and `5OFF`.
- Expired discount codes return an expired validation message before the generic non-active status message so storefront/cart validation can present the expected customer-facing error.
- Shipping seed data now follows the Spec 07/08 checkout fixtures: `Domestic` covers Germany with `Standard Shipping` at 4.99 EUR, while `International` covers AT/CH/US/GB/CA/AU with a 14.99 EUR international rate.
- Storefront seeded tax settings use tax-inclusive pricing so checkout browser totals match the storefront spec examples while tax amounts remain visible as extracted totals.
- The checkout payment UI keeps the existing service-backed reservation path internally, but the browser-facing action is a single payment button (`Pay now`, `Pay with PayPal`, or `Place order`) that calls `placeOrder()`.
- The seeded customer now has a deterministic default `Home` address so account address-book flows and browser tests have a stable read/edit fixture without seeding runtime orders.
- The storefront mobile menu uses a Flux modal flyout with regular `wire:navigate` links; `flux:modal.close` is only used for Flux's own close button because wrapping plain anchors produced Flux JS errors in browser tests.
- Product detail placeholders use `role="img"` and descriptive `aria-label` text until seeded media is available, and the checkout email field has an explicit `aria-describedby` target for validation errors.

## Open Issues

- Full automated browser interaction/permutation suites from Spec 08 are still incomplete beyond the expanded Pest browser smoke coverage, Suite 2 admin authentication, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account flow, Suite 11 inventory enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile, and Suite 14 accessibility.
- The full suite now needs a higher PHP memory limit when all browser suites run in one process; the default `php artisan test --compact` command hits 128 MB in Pest's browser WebSocket client, while `php -d memory_limit=512M vendor/bin/pest --compact` passes.

## Completion Summary

Not complete. Phase 1 foundation, Phase 2 catalog data/UI surfaces, product media processing/admin upload controls, Phase 3 storefront theme/content/navigation data, the Phase 4 cart/checkout/pricing backend foundation, cart/checkout storefront UI through order completion, cart-page estimates, cart/checkout REST APIs, Phase 5 order/payment backend foundation, Phase 5 refund/fulfillment services, customer account order/address/logout views, admin dashboard/order/customer/discount/content/settings/theme-file/navigation/search/analytics/apps/developers management, storefront search and analytics APIs, product/customer/collection/discount/content page/store settings/search/analytics/shipping/tax/theme/order/export API surfaces, deferred OAuth/app route stubs, expanded automated browser smoke coverage, Suite 2 admin authentication browser coverage, Suite 7 storefront browsing browser coverage, Suite 8 cart-flow browser coverage, Suite 9 checkout-flow browser coverage, Suite 10 customer-account browser coverage, Suite 11 inventory-enforcement browser coverage, Suite 12 tenant-isolation browser coverage, Suite 13 responsive/mobile browser coverage, Suite 14 accessibility browser coverage, outbound webhook delivery foundations, spec-root customer password reset routes, and representative database CHECK constraint coverage are implemented, with the remaining full browser-suite gap tracked above.


I’m updating `specs/progress.md` now with the Suite 3 evidence and the adjusted remaining-browser-suite list. This is only progress bookkeeping; the implementation and verification are already complete for this slice.


Input:
*** Begin Patch
*** Update File: /Users/fabianwesner/Herd/shop/specs/progress.md
@@
-| Browser E2E plan | `specs/08-PLAYWRIGHT-E2E-PLAN.md` | partial | Manual Playwright MCP smoke coverage has verified storefront catalog browsing on `shop.test` and `acme-fashion.test`, product detail, add-to-cart, cart drawer/page, checkout through order completion, order confirmation, customer order list/detail, SQLite-backed search and search API JSON, analytics event ingestion API, DB-backed content pages, seeded nested navigation dropdowns, admin dashboard on desktop/mobile, admin analytics, admin app list/detail, admin developers token/webhook flows, admin product/collection/inventory/order/customer/discount/content/navigation/settings/theme/search pages, admin checkout/notification settings pages, admin product media section rendering, admin analytics CSV export, admin customer address creation, admin discount creation/editing/filtering, admin page creation, admin nested navigation rendering/item creation/save, admin theme editor preview, admin theme file list/editor, admin search reindexing, admin fulfillment creation/shipping/delivery, and auth flows without console warnings/errors on successful pages. Automated Pest browser coverage now checks storefront core pages, storefront account auth/reset pages including the customer root reset paths and account aliases, authenticated admin navigation/pages/settings/theme/search/apps/developers surfaces, Suite 2 admin authentication login/validation/redirect/logout/sidebar navigation interactions, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account registration/login/orders/addresses/logout, Suite 11 inventory policy enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile flows, Suite 14 accessibility checks, and mobile storefront rendering for JavaScript errors. The remaining Spec 08 interaction/permutation browser suites are still incomplete. |
+| Browser E2E plan | `specs/08-PLAYWRIGHT-E2E-PLAN.md` | partial | Manual Playwright MCP smoke coverage has verified storefront catalog browsing on `shop.test` and `acme-fashion.test`, product detail, add-to-cart, cart drawer/page, checkout through order completion, order confirmation, customer order list/detail, SQLite-backed search and search API JSON, analytics event ingestion API, DB-backed content pages, seeded nested navigation dropdowns, admin dashboard on desktop/mobile, admin analytics, admin app list/detail, admin developers token/webhook flows, admin product/collection/inventory/order/customer/discount/content/navigation/settings/theme/search pages, admin checkout/notification settings pages, admin product media section rendering, admin analytics CSV export, admin customer address creation, admin discount creation/editing/filtering, admin page creation, admin nested navigation rendering/item creation/save, admin theme editor preview, admin theme file list/editor, admin search reindexing, admin fulfillment creation/shipping/delivery, and auth flows without console warnings/errors on successful pages. Automated Pest browser coverage now checks storefront core pages, storefront account auth/reset pages including the customer root reset paths and account aliases, authenticated admin navigation/pages/settings/theme/search/apps/developers surfaces, Suite 2 admin authentication login/validation/redirect/logout/sidebar navigation interactions, Suite 3 admin product listing/create/edit/archive/search/status-filter/draft visibility interactions, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account registration/login/orders/addresses/logout, Suite 11 inventory policy enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile flows, Suite 14 accessibility checks, and mobile storefront rendering for JavaScript errors. The remaining Spec 08 interaction/permutation browser suites are still incomplete. |
@@
 - 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding the accessibility browser suite and Blade accessibility fixes.
 - 2026-05-04: `php artisan test --compact tests/Browser/Storefront/AccessibilityTest.php` passed for the new Suite 14 accessibility browser coverage: 11 tests, 42 assertions.
 - 2026-05-04: `npm run build` passed after the storefront accessibility Blade changes.
 - 2026-05-04: `php artisan test --compact tests/Browser/SmokeTest.php tests/Browser/Admin/AuthenticationTest.php tests/Browser/Storefront/BrowsingTest.php tests/Browser/Storefront/CartTest.php tests/Browser/Storefront/CheckoutTest.php tests/Browser/Storefront/CustomerAccountTest.php tests/Browser/Storefront/InventoryTest.php tests/Browser/Storefront/TenantIsolationTest.php tests/Browser/Storefront/ResponsiveTest.php tests/Browser/Storefront/AccessibilityTest.php` passed after adding Suite 14: 94 tests, 532 assertions.
 - 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 14: 343 tests, 1971 assertions.
+- 2026-05-04: `mcp__laravel_boost__.search_docs` consulted Pest browser testing, Livewire form/file-upload docs, Flux input/select/button/table docs, and Laravel browser/session testing docs before adding the Spec 08 admin product-management browser suite.
+- 2026-05-04: `php artisan make:test --pest Browser/Admin/ProductManagementTest --no-interaction` created the Suite 3 product-management browser test, which was moved into the Spec 08 browser directory structure.
+- 2026-05-04: `vendor/bin/pint --dirty --format agent` passed after adding Suite 3 and the product form save-button test marker.
+- 2026-05-04: `php artisan test --compact tests/Browser/Admin/ProductManagementTest.php` passed for the new Suite 3 admin product-management browser coverage: 7 tests, 98 assertions.
+- 2026-05-04: `php artisan test --compact tests/Browser` passed after adding Suite 3: 101 tests, 630 assertions.
+- 2026-05-04: `php -d memory_limit=512M vendor/bin/pest --compact` passed the full suite after Suite 3: 350 tests, 2069 assertions.
@@
-- Automated browser coverage now combines smoke coverage with Suite 2 admin-auth interactions, Suite 7 storefront browsing interactions, Suite 8 cart-flow interactions, Suite 9 checkout-flow interactions, Suite 10 customer-account interactions, Suite 11 inventory-policy interactions, Suite 12 tenant-isolation interactions, Suite 13 responsive/mobile interactions, and Suite 14 accessibility interactions: storefront catalog/content/search/cart, storefront account auth/reset pages, the full authenticated admin navigation surface, admin login validation, protected-route redirects, logout, sidebar navigation, mobile storefront rendering, seeded collection/product/search/static page browsing, sale/compare-at pricing, draft-product visibility guards, stock/backorder messaging, main-navigation clicks, add-to-cart, cart quantity updates/removal, multi-product carts, subtotal/total display, valid/invalid/expired/maxed/free-shipping/fixed discount code handling, domestic/international checkout shipping, checkout discount carryover, address validation, empty-cart checkout protection, credit-card/PayPal/bank-transfer order completion, payment decline handling, payment-method UI switching, customer registration validation, customer login validation, account auth redirects, customer order history/detail, address book create/update, customer logout, deny-policy sold-out blocking, continue-policy backorder add-to-cart, in-stock status display, deny-policy cart stock-limit feedback, storefront product/collection/search store isolation, admin product/order store isolation, customer account store isolation, mobile hamburger navigation, mobile product/cart/checkout flows, mobile collection filtering, tablet admin login/sidebar navigation, console-clean home/cart pages, heading hierarchy, form labels, product image placeholder accessible text, checkout error linkage, keyboard navigation, and search input labeling.
+- Automated browser coverage now combines smoke coverage with Suite 2 admin-auth interactions, Suite 3 admin product-management interactions, Suite 7 storefront browsing interactions, Suite 8 cart-flow interactions, Suite 9 checkout-flow interactions, Suite 10 customer-account interactions, Suite 11 inventory-policy interactions, Suite 12 tenant-isolation interactions, Suite 13 responsive/mobile interactions, and Suite 14 accessibility interactions: storefront catalog/content/search/cart, storefront account auth/reset pages, the full authenticated admin navigation surface, admin login validation, protected-route redirects, logout, sidebar navigation, admin product listing/create/edit/archive/search/status-filter/draft visibility guards, mobile storefront rendering, seeded collection/product/search/static page browsing, sale/compare-at pricing, draft-product storefront visibility guards, stock/backorder messaging, main-navigation clicks, add-to-cart, cart quantity updates/removal, multi-product carts, subtotal/total display, valid/invalid/expired/maxed/free-shipping/fixed discount code handling, domestic/international checkout shipping, checkout discount carryover, address validation, empty-cart checkout protection, credit-card/PayPal/bank-transfer order completion, payment decline handling, payment-method UI switching, customer registration validation, customer login validation, account auth redirects, customer order history/detail, address book create/update, customer logout, deny-policy sold-out blocking, continue-policy backorder add-to-cart, in-stock status display, deny-policy cart stock-limit feedback, storefront product/collection/search store isolation, admin product/order store isolation, customer account store isolation, mobile hamburger navigation, mobile product/cart/checkout flows, mobile collection filtering, tablet admin login/sidebar navigation, console-clean home/cart pages, heading hierarchy, form labels, product image placeholder accessible text, checkout error linkage, keyboard navigation, and search input labeling.
+- The admin product-management browser suite uses Laravel `actingAs()` and `withSession()` to create deterministic authenticated browser visits; the separate Suite 2 admin-auth suite owns login-form coverage so persisted browser cookies from earlier tests cannot leak into product CRUD assertions.
@@
-- Full automated browser interaction/permutation suites from Spec 08 are still incomplete beyond the expanded Pest browser smoke coverage, Suite 2 admin authentication, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account flow, Suite 11 inventory enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile, and Suite 14 accessibility.
+- Full automated browser interaction/permutation suites from Spec 08 are still incomplete beyond the expanded Pest browser smoke coverage, Suite 2 admin authentication, Suite 3 admin product management, Suite 7 storefront browsing, Suite 8 cart flow, Suite 9 checkout flow, Suite 10 customer account flow, Suite 11 inventory enforcement, Suite 12 tenant isolation, Suite 13 responsive/mobile, and Suite 14 accessibility.
@@
-Not complete. Phase 1 foundation, Phase 2 catalog data/UI surfaces, product media processing/admin upload controls, Phase 3 storefront theme/content/navigation data, the Phase 4 cart/checkout/pricing backend foundation, cart/checkout storefront UI through order completion, cart-page estimates, cart/checkout REST APIs, Phase 5 order/payment backend foundation, Phase 5 refund/fulfillment services, customer account order/address/logout views, admin dashboard/order/customer/discount/content/settings/theme-file/navigation/search/analytics/apps/developers management, storefront search and analytics APIs, product/customer/collection/discount/content page/store settings/search/analytics/shipping/tax/theme/order/export API surfaces, deferred OAuth/app route stubs, expanded automated browser smoke coverage, Suite 2 admin authentication browser coverage, Suite 7 storefront browsing browser coverage, Suite 8 cart-flow browser coverage, Suite 9 checkout-flow browser coverage, Suite 10 customer-account browser coverage, Suite 11 inventory-enforcement browser coverage, Suite 12 tenant-isolation browser coverage, Suite 13 responsive/mobile browser coverage, Suite 14 accessibility browser coverage, outbound webhook delivery foundations, spec-root customer password reset routes, and representative database CHECK constraint coverage are implemented, with the remaining full browser-suite gap tracked above.
+Not complete. Phase 1 foundation, Phase 2 catalog data/UI surfaces, product media processing/admin upload controls, Phase 3 storefront theme/content/navigation data, the Phase 4 cart/checkout/pricing backend foundation, cart/checkout storefront UI through order completion, cart-page estimates, cart/checkout REST APIs, Phase 5 order/payment backend foundation, Phase 5 refund/fulfillment services, customer account order/address/logout views, admin dashboard/order/customer/discount/content/settings/theme-file/navigation/search/analytics/apps/developers management, storefront search and analytics APIs, product/customer/collection/discount/content page/store settings/search/analytics/shipping/tax/theme/order/export API surfaces, deferred OAuth/app route stubs, expanded automated browser smoke coverage, Suite 2 admin authentication browser coverage, Suite 3 admin product-management browser coverage, Suite 7 storefront browsing browser coverage, Suite 8 cart-flow browser coverage, Suite 9 checkout-flow browser coverage, Suite 10 customer-account browser coverage, Suite 11 inventory-enforcement browser coverage, Suite 12 tenant-isolation browser coverage, Suite 13 responsive/mobile browser coverage, Suite 14 accessibility browser coverage, outbound webhook delivery foundations, spec-root customer password reset routes, and representative database CHECK constraint coverage are implemented, with the remaining full browser-suite gap tracked above.
*** End Patch