# راهنمای کاربری منتایم

راهنمای کامل استفاده از پلتفرم رزرو آنلاین خدمات محلی **منتایم** برای مشتریان و صاحبان کسب‌وکار.

> این فایل نسخه Markdown است. نسخه آنلاین در مسیر `/guide` و نسخه مناسب کپی در Notion/Docs در فایل `user-guide-notion.txt` قرار دارد.

---

## فهرست مطالب

1. [منتایم چیست؟](#۱-منتایم-چیست)
2. [شروع کار و ورود](#۲-شروع-کار-و-ورود)
3. [کشف کسب‌وکارها](#۳-کشف-کسب‌وکارها)
4. [صفحه کسب‌وکار و رزرو نوبت](#۴-صفحه-کسب‌وکار-و-رزرو-نوبت)
5. [پرداخت](#۵-پرداخت)
6. [مدیریت رزروها (مشتری)](#۶-مدیریت-رزروها-مشتری)
7. [امتیازدهی و حسن انجام کار](#۷-امتیازدهی-و-حسن-انجام-کار)
8. [پروفایل کاربری](#۸-پروفایل-کاربری)
9. [ثبت کسب‌وکار](#۹-ثبت-کسب‌وکار)
10. [پنل صاحب کسب‌وکار](#۱۰-پنل-صاحب-کسب‌وکار)
11. [مدیریت رزروها (صاحب کسب‌وکار)](#۱۱-مدیریت-رزروها-صاحب-کسب‌وکار)
12. [منوی پایین موبایل](#۱۲-منوی-پایین-موبایل)
13. [سؤالات متداول](#۱۳-سؤالات-متداول)

---

## ۱. منتایم چیست؟

منتایم پلتفرمی برای **کشف کسب‌وکارهای محلی** و **رزرو آنلاین نوبت** است؛ مثلاً کارواش، آرایشگاه و خدمات مشابه.

| نقش | کار اصلی |
|-----|----------|
| **مشتری** | پیدا کردن کسب‌وکار، رزرو، پرداخت، امتیاز |
| **صاحب کسب‌وکار** | مدیریت خدمات، ساعات، رزروها و تنظیمات لندینگ |

---

## ۲. شروع کار و ورود

### ورود با کد یکبارمصرف (پیشنهادی)

1. از منو **ورود** را بزنید (یا مسیر `/login`).
2. حالت **کد یکبارمصرف** را انتخاب کنید.
3. **شماره موبایل** خود را وارد کنید (مثال: `09121234567`).
4. **دریافت کد تأیید** را بزنید.
5. در صفحه **کد تأیید**، کد ۴ رقمی پیامک‌شده را وارد کنید.

### ورود با رمز عبور

1. در صفحه ورود، حالت **رمز عبور** را انتخاب کنید.
2. موبایل و رمز را وارد کنید و **ورود** را بزنید.

> **نکته:** اگر اولین بار است، با کد یکبارمصرف وارد شوید و بعداً از پروفایل رمز بسازید.

### ادامه بدون ورود

می‌توانید با **ادامه بدون ورود** کسب‌وکارها را ببینید؛ برای ثبت رزرو باید وارد شوید.

---

## ۳. کشف کسب‌وکارها

از **خانه** (`/app`):

1. لیست کسب‌وکارهای فعال را ببینید.
2. در صورت نیاز، با جستجو یا فیلتر **دسته** محدود کنید.
3. روی کارت کسب‌وکار بزنید تا صفحه آن باز شود.

### ظاهر کارت‌ها

| عرض صفحه | چیدمان |
|----------|--------|
| کمتر از ۴۲۵px | لیست افقی |
| ۴۲۵px به بالا | کارت با تصویر کاور (۲ تا ۵ ستون بسته به عرض) |

روی کارت معمولاً می‌بینید: تصویر کاور، نام، امتیاز، زیرعنوان، دسته و آدرس.

---

## ۴. صفحه کسب‌وکار و رزرو نوبت

### صفحه لندینگ

در صفحه کسب‌وکار می‌توانید ببینید:

- نام، زیرعنوان و توضیحات
- گالری تصاویر
- نکات برجسته (مثلاً رضایت مشتریان، رزرو آنلاین آسان)
- بنر تخفیف (در صورت فعال بودن)
- لیست خدمات

دکمه اصلی: **رزرو نوبت**

> اگر کسب‌وکار غیرفعال باشد پیام **این کسب‌وکار فعلاً غیرفعال است.** نمایش داده می‌شود.

### مراحل رزرو (`/app/businesses/:id/book`)

بسته به تنظیمات کسب‌وکار، مراحل ممکن است شامل این‌ها باشد:

1. **کلاس خدمات** (فقط اگر کلاس‌بندی فعال باشد؛ مثلاً اندازه خودرو)
2. **انتخاب خدمات** (می‌توانید چند خدمت انتخاب کنید؛ دوباره زدن = لغو انتخاب)
3. **تاریخ و ساعت**
4. **اطلاعات و پرداخت** — یادداشت اختیاری
5. **تایید نهایی** → **ثبت نهایی رزرو**

اگر بین راه وارد نباشید، به ورود هدایت می‌شوید و بعد به همین مسیر برمی‌گردید.

### بعد از ثبت رزرو

| حالت کسب‌وکار | نتیجه |
|---------------|--------|
| **تأیید خودکار** فعال | رزرو تأیید می‌شود و آماده **پرداخت آنلاین** است |
| تأیید دستی | وضعیت **در انتظار تأیید**؛ پس از تأیید صاحب، لینک پرداخت می‌آید |

---

## ۵. پرداخت

مسیر: `/app/bookings/pay`

1. مبلغ، کسب‌وکار و تاریخ را بررسی کنید.
2. **پرداخت آنلاین** را بزنید.
3. پس از موفقیت به لیست رزروها برگردید.

اگر خدمت با باشگاه مشتریان **رایگان** شده باشد، مبلغ رایگان نمایش داده می‌شود.

تخفیف درصدی (در صورت فعال بودن) معمولاً **خودکار** اعمال می‌شود و نیازی به وارد کردن کد نیست.

---

## ۶. مدیریت رزروها (مشتری)

از منو **رزروها** (`/app/bookings`):

| وضعیت | معنی تقریبی |
|--------|-------------|
| در انتظار تأیید | منتظر تأیید صاحب کسب‌وکار |
| منتظر پرداخت | باید پرداخت کنید |
| تأیید شده | پرداخت شده / تأیید نهایی |
| انجام شده | خدمت انجام شده |
| لغو شده | لغو شده |

**اقدامات مشتری:**

- **پرداخت** (وقتی منتظر پرداخت است)
- **لغو** (در وضعیت‌های مجاز)

اگر رزروی نباشد: **هنوز رزروی ثبت نکردید.**

---

## ۷. امتیازدهی و حسن انجام کار

بعد از اینکه صاحب کسب‌وکار رزرو را **انجام شد** علامت بزند:

1. پنجره **امتیاز** (۱ تا ۵ ستاره) باز می‌شود.
2. اگر **حسن انجام کار** فعال باشد:
   - **تمایل ندارم** → فقط امتیاز ثبت می‌شود
   - **تمایل دارم** → مبلغ قدردانی را وارد و پرداخت می‌کنید
3. اگر حسن انجام کار غیرفعال باشد، فقط **ثبت امتیاز** دارید.

---

## ۸. پروفایل کاربری

از آیکون پروفایل در هدر:

- مشاهده موبایل و نقش
- **تنظیم / تغییر رمز عبور**
- مشتری‌ها: لینک **ثبت کسب‌وکار من**
- صاحبان: **ورود به پنل کسب‌وکار**
- **خروج از حساب**

---

## ۹. ثبت کسب‌وکار

مسیر: `/app/register-business` (باید مشتری باشید و وارد شده باشید)

1. **نام کسب‌وکار**، **دسته‌بندی**، توضیحات، آدرس و تلفن را پر کنید.
2. **ارسال درخواست** را بزنید.
3. پس از بررسی ادمین، در صورت تأیید، نقش شما به صاحب کسب‌وکار تبدیل می‌شود و پنل فعال می‌شود.

> اگر از قبل کسب‌وکار داشته باشید یا درخواست در انتظار بررسی داشته باشید، امکان ارسال مجدد نیست.

---

## ۱۰. پنل صاحب کسب‌وکار

مسیر: `/app/owner` — عنوان منو: **کسب‌وکار من**

### اطلاعات کسب‌وکار

نام، زیرعنوان، توضیحات، تلفن، آدرس و **نکات برجسته لندینگ** (حداکثر ۳ مورد از لیست عمومی).

### لوگو و تصاویر

- لوگوی **حالت روشن** و **حالت تاریک** (اختیاری؛ اگر یکی باشد برای هر دو استفاده می‌شود)
- گالری تصاویر + انتخاب **کاور**

### تنظیمات نوبت‌دهی

- **پذیرش همزمان**
- **گام نوبت‌دهی (دقیقه)**
- **تأیید خودکار درخواست‌ها**
- **حسن انجام کار**
- **تخفیف درصدی** (عنوان، درصد، کد نمایشی، فقط اولین رزرو یا همه رزروها)

### ساعات پذیرش آنلاین

تعیین بازه‌های قابل رزرو برای روزهای هفته (همه روزها یکسان یا جداگانه).

### خدمات و قیمت‌ها

- افزودن خدمت از قالب‌ها یا پیشنهاد **خدمت سفارشی** (نیاز به تأیید ادمین)
- قیمت و مدت
- اختیاری: **خدمت رایگان دوره‌ای** (هر N بار یک‌بار رایگان)
- اختیاری: **کلاس‌بندی خدمات**

---

## ۱۱. مدیریت رزروها (صاحب کسب‌وکار)

در **رزروها** تب‌ها:

- **در انتظار تأیید**
- **تأیید شده**
- **لغو شده**

اقدامات:

| دکمه | کار |
|------|-----|
| **تأیید** | تأیید درخواست مشتری |
| **انجام شد** | پایان خدمت (امتیاز برای مشتری باز می‌شود) |
| **لغو** | لغو با وارد کردن **علت لغو** |

> صاحب کسب‌وکار کسب‌وکار خودش را در لیست کشف نمی‌بیند و نمی‌تواند برای خودش رزرو کند.

---

## ۱۲. منوی پایین موبایل

| آیتم | چه زمانی |
|------|----------|
| **خانه** | همیشه |
| **رزروها** | همیشه (بدون ورود → صفحه ورود) |
| **ثبت کسب‌وکار** | اگر صاحب کسب‌وکار نباشید |
| **کسب‌وکار من** | اگر صاحب کسب‌وکار باشید |
| **ورود** | مهمان |
| **خروج** | وارد شده |

---

## ۱۳. سؤالات متداول

**آیا بدون ورود می‌توانم رزرو کنم؟**  
خیر. مرور آزاد است؛ ثبت رزرو نیاز به ورود دارد.

**کد تخفیف را کجا وارد کنم؟**  
معمولاً نیاز نیست؛ اگر تخفیف فعال باشد هنگام رزرو/پرداخت خودکار اعمال می‌شود.

**چرا کسب‌وکار خودم را در لیست نمی‌بینم؟**  
عمدی است تا صاحب کسب‌وکار برای خودش رزرو نکند. از **کسب‌وکار من** مدیریت کنید.

**خدمت سفارشی کی در لیست مشتری می‌آید؟**  
پس از تأیید ادمین در پنل مدیریت پلتفرم.

**چطور رمز بسازم؟**  
با OTP وارد شوید → پروفایل → تنظیم رمز عبور.

---

## نسخه آنلاین و کپی

| خروجی | مسیر |
|--------|------|
| صفحه وب داخل اپ | `/guide` |
| این فایل Markdown | `docs/user-guide.md` |
| متن ساخت‌یافته برای Notion/Docs | `docs/user-guide-notion.txt` |

---

*منتایم — رزرو آنلاین خدمات محلی*