canina/docs/02-user-guide.md
parsa aghaei 7615aa0e51 fix: resolve seed encoding, search param, and wiki data source issues
- Fix seed-products.ts TS error (implicit any) and BOM handling
- Re-run full seed to restore correct Persian encoding in DB
- Fix productService query→search param mismatch
- Fix IngredientWiki hardcoded port 4000→use settingsStore
- Restore seed-products-data.json from git after accidental corruption
2026-07-11 15:40:49 +03:30

4.2 KiB
Raw Blame History

راهنمای کاربری سیستم (User Guide)

سیستم کانینا از نظر نوع مخاطب به دو دسته کلی B2C (مشتریان عادی) و B2B (کلینیک‌ها و فروشگاه‌ها) تقسیم می‌شود. علاوه بر این، نقش «ادمین» برای مدیریت سیستم وجود دارد.

۱. مشتریان عادی (B2C Users)

مشتری عادی کسی است که وارد سایت می‌شود تا برای حیوان خانگی خود مکمل خریداری کند یا اطلاعات کسب کند.

کاربر چه کارهایی می‌تواند انجام دهد؟

  • جستجو و کشف محصول: می‌تواند محصولات را بر اساس دسته‌بندی‌ها (سگ، گربه، نوع بیماری، ویتامین‌ها) فیلتر کرده و جستجو کند.
  • مشاهده جزئیات دقیق محصول: مطالعه مشخصات دارویی، ترکیبات، نحوه مصرف، نظرات و همچنین قیمت و وضعیت موجودی.
  • استفاده از دانشنامه (Wiki): مطالعه درباره مواد موثره به کار رفته در محصولات (مانند بیوتین، گلوکزآمین) و دیدن محصولات مرتبط با هر ماده.
  • ثبت پروفایل حیوان خانگی (Pet Profile): کاربر می‌تواند اطلاعات حیوانات خود (نام، نژاد، سن، وضعیت عقیم‌سازی، بیماری‌های زمینه‌ای) را ثبت کند. سیستم از این اطلاعات برای شخصی‌سازی محصولات استفاده می‌کند.
  • مشاوره هوشمند (Smart Advisor): با وارد کردن مشخصات حیوان و مشکلی که دارد (مثلاً ریزش مو یا مشکل مفاصل)، سیستم بهترین مکمل‌های موجود را به صورت هوشمند پیشنهاد می‌دهد.
  • مدیریت سبد خرید و سفارش: افزودن محصولات به سبد، استفاده از کدهای تخفیف، استفاده از موجودی کیف پول و در نهایت پرداخت از طریق درگاه بانکی.
  • پیگیری سفارش: مشاهده وضعیت سفارشات (در حال بررسی، ارسال شده، تحویل داده شده).

۲. مشتریان تجاری (B2B Users / کلینیک‌ها و داروخانه‌ها)

این دسته از کاربران پس از ثبت‌نام و تایید هویت توسط ادمین، به پورتال B2B دسترسی پیدا می‌کنند.

کاربر B2B چه کارهایی می‌تواند انجام دهد؟

  • مشاهده قیمت‌های همکاری: محصولات را با قیمت عمده یا درصد تخفیف ویژه همکاری مشاهده می‌کنند.
  • ثبت سفارشات عمده (Bulk Order): رابط کاربری ویژه‌ای برای سفارش سریع محصولات در تعداد بالا دارند، بدون اینکه نیازی باشد وارد صفحه تک‌تک محصولات شوند.
  • پرداخت اعتباری/چکی: در صورت تایید مدیریت، قابلیت پرداخت غیرنقدی یا ثبت اسناد در سیستم برای آن‌ها فعال می‌شود.

۳. مدیران سیستم (Admins)

مدیران از طریق پنل مدیریت (که جدا از رابط کاربری اصلی است) سیستم را کنترل می‌کنند.

مدیر چه کارهایی می‌تواند انجام دهد؟

  • مدیریت محصولات: تعریف محصول جدید، مدیریت موجودی انبار، تغییر قیمت‌ها و تنظیم متادیتای سئو.
  • مدیریت کاربران و نقش‌ها: تایید حساب‌های B2B، مدیریت سطوح دسترسی.
  • مدیریت سفارشات: تغییر وضعیت سفارشات (به ارسال شده و...) و ثبت کدهای پیگیری پستی.
  • گزارش‌گیری: مشاهده گزارش فروش، محصولات پرطرفدار و وضعیت مالی کیف پول‌ها.
  • مدیریت محتوا: نوشتن مقالات بلاگ و اطلاعات دانشنامه دارویی.