# سند نیازمندی‌های محصول (Product Requirement Document - PRD)
**پروژه:** فروشگاه آنلاین و سامانه تخصصی مکمل‌های دامپزشکی Canina Iran  
**نسخه:** ۲.۰ (به‌روزرسانی Brownfield)  
**نویسنده:** ایجنت Product Manager (`02_product_manager.md`)

---

## ۱. اهداف بیزینس و چشم‌انداز (Product Vision)
برند **Canina pharma GmbH** آلمان تولیدکننده مکمل‌های تخصصی دامپزشکی با گواهی IFS و HACCP است. هدف پروژه ارائه بستری فوق‌پیشرفته، زیبا، سریع و سئومحور برای فروش محصولات اصل کانینا در ایران است که ۳ دسته از مخاطبان را پوشش می‌دهد:
1. **صاحبان پت خانگی (Pet Owners):** نیازمند راهنمایی علمی تعاملی برای انتخاب دقیق مکمل بر اساس وزن، سن و نیازمندی پت.
2. **کاربران دارای نسخه دامپزشک:** نیازمند خرید مستقیم و سریع بدون معطلی در مراحل راهنما.
3. **خریداران عمده (پت‌شاپ‌ها، کلینیک‌ها و دامپزشکان):** نیازمند احراز هویت اختصاصی، مشاهده قیمت‌های تخفیف‌دار عمده پس از تایید ادمین و ثبت سفارش حجمی آسان (Bulk Order Matrix).

---

## ۲. دیتای مرجع محصولات کانینا (Real Catalog Data)
دیتابیس پروژه حاوی دیتای واقعی محصولات برند کانینا (از جمله Canina Ballaststoff Mix, Canhydrox GAG, Eierschalenpulver, Flexan, Herz Vital, Immun-Booster, Barfer's Best, Petvital Catlax و غیره) است.
- **تعداد دقیق محصولات مرجع:** ۳۰+ محصول واقعی.
- **ویژگی‌های استخراج شده هر محصول:** نام فارسی و انگلیسی، کد Art No، بارکد، گروه‌بندی (مفاصل، گوارش، سیستم ایمنی، ویتامین، بارف/تغذیه خام)، ترکیبات کامل، دوز و نحوه مصرف، وزن/حجم، قیمت خرید و فروش، گروه هدف (سگ / گربه / هر دو).

---

## ۳. مسارهای اصلی کاربر (User Journeys & Core UX)

### ۳.۱. مسیر کاربر خانگی (Pet Owner Flow) - "Wizard تعاملی توصیه مکمل"
- **توصیف:** یک راهنمای گام‌به‌گام و مصور (Interactive Recommendation Wizard).
- **مراحل:**
  1. انتخاب نوع پت (سگ یا گربه).
  2. وارد کردن وزن (کیلوگرم)، سن (ماه/سال) و میزان فعالیت.
  3. انتخاب عارضه یا هدف تغذیه‌ای (مثلاً: سلامت مفاصل، ریزش مو و پوست، گوارش و هضم، تقویت سیستم ایمنی، تغذیه خام/BARF).
  4. محاسبه هوشمند دوز دقیق مصرفی و پیشنهاد محصول مرتبط بر اساس قوانین `SmartAdvisorRule`.
  5. افزودن مستقیم محصول پیشنهادی به سبد خرید با دوز محاسبه شده.

### ۳.۲. مسیر کاربر دارای نسخه (Prescribed User Flow)
- **توصیف:** خرید سریع و مستقیم.
- **ویژگی‌ها:**
  - جستجوی لحظه‌ای (Instant Search / Autocomplete) با نام فارسی، انگلیسی یا Art No.
  - کاتالوگ و دسته‌بندی فیلترپذیر بدون اجبار به ورود به Wizard.
  - افزودن یک‌کلیکی به سبد خرید و چک‌اوت سریع.

### ۳.۳. مسیر خریداران عمده (Wholesale Buyers Flow)
- **توصیف:** ویژه کلینیک‌ها، پت‌شاپ‌ها و داروخانه‌های دامپزشکی.
- **ویژگی‌ها:**
  - فرم ثبت‌نام/درخواست احراز هویت خریدار عمده با قابلیت بارگذاری پروانه کسب / کارت نظام دامپزشکی.
  - عدم نمایش قیمت‌های عمده به کاربران عادی و ثبت‌نام‌نشده.
  - پس از تایید حساب کاربری توسط ادمین (تغییر نقش به `User_Wholesale`):
    - دسترسی به **Bulk Order Matrix** (جدول سفارش حجمی) برای ورود تعداد هر سایز/محصول در یک صفحه و ثبت یک‌باره سفارش.
    - اعمال تخفیف‌های پله‌ای/عمده روی فاکتور.

### ۳.۴. نیازمندی‌های سئو و فنی (Technical & SEO Requirements)
- **Structured Data:** پیاده‌سازی کامل JSON-LD استاندارد schema.org برای `Product`, `MedicalWebPage`, `BreadcrumbList`, `Organization`.
- **متا تگ‌های داینامیک:** Open Graph، Twitter Cards، عنوان و توضیحات داینامیک بر اساس اطلاعات هر محصول.
- **طراحی UI/UX:** مدرن، شیک، با رنگ‌بندی متناسب با گرید دارویی کانینا، میکرو-انیمیشن‌ها، Glassmorphism، و واکنش‌گرایی ۱۰۰٪ در تمامی رزولوشن‌ها.

---

## ۴. ماتریس تیکت‌ها و برنامه اجرایی (Actionable Backlog Roadmap)
تیکت‌ها بر اساس اولویت‌بندی اتمیک و وابسته در `.ai_agency/memory/backlog.json` تعریف می‌شوند.