diff --git a/.claude/prompt/currency-toman-display-admin.md b/.claude/prompt/currency-toman-display-admin.md new file mode 100644 index 00000000..5fc44186 --- /dev/null +++ b/.claude/prompt/currency-toman-display-admin.md @@ -0,0 +1,109 @@ +# واحد پول = تومان در پنل ادمین (نمایش ÷۱۰ / ورودی ×۱۰) — ذخیره و درگاه ریال میماند + +## پروژه + +`clinicpro` (admin frontend — React). **cross-repo:** پرامپت همتا برای سایت عمومی: `nobat724_front/.claude/prompt/currency-toman-display-front.md`. + +## زمینه + +واحد پول در **نمایشِ کل محصول باید تومان** باشد، ولی طبق تصمیم: +- **ذخیرهسازی DB و API و ارسال به درگاه پرداخت همچنان ریال میماند** (بدون migration، نام ستون/فیلدهای `*_rials` ثابت). درگاه ملت ریال میخواهد و مقدارِ ذخیرهشده درست است. +- فقط **لایهٔ نمایش** مقدار ریال را ÷۱۰ کرده و با برچسب «تومان» نشان دهد، و **فرمهای ورودیِ پول** مقدارِ تومانِ واردشده را ×۱۰ کرده و بهصورت ریال ذخیره کنند. + +الان ناهماهنگ است: `formatRial` عددِ **ریال** را میگیرد ولی برچسب «تومان» میچسباند (پس ۱۰ برابر نشان میدهد)، و فرمهای قیمت با برچسب «(ریال)» مقدار را مستقیم ریال ذخیره میکنند. + +## مشکل / هدف + +در پنل ادمین، همهٔ مبالغ **به تومان** نمایش داده و دریافت شوند؛ تبدیل تومان↔ریال فقط در لایهٔ UI (نمایش/فرم) انجام شود. DB/API/درگاه تغییری نکنند. + +## فایلهای مرتبط + +| فایل | نقش | +|------|-----| +| `clinicpro/assets/admin/lib/utils.ts` | helper مرکزی تبدیل + `formatRial` (نمایش تومان) | +| `clinicpro/assets/admin/lib/utils.test.ts` | بهروزرسانی انتظار تست | +| `clinicpro/assets/admin/pages/SettingsPage.tsx` | ۳ ورودی قیمت (appointment_fee/sms_panel_fee/sms_price) تومان | +| `clinicpro/assets/admin/components/FreeVisitPrice.tsx` | ورودی قیمت تومان | +| `clinicpro/assets/admin/components/ServiceTariffModal.tsx` | ورودی تعرفه تومان | +| `clinicpro/assets/admin/components/TenantInsuranceContracts.tsx` | ورودی فرانشیز/سقف تعهد تومان | +| `clinicpro/assets/admin/pages/SmsWalletPage.tsx` | مبلغ شارژ (ورودی) + نمایش قیمت هر پیامک | +| (در صورت وجود) صفحهٔ تسویه/برداشت که `amount_rials` ورودی میگیرد | ورودی مبلغ تومان | + +> نمایشهای دیگر (Payments، Subscription، RepresentationFinance، Dashboard و…) از `formatRial` استفاده میکنند؛ با اصلاح مرکزی خودکار تومان میشوند (۲۲ مصرف `formatRial`). + +## وضعیت فعلی + +### `lib/utils.ts` +```ts +export function formatRial(amount: number): string { + return new Intl.NumberFormat('fa-IR').format(amount) + ' تومان'; +} +``` +عدد ریال را بدون تبدیل، با برچسب «تومان» نشان میدهد → ۱۰ برابر. + +### `SettingsPage.tsx` (ورودیها ریال ذخیره میشوند) +```tsx +appointment_fee_rials: s.appointment_fee_rials ?? '150000', +sms_panel_fee_rials: s.sms_panel_fee_rials ?? '1500000', +sms_price_rials: s.sms_price_rials ?? '500', +// ... + +``` +مقدار مستقیم بهصورت ریال در `site_config` PATCH میشود. + +### نمونهٔ نمایش (Subscription) +```tsx +{formatRial(period.price_rials)} // price_rials ریال است +``` + +## وظایف + +### ۱. helperهای تبدیل + اصلاح `formatRial` (utils.ts) + +```ts +export const RIAL_PER_TOMAN = 10; +export const rialToToman = (rial: number): number => Math.round((Number(rial) || 0) / RIAL_PER_TOMAN); +export const tomanToRial = (toman: number): number => Math.round((Number(toman) || 0) * RIAL_PER_TOMAN); + +// ورودی همچنان «مقدار ریال» است (سازگاری با ۲۲ فراخوانی)، ولی خروجی به تومان نمایش داده میشود. +export function formatRial(rial: number): string { + return new Intl.NumberFormat('fa-IR').format(rialToToman(rial)) + ' تومان'; +} +``` +> نام `formatRial` را برای سازگاری با تمام مصرفکنندهها نگه دار (فقط رفتارش توماننمایش میشود). اگر خواستی برای خوانایی `formatToman` را هم بهعنوان alias صادر کن. + +### ۲. فرمهای ورودی پول — تومان بگیر، ریال ذخیره کن + +الگوی کلی: مقدار ذخیرهشده (ریال) را با `rialToToman` در فرم نشان بده؛ هنگام submit با `tomanToRial` به ریال تبدیل کن؛ برچسب واحد را «تومان» کن. + +**`SettingsPage.tsx`:** +- `defaultValues`: `appointment_fee_rials: String(rialToToman(Number(s.appointment_fee_rials ?? 1500000)))` و مشابه برای `sms_panel_fee_rials`، `sms_price_rials` (پیشفرضها را هم به تومان تبدیل کن: مثلاً `150000` ریال → نمایش `15000`). +- هنگام ذخیره (onSubmit/PATCH): این سه فیلد را `tomanToRial(...)` کن و سپس بفرست، تا `site_config` همچنان ریال بگیرد. +- placeholder/برچسبها را از ریال به تومان بهروز کن (مثلاً placeholder «15000»). + +**`FreeVisitPrice.tsx` / `ServiceTariffModal.tsx` / `TenantInsuranceContracts.tsx`:** +- برچسبهای «قیمت (ریال)»، «تعرفه (ریال)»، «فرانشیز (ریال)»، «سقف تعهد (ریال)» → «(تومان)». +- مقدار پیشفرضِ فرم = `rialToToman(storedRial)`؛ هنگام ذخیره = `tomanToRial(inputToman)` قبل از ارسال به API. + +**`SmsWalletPage.tsx`:** +- مبلغ شارژ که کاربر وارد میکند = تومان → قبل از ارسال `tomanToRial`. +- نمایش «قیمت هر پیامک» و موجودی کیفپول از `formatRial` استفاده کند (خودکار تومان). + +**صفحهٔ تسویه/برداشت (اگر `amount_rials` را از ورودی میگیرد):** مقدار تومانِ واردشده را `tomanToRial` کن و بفرست؛ نمایش موجودی/سقف با `formatRial`. + +### ۳. برچسبهای ثابت «ریال» در JSX + +هر جای UI که رشتهٔ «ریال» بهصورت ثابت کنار عدد آمده (نه از طریق `formatRial`) به «تومان» تغییر کند و عددش اگر خام ریال است با `rialToToman` تبدیل شود. (با `grep -rn "ریال" assets/admin` پیدا کن.) + +### ۴. تست + +`lib/utils.test.ts`: انتظار `formatRial` را به تومان بهروز کن (مثلاً ورودی `150000` ریال → خروجی شامل `15,000` و «تومان»). + +## نکات مهم + +- **DB/API/درگاه دست نخورد:** هیچ کلید `*_rials`، هیچ endpoint، و `MellatGateway`/`PaymentManager` تغییر نمیکند. مقدارِ رفته به درگاه همان ریالِ ذخیرهشده است (درست). +- **تبدیل فقط در مرز UI:** نمایش `rialToToman`، ورودی `tomanToRial`. هیچ مقدارِ تبدیلشدهای نباید در API/DB ذخیره شود مگر بعد از `tomanToRial` (که دوباره ریال است). +- **گرد کردن:** قیمتها مضرب ۱۰ ریالاند؛ `Math.round` امن است. اگر مقداری مضرب ۱۰ نبود، تومانِ گردشده نمایش داده میشود (پذیرفتنی). +- **دوبارهتبدیل نشود:** مراقب باش جایی که قبلاً `formatRial` اعمال شده دوباره ÷۱۰ نکنی (double convert). +- تستها: `ddev exec npx tsc --noEmit`، `ddev exec yarn dev` بدون خطا؛ سپس چشمی: Settings (قیمتها تومان و ذخیره درست)، Payments/Subscription/Dashboard (اعداد ۱۰ برابر کوچکتر از قبل و برچسب تومان). +- backend docs تغییری ندارد (واحد API ریال میماند). diff --git a/assets/admin/components/FreeVisitPrice.tsx b/assets/admin/components/FreeVisitPrice.tsx index 4256c9a8..dafdf824 100644 --- a/assets/admin/components/FreeVisitPrice.tsx +++ b/assets/admin/components/FreeVisitPrice.tsx @@ -2,7 +2,7 @@ import { useEffect, useState } from 'react'; import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'; import { toast } from 'sonner'; import { api } from '../lib/api'; -import { formatRial } from '../lib/utils'; +import { formatRial, rialToToman, tomanToRial } from '../lib/utils'; interface Pricing { free_visit_price_rials: number } @@ -17,11 +17,11 @@ export default function FreeVisitPrice() { const pricing = (data as any)?.data as Pricing | undefined; useEffect(() => { - if (pricing) setValue(String(pricing.free_visit_price_rials ?? 0)); + if (pricing) setValue(String(rialToToman(pricing.free_visit_price_rials ?? 0))); }, [pricing]); const saveMut = useMutation({ - mutationFn: () => api.put('/api/v1/insurance-pricing', { free_visit_price_rials: Number(value) || 0 }), + mutationFn: () => api.put('/api/v1/insurance-pricing', { free_visit_price_rials: tomanToRial(Number(value) || 0) }), onSuccess: () => { toast.success('قیمت ویزیت ذخیره شد'); qc.invalidateQueries({ queryKey: ['insurance-pricing'] }); @@ -37,7 +37,7 @@ export default function FreeVisitPrice() {