92 lines
5.7 KiB
Python
92 lines
5.7 KiB
Python
"""ترجمهٔ کدهای بازگشتی سامانهٔ 0098SMS به متن فارسی و رده‌بندی وضعیت.
|
||
|
||
دو جدول مستقل در راهنمای vendor آمده است:
|
||
|
||
* **کدهای ارسال/خطا** (لینک ارتباطی و وب‌سرویس): عدد کوتاه یا رشته‌ای مانند
|
||
``Hang``/``Wrong time``. صفر (یا شناسهٔ ۹رقمی در ``SendSMSWithID``) یعنی موفق.
|
||
* **کدهای وضعیت دلیوری** (خروجی ``smsdeliveryState``): ۵=رسیده به گوشی،
|
||
۶=نرسیده، ۷=منقضی، ۸=نامشخص.
|
||
|
||
این ماژول تنها منبع حقیقت این کدهاست تا provider و پنل هر دو از یک ترجمه استفاده کنند.
|
||
"""
|
||
from dataclasses import dataclass
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# کدهای خطای ارسال (ترکیب جدول لینک ارتباطی و وب‌سرویس راهنما).
|
||
# ---------------------------------------------------------------------------
|
||
SEND_ERROR_CODES = {
|
||
"1": "شماره گیرنده اشتباه است.",
|
||
"2": "گیرنده تعریف نشده است.",
|
||
"3": "فرستنده تعریف نشده است.",
|
||
"4": "مخاطب دریافت پیام‌های تبلیغاتی خود را بسته است (بلک‌لیست).",
|
||
"5": "متن تنظیم نشده است.",
|
||
"6": "نام کاربری تنظیم نشده است.",
|
||
"7": "کلمه عبور تنظیم نشده است.",
|
||
"8": "نام دامین تنظیم نشده است.",
|
||
"9": "مجوز شما باطل شده است.",
|
||
"10": "اعتبار پیامک شما کافی نیست.",
|
||
"11": "برای این شماره لینک تعریف نشده است.",
|
||
"12": "عدم مجوز برای اتصال لینک.",
|
||
"13": "نام کاربری و کلمه عبور اشتباه است.",
|
||
"14": "کاراکتر غیرمجاز در متن وجود دارد.",
|
||
"15": "سقف ارسال روزانه پر شده است.",
|
||
"16": "عدم مجوز شماره برای ارسال از لینک.",
|
||
"17": "خطا در شماره پنل؛ لطفاً با پشتیبانی تماس بگیرید.",
|
||
"18": "اتمام تاریخ اعتبار شماره پنل؛ برای استفاده تمدید شود.",
|
||
"19": "تنظیمات کد opt انجام نشده است.",
|
||
"20": "فرمت کد opt صحیح نیست.",
|
||
"21": "تنظیمات کد opt توسط ادمین تأیید نشده است.",
|
||
"22": "اطلاعات مالک شماره ثبت و تأیید نشده است.",
|
||
"23": "هنوز اجازهٔ ارسال به این شماره پنل داده نشده است.",
|
||
"24": "ارسال از IP غیرمجاز انجام شده است.",
|
||
"66": "شارژ پنل شما برای ارسال کافی نیست؛ لطفاً شارژ نمایید.",
|
||
"1111": "شماره موبایل صحیح نیست.",
|
||
"-22": "خطای شارژ؛ لطفاً با پشتیبانی تماس بگیرید.",
|
||
"-23": "حساب کاربری شما مسدود است؛ لطفاً با پشتیبانی تماس بگیرید.",
|
||
"-24": "مرحلهٔ دوم ثبت‌نام شما انجام نگرفته است؛ ثبت‌نام را کامل نمایید.",
|
||
"-25": "عدم مجوز شماره برای ارسال از لینک.",
|
||
"-26": "خطا در شماره پنل؛ لطفاً با پشتیبانی تماس بگیرید.",
|
||
"-27": "اتمام تاریخ اعتبار شماره پنل؛ برای استفاده تمدید شود.",
|
||
"-28": "تنظیمات کد opt انجام نشده است.",
|
||
"-29": "فرمت کد opt صحیح نیست.",
|
||
"-31": "شناسهٔ پیامک (smsid) یافت نشد.",
|
||
"-32": "شناسهٔ پیامک (smsid) مطابقت ندارد.",
|
||
"hang": "عدم تطابق نام کاربری و کلمه عبور؛ لطفاً با پشتیبانی تماس بگیرید.",
|
||
"no doc": "کاراکتر غیرمجاز در متن وجود دارد.",
|
||
"wrong timestamp": "تایم‌استمپ ارسال‌شده صحیح نیست.",
|
||
"wrong time": "زمان در بازهٔ صحیح نیست (از همان روز تا یک سال بعد مجاز است).",
|
||
}
|
||
|
||
|
||
def describe_send_code(code):
|
||
"""متن فارسی کد خطای ارسال؛ اگر کد ناشناخته باشد ``None``."""
|
||
return SEND_ERROR_CODES.get(str(code).strip().casefold())
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# کدهای وضعیت دلیوری (``smsdeliveryState``).
|
||
# ---------------------------------------------------------------------------
|
||
@dataclass(frozen=True, slots=True)
|
||
class DeliveryCode:
|
||
status: str # مطابق SMSQueue.DeliveryStatus
|
||
description: str
|
||
is_final: bool # True = دیگر نیازی به استعلام مجدد نیست
|
||
|
||
|
||
_DELIVERY_CODES = {
|
||
"5": DeliveryCode("delivered", "رسیده به گوشی.", True),
|
||
"6": DeliveryCode("not_delivered", "نرسیده به گوشی.", True),
|
||
"7": DeliveryCode("expired", "وضعیت دریافت پیامک منقضی شده است.", True),
|
||
"8": DeliveryCode("unknown", "وضعیت پیامک نامشخص است.", False),
|
||
}
|
||
|
||
|
||
def classify_delivery(raw_code):
|
||
"""کد دلیوری خام را به :class:`DeliveryCode` تبدیل می‌کند.
|
||
|
||
عدد ۲ یا هر مقدار منفی/غیرشناخته‌شده ⇒ «نامشخص» و غیرنهایی، تا استعلام بعدی
|
||
دوباره تلاش کند (وضعیت ممکن است هنوز از سمت اپراتور برنگشته باشد).
|
||
"""
|
||
code = str(raw_code).strip()
|
||
return _DELIVERY_CODES.get(code, DeliveryCode("unknown", f"کد وضعیت ناشناخته: {code}", False))
|