راه‌اندازی سیستم مدیریت مجموعه

این ترتیب برای اولین بار راه‌اندازی مجموعه پیشنهاد می‌شود:

1. پنل مدیریت: ساخت مجموعه، اتصال کاربران، فعال‌سازی ماژول لیزر یا پذیرش کلاسیک، ذخیره «جریان پذیرش» و «جریان لیزر»
2. تنظیمات ⁦←⁩ هویت سایت: عنوان، لوگو، رنگ و فونت
3. منو ⁦←⁩ فرم پذیرش: طراحی فرم پذیرش (فقط اگر پذیرش کلاسیک فعال است)
4. تنظیمات ⁦←⁩ استایل پرینت: اندازه کاغذ، سربرگ، سپس «ویرایش استایل پرینت»
5. تنظیمات ⁦←⁩ فیلدهای پرونده: فیلدهای اطلاعات بیمار
6. تنظیمات ⁦←⁩ کد پذیرش: قالب شماره پذیرش
7. تنظیمات ⁦←⁩ تنظیمات مالی و «حساب‌های پیش‌فرض»
8. تنظیمات ⁦←⁩ اعلان‌ها (در صورت نیاز)
9. پذیرش کلاسیک: «ویزیت پزشک»، «اسناد پذیرش»، «چک‌لیست جراحی»، «دلایل لغو»
10. منو: پزشکان، مشاوران، خدمات، انبار
11. تنظیمات لیزر: شیفت‌های کاری، اپراتورها، دستگاه‌ها، نواحی لیزر، محصولات مصرفی
12. وب اپلیکیشن (در صورت نیاز): فعال‌سازی در پنل پلتفرم، محتوا، ظاهر، SEO، ورود کاربران — جزئیات
13. تست: یک پذیرش آزمایشی ثبت کنید

نقش‌ها از منوی «پرسنل و دسترسی» ⁦←⁩ «نقش‌ها» قابل تنظیم هستند. هر کاربر باید به مجموعه مورد نظر متصل باشد و از بالای صفحه مجموعه فعال را انتخاب کند.

مسیر: /admin/clinics — فقط برای مدیر سیستم.

مجموعه‌ها

با «مجموعه جدید» کلینیک بسازید. فیلدهای فرم:

در هر ردیف: مدیریت مجموعه · جریان پذیرش · جریان لیزر · کاربران مجموعه

جریان پذیرش پذیرش کلاسیک

مسیر: /admin/clinics/.../admission-workflow — دکمه: «ذخیره جریان پذیرش»

تنظیمات کلی

• فعال‌سازی جریان خودکار پذیرش
• پذیرش کلاسیک — فقط وقتی ماژول لیزر فعال است نمایش داده می‌شود؛ خاموش = فقط پذیرش لیزر

هدایت به صفحه (رفتن کاربر)

بعد از هر رویداد (ایجاد پذیرش، ویزیت، تأیید، پرداخت، …) کاربر به کدام صفحه برود: جزئیات پذیرش، اتاق پزشک، ویزیت، تأیید مشتری، فاکتور، تعیین وقت عمل، اتاق عمل، چک‌لیست.

مراحل جریان

هر مرحله: سوییچ فعال/غیرفعال + «عنوان نمایشی مرحله».

انتقال وضعیت پرونده (مرحله بعدی)

پس از ایجاد، ویزیت، تأیید (با/بدون مالی)، پرداخت، ثبت وقت عمل — وضعیت پرونده به کجا برود.

برچسب وضعیت‌های پذیرش

متن نمایشی هر وضعیت در لیست پذیرش‌ها.

صفحه تعیین وقت عمل

عنوان صفحه، توضیح، برچسب دکمه‌ها، برچسب تاریخ و محل، محل‌های جراحی (لیست + گزینه «سایر»).

برچسب مراحل چک‌لیست جراحی

نام هر مرحله در چک‌لیست عمل.

جریان لیزر لیزر

مسیر: /admin/clinics/.../laser-workflow — دکمه: «ذخیره جریان لیزر»

مراحل جریان لیزر

انتقال بین مراحل

پس از مشاوره، ارزیابی، برنامه‌ریزی، تسویه، زمان‌بندی، اتمام جلسه، مراقبت — مرحله بعدی چیست.

برچسب وضعیت‌ها

متن وضعیت‌های لیزر در اتاق لیزر.

اتاق لیزر

عنوان صفحه و توضیح صفحه در لیست اتاق لیزر.

فیلدهای ارزیابی پوست

فیلدهای دلخواه: برچسب، نوع (متن، متن چندخطی، انتخابی، بله/خیر، عدد)، اجباری بودن.

کاربران مجموعه

مسیر: /admin/clinics/.../users

• انتخاب از سامانه: کاربر موجود + نقش
• کاربر جدید: نام، نام کاربری، ایمیل، تلفن، رمز، وضعیت، نقش

منو ⁦←⁩ «تنظیمات» — /settings

هر تب دکمه «ذخیره» جداگانه دارد. «چک‌لیست جراحی» و «دلایل لغو» بلافاصله با هر افزودن/ویرایش ذخیره می‌شوند.

هویت سایت

اطلاعات عمومی

عنوان سایت · شعار / توضیح کوتاه · ایمیل پشتیبانی · تلفن پشتیبانی

رنگ اصلی سیستم

رنگ حالت روشن · رنگ حالت تیره

فونت سیستم

فونت فارسی و انگلیسی: ایران‌یکان (محلی — بدون Google Fonts)

حالت رنگی

فعال بودن حالت تیره · تم پیش‌فرض (سیستم / روشن / تیره)

تصاویر و برندینگ

لوگو (روشن/تیره) · فاوآیکون (روشن/تیره)

فرم پذیرش (منوی اصلی)

منو ⁦←⁩ «فرم پذیرش» — /admission-form

قبل از ثبت اولین پذیرش واقعی، فرم پذیرش را طراحی کنید: فیلدهای سفارشی، ترتیب نمایش و نوع هر فیلد (متن، انتخابی، تاریخ و …).

استایل پرینت

• اندازه کاغذ: A4 یا A5
• تصویر سربرگ پرینت: آپلود تصویر
• ویرایش استایل پرینت: لینک به /print-style (بعد از آپلود سربرگ)

فیلدهای پرونده

«فیلدهای اطلاعات عمومی پرونده» — برای هر فیلد: نمایش، اجباری، عنوان، عرض، ترتیب (کشیدن و رها کردن).

فیلدها: نام و نام خانوادگی، موبایل، کد ملی، تلفن ثابت، ایمیل، تاریخ تولد، سن، جنسیت، وضعیت تأهل، شغل، آدرس، بیمار VIP، فعال.

کد پذیرش

کد پذیرش کلاسیک

پیشوند · پسوند · «استفاده از عدد در کد» · «شروع شماره از» · «دامنه شماره» (این مجموعه / سراسری) · پیش‌نمایش کد

کد پذیرش لیزر

پیشوند · پسوند · «استفاده از عدد در کد» · «شروع شماره از» · «دامنه شماره» (این مجموعه / سراسری) · پیش‌نمایش کد — فقط وقتی ماژول لیزر فعال باشد.

شیفت‌های کاری لیزر

مسیر: /settings?tab=laser-shifts — تب «شیفت‌های کاری»

ساعت پیش‌فرض شیفت صبح و عصر برای همه اپراتورها. در صفحه /laser/operators هنگام تعریف شیفت، «صبح» یا «عصر» همین بازه را اعمال می‌کند.

• فعال — شیفت صبح/عصر
• عنوان نمایشی — مثلاً «صبح» یا «شیفت اول»
• ساعت شروع / پایان — فرمت ۰۸:۰۰

تنظیمات مالی

مسیر: /settings — تب «تنظیمات مالی»

• فعال‌سازی بخش مالی — روشن/خاموش کردن کل قابلیت‌های پولی در مجموعه
• واحد نمایش: ریال یا تومان
• افزودن مالیات به فاکتور + «نرخ مالیات (درصد)»

حساب‌های پیش‌فرض (در تب تنظیمات مالی)

بانک، صاحب حساب، شماره کارت، شماره حساب، شبا — برای ثبت پرداخت وقتی پزشک حساب اختصاصی ندارد.

وقتی «فعال‌سازی بخش مالی» روشن باشد چه چیزهایی اضافه می‌شود؟

با روشن بودن این گزینه، بخش‌های زیر در سامانه ظاهر یا فعال می‌شوند. با خاموش بودن، قیمت و فاکتور در هیچ‌جا نمایش داده نمی‌شود و ثبت پرداخت ممکن نیست.

حقوق و مزایا حسابداری داخلی

مسیر: /settings?tab=payroll — تب «حقوق و مزایا»

این بخش مستقل از «تنظیمات مالی بیمار» است. حتی اگر فاکتور و پرداخت بیمار خاموش باشد، می‌توانید حقوق پرسنل را محاسبه کنید.

فعال‌سازی

• فعال‌سازی محاسبه حقوق — روشن/خاموش کردن کل ماژول حقوق و منوی حسابداری

اپراتورهای لیزر لیزر

فقط وقتی ماژول لیزر فعال باشد.

• محاسبه حقوق اپراتور
• مبنای محاسبه — «درآمد جلسه» (هزینه محاسبه‌شده) یا «مبلغ پرداخت‌شده جلسه»
• درصد پیش‌فرض قرارداد — اگر برای دستگاه/اپراتور درصد اختصاصی نباشد
• اولویت درصد دستگاه / اپراتور — ترتیب اعمال درصد اختصاصی

مشاوران پذیرش کلاسیک

فقط وقتی پذیرش کلاسیک فعال باشد.

• محاسبه حقوق مشاور
• روش محاسبه:
  • «درصد از کل مبلغ پذیرش» — یک‌بار روی جمع فاکتور (نه هر پرداخت جدا)
  • «مبلغ ثابت به ازای هر پذیرش»
• درصد پیش‌فرض / مبلغ ثابت — اگر برای مشاور در صفحه «مشاوران» مقدار اختصاصی ثبت نشده باشد

پیش‌نیازها

• اپراتورها در /laser/operators — درصد اختصاصی (اختیاری)
• مشاوران در منوی «مشاوران» — درصد یا حالت محاسبه (اختیاری)
• برای مشاور با حالت درصدی: «فعال‌سازی بخش مالی» و ثبت فاکتور/پرداخت پذیرش

اعلان‌ها

فعال‌سازی توستر · موقعیت · مدت نمایش · حداکثر هم‌زمان · فاصله · تم · رنگ‌های غنی · دکمه بستن · پیش‌نمایش زنده (موفقیت، خطا، اطلاعات، هشدار).

ویزیت پزشک پذیرش کلاسیک

• توضیحات پزشک — نمایش و عنوان
• بیمار ویژه
• هزینه بیمارستان (با مالی فعال)
• امکان تغییر قیمت در تکمیل پذیرش (با مالی فعال)

اسناد پذیرش

چک‌لیست جراحی پذیرش کلاسیک

دسته جدید / ویرایش دسته: نام، مرحله، اجباری، فعال

آیتم جدید / ویرایش آیتم: برچسب، توضیح، اجباری، فعال

دلایل لغو پذیرش کلاسیک

دلایل لغو پذیرش — عنوان، گزینه «سایر»، ترتیب

دلایل لغو جراحی — عنوان، گزینه «سایر»، ترتیب

مشاوران پذیرش کلاسیک

منو ⁦←⁩ «پرسنل و دسترسی» ⁦←⁩ «مشاوران» — مسیر: /consultants

پیش‌نیاز

• «پذیرش کلاسیک» در پنل مدیریت فعال باشد
• کاربر مورد نظر ابتدا در «کاربران مجموعه» (پنل مدیریت) یا «کاربران» (منوی مجموعه) ساخته و به مجموعه وصل شده باشد
• دسترسی «مشاهده/ثبت مشاور» در نقش کاربر تنظیم شده باشد

ثبت مشاور

دکمه «مشاور جدید» — فیلدهای فرم:

کجا استفاده می‌شود؟

• ثبت پذیرش جدید از پرونده بیمار یا «پذیرش‌ها» — پنجره «انتخاب پزشک و مشاور» (اگر بیش از یک مشاور باشد، باید انتخاب شود)
• جزئیات پذیرش — فیلد «نام مشاور»
• اتاق پزشک و اتاق عمل — نام مشاور در کارت پذیرش
• تاریخچه پذیرش‌های پرونده — نام مشاور برای هر پذیرش

خدمات و انبار

تنظیمات لیزر

اپراتورها — مراحل راه‌اندازی

1. در /settings?tab=laser-shifts ساعت شیفت صبح و عصر را تنظیم کنید.
2. در /laser/operators اپراتور را ثبت کنید و دستگاه‌های مجاز را انتخاب کنید.
3. از دکمه «شیفت و مرخصی» — روزهای کاری (صبح/عصر/سفارشی) و در صورت نیاز مرخصی ثبت کنید.
4. در /laser/devices نیز می‌توانید اپراتورهای مجاز هر دستگاه را تنظیم کنید (دوطرفه).

حسابداری مدیریت داخلی

منوی کناری ⁦←⁩ گروه «حسابداری» — نیاز به دسترسی «مشاهده حسابداری» یا «مدیریت حقوق»

جریان حقوق و دستمزد

1. در /settings?tab=payroll تنظیمات حقوق را فعال و فرمول‌ها را مشخص کنید.
2. در /accounting/payroll بازه را انتخاب کنید (دستی یا «ماه جاری» / «ماه قبل»).
3. پیش‌نمایش را بررسی کنید و «ثبت این دوره» یا «ثبت دوره جدید» را بزنید.
4. در صفحه جزئیات دوره، «نهایی‌سازی» را تأیید کنید — محاسبات ثابت می‌ماند.
5. پس از پرداخت واقعی به پرسنل، «ثبت پرداخت» را بزنید — دوره در فیلتر «پرداخت‌شده» دیده می‌شود.

فرمول‌های محاسبه

• اپراتور: مجموع (مبنای جلسه تکمیل‌شده × درصد قرارداد)
• مشاور (درصدی): درصد × کل مبلغ فاکتور پذیرش — یک‌بار برای هر پذیرش
• مشاور (ثابت): مبلغ ثابت × تعداد پذیرش در بازه

وب اپلیکیشن مدیریت مجموعه

منوی کناری ← «وب اپلیکیشن» — مسیر: /settings/web-app

وب‌اپ سایت موبایل‌محور مجموعه است که روی دامنه جدا اجرا می‌شود. تمام متن‌ها، رنگ‌ها و تصاویر از CRM تنظیم می‌شوند.

فعال‌سازی

1. پنل مدیریت پلتفرم ⁦←⁩ مجموعه‌ها ⁦←⁩ انتخاب مجموعه ⁦←⁩ وب اپلیکیشن — مسیر: /admin/clinics/{id}/web-app
2. سوییچ «فعال‌سازی وب اپلیکیشن» را روشن کنید، Slug را تنظیم و ذخیره کنید
3. در CRM همان مجموعه، منوی کناری وب اپلیکیشن ظاهر می‌شود

شناسه Slug چیست؟

Slug شناسه یکتای مجموعه در API وب‌اپ است. هر درخواست API با ?slug=... یا (در production) با دامنه مرورگر، مجموعه را مشخص می‌کند.

اتصال وب‌اپ به CRM (Slug، env و دامنه)

فایل webapp/.env (نمونه):

VITE_CRM_API_URL=http://127.0.0.1:8000
VITE_WEB_APP_SLUG=demo

آدرس Bootstrap: https://crm.example.com/api/web-app/bootstrap?slug=demo

ورود پیامکی (OTP)

1. تنظیمات ← پیامک — پنل ملی‌پیامک یا پارس‌گرین را فعال کنید
2. وب اپلیکیشن ← ورود کاربران ← ورود پیامکی — پنل، الگو و متن پیامک (خط آخر: @domain #code برای خواندن خودکار)

ورود با Google (۰ تا ۱۰۰)

برای فعال‌سازی «ورود با Google» باید یک OAuth Client در Google Cloud بسازید و Client ID و Secret را در CRM وارد کنید.

مرحله ۱ — ورود به Google Cloud

1. به Google Cloud Console بروید و با حساب Google وارد شوید
2. از بالای صفحه یک پروژه بسازید یا پروژه موجود را انتخاب کنید

مرحله ۲ — صفحه رضایت OAuth (OAuth consent screen)

1. منو ⁦←⁩ APIs & Services ⁦←⁩ OAuth consent screen
2. نوع External (یا Internal اگر Workspace دارید) را انتخاب کنید
3. نام اپلیکیشن، ایمیل پشتیبانی و دامنه (در صورت داشتن) را پر کنید
4. در Scopes حداقل email، profile و openid کافی است
5. اگر حالت Testing است، ایمیل کاربران تست را در بخش Test users اضافه کنید

مرحله ۳ — ساخت OAuth Client ID

1. منو ⁦←⁩ APIs & Services ⁦←⁩ Credentials ⁦←⁩ Create Credentials ⁦←⁩ OAuth client ID
2. Application type: Web application
3. Authorized JavaScript origins — آدرس فرانت وب‌اپ:
   • توسعه: http://localhost:5174
   • Production: دامنه وب‌اپ — مثال https://app.example.com
4. Authorized redirect URIs — آدرس callback سرور CRM (مهم):
   • https://YOUR-CRM-DOMAIN/api/web-app/auth/google/callback
   • مثال محلی: http://127.0.0.1:8000/api/web-app/auth/google/callback
5. بعد از Create، Client ID و Client Secret را کپی کنید

مرحله ۴ — تنظیم در CRM مجموعه

1. منوی کناری ⁦←⁩ وب اپلیکیشن ⁦←⁩ تب ورود کاربران
2. بخش «ورود با Google» را فعال کنید
3. Client ID و Client Secret را از Google Cloud paste کنید و ذخیره کنید

مرحله ۵ — تست

1. وب‌اپ را با Slug درست باز کنید
2. روی ورود با Google بزنید — باید به صفحه Google هدایت شوید
3. پس از تأیید، به وب‌اپ برمی‌گردید و وارد می‌شوید

بازیابی رمز عبور

در تب ورود کاربران، گزینه «بازیابی رمز با پیامک» را فعال کنید. کاربر شماره موبایل ثبت‌شده را وارد می‌کند، کد تأیید می‌گیرد و رمز جدید تنظیم می‌کند.

مشاوران و صف

منوی پرسنل ← مشاوران — تعریف مشاور، شبکه‌های اجتماعی، جایگاه صف. کاربران وب‌اپ فقط شبکه‌های مشاور اختصاص‌یافته را می‌بینند.

لیست کاربران وب‌اپ: پرسنل ← کاربران وب‌اپ — /web-app-users

عیب‌یابی سریع

• Slug پنل پلتفرم = env وب‌اپ (VITE_WEB_APP_SLUG) یا ?slug= در URL ⁦←⁩ وب‌اپ باز نمی‌شود
• پنل پیامک فعال در تنظیمات + همان پنل در تب ورود کاربران انتخاب شده ⁦←⁩ OTP نمی‌آید
• تب SEO، robots روی index، دامنه اختصاصی و زمان ایندکس گوگل ⁦←⁩ SEO در گوگل نیست
• Redirect URI در Google Cloud = آدرس /api/web-app/auth/google/callback روی CRM ⁦←⁩ ورود Google خطا می‌دهد
• استایل شبکه اجتماعی یا دکمه‌های پایین در پیش‌نمایش عوض نمی‌شود ⁦←⁩ تب ظاهر ← استایل بخش‌ها را ذخیره کنید (یا تب شبکه‌های اجتماعی — هر دو به یک تنظیم وصل‌اند)
• تصویر Hero یا لوگو در وب‌اپ نیست ⁦←⁩ در تب ظاهر ← رسانه و آمار آپلود و ذخیره کنید

ترتیب پیشنهادی راه‌اندازی وب‌اپ

بعد از فعال‌سازی در پنل پلتفرم، این ترتیب برای اولین بار پیشنهاد می‌شود:

1. پنل پلتفرم: فعال‌سازی، Slug، دامنه اختصاصی (در صورت production) — /admin/clinics/.../web-app
2. Deploy / env: build وب‌اپ، اتصال به CRM — جزئیات
3. زبان‌ها: تب «زبان‌ها» — زبان پیش‌فرض، RTL/LTR، پرچم
4. محتوا: تب «محتوا» — عنوان Hero، زیرعنوان، متن دکمه‌ها، شمارنده‌های آمار — جزئیات
5. ظاهر: تم آماده، رنگ‌ها، استایل بخش‌ها، Hero، تصاویر — جزئیات
6. شبکه‌های اجتماعی: لینک پلتفرم‌ها + استایل نمایش — جزئیات
7. تماس، فوتر، SEO: تب‌های مربوط در همان صفحه
8. ورود کاربران: OTP، Google، بازیابی رمز — در صورت نیاز
9. مشاوران: تعریف مشاور + جایگاه صف — اگر مودال مشاوره فعال است
10. نمونه کارها و FAQ: دسته، رسانه، سؤال/پاسخ
11. تست نهایی: باز کردن وب‌اپ روی موبایل، ورود، FAQ، نمونه کارها

دسترسی‌های وب اپلیکیشن

منوی «وب اپلیکیشن» در CRM فقط با دسترسی مناسب دیده می‌شود:

از منوی «پرسنل و دسترسی» ← «نقش‌ها» این دسترسی‌ها را به «مدیر مجموعه» یا نقش اختصاصی بدهید.

تب محتوا — متن‌ها و شمارنده‌ها

مسیر: /settings/web-app — تب استودیو «محتوا»

ابتدا زبان محتوا را انتخاب کنید؛ متن‌ها برای همان زبان ذخیره می‌شوند. برای چند زبان، از تب «زبان‌ها» زبان اضافه کنید و محتوا را برای هر زبان جداگانه ویرایش کنید.

بخش‌های متنی مهم صفحه اصلی

تب ظاهر — Theme، Hero و رسانه

تب استودیو «ظاهر» — چهار زیرتب دارد:

۱. استایل بخش‌ها

تغییرات بلافاصله در پیش‌نمایش دیده می‌شوند. قبل از انتشار حتماً ذخیره کنید.

۲. Hero — تصویر، چیدمان و تایپوگرافی

• جایگاه تصویر Hero: سمت چپ (پیش‌فرض) یا سمت راست
• چیدمان متن: کلاسیک، ادیتوریال (خط عمودی)، فشرده، اسپات‌لایت
• تراز عمودی: بالا / وسط / پایین — برای چسباندن متن به بالا یا پایین Hero
• خط افقی / خط عمودی: ضخامت، رنگ، ارتفاع خط عمودی، فاصله از متن
• فاصله‌گذاری:
  • فاصله بلوک متن از تصویر — مقدار منفی = چسبیدن عنوان به عکس
  • فاصله بین متن و تصویر — فاصله مستقیم دو بلوک
  • فاصله بخش از بالا/پایین/چپ و راست
• عنوان / زیرعنوان: فونت جدا (مثلاً ایران نستعلیق)، اندازه، رنگ، فاصله از راست
• تصویر: حاشیه، سایه، پس‌زمینه پشت عکس، گردی گوشه‌ها

۳. تم و رنگ

• استایل آماده (Preset): Modern، Classic، Clinical، Luxury و … — با تغییر preset، رنگ‌ها و layout پیش‌فرض عوض می‌شود
• فونت پیش‌فرض، مقیاس فاصله‌گذاری، گوشه کارت‌ها و دکمه‌ها
• پالت رنگ: primary، secondary، accent، background، surface، text و …

۴. رسانه و آمار

• لوگو، Favicon، تصویر Hero، تصویر بخش آمار — بلافاصله پس از انتخاب آپلود می‌شوند
• چیدمان آمار: کنار آمار یا زیر آمار · جایگاه تصویر · مقیاس و گردی

شبکه‌های اجتماعی

تب استودیو «شبکه‌های اجتماعی»

• استایل بخش: همان تنظیم «استایل شبکه‌های اجتماعی» در تب ظاهر — هر دو یک مقدار را تغییر می‌دهند
• برای هر پلتفرم (اینستاگرام، تلگرام، واتساپ، …): فعال/غیرفعال، شناسه/لینک، انتخاب آیکون

Deploy و Build وب‌اپ

پیش‌نیاز سرور

• CRM روی HTTPS در دسترس باشد (API برای bootstrap و auth)
• Node.js برای build (روی CI یا محلی)
• وب‌سرور برای فایل‌های static (Nginx، Cloudflare Pages، …)

Build

در پوشه webapp/:

npm install
npm run build

خروجی در پوشه webapp/dist/ — همین را روی دامنه وب‌اپ deploy کنید.

فونت‌ها (محلی — بدون Google Fonts)

فونت‌های فارسی و انگلیسی داخل CRM در مسیر crm/resources/fonts/ نگهداری می‌شوند (یکان‌باخ، وزیرمتن، ایران‌یکان، ایران نستعلیق و …). وب‌اپ و رزرو آنلاین فونت را از API سرور CRM می‌گیرند:

• /api/web-app/fonts/{font-key}.css — فایل CSS با @font-face
• /api/web-app-fonts/… — فایل‌های woff/woff2

پنل CRM هم از همین فونت‌های محلی استفاده می‌کند (resources/css/fonts.css). نیازی به اتصال اینترنت یا Google Fonts API نیست.

متغیرهای env (Production)

توسعه محلی

cd webapp
npm install
npm run dev

پورت پیش‌فرض Vite معمولاً 5174 است. CRM باید همزمان در حال اجرا باشد (php artisan serve یا معادل).

دامنه اختصاصی

1. در پنل پلتفرم فیلد «دامنه اختصاصی» را پر کنید — مثال: app.clinic.com
2. DNS را به سرور وب‌اپ اشاره دهید
3. VITE_CRM_API_URL را هنگام build روی آدرس CRM تنظیم کنید
4. فایل‌های dist را deploy کنید — SPA باید fallback به index.html داشته باشد

رزرو آنلاین (Booking) مدیریت مجموعه

منوی کناری ← «رزرو آنلاین» — مسیر: /settings/booking

فعال‌سازی

1. پنل مدیریت پلتفرم ⁦←⁩ مجموعه‌ها ⁦←⁩ انتخاب مجموعه ⁦←⁩ رزرو آنلاین — مسیر: /admin/clinics/{id}/booking
2. سوییچ «فعال‌سازی رزرو آنلاین» را روشن کنید
3. Slug و در صورت نیاز ساب‌دامنه (مثلاً booking-dr-ahmadi) را تنظیم و ذخیره کنید
4. اپ Booking را روی همان ساب‌دامنه deploy کنید
5. در CRM همان مجموعه، منوی رزرو آنلاین در تنظیمات ظاهر می‌شود

اتصال Booking به CRM

فایل booking/.env (نمونه):

VITE_CRM_API_URL=http://127.0.0.1:8000
VITE_BOOKING_SLUG=demo

تنظیمات عمومی Booking

مسیر: /settings/booking

درگاه‌های پرداخت Booking

مسیر: /settings/booking?tab=payment

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

درگاه	فیلدهای CRM	مستندات رسمی
زرین‌پال	Merchant ID (۳۶ کاراکتر) · فعال/غیرفعال · حالت Sandbox	zarinpal.com/docs
زیبال	Merchant · فعال/غیرفعال · حالت تست (zibal)	help.zibal.ir/IPG/API

• اگر فقط یک درگاه فعال باشد، کاربر مستقیماً به همان هدایت می‌شود
• اگر چند درگاه فعال باشد، کاربر درگاه را با لوگوی رسمی انتخاب می‌کند
• Callback URL هر درگاه: https://crm.example.com/api/booking/payments/callback/{gateway}

راه‌اندازی درگاه زرین‌پال

1. در zarinpal.com ثبت‌نام و احراز هویت پذیرنده
2. از پنل زرین‌پال، Merchant ID (کد ۳۶ کاراکتری درگاه) را دریافت کنید
3. در CRM: تنظیمات رزرو آنلاین ⁦←⁩ تب پرداخت ⁦←⁩ زرین‌پال را فعال و Merchant ID را وارد کنید
4. برای تست: حالت Sandbox را روشن کنید — API: sandbox.zarinpal.com
5. Callback URL را در پنل زرین‌پال (در صورت نیاز) مطابق آدرس CRM تنظیم کنید

راه‌اندازی درگاه زیبال

1. در zibal.ir ثبت‌نام و درخواست درگاه اینترنتی
2. پس از تأیید شاپرک، Merchant اختصاصی دریافت کنید (برای تست: zibal)
3. در CRM: تنظیمات رزرو آنلاین ⁦←⁩ تب پرداخت ⁦←⁩ زیبال را فعال و Merchant را وارد کنید
4. Callback URL: آدرس CRM — پس از پرداخت، trackId و success برمی‌گردد
5. تأیید نهایی با POST https://gateway.zibal.ir/v1/verify

فرآیند انتقال در دو فاز انجام می‌شود:

1. بارگذاری بکاپ SQL در یک دیتابیس موقت (اتصال legacy)
2. Import داده‌ها از دیتابیس legacy به دیتابیس اصلی CRM (اتصال DB_CONNECTION)

برای انتقال کامل معمولاً یک دستور کافی است؛ برای تکرار یا رفع نقص، می‌توانید مراحل را جداگانه اجرا کنید.

php artisan clinic:migrate-legacy-data ^
  --sql="C:\path\to\backup.sql" ^
  --uploads="C:\path\to\uploads" ^
  --fresh-target ^
  --force

پیش‌نیازها

• فایل بکاپ SQL از CRM قدیمی (مثلاً drnegahi.sql)
• پوشه فایل‌های آپلود legacy (اسناد پذیرش، رسید پرداخت و …) — در صورت وجود
• PHP، Composer و MySQL/MariaDB روی سرور یا محیط توسعه
• دسترسی به ترمینال در پوشه پروژه CRM
• فضای کافی روی دیسک برای کپی فایل‌ها به storage/app/public

دو دیتابیس جدا

تنظیمات .env

در فایل crm/.env این مقادیر را تنظیم کنید:

# دیتابیس هدف (CRM جدید)
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=first
DB_USERNAME=root
DB_PASSWORD=

# دیتابیس موقت legacy (بکاپ قدیمی)
LEGACY_DB_HOST=127.0.0.1
LEGACY_DB_PORT=3306
LEGACY_DB_DATABASE=crm_legacy
LEGACY_DB_USERNAME=root
LEGACY_DB_PASSWORD=

# مسیر پوشه uploads قدیمی (اختیاری — می‌توان با --uploads هم داد)
LEGACY_UPLOADS_PATH=C:\path\to\legacy\uploads

# آدرس پایه رسانه legacy (برای portfolio و موارد وابسته به URL)
LEGACY_MEDIA_BASE_URL=https://example-old-crm.com

بعد از تنظیم env، یک‌بار migrationهای CRM را اجرا کنید (اگر از --fresh-target استفاده نمی‌کنید):

php artisan migrate --force
php artisan storage:link

دستورات انتقال

۱. انتقال کامل (پیشنهادی)

SQL را در legacy بارگذاری می‌کند، در صورت نیاز دیتابیس هدف را fresh می‌کند، سپس همه مراحل import را اجرا می‌کند:

php artisan clinic:migrate-legacy-data --sql="C:\path\backup.sql" --uploads="C:\path\uploads" --fresh-target --force

گزینه‌های مهم

۲. پیش‌نمایش (dry run)

قبل از import واقعی، حجم داده را ببینید:

php artisan clinic:migrate-legacy-data --sql="C:\path\backup.sql" --dry-run --force

۳. Import جزئی (legacy از قبل restore شده)

وقتی SQL قبلاً در crm_legacy بارگذاری شده:

php artisan clinic:import-legacy --uploads="C:\path\uploads" --only=admission_documents

یا با همان دستور migrate و رد کردن SQL:

php artisan clinic:migrate-legacy-data --skip-sql-import --uploads="C:\path\uploads" --only=patients --only=admissions --force

۴. فقط بارگذاری SQL در legacy

برای restore دستی بکاپ بدون import به هدف:

php artisan clinic:migrate-legacy-data --sql="C:\path\backup.sql" --dry-run --force
# سپس بدون --dry-run و بدون --fresh-target فقط SQL:
php artisan clinic:migrate-legacy-data --sql="C:\path\backup.sql" --force

مراحل import (ترتیب اجرا)

مراحل به‌صورت خودکار به ترتیب وابستگی اجرا می‌شوند. با --only= می‌توانید یک یا چند مرحله را جداگانه تکرار کنید.

رفتارهای ویژه import

• اگر جدول complexes خالی باشد، کلینیک پیش‌فرض با id=1 و نام از options.site_title ساخته می‌شود
• اگر complex_patient یا complex_user خالی باشد، همه بیماران و کاربران import‌شده به کلینیک پیش‌فرض وصل می‌شوند
• IDهای legacy در جدول import_maps نگه‌داری می‌شوند تا import تکراری idempotent باشد
• پذیرش‌های legacy با وضعیت pending (status=0) طبق گزارش skip می‌شوند
• رزروهای گذشته confirmed ممکن است به no-show نگاشت شوند

فایل‌های آپلود (اسناد پذیرش)

جدول legacy documents به دسته‌های اسناد پذیرش و فایل‌های جدا در ساختار جدید تبدیل می‌شود.

مسیر مقصد در CRM جدید

storage/app/public/clinics/{clinicId}/admissions/{admissionId}/documents/{uuid}.ext

URL عمومی: /storage/clinics/... — نیاز به php artisan storage:link

جستجوی فایل در پوشه legacy

اگر مسیر دقیق در JSON فایل نباشد، import در این مسیرها هم جستجو می‌کند:

• مسیر نسبی همان‌طور که در legacy ذخیره شده
• uploads/admission/{id}/
• uploads/tmp/default/ و زیرپوشه‌های tmp/*/
• uploads/payment_documents/*/

انواع سند

php artisan clinic:import-legacy --uploads="C:\path\uploads" --only=admission_documents

بررسی و تأیید بعد از انتقال

در پایان import، جدول شمارش entityها و بخش IMPORT REPORT در خروجی ترمینال نمایش داده می‌شود.

چک‌لیست UI

• پنل مدیریت → مجموعه‌ها: کلینیک با نام درست وجود دارد
• کاربران: همه کاربران legacy به کلینیک وصل شده‌اند — یک‌بار logout/login کنید
• بیماران (/patients): تعداد با legacy مطابقت دارد
• پذیرش‌ها: وضعیت، مشاور، خدمات و تاریخ‌ها
• حسابداری: جمع فاکتورها و پرداخت‌ها
• اسناد پذیرش: باز کردن یک پذیرش و مشاهده فایل‌ها
• مشاوران ↔ وب‌اپ: ارتباط کاربران وب‌اپ با مشاور
• وب‌اپ / Booking: Slug، تنظیمات و نوبت‌ها (در صورت استفاده)

بررسی سریع در دیتابیس (اختیاری)

SELECT COUNT(*) FROM patients;
SELECT COUNT(*) FROM clinic_patient;
SELECT COUNT(*) FROM admissions;
SELECT COUNT(*) FROM admission_documents;
SELECT COUNT(*) FROM clinic_user;

بعد از import

1. php artisan storage:link — اگر قبلاً اجرا نشده
2. تنظیمات مجموعه را در /settings مرور کنید (هویت، مالی، فرم پذیرش)
3. در پنل پلتفرم: ماژول لیزر/پذیرش کلاسیک، Slug وب‌اپ و Booking
4. یک پذیرش نمونه باز کنید و چاپ / اسناد را تست کنید

عیب‌یابی مشکلات رایج

دلایل skip در گزارش import

منو ⁦←⁩ «اتاق لیزر» — /laser-room

• «فعال‌سازی ماژول لیزر» روشن باشد
• «اجرای جلسه لیزر» و مراحل مورد نیاز فعال باشند
• شیفت صبح/عصر در /settings?tab=laser-shifts تنظیم شده باشد
• اپراتور با دستگاه‌های مجاز و (در صورت نیاز) شیفت کاری تعریف شده باشد
• دستگاه‌ها و نواحی با قیمت شات تعریف شده باشند
• یک بیمار و پذیرش لیزر ثبت شده باشد

در پنل جزئیات: جلسات · ارزیابی پوست · برنامه درمان · مراقبت پس از درمان · اسناد پذیرش · ثبت جلسه لیزر (بسته به مراحل فعال).

شروع کار — پذیرش کلاسیک

• «پذیرش کلاسیک» و «جریان پذیرش» فعال
• فرم پذیرش طراحی شده (در صورت فعال بودن پذیرش کلاسیک)
• پزشکان، مشاوران و خدمات ثبت شده
• تنظیمات ویزیت، اسناد، چک‌لیست، دلایل لغو
• در صورت نیاز به فاکتور: «فعال‌سازی بخش مالی» و حساب‌های پیش‌فرض

منو: «پذیرش‌ها» · «اتاق پزشک» · «اتاق عمل»