cleanup: trim bloated multi-line comments across the project

accounts/services.py

@@ -104,12 +104,9 @@ def send_sms(*, phone: str, message: str) -> None:
         )
         raise SMSDeliveryError('ارسال پیامک با خطا مواجه شد.')
 
-    # ⚠️ کاوه‌نگار حتی برای شکست‌های سطحِ اپلیکیشن (کلیدِ نامعتبر، اعتبار
-    # ناکافی، گیرنده‌ی نامعتبر و…) HTTP 200 برمی‌گردونه؛ نتیجه‌ی واقعی توی
-    # بدنه‌ی JSON، زیرِ return.status هست (200 یعنی موفق). صرفِ
-    # status_code == 200 «موفقیت» در نظر گرفته نمی‌شه؛ بدنه parse می‌شه و
-    # فقط return.status == 200 موفقیت محسوب می‌شه؛ هر پاسخِ ناقص/غیرمنتظره
-    # هم شکستِ تحویل در نظر گرفته می‌شه (نه موفقیت).
+    # کاوه‌نگار حتی برای شکست‌های سطحِ اپلیکیشن (کلیدِ نامعتبر، اعتبارِ ناکافی و…)
+    # HTTP 200 برمی‌گردونه؛ نتیجه‌ی واقعی توی body.return.status هست. فقط
+    # اون فیلد موفقیت رو تعیین می‌کنه، نه status_code.
     try:
         body = response.json()
         provider_status = body['return']['status']
@@ -158,23 +155,10 @@ def send_otp_sms(*, phone: str, code: str) -> None:
         raise OTPDeliveryError(str(exc)) from exc
 
 
-# ─────────────────────────────────────────────────────────────────────────
-# Targeting helpers (internal, read-only)
-#
-# هدف: صرفاً کوئری‌های قابل‌استفاده‌ی مجدد برای انتخاب زیرمجموعه‌ای از
-# کاربران، تا فیچرهای آینده (مثلاً کمپین‌های پیامی) بدونِ تکرارِ منطقِ
-# فیلتر، از همین توابع استفاده کنن. این ماژول:
-#   - هیچ پیامی نمی‌فرسته (نه SMS، نه notification).
-#   - هیچ جدول/مایگریشنِ جدیدی اضافه نمی‌کنه.
-#   - هیچ background job/endpoint‌ای نداره؛ فقط QuerySetِ User برمی‌گردونه.
-#   - هیچ رفتارِ موجودی رو تغییر نمی‌ده (فقط SELECT).
-#
-# ارجاع به subscription.Subscription عمداً با import محلی (داخلِ تابع) و
-# بر اساسِ user_id انجام می‌شه — دقیقاً همون الگویی که payment/services.py
-# و discount/services.py برای صداکردنِ subscription استفاده می‌کنن؛ چون
-# accounts.User (طبقِ docstringِ خودش) هیچ‌وقت FK واقعی به مدل‌های اپ‌های
-# دیگه نمی‌زنه.
-# ─────────────────────────────────────────────────────────────────────────
+# Targeting helpers (internal, read-only): کوئری‌های قابل‌استفاده‌ی مجدد برای
+# انتخابِ زیرمجموعه‌ای از کاربران (مثلاً برای کمپین‌های پیامی)؛ فقط SELECT،
+# بدونِ ارسالِ پیام. ارجاع به subscription.Subscription با import محلی و
+# user_id انجام می‌شه چون accounts.User هیچ‌وقت FK واقعی به اپ‌های دیگه نمی‌زنه.
 
 def get_all_users():
     """همه‌ی کاربران (مهمان و ثبت‌نام‌شده)."""