django-chelseru 1.1.8__py3-none-any.whl → 2.0.0__py3-none-any.whl

django_chelseru-2.0.0.dist-info/METADATA

@@ -0,0 +1,475 @@
+Metadata-Version: 2.4
+Name: django-chelseru
+Version: 2.0.0
+Summary: Authentication system, online and real-time chat, SMS & BANK system for Iranian SMS services.
+Home-page: https://pipdjango.chelseru.com
+Author: Sobhan Bahman Rashnu
+Author-email: bahmanrashnu@gmail.com
+Project-URL: Documentation, https://github.com/Chelseru/django-chelseru-lour/
+Project-URL: Telegram Group, https://t.me/bahmanpy
+Project-URL: Telegram Channel, https://t.me/ChelseruCom
+Keywords: djangochelseruchat djangochat drfchat online-chat online real-time chat iran chelseru lor lur bahman rashnu rashno lak lour sms djangoauth auth ywt otpauth otp authentication djangootp djangoiransms iransms djangosms djangokavenegar djangomelipayamak sobhan چت  سبحان بهمن رشنو چلسرو جنگو پایتون لر لور آنلاین ریل تایم
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1.6
+Requires-Dist: djangorestframework==3.15.2
+Requires-Dist: djangorestframework_simplejwt==5.5.0
+Requires-Dist: channels==4.2.2
+Requires-Dist: channels_redis==4.2.1
+Requires-Dist: daphne==4.1.2
+Requires-Dist: zeep==4.3.1
+Requires-Dist: user-agents==2.2.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# django-chelseru Django Package
+
+## Overview
+
+django-chelseru is a Django package developed by Sobhan Bahman Rashnu for real-time chatting via WebSocket, OTP-based SMS verification, and SMS sending with Iranian providers. It also supports payment integrations.
+
+Useful for building applications requiring secure authentication, messaging, real-time chat, and online payments.
+
+## Features
+
+- **Authentication**: OTP and PASSWD methods using rest_framework_simplejwt.
+- **SMS Services**: PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM.
+- **Payment Gateways**: PAYPING_IR, ZARINPAL_COM.
+- **Real-time Chat**: WebSocket/Channels for messaging.
+- Session management and API endpoints for OTP, authentication, SMS, payments, and chat.
+
+## Requirements
+
+- Python 3.8+
+- Django 4.x
+- django-rest-framework
+- djangorestframework-simplejwt
+- django-channels
+- user-agents
+- requests
+- Other dependencies: See `requirements.txt`
+
+## Installation
+
+1. Install the package:
+
+   ```bash
+   pip install django-chelseru
+   ```
+2. Add to `INSTALLED_APPS` in `settings.py`:
+
+   ```python
+   INSTALLED_APPS = [
+       ...
+       'rest_framework',
+       'rest_framework_simplejwt',
+       'channels',
+       'drfchelseru',
+   ]
+   ```
+3. Configure middleware and ASGI in `settings.py`.
+4. Apply migrations:
+
+   ```bash
+   python manage.py makemigrations
+   python manage.py migrate
+   ```
+5. Run the server (use ASGI for WebSocket):
+
+   ```bash
+   daphne -b 0.0.0.0 -p 8000 project.asgi:application
+   ```
+
+## Project Structure
+
+- **models.py**: Defines models for users, OTP codes, sessions, SMS messages, organizations, chat rooms, chat permissions, messages, wallets, and payments.
+- **views.py**: Handles API endpoints for OTP authentication, SMS, payments, and chat.
+- **urls.py**: Maps URL patterns to views for API routes.
+- **consumers.py**: Implements WebSocket consumer for real-time chat.
+- **middlewares.py**: Includes `TakeUserSessionMiddlaware` for session management and `JWTAuthMiddleware` for WebSocket authentication.
+
+## Models
+
+- **User**: Extends Django's User model with mobile number and group.
+- **OTPCode**: Stores OTP codes for authentication with expiration logic.
+- **Session**: Tracks user sessions with IP, device, and browser info.
+- **MessageSMS**: Logs SMS messages sent to users.
+- **Organization**: Represents organizations owned by users.
+- **ChatRoomPermissions**: Defines access levels for chat room actions.
+- **ChatRoom**: Manages chat rooms with users, status, and permissions.
+- **MessageChat**: Stores chat messages with sender and timestamp.
+- **Wallet**: Tracks user wallet balances for payments.
+- **Payment**: Manages payment transactions with gateway integration.
+
+## Configuration
+
+Update your Django `settings.py`:
+
+```python
+MIDDLEWARE = [
+    ...
+    'drfchelseru.middlewares.TakeUserSessionMiddlaware',
+]
+
+ASGI_APPLICATION = 'yourproject.asgi.application'
+
+CHANNEL_LAYERS = {
+    'default': {
+        'BACKEND': 'channels_redis.core.RedisChannelLayer',
+        'CONFIG': {
+            'hosts': [('127.0.0.1', 6379)],
+        },
+    },
+}
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD': 'OTP',
+        'AUTH_SERVICE': 'rest_framework_simplejwt',
+        'OPTIONS': {
+            'OTP_LENGTH': 8,
+            'OTP_EXPIRE_PER_MINUTES': 4,
+            'OTP_SMS_TEMPLATE_ID': 5,
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY': '',
+            'MELI_PAYAMAK_COM_USERNAME': '',
+            'MELI_PAYAMAK_COM_PASSWORD': '',
+            'MELI_PAYAMAK_COM_FROM': '',
+            'KAVENEGAR_COM_API_KEY': '',
+            'KAVENEGAR_COM_FROM': '',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            'T3': 3,
+        }
+    },
+    'BANK': {
+        'GATEWAY': 'PAYPING_IR',
+        'SETTINGS': {
+            'MERCHANT_ID': '',
+            'CALLBACK_URL': '',
+            'CURRENCY': 'IRT'
+        }
+    }
+}
+```
+
+## API Endpoints
+
+- **POST /drfchelseru/message/send/**: Send SMS.
+
+  - Request: `{ "mobile_number": "09211892425", "message_text": "Hello", "template_id": 1 }`
+  - Response: `{ "details": "The Message was sent correctly." }` (200 OK)
+
+- **POST /drfchelseru/otp/send/**: Request OTP code.
+
+  - Request: `{ "mobile_number": "09211892425" }`
+  - Response: `{ "details": "The OTP code was sent correctly." }` (200 OK)
+
+- **POST /drfchelseru/authenticate/**: Authenticate with OTP.
+
+  - Request: `{ "mobile_number": "09211892425", "code": "652479", "group": 0 }`
+  - Response: `{ "access": "<access_token>", "refresh": "<refresh_token>" }` (200 OK)
+
+- **GET /drfchelseru/sessions/**: List user sessions (authenticated users only).
+
+  - Headers: `Authorization: Bearer <access_token>`
+  - Response: List of sessions (200 OK)
+
+- **POST /drfchelseru/payment/create/**: Initiate payment.
+
+  - Request: `{ "order_id": "123", "amount": 1000.0, "description": "Test payment", "callback_url": "http://example.com/callback", "mobile": "09211892425", "email": "user@example.com", "currency": "IRT" }`
+  - Response: `{ "details": { "gateway_url": "<url>", ... } }` (200 OK)
+
+- **GET/POST /drfchelseru/payment/verify/**: Verify payment.
+
+  - GET Query: `?Authority=<authority>&Status=OK`
+  - POST Body: `{ "paymentCode": "<code>", "paymentRefId": "<refid>", ... }`
+  - Response: `{ "details": { "is_pay": 1, ... } }` (200 OK)
+
+- **/drfchelseru/chat/chatrooms/**: CRUD for chat rooms (authenticated users only).
+
+  - POST Request: `{ "user": 2 }` (to create room with user ID 2)
+  - Headers: `Authorization: Bearer <access_token>`
+  - Response: Chat room details (201 Created)
+
+- **/drfchelseru/chat/messages/**: CRUD for chat messages (authenticated users only).
+
+  - POST Request: `{ "chat_room": 1, "text": "Hello" }`
+  - GET Query: `?chat_room=1`
+  - Headers: `Authorization: Bearer <access_token>`
+  - Response: Message details or list (200 OK / 201 Created)
+
+## WebSocket Usage
+
+- Connect to a chat room for real-time messaging:
+
+  ```bash
+  wscat -c wss://<your-domain>/drfchelseru/chat/<chat_room_id>/?token=<jwt_token>
+  ```
+  - Example token: `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzYxMDE5NTY3LCJpYXQiOjE3NTU4MzU1NjcsImp0aSI6IjhhYTY1Y2I3ZDhmMjRmMzliYjFmNDFkZmJiYjcyYmVmIiwidXNlcl9pZCI6Mzl9.mHmIjbTl3X1cd3Ky5HFCD6gy4kGxMVcActo9JXtT9JQ`
+  - Replace `<chat_room_id>` (e.g., 17) with the desired room ID and provide a valid JWT token.
+
+## Middleware
+
+- **TakeUserSessionMiddlaware**: Logs user session data (IP, user agent, device, browser) for HTTP requests.
+- **JWTAuthMiddleware**: Authenticates WebSocket connections using JWT tokens.
+
+## Usage
+
+- Access the API at `http://<your-domain>/drfchelseru/`.
+- Connect to WebSocket at `ws://<your-domain>/drfchelseru/chat/<chat_room_id>/?token=<jwt_token>`.
+- Admin panel: Create a superuser with `python manage.py createsuperuser`.
+
+## Contributing
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature-branch`).
+3. Commit your changes (`git commit -m "Add feature"`).
+4. Push to the branch (`git push origin feature-branch`).
+5. Open a pull request.
+
+## License
+
+MIT License
+
+
+
+_______________________________________________________________________________________________________________________
+
+
+# django-chelseru پکیج جنگو
+
+## بررسی اجمالی
+
+django-chelseru یک پکیج جنگو است که توسط سبحان بهمن رشنو توسعه یافته برای گفتگوهای همزمان از راه وب‌سوکت، تایید پیامکی بر پایه OTP، و فرستادن پیامک با فراهم‌کنندگان ایرانی. همچنین از یکپارچگی پرداخت پشتیبانی می‌کند.
+
+کاربردی برای ساخت برنامه‌هایی که نیاز به تایید امن، پیام‌رسانی، گفتگو همزمان، و پرداخت برخط دارند.
+
+## ویژگی‌ها
+
+- **تایید**: روش‌های OTP و PASSWD با بهره‌گیری از rest_framework_simplejwt.
+- **خدمات پیامک**: PARSIAN_WEBCO_IR، MELI_PAYAMAK_COM، KAVENEGAR_COM.
+- **درگاه‌های پرداخت**: PAYPING_IR، ZARINPAL_COM.
+- **گفتگو همزمان**: وب‌سوکت/کانال‌ها برای پیام‌رسانی.
+- مدیریت نشست و نقاط پایانی API برای OTP، تایید، پیامک، پرداخت‌ها، و گفتگو.
+
+## نیازمندی‌ها
+
+- Python 3.8+
+- Django 4.x
+- django-rest-framework
+- djangorestframework-simplejwt
+- django-channels
+- user-agents
+- requests
+- دیگر وابستگی‌ها: ببینید `requirements.txt`
+
+## نصب
+
+1. پکیج را نصب کنید:
+
+   ```bash
+   pip install django-chelseru
+   ```
+2. به `INSTALLED_APPS` در `settings.py` بیفزایید:
+
+   ```python
+   INSTALLED_APPS = [
+       ...
+       'rest_framework',
+       'rest_framework_simplejwt',
+       'channels',
+       'drfchelseru',
+   ]
+   ```
+3. میان‌گیر و ASGI را در `settings.py` پیکربندی کنید.
+4. مهاجرت‌ها را اعمال کنید:
+
+   ```bash
+   python manage.py makemigrations
+   python manage.py migrate
+   ```
+5. کارساز را اجرا کنید (برای وب‌سوکت از ASGI بهره ببرید):
+
+   ```bash
+   daphne -b 0.0.0.0 -p 8000 project.asgi:application
+   ```
+
+## ساختار پروژه
+
+- **models.py**: مدل‌ها را برای کاربران، کدهای OTP، نشست‌ها، پیامک‌ها، سازمان‌ها، اتاق‌های گفتگو، دسترسی‌های اتاق گفتگو، پیام‌ها، کیف‌پول‌ها، و پرداخت‌ها تعریف می‌کند.
+- **views.py**: نقاط پایانی API برای تایید OTP، پیامک، پرداخت‌ها، و گفتگو را مدیریت می‌کند.
+- **urls.py**: الگوهای URL را به نما‌ها برای مسیرهای API نگاشت می‌کند.
+- **consumers.py**: مصرف‌کننده وب‌سوکت را برای گفتگو همزمان پیاده‌سازی می‌کند.
+- **middlewares.py**: شامل `TakeUserSessionMiddlaware` برای مدیریت نشست و `JWTAuthMiddleware` برای تایید وب‌سوکت.
+
+## مدل‌ها
+
+- **User**: مدل کاربر جنگو را با شماره همراه و گروه گسترش می‌دهد.
+- **OTPCode**: کدهای OTP را برای تایید با منطق انقضا ذخیره می‌کند.
+- **Session**: نشست‌های کاربر را با IP، دستگاه، و داده‌های مرورگر پیگیری می‌کند.
+- **MessageSMS**: پیامک‌های فرستاده‌شده به کاربران را ثبت می‌کند.
+- **Organization**: سازمان‌هایی را که مالک کاربران هستند نشان می‌دهد.
+- **ChatRoomPermissions**: سطوح دسترسی برای کارهای اتاق گفتگو را تعریف می‌کند.
+- **ChatRoom**: اتاق‌های گفتگو را با کاربران، وضعیت، و دسترسی‌ها مدیریت می‌کند.
+- **MessageChat**: پیام‌های گفتگو را با فرستنده و زمان‌نگار ذخیره می‌کند.
+- **Wallet**: مانده کیف‌پول کاربران را برای پرداخت‌ها پیگیری می‌کند.
+- **Payment**: تراکنش‌های پرداخت را با یکپارچگی درگاه مدیریت می‌کند.
+
+## پیکربندی
+
+`settings.py` جنگو را به‌روزرسانی کنید:
+
+```python
+MIDDLEWARE = [
+    ...
+    'drfchelseru.middlewares.TakeUserSessionMiddlaware',
+]
+
+ASGI_APPLICATION = 'yourproject.asgi.application'
+
+CHANNEL_LAYERS = {
+    'default': {
+        'BACKEND': 'channels_redis.core.RedisChannelLayer',
+        'CONFIG': {
+            'hosts': [('127.0.0.1', 6379)],
+        },
+    },
+}
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD': 'OTP',
+        'AUTH_SERVICE': 'rest_framework_simplejwt',
+        'OPTIONS': {
+            'OTP_LENGTH': 8,
+            'OTP_EXPIRE_PER_MINUTES': 4,
+            'OTP_SMS_TEMPLATE_ID': 5,
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY': '',
+            'MELI_PAYAMAK_COM_USERNAME': '',
+            'MELI_PAYAMAK_COM_PASSWORD': '',
+            'MELI_PAYAMAK_COM_FROM': '',
+            'KAVENEGAR_COM_API_KEY': '',
+            'KAVENEGAR_COM_FROM': '',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            'T3': 3,
+        }
+    },
+    'BANK': {
+        'GATEWAY': 'PAYPING_IR',
+        'SETTINGS': {
+            'MERCHANT_ID': '',
+            'CALLBACK_URL': '',
+            'CURRENCY': 'IRT'
+        }
+    }
+}
+```
+
+## نقاط پایانی API
+
+- **POST /drfchelseru/message/send/**: فرستادن پیامک.
+
+  - درخواست: `{ "mobile_number": "09211892425", "message_text": "Hello", "template_id": 1 }`
+  - پاسخ: `{ "details": "The Message was sent correctly." }` (200 OK)
+
+- **POST /drfchelseru/otp/send/**: درخواست کد OTP.
+
+  - درخواست: `{ "mobile_number": "09211892425" }`
+  - پاسخ: `{ "details": "The OTP code was sent correctly." }` (200 OK)
+
+- **POST /drfchelseru/authenticate/**: تایید با OTP.
+
+  - درخواست: `{ "mobile_number": "09211892425", "code": "652479", "group": 0 }`
+  - پاسخ: `{ "access": "<access_token>", "refresh": "<refresh_token>" }` (200 OK)
+
+- **GET /drfchelseru/sessions/**: فهرست نشست‌های کاربر (فقط کاربران تاییدشده).
+
+  - سرآیندها: `Authorization: Bearer <access_token>`
+  - پاسخ: فهرست نشست‌ها (200 OK)
+
+- **POST /drfchelseru/payment/create/**: آغاز پرداخت.
+
+  - درخواست: `{ "order_id": "123", "amount": 1000.0, "description": "Test payment", "callback_url": "http://example.com/callback", "mobile": "09211892425", "email": "user@example.com", "currency": "IRT" }`
+  - پاسخ: `{ "details": { "gateway_url": "<url>", ... } }` (200 OK)
+
+- **GET/POST /drfchelseru/payment/verify/**: تایید پرداخت.
+
+  - جستجوی GET: `?Authority=<authority>&Status=OK`
+  - بدنه POST: `{ "paymentCode": "<code>", "paymentRefId": "<refid>", ... }`
+  - پاسخ: `{ "details": { "is_pay": 1, ... } }` (200 OK)
+
+- **/drfchelseru/chat/chatrooms/**: CRUD برای اتاق‌های گفتگو (فقط کاربران تاییدشده).
+
+  - درخواست POST: `{ "user": 2 }` (برای ساخت اتاق با شناسه کاربر 2)
+  - سرآیندها: `Authorization: Bearer <access_token>`
+  - پاسخ: جزئیات اتاق گفتگو (201 Created)
+
+- **/drfchelseru/chat/messages/**: CRUD برای پیام‌های گفتگو (فقط کاربران تاییدشده).
+
+  - درخواست POST: `{ "chat_room": 1, "text": "Hello" }`
+  - جستجوی GET: `?chat_room=1`
+  - سرآیندها: `Authorization: Bearer <access_token>`
+  - پاسخ: جزئیات پیام یا فهرست (200 OK / 201 Created)
+
+## بهره‌گیری از وب‌سوکت
+
+- پیوستن به اتاق گفتگو برای پیام‌رسانی همزمان:
+
+  ```bash
+  wscat -c wss://<your-domain>/drfchelseru/chat/<chat_room_id>/?token=<jwt_token>
+  ```
+  - نمونه نشانه: `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzYxMDE5NTY3LCJpYXQiOjE3NTU4MzU1NjcsImp0aSI6IjhhYTY1Y2I3ZDhmMjRmMzliYjFmNDFkZmJiYjcyYmVmIiwidXNlcl9pZCI6Mzl9.mHmIjbTl3X1cd3Ky5HFCD6gy4kGxMVcActo9JXtT9JQ`
+  - &lt;chat_room_id&gt; (مانند 17) را با شناسه اتاق دلخواه جایگزین کنید و نشانه JWT معتبر فراهم کنید.
+
+## میان‌گیرها
+
+- **TakeUserSessionMiddlaware**: داده‌های نشست کاربر (IP، عامل کاربر، دستگاه، مرورگر) را برای درخواست‌های HTTP ثبت می‌کند.
+- **JWTAuthMiddleware**: اتصال‌های وب‌سوکت را با نشانه‌های JWT تایید می‌کند.
+
+## بهره‌گیری
+
+- به API در `http://<your-domain>/drfchelseru/` دسترسی یابید.
+- به وب‌سوکت در `ws://<your-domain>/drfchelseru/chat/<chat_room_id>/?token=<jwt_token>` وصل شوید.
+- پنل مدیر: ابرکاربر را با `python manage.py createsuperuser` بسازید.
+
+## همکاری
+
+1. مخزن را فورک کنید.
+2. شاخه نو بسازید (`git checkout -b feature-branch`).
+3. تغییرات را کامیت کنید (`git commit -m "Add feature"`).
+4. به شاخه بفرستید (`git push origin feature-branch`).
+5. درخواست کشیدن باز کنید.
+
+## پروانه
+
+MIT License

{django_chelseru-1.1.8.dist-info → django_chelseru-2.0.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-django_chelseru-1.1.8.dist-info/licenses/LICENSE,sha256=VupU5KV4NteHaNQb-WH31G_WZWezxXoomjiCIAHoQJo,1089
+django_chelseru-2.0.0.dist-info/licenses/LICENSE,sha256=VupU5KV4NteHaNQb-WH31G_WZWezxXoomjiCIAHoQJo,1089
 drfchelseru/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drfchelseru/admin.py,sha256=uamcWPCCw9_dD00XL8Brp8A1NvfhB5FtUfF9DWQCK9c,1022
 drfchelseru/apps.py,sha256=hOTTzFGLXiTPZeN8p_LLcSECLtsR2Q0SUo8zJzgM-qQ,211
@@ -37,7 +37,7 @@ drfchelseru/migrations/0020_payment_paid_at.py,sha256=H6cr-tfjJVjN3tCsCD8ecg9JGJ
 drfchelseru/migrations/0021_alter_payment_message.py,sha256=g5qIvQ-wecdXGcMf7ZhyfL2u85QpgMUOADHE7t4QHog,397
 drfchelseru/migrations/0022_payment_pay_mode_wallet.py,sha256=241lZITO1jQHqXkJKYm8DKUh7w9rmROh65LzNifP3BA,1521
 drfchelseru/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_chelseru-1.1.8.dist-info/METADATA,sha256=OOjipNbIe83ImvKJ2ZWUihnIMfKSNcDPBBBAec9E5qY,10944
-django_chelseru-1.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-django_chelseru-1.1.8.dist-info/top_level.txt,sha256=fsaO1F03W3j4AYi0TfDGv5Cjb_Qrh6RSkwkWqfqaMns,12
-django_chelseru-1.1.8.dist-info/RECORD,,
+django_chelseru-2.0.0.dist-info/METADATA,sha256=EObLgGe6BtL_uteht0I9gkfDai8YPHmlsTKDhm4ea2Y,18242
+django_chelseru-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+django_chelseru-2.0.0.dist-info/top_level.txt,sha256=fsaO1F03W3j4AYi0TfDGv5Cjb_Qrh6RSkwkWqfqaMns,12
+django_chelseru-2.0.0.dist-info/RECORD,,

django_chelseru-1.1.8.dist-info/METADATA

@@ -1,312 +0,0 @@
-Metadata-Version: 2.4
-Name: django-chelseru
-Version: 1.1.8
-Summary: Authentication system, online and real-time chat, SMS system for Iranian SMS services.
-Home-page: https://pipdjango.chelseru.com
-Author: Sobhan Bahman Rashnu
-Author-email: bahmanrashnu@gmail.com
-Project-URL: Documentation, https://github.com/Chelseru/django-chelseru-lour/
-Project-URL: Telegram Group, https://t.me/bahmanpy
-Project-URL: Telegram Channel, https://t.me/ChelseruCom
-Keywords: djangochelseruchat djangochat drfchat online-chat online real-time chat iran chelseru lor lur bahman rashnu rashno lak lour sms djangoauth auth ywt otpauth otp authentication djangootp djangoiransms iransms djangosms djangokavenegar djangomelipayamak sobhan چت  سبحان بهمن رشنو چلسرو جنگو پایتون لر لور آنلاین ریل تایم
-Classifier: Programming Language :: Python :: 3
-Classifier: Framework :: Django
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: Django>=5.1.6
-Requires-Dist: djangorestframework==3.15.2
-Requires-Dist: djangorestframework_simplejwt==5.5.0
-Requires-Dist: channels==4.2.2
-Requires-Dist: channels_redis==4.2.1
-Requires-Dist: daphne==4.1.2
-Requires-Dist: zeep==4.3.1
-Requires-Dist: user-agents==2.2.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# django-chelseru
-
-بستهٔ جنگویی برای **گپ‌زنی همزمان (WebSocket)**، **راستی‌آزمایی پیامکی (OTP)** و **فرستادن پیامک** با یاری‌دهنده‌های ایرانی.
-
-**نویسنده:** Sobhan Bahman Rashnu
-
----
-
-## فهرست مطالب
-
-- [ویژگی‌ها](#ویژگیها)
-- [نصب](#نصب)
-- [پیش‌نیازها و افزودن به تنظیمات](#پیشنیازها-و-افزودن-به-تنظیمات)
-- [پیکربندی](#پیکربندی)
-- [تعریف آدرس‌ها (URLs)](#تعریف-آدرسها-urls)
-- [نقطه‌های پایانی API](#نقطههای-پایانی-api)
-  - [/api/otp/send/ — فرستادن رمز یک‌بارمصرف](#apiotpsend--فرستادن-رمز-یکبارمصرف)
-  - [/api/authenticate/ — راستی‌آزمایی با OTP و دریافت JWT](#apiauthenticate--راستیآزمایی-با-otp-و-دریافت-jwt)
-  - [/api/message/send/ — فرستادن پیامک](#apimessagesend--فرستادن-پیامک)
-  - [/api/sessions/ — فهرست نشست‌های فعال](#apisessions--فهرست-نشستهای-فعال)
-- [مدل‌ها](#مدلها)
-
----
-
-## ویژگی‌ها
-
-- 📱 **راستی‌آزمایی پیامکی (OTP):** تولید و فرستادن رمز یک‌بارمصرف و اعتبارسنجی امن.
-- 💬 **گپ‌زنی همزمان:** پیام‌رسانی همزمان بر پایهٔ **WebSocket/Channels**.
-- ✉️ **فرستادن پیامک:** پشتیبانی از یاری‌دهنده‌های نام‌آشنای ایرانی.
-
----
-
-## نصب
-
-```bash
-pip install django-chelseru
-```
-
----
-
-## پیش‌نیازها و افزودن به تنظیمات
-
-`INSTALLED_APPS` را در `settings.py` به‌روز کنید:
-
-```python
-INSTALLED_APPS = [
-    # ...
-    'channels',
-    'rest_framework',
-    'rest_framework_simplejwt',
-    'drfchelseru',
-    # ...
-]
-```
-
-> نکته: برای قابلیت‌های همزمان (WebSocket) پروژهٔ شما باید با **ASGI** اجرا شود (مانند `daphne` یا `uvicorn`).
-
----
-
-## پیکربندی
-
-واژه‌نامهٔ `DJANGO_CHELSERU` را در `settings.py` بیفزایید و بر اساس نیاز خود سفارشی‌سازی کنید:
-
-```python
-DJANGO_CHELSERU = {
-    'AUTH': {
-        'AUTH_METHOD': 'OTP',  # روش‌های پشتیبانی‌شده: OTP, PASSWD
-        'AUTH_SERVICE': 'rest_framework_simplejwt',  # فعلاً: rest_framework_simplejwt
-        'OPTIONS': {
-            'OTP_LENGTH': 8,                 # پیش‌فرض: 8
-            'OTP_EXPIRE_PER_MINUTES': 4,     # پیش‌فرض: 4
-            'OTP_SMS_TEMPLATE_ID': 1,        # شناسهٔ قالب پیامکی OTP
-        },
-    },
-    'SMS': {
-        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',  # PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM
-        'SETTINGS': {
-            'PARSIAN_WEBCO_IR_API_KEY': '',
-            'MELI_PAYAMAK_COM_USERNAME': '',
-            'MELI_PAYAMAK_COM_PASSWORD': '',
-            'MELI_PAYAMAK_COM_FROM': '',
-            'KAVENEGAR_COM_API_KEY': 'YOUR_KAVENEGAR_API_KEY',
-            'KAVENEGAR_COM_FROM': 'YOUR_KAVENEGAR_FROM_NUMBER',
-        },
-        'TEMPLATES': {
-            'T1': 1,
-            'T2': 2,
-            # ...
-        },
-    },
-}
-```
-
-**راهنما:**
-
-- `AUTH_METHOD`: روش راستی‌آزمایی (برای پیامکی از `'OTP'` استفاده کنید).
-- `OTP_LENGTH`: طول رمز یک‌بارمصرف.
-- `OTP_EXPIRE_PER_MINUTES`: مدت اعتبار رمز (به دقیقه).
-- `OTP_SMS_TEMPLATE_ID`: شناسهٔ قالب پیامکی که برای OTP بهره‌گیری می‌شود.
-- `SMS_SERVICE`: انتخاب یاری‌دهندهٔ پیامکی.
-- `SETTINGS`: مقادیر دسترسی یاری‌دهندهٔ انتخاب‌شده.
-- `TEMPLATES`: نگاشت کلیدهای دلخواه به شناسهٔ قالب‌ها.
-
----
-
-## تعریف آدرس‌ها (URLs)
-
-در `urls.py`:
-
-```python
-from django.urls import path, include
-
-urlpatterns = [
-    # ...
-    path('api/', include('drfchelseru.urls')),
-    # ...
-]
-```
-
----
-
-## نقطه‌های پایانی API
-
-| مسیر                 | شرح                                                | روش  |
-| -------------------- | -------------------------------------------------- | ---- |
-| `/api/otp/send/`     | فرستادن رمز یک‌بارمصرف به شمارهٔ همراه             | POST |
-| `/api/authenticate/` | راستی‌آزمایی کاربر با OTP و دریافت توکن‌های JWT    | POST |
-| `/api/sessions/`     | فهرست و مدیریت نشست‌های فعال کاربر (نیازمند احراز) | GET  |
-| `/api/message/send/` | فرستادن پیامک با یاری‌دهندهٔ پیکربندی‌شده          | POST |
-
----
-
-### `/api/otp/send/` — فرستادن رمز یک‌بارمصرف
-
-**روش:** `POST`\
-**شرح:** یک OTP به شمارهٔ همراه کاربر فرستاده می‌شود.
-
-**بدنهٔ درخواست:**
-
-| فیلد            | نوع   | شرح                | نمونه         |
-| --------------- | ----- | ------------------ | ------------- |
-| `mobile_number` | `str` | شمارهٔ همراه کاربر | `09121234567` |
-
-**نمونهٔ درخواست:**
-
-```http
-POST /api/otp/send/ HTTP/1.1
-Content-Type: application/json
-
-{
-  "mobile_number": "09121234567"
-}
-```
-
-**پاسخ‌های ممکن:**
-
-- `200 OK`
-  ```json
-  { "details": "The OTP code was sent correctly." }
-  ```
-- `400 Bad Request` — ساختار نادرست `mobile_number`
-- `409 Conflict`
-  ```json
-  { "details": "An OTP code has already been sent. Please wait X seconds before trying again." }
-  ```
-- `500 Internal Server Error` — خطا در کارگذار
-
----
-
-### `/api/authenticate/` — راستی‌آزمایی با OTP و دریافت JWT
-
-**روش:** `POST`\
-**شرح:** اعتبارسنجی کاربر با OTP؛ در صورت موفقیت، توکن‌های `access` و `refresh` بازگردانده می‌شود.
-
-**بدنهٔ درخواست:**
-
-| فیلد            | نوع   | شرح                         | نمونه         |
-| --------------- | ----- | --------------------------- | ------------- |
-| `mobile_number` | `str` | شمارهٔ همراه کاربر          | `09121234567` |
-| `code`          | `str` | رمز یک‌بارمصرف دریافت‌شده   | `12345678`    |
-| `group`         | `int` | (اختیاری) شناسهٔ گروه کاربر | `1`           |
-
-**نمونهٔ درخواست:**
-
-```http
-POST /api/authenticate/ HTTP/1.1
-Content-Type: application/json
-
-{
-  "mobile_number": "09121234567",
-  "code": "12345678",
-  "group": 1
-}
-```
-
-**پاسخ‌های ممکن:**
-
-- `200 OK`
-  ```json
-  { "access": "...", "refresh": "..." }
-  ```
-- `401 Unauthorized`
-  ```json
-  { "error": "The code sent to this mobile number was not found." }
-  ```
-- `400 Bad Request` — فیلدهای الزامی ناپیدا/نامعتبر
-- `500 Internal Server Error` — خطا در کارگذار
-
----
-
-### `/api/message/send/` — فرستادن پیامک
-
-**روش:** `POST`\
-**شرح:** فرستادن پیامک سفارشی با یاری‌دهندهٔ پیکربندی‌شده.
-
-**بدنهٔ درخواست:**
-
-| فیلد            | نوع   | شرح                                            | نمونه           |
-| --------------- | ----- | ---------------------------------------------- | --------------- |
-| `mobile_number` | `str` | شمارهٔ همراه گیرنده                            | `09121234567`   |
-| `message_text`  | `str` | متن پیام (حداکثر ۲۹۰ نویسه)                    | `Hello, World!` |
-| `template_id`   | `int` | (برای برخی یاری‌دهنده‌ها مانند پارسیان الزامی) | `1`             |
-
-**نمونهٔ درخواست:**
-
-```http
-POST /api/message/send/ HTTP/1.1
-Content-Type: application/json
-
-{
-  "mobile_number": "09121234567",
-  "message_text": "Hello, World!",
-  "template_id": 1
-}
-```
-
-**پاسخ‌های ممکن:**
-
-- `200 OK`
-  ```json
-  { "details": "The Message was sent correctly." }
-  ```
-- `400 Bad Request` — خطاهای اعتبارسنجی فیلدها
-- `401 Unauthorized` — احراز انجام نشده
-- `500 Internal Server Error` — خطا در کارگذار
-- `502 Bad Gateway` — خطای بازگشتی از یاری‌دهندهٔ پیامکی
-
----
-
-### `/api/sessions/` — فهرست نشست‌های فعال
-
-**روش:** `GET`\
-**شرح:** همهٔ نشست‌های فعال کاربر را برمی‌گرداند. نیازمند **احراز هویت** (`IsAuthenticated`).
-
-**سربرگ‌های لازم:**
-
-| سربرگ           | مقدار                        |
-| --------------- | ---------------------------- |
-| `Authorization` | `Bearer <your_access_token>` |
-
-**نمونهٔ درخواست:**
-
-```http
-GET /api/sessions/ HTTP/1.1
-Authorization: Bearer <your_access_token>
-```
-
----
-
-## مدل‌ها
-
-این بسته یک مدل **Session** برای مدیریت نشست‌های فعال کاربران فراهم می‌کند.\
-از طریق نقطهٔ پایانی `/api/sessions/` می‌توانید نشست‌ها را مشاهده/مدیریت کنید.