​

Shop System

​

Features

• Product catalog with categories
• Sale prices and featured products
• Image galleries per product
• Shopping cart (persistent)
• PayPal checkout integration
• Order tracking with status updates
• Secure file delivery for digital products
• Coupon system

​

Admin URLs

​

Adding Products

​

Order Management

​

Order Statuses

​

Managing Orders

1. Go to /admin/orders
2. Click on an order to view details
3. Update status from dropdown
4. Add notes for each step (visible to customer)
5. Upload delivery files for digital products

​

Secure File Delivery

1. Upload files to the order
2. Customer receives secure, time-limited download links
3. Links expire after 15 minutes
4. Only the order owner can download

​

Customer Experience

​

Shopping Flow

1. Browse products on /shop
2. Click product to view details
3. Add to cart
4. View cart and adjust quantities
5. Proceed to checkout
6. Pay with PayPal
7. View order status on dashboard

​

Customer Dashboard

• Order history
• Status tracking with visual stepper
• Download links for digital products
• Admin notes for each step

​

PayPal Integration

​

Setup

VITE_PAYPAL_CLIENT_ID=your_paypal_client_id

​

Test Mode

1. Create sandbox accounts in PayPal Developer
2. Use sandbox Client ID
3. Test purchases with sandbox buyer account

​

Database Schema

​

products Collection

{
  name: "Digital Art Pack",
  price: 29.99,
  discountedPrice: 19.99,
  onSale: true,
  featured: true,
  imageUrl: "https://...",
  galleryUrls: ["https://...", "https://..."],
  category: "Digital Products",
  tags: ["art", "design", "digital"],
  description: "<p>Beautiful digital art...</p>",
  additionalInfo: "<p>Format: PNG, 300dpi...</p>"
}

​

orders Collection

{
  orderId: "ORD-2024-001",
  customerId: "user123",
  customerEmail: "customer@example.com",
  items: "[{\"name\":\"Digital Art Pack\",\"price\":19.99,\"qty\":1}]",
  subtotal: 19.99,
  discount: 0,
  total: 19.99,
  status: "completed",
  paypalOrderId: "PAY-123..."
}

​

Coupon System