This file is the single source of truth for the project plan and status. Update it at the end of every work session.
Last updated: 2026-11-14
Current step: Step 5 — Publishing (Step 4 Commerce is done and tested with a real Stripe test payment)
Next action: Merge the feature branches into main, then start Step 5: publish a store so real shoppers can open it (local: storename.localhost)
Status marks: [ ] not started · [~] in progress · [x] done
An AI store generator for ecommerce only, similar to amboras.com. A customer describes their brand, and the AI builds a complete online store.
| Topic | Decision |
|---|---|
| Customers | First-time founders and existing merchants |
| Market | Malaysia first |
| Team | Solo, as a business |
| Where we develop | Local machine first, no hosting yet |
| Topic | Decision |
|---|---|
| Backend | Laravel 13 on PHP 8.3 / 8.4 |
| Frontend | React + TypeScript |
| Payments | Stripe Malaysia |
| AI for first store generation | Claude Sonnet 5.5 (claude-sonnet-5-5) |
| Pricing rule | Each plan has a limited number of full regenerations per month |
| Template reuse | Later improvement (see section 6) |
| Topic | Decision |
|---|---|
| Laravel + React link | Inertia.js (official Laravel React starter kit) |
| Styling | Tailwind + shadcn/ui |
| Database | MySQL (already installed), one database, store_id on every table |
| Background jobs | Laravel queues (database driver first, Redis later) |
| Commerce backend | Our own: products, cart, orders, checkout. Not built on Shopify |
| How AI builds a store | AI picks and fills pre-built React sections. It never writes raw code |
| Store data | Saved as a “store plan”; later edits change small parts of it |
| AI for small edits | DeepSeek, called directly from Laravel (not through Hermes) |
| AI design | One swappable AI layer, so each task can use a different model |
| Shipping | EasyParcel |
| Languages | Bahasa Malaysia and English |
| Order notifications and chat button |
Changing from Claude to another AI model (or back) must be a settings change, not a code rewrite.
.env.local: which provider and which model. Example:
AI_GENERATE_PROVIDER=claude, AI_GENERATE_MODEL=claude-sonnet-5-5AI_EDIT_PROVIDER=deepseek, AI_EDIT_MODEL=deepseek-chatplan column of the stores table as JSON. Since Step 4 it is version 2: a theme (8 colours, heading font, body font, corner radius), one header and one footer shared by every page, and a list of pages. The first page is always home.id, a title and an ordered list of sections. Each section has an id, a type, a variant (layout) and content (the text). Section ids are unique in the whole plan.shop, products, cart, checkout and a few more) cannot be used as page ids.#section-id scrolls on the home page, /shop opens the Shop page. The storefront turns these into real addresses.PlanUpgrader converts an old version 1 plan to version 2.PlanSchema.php is the one place that says what is allowed. PlanValidator checks every plan before saving and removes anything unknown. Links can only point inside the page, inside the site, or to https, mailto and tel addresses.public storage disk, which needs php artisan storage:link once per machine.PaymentGateway), like the AI layer. Stripe is the only provider for now.PlanSchema.php and types.ts, write one React component, add one line in renderer.tsx.--sf-* CSS variables, so it never mixes with the dashboard theme.AiManager. It reads config/ai.php, which reads .env.local.claude, deepseek, and fake. The fake one needs no key and costs nothing: it returns the built-in sample design. Use fake for free development work.config/ai.php.PlanSchema.php) and the brand description, and answers with a store plan.PlanValidator. If it fails, the AI gets one chance to correct it. If it fails again, the job fails and the store is not changed.store_generations table, which also drives the progress screen and counts usage.config/plans.php.plan column of the users table.| Plan | Price / month | Stores | Full regenerations / month | AI edits / month |
|---|---|---|---|---|
| Free trial (14 days) | RM0 | 1 | 2 in total | 30 in total |
| Starter | RM39 | 1 | 3 | 100 |
| Growth | RM99 | 3 | 10 | 500 |
| Pro | RM249 | 10 | 30 | 2,000 |
php is still 8.2)ai_commerce)https://git.mirfalah.my/mirfalah-tech/ai_commerce.git. Branches main and feature/store-sections-renderer both hold Steps 1 and 2store_id (applies from Step 2 on)fake AI provider)storename.localhost)| Tool | Status |
|---|---|
| PHP | 8.4.27 at /opt/homebrew/opt/php@8.4/bin/php (used by this project). Default php is 8.2.30; 8.5.5 also installed |
| Composer | 2.9.7 |
| Node / npm | 24.14.1 / 11.11.0 |
| MySQL | 9.6.0 |
| PostgreSQL | Not installed (not needed, using MySQL) |
| Redis | Not installed (not needed yet) |
This project needs PHP 8.4, which is not the default php on this machine. In each new terminal, run this first:
export PATH="/opt/homebrew/opt/php@8.4/bin:$PATH"
Then, from the project folder:
| Task | Command |
|---|---|
| Start the app (server, queue, Vite) | composer run dev |
| Open the app | http://localhost:8000 |
| Run all tests | php artisan test |
| Check PHP style and types | composer lint and composer types:check |
| Check frontend | npm run check and npm run types:check |
| Rebuild frontend for tests | npm run build |
.env is uploaded to the repository and holds only basic, non-secret settings (secrets and all AI settings are blank). .env.local is never uploaded and holds everything needed to run, including keys. When .env.local exists the app reads it instead of .env, so it must be complete. This is set up in bootstrap/app.php.ai_commerce, settings in .env.local.php artisan db:seed. Email is in database/seeders/DatabaseSeeder.php, password in database/factories/UserFactory.php..env.local now uses the real providers (claude and deepseek), so every generation and edit costs a little money. To work for free, set both providers to fake. For real AI, set AI_GENERATE_PROVIDER=claude and AI_EDIT_PROVIDER=deepseek, and fill in ANTHROPIC_API_KEY and DEEPSEEK_API_KEY.composer run dev starts it. Without it, a job waits and is marked failed after 10 minutes.storage/logs/laravel.log, not sent.https://git.mirfalah.my/mirfalah-tech/ai_commerce.git (remote name origin). The .env.local file is never uploaded.| Thing | Location |
|---|---|
| Store model | app/Models/Store.php |
| Store screens logic | app/Http/Controllers/StoreController.php |
| Store categories, languages, statuses | app/Enums/ |
| Store form rules | app/Http/Requests/Stores/CreateStoreRequest.php |
| Screens | resources/js/pages/dashboard.tsx, resources/js/pages/stores/ |
| Store tests | tests/Feature/Stores/ |
| Store plan format (the rules) | app/StorePlan/PlanSchema.php |
| Store plan checker | app/StorePlan/PlanValidator.php |
| Sample plan | app/StorePlan/SamplePlan.php |
| Preview logic | app/Http/Controllers/StoreDesignController.php |
| AI settings | config/ai.php (providers, models per task) |
| AI layer and providers | app/Ai/, app/Ai/Drivers/ |
| AI prompts, generation and chat edits | app/StorePlan/Ai/ |
| Start an AI job (buttons) | app/Http/Controllers/StoreGenerationController.php |
| Background AI job | app/Jobs/RunStoreGeneration.php |
| Plan limits and usage counting | config/plans.php, app/Billing/UsageLimits.php |
| Progress screen and chat box | resources/js/components/stores/ |
| Product model and photos | app/Models/Product.php, app/Models/ProductImage.php |
| Product screens logic | app/Http/Controllers/ProductController.php |
| Product screens | resources/js/pages/stores/products/ |
| Storefront Shop and product pages | resources/js/storefront/pages/ |
| Checkout and order logic | app/Commerce/Checkout.php, app/Http/Controllers/CheckoutController.php |
| Payment providers | app/Commerce/Payments/ (interface and Stripe) |
| Stripe webhook | app/Http/Controllers/StripeWebhookController.php (address: /stripe/webhook) |
| Orders for the merchant | app/Http/Controllers/OrderController.php, resources/js/pages/stores/orders/ |
| Order email | app/Mail/OrderConfirmation.php, resources/views/mail/orders/ |
| Cart logic | app/Commerce/Cart.php, app/Http/Controllers/CartController.php |
| Storefront words (English, Malay) | resources/js/storefront/text.ts |
| Store plan format (frontend types) | resources/js/storefront/types.ts |
| Storefront renderer and sections | resources/js/storefront/renderer.tsx, resources/js/storefront/sections/ |
.env.local). Before real merchants sell, each merchant must be paid into their own account. The usual way is Stripe Connect. Decide before launch; it changes the checkout a little and adds an onboarding step for merchants.Add one line per work session: date, what was done, what is next.
| Date | Done | Next |
|---|---|---|
| 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) |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |