Build Detail

You own spec extraction for implementation planning. Read `specs/09-IMPLEMENTATION-ROADMAP.md` and produce: (1) phase-by-phase checklist with concrete deliverables, (2) dependencies, (3) acceptance criteria references. Keep concise but complete.

You own data/backend requirements extraction. Read `specs/01-DATABASE-SCHEMA.md`, `specs/05-BUSINESS-LOGIC.md`, `specs/06-AUTH-AND-SECURITY.md`, `specs/07-SEEDERS-AND-TEST-DATA.md`. Return a structured checklist of entities, rules, policies, jobs, events, and required tests.

You own API/admin extraction. Read `specs/02-API-ROUTES.md` and `specs/03-ADMIN-UI.md`. Return required routes/components/actions plus acceptance criteria for admin workflows.

You own storefront/E2E extraction. Read `specs/04-STOREFRONT-UI.md` and `specs/08-PLAYWRIGHT-E2E-PLAN.md`. Return storefront requirements and a runnable Playwright scenario matrix with pass criteria.

You own current-code audit. Inspect the current repository and summarize what is already implemented vs missing relative to a full shop system. Include key files and current test coverage gaps.

Ownership: foundation/domain backend only. You are not alone in the codebase; ignore unrelated edits made by others and do not touch files outside your scope unless absolutely required. Task: Implement Phase 1 foundation + core data model scaffolding for the shop from scratch on current branch. Scope/files you may create/edit: - app/Models/** (new domain models) - app/Enums/** - app/Support/** - app/Http/Middleware/** (store resolver) - app/Providers/AppServiceProvider.php (register current store bindings) - bootstrap/app.php (register middleware aliases/group) - config/auth.php (customer guard/provider) - database/migrations/** (replace starter schema with shop schema core + domain tables needed for phases 1-5 minimally) - database/factories/** (new factories) - database/seeders/** (comprehensive baseline seeding for 2 stores, admin users, customers, products, collections, discounts, shipping/tax) Requirements: 1) Keep existing users auth working for admin web guard, add customer table/model/guard. 2) Add tenant models: Organization, Store, StoreDomain, StoreUser, StoreSettings with relationships. 3) Add core catalog/order/cart/payment schema sufficient for full feature implementation later. 4) Add BelongsToStore trait/global scope using current store context helper. 5) Add ResolveStore middleware (host-based, fallback first store in local/testing). 6) Ensure `php artisan migrate:fresh --seed` works. 7) Keep code pragmatic and compilable in Laravel 12/PHP 8.4. Deliverable: - Implement code directly. - Run formatting if needed. - Run at least `php artisan migrate:fresh --seed` and report results. - Return concise summary with key files changed and anything still missing.

Ownership: services + API only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Services/** - app/Contracts/** - app/Support/** only if needed for service helpers (avoid changing existing files unless required) - app/Exceptions/** - app/Http/Controllers/Api/** - routes/api.php Task: Implement pragmatic business logic for shop core: 1) CartService: create/get cart by session+store, add/update/remove lines, recalc totals. 2) DiscountService: support codes WELCOME10(10% min), FLAT5(fixed), FREESHIP. 3) ShippingService/TaxService/PricingService: compute shipping/tax/total from cart + address + discounts. 4) Payment service/provider abstraction with MockPaymentProvider (credit_card/paypal/bank_transfer; magic decline card handling). 5) CheckoutService: create checkout from cart, set contact/address/shipping/payment, place order and payment rows, inventory checks for deny policy. 6) OrderService: generate sequential order numbers per store and create order lines. 7) InventoryService: reserve/commit/release/restock basics. 8) Basic REST JSON API endpoints for storefront cart/checkout and admin product/order listing/detail under versioned prefixes. Constraints: - Keep code simple, deterministic, and testable. - Use existing models/enums from repo. - Avoid UI changes. - Ensure no syntax/runtime errors. Deliverable: - Implement directly. - Run `php artisan test --filter=Cart --filter=Checkout` if tests exist, otherwise run `php -l` style sanity by `php artisan route:list`. - Return summary with key files and any TODOs.

Ownership: storefront + customer experience only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Http/Controllers/Storefront/** - app/Http/Controllers/Customer/** - resources/views/storefront/** - resources/views/customer/** - routes/storefront.php Task: Implement customer-facing shop UI and flow using Blade + controllers: 1) Storefront pages: home, collections index/show, product show, search, page show. 2) Cart page + actions (add/update/remove/apply discount) integrating CartService. 3) Checkout page + submit flow integrating CheckoutService; support payment method choice and display validation/errors. 4) Order confirmation page with bank-transfer instructions when pending. 5) Customer auth/account: register, login, logout (customer guard), dashboard, order history/show, address CRUD. 6) Use responsive Tailwind markup and clear headings/labels compatible with Playwright assertions. Constraints: - Route definitions go into `routes/storefront.php` only. - Assume middleware `resolve.store:storefront` exists. - Keep dependencies on services via constructor injection. Deliverable: - Implement directly. - Run `php artisan route:list | rg storefront|account|checkout|cart` and report. - Return summary and any blockers.

Ownership: admin panel only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Http/Controllers/Admin/** - resources/views/admin/** - routes/admin.php Task: Implement practical admin UI/controllers for core workflows: 1) Admin auth entry screen (can rely on existing web guard auth routes); create admin login view if needed. 2) Dashboard with KPIs (sales/orders/customers/products). 3) Products CRUD (index/create/edit/store/update/delete). 4) Collections CRUD and product assignment basics. 5) Inventory view with inline stock update action. 6) Orders index/show + actions: confirm bank transfer payment, create fulfillment, create refund. 7) Customers index/show. 8) Discounts index/create/edit. 9) Settings pages: general, shipping, taxes with save actions. Constraints: - Route definitions in `routes/admin.php` only. - Use middleware assuming `auth` + `resolve.store:admin`. - Keep templates simple but complete and testable. Deliverable: - Implement directly. - Run `php artisan route:list | rg admin` and report. - Return summary and known gaps.

Ownership: services + API only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Services/** - app/Contracts/** - app/Exceptions/** - app/Http/Controllers/Api/** - routes/api.php Task: Implement pragmatic business logic for shop core: 1) CartService: create/get cart by session+store, add/update/remove lines, recalc totals. 2) DiscountService: support codes WELCOME10(10% min), FLAT5(fixed), FREESHIP, plus expired/maxed handling. 3) ShippingService/TaxService/PricingService: compute shipping/tax/total from cart + address + discounts. 4) Payment service/provider abstraction with MockPaymentProvider (credit_card/paypal/bank_transfer; magic decline card handling). 5) CheckoutService: create checkout from cart, set contact/address/shipping/payment, place order and payment rows, inventory checks for deny policy. 6) OrderService: generate sequential order numbers per store and create order lines. 7) InventoryService: reserve/commit/release/restock basics. 8) Basic REST JSON API endpoints for storefront cart/checkout and admin product/order listing/detail under versioned prefixes. Constraints: - Keep code simple, deterministic, and testable. - Use existing models/enums from repo. - Avoid UI changes. - Ensure no syntax/runtime errors. Deliverable: - Implement directly. - Run `php artisan route:list` and a targeted sanity check if possible. - Return summary with key files and TODOs.

Ownership: storefront + customer experience only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Http/Controllers/Storefront/** - app/Http/Controllers/Customer/** - resources/views/storefront/** - resources/views/customer/** - routes/storefront.php Task: Implement customer-facing shop UI and flow using Blade + controllers: 1) Storefront pages: home, collections index/show, product show, search, page show. 2) Cart page + actions (add/update/remove/apply discount) integrating CartService. 3) Checkout page + submit flow integrating CheckoutService; support payment method choice and validation/errors. 4) Order confirmation page with bank-transfer instructions when pending. 5) Customer auth/account: register, login, logout (customer guard), dashboard, order history/show, address CRUD. 6) Responsive Tailwind markup with headings/labels suitable for Playwright assertions. Constraints: - Route definitions go into `routes/storefront.php` only. - Assume middleware `resolve.store:storefront` exists. - Keep service dependencies via injection. Deliverable: - Implement directly. - Run `php artisan route:list | rg storefront|account|checkout|cart|products|collections` and report. - Return summary and blockers.

Ownership: admin panel only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - app/Http/Controllers/Admin/** - resources/views/admin/** - routes/admin.php Task: Implement practical admin UI/controllers for core workflows: 1) Dashboard with KPIs (sales/orders/customers/products). 2) Products CRUD. 3) Collections CRUD and product assignment basics. 4) Inventory view with stock update action. 5) Orders index/show + actions: confirm bank transfer payment, create fulfillment, create refund. 6) Customers index/show. 7) Discounts index/create/edit. 8) Settings pages: general, shipping, taxes with save actions. Constraints: - Route definitions in `routes/admin.php` only. - Use middleware `auth` + `resolve.store:admin`. - Keep templates simple but functional and testable. Deliverable: - Implement directly. - Run `php artisan route:list | rg admin` and report. - Return summary and gaps.

Ownership: phase 8-10 backend scaffolding only. You are not alone in the codebase; ignore unrelated edits made by others and do not touch files outside scope. Scope/files you may create/edit: - database/migrations/** (new files only) - app/Models/** (new models only for search/analytics/apps/webhooks/oauth) - app/Services/** (new services for search/analytics/webhooks only) - app/Jobs/** (new jobs for analytics/webhooks only) - database/seeders/** (new seeders + update DatabaseSeeder.php only to include new seeders) Task: Implement baseline schema + code for missing phases: 1) Search: search_settings, search_queries, products_fts (sqlite FTS5 virtual table), plus SearchService with reindex + query methods. 2) Analytics: analytics_events, analytics_daily + AnalyticsService + AggregateAnalytics job. 3) Apps/Webhooks: apps, app_installations, oauth_clients, oauth_tokens, webhook_subscriptions, webhook_deliveries + WebhookService + DeliverWebhook job. 4) Add pragmatic seeders for these tables with deterministic sample data. Constraints: - Keep migrations compatible with SQLite. - Keep implementation minimal but functional and testable. - Do not modify controllers/routes/views/tests in this task. Deliverable: - Implement directly. - Run `touch /tmp/shop-phase810.sqlite && DB_DATABASE=/tmp/shop-phase810.sqlite php artisan migrate:fresh --seed`. - Return summary and any caveats.

Ownership: phase 8-10 admin UI extensions only. You are not alone in the codebase; ignore unrelated edits made by others and do not touch files outside scope. Scope/files you may create/edit: - app/Http/Controllers/Admin/** (new controllers and minimal edits in existing admin controllers if required) - resources/views/admin/** (new view folders/files) - routes/admin.php Task: Extend admin interface with missing sections and practical functionality: 1) Pages management (index/create/edit/store/update/delete). 2) Navigation management (edit main menu items list; add/remove/reorder simple via position input). 3) Themes management (index, edit theme settings JSON, publish action). 4) Search settings page (edit synonyms/stop words and trigger reindex via SearchService if available). 5) Analytics page (KPI summary + top products from orders; date range filter). 6) Apps page and Developers page (show installed apps, tokens/webhooks placeholders and create/revoke token + webhook CRUD basics if model exists). Constraints: - Keep templates simple and consistent with current admin layout. - Use middleware and current store scoping already in place. - Add routes in `routes/admin.php` under existing admin group. Deliverable: - Implement directly. - Run `php artisan route:list | rg "admin/(pages|navigation|themes|search|analytics|apps|developers)"`. - Return summary and any gaps.

Ownership: tests only. You are not alone in the codebase; ignore unrelated edits by others and do not touch files outside scope. Scope/files you may create/edit: - tests/** - tests/Pest.php Task: Create a comprehensive Pest suite for the implemented shop system. Required coverage (unit + feature): 1) Tenancy/middleware: store resolution fallback in testing and store scoping behavior. 2) Services unit tests: - CartService add/update/remove + version conflict. - DiscountService valid/invalid codes. - CheckoutService placeOrder for credit card success, credit-card decline, and bank transfer pending. - InventoryService deny/continue policies. - SearchService reindex/query/autocomplete basics. - Analytics aggregation job. - Webhook signature/verification + delivery record behavior (mock HTTP). 3) Feature tests: - Storefront browse pages (home, collections, product, search, page). - Cart + checkout happy path and decline path. - Customer register/login/account orders/addresses. - Admin pages reachable when authenticated and store assigned. - Admin product create/update flow. - Admin order confirm bank transfer + fulfillment/refund actions. - APIs: storefront cart endpoints and admin product/order endpoints. 4) Remove/replace starter placeholder tests that are no longer relevant (e.g. Example tests). Constraints: - Use Pest style. - Keep tests deterministic; seed or create explicit data. - Use `RefreshDatabase` where needed. - Avoid brittle assertions. Deliverable: - Implement tests directly. - Run `touch /tmp/shop-testsuite.sqlite && DB_DATABASE=/tmp/shop-testsuite.sqlite php artisan test` and report summary. - Return key files and any failing tests if unresolved.

Review specs/08-PLAYWRIGHT-E2E-PLAN.md and specs/09-IMPLEMENTATION-ROADMAP.md in /Users/fabianwesner/Herd/shop. Return a concise checklist of acceptance criteria and required E2E flows to verify manually in browser for both customer and admin sides. Focus on concrete observable behaviors and order by priority.