Files

T

hamed 158dcb58aa feat: implement service mode completion for nobat724_front

- Add task for completing service mode in clinicpro with detailed objectives and acceptance criteria.
- Create architecture documentation for task 00b, outlining involved components and necessary changes.
- Develop checklist for task 00b to ensure all requirements are met.
- Document implementation notes for task 00b, emphasizing API contract checks and design system adherence.
- Update task documentation for task 00b, specifying goals and current issues with service mode.

2026-07-30 11:56:08 +03:30

7.9 KiB

Raw Permalink Blame History

تسک ۰۰ب — سازگارسازی nobat724_front با وضعیت فعلی نوبت‌دهی سرویسی

پروژه: nobat724_front (سایت عمومی) · فاز: ۰ · وابستگی: ۰۰ · زمان: ۱۰-۱۴ ساعت پیش‌نیاز همهٔ تسک‌های ۰۱ به بعد

⛔ خط سرخ

مسیر اسلاتی سایت دست‌کاری نمی‌شود: adaptSlots()، رندر تب‌های شیفت، و همهٔ رفتار booking_mode === 'slot' عیناً می‌ماند. رجوع: _shared/red-lines.md

هدف

سایت حالت سرویسی را می‌شناسد ولی سه دسته مشکل دارد: انحراف از دیزاین‌سیستم، محاسبهٔ موازی مدت در فرانت، و نبود سرویس/مدت در پنل کاربر. این تسک همه را می‌بندد و سایت را با endpoint های جدید تسک ۰۰ هم‌گام می‌کند.

وضعیت فعلی

✅ کار می‌کند

مورد	فایل
تشخیص حالت per محل	`components/appointment/index.js:125` — `selectedLocation?.booking_mode === "service"`
مرحلهٔ انتخاب سرویس	`components/appointment/service/index.js`
فراخوانی endpoint ها	`services/response.js:78,83`
تبدیل پاسخ به قالب اسلات	`lib/appointmentSlots.js` → `adaptServiceSlots()`
ارسال سرویس‌ها در ثبت	`components/appointment/detail/SubmitData.js:152`
JSON-LD `availableService` با `estimatedDuration`	`app/doctor/[slug]/page.js:212`
باطل‌کردن انتخاب‌ها با تعویض محل	`changeLocation()` در `index.js`

❌ مشکلات این تسک

۱. انحراف از دیزاین‌سیستم — رنگ‌های hard-code.

components/appointment/service/index.js:

<h2 className="text-[16px] font-bold text-[#3B3B3B] mb-4">۱. انتخاب سرویس</h2>
<p className="text-[14px] text-[#7A7A7A]">…</p>
className={active
  ? "border-[#5559CE] bg-[#5559CE]/5"
  : "border-gray-200 bg-white hover:border-[#5559CE]"}

چهار رنگ hard-code. سایت darkMode: "class" دارد و صفحات عمومی با data-theme تم عوض می‌کنند — این کامپوننت در دارک‌مود می‌شکند. بقیهٔ مراحل رزرو از تم MUI/Tailwind استفاده می‌کنند و این یکی نمی‌کند.

۲. محاسبهٔ موازی مدت در فرانت.

// components/appointment/service/index.js
const totalMinutes = services
  .filter((s) => draft.includes(s.uuid))
  .reduce((sum, s) => sum + (Number(s.duration_minutes) || 0), 0);

بک‌اند همان عدد را در total_duration_minutes پاسخ appointment-service-slots برمی‌گرداند. دو محاسبه یعنی: وقتی تسک ۰۴ فرمول را به «زمان تنها / زمان اضافه» عوض کند، سایت عدد قدیمی نشان می‌دهد و بیمار مدتی می‌بیند که با مدت واقعی نوبتش نمی‌خواند.

۳. adaptServiceSlots برچسب گمراه‌کننده می‌سازد.

return [{
  start_time: starts[0].start_time,
  end_time: starts[starts.length - 1].start_time,   // ← پایانِ آخرین شروع، نه پایان نوبت
  label: "زمان‌های خالی",
  slots: …,
}];

همهٔ زمان‌ها در یک تب جمع می‌شوند و مرز شیفت‌ها (صبح/عصر) از بین می‌رود — در حالی که حالت اسلاتی همان اطلاعات را از بک‌اند دارد و نشان می‌دهد. برای پزشکی با شیفت صبح و عصر، بیمار یک فهرست بلند بی‌ساختار می‌بیند.

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

components/dashboard/userAccount/sidebars/turns/Card.js و isTurnsDetails/* هیچ ارجاعی به service یا مدت ندارند. بیمار نوبت سرویسی گرفته و در پنلش نمی‌بیند چه سرویسی رزرو کرده یا نوبتش چند دقیقه است.

۵. جابه‌جایی نوبت در پنل کاربر، سرویس‌آگاه نیست.

پس از تسک ۰۰، endpoint POST /appointment/{uuid}/service-reschedule وجود دارد. ButtonData.js هیچ مسیری برای جابه‌جایی ندارد.

دامنه

هست:

بازنویسی components/appointment/service/index.js با توکن‌های تم (بدون تغییر رفتار)
حذف محاسبهٔ مدت از فرانت — مصرف total_duration_minutes بک‌اند
adaptServiceSlots گروه‌بندی per شیفت
نمایش سرویس‌ها و مدت در کارت و جزئیات نوبت پنل کاربر
جابه‌جایی سرویس‌آگاه از پنل کاربر
به‌روزرسانی services/response.js برای endpoint های جدید تسک ۰۰

نیست: تغییری در مسیر اسلاتی · حالت resource (تسک ۰۶ و پس از آن، یک تسک frontend جدا)

معیار پذیرش

✅ موفق: مرحلهٔ انتخاب سرویس در دارک‌مود درست رندر می‌شود (هیچ متن سیاه روی زمینهٔ تیره، هیچ کارت سفید).
✅ موفق: مدت نمایش‌داده‌شده در مرحلهٔ انتخاب سرویس از پاسخ بک‌اند می‌آید؛ اگر بک‌اند عدد متفاوتی بدهد، UI همان را نشان می‌دهد.
✅ موفق: پزشکی با دو شیفت (صبح ۹-۱۳، عصر ۱۶-۲۰) در حالت سرویسی → دو تب زمانی، با برچسب واقعی هر شیفت.
✅ موفق: کارت نوبت در پنل کاربر نام سرویس‌ها و مدت را نشان می‌دهد؛ نوبت اسلاتی دقیقاً مثل امروز (بدون این دو خط).
✅ موفق: بیمار از پنل نوبت سرویسی‌اش را جابه‌جا می‌کند → مدت خودکار حفظ می‌شود، بیمار عددی وارد نمی‌کند.
❌ خطا: جابه‌جایی به زمان اشغال‌شده → پیام فارسی از بک‌اند نمایش داده می‌شود (نه «خطای نامشخص»)، و فهرست زمان‌ها خودکار به‌روز می‌شود.
❌ خطا: انتخاب صفر سرویس → دکمهٔ ادامه غیرفعال با راهنمای فارسی.
⚠️ مرزی: محلی که booking_mode = 'service' است ولی هیچ سرویس bookable ندارد → پیام روشن («سرویسی برای نوبت‌دهی آنلاین تعریف نشده است») + پیشنهاد محل دیگر اگر باشد.
⚠️ مرزی: پزشک در مطب شخصی اسلاتی و در کلینیک سرویسی → تعویض محل، مرحلهٔ سرویس را ظاهر/پنهان می‌کند و انتخاب‌های قبلی باطل می‌شوند (رفتار موجود، حفظ شود).
⚠️ مرزی: پاسخ appointment-service-slots خالی → پیام دلیل‌دار، نه فهرست خالی بی‌توضیح.
⚠️ مرزی: نوبت قدیمی سرویسی بدون service_items → کارت مدت را نشان می‌دهد و نام سرویس را «—»؛ کرش نمی‌کند.
⚠️ مرزی: total_duration_minutes در پاسخ نبود (بک‌اند قدیمی) → fallback به محاسبهٔ فرانت با یک console.warn، نه صفحهٔ خالی.

خروجی

components/appointment/service/index.js بازنویسی‌شده با توکن تم
lib/appointmentSlots.js — adaptServiceSlots شیفت‌آگاه
components/dashboard/userAccount/sidebars/turns/* — سرویس و مدت
services/response.js — endpoint های جدید
checklist.md کامل‌شده

7.9 KiB Raw Permalink Blame History Unescape Escape