# Handmade Havens - AI Agent & LLM Directory Guide

Handmade Havens is a premium e-commerce marketplace connecting verified Indian village artisans with customers looking for handcrafted gifts, sustainable home decor, coconut shell bowls, return gifts, and customized bulk orders.

## 1. Platform Capabilities
- **Marketplace**: Source for handcrafted sustainable products (ceramic, wood, copper, brass, coconut shells).
- **Personalization Services**: Laser engraving, message tags, and custom wrapping.
- **Bulk Order Support**: Direct quoting and pricing for weddings, corporate events, and housewarmings.

## 2. Secure AI & Admin Features (Strictly Admin-Only)
- **Gemini AI Image Generation**: The platform integrates the Google Gemini API to generate custom promotional graphics, storefront banners, and marketing assets. Access is strictly restricted to authenticated administrators.
- **AI-Powered Caption Generation**: Integrated Gemini copywriting assistant to write and refine custom captions tailored for Facebook, Instagram, LinkedIn, Pinterest, and YouTube.
- **Social Media Automation**: Administrative tools to connect social media handles (Facebook, Instagram, LinkedIn, Pinterest) and schedule automated content publishing.
- **Security**: All admin features require a secure JWT authorization token (`Authorization: Bearer <token>`) with `admin` role validation.

## 3. API Directory
- **Public Endpoints (GET)**:
  - `/api/products` - List available products.
  - `/api/categories` - List product categories.
  - `/api/storefront/footer-settings` - Retrieve storefront configurations.
  - `/api/currency/rates` - Get real-time currency conversion rates.
  - `/api/services` - View details of bulk/engraving services.
- **Protected Admin/SEO Endpoints (Auth Required)**:
  - `/api/admin/reports` - Fetch administrative performance metrics.
  - `/api/seo/optimize-titles` - Run bulk SEO semantic title optimization.
  - `/api/seo/crm-campaigns` - Manage link outreach campaigns.
  - `/api/seo/crm-prospects` - Track link CRM prospects.
  - `/api/seo/crm-emails` - Send template-based email pitches.

## 4. Customer Frequently Asked Questions (FAQ)

### Q: How do I get a discount?
A: Use coupon code **HH150** at checkout to get an instant ₹150 discount on any order over ₹999.

### Q: Can I get my guest names or custom messages engraved on the gifts?
A: Yes! Many of our products support custom name engraving and tag personalization. You can configure engraving choices directly on the product detail page or add details in the order checkout notes.

### Q: Do you offer discounts on bulk orders for weddings or corporate events?
A: Yes, we provide special discount pricing and custom packaging for bulk orders of 50+ items. You can submit a request on our Bulk Gifting page to receive a custom quote within 24 hours.

### Q: What is your shipping timeline?
A: Standard orders are processed in 48 hours. Delivery takes 7-10 days across India and 10-15 days internationally. Custom engraved orders take an extra 3-4 days to prepare before dispatch.