epic-candles

As a developer, I want a shared component library (buttons, cards, inputs, navbars, modals, badges) styled with the epic-candles design tokens so that every page maintains visual consistency and development velocity is maximized.

As a backend developer, I want a FastAPI endpoint to fetch a single product by ID with full details (images, variants, stock level, gift set flag, fragrance metadata) so that the Product detail page renders accurate and complete information.

As a backend developer, I want FastAPI endpoints for product create, read, update, and soft-delete with stock adjustment support so that admins can maintain accurate inventory records that feed directly into the Collection and Product pages.

As a guest or customer, I want to land on an engaging Home page that showcases the interactive cultural map of India, featured candle collections, and navigation entry points so that I can immediately browse or discover the brand and proceed to the Collection or Product pages. Implement based on the existing JSX design (v2).

As a guest, I want a Login page with email/password fields and a Sign In CTA so that I can authenticate and access my cart, orders, and subscription from any point in the Guest or Customer user flow (Guest: Product → Login).

As a guest, I want a Signup page with name, email, password, and phone fields so that I can create an account and transition into the authenticated Customer user flow for cart, checkout, and subscriptions (Guest: Product → Signup).

As a guest or customer, I want a Collection page with grid/list views, fragrance/theme/occasion filter panels, and search so that I can browse and discover candles that match my preferences before viewing a Product detail (Guest & User: Collection → Product).

As a customer, I want a Product detail page with image gallery, fragrance notes, occasion tags, quantity selector, gift message customization field, and Add-to-Cart CTA so that I can evaluate and add a candle or gift set to my cart (User: Product → Cart; Guest: Product → Login/Signup).

As a customer, I want a Cart page showing all added items with quantities, gift messages, subtotal, and a Proceed-to-Checkout CTA so that I can review my selections before entering the Checkout flow (User: Cart → Checkout).

As a backend developer, I want FastAPI endpoints for cart CRUD (add item, update quantity, remove item, fetch cart with totals) so that cart state is persisted server-side for authenticated users and synced with guest sessions.

As a customer, I want a Checkout page with address form, order summary, gift message review, and payment method selection (Razorpay / Paytm) so that I can complete my purchase securely (User: Checkout → Complete Payment).

As a customer, I want a Subscription page displaying available monthly candle box plans with pricing, frequency options, and a Subscribe CTA so that I can enroll in recurring deliveries directly from the Collection or Product page (User: Collection → Subscribe Box).

As an admin, I want a Dashboard page with KPI cards (total sales, revenue, active subscriptions), sales trend charts, and quick navigation to Inventory and Subscriptions so that I can monitor business health at a glance after login (Admin: Login → Dashboard).

As an admin, I want an Inventory page with a product table, stock level indicators, Add Product and Edit Product modals, and bulk status controls so that I can manage the candle catalog (Admin: Dashboard → Inventory → Add/Update).

As an admin, I want a Subscriptions management page with a subscriber table, subscription status filters, order history per subscriber, and pause/cancel controls so that I can oversee all active monthly box subscriptions (Admin: Dashboard → Subscriptions).

As a developer, I want the Login page wired to the existing FastAPI auth endpoints (JWT token issuance, session management) so that authenticated customers are redirected into the Customer flow and admins are routed to the Dashboard.

As a guest, I want the Signup page form to call the registration API, handle validation errors inline, and redirect me to the Home or Collection page upon success so that the onboarding experience is seamless.

As a guest or customer, I want the Collection page to fetch live catalog data, apply filter/search queries via API, and display results with loading and empty states so that I can seamlessly navigate to any Product detail page.

As a customer, I want the Product detail page to load live product data, handle gift message input, and trigger Add-to-Cart with variant and quantity so that I can confidently proceed to the Cart in the Customer user flow.

As a customer, I want the Cart page to sync with the cart API in real time, allow inline quantity edits and item removal, and display an accurate total so that I can confidently proceed to Checkout.

As a backend developer, I want FastAPI endpoints to create orders, initiate Razorpay and Paytm payment sessions, verify payment callbacks, and persist order records in MySQL so that purchases are processed securely and reliably.

As an admin, I want the Inventory page to load the product list via API, support inline stock edits, open modals for add/edit, and persist changes so that catalog updates are immediately reflected across the storefront.

As a customer, I want the Checkout page to submit my address, launch the Razorpay or Paytm payment widget, handle success and failure callbacks, and show an order confirmation so that my purchase is completed end-to-end.

As a backend developer, I want FastAPI endpoints to list subscription plans, create and update customer subscriptions, handle recurring billing via Razorpay subscriptions API, and store subscription state in MySQL so that monthly box deliveries are managed reliably.

As a customer, I want the Subscription page to fetch available plans, let me select a plan and frequency, initiate a recurring payment, and confirm my active subscription so that I am enrolled in monthly candle deliveries.

As a backend developer, I want FastAPI endpoints that aggregate sales totals, revenue by period, subscription counts, and top-selling products from MySQL so that the Admin Dashboard can display accurate and up-to-date business metrics.

As a backend developer, I want FastAPI admin endpoints to list all subscriptions with filters, fetch per-subscriber order history, and perform pause, resume, and cancel operations so that admins have full control over subscription lifecycle.

As a customer or guest, I want an AI-powered chat widget on the platform (backed by GPT and Langchain) that can answer fragrance queries, recommend candles by occasion, and handle subscription FAQs so that I receive instant support without leaving the storefront.

As an admin, I want the Dashboard page to pull live analytics from the API and render charts and KPI cards with refresh capability so that I have real-time visibility into sales and subscription performance.

As an admin, I want the Subscriptions management page to fetch live subscriber data, support status filtering, and execute pause or cancel actions via API so that subscription management is fully operational within the Admin flow.