.cursor/skills/abshode-domain-lookup/learned-notes.md

# یادداشت‌های یادگیری — abshode-domain-lookup

فرمت هر خط:
- YYYY-MM-DD | موضوع | مسیر فایل(ها) | نکتهٔ ۱ خطی

- 2026-09-06 | گیفت‌کارت | `database/migrations/2026_09_06_000001_create_giftcards_tables.php` | create جداول giftcards و giftcard_codes اگر نباشند؛ drop در down ندارد
- 2026-09-08 | خطای «محدودیت فیلد قیمت» در گیفت‌کارت | `app/Exceptions/Handler.php` + `GiftCardController::redeem` | پیام عمومی MySQL ۱۲۶۴ (Out of range) است؛ معمولاً `amount`/`total=count*amount` از ظرفیت ستون بیشتر است، نه باگ فرم ادمین
- 2026-09-08 | widen مبلغ گیفت‌کارت | `migrations/2026_09_08_000001_widen_giftcard_amount_columns.php` + `deploy_safe_schema.sql` | `amount`/`total` → DECIMAL(20,4) تا مبالغ ≥۱۰۰ میلیون ریال جا شود
- 2026-09-08 | لیست گیفت کاربر | `GiftCardController::mine` + `GET customer/giftcard/mine` + `GiftCardCodes::giftcard` | available=اختصاصی+عمومی تک‌کد use_once=0؛ history از assigned_to
- 2026-09-09 | «کد قابل استفاده» خالی در اپ | `routes/customer.php` + `GiftCardController::mine` | مسیر `GET customer/giftcard/mine` هنوز کامیت/دیپلوی نشده؛ سرور واقعی ۴۰۴ می‌دهد (use و me → ۴۰۱) پس لیست همیشه خالی است
- 2026-09-09 | کارت هدیه فلزی | `GiftCardController::useGiftCard` | unit=2 دیگر «در دست ساخت» نیست؛ شارژ gold کیف اصلی + سینک ته‌حساب/زرین/پرگار؛ used_count فقط بعد از موفقیت
- 2026-09-12 | واریز کیف‌پول + هدیه ریالی | `Withdraw::scopeDeposits` | note«کارت هدیه» با cash>0 در لیست واریز می‌آید؛ هدیه مسی (فقط gold) نه
- 2026-09-12 | پیامک کارت هدیه | `GiftCardController::useGiftCard` | پسوند SMS: ریالی→«قلک ریال»، فلزی→«قلک مس» (نه name_fa / قلک طلا)
- 2026-09-12 | تعداد کد هدیه | `GiftCardController::redeem` | count=N → N کارت جدا هرکدام ۱ کد یکتا + مبلغ کامل؛ store هم برای unit 1/2 چندکد می‌سازد
- 2026-09-12 | انقضای کارت هدیه | `GiftCardController::validateGiftExpiryDate` + `GiftCardEditorFormBody` | تاریخ قبل از امروز → ۴۰۰ / خطای فرم؛ امروز مجاز
- 2026-09-09 | رمز ادمین ≠ لاگین اپ | `Customer::setPasswordAttribute` + `AuthController` + `updateAdmin` | قبل از هش/لاگین ارقام فارسی→انگلیسی؛ jwt hash=false؛ آنلاین فقط password غیرخالی بفرست
mamad 2026-09-06 20:07:26 +03:30			`# یادداشت‌های یادگیری — abshode-domain-lookup`

			`فرمت هر خط:`
			`- YYYY-MM-DD \| موضوع \| مسیر فایل(ها) \| نکتهٔ ۱ خطی`

			- 2026-09-06 \| گیفت‌کارت \| `database/migrations/2026_09_06_000001_create_giftcards_tables.php` \| create جداول giftcards و giftcard_codes اگر نباشند؛ drop در down ندارد
. 2026-09-08 14:06:28 +03:30			- 2026-09-08 \| خطای «محدودیت فیلد قیمت» در گیفت‌کارت \| `app/Exceptions/Handler.php` + `GiftCardController::redeem` \| پیام عمومی MySQL ۱۲۶۴ (Out of range) است؛ معمولاً `amount`/`total=count*amount` از ظرفیت ستون بیشتر است، نه باگ فرم ادمین
			- 2026-09-08 \| widen مبلغ گیفت‌کارت \| `migrations/2026_09_08_000001_widen_giftcard_amount_columns.php` + `deploy_safe_schema.sql` \| `amount`/`total` → DECIMAL(20,4) تا مبالغ ≥۱۰۰ میلیون ریال جا شود
feat(giftcard): add customer giftcard/mine endpoint; fix admin/app password digit normalization 2026-09-09 16:57:20 +03:30			- 2026-09-08 \| لیست گیفت کاربر \| `GiftCardController::mine` + `GET customer/giftcard/mine` + `GiftCardCodes::giftcard` \| available=اختصاصی+عمومی تک‌کد use_once=0؛ history از assigned_to
			- 2026-09-09 \| «کد قابل استفاده» خالی در اپ \| `routes/customer.php` + `GiftCardController::mine` \| مسیر `GET customer/giftcard/mine` هنوز کامیت/دیپلوی نشده؛ سرور واقعی ۴۰۴ می‌دهد (use و me → ۴۰۱) پس لیست همیشه خالی است
feat(giftcard): redeem metal unit=2 into main wallet gold 2026-09-09 20:58:24 +03:30			- 2026-09-09 \| کارت هدیه فلزی \| `GiftCardController::useGiftCard` \| unit=2 دیگر «در دست ساخت» نیست؛ شارژ gold کیف اصلی + سینک ته‌حساب/زرین/پرگار؛ used_count فقط بعد از موفقیت
changes of giftcard 2026-09-12 10:12:43 +03:30			- 2026-09-12 \| واریز کیف‌پول + هدیه ریالی \| `Withdraw::scopeDeposits` \| note«کارت هدیه» با cash>0 در لیست واریز می‌آید؛ هدیه مسی (فقط gold) نه
			- 2026-09-12 \| پیامک کارت هدیه \| `GiftCardController::useGiftCard` \| پسوند SMS: ریالی→«قلک ریال»، فلزی→«قلک مس» (نه name_fa / قلک طلا)
			- 2026-09-12 \| تعداد کد هدیه \| `GiftCardController::redeem` \| count=N → N کارت جدا هرکدام ۱ کد یکتا + مبلغ کامل؛ store هم برای unit 1/2 چندکد می‌سازد
			- 2026-09-12 \| انقضای کارت هدیه \| `GiftCardController::validateGiftExpiryDate` + `GiftCardEditorFormBody` \| تاریخ قبل از امروز → ۴۰۰ / خطای فرم؛ امروز مجاز
feat(giftcard): add customer giftcard/mine endpoint; fix admin/app password digit normalization 2026-09-09 16:57:20 +03:30			- 2026-09-09 \| رمز ادمین ≠ لاگین اپ \| `Customer::setPasswordAttribute` + `AuthController` + `updateAdmin` \| قبل از هش/لاگین ارقام فارسی→انگلیسی؛ jwt hash=false؛ آنلاین فقط password غیرخالی بفرست