|
|
@@ -3,9 +3,9 @@
|
|
3
|
3
|
This file is the single source of truth for the project plan and status.
|
|
4
|
4
|
Update it at the end of every work session.
|
|
5
|
5
|
|
|
6
|
|
-**Last updated:** 2026-11-18
|
|
7
|
|
-**Current step:** Step 9 — Modern store design (parts 1–3 done; next: part 4, style options and motion)
|
|
8
|
|
-**Next action:** Commit part 3 on `redesign/part-3-product-page` (do not merge into `main` yet). Then create `redesign/part-4-style-options` from it and build style options and motion. Step 7 part 2 still waits for an EasyParcel API key
|
|
|
6
|
+**Last updated:** 2026-11-19
|
|
|
7
|
+**Current step:** Step 9 — Modern store design (parts 1–4 done; next: part 5, more layouts per section)
|
|
|
8
|
+**Next action:** Commit part 4 on `redesign/part-4-style-options` (do not merge into `main` yet). Then create `redesign/part-5-section-layouts` from it and add more layouts per section. Step 7 part 2 still waits for an EasyParcel API key
|
|
9
|
9
|
|
|
10
|
10
|
Status marks: `[ ]` not started · `[~]` in progress · `[x]` done
|
|
11
|
11
|
|
|
|
@@ -219,12 +219,22 @@ Changing from Claude to another AI model (or back) must be a settings change, no
|
|
219
|
219
|
- **Phone menu:** below tablet width both header layouts show a menu button that opens all links and the header button; Escape or a link closes it.
|
|
220
|
220
|
- On wide screens the photos stay in view while the shopper scrolls the details.
|
|
221
|
221
|
|
|
|
222
|
+### How store styles work (added in Step 9 part 4)
|
|
|
223
|
+
|
|
|
224
|
+- `theme.style` in the store plan has six optional parts: `buttons` (solid, outline, shadow), `cards` (border, shadow, plain, hard), `spacing` (compact, normal, airy), `headings` (normal, uppercase, heavy), `backgrounds` (plain, alternate) and `motion` (none, gentle). A plan without it uses `PlanSchema::STYLE_DEFAULTS`, which look exactly like stores did before, so old designs need no change.
|
|
|
225
|
+- The storefront root carries `data-buttons`, `data-cards` and so on; `resources/css/app.css` turns them into looks. Components only carry five classes: `sf-btn-primary`, `sf-btn-outline`, `sf-card` (cards and photos), `sf-section` (section spacing) and `sf-band` (each section on a page). A new component gets every style by using those classes.
|
|
|
226
|
+- **Ready-made looks** (`PlanSchema::STYLE_PRESETS`): Minimal, Soft, Elegant, Bold, Playful and Classic. Each sets the style, corner roundness and fonts, never the colours. They are in the **Style** box of the Design tab, with a "Fine-tune" panel for single options.
|
|
|
227
|
+- **Fonts:** 20 in all. Archivo Black, Bebas Neue, Caveat and DM Serif Display are for headings only; the checker refuses them for body text.
|
|
|
228
|
+- **Alternate backgrounds** skip sections that bring their own background (hero, trust row, testimonials, newsletter).
|
|
|
229
|
+- **Gentle motion:** sections that start below the first screen fade up as they come into view. Anything on the first screen is never hidden, and nothing moves for visitors who ask their device for less motion. A scroll check is used instead of an intersection observer, for the same reason as the sticky cart bar.
|
|
|
230
|
+- **AI:** chooses a style that fits the brand when generating (with examples per kind of brand), and changes it by chat ("make it more premium", "bolder").
|
|
|
231
|
+
|
|
222
|
232
|
### Category guides for the AI (agreed 2026-11-17)
|
|
223
|
233
|
|
|
224
|
234
|
- The category the merchant picks on the Create store page (Fashion, Beauty, Food, Home, Electronics, Health, Kids, Digital, Other) chooses a short design guide that is sent to the AI with the brand description.
|
|
225
|
235
|
- A guide is a starting direction, not a template: for example Fashion = big photos, magazine feel, lookbook; Food = warm and appetising, "how it's made", reviews high up; Beauty = soft and clean, "shop by skin need". "Other" has no guide.
|
|
226
|
236
|
- The brand description decides the details, so two stores in the same category still look different (bold streetwear versus elegant modest wear).
|
|
227
|
|
-- Guides live in our code and can be improved any time. They only suggest styles and layouts the store can really show, so they are written after the style options exist (Step 9 part 4).
|
|
|
237
|
+- Guides live in our code and can be improved any time. They only suggest styles and layouts the store can really show, so they are written after the style options and extra layouts exist (Step 9 parts 4 and 5).
|
|
228
|
238
|
- To avoid repeats, the AI is told not to copy the example design and, for a merchant's second store, what their first store looks like.
|
|
229
|
239
|
|
|
230
|
240
|
### AI edits must really change something (added 2026-11-16)
|
|
|
@@ -360,9 +370,10 @@ Agreed on 2026-11-17 after comparing our stores with 2026 design trends (researc
|
|
360
|
370
|
- [x] Part 1 — Photos first (done 2026-11-18): hero layouts with a big photo (full width, and split photo and text), a hero photo the merchant uploads in the Design tab or one of their product photos, second product photo on hover, nicer placeholders when there is no photo
|
|
361
|
371
|
- [x] Part 2 — Announcement bar and trust row (done 2026-11-18): a slim bar above the header and a row of trust points, filled in by themselves from free shipping, automatic discounts, secure payment and WhatsApp
|
|
362
|
372
|
- [x] Part 3 — Product page upgrade (done 2026-11-18): trust points under the button, folding sections (the product's own, such as "How to use", plus shipping from real fees), sticky add-to-cart bar on phones, "pairs well with", photos that stay in view on wide screens, and a phone menu for the header
|
|
363
|
|
-- [ ] Part 4 — Style options and motion: style presets the AI picks (minimal, bold, dark and elegant, soft, playful), buttons (solid, outline, pill), borders and shadows, spacing (compact or airy), section backgrounds, more fonts, more layouts per section, and gentle motion (always off for visitors who ask their device for less motion)
|
|
364
|
|
-- [ ] Part 5 — Category guides for the AI (see section 2)
|
|
365
|
|
-- [ ] Part 6 — Collections ("shop by need" tiles and menu links), bento grid section, video section, real reviews from buyers after delivery
|
|
|
373
|
+- [x] Part 4 — Style options and motion (done 2026-11-19): six style options (buttons, cards, spacing, headings, backgrounds, motion), six ready-made looks in a Style box in the Design tab, 12 more fonts (20 in all), gentle fade-in motion, and AI rules so each brand gets a fitting style
|
|
|
374
|
+- [ ] Part 5 — More layouts per section: 3 to 4 layouts instead of 2 for the main sections (moved out of part 4 on 2026-11-19)
|
|
|
375
|
+- [ ] Part 6 — Category guides for the AI (see section 2)
|
|
|
376
|
+- [ ] Part 7 — Collections ("shop by need" tiles and menu links), bento grid section, video section, real reviews from buyers after delivery
|
|
366
|
377
|
|
|
367
|
378
|
Branches (agreed 2026-11-18):
|
|
368
|
379
|
|
|
|
@@ -424,58 +435,59 @@ Then, from the project folder:
|
|
424
|
435
|
|
|
425
|
436
|
## 4b. Where things are in the code
|
|
426
|
437
|
|
|
427
|
|
-| Thing | Location |
|
|
428
|
|
-| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
429
|
|
-| Store model | `app/Models/Store.php` |
|
|
430
|
|
-| Store screens logic | `app/Http/Controllers/StoreController.php` |
|
|
431
|
|
-| Store categories, languages, statuses | `app/Enums/` |
|
|
432
|
|
-| Store form rules | `app/Http/Requests/Stores/CreateStoreRequest.php` |
|
|
433
|
|
-| Screens | `resources/js/pages/dashboard.tsx`, `resources/js/pages/stores/` |
|
|
434
|
|
-| Store tests | `tests/Feature/Stores/` |
|
|
435
|
|
-| Store plan format (the rules) | `app/StorePlan/PlanSchema.php` |
|
|
436
|
|
-| Store plan checker | `app/StorePlan/PlanValidator.php` |
|
|
437
|
|
-| Sample plan | `app/StorePlan/SamplePlan.php` |
|
|
438
|
|
-| Preview logic | `app/Http/Controllers/StoreDesignController.php` |
|
|
439
|
|
-| AI settings | `config/ai.php` (providers, models per task) |
|
|
440
|
|
-| AI layer and providers | `app/Ai/`, `app/Ai/Drivers/` |
|
|
441
|
|
-| AI prompts, generation and chat edits | `app/StorePlan/Ai/` |
|
|
442
|
|
-| Start an AI job (buttons) | `app/Http/Controllers/StoreGenerationController.php` |
|
|
443
|
|
-| Background AI job | `app/Jobs/RunStoreGeneration.php` |
|
|
444
|
|
-| Plan limits and usage counting | `config/plans.php`, `app/Billing/UsageLimits.php` |
|
|
445
|
|
-| Progress screen and chat box | `resources/js/components/stores/` |
|
|
446
|
|
-| Product model and photos | `app/Models/Product.php`, `app/Models/ProductImage.php` |
|
|
447
|
|
-| Product screens logic | `app/Http/Controllers/ProductController.php` |
|
|
448
|
|
-| Product screens | `resources/js/pages/stores/products/` |
|
|
449
|
|
-| Storefront Shop and product pages | `resources/js/storefront/pages/` |
|
|
450
|
|
-| Checkout and order logic | `app/Commerce/Checkout.php`, `app/Http/Controllers/CheckoutController.php` |
|
|
451
|
|
-| Payment providers | `app/Commerce/Payments/` (interface and Stripe) |
|
|
452
|
|
-| Stripe webhook | `app/Http/Controllers/StripeWebhookController.php` (address: `/stripe/webhook`) |
|
|
453
|
|
-| Orders for the merchant | `app/Http/Controllers/OrderController.php`, `resources/js/pages/stores/orders/` |
|
|
454
|
|
-| Order email | `app/Mail/OrderConfirmation.php`, `resources/views/mail/orders/` |
|
|
455
|
|
-| Live store or preview (the difference) | `app/Storefront/Storefront.php` |
|
|
456
|
|
-| Live store addresses | top of `routes/web.php`, `config/storefront.php` |
|
|
457
|
|
-| Publish and take offline | `app/Http/Controllers/StorePublishController.php` |
|
|
458
|
|
-| Plans, trial and limits | `app/Models/Plan.php`, `app/Models/User.php` (`currentPlan`), `app/Billing/UsageLimits.php` |
|
|
459
|
|
-| Subscriptions with Stripe | `app/Billing/` (`Billing`, `SubscriptionGateway`, `StripeSubscriptionGateway`) |
|
|
460
|
|
-| Billing page | `app/Http/Controllers/BillingController.php`, `resources/js/pages/billing/` |
|
|
461
|
|
-| Shipping fees | `app/Commerce/Shipping/`, store settings in `app/Http/Controllers/StoreSettingsController.php` |
|
|
462
|
|
-| Store settings page | `resources/js/pages/stores/settings.tsx` |
|
|
463
|
|
-| Mark as shipped and its email | `OrderController::ship`, `app/Mail/OrderShipped.php` |
|
|
464
|
|
-| WhatsApp links and phone cleaning | `app/Support/MalaysianPhone.php`, `resources/js/storefront/whatsapp.tsx` |
|
|
465
|
|
-| Shopper messages in English and Malay | `app/Storefront/StorefrontText.php`, `resources/js/storefront/text.ts` |
|
|
466
|
|
-| Discount codes | `app/Models/DiscountCode.php`, `app/Http/Controllers/DiscountCodeController.php`, `resources/js/pages/stores/discounts/` |
|
|
467
|
|
-| Discount in the cart and checkout | `Cart::applyCode` and `Cart::discount`, `Checkout::placeOrder` |
|
|
468
|
|
-| Product variants | `app/Models/ProductVariant.php`, `SaveProductRequest`, `ProductController::syncVariants`, `resources/js/components/stores/variant-editor.tsx` |
|
|
469
|
|
-| Cart logic | `app/Commerce/Cart.php`, `app/Http/Controllers/CartController.php` |
|
|
470
|
|
-| Bundles | `app/Models/BundleItem.php`, `app/Commerce/BundleStock.php`, `resources/js/components/stores/bundle-editor.tsx` |
|
|
471
|
|
-| Chat commands | `app/Commerce/ChatActions.php`, `StoreGenerationController::confirm`, `resources/js/components/stores/design-chat.tsx` |
|
|
472
|
|
-| Automatic discounts | `app/Models/AutomaticDiscount.php`, `app/Commerce/AutomaticDiscountRules.php`, `Cart::applied`, `AutomaticDiscountController` |
|
|
473
|
|
-| Hero photos | `app/StorePlan/HeroImages.php`, `HeroImageController`, `resources/js/storefront/sections/hero.tsx`, `components/stores/hero-picker.tsx` |
|
|
474
|
|
-| Announcement bar and trust row | `app/Storefront/Announcements.php`, `storefront/sections/announcement-bar.tsx`, `storefront/sections/trust-bar.tsx` |
|
|
475
|
|
-| Product page, phone menu | `storefront/pages/product.tsx`, `app/Storefront/RelatedProducts.php`, `components/stores/details-editor.tsx`, `storefront/sections/header.tsx` |
|
|
476
|
|
-| Storefront words (English, Malay) | `resources/js/storefront/text.ts` |
|
|
477
|
|
-| Store plan format (frontend types) | `resources/js/storefront/types.ts` |
|
|
478
|
|
-| Storefront renderer and sections | `resources/js/storefront/renderer.tsx`, `resources/js/storefront/sections/` |
|
|
|
438
|
+| Thing | Location |
|
|
|
439
|
+| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
440
|
+| Store model | `app/Models/Store.php` |
|
|
|
441
|
+| Store screens logic | `app/Http/Controllers/StoreController.php` |
|
|
|
442
|
+| Store categories, languages, statuses | `app/Enums/` |
|
|
|
443
|
+| Store form rules | `app/Http/Requests/Stores/CreateStoreRequest.php` |
|
|
|
444
|
+| Screens | `resources/js/pages/dashboard.tsx`, `resources/js/pages/stores/` |
|
|
|
445
|
+| Store tests | `tests/Feature/Stores/` |
|
|
|
446
|
+| Store plan format (the rules) | `app/StorePlan/PlanSchema.php` |
|
|
|
447
|
+| Store plan checker | `app/StorePlan/PlanValidator.php` |
|
|
|
448
|
+| Sample plan | `app/StorePlan/SamplePlan.php` |
|
|
|
449
|
+| Preview logic | `app/Http/Controllers/StoreDesignController.php` |
|
|
|
450
|
+| AI settings | `config/ai.php` (providers, models per task) |
|
|
|
451
|
+| AI layer and providers | `app/Ai/`, `app/Ai/Drivers/` |
|
|
|
452
|
+| AI prompts, generation and chat edits | `app/StorePlan/Ai/` |
|
|
|
453
|
+| Start an AI job (buttons) | `app/Http/Controllers/StoreGenerationController.php` |
|
|
|
454
|
+| Background AI job | `app/Jobs/RunStoreGeneration.php` |
|
|
|
455
|
+| Plan limits and usage counting | `config/plans.php`, `app/Billing/UsageLimits.php` |
|
|
|
456
|
+| Progress screen and chat box | `resources/js/components/stores/` |
|
|
|
457
|
+| Product model and photos | `app/Models/Product.php`, `app/Models/ProductImage.php` |
|
|
|
458
|
+| Product screens logic | `app/Http/Controllers/ProductController.php` |
|
|
|
459
|
+| Product screens | `resources/js/pages/stores/products/` |
|
|
|
460
|
+| Storefront Shop and product pages | `resources/js/storefront/pages/` |
|
|
|
461
|
+| Checkout and order logic | `app/Commerce/Checkout.php`, `app/Http/Controllers/CheckoutController.php` |
|
|
|
462
|
+| Payment providers | `app/Commerce/Payments/` (interface and Stripe) |
|
|
|
463
|
+| Stripe webhook | `app/Http/Controllers/StripeWebhookController.php` (address: `/stripe/webhook`) |
|
|
|
464
|
+| Orders for the merchant | `app/Http/Controllers/OrderController.php`, `resources/js/pages/stores/orders/` |
|
|
|
465
|
+| Order email | `app/Mail/OrderConfirmation.php`, `resources/views/mail/orders/` |
|
|
|
466
|
+| Live store or preview (the difference) | `app/Storefront/Storefront.php` |
|
|
|
467
|
+| Live store addresses | top of `routes/web.php`, `config/storefront.php` |
|
|
|
468
|
+| Publish and take offline | `app/Http/Controllers/StorePublishController.php` |
|
|
|
469
|
+| Plans, trial and limits | `app/Models/Plan.php`, `app/Models/User.php` (`currentPlan`), `app/Billing/UsageLimits.php` |
|
|
|
470
|
+| Subscriptions with Stripe | `app/Billing/` (`Billing`, `SubscriptionGateway`, `StripeSubscriptionGateway`) |
|
|
|
471
|
+| Billing page | `app/Http/Controllers/BillingController.php`, `resources/js/pages/billing/` |
|
|
|
472
|
+| Shipping fees | `app/Commerce/Shipping/`, store settings in `app/Http/Controllers/StoreSettingsController.php` |
|
|
|
473
|
+| Store settings page | `resources/js/pages/stores/settings.tsx` |
|
|
|
474
|
+| Mark as shipped and its email | `OrderController::ship`, `app/Mail/OrderShipped.php` |
|
|
|
475
|
+| WhatsApp links and phone cleaning | `app/Support/MalaysianPhone.php`, `resources/js/storefront/whatsapp.tsx` |
|
|
|
476
|
+| Shopper messages in English and Malay | `app/Storefront/StorefrontText.php`, `resources/js/storefront/text.ts` |
|
|
|
477
|
+| Discount codes | `app/Models/DiscountCode.php`, `app/Http/Controllers/DiscountCodeController.php`, `resources/js/pages/stores/discounts/` |
|
|
|
478
|
+| Discount in the cart and checkout | `Cart::applyCode` and `Cart::discount`, `Checkout::placeOrder` |
|
|
|
479
|
+| Product variants | `app/Models/ProductVariant.php`, `SaveProductRequest`, `ProductController::syncVariants`, `resources/js/components/stores/variant-editor.tsx` |
|
|
|
480
|
+| Cart logic | `app/Commerce/Cart.php`, `app/Http/Controllers/CartController.php` |
|
|
|
481
|
+| Bundles | `app/Models/BundleItem.php`, `app/Commerce/BundleStock.php`, `resources/js/components/stores/bundle-editor.tsx` |
|
|
|
482
|
+| Chat commands | `app/Commerce/ChatActions.php`, `StoreGenerationController::confirm`, `resources/js/components/stores/design-chat.tsx` |
|
|
|
483
|
+| Automatic discounts | `app/Models/AutomaticDiscount.php`, `app/Commerce/AutomaticDiscountRules.php`, `Cart::applied`, `AutomaticDiscountController` |
|
|
|
484
|
+| Hero photos | `app/StorePlan/HeroImages.php`, `HeroImageController`, `resources/js/storefront/sections/hero.tsx`, `components/stores/hero-picker.tsx` |
|
|
|
485
|
+| Announcement bar and trust row | `app/Storefront/Announcements.php`, `storefront/sections/announcement-bar.tsx`, `storefront/sections/trust-bar.tsx` |
|
|
|
486
|
+| Product page, phone menu | `storefront/pages/product.tsx`, `app/Storefront/RelatedProducts.php`, `components/stores/details-editor.tsx`, `storefront/sections/header.tsx` |
|
|
|
487
|
+| Store styles | `PlanSchema::STYLE_OPTIONS` and `STYLE_PRESETS`, `StoreStyleController`, `storefront/theme.ts`, `storefront/reveal.tsx`, `resources/css/app.css`, `components/stores/style-picker.tsx` |
|
|
|
488
|
+| Storefront words (English, Malay) | `resources/js/storefront/text.ts` |
|
|
|
489
|
+| Store plan format (frontend types) | `resources/js/storefront/types.ts` |
|
|
|
490
|
+| Storefront renderer and sections | `resources/js/storefront/renderer.tsx`, `resources/js/storefront/sections/` |
|
|
479
|
491
|
|
|
480
|
492
|
## 5. Open questions
|
|
481
|
493
|
|
|
|
@@ -503,33 +515,34 @@ Moved into **Step 9 — Modern store design** on 2026-11-17.
|
|
503
|
515
|
|
|
504
|
516
|
Add one line per work session: date, what was done, what is next.
|
|
505
|
517
|
|
|
506
|
|
-| Date | Done | Next |
|
|
507
|
|
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
|
|
508
|
|
-| 2026-11-14 | Planning. Chose stack, market, payments, AI models, plan prices. Checked local tools. Created this file. All proposed decisions confirmed. Added the rule that the AI model must be easy to change. | Install PHP 8.4, create the Laravel project (Step 0 and Step 1) |
|
|
509
|
|
-| 2026-11-14 | Installed PHP 8.4. Created the Laravel 13 + React project, MySQL database and git repo. Built create-a-store flow and dashboard. 51 tests pass; login and store creation checked in the browser. Step 0 and Step 1 done. | Step 2: store plan format, sections, renderer |
|
|
510
|
|
-| 2026-11-14 | Step 2 done on branch `feature/store-sections-renderer`: store plan format and validator, 10 sections with 2 variants each, renderer, dashboard preview, sample design. 69 tests pass; storefront checked in the browser on desktop and mobile. | Step 3: swappable AI layer and store generation |
|
|
511
|
|
-| 2026-11-14 | First commit made and pushed to the private repository on git.mirfalah.my (branch `feature/store-sections-renderer`). | Step 3: swappable AI layer and store generation |
|
|
512
|
|
-| 2026-11-14 | Step 3 built on branch `feature/ai-generation`: swappable AI layer (Claude, DeepSeek, fake), full store generation, chat edits, background job with progress screen, plan limits. 92 tests pass; whole flow checked in the browser with the fake provider. Not yet run against real Claude or DeepSeek. | Add API keys, run the real test, then Step 4 |
|
|
513
|
|
-| 2026-11-14 | Split settings into `.env` (uploaded, no secrets, AI settings blank) and `.env.local` (private, complete). Removed `.env.example`. | Real AI test, then Step 4 |
|
|
514
|
|
-| 2026-11-14 | Real AI test passed: Claude Sonnet 5.5 generated two stores, DeepSeek made two chat edits. Tuned the prompt for more varied layouts. Step 3 done. | Merge into `main`, then Step 4: products |
|
|
515
|
|
-| 2026-11-14 | Step 4 part 1 on branch `feature/commerce`: store plan version 2 with pages, products with photos, Shop page, product page, real products on the home page. 108 tests pass; checked in the browser; real Claude and DeepSeek re-tested with the new format. | Step 4 part 2: cart, Stripe checkout, orders, email |
|
|
516
|
|
-| 2026-11-14 | Cart built on branch `feature/commerce`: add to cart, quantity, remove, subtotal, header count, stock limits. 118 tests pass; checked in the browser. | Stripe checkout (needs test keys), orders, email |
|
|
517
|
|
-| 2026-11-15 | Step 4 finished on branch `feature/commerce`: checkout with Stripe (test mode), orders for the merchant, order confirmation email. 133 tests pass. A real Stripe test payment worked end to end: order paid, stock lowered, email written to the log. | Merge into `main`, then Step 5: publishing |
|
|
518
|
|
-| 2026-11-15 | Merged Steps 3 and 4 into `main` and pushed. | Step 5: publishing |
|
|
519
|
|
-| 2026-11-15 | Content pages by chat on branch `feature/content-pages`: add, rename and remove pages, each page at its own address, menu links guaranteed by the app. 139 tests pass; tested with real DeepSeek and in the browser. Step 4 is now complete except the known gaps. | Step 5: publishing |
|
|
520
|
|
-| 2026-11-15 | Planning only. Added Step 8 (discount codes, product variants, bundles with linked stock, chat commands with a confirm step), placed after Malaysia features. "Before launch" is now Step 9. Cart items redesigned as cards. | Step 5: publishing |
|
|
521
|
|
-| 2026-11-15 | Step 5 on branch `feature/publishing`: publish and take offline, live stores on their own address, design changes private until published again, dashboard blocked on store addresses. 150 tests pass; Luna Skin published and checked in the browser at `luna-skin.localhost:8000`. | Step 6: subscription billing |
|
|
522
|
|
-| 2026-11-16 | Step 6 on branch `feature/billing`: plans table, 14-day trial, Stripe subscriptions (subscribe, switch, cancel, undo), Billing page, limits enforced, live stores offline when there is no plan. 164 tests pass; real Stripe test subscription to Growth, cancel and undo all worked. Switched the session model from Fable 5.2 to Opus 5.5. | Merge into `main`, then Step 7 |
|
|
523
|
|
-| 2026-11-16 | Step 7 part 1 on branch `feature/malaysia-shipping`: store settings, flat shipping fees (west, east, free over), mark as shipped with tracking and email, WhatsApp buttons, Malay checkout messages, Malaysian phone check. Fixed live-store menu links on pages other than home (bug from Step 5). 178 tests pass; real Stripe test payment with shipping to Sabah worked. | Merge, then Step 7 part 2 or Step 8 |
|
|
524
|
|
-| 2026-11-16 | Featured product fix on branch `feature/featured-product-link` (built on `feature/malaysia-shipping`): the section links to a real product (Design tab picker or chat), shows its real name, price, photo and page, and hides the made-up price otherwise. Added a check that marks chat edits that changed nothing. 191 tests pass; checked in the browser and with real DeepSeek. | Merge both branches, then Step 7 part 2 or Step 8 |
|
|
525
|
|
-| 2026-11-16 | Planning only. Added "more design styles" to later improvements: style options (effects, backgrounds, buttons, spacing, motion), more fonts, more layouts per section, more section types. | Merge branches, then Step 7 part 2 or Step 8 |
|
|
526
|
|
-| 2026-11-16 | Step 8 part 1 on branch `feature/discount-codes`: discount codes (merchant Discounts tab, cart code box, order record, Stripe coupon, use counted when paid). 207 tests pass; real Stripe test payment with a 20% code worked. | Merge, then product variants |
|
|
527
|
|
-| 2026-11-16 | Step 8 part 2 on branch `feature/product-variants` (built on `feature/discount-codes`): product options and variants, option buttons on the product page, variant cart lines, orders and stock. 217 tests pass; real Stripe test payment for a 100ml variant with a discount code worked. | Merge both branches, then bundles |
|
|
528
|
|
-| 2026-11-16 | Step 8 part 3 on branch `feature/bundles`: bundles with linked stock (bundle editor in the product form, "What's inside" on the product page, shared stock check at checkout, order shows what to pack). 223 tests pass; real Stripe test payment for "Glow Starter Set" (cleanser + 50ml moisturiser, RM 69 + RM 8 shipping) lowered both items' stock. | Merge, then chat commands |
|
|
529
|
|
-| 2026-11-17 | Step 8 part 4 on branch `feature/chat-commands`: chat commands for products, discount codes and bundles, with Confirm and Cancel in the chat. Shared discount rules. Fixed a test that failed by chance (random stock). 233 tests pass; with real DeepSeek, "GLOW15 until end of month + 100ml to RM 52" was proposed, confirmed and saved; a product + bundle request was proposed correctly and cancelled. | Merge; then automatic discounts, Step 7 part 2 or Step 9 |
|
|
530
|
|
-| 2026-11-17 | Step 8 part 5 on branch `feature/automatic-discounts`: automatic discounts (Discounts tab form, best-of-one rule with codes, cart nudge, product page note, order/Stripe/email name, chat command). Step 8 is done. 243 tests pass; real Stripe test payment with "Glow Week" (2 cleansers, −RM 8.40, total RM 83.60) worked, GLOW15 correctly won when typed; real DeepSeek proposed a sunscreen-only sale correctly (cancelled). | Merge; then Step 7 part 2 or Step 9 |
|
|
531
|
|
-| 2026-11-17 | Chat commands can write product descriptions from the product name (same branch, `feature/automatic-discounts`). Real DeepSeek test found the AI guessing bundle contents, so bundle contents are now listed for it; second try was accurate. 244 tests pass. | Merge; then Step 7 part 2 or Step 9 |
|
|
532
|
|
-| 2026-11-17 | Researched 2026 store design trends and published a comparison page. Added Step 9 — Modern store design (6 parts) and the category guides decision; "Before launch" is now Step 10. | Step 9 part 1: photos first |
|
|
533
|
|
-| 2026-11-18 | Step 9 part 1 on branch `redesign/part-1-photo-hero`: full-width and split photo heroes, hero photo upload and picker in the Design tab, automatic product photo, second photo on hover, letter placeholders, AI told about photos. 251 tests pass; checked in the browser at desktop and phone width with a test banner on Luna Skin. | Merge, then part 2 |
|
|
534
|
|
-| 2026-11-18 | Step 9 part 2 on branch `redesign/part-2-announcement-bar` (from part 1): announcement bar (automatic lines + merchant lines, Settings card) and trust row section with live facts. Plan checker now supports "required if" rules. 257 tests pass; real DeepSeek added a trust row to Luna Skin correctly; checked in the browser. | Commit; part 3 branches from part 2 |
|
|
535
|
|
-| 2026-11-18 | Step 9 part 3 on branch `redesign/part-3-product-page` (from part 2): folding sections (form, chat with merge by title), trust points, sticky phone add-to-cart bar, pairs well with, phone menu, sticky photos. Found and fixed the sticky bar hiding under the header. 261 tests pass; real DeepSeek wrote a sensible "How to use" for the sunscreen (confirmed); checked at phone width. | Commit; part 4 branches from part 3 |
|
|
|
518
|
+| Date | Done | Next |
|
|
|
519
|
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
|
|
|
520
|
+| 2026-11-14 | Planning. Chose stack, market, payments, AI models, plan prices. Checked local tools. Created this file. All proposed decisions confirmed. Added the rule that the AI model must be easy to change. | Install PHP 8.4, create the Laravel project (Step 0 and Step 1) |
|
|
|
521
|
+| 2026-11-14 | Installed PHP 8.4. Created the Laravel 13 + React project, MySQL database and git repo. Built create-a-store flow and dashboard. 51 tests pass; login and store creation checked in the browser. Step 0 and Step 1 done. | Step 2: store plan format, sections, renderer |
|
|
|
522
|
+| 2026-11-14 | Step 2 done on branch `feature/store-sections-renderer`: store plan format and validator, 10 sections with 2 variants each, renderer, dashboard preview, sample design. 69 tests pass; storefront checked in the browser on desktop and mobile. | Step 3: swappable AI layer and store generation |
|
|
|
523
|
+| 2026-11-14 | First commit made and pushed to the private repository on git.mirfalah.my (branch `feature/store-sections-renderer`). | Step 3: swappable AI layer and store generation |
|
|
|
524
|
+| 2026-11-14 | Step 3 built on branch `feature/ai-generation`: swappable AI layer (Claude, DeepSeek, fake), full store generation, chat edits, background job with progress screen, plan limits. 92 tests pass; whole flow checked in the browser with the fake provider. Not yet run against real Claude or DeepSeek. | Add API keys, run the real test, then Step 4 |
|
|
|
525
|
+| 2026-11-14 | Split settings into `.env` (uploaded, no secrets, AI settings blank) and `.env.local` (private, complete). Removed `.env.example`. | Real AI test, then Step 4 |
|
|
|
526
|
+| 2026-11-14 | Real AI test passed: Claude Sonnet 5.5 generated two stores, DeepSeek made two chat edits. Tuned the prompt for more varied layouts. Step 3 done. | Merge into `main`, then Step 4: products |
|
|
|
527
|
+| 2026-11-14 | Step 4 part 1 on branch `feature/commerce`: store plan version 2 with pages, products with photos, Shop page, product page, real products on the home page. 108 tests pass; checked in the browser; real Claude and DeepSeek re-tested with the new format. | Step 4 part 2: cart, Stripe checkout, orders, email |
|
|
|
528
|
+| 2026-11-14 | Cart built on branch `feature/commerce`: add to cart, quantity, remove, subtotal, header count, stock limits. 118 tests pass; checked in the browser. | Stripe checkout (needs test keys), orders, email |
|
|
|
529
|
+| 2026-11-15 | Step 4 finished on branch `feature/commerce`: checkout with Stripe (test mode), orders for the merchant, order confirmation email. 133 tests pass. A real Stripe test payment worked end to end: order paid, stock lowered, email written to the log. | Merge into `main`, then Step 5: publishing |
|
|
|
530
|
+| 2026-11-15 | Merged Steps 3 and 4 into `main` and pushed. | Step 5: publishing |
|
|
|
531
|
+| 2026-11-15 | Content pages by chat on branch `feature/content-pages`: add, rename and remove pages, each page at its own address, menu links guaranteed by the app. 139 tests pass; tested with real DeepSeek and in the browser. Step 4 is now complete except the known gaps. | Step 5: publishing |
|
|
|
532
|
+| 2026-11-15 | Planning only. Added Step 8 (discount codes, product variants, bundles with linked stock, chat commands with a confirm step), placed after Malaysia features. "Before launch" is now Step 9. Cart items redesigned as cards. | Step 5: publishing |
|
|
|
533
|
+| 2026-11-15 | Step 5 on branch `feature/publishing`: publish and take offline, live stores on their own address, design changes private until published again, dashboard blocked on store addresses. 150 tests pass; Luna Skin published and checked in the browser at `luna-skin.localhost:8000`. | Step 6: subscription billing |
|
|
|
534
|
+| 2026-11-16 | Step 6 on branch `feature/billing`: plans table, 14-day trial, Stripe subscriptions (subscribe, switch, cancel, undo), Billing page, limits enforced, live stores offline when there is no plan. 164 tests pass; real Stripe test subscription to Growth, cancel and undo all worked. Switched the session model from Fable 5.2 to Opus 5.5. | Merge into `main`, then Step 7 |
|
|
|
535
|
+| 2026-11-16 | Step 7 part 1 on branch `feature/malaysia-shipping`: store settings, flat shipping fees (west, east, free over), mark as shipped with tracking and email, WhatsApp buttons, Malay checkout messages, Malaysian phone check. Fixed live-store menu links on pages other than home (bug from Step 5). 178 tests pass; real Stripe test payment with shipping to Sabah worked. | Merge, then Step 7 part 2 or Step 8 |
|
|
|
536
|
+| 2026-11-16 | Featured product fix on branch `feature/featured-product-link` (built on `feature/malaysia-shipping`): the section links to a real product (Design tab picker or chat), shows its real name, price, photo and page, and hides the made-up price otherwise. Added a check that marks chat edits that changed nothing. 191 tests pass; checked in the browser and with real DeepSeek. | Merge both branches, then Step 7 part 2 or Step 8 |
|
|
|
537
|
+| 2026-11-16 | Planning only. Added "more design styles" to later improvements: style options (effects, backgrounds, buttons, spacing, motion), more fonts, more layouts per section, more section types. | Merge branches, then Step 7 part 2 or Step 8 |
|
|
|
538
|
+| 2026-11-16 | Step 8 part 1 on branch `feature/discount-codes`: discount codes (merchant Discounts tab, cart code box, order record, Stripe coupon, use counted when paid). 207 tests pass; real Stripe test payment with a 20% code worked. | Merge, then product variants |
|
|
|
539
|
+| 2026-11-16 | Step 8 part 2 on branch `feature/product-variants` (built on `feature/discount-codes`): product options and variants, option buttons on the product page, variant cart lines, orders and stock. 217 tests pass; real Stripe test payment for a 100ml variant with a discount code worked. | Merge both branches, then bundles |
|
|
|
540
|
+| 2026-11-16 | Step 8 part 3 on branch `feature/bundles`: bundles with linked stock (bundle editor in the product form, "What's inside" on the product page, shared stock check at checkout, order shows what to pack). 223 tests pass; real Stripe test payment for "Glow Starter Set" (cleanser + 50ml moisturiser, RM 69 + RM 8 shipping) lowered both items' stock. | Merge, then chat commands |
|
|
|
541
|
+| 2026-11-17 | Step 8 part 4 on branch `feature/chat-commands`: chat commands for products, discount codes and bundles, with Confirm and Cancel in the chat. Shared discount rules. Fixed a test that failed by chance (random stock). 233 tests pass; with real DeepSeek, "GLOW15 until end of month + 100ml to RM 52" was proposed, confirmed and saved; a product + bundle request was proposed correctly and cancelled. | Merge; then automatic discounts, Step 7 part 2 or Step 9 |
|
|
|
542
|
+| 2026-11-17 | Step 8 part 5 on branch `feature/automatic-discounts`: automatic discounts (Discounts tab form, best-of-one rule with codes, cart nudge, product page note, order/Stripe/email name, chat command). Step 8 is done. 243 tests pass; real Stripe test payment with "Glow Week" (2 cleansers, −RM 8.40, total RM 83.60) worked, GLOW15 correctly won when typed; real DeepSeek proposed a sunscreen-only sale correctly (cancelled). | Merge; then Step 7 part 2 or Step 9 |
|
|
|
543
|
+| 2026-11-17 | Chat commands can write product descriptions from the product name (same branch, `feature/automatic-discounts`). Real DeepSeek test found the AI guessing bundle contents, so bundle contents are now listed for it; second try was accurate. 244 tests pass. | Merge; then Step 7 part 2 or Step 9 |
|
|
|
544
|
+| 2026-11-17 | Researched 2026 store design trends and published a comparison page. Added Step 9 — Modern store design (6 parts) and the category guides decision; "Before launch" is now Step 10. | Step 9 part 1: photos first |
|
|
|
545
|
+| 2026-11-18 | Step 9 part 1 on branch `redesign/part-1-photo-hero`: full-width and split photo heroes, hero photo upload and picker in the Design tab, automatic product photo, second photo on hover, letter placeholders, AI told about photos. 251 tests pass; checked in the browser at desktop and phone width with a test banner on Luna Skin. | Merge, then part 2 |
|
|
|
546
|
+| 2026-11-18 | Step 9 part 2 on branch `redesign/part-2-announcement-bar` (from part 1): announcement bar (automatic lines + merchant lines, Settings card) and trust row section with live facts. Plan checker now supports "required if" rules. 257 tests pass; real DeepSeek added a trust row to Luna Skin correctly; checked in the browser. | Commit; part 3 branches from part 2 |
|
|
|
547
|
+| 2026-11-18 | Step 9 part 3 on branch `redesign/part-3-product-page` (from part 2): folding sections (form, chat with merge by title), trust points, sticky phone add-to-cart bar, pairs well with, phone menu, sticky photos. Found and fixed the sticky bar hiding under the header. 261 tests pass; real DeepSeek wrote a sensible "How to use" for the sunscreen (confirmed); checked at phone width. | Commit; part 4 branches from part 3 |
|
|
|
548
|
+| 2026-11-19 | Step 9 part 4 on branch `redesign/part-4-style-options` (from part 3): style options, six ready-made looks with a Style box, 12 more fonts, gentle motion, AI style rules. Fixed fade-in hiding a section that was already partly on screen. "More layouts per section" moved to a new part 5; category guides are now part 6 and collections part 7. 266 tests pass; Bold look and a real DeepSeek "more premium and elegant" change both checked in the browser. | Commit; part 5 branches from part 4 |
|