# Pinata Farm - Comprehensive Application Guide

This document is optimized for AI agents to understand the functional landscape of the Pinata Farm application.

## 1. Functional Overview
Pinata Farm acts as a bridge between user imagination and handmade craftsmanship. It handles the entire lifecycle of a custom gift product, from initial AI-assisted design to final delivery.

## 2. Main User Journeys

### AI Design & Discovery
- **Concept Generation**: Users describe a theme (e.g., "A blue dragon for a 5-year-old"), and the system provides visual suggestions.
- **Gallery Exploration**: A showcase of handmade works categorized by occasion or design type.

### Ordering Workflow
- **Custom Requests**: Users can either use an AI-generated design or upload their own reference photos.
- **Specification**: Collection of details including size, filling (candies/gifts), and special notes.
- **Identity & Delivery**: Captures contact information and shipping addresses across major cities like Hanoi, Da Nang, and HCM City.

### Tracking & Management
- **Order ID System**: Every request is assigned a unique tracking code (e.g., AE1234).
- **Status Lifecycle**: Orders progress through states: Pending -> Confirmed -> Producing -> Shipping -> Delivered.
- **History**: Users can review their past requests through a local browser-based history page.

## 3. Product Information (FAQ)
- **What is a Pinata?**: A custom-shaped, colorful gift box that can be filled with treats.
- **Play Methods**: 
  - *Traditional*: Hanging it up and hitting it with a stick.
  - *Pull-string*: Suitable for children under 3 years old, where ribbons are pulled to release contents.
- **Alternative Samples**: Users are encouraged to upload their own images if they prefer non-AI designs.

## 4. Brand & Support Context
- **Philosophy**: "Handmade with Love" — emphasizing the manual craftsmanship of every piece.
- **Digital Presence**: Active on Facebook and Instagram for community engagement and sample showcasing.
- **Language**: Full bilingual support for Vietnamese and English audiences.