lemon-ecommerce

As a customer or guest, I want a visually appealing home page so that I can browse featured bakery products, see promotions, and navigate to the catalog or cake builder. Implement a hero banner with CTA, a featured products carousel with hover animations (cakes 'rising' on hover), a category grid (cakes, pastries, breads, etc.), and a promotional section. Wire navigation links to Catalog and Cake Builder pages. Apply the global theme established in t1.

As a registered user (admin or customer), I want a polished login page so that I can securely sign in and be redirected to the appropriate page. Integrate the existing Login (v1) design with the global theme, connect to the existing auth API, handle validation errors inline, support a 'Remember me' option, and redirect admins to the dashboard and customers to the home page post-login.

As a new visitor, I want a signup page so that I can create a customer account and start ordering. Integrate the existing Signup (v1) design with the global theme, add form validation (email format, password strength, confirm password), connect to the registration API endpoint, show success feedback, and redirect to the home page after successful signup.

As a backend developer, I want admin product CRUD endpoints so that admins can create, update, and deactivate products. Implement POST /admin/products, PUT /admin/products/{id}, PATCH /admin/products/{id}/status, DELETE /admin/products/{id}, and image upload to object storage (S3/MinIO). Add role-based access control restricting these to admin users. Validate all fields including INR price, category enum, and image requirements.

As a backend developer, I want cake builder configuration and pricing APIs so that the frontend can load available options and calculate live prices. Implement GET /cake-builder/options returning sizes, layers, frostings, fillings, and decorations with prices in INR; POST /cake-builder/price-preview accepting a partial/full configuration and returning computed total; POST /cake-builder/save to persist a named design linked to a user account.

As an admin, I want a dashboard overview page so that I can monitor sales performance, recent orders, and key metrics at a glance. Integrate the existing Dashboard (v1) design with the theme, display KPI cards (total sales in INR, orders today, top-selling products, revenue trend), embed a sales chart (weekly/monthly), show a recent orders table with status badges, and link to Products and Orders management sections.

As a customer or guest, I want a catalog page so that I can browse all bakery products, filter by category, and search by keyword. Integrate the existing Catalog (v1) design, implement a debounced search bar, sidebar/horizontal category filter chips, product grid cards (image, name, price in INR, Add to Cart button), sort options (price, popularity, newest), and pagination or infinite scroll. Connect to the products listing API.

As a backend developer, I want cart management endpoints so that authenticated customers can persist their cart across sessions. Implement GET /cart, POST /cart/items (add standard or cake builder items), PUT /cart/items/{id} (update quantity), DELETE /cart/items/{id}, and DELETE /cart (clear cart). Support serialized cake builder configurations in cart items. Return all totals in INR.

As a customer using the cake builder, I want AI-generated design suggestions so that I can get inspiration and auto-populate the builder with a coherent theme. Build POST /ai/cake-suggestions endpoint accepting a prompt or occasion type (birthday, wedding, anniversary) and returning 3-5 complete cake configurations mapped to valid builder option IDs. Integrate with LLM API using LangChain for conversational flows and structured JSON output compatible with the cake builder configuration schema.

As a DevOps engineer, I want product images served via a CDN with automatic optimization so that catalog and product pages load fast within the 3-second requirement. Set up an S3-compatible bucket (or MinIO in K8s) for product image storage, configure CloudFront or Nginx-based CDN, add image resizing/compression on upload using Pillow or imgproxy, and update product API to return CDN URLs for all image fields.

As an admin, I want a products management page so that I can view, add, edit, and remove bakery products in the catalog. Integrate the existing Products (v1) design, implement a data table with search and category filter, Add Product button opening a modal/drawer form (name, description, price in INR, category, images, availability toggle), inline edit and delete actions, and pagination. Connect to product CRUD API endpoints.

As an admin, I want an orders management page so that I can view all customer orders and update their fulfillment status. Integrate the existing Orders (v1) design for admin view, show an orders table with order ID, customer name, items summary, total in INR, placed-at timestamp (IST), and status. Add a status dropdown per row (Pending, Confirmed, Baking, Out for Delivery, Delivered, Cancelled), filter by status and date range, and connect to the admin orders API.

As a customer or guest, I want a product detail page so that I can view full information about a bakery item before adding to cart or customizing it. Integrate the existing Product (v1) design, display image gallery, name, description, price in INR, size/variant selector, quantity stepper, Add to Cart button, a 'Customize with Cake Builder' CTA for eligible products, and related products section. Connect to the product detail API.

As a backend developer, I want order placement and management endpoints so that customers can place orders and admins can manage fulfillment. Implement POST /orders (create from cart), GET /orders (customer: own; admin: all with filters), GET /orders/{id}, PATCH /admin/orders/{id}/status (update fulfillment status). Store and return all timestamps in IST and amounts in INR. Include order line items, delivery address, and payment reference.

As a customer, I want an interactive cake builder page so that I can visually customize my cake in real time before adding it to cart. Integrate the existing Cake Builder (v1) design, implement a step-by-step customization panel (size, layers, frosting, filling, decorations, message text), a 3D canvas preview using Three.js or Babylon.js with real-time rendering, drag-and-drop decoration placement, spin-the-cake view, a live price calculator in INR, and an Add to Cart button passing the full configuration. Ensure mobile responsiveness.

As a backend developer, I want secure payment processing endpoints so that customers can complete purchases via Razorpay or Paytm. Implement POST /payments/initiate (create payment order with gateway SDK), POST /payments/verify (validate payment signature, update order to Confirmed on success), and POST /payments/webhook (handle async notifications). Store all amounts in INR paise and log all payment events for PCI DSS audit compliance.

As a backend developer, I want analytics endpoints so that the admin dashboard can display sales KPIs and trends. Implement GET /admin/analytics/summary (total revenue in INR, orders count, top products, new customers for date range), GET /admin/analytics/revenue-trend (daily/weekly/monthly time series in IST), and GET /admin/analytics/top-products. Aggregate from orders table and optimize queries with appropriate indexes.

As a customer, I want a shopping cart page so that I can review selected items, adjust quantities, and proceed to checkout. Integrate the existing Cart (v1) design, list cart items with thumbnail, name, customization summary (for cake builder items), unit price and line total in INR, quantity stepper, remove item button, order summary panel (subtotal, delivery fee, total in INR), and a Proceed to Checkout CTA. Persist cart state via API or local storage with auth-aware sync.

As a customer, I want an 'Inspire Me' AI feature in the cake builder so that I can get design suggestions and apply them instantly. Add an 'Inspire Me' button to the Cake Builder page that opens an occasion/prompt picker, calls the AI suggestions API, displays suggestion cards with previews and descriptions, and allows one-click application to populate all builder controls. Show loading skeletons during API call and handle errors gracefully.

As a customer, I want a checkout page so that I can enter delivery details, review my order, and pay securely. Integrate the existing Checkout (v1) design, implement a multi-step flow (Address → Review → Payment), address form with validation, order summary with INR pricing, delivery date/time slot picker (IST), and Razorpay or Paytm payment gateway SDK for card/UPI/net-banking. Handle payment success, failure, and pending states with appropriate redirects to the orders tracking page.

As a customer, I want an orders tracking page so that I can view my order history and track the real-time status of active orders. Integrate the existing Orders (v1) design for customer view, display a list of past and active orders with order ID, placed date (IST), items summary, total in INR, and a status timeline/stepper (Placed → Confirmed → Baking → Out for Delivery → Delivered). Add a reorder button and link to order detail. Connect to the customer orders API.