|
|
@@ -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-14
|
|
7
|
|
-**Current step:** Step 7 — Malaysia features (part 1 done: shipping fees, mark as shipped, WhatsApp buttons, Malay checkout messages; part 2 needs EasyParcel and WhatsApp Business accounts)
|
|
8
|
|
-**Next action:** Merge `feature/malaysia-shipping` into `main`. Then either Step 7 part 2 (needs an EasyParcel demo account and API key) or go on to Step 8 (discounts) and come back to part 2 later
|
|
|
6
|
+**Last updated:** 2026-11-16
|
|
|
7
|
+**Current step:** Step 7 — Malaysia features (part 1 done, plus the featured product fix; part 2 needs EasyParcel and WhatsApp Business accounts)
|
|
|
8
|
+**Next action:** Merge `feature/malaysia-shipping`, then `feature/featured-product-link` (built on top of it), into `main`. Then either Step 7 part 2 (needs an EasyParcel demo account and API key) or go on to Step 8 (discounts) and come back to part 2 later
|
|
9
|
9
|
|
|
10
|
10
|
Status marks: `[ ]` not started · `[~]` in progress · `[x]` done
|
|
11
|
11
|
|
|
|
@@ -130,6 +130,21 @@ Changing from Claude to another AI model (or back) must be a settings change, no
|
|
130
|
130
|
- WhatsApp numbers are saved as digits with country code (`60123456789`). Only Malaysian numbers are accepted. `MalaysianPhone` does the cleaning.
|
|
131
|
131
|
- Messages the server shows to shoppers live in `App\Storefront\StorefrontText`; words drawn in the browser live in `resources/js/storefront/text.ts`.
|
|
132
|
132
|
|
|
|
133
|
+### How the featured product section works (fixed in Step 7)
|
|
|
134
|
+
|
|
|
135
|
+- A `featured_product` section may hold `productSlug`: the web-address name of one of the store's active products. Product web-address names never change, even when a product is renamed, so the link stays good.
|
|
|
136
|
+- Linked: the store shows the product's real name, price, "price before discount", photo and sold-out state, and the button opens the product page. The AI's description and bullet points stay.
|
|
|
137
|
+- Not linked and the store has products: the price is hidden, because the AI's price is only an example.
|
|
|
138
|
+- Not linked and the store has no products: the AI's example name and price show, so a new store never looks empty.
|
|
|
139
|
+- The merchant links it with the "Featured product" picker on the Design tab, or by chat. The AI is given the store's product list; a made-up product name is sent back to the AI to fix.
|
|
|
140
|
+- The link is part of the design, so on a live store it shows after "Publish changes". Price and stock changes show straight away.
|
|
|
141
|
+- A linked product that is sold out shows a "Sold out" label, and its button says "View product".
|
|
|
142
|
+
|
|
|
143
|
+### AI edits must really change something (added 2026-11-16)
|
|
|
144
|
+
|
|
|
145
|
+- In a real test, the edit AI replied "Done" without including the change. The app no longer trusts the reply for this: it compares the design before and after each chat edit and saves the answer in `store_generations.changed`.
|
|
|
146
|
+- When nothing changed, the chat shows "No change was made to your design." under the AI's reply.
|
|
|
147
|
+
|
|
133
|
148
|
### Plan prices and limits (starting numbers, adjust after real usage)
|
|
134
|
149
|
|
|
135
|
150
|
| Plan | Price / month | Stores | Full regenerations / month | AI edits / month |
|
|
|
@@ -226,6 +241,7 @@ Part 1 (done 2026-11-16, no new accounts needed):
|
|
226
|
241
|
- [x] Checkout and cart error messages in the store's language
|
|
227
|
242
|
- [x] Checked which payment methods the Stripe account has: cards on; FPX and GrabPay supported by Stripe in Malaysia but not switched on yet (switch on in the Stripe dashboard, no code change). DuitNow QR, Touch 'n Go and Boost are not offered by Stripe
|
|
228
|
243
|
- [x] Tested with a real Stripe test payment on 2026-11-16: Sabah order, RM 15 shipping, total RM 70; then marked as shipped
|
|
|
244
|
+- [x] Fix: the "featured product" section can now be linked to a real product (picker on the Design tab, or by chat: "feature the green sambal"). Its real name, price, photo and page are shown. Before, it showed the AI's made-up name and price
|
|
229
|
245
|
|
|
230
|
246
|
Part 2 (needs outside accounts):
|
|
231
|
247
|
|
|
|
@@ -363,21 +379,22 @@ Then, from the project folder:
|
|
363
|
379
|
|
|
364
|
380
|
Add one line per work session: date, what was done, what is next.
|
|
365
|
381
|
|
|
366
|
|
-| Date | Done | Next |
|
|
367
|
|
-| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
|
|
368
|
|
-| 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) |
|
|
369
|
|
-| 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 |
|
|
370
|
|
-| 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 |
|
|
371
|
|
-| 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 |
|
|
372
|
|
-| 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 |
|
|
373
|
|
-| 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 |
|
|
374
|
|
-| 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 |
|
|
375
|
|
-| 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 |
|
|
376
|
|
-| 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 |
|
|
377
|
|
-| 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 |
|
|
378
|
|
-| 2026-11-15 | Merged Steps 3 and 4 into `main` and pushed. | Step 5: publishing |
|
|
379
|
|
-| 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 |
|
|
380
|
|
-| 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 |
|
|
381
|
|
-| 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 |
|
|
382
|
|
-| 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 |
|
|
383
|
|
-| 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 |
|
|
|
382
|
+| Date | Done | Next |
|
|
|
383
|
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
|
|
|
384
|
+| 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) |
|
|
|
385
|
+| 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 |
|
|
|
386
|
+| 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 |
|
|
|
387
|
+| 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 |
|
|
|
388
|
+| 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 |
|
|
|
389
|
+| 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 |
|
|
|
390
|
+| 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 |
|
|
|
391
|
+| 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 |
|
|
|
392
|
+| 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 |
|
|
|
393
|
+| 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 |
|
|
|
394
|
+| 2026-11-15 | Merged Steps 3 and 4 into `main` and pushed. | Step 5: publishing |
|
|
|
395
|
+| 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 |
|
|
|
396
|
+| 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 |
|
|
|
397
|
+| 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 |
|
|
|
398
|
+| 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 |
|
|
|
399
|
+| 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 |
|
|
|
400
|
+| 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 |
|