icy-printing

As a user, I want all pages to share a consistent Artify 3D color palette and theme: Background #E8F0F2, Surface #F7F7F7, Text #333333, Accent #FF6F61, Muted #B0BEC5. Apply global CSS/theme variables, typography, and component styles across the entire frontend scaffold to match the design system.

As a customer, I want to use a backend API to place an order with delivery address and selected design, so the Checkout page can submit orders and trigger the fulfillment workflow.

As a designer, I want to use a backend API to retrieve my sales metrics and customer interaction data, so the Designer Dashboard page can display performance insights.

As an admin, I want to use a backend API to upload and manage 3D print templates available for customer selection, so the Templates Management page can maintain the design catalog.

Create FastAPI authentication endpoints for all user roles (customer, designer, admin, owner, artist). Includes: JWT token issuance and refresh, role-based access control middleware, password hashing, session management. Supports email/password and Google OAuth flows. Required by all login pages: Admin Login, Customer Login, Designer Login, Owner Login, Artist Login, Signup. Note: Google OAuth integration already covered by task 5df137e0.

Create FastAPI endpoints to fetch a single design/product by ID, including full details: title, images, description, pricing in INR, designer info, and category. Also expose endpoint to fetch related/recommended designs. Required by the Product Detail page (task d7c24375) and Landing page featured designs section.

Configure a file storage solution (e.g., local storage with Docker volume or S3-compatible object storage) for all uploaded assets: customer photos, 3D design files, portfolio images, showcase images, and ad banners. Implement a FastAPI file upload utility with validation (file type, size limits). Required by Photo Upload API (task 982627f9), Designer Designs API (task 7945ab7c), Owner Showcase API (task eb770aaf), and Templates Management API (task d3c9173d).

Implement role-based route protection in React Router. Guard routes by user role: admin routes (Admin Dashboard, Orders, Templates, Ads, Reports), designer routes (Designer Dashboard, Portfolio), artist routes (Artist Dashboard, Consultations, Design Studio, Profile), owner routes (Owner Dashboard, Showcase), and customer routes (Home, Checkout, Order Tracking). Redirect unauthenticated users to the appropriate login page. Depends on global state management.

Create seed scripts to populate the MySQL database with initial data: default admin and owner accounts, sample 3D design templates with placeholder images, design categories (Figurines, Jewelry, Home Decor, Architecture, Art Pieces), sample advertisement slots, and demo customer/designer accounts. Run via Alembic or a standalone seed script for development and staging environments.

As a customer, I want to be able to sign in via a dedicated Customer Login page (separate from Designer login) with email/password and Google Sign-In options, so I can access my personalized browsing, orders, and account features. Implements the Customer Login node from the Customer user flow.

As a new customer, I want to be able to create an account via the Signup page using Google Sign-In or email registration, so I can start browsing and ordering personalized 3D prints. Implements the Signup: Google Sign In node from the Customer user flow.

As a designer, I want a dedicated Designer Login page separate from the Customer Login, so I can sign in and access my designer portal with portfolio and sales management. Implements Designer Login: Sign In node from the Designer user flow.

As an artist, I want a dedicated Login page so I can sign in to access my dashboard, view consultation requests, and manage my design studio. Implements Login: Sign In node from the Artist user flow.

As an admin, I want a secure Admin Login page so I can authenticate and access the admin dashboard to manage orders, templates, ads, and reports. Implements Admin Login: Sign In node from the Admin user flow.

As the owner, I want a dedicated Owner Login page so I can securely access my owner dashboard to manage portfolio showcase and view performance. Implements Owner Login: Sign In node from the Owner user flow.

As a customer, I want to use a backend payment integration supporting UPI, credit card, and debit card in INR, so the Checkout page can securely process payments compliant with Indian financial regulations.

As a customer, I want to use a backend API to retrieve real-time order status and delivery location data, so the Order Tracking page can display live updates and map-based navigation.

As an admin, I want to use a backend API to list all customer orders and update their fulfillment status, so the Orders Management page can provide full order control.

As a user, I want the platform to support both English and Hindi languages so I can navigate and use Artify 3D in my preferred language across all pages.

Create FastAPI endpoints for customer delivery address management: add, update, delete, and list saved addresses. Address fields include full name, phone, street, city, state, pincode (India-specific), and landmark. Required by the Checkout page (task 269e382e) and Order Tracking page (task ac294873). Note: depends on auth middleware so only authenticated customers can access.

Create FastAPI endpoints for the consultation request workflow: customers create consultation requests, artists view pending requests, artists accept or decline requests, and consultation status updates. Required by the Consultations page (task 8b07d402) in the Artist user flow.

Create FastAPI endpoints for artist profile management: get profile, update bio, upload portfolio images, and manage portfolio display order. Required by the Artist Profile page (task 551c847b) and Artist Dashboard page (task 1ece46e5).

Create FastAPI endpoints for the Owner Dashboard: retrieve platform performance metrics (total sales, top designs, revenue charts, visitor stats) and owner's showcase portfolio summary. Required by the Owner Dashboard page (task ef2db21c). Distinct from the Owner Showcase API (task eb770aaf) which handles uploads.

Integrate GPT-5.4 via LiteLLM routing and Langchain for user-friendly AI responses (e.g., design recommendations, customer support chatbot). Integrate Google Nano Banana (or available image generation model) for AI-generated 3D design preview images. Expose FastAPI endpoints for AI-powered design suggestions and image generation. Required for the Design Studio page (task 607e2b2e) and Product page AI features.

Create a FastAPI endpoint that triggers on-demand regeneration of the System Requirements Document (SRD). Endpoint accepts updated project parameters and returns a regenerated SRD document. Include authorization so only admin/owner roles can trigger this. Required by the selective re-run capability specified in the SRD.

As a customer, I want to browse pre-uploaded 3D print designs on the Home page after logging in, with an Amazon-style product grid, category filters, featured designs, and a search bar, so I can easily find and select designs to purchase. Implements the Home: Browse Designs node from the Customer user flow.

As a designer, I want a Designer Dashboard page where I can view my sales metrics, customer interactions, and quick links to portfolio management, so I can manage my business on Artify 3D. Implements Designer Dashboard: View Sales and View Interactions nodes from the Designer user flow.

As an artist, I want an Artist Dashboard page to view my schedule, access consultation requests, and navigate to my Design Studio and Profile, so I can manage my workflow efficiently. Implements Dashboard: View Schedule node from the Artist user flow.

As an admin, I want an Admin Dashboard overview page with quick access to Orders, Templates, Ads, and Reports sections, so I can efficiently manage platform operations. Implements Admin Dashboard: View Overview node from the Admin user flow.

As the owner, I want an Owner Dashboard page where I can view my portfolio showcase and platform performance metrics, so I can track business growth and manage my presence. Implements Owner Dashboard: View Portfolio and View Performance nodes from the Owner user flow.

As an admin, I want to use a backend API to generate and export sales and performance reports with date filters, so the Reports page can provide actionable business insights.

As a customer, I want to view the details of a selected 3D print design on the Product page, including images, description, pricing in INR, and the option to upload a custom photo for personalization, so I can make an informed purchase. Implements Product: Select Design and Product: Upload Custom Photo nodes from the Customer user flow.

As a designer, I want a Portfolio page where I can upload new designs, manage existing ones, and showcase my completed 3D art to attract customers, so I can grow my sales on the platform. Implements Portfolio: Upload Design and Portfolio: Manage Designs nodes from the Designer user flow.

As an artist, I want a Consultations page where I can view and accept customer consultation requests for custom 3D print projects, so I can begin the design process. Implements Consultations: View Requests and Accept Request nodes from the Artist user flow.

As an artist, I want a Profile page where I can update my portfolio, bio, and showcase completed work to attract customers and build my brand on Artify 3D. Implements Profile: Update Portfolio node from the Artist user flow.

As an admin, I want an Orders page where I can view all customer orders and update their status (e.g., processing, shipped, delivered), so I can ensure timely fulfillment. Implements Orders: Manage Orders and Update Status nodes from the Admin user flow.

As an admin, I want a Templates page where I can upload new 3D print designs and manage existing templates available for customer selection, so the catalog stays fresh. Implements Templates: Upload Designs node from the Admin user flow.

As an admin, I want an Ads Management page where I can create, update, and manage advertisement slots displayed on the platform, so I can maximize monetization. Implements Ads: Manage Ad Slots node from the Admin user flow.

As an admin, I want a Reports page where I can generate and view sales and performance reports with charts and data exports, so I can monitor business health. Implements Reports: Generate Reports node from the Admin user flow.

As the owner, I want a Showcase page where I can upload pictures of previous and completed 3D art and manage the special display slot, so I can attract customers with my portfolio. Implements Showcase: Upload Completed Art and Manage Display Slot nodes from the Owner user flow.

As a customer, I want the Home Browse Designs page to fetch and display live design data from the backend Designs API, with working search, filters, and pagination.

As a customer, I want to complete my order on the Checkout page by entering my delivery address and selecting a payment method (UPI, credit card, debit card) in INR, so I can securely place my 3D print order. Implements Checkout: Enter Address and Checkout: Pay in INR nodes from the Customer user flow.

As an artist, I want a Design Studio page where I can create and upload new 3D designs, and submit them as templates for customer browsing, so I can contribute to the Artify 3D catalog. Implements Design Studio: Create Design, Upload Design, and Templates: Submit Template nodes from the Artist user flow.

As a customer, I want to track the status of my 3D print order on the Order Tracking page with live updates, map-based location navigation, and order history, so I can stay informed about my delivery. Implements Order Tracking: Track Order node from the Customer user flow.

As a customer, I want the Checkout page to integrate with the backend Order Placement and Payment Gateway APIs so I can complete UPI/card payments and receive an order confirmation.

As a customer, I want the Order Tracking page to display real-time order status and map-based delivery tracking by consuming the Order Tracking API.