79 lines
2.6 KiB
Markdown
79 lines
2.6 KiB
Markdown
# تسک ۱۶: داشبورد هوشمند — چارت + فیلتر زمانی
|
|
|
|
## توضیح
|
|
داشبوردهای موجود را با نمودار و فیلتر بازه زمانی تکمیل میکند.
|
|
**هیچ endpoint جدیدی ایجاد نمیشود** — فقط پارامتر `from` و `to` (Unix timestamp) به endpoint های موجود اضافه میشود.
|
|
همچنین چند فیلد جدید به response های موجود اضافه میشود.
|
|
|
|
## Endpoint های موجود که تغییر میکنند
|
|
|
|
| متد | مسیر | تغییر |
|
|
|-----|------|-------|
|
|
| GET | `/api/v1/admin/dashboard/charts` | اضافه: query params `from` و `to` |
|
|
| GET | `/api/v1/dashboard/clinic` | اضافه: `from`، `to` + فیلدهای جدید response |
|
|
| GET | `/api/v1/dashboard/doctor` | اضافه: `from`، `to` + فیلدهای جدید response |
|
|
|
|
## فیلدهای جدید در Response
|
|
|
|
### GET /api/v1/dashboard/clinic
|
|
فیلدهای اضافهشده به data موجود:
|
|
```json
|
|
{
|
|
"sms_wallet_balance": 150000,
|
|
"unique_patients_count": 45,
|
|
"revenue_period_rials": 12500000
|
|
}
|
|
```
|
|
|
|
### GET /api/v1/dashboard/doctor
|
|
فیلدهای اضافهشده:
|
|
```json
|
|
{
|
|
"unique_patients_count": 28,
|
|
"revenue_period_rials": 7800000
|
|
}
|
|
```
|
|
|
|
### GET /api/v1/admin/dashboard/charts?from=UNIX&to=UNIX
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
"appointments_by_day": [
|
|
{ "date": 1718000000, "count": 12 },
|
|
{ "date": 1718086400, "count": 8 }
|
|
],
|
|
"revenue_by_day": [
|
|
{ "date": 1718000000, "amount_rials": 4500000 },
|
|
{ "date": 1718086400, "amount_rials": 3200000 }
|
|
],
|
|
"subscription_sales_by_plan": [
|
|
{ "plan": "basic", "count": 15, "total_rials": 3750000 },
|
|
{ "plan": "professional", "count": 5, "total_rials": 2500000 }
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## پیشنیازها
|
|
- همه تسکهای ۱۰–۱۵ (نیاز به داده واقعی)
|
|
- `yarn add recharts` برای نمودارها
|
|
|
|
## زمان تخمینی
|
|
۸ تا ۱۰ ساعت
|
|
|
|
## فیلتر بازه زمانی
|
|
|
|
| preset | محاسبه |
|
|
|--------|--------|
|
|
| این هفته | from = شروع هفته جاری (شنبه) — to = now |
|
|
| این ماه | from = اول ماه جاری (شمسی) — to = now |
|
|
| ۳ ماه | from = now - 90 روز — to = now |
|
|
| سفارشی | کاربر از PersianCalendar انتخاب میکند |
|
|
|
|
**تبدیل تاریخ شمسی به Unix timestamp** برای ارسال به API:
|
|
```ts
|
|
// از کتابخانه موجود در پروژه استفاده میشود
|
|
// PersianCalendar component از assets/admin/components/ui/
|
|
```
|