-```
-
-**Webhook Events:**
-- `room_started` - شروع روم
-- `room_finished` - پایان روم
-- `participant_joined` - ورود کاربر
-- `participant_left` - خروج کاربر
-- `track_published` - انتشار track
-- `track_unpublished` - حذف track
-- `recording_started` - شروع ضبط
-- `recording_finished` - پایان ضبط
-- و بیشتر...
-
----
-
-### ❤️ Health Check
-
-وضعیت سلامت سرور را بررسی میکند.
-
-**Endpoint:**
-```http
-GET /healthCheck
-```
-
-**Response:**
-```
-Healthy
-```
-
-سرویسهای بررسی شده:
-- ✅ Database (MySQL/MariaDB)
-- ✅ Redis
-- ✅ NATS
-
----
-
-### 📥 Download Services
-
-#### Download Uploaded File
-```http
-GET /download/uploadedFile/:sid/*
-```
-
-#### Download Recording
-```http
-GET /download/recording/:token
-```
-
-#### Download Analytics
-```http
-GET /download/analytics/:token
-```
-
----
-
-## 🔄 Compatibility APIs
-
-### 🟦 BigBlueButton (BBB) Compatibility
-
-Plugnmeet از API های BigBlueButton پشتیبانی میکند.
-
-**Base Path:**
-```
-/:apiKey/bigbluebutton/api
-```
-
-**Available Endpoints:**
-- `GET/POST /create` - ایجاد جلسه
-- `GET/POST /join` - ورود به جلسه
-- `GET/POST /isMeetingRunning` - بررسی فعال بودن
-- `GET/POST /getMeetingInfo` - اطلاعات جلسه
-- `GET/POST /getMeetings` - لیست جلسات
-- `GET/POST /end` - پایان جلسه
-- `GET/POST /getRecordings` - لیست ضبطها
-- `GET/POST /deleteRecordings` - حذف ضبط
-- `GET/POST /publishRecordings` - انتشار ضبط
-- `GET/POST /updateRecordings` - بهروزرسانی ضبط
-
-**Authentication:** نیازمند `checksum` مطابق استاندارد BBB
-
-#### Example (BBB Join)
-```bash
-API_KEY="your-api-key"
-SECRET="your-secret"
-MEETING_ID="test-meeting"
-USER_NAME="Ali"
-
-# ساخت query string
-QUERY="meetingID=${MEETING_ID}&fullName=${USER_NAME}"
-
-# محاسبه checksum
-CHECKSUM=$(echo -n "join${QUERY}${SECRET}" | sha1sum | awk '{print $1}')
-
-# URL نهایی
-URL="https://your-domain.com/${API_KEY}/bigbluebutton/api/join?${QUERY}&checksum=${CHECKSUM}"
-
-echo "Join URL: $URL"
-```
-
----
-
-### 🎓 LTI (Learning Tools Interoperability)
-
-برای یکپارچگی با سیستمهای LMS.
-
-**Base Path:**
-```
-/lti/v1
-```
-
-#### LTI Landing
-```http
-POST /lti/v1
-```
-
-#### LTI API Endpoints
-
-نیازمند هدر `Authorization` خاص LTI:
-
-- `POST /lti/v1/api/room/join` - ورود به روم
-- `POST /lti/v1/api/room/isActive` - بررسی فعال بودن
-- `POST /lti/v1/api/room/end` - پایان روم
-- `POST /lti/v1/api/recording/fetch` - لیست ضبطها
-- `POST /lti/v1/api/recording/download` - دانلود ضبط
-- `POST /lti/v1/api/recording/delete` - حذف ضبط
-
----
-
-## 🛠️ SDKs & Tools
-
-### Official SDKs
-
-#### PHP SDK
-```bash
-composer require mynaparrot/plugnmeet-sdk-php
-```
-
-```php
-roomId = 'test-room';
-$params->metadata->roomTitle = 'کلاس آزمایشی';
-
-$result = $plugnmeet->room->create($params);
-```
-
----
-
-#### JavaScript/Node.js SDK
-```bash
-npm install plugnmeet-sdk-js
-```
-
-```javascript
-const { PlugNmeet } = require('plugnmeet-sdk-js');
-
-const plugnmeet = new PlugNmeet({
- host: 'https://your-domain.com',
- apiKey: 'your-api-key',
- apiSecret: 'your-secret'
-});
-
-// ایجاد روم
-const result = await plugnmeet.room.create({
- roomId: 'test-room',
- metadata: {
- roomTitle: 'کلاس آزمایشی'
- }
-});
-
-// تولید توکن ورود
-const token = await plugnmeet.room.getJoinToken({
- roomId: 'test-room',
- userInfo: {
- userId: 'user-123',
- name: 'علی احمدی',
- isAdmin: false
- }
-});
-```
-
----
-
-### Docker Deployment
-
-```bash
-docker run -d \
- --name plugnmeet-server \
- -p 8080:8080 \
- -v $PWD/config.yaml:/config.yaml \
- mynaparrot/plugnmeet-server \
- --config /config.yaml
-```
-
----
-
-## 📚 Additional Resources
-
-### Documentation
-- 🌐 **Official Website**: https://www.plugnmeet.org
-- 📖 **Full Documentation**: https://www.plugnmeet.org/docs
-- 🔧 **Installation Guide**: https://www.plugnmeet.org/docs/installation
-- 👨💻 **Developer Guide**: https://www.plugnmeet.org/docs/developer-guide
-
-### Community & Support
-- 💬 **Discord**: https://discord.gg/2X2ZaCHu4C
-- 🐛 **GitHub Issues**: https://github.com/mynaparrot/plugNmeet-server/issues
-- 📧 **Email Support**: support@plugnmeet.com
-
-### Source Code
-- 🖥️ **Server**: https://github.com/mynaparrot/plugNmeet-server
-- 🎨 **Client**: https://github.com/mynaparrot/plugNmeet-client
-- 🎬 **Recorder**: https://github.com/mynaparrot/plugNmeet-recorder
-
----
-
-## 📝 Notes & Best Practices
-
-### Performance Tips
-1. ✅ از Redis برای caching استفاده کنید
-2. ✅ برای مقیاسپذیری از Load Balancer استفاده کنید
-3. ✅ ضبطها را در storage خارجی (S3, MinIO) ذخیره کنید
-4. ✅ از CDN برای سرویسدهی فایلهای استاتیک استفاده کنید
-
-### Security Best Practices
-1. 🔒 HTTPS را فعال کنید (الزامی)
-2. 🔒 `apiKey` و `secret` را محرمانه نگه دارید
-3. 🔒 از CORS Policy مناسب استفاده کنید
-4. 🔒 توکنها را با expiration time محدود تولید کنید
-5. 🔒 Webhook signature را همیشه تایید کنید
-
-### Rate Limiting
-- `/auth` endpoints: 100 req/min per IP
-- `/api` endpoints: 1000 req/min per token
-- File uploads: 10 MB/s per user
-
----
-
-## 🎯 Quick Start Checklist
-
-- [ ] LiveKit Server راهاندازی شده
-- [ ] Redis نصب و پیکربندی شده
-- [ ] MySQL/MariaDB آماده است
-- [ ] فایل `config.yaml` تنظیم شده
-- [ ] Plugnmeet Server در حال اجراست
-- [ ] Client UI در دسترس است
-- [ ] Test meeting ایجاد و تست شده
-- [ ] Webhook تنظیم شده (اختیاری)
-- [ ] Recording تست شده (اختیاری)
-
----
-
-## 🎉 نسخه و تاریخچه تغییرات
-
-**نسخه فعلی مستند**: 2.0.0
-**آخرین بهروزرسانی**: نوامبر 2024
-
-برای مشاهده تاریخچه کامل تغییرات به فایل [CHANGELOG.md](./CHANGELOG.md) مراجعه کنید.
-
----
-
-
-
-**ساخته شده با ❤️ توسط [MynaParrot](https://www.mynaparrot.com)**
-
-[Website](https://www.plugnmeet.org) • [GitHub](https://github.com/mynaparrot/plugNmeet-server) • [Discord](https://discord.gg/2X2ZaCHu4C)
-
-
diff --git a/apps/course/services/plugnmeet.py b/apps/course/services/plugnmeet.py
deleted file mode 100644
index c0dc5e1..0000000
--- a/apps/course/services/plugnmeet.py
+++ /dev/null
@@ -1,155 +0,0 @@
-import json
-import hmac
-import hashlib
-from typing import Any, Dict, Optional
-from urllib.parse import urljoin
-
-import requests
-from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-
-
-class PlugNMeetError(Exception):
- def __init__(self, message: str, *, status_code: Optional[int] = None, response_data: Optional[Dict[str, Any]] = None):
- super().__init__(message)
- self.status_code = status_code
- self.response_data = response_data or {}
-
-
-class PlugNMeetClient:
- def __init__(self, *, base_url: Optional[str] = None, api_key: Optional[str] = None, api_secret: Optional[str] = None, timeout: Optional[float] = None):
- self.base_url = (base_url or getattr(settings, "PLUGNMEET_SERVER_URL", "")).rstrip("/")
- self.api_key = api_key or getattr(settings, "PLUGNMEET_API_KEY", "")
- self.api_secret = api_secret or getattr(settings, "PLUGNMEET_API_SECRET", "")
- self.timeout = timeout or getattr(settings, "PLUGNMEET_TIMEOUT", 10.0)
-
- if not self.base_url or not self.api_key or not self.api_secret:
- raise ImproperlyConfigured("PlugNMeet integration settings are incomplete.")
-
- def create_room(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- # Convert entire payload keys to camelCase as required by PlugNMeet protocol
- print(f"[PlugNMeet] Creating room with payload: {payload}")
- prepared = self._camelize_dict(payload)
- return self._post("/auth/room/create", prepared)
-
- def get_join_token(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- # Convert entire payload keys to camelCase as required by PlugNMeet protocol
- prepared = self._camelize_dict(payload)
- return self._post("/auth/room/getJoinToken", prepared)
-
- def is_room_active(self, room_id: str) -> Dict[str, Any]:
- return self._post("/auth/room/isRoomActive", {"roomId": room_id})
-
- def end_room(self, room_id: str) -> Dict[str, Any]:
- return self._post("/auth/room/endRoom", {"roomId": room_id})
-
- def get_recording_info(self, record_id: str) -> Dict[str, Any]:
- """Get detailed information about a recording."""
- return self._post("/auth/recording/recordingInfo", {"recordId": record_id})
-
- def get_recording_download_token(self, record_id: str) -> Dict[str, Any]:
- """Get a temporary download token for a recording."""
- return self._post("/auth/recording/getDownloadToken", {"recordId": record_id})
-
- def download_file(self, download_path: str, save_to: str) -> bool:
- """
- Download a file from PlugNMeet server.
-
- Args:
- download_path: The download path (e.g., '/download/recording/token_xxx')
- save_to: Local file path to save the downloaded file
-
- Returns:
- True if download successful, False otherwise
- """
- import logging
- logger = logging.getLogger(__name__)
-
- url = urljoin(f"{self.base_url}/", download_path.lstrip("/"))
- logger.info(f"[PlugNMeet] Downloading file from {url}")
-
- try:
- response = requests.get(url, stream=True, timeout=300) # 5 minute timeout for large files
- response.raise_for_status()
-
- # Write file in chunks
- with open(save_to, 'wb') as f:
- for chunk in response.iter_content(chunk_size=8192):
- if chunk:
- f.write(chunk)
-
- logger.info(f"[PlugNMeet] File downloaded successfully to {save_to}")
- return True
-
- except requests.RequestException as exc:
- logger.error(f"[PlugNMeet] Failed to download file - error={str(exc)}")
- raise PlugNMeetError(f"Failed to download file: {str(exc)}") from exc
-
- def _post(self, path: str, payload: Dict[str, Any]) -> Dict[str, Any]:
- url = urljoin(f"{self.base_url}/", path.lstrip("/"))
- body = json.dumps(payload, ensure_ascii=False, separators=(",", ":"))
- headers = {
- "Content-Type": "application/json",
- "API-KEY": self.api_key,
- "HASH-SIGNATURE": self._build_signature(body),
- }
-
- import logging
- logger = logging.getLogger(__name__)
- logger.debug(f"[PlugNMeet] POST {path} - Body: {body[:500]}")
-
- try:
- response = requests.post(url, data=body.encode("utf-8"), headers=headers, timeout=self.timeout)
- except requests.RequestException as exc:
- raise PlugNMeetError("Failed to reach PlugNMeet server.") from exc
-
- if response.status_code >= 400:
- response_data = self._safe_json(response)
- error_msg = f"PlugNMeet server returned status {response.status_code}: {response.text}"
- raise PlugNMeetError(
- error_msg,
- status_code=response.status_code,
- response_data=response_data,
- )
-
- data = self._safe_json(response)
- if data is None:
- raise PlugNMeetError("PlugNMeet server returned an invalid response format.")
-
- if isinstance(data, dict) and data.get('status') is False:
- error_message = data.get('msg') or data.get('message') or "PlugNMeet operation failed."
- raise PlugNMeetError(
- error_message,
- status_code=response.status_code,
- response_data=data,
- )
-
- return data
-
- @staticmethod
- def _snake_to_camel(key: str) -> str:
- parts = key.split("_")
- if not parts:
- return key
- return parts[0] + "".join(p.capitalize() or "" for p in parts[1:])
-
- def _camelize_dict(self, obj: Any) -> Any:
- if isinstance(obj, dict):
- return {self._snake_to_camel(k): self._camelize_dict(v) for k, v in obj.items()}
- if isinstance(obj, list):
- return [self._camelize_dict(v) for v in obj]
- return obj
-
- def _build_signature(self, body: str) -> str:
- digest = hmac.new(self.api_secret.encode("utf-8"), body.encode("utf-8"), hashlib.sha256)
- return digest.hexdigest()
-
- @staticmethod
- def _safe_json(response: requests.Response) -> Optional[Dict[str, Any]]:
- try:
- return response.json()
- except ValueError:
- return None
-
-
-__all__ = ["PlugNMeetClient", "PlugNMeetError"]
diff --git a/apps/course/services/web_egress.py b/apps/course/services/web_egress.py
deleted file mode 100644
index b1af20a..0000000
--- a/apps/course/services/web_egress.py
+++ /dev/null
@@ -1,192 +0,0 @@
-from __future__ import annotations
-
-import logging
-from typing import Any, Dict, Optional
-
-import requests
-from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-from django.utils import timezone
-
-logger = logging.getLogger(__name__)
-
-
-class WebEgressError(Exception):
- def __init__(
- self,
- message: str,
- *,
- status_code: Optional[int] = None,
- response_data: Optional[Dict[str, Any]] = None,
- ):
- super().__init__(message)
- self.status_code = status_code
- self.response_data = response_data or {}
-
-
-class WebEgressClient:
- def __init__(
- self,
- *,
- base_url: Optional[str] = None,
- service_token: Optional[str] = None,
- timeout: Optional[float] = None,
- ):
- self.base_url = (
- base_url
- or getattr(settings, "ONLINE_CLASS_WEB_EGRESS_SERVICE_URL", "")
- ).rstrip("/")
- self.service_token = (
- service_token
- or getattr(settings, "ONLINE_CLASS_WEB_EGRESS_SERVICE_TOKEN", "")
- )
- self.timeout = timeout or getattr(
- settings, "ONLINE_CLASS_WEB_EGRESS_TIMEOUT", 20.0
- )
-
- if not self.base_url:
- raise ImproperlyConfigured(
- "ONLINE_CLASS_WEB_EGRESS_SERVICE_URL must be configured."
- )
-
- def start_recording(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- return self._request("POST", "/api/web-egress/start/", json=payload)
-
- def stop_recording(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- return self._request("POST", "/api/web-egress/stop/", json=payload)
-
- def get_status(self, *, room_id: str, session_id: int) -> Dict[str, Any]:
- return self._request(
- "GET",
- "/api/web-egress/status/",
- params={"room_id": room_id, "session_id": session_id},
- )
-
- def _request(self, method: str, path: str, **kwargs) -> Dict[str, Any]:
- headers = kwargs.pop("headers", {})
- headers["Content-Type"] = "application/json"
- if self.service_token:
- headers["Authorization"] = f"Bearer {self.service_token}"
-
- request_url = f"{self.base_url}{path}"
-
- try:
- response = requests.request(
- method,
- request_url,
- headers=headers,
- timeout=self.timeout,
- **kwargs,
- )
- except requests.RequestException as exc:
- logger.exception(
- "[WebEgressClient] Request failed method=%s url=%s error=%s",
- method,
- request_url,
- str(exc),
- )
- raise WebEgressError("Failed to reach WebEgress service.") from exc
-
- data = self._safe_json(response)
- if response.status_code >= 400:
- message = (
- (data or {}).get("message")
- or (data or {}).get("detail")
- or response.text
- or "WebEgress service request failed."
- )
- logger.error(
- "[WebEgressClient] Non-success response method=%s url=%s status=%s message=%s payload=%s",
- method,
- request_url,
- response.status_code,
- message,
- data,
- )
- raise WebEgressError(
- message,
- status_code=response.status_code,
- response_data=data,
- )
-
- if data is None:
- raise WebEgressError("WebEgress service returned an invalid response.")
-
- if isinstance(data, dict) and data.get("status") is False:
- raise WebEgressError(
- data.get("message") or data.get("detail") or "WebEgress failed.",
- status_code=response.status_code,
- response_data=data,
- )
-
- return data
-
- @staticmethod
- def _safe_json(response: requests.Response) -> Optional[Dict[str, Any]]:
- try:
- return response.json()
- except ValueError:
- return None
-
-
-def is_web_egress_recording_status(status_value: str) -> bool:
- return str(status_value or "").strip().lower() in {
- "starting",
- "recording",
- "stopping",
- }
-
-
-def stop_session_web_egress_if_active(session) -> bool:
- """
- Best-effort stop for an active WebEgress recording.
-
- Returns True when a stop request was sent, otherwise False.
- This helper never raises and is safe to call from close-session flows.
- """
- if not getattr(settings, "ONLINE_CLASS_WEB_EGRESS_ENABLED", False):
- return False
-
- if not session or not is_web_egress_recording_status(
- getattr(session, "web_egress_status", "")
- ):
- return False
-
- try:
- client = WebEgressClient()
- client.stop_recording(
- {
- "session_id": session.id,
- "room_id": session.room_id,
- "egress_id": session.web_egress_id,
- }
- )
- except (ImproperlyConfigured, WebEgressError) as exc:
- logger.warning(
- "[WebEgress] Failed to stop active recording during session close - session_id=%s room_id=%s error=%s",
- session.id,
- session.room_id,
- str(exc),
- )
- return False
-
- session.web_egress_status = "stopping"
- if not session.web_egress_stopped_at:
- session.web_egress_stopped_at = timezone.now()
- session.save(
- update_fields=[
- "web_egress_status",
- "web_egress_stopped_at",
- "updated_at",
- ]
- )
- else:
- session.save(update_fields=["web_egress_status", "updated_at"])
-
- logger.info(
- "[WebEgress] Stop requested during session close - session_id=%s room_id=%s egress_id=%s",
- session.id,
- session.room_id,
- session.web_egress_id,
- )
- return True
diff --git a/apps/course/signals.py b/apps/course/signals.py
deleted file mode 100644
index daaae95..0000000
--- a/apps/course/signals.py
+++ /dev/null
@@ -1,529 +0,0 @@
-import logging
-from django.utils import timezone
-from apps.course.models import Course, Participant, LessonCompletion, CourseLiveSession
-from apps.account.notification_service import create_and_send_notification
-from apps.chat.models import RoomMessage
-from apps.course.models.course import Course, extract_text_from_json, get_localized_field
-from apps.course.models.lesson import CourseLesson
-from apps.course.models.live_session import LiveSessionRecording, LiveSessionUser
-from django.db.models import Q
-
-logger = logging.getLogger(__name__)
-
-from django.db.models.signals import post_save, post_delete, pre_save, m2m_changed
-from django.dispatch import receiver
-from django.core.cache import cache
-from django.contrib.auth import get_user_model
-
-UserModel = get_user_model()
-
-
-def sync_course_group_room(instance):
- title_str = extract_text_from_json(instance.title)
- first_professor = instance.professors.first()
-
- if first_professor:
- # Try to get an existing group room; if multiple exist, pick the first.
- try:
- room, created = RoomMessage.objects.get_or_create(
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP,
- defaults={
- "name": f"{title_str} - Group",
- "description": f"Group chat for course: {title_str}",
- "initiator": first_professor,
- },
- )
- except RoomMessage.MultipleObjectsReturned:
- # Fallback: get the earliest room and update it
- room = RoomMessage.objects.filter(
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP,
- ).order_by("id").first()
- created = False
- if not created:
- # Update the existing room with latest info
- RoomMessage.objects.filter(id=room.id).update(
- name=f"{title_str} - Group",
- description=f"Group chat for course: {title_str}",
- initiator=first_professor,
- )
- else:
- # No professor yet – just ensure the group room exists without initiator
- RoomMessage.objects.filter(
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP,
- ).update(
- name=f"{title_str} - Group",
- description=f"Group chat for course: {title_str}",
- )
-
-
-@receiver(post_save, sender=Course)
-def handle_room_message_for_course(sender, instance, created, **kwargs):
- title_str = extract_text_from_json(instance.title)
- first_professor = instance.professors.first()
- if created and not first_professor:
- return
-
- if created: # فقط برای موارد جدید اجرا شود
- RoomMessage.objects.create(
- name=f"{title_str} - Group",
- description=f"Group chat for course: {title_str}",
- initiator=first_professor, # استاد اول بهعنوان سازنده اتاق
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP
- )
- else: # این بخش در زمان آپدیت دوره اجرا میشود
- # Find the existing group room for this course and update its details
- update_kwargs = {
- 'name': f"{title_str} - Group",
- 'description': f"Group chat for course: {title_str}",
- }
- if first_professor:
- update_kwargs['initiator'] = first_professor
- RoomMessage.objects.filter(
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP
- ).update(**update_kwargs)
-
-
-@receiver(m2m_changed, sender=Course.professors.through)
-def handle_course_professors_changed(sender, instance, action, pk_set, **kwargs):
- if action not in {"post_add", "post_remove", "post_clear"}:
- return
-
- sync_course_group_room(instance)
-
- for professor in instance.professors.all():
- professor.ensure_professor_profile()
- detail_cache_key = f"professor_detail_{professor.slug}"
- cache.delete(detail_cache_key)
-
-
-@receiver(post_save, sender=Course)
-def ensure_professor_role(sender, instance, **kwargs):
- for professor in instance.professors.all():
- professor.ensure_professor_profile()
-
-@receiver([post_save, post_delete], sender=Course)
-def invalidate_professor_course_cache(sender, instance, **kwargs):
- """
- Clears the cached professor detail page AND their course list
- whenever a course assigned to them is created, updated, or deleted.
- """
- for professor in instance.professors.all():
- detail_cache_key = f"professor_detail_{professor.slug}"
- cache.delete(detail_cache_key)
-
-# Optional: If you update a Professor's profile in the admin directly
-@receiver([post_save, post_delete], sender=UserModel)
-def invalidate_professor_profile_cache(sender, instance, **kwargs):
- if instance.user_type == UserModel.UserType.PROFESSOR:
- cache_key = f"professor_detail_{instance.slug}"
- cache.delete(cache_key)
-
-@receiver(post_save, sender=Course)
-def sync_course_chat_locks(sender, instance, **kwargs):
- """
- Automatically locks/unlocks the related chat rooms when the admin
- toggles the chat locks on the Course page.
- """
- # 1. Update the Group Chat
- RoomMessage.objects.filter(
- course=instance,
- room_type=RoomMessage.RoomTypeChoices.GROUP
- ).update(is_locked=instance.is_group_chat_locked)
-
- # 2. Update the Private Chats between the Professors and Students of this course
- # Get all student IDs enrolled in this course
- student_ids = instance.participants.values_list('student_id', flat=True)
- professor_ids = list(instance.professors.values_list('id', flat=True))
-
- if student_ids and professor_ids:
- RoomMessage.objects.filter(
- room_type=RoomMessage.RoomTypeChoices.PRIVATE
- ).filter(
- # Find rooms where initiator is any professor and recipient is student, OR vice versa
- Q(initiator_id__in=professor_ids, recipient_id__in=student_ids) |
- Q(initiator_id__in=student_ids, recipient_id__in=professor_ids)
- ).update(is_locked=instance.is_professor_chat_locked)
-
-
-def _recalculate_course_lessons_count(course_id):
- Course.recalculate_lessons_count_for_course(course_id)
-
-
-def _sync_quiz_lesson_numbers(course_id):
- if not course_id:
- return
- from apps.quiz.models import Quiz
- from apps.course.models import CourseLesson
-
- active_lessons_count = CourseLesson.objects.filter(
- course_id=course_id,
- is_active=True
- ).filter(
- Q(chapter__isnull=True) | Q(chapter__is_active=True)
- ).count()
-
- # Update quizzes where lesson_number > active_lessons_count to 0
- Quiz.objects.filter(
- course_id=course_id,
- lesson_number__gt=active_lessons_count
- ).update(lesson_number=0)
-
-
-@receiver(pre_save, sender=CourseLesson)
-def capture_previous_course_lesson_state(sender, instance, **kwargs):
- if not instance.pk:
- instance._previous_course_id = None
- instance._previous_is_active = None
- return
-
- previous = sender.objects.filter(pk=instance.pk).values('course_id', 'is_active').first()
- if previous:
- instance._previous_course_id = previous['course_id']
- instance._previous_is_active = previous['is_active']
- else:
- instance._previous_course_id = None
- instance._previous_is_active = None
-
-
-@receiver(post_save, sender=CourseLesson)
-def sync_lessons_count_on_course_lesson_save(sender, instance, **kwargs):
- affected_course_ids = {instance.course_id}
-
- previous_course_id = getattr(instance, '_previous_course_id', None)
- previous_is_active = getattr(instance, '_previous_is_active', None)
- if previous_course_id and previous_course_id != instance.course_id:
- affected_course_ids.add(previous_course_id)
-
- if previous_is_active is not None and previous_is_active != instance.is_active and previous_course_id:
- affected_course_ids.add(previous_course_id)
-
- for course_id in affected_course_ids:
- _recalculate_course_lessons_count(course_id)
- _sync_quiz_lesson_numbers(course_id)
-
-
-@receiver(post_delete, sender=CourseLesson)
-def sync_lessons_count_on_course_lesson_delete(sender, instance, **kwargs):
- _recalculate_course_lessons_count(instance.course_id)
- _sync_quiz_lesson_numbers(instance.course_id)
-
-
-@receiver(post_save, sender=LiveSessionRecording)
-def create_course_lesson_from_recording(sender, instance, **kwargs):
- """
- Automatically creates a CourseChapter (if not exists) and CourseLesson
- whenever a LiveSessionRecording is saved with a valid file.
- """
- if not instance.file:
- return
-
- # To avoid duplicate creation if save is called multiple times
- from apps.course.models.lesson import Lesson, CourseChapter, CourseLesson
- if Lesson.objects.filter(content_file=instance.file.name).exists():
- return
-
- session = instance.session
- course = session.course
-
- # 1. Determine chapter title as recording date (YYYY-MM-DD)
- date_val = instance.created_at or timezone.now()
- recording_date_str = date_val.strftime('%Y-%m-%d')
-
- # 2. Get or create CourseChapter for this date
- from apps.course.models.course import extract_text_from_json
- chapter = None
- for ch in CourseChapter.objects.filter(course=course):
- if extract_text_from_json(ch.title) == recording_date_str:
- chapter = ch
- break
-
- if not chapter:
- chapter = CourseChapter.objects.create(
- course=course,
- title=recording_date_str,
- is_active=True
- )
-
- # 3. Determine lesson title: use custom title or subject (with parts if multiple recordings exist)
- base_title = session.recording_title or session.subject
-
- # Get all recordings for this session, ordered by creation
- recordings = list(LiveSessionRecording.objects.filter(session=session).order_by('created_at', 'id'))
- recordings_count = len(recordings)
-
- if recordings_count <= 1:
- lesson_title = base_title
- else:
- try:
- current_index = recordings.index(instance) + 1
- except ValueError:
- current_index = recordings_count
-
- lesson_title = f"{base_title} part {current_index}"
-
- # Retroactively rename the first lesson if this is a subsequent recording
- if current_index > 1:
- first_recording = recordings[0]
- if first_recording.file:
- first_lesson = Lesson.objects.filter(content_file=first_recording.file.name).first()
- if first_lesson:
- first_lesson_title = f"{base_title} part 1"
- first_lesson.title = first_lesson_title
- first_lesson.save(update_fields=['title'])
-
- # Also update corresponding CourseLesson
- CourseLesson.objects.filter(lesson=first_lesson).update(title=first_lesson_title)
-
- # 4. Calculate duration in minutes
- duration_minutes = 0
- if instance.file_time:
- duration_minutes = int(instance.file_time.total_seconds() / 60)
- if duration_minutes == 0 and instance.file_time.total_seconds() > 0:
- duration_minutes = 1
-
- # 5. Create the Lesson object
- lesson = Lesson.objects.create(
- title=lesson_title,
- content_type="video_file",
- content_file=instance.file,
- duration=duration_minutes
- )
-
- # 6. Create the CourseLesson object linking it to the chapter
- course_lesson = CourseLesson.objects.create(
- course=course,
- chapter=chapter,
- lesson=lesson,
- title=lesson_title,
- is_active=True
- )
-
- logger.info(f"✨ [Signal] Automatically created CourseLesson {course_lesson.id} ({lesson_title}) for course {course.id} from recording {instance.id}")
-
-
-@receiver(pre_save, sender=Participant)
-def store_participant_previous_active(sender, instance, **kwargs):
- if instance.pk:
- try:
- old = Participant.objects.get(pk=instance.pk)
- instance._previous_is_active = old.is_active
- except Participant.DoesNotExist:
- instance._previous_is_active = None
- else:
- instance._previous_is_active = None
-
-
-@receiver(post_save, sender=Participant)
-def notify_course_access_granted(sender, instance, created, **kwargs):
- if instance.is_active:
- was_activated = False
- if created:
- was_activated = True
- elif hasattr(instance, '_previous_is_active') and instance._previous_is_active is False:
- was_activated = True
-
- if was_activated:
- course_title_en = get_localized_field('en', instance.course.title)
- course_title_fa = get_localized_field('fa', instance.course.title)
- create_and_send_notification(
- user=instance.student,
- title_en="Course Access Granted",
- body_en=f"Your access to the course '{course_title_en}' has been activated.",
- title_fa="دسترسی به دوره فعال شد",
- body_fa=f"دسترسی شما به دوره «{course_title_fa}» فعال شد.",
- service='imam-javad',
- data={'type': 'course_access_granted', 'course_id': instance.course.id}
- )
-
-
-@receiver(post_save, sender=LessonCompletion)
-def check_course_completion(sender, instance, created, **kwargs):
- if created:
- student = instance.student
- course_lesson = instance.course_lesson
- course = course_lesson.course
-
- if not course:
- return
-
- total_lessons_count = CourseLesson.objects.filter(course=course, is_active=True).count()
- if total_lessons_count > 0:
- completed_lessons_count = LessonCompletion.objects.filter(
- student=student,
- course_lesson__course=course,
- course_lesson__is_active=True
- ).count()
-
- if completed_lessons_count >= total_lessons_count:
- cache_key = f"notified_course_completed_{student.id}_{course.id}"
- if not cache.get(cache_key):
- cache.set(cache_key, True, timeout=86400 * 30) # 30 days
-
- course_title_en = get_localized_field('en', course.title)
- course_title_fa = get_localized_field('fa', course.title)
- create_and_send_notification(
- user=student,
- title_en="Course Completed",
- body_en=f"Congratulations! You have completed the course '{course_title_en}'.",
- title_fa="دوره به پایان رسید",
- body_fa=f"تبریک! شما دوره «{course_title_fa}» را با موفقیت به پایان رساندید.",
- service='imam-javad',
- data={'type': 'course_completed', 'course_id': course.id}
- )
-
-
-@receiver(pre_save, sender=CourseLiveSession)
-def handle_live_session_pre_save(sender, instance, **kwargs):
- if instance.pk:
- try:
- old = CourseLiveSession.objects.get(pk=instance.pk)
- instance._previous_is_cancelled = old.is_cancelled
- instance._previous_started_at = old.started_at
- instance._previous_ended_at = old.ended_at
-
- # Reset reminder_sent if rescheduled to a future time
- if old.started_at != instance.started_at:
- if instance.started_at > timezone.now():
- instance.reminder_sent = False
- except CourseLiveSession.DoesNotExist:
- instance._previous_is_cancelled = None
- instance._previous_started_at = None
- instance._previous_ended_at = None
- else:
- instance._previous_is_cancelled = None
- instance._previous_started_at = None
- instance._previous_ended_at = None
-
-
-@receiver(post_save, sender=CourseLiveSession)
-def notify_live_session_changes(sender, instance, created, **kwargs):
- # Event 1: LIVE Class Cancelled
- if instance.is_cancelled:
- was_cancelled = False
- if created:
- was_cancelled = True
- elif hasattr(instance, '_previous_is_cancelled') and instance._previous_is_cancelled is False:
- was_cancelled = True
-
- if was_cancelled:
- participants = Participant.objects.filter(course=instance.course, is_active=True).select_related('student')
- course_title_en = get_localized_field('en', instance.course.title)
- course_title_fa = get_localized_field('fa', instance.course.title)
- for p in participants:
- create_and_send_notification(
- user=p.student,
- title_en="LIVE Class Cancelled",
- body_en=f"The live class '{instance.subject}' for '{course_title_en}' has been cancelled.",
- title_fa="کلاس زنده لغو شد",
- body_fa=f"کلاس زنده «{instance.subject}» برای دوره «{course_title_fa}» لغو شده است.",
- service='imam-javad',
- data={'type': 'live_class_cancelled', 'session_id': instance.id}
- )
- return
-
- # Event 2: LIVE Class Rescheduled
- if not created and hasattr(instance, '_previous_started_at') and instance._previous_started_at is not None:
- if instance._previous_started_at != instance.started_at:
- if not instance.is_cancelled:
- participants = Participant.objects.filter(course=instance.course, is_active=True).select_related('student')
- course_title_en = get_localized_field('en', instance.course.title)
- course_title_fa = get_localized_field('fa', instance.course.title)
- for p in participants:
- create_and_send_notification(
- user=p.student,
- title_en="LIVE Class Rescheduled",
- body_en=f"The live class '{instance.subject}' for '{course_title_en}' has been rescheduled to {instance.started_at.strftime('%Y-%m-%d %H:%M')}.",
- title_fa="کلاس زنده تغییر زمان یافت",
- body_fa=f"زمان کلاس زنده «{instance.subject}» برای دوره «{course_title_fa}» به {instance.started_at.strftime('%Y-%m-%d %H:%M')} تغییر یافته است.",
- service='imam-javad',
- data={'type': 'live_class_rescheduled', 'session_id': instance.id}
- )
-
- # Event 6.2: Missed LIVE Sessions
- if instance.ended_at and not instance.is_cancelled:
- was_ended = False
- if created:
- was_ended = True
- elif hasattr(instance, '_previous_ended_at') and not instance._previous_ended_at:
- was_ended = True
-
- if was_ended:
- last_2_sessions = list(CourseLiveSession.objects.filter(
- course=instance.course,
- ended_at__isnull=False,
- is_cancelled=False
- ).order_by('-started_at')[:2])
-
- if len(last_2_sessions) == 2:
- # Find all active enrolled students of the course
- participants = Participant.objects.filter(course=instance.course, is_active=True).select_related('student')
- course_title_en = get_localized_field('en', instance.course.title)
- course_title_fa = get_localized_field('fa', instance.course.title)
- for p in participants:
- student = p.student
-
- # Check if student joined either session
- joined_latest = LiveSessionUser.objects.filter(session=last_2_sessions[0], user=student).exists()
- joined_second_latest = LiveSessionUser.objects.filter(session=last_2_sessions[1], user=student).exists()
-
- if not joined_latest and not joined_second_latest:
- # Prevent duplicate alert using cache
- cache_key = f"notified_missed_consecutive_live_{student.id}_{last_2_sessions[0].id}_{last_2_sessions[1].id}"
- if not cache.get(cache_key):
- cache.set(cache_key, True, timeout=86400 * 30) # 30 days
- create_and_send_notification(
- user=student,
- title_en="We Missed You at the LIVE Class!",
- body_en=f"You missed the last 2 consecutive live broadcasts for '{course_title_en}'. You can check the recordings in the archive.",
- title_fa="جای شما در کلاس زنده خالی بود!",
- body_fa=f"شما ۲ کلاس زنده اخیر دوره «{course_title_fa}» را از دست دادهاید. میتوانید ویدئوی ضبطشده را در بخش آرشیو مشاهده کنید.",
- service='imam-javad',
- data={'type': 'missed_live_sessions', 'course_id': instance.course.id}
- )
-
-
-@receiver(pre_save, sender=LiveSessionRecording)
-def store_recording_previous_file(sender, instance, **kwargs):
- if instance.pk:
- try:
- old = LiveSessionRecording.objects.get(pk=instance.pk)
- instance._previous_file = old.file
- except LiveSessionRecording.DoesNotExist:
- instance._previous_file = None
- else:
- instance._previous_file = None
-
-
-@receiver(post_save, sender=LiveSessionRecording)
-def notify_recording_available(sender, instance, created, **kwargs):
- if instance.file:
- was_uploaded = False
- if created:
- was_uploaded = True
- elif hasattr(instance, '_previous_file') and not instance._previous_file:
- was_uploaded = True
-
- if was_uploaded:
- session = instance.session
- if not session:
- return
- participants = Participant.objects.filter(course=session.course, is_active=True).select_related('student')
- course_title_en = get_localized_field('en', session.course.title)
- course_title_fa = get_localized_field('fa', session.course.title)
- for p in participants:
- create_and_send_notification(
- user=p.student,
- title_en="LIVE Recording Available",
- body_en=f"The recording for '{session.subject}' in '{course_title_en}' is now available.",
- title_fa="ضبط کلاس زنده در دسترس است",
- body_fa=f"ضبط کلاس زنده «{session.subject}» برای دوره «{course_title_fa}» اکنون در آرشیو در دسترس است.",
- service='imam-javad',
- data={'type': 'live_recording_available', 'recording_id': instance.id}
- )
-
-
diff --git a/apps/course/templates/course/add_student_form.html b/apps/course/templates/course/add_student_form.html
deleted file mode 100644
index ecd1d31..0000000
--- a/apps/course/templates/course/add_student_form.html
+++ /dev/null
@@ -1,29 +0,0 @@
-{% extends "admin/base_site.html" %}
-
-{% load i18n unfold %}
-
-{% block breadcrumbs %}{% endblock %}
-
-{% block extrahead %}
- {{ block.super }}
-
- {{ form.media }}
-{% endblock %}
-
-{% block content %}
-
-{% endblock %}
diff --git a/apps/course/tests.py b/apps/course/tests.py
deleted file mode 100644
index 7ce503c..0000000
--- a/apps/course/tests.py
+++ /dev/null
@@ -1,3 +0,0 @@
-from django.test import TestCase
-
-# Create your tests here.
diff --git a/apps/course/tests/__init__.py b/apps/course/tests/__init__.py
deleted file mode 100644
index 8b13789..0000000
--- a/apps/course/tests/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/apps/course/tests/test_course_access_guards.py b/apps/course/tests/test_course_access_guards.py
deleted file mode 100644
index 434737e..0000000
--- a/apps/course/tests/test_course_access_guards.py
+++ /dev/null
@@ -1,133 +0,0 @@
-from django.core.files.uploadedfile import SimpleUploadedFile
-from rest_framework import status
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser, StudentUser
-from apps.course.models.course import Course, CourseCategory
-from apps.course.models.lesson import CourseChapter, CourseLesson, Lesson
-from apps.quiz.models.quiz import Quiz, Question
-
-
-class CourseAccessGuardsTests(APITestCase):
- def setUp(self):
- self.professor = ProfessorUser.objects.create(
- email='prof-guard@example.com',
- fullname='Professor Guard',
- experience_years=5,
- )
- self.outsider = StudentUser.objects.create(
- email='outsider@example.com',
- fullname='Outsider Student',
- )
- self.category = CourseCategory.objects.create(
- name='Guard Category',
- slug='guard-category',
- )
- thumbnail = SimpleUploadedFile('guard.jpg', b'filecontent', content_type='image/jpeg')
- self.course = Course.objects.create(
- title='Guard Course',
- slug='guard-course',
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=False,
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=0,
- description='Description',
- short_description='Short description',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
- self.chapter = CourseChapter.objects.create(
- course=self.course,
- title='Chapter 1',
- priority=1,
- is_active=True,
- )
- lesson = Lesson.objects.create(
- title='Lesson 1',
- content_type=Lesson.ContentTypeChoices.VIDEO_FILE,
- duration=5,
- )
- self.course_lesson = CourseLesson.objects.create(
- course=self.course,
- chapter=self.chapter,
- lesson=lesson,
- priority=1,
- is_active=True,
- )
- self.quiz = Quiz.objects.create(
- lesson=self.course_lesson,
- course=self.course,
- title='Guard Quiz',
- description='Quiz description',
- each_question_timing=30,
- status=True,
- )
- self.question = Question.objects.create(
- quiz=self.quiz,
- question='What is 2+2?',
- option1='4',
- option2='3',
- option3='2',
- option4='1',
- correct_answer=1,
- priority=1,
- )
-
- def test_lesson_list_marks_lessons_and_quizzes_inactive_without_course_access(self):
- self.client.force_authenticate(user=self.outsider)
-
- response = self.client.get(f'/api/courses/{self.course.slug}/lessons/')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- lesson_data = response.data['results'][0]
- self.assertFalse(lesson_data['permission'])
- self.assertFalse(lesson_data['is_active'])
- self.assertFalse(lesson_data['quizs'][0]['permission'])
-
- def test_lesson_list_v2_marks_chapter_inactive_without_course_access(self):
- self.client.force_authenticate(user=self.outsider)
-
- response = self.client.get(f'/api/courses/v2/{self.course.slug}/lessons/')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- chapter_data = response.data['results'][0]
- self.assertFalse(chapter_data['is_active'])
- self.assertFalse(chapter_data['lessons'][0]['is_active'])
-
- def test_quiz_detail_rejects_users_without_course_access(self):
- self.client.force_authenticate(user=self.outsider)
-
- response = self.client.get(f'/api/quiz/{self.quiz.id}/')
-
- self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
-
- def test_quiz_submit_rejects_users_without_course_access(self):
- self.client.force_authenticate(user=self.outsider)
-
- payload = {
- 'quiz': self.quiz.id,
- 'started_at': '2026-06-02T10:00:00Z',
- 'ended_at': '2026-06-02T10:01:00Z',
- 'total_timing': 60,
- 'question_score': 1,
- 'timing_score': 1,
- 'total_score': 2,
- 'answers': [
- {
- 'question': self.question.id,
- 'option_num': 1,
- 'at_time': '2026-06-02T10:00:30Z',
- 'answer_timing': 30,
- }
- ],
- }
-
- response = self.client.post('/api/quiz/submit-quiz/', payload, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
- self.assertIn('quiz', response.data)
diff --git a/apps/course/tests/test_lessons_count_sync.py b/apps/course/tests/test_lessons_count_sync.py
deleted file mode 100644
index 468002a..0000000
--- a/apps/course/tests/test_lessons_count_sync.py
+++ /dev/null
@@ -1,174 +0,0 @@
-from io import StringIO
-
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.core.management import call_command
-from django.test import TestCase
-
-from apps.account.models import ProfessorUser
-from apps.course.models.course import Course, CourseCategory
-from apps.course.models.lesson import CourseChapter, CourseLesson, Lesson
-
-
-class LessonsCountSyncTests(TestCase):
- def setUp(self):
- self.professor = ProfessorUser.objects.create(
- email='prof-sync@example.com',
- fullname='Professor Sync',
- experience_years=5,
- )
- self.category = CourseCategory.objects.create(
- name='Sync Category',
- slug='sync-category',
- )
-
- def _create_course(self, slug, title, lessons_count=0):
- thumbnail = SimpleUploadedFile(f'{slug}.jpg', b'filecontent', content_type='image/jpeg')
- return Course.objects.create(
- title=title,
- slug=slug,
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=False,
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=lessons_count,
- description='Description',
- short_description='Short description',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
-
- def _create_chapter(self, course, title='Chapter', priority=1):
- return CourseChapter.objects.create(
- course=course,
- title=title,
- priority=priority,
- is_active=True,
- )
-
- def _create_course_lesson(self, course, chapter=None, title='Lesson', is_active=True, priority=1):
- if chapter is None:
- chapter = self._create_chapter(course, title=f'{course.title} Chapter', priority=priority)
-
- lesson = Lesson.objects.create(
- title=title,
- content_type=Lesson.ContentTypeChoices.VIDEO_FILE,
- duration=5,
- )
- return CourseLesson.objects.create(
- course=course,
- chapter=chapter,
- lesson=lesson,
- priority=priority,
- is_active=is_active,
- )
-
- def test_creating_active_course_lesson_updates_lessons_count(self):
- course = self._create_course('create-active-course', 'Create Active Course')
-
- self._create_course_lesson(course, title='Lesson 1')
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 1)
-
- def test_deleting_active_course_lesson_updates_lessons_count(self):
- course = self._create_course('delete-active-course', 'Delete Active Course')
- course_lesson = self._create_course_lesson(course, title='Lesson 1')
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 1)
-
- course_lesson.delete()
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 0)
-
- def test_toggling_is_active_updates_lessons_count(self):
- course = self._create_course('toggle-active-course', 'Toggle Active Course')
- course_lesson = self._create_course_lesson(course, title='Lesson 1', is_active=False)
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 0)
-
- course_lesson.is_active = True
- course_lesson.save()
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 1)
-
- course_lesson.is_active = False
- course_lesson.save()
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 0)
-
- def test_moving_course_lesson_updates_old_and_new_course_counts(self):
- old_course = self._create_course('old-course', 'Old Course')
- new_course = self._create_course('new-course', 'New Course')
- old_chapter = self._create_chapter(old_course, title='Old Chapter', priority=1)
- new_chapter = self._create_chapter(new_course, title='New Chapter', priority=1)
- course_lesson = self._create_course_lesson(
- old_course,
- chapter=old_chapter,
- title='Lesson 1',
- is_active=True,
- priority=1,
- )
-
- old_course.refresh_from_db()
- new_course.refresh_from_db()
- self.assertEqual(old_course.lessons_count, 1)
- self.assertEqual(new_course.lessons_count, 0)
-
- course_lesson.chapter = new_chapter
- course_lesson.save()
-
- old_course.refresh_from_db()
- new_course.refresh_from_db()
- self.assertEqual(old_course.lessons_count, 0)
- self.assertEqual(new_course.lessons_count, 1)
-
- def test_inactive_lessons_are_not_counted(self):
- course = self._create_course('inactive-course', 'Inactive Course')
-
- self._create_course_lesson(course, title='Lesson 1', is_active=False)
- self._create_course_lesson(course, title='Lesson 2', is_active=True, priority=2)
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 1)
-
- def test_sync_course_lessons_count_command_updates_mismatched_courses(self):
- first_course = self._create_course('sync-first-course', 'Sync First Course', lessons_count=99)
- second_course = self._create_course('sync-second-course', 'Sync Second Course', lessons_count=7)
-
- self._create_course_lesson(first_course, title='Lesson 1', is_active=True)
- self._create_course_lesson(first_course, title='Lesson 2', is_active=False, priority=2)
- self._create_course_lesson(second_course, title='Lesson 3', is_active=True)
- self._create_course_lesson(second_course, title='Lesson 4', is_active=True, priority=2)
-
- Course.objects.filter(pk=first_course.pk).update(lessons_count=99)
- Course.objects.filter(pk=second_course.pk).update(lessons_count=7)
-
- stdout = StringIO()
- call_command('sync_course_lessons_count', stdout=stdout)
-
- first_course.refresh_from_db()
- second_course.refresh_from_db()
- self.assertEqual(first_course.lessons_count, 1)
- self.assertEqual(second_course.lessons_count, 2)
- self.assertIn('Sync complete. 2 course(s) updated.', stdout.getvalue())
-
- def test_sync_course_lessons_count_command_dry_run_does_not_persist_changes(self):
- course = self._create_course('sync-dry-course', 'Sync Dry Course', lessons_count=5)
- self._create_course_lesson(course, title='Lesson 1', is_active=True)
- Course.objects.filter(pk=course.pk).update(lessons_count=5)
-
- stdout = StringIO()
- call_command('sync_course_lessons_count', '--dry-run', stdout=stdout)
-
- course.refresh_from_db()
- self.assertEqual(course.lessons_count, 5)
- self.assertIn('Dry run complete. 1 course(s) would be updated.', stdout.getvalue())
diff --git a/apps/course/tests/test_live_session_api.py b/apps/course/tests/test_live_session_api.py
deleted file mode 100644
index c3186b8..0000000
--- a/apps/course/tests/test_live_session_api.py
+++ /dev/null
@@ -1,273 +0,0 @@
-import tempfile
-from unittest import mock
-
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.test import override_settings
-from django.urls import reverse
-from django.utils import timezone
-from dj_language.models import Language
-from rest_framework import status
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser, StudentUser
-from apps.course.models import (
- Course,
- CourseCategory,
- CourseLiveSession,
- Participant,
-)
-from apps.course.views.course import get_course_slug_value
-
-
-@override_settings(
- PLUGNMEET_SERVER_URL='https://meet.example.com',
- PLUGNMEET_API_KEY='test-key',
- PLUGNMEET_API_SECRET='test-secret',
- MEDIA_ROOT=tempfile.gettempdir(),
- ONLINE_CLASS_FRONTEND_DOMAIN='http://testserver',
-)
-class CourseLiveSessionAPITests(APITestCase):
- def setUp(self):
- Language.objects.update_or_create(
- id=69,
- defaults={
- 'code': 'en',
- 'name': 'English',
- 'status': True,
- 'countries': [],
- },
- )
- self.professor = ProfessorUser.objects.create(
- email='prof@example.com',
- fullname='Professor Sample',
- experience_years=5,
- )
- self.student = StudentUser.objects.create(
- email='student@example.com',
- fullname='Student Sample',
- )
- self.category = CourseCategory.objects.create(name='Category', slug='category')
- thumbnail = SimpleUploadedFile('thumb.jpg', b'filecontent', content_type='image/jpeg')
- self.course = Course.objects.create(
- title='Sample Course',
- slug='sample-course',
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=True,
- online_link='https://example.com/live',
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=2,
- description='Description',
- short_description='Short',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
- professor_avatar = SimpleUploadedFile('prof-avatar.jpg', b'avatar', content_type='image/jpeg')
- self.professor.avatar = professor_avatar
- self.professor.save(update_fields=['avatar'])
- student_avatar = SimpleUploadedFile('student-avatar.jpg', b'avatar', content_type='image/jpeg')
- self.student.avatar = student_avatar
- self.student.save(update_fields=['avatar'])
-
- @mock.patch('apps.course.views.live_session.PlugNMeetClient')
- def test_professor_can_create_room(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.create_room.return_value = {'status': 'success'}
-
- self.client.force_authenticate(user=self.professor)
- url = reverse('course-live-session-room-create', kwargs={'slug': self.course.slug})
- payload = {
- 'room_id': 'custom-room-id',
- 'subject': 'Algebra Session',
- }
- response = self.client.post(url, payload, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_201_CREATED)
- mock_client.create_room.assert_called_once()
- self.assertTrue(
- CourseLiveSession.objects.filter(course=self.course, room_id='custom-room-id').exists()
- )
-
- @mock.patch('apps.course.views.live_session.PlugNMeetClient')
- def test_professor_receives_admin_token(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.get_join_token.return_value = {'token': 'abc123'}
-
- session = CourseLiveSession.objects.create(
- course=self.course,
- subject='Session',
- started_at=timezone.now(),
- room_id='room-123',
- )
-
- self.client.force_authenticate(user=self.professor)
- url = reverse('course-live-session-token')
- response = self.client.post(url, {'room_id': session.room_id}, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- args, _ = mock_client.get_join_token.call_args
- payload = args[0]
- self.assertTrue(payload['user_info']['is_admin'])
- profile_pic = payload['user_info']['user_metadata'].get('profilePic')
- self.assertEqual(profile_pic, f"http://testserver{self.professor.avatar.url}")
- self.assertEqual(response.data['token'], 'abc123')
-
- @mock.patch('apps.course.views.live_session.PlugNMeetClient')
- def test_student_participant_receives_limited_token(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.get_join_token.return_value = {'token': 'student-token'}
-
- session = CourseLiveSession.objects.create(
- course=self.course,
- subject='Session',
- started_at=timezone.now(),
- room_id='room-456',
- )
- Participant.objects.create(course=self.course, student=self.student)
-
- self.client.force_authenticate(user=self.student)
- url = reverse('course-live-session-token')
- response = self.client.post(url, {'room_id': session.room_id}, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- args, _ = mock_client.get_join_token.call_args
- payload = args[0]
- self.assertFalse(payload['user_info']['is_admin'])
- metadata = payload['user_info']['user_metadata']
- self.assertIn('lock_microphone', metadata['lock_settings'])
- self.assertEqual(metadata.get('profilePic'), f"http://testserver{self.student.avatar.url}")
- self.assertEqual(response.data['token'], 'student-token')
-
- def test_student_without_access_cannot_get_token(self):
- session = CourseLiveSession.objects.create(
- course=self.course,
- subject='Session',
- started_at=timezone.now(),
- room_id='room-789',
- )
-
- self.client.force_authenticate(user=self.student)
- url = reverse('course-live-session-token')
- response = self.client.post(url, {'room_id': session.room_id}, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
-
- @mock.patch('apps.course.views.course.PlugNMeetClient')
- def test_validate_metadata_includes_active_room_for_student(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.is_room_active.return_value = {'status': True, 'msg': 'room is active', 'isActive': True}
- mock_client.get_join_token.return_value = {'token': 'joined-student-token'}
-
- session = CourseLiveSession.objects.create(
- course=self.course,
- subject='Session Live',
- started_at=timezone.now(),
- room_id='room-live-1',
- )
- Participant.objects.create(course=self.course, student=self.student)
-
- self.client.force_authenticate(user=self.student)
- url = reverse(
- 'course-online-validate',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.get(url)
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- metadata = response.data['metadata']
- self.assertTrue(metadata['is_online'])
- self.assertEqual(metadata['active_room_id'], session.room_id)
- self.assertTrue(metadata['can_join_live_session'])
- self.assertEqual(metadata['live_session']['room_id'], session.room_id)
- self.assertIsNotNone(metadata['live_session']['started_at'])
- self.assertEqual(
- response.data['redirect_path'],
- 'http://testserver/?access_token=joined-student-token'
- )
- self.assertEqual(
- metadata['redirect_path'],
- 'http://testserver/?access_token=joined-student-token'
- )
-
- @mock.patch('apps.course.views.course.PlugNMeetClient')
- def test_validate_metadata_for_professor_hides_creation_when_online(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.is_room_active.return_value = {'status': True, 'msg': 'room is active', 'isActive': True}
- mock_client.get_join_token.return_value = {'token': 'joined-prof-token'}
-
- CourseLiveSession.objects.create(
- course=self.course,
- subject='Session Live',
- started_at=timezone.now(),
- room_id='room-live-2',
- )
-
- self.client.force_authenticate(user=self.professor)
- url = reverse(
- 'course-online-validate',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.get(url)
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- metadata = response.data['metadata']
- self.assertFalse(metadata['can_create_live_session'])
- self.assertEqual(
- response.data['redirect_path'],
- 'http://testserver/?access_token=joined-prof-token'
- )
-
- @mock.patch('apps.course.views.course.PlugNMeetClient')
- def test_validate_returns_direct_access_token_for_professor_when_class_is_not_online(
- self,
- mock_client_cls,
- ):
- mock_client = mock_client_cls.return_value
- mock_client.create_room.return_value = {'status': 'success'}
- mock_client.get_join_token.return_value = {'token': 'teacher-access-token'}
- self.client.force_authenticate(user=self.professor)
-
- url = reverse(
- 'course-online-validate',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.get(url)
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- metadata = response.data['metadata']
- self.assertFalse(metadata['is_online'])
- self.assertTrue(metadata['can_create_live_session'])
- self.assertEqual(
- response.data['redirect_path'],
- 'http://testserver/?access_token=teacher-access-token',
- )
- self.assertEqual(metadata['redirect_path'], response.data['redirect_path'])
- self.assertTrue(
- CourseLiveSession.objects.filter(course=self.course, ended_at__isnull=True).exists()
- )
-
- @mock.patch(
- 'apps.course.views.course.CourseOnlineClassTokenValidateAPIView._generate_entry_token',
- return_value='waiting-token',
- )
- def test_validate_returns_waiting_redirect_when_class_is_not_online(self, _mock_generate_entry_token):
- Participant.objects.create(course=self.course, student=self.student)
- self.client.force_authenticate(user=self.student)
-
- url = reverse(
- 'course-online-validate',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.get(url)
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- metadata = response.data['metadata']
- self.assertFalse(metadata['is_online'])
- self.assertFalse(metadata['can_join_live_session'])
- self.assertEqual(response.data['redirect_path'], 'http://testserver/?token=waiting-token&slug=sample-course')
- self.assertIn('&slug=sample-course', response.data['redirect_path'])
- self.assertEqual(metadata['redirect_path'], response.data['redirect_path'])
diff --git a/apps/course/tests/test_live_session_subjects.py b/apps/course/tests/test_live_session_subjects.py
deleted file mode 100644
index 2bfd229..0000000
--- a/apps/course/tests/test_live_session_subjects.py
+++ /dev/null
@@ -1,133 +0,0 @@
-import tempfile
-from unittest import mock
-
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.test import override_settings
-from django.urls import reverse
-from django.utils import timezone
-from dj_language.models import Language
-from rest_framework import status
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser
-from apps.course.models import Course, CourseCategory, CourseLiveSession
-from apps.course.views.course import get_course_slug_value
-
-
-@override_settings(
- PLUGNMEET_SERVER_URL='https://meet.example.com',
- PLUGNMEET_API_KEY='test-key',
- PLUGNMEET_API_SECRET='test-secret',
- MEDIA_ROOT=tempfile.gettempdir(),
- ONLINE_CLASS_FRONTEND_DOMAIN='http://testserver',
-)
-class CourseLiveSessionSubjectTests(APITestCase):
- def setUp(self):
- Language.objects.update_or_create(
- id=69,
- defaults={
- 'code': 'en',
- 'name': 'English',
- 'status': True,
- 'countries': [],
- },
- )
- self.professor = ProfessorUser.objects.create(
- email='subject-prof@example.com',
- fullname='Subject Professor',
- experience_years=5,
- )
- self.category = CourseCategory.objects.create(name='Category', slug='category')
- thumbnail = SimpleUploadedFile('thumb.jpg', b'filecontent', content_type='image/jpeg')
- self.course = Course.objects.create(
- title=[{'title': 'Sample Course', 'language_code': 'en'}],
- slug=[{'title': 'sample-course', 'language_code': 'en'}],
- category=self.category,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=True,
- online_link='https://example.com/live',
- level=[{'title': 'beginner', 'language_code': 'en'}],
- duration=10,
- lessons_count=2,
- description=[{'title': 'Description', 'language_code': 'en'}],
- short_description=[{'title': 'Short', 'language_code': 'en'}],
- status=[{'title': 'ongoing', 'language_code': 'en'}],
- is_free=True,
- )
- self.course.professors.add(self.professor)
-
- @mock.patch('apps.course.views.live_session.PlugNMeetClient')
- def test_room_create_uses_incremental_subject(self, mock_client_cls):
- mock_client_cls.return_value.create_room.return_value = {'status': 'success'}
- CourseLiveSession.objects.create(
- course=self.course,
- room_id='room-old',
- subject='Live Session 1',
- started_at=timezone.now(),
- ended_at=timezone.now(),
- )
-
- self.client.force_authenticate(user=self.professor)
- url = reverse(
- 'course-live-session-room-create',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.post(url, {}, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_201_CREATED)
- session = CourseLiveSession.objects.filter(
- course=self.course,
- ended_at__isnull=True,
- ).latest('id')
- self.assertEqual(session.subject, 'Live Session 2')
-
- @mock.patch('apps.course.views.course.PlugNMeetClient')
- def test_validate_professor_create_uses_incremental_subject(self, mock_client_cls):
- mock_client = mock_client_cls.return_value
- mock_client.create_room.return_value = {'status': 'success'}
- mock_client.get_join_token.return_value = {'token': 'teacher-access-token'}
- CourseLiveSession.objects.create(
- course=self.course,
- room_id='room-old',
- subject='Live Session 1',
- started_at=timezone.now(),
- ended_at=timezone.now(),
- )
-
- self.client.force_authenticate(user=self.professor)
- url = reverse(
- 'course-online-validate',
- kwargs={'slug': get_course_slug_value(self.course)},
- )
- response = self.client.get(url)
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- session = CourseLiveSession.objects.filter(
- course=self.course,
- ended_at__isnull=True,
- ).latest('id')
- self.assertEqual(session.subject, 'Live Session 2')
-
- def test_set_recording_title_updates_session_subject(self):
- session = CourseLiveSession.objects.create(
- course=self.course,
- room_id='room-active',
- subject='Live Session 1',
- started_at=timezone.now(),
- )
-
- response = self.client.post(
- reverse('course-live-session-set-recording-title'),
- {
- 'room_id': session.room_id,
- 'title': 'machine learning',
- },
- format='json',
- )
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- session.refresh_from_db()
- self.assertEqual(session.recording_title, 'machine learning')
- self.assertEqual(session.subject, 'machine learning')
diff --git a/apps/course/tests/test_multiple_roles_api.py b/apps/course/tests/test_multiple_roles_api.py
deleted file mode 100644
index 9eacac5..0000000
--- a/apps/course/tests/test_multiple_roles_api.py
+++ /dev/null
@@ -1,254 +0,0 @@
-"""
-تستهای API برای سیستم نقشهای چندگانه
-"""
-from django.test import TestCase
-from django.urls import reverse
-from rest_framework.test import APIClient
-from rest_framework import status
-from django.contrib.auth.models import Group
-from decimal import Decimal
-from apps.account.models import User
-from apps.course.models import Course, CourseCategory, Participant
-from apps.transaction.models import TransactionParticipant
-
-
-class MultipleRolesAPITestCase(TestCase):
- def setUp(self):
- """راهاندازی دادههای تست"""
- # ایجاد گروهها
- Group.objects.create(name="Professor Group")
- Group.objects.create(name="Student Group")
- Group.objects.create(name="Client Group")
-
- # ایجاد کاربر
- self.user = User.objects.create_user(
- email='test@example.com',
- fullname='Test User',
- password='testpass123'
- )
-
- # ایجاد دستهبندی دوره
- self.category = CourseCategory.objects.create(
- name='Test Category',
- slug='test-category'
- )
-
- # راهاندازی API client
- self.client = APIClient()
- self.client.force_authenticate(user=self.user)
-
- def test_user_profile_basic_functionality(self):
- """تست عملکرد اصلی profile کاربر"""
- # اضافه کردن نقشها
- self.user.add_role('professor')
- self.user.add_role('student')
-
- # تست متدهای جدید User model
- self.assertTrue(self.user.has_role('professor'))
- self.assertTrue(self.user.has_role('student'))
-
- roles = self.user.get_all_roles()
- self.assertIn('professor', roles)
- self.assertIn('student', roles)
-
- # نقش اصلی باید professor باشد (اولویت بالاتر)
- self.assertEqual(self.user.primary_role, User.UserType.PROFESSOR)
-
- def test_course_access_for_professor(self):
- """تست دسترسی استاد به دوره خودش"""
- # کاربر استاد میشود و دوره میسازد
- self.user.add_role('professor')
-
- course = Course.objects.create(
- title='Test Course',
- slug='test-course',
- category=self.category,
- professor=self.user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Test description'
- )
-
- # تست serializer
- from apps.course.serializers import CourseDetailSerializer
-
- # شبیهسازی request context
- from django.test import RequestFactory
- factory = RequestFactory()
- request = factory.get('/')
- request.user = self.user
-
- serializer = CourseDetailSerializer(course, context={'request': request})
- data = serializer.data
-
- # استاد باید دسترسی داشته باشد
- self.assertTrue(data['access'])
-
- def test_course_enrollment_preserves_professor_role(self):
- """تست اینکه ثبتنام در دوره نقش professor را حفظ میکند"""
- # کاربر استاد میشود
- self.user.add_role('professor')
-
- # کاربر دیگری دوره میسازد
- other_user = User.objects.create_user(
- email='other@example.com',
- fullname='Other User',
- password='testpass123'
- )
- other_user.add_role('professor')
-
- course = Course.objects.create(
- title='Test Course',
- slug='test-course',
- category=self.category,
- professor=other_user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Test description',
- is_free=True
- )
-
- # شبیهسازی transaction
- transaction_data = {
- 'participant_infos': [{'email': self.user.email}]
- }
-
- # شبیهسازی منطق transaction
- if not self.user.has_role('student'):
- self.user.add_role('student')
-
- Participant.objects.create(
- student=self.user,
- course=course
- )
-
- # بررسی اینکه هر دو نقش حفظ شدهاند
- self.assertTrue(self.user.has_role('professor'))
- self.assertTrue(self.user.has_role('student'))
-
- # بررسی اینکه کاربر میتواند دوره خودش را مدیریت کند
- own_course = Course.objects.create(
- title='Own Course',
- slug='own-course',
- category=self.category,
- professor=self.user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Own course description'
- )
-
- self.assertTrue(self.user.can_manage_course(own_course))
- self.assertFalse(self.user.can_manage_course(course)) # دوره دیگری
-
- def test_course_access_for_professor_student(self):
- """تست دسترسی دوره برای کاربری که هم استاد و هم دانشآموز است"""
- # کاربر استاد میشود
- self.user.add_role('professor')
-
- # دوره خودش
- own_course = Course.objects.create(
- title='Own Course',
- slug='own-course',
- category=self.category,
- professor=self.user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Own course description'
- )
-
- # دوره دیگری
- other_user = User.objects.create_user(
- email='other@example.com',
- fullname='Other User',
- password='testpass123'
- )
- other_user.add_role('professor')
-
- other_course = Course.objects.create(
- title='Other Course',
- slug='other-course',
- category=self.category,
- professor=other_user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Other course description'
- )
-
- # کاربر در دوره دیگری شرکت میکند
- self.user.add_role('student')
- Participant.objects.create(
- student=self.user,
- course=other_course
- )
-
- # تست دسترسیها
- from apps.course.serializers import CourseDetailSerializer
- from django.test import RequestFactory
-
- factory = RequestFactory()
- request = factory.get('/')
- request.user = self.user
-
- # دسترسی به دوره خودش
- serializer = CourseDetailSerializer(own_course, context={'request': request})
- data = serializer.data
- self.assertTrue(data['access'])
-
- # دسترسی به دوره دیگری (به عنوان participant)
- serializer = CourseDetailSerializer(other_course, context={'request': request})
- data = serializer.data
- self.assertTrue(data['access'])
-
- def test_backward_compatibility(self):
- """تست سازگاری با کدهای قدیمی"""
- # property قدیمی باید همچنان کار کند
- self.user.add_role('student')
- self.assertEqual(self.user.user_type_based_on_groups, User.UserType.STUDENT)
-
- self.user.add_role('professor')
- self.assertEqual(self.user.user_type_based_on_groups, User.UserType.PROFESSOR)
-
- # user_type field باید بروزرسانی شود
- self.assertEqual(self.user.user_type, User.UserType.PROFESSOR)
-
- def test_course_detail_serializer_uses_rub_price_for_russian_language(self):
- """برای زبان روسی باید قیمت روبلی برگردانده شود، نه دلار"""
- self.user.add_role('professor')
-
- course = Course.objects.create(
- title=[
- {"title": "English Title", "language_code": "en"},
- {"title": "Русский заголовок", "language_code": "ru"},
- ],
- slug='localized-course',
- category=self.category,
- professor=self.user,
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Test description',
- is_free=False,
- price=Decimal('100.00'),
- price_rub=Decimal('7500.00'),
- discount_percentage=10,
- )
-
- from apps.course.serializers import CourseDetailSerializer
- from django.test import RequestFactory
-
- factory = RequestFactory()
- request = factory.get('/', HTTP_ACCEPT_LANGUAGE='ru')
- request.user = self.user
- request.LANGUAGE_CODE = 'ru'
-
- serializer = CourseDetailSerializer(course, context={'request': request})
- data = serializer.data
-
- self.assertEqual(data['currency'], 'RUB')
- self.assertEqual(data['price'], '7500.00')
- self.assertEqual(data['final_price'], '6750.00')
diff --git a/apps/course/tests/test_my_courses_api.py b/apps/course/tests/test_my_courses_api.py
deleted file mode 100644
index 11a95e1..0000000
--- a/apps/course/tests/test_my_courses_api.py
+++ /dev/null
@@ -1,145 +0,0 @@
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.urls import reverse
-from rest_framework import status
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser, StudentUser
-from apps.course.models.course import Course, CourseCategory
-from apps.course.models.lesson import CourseChapter, CourseLesson, Lesson, LessonCompletion
-from apps.course.models.participant import Participant
-
-
-class MyCoursesAPITests(APITestCase):
- def setUp(self):
- self.professor = ProfessorUser.objects.create(
- email='prof@example.com',
- fullname='Professor Example',
- experience_years=5,
- )
- self.student = StudentUser.objects.create(
- email='student@example.com',
- fullname='Student Example',
- )
- self.category = CourseCategory.objects.create(
- name='Category',
- slug='category',
- )
-
- def _create_course(self, slug, title):
- thumbnail = SimpleUploadedFile('thumb.jpg', b'filecontent', content_type='image/jpeg')
- return Course.objects.create(
- title=title,
- slug=slug,
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=False,
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=0,
- description='Description',
- short_description='Short description',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
-
- def _attach_lessons(self, course, lesson_specs):
- chapter = CourseChapter.objects.create(
- course=course,
- title=f'{course.title} Chapter',
- priority=1,
- is_active=True,
- )
-
- created_lessons = []
- for index, spec in enumerate(lesson_specs, start=1):
- lesson = Lesson.objects.create(
- title=spec['title'],
- content_type=Lesson.ContentTypeChoices.VIDEO_FILE,
- duration=5,
- )
- course_lesson = CourseLesson.objects.create(
- course=course,
- chapter=chapter,
- lesson=lesson,
- priority=index,
- is_active=spec.get('is_active', True),
- )
- created_lessons.append(course_lesson)
-
- return created_lessons
-
- def test_completed_filter_returns_only_courses_with_all_active_lessons_completed(self):
- completed_course = self._create_course('completed-course', 'Completed Course')
- partial_course = self._create_course('partial-course', 'Partial Course')
- empty_course = self._create_course('empty-course', 'Empty Course')
-
- completed_lessons = self._attach_lessons(
- completed_course,
- [
- {'title': 'Completed Lesson 1'},
- {'title': 'Completed Lesson 2'},
- {'title': 'Inactive Lesson', 'is_active': False},
- ],
- )
- partial_lessons = self._attach_lessons(
- partial_course,
- [
- {'title': 'Partial Lesson 1'},
- {'title': 'Partial Lesson 2'},
- ],
- )
-
- Participant.objects.create(student=self.student, course=completed_course)
- Participant.objects.create(student=self.student, course=partial_course)
- Participant.objects.create(student=self.student, course=empty_course)
-
- LessonCompletion.objects.create(student=self.student, course_lesson=completed_lessons[0])
- LessonCompletion.objects.create(student=self.student, course_lesson=completed_lessons[1])
- LessonCompletion.objects.create(student=self.student, course_lesson=partial_lessons[0])
-
- self.client.force_authenticate(user=self.student)
- url = reverse('course-my-courses-list')
- response = self.client.get(url, {'completed': 'true'}, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- self.assertEqual(response.data['count'], 1)
- self.assertEqual({item['slug'] for item in response.data['results']}, {completed_course.slug})
-
- def test_my_courses_without_completed_filter_returns_completed_and_incomplete_courses(self):
- completed_course = self._create_course('all-completed-course', 'All Completed Course')
- partial_course = self._create_course('all-partial-course', 'All Partial Course')
-
- completed_lessons = self._attach_lessons(
- completed_course,
- [
- {'title': 'Completed Lesson 1'},
- ],
- )
- partial_lessons = self._attach_lessons(
- partial_course,
- [
- {'title': 'Partial Lesson 1'},
- {'title': 'Partial Lesson 2'},
- ],
- )
-
- Participant.objects.create(student=self.student, course=completed_course)
- Participant.objects.create(student=self.student, course=partial_course)
-
- LessonCompletion.objects.create(student=self.student, course_lesson=completed_lessons[0])
- LessonCompletion.objects.create(student=self.student, course_lesson=partial_lessons[0])
-
- self.client.force_authenticate(user=self.student)
- url = reverse('course-my-courses-list')
- response = self.client.get(url, format='json')
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- self.assertEqual(response.data['count'], 2)
- self.assertEqual(
- {item['slug'] for item in response.data['results']},
- {completed_course.slug, partial_course.slug},
- )
diff --git a/apps/course/tests/test_professor_api.py b/apps/course/tests/test_professor_api.py
deleted file mode 100644
index 72bd79d..0000000
--- a/apps/course/tests/test_professor_api.py
+++ /dev/null
@@ -1,113 +0,0 @@
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.urls import reverse
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser
-from apps.course.models import Course, CourseCategory, CourseLesson, Lesson
-
-
-class TestProfessorAPI(APITestCase):
- def setUp(self):
- self.professor = ProfessorUser.objects.create(
- email='professor@example.com',
- fullname='استاد نمونه',
- experience_years=7,
- )
- self.category = CourseCategory.objects.create(name='General', slug='general')
- thumbnail = SimpleUploadedFile('thumb.jpg', b'filecontent', content_type='image/jpeg')
- self.course = Course.objects.create(
- title='Test Course',
- slug='test-course',
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=True,
- online_link='https://example.com/classroom',
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=1,
- description='Sample description',
- short_description='Short description',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
- lesson = Lesson.objects.create(
- title='Lesson 1',
- content_type=Lesson.ContentTypeChoices.VIDEO_FILE,
- duration=5,
- )
- CourseLesson.objects.create(course=self.course, lesson=lesson, priority=1, is_active=True)
- self.professor.refresh_from_db()
-
- def test_professor_list_api(self):
- url = reverse('course-professor-list')
- response = self.client.get(url)
- self.assertEqual(response.status_code, 200)
- self.assertEqual(response.data['count'], 1)
- item = response.data['results'][0]
- self.assertEqual(item['slug'], self.professor.slug)
- self.assertEqual(item['fullname'], self.professor.fullname)
- self.assertEqual(item['experience_years'], 7)
- self.assertEqual(item['course_count'], 1)
- self.assertEqual(item['lesson_count'], 1)
-
- def test_professor_detail_api(self):
- url = reverse('course-professor-detail', kwargs={'slug': self.professor.slug})
- response = self.client.get(url)
- self.assertEqual(response.status_code, 200)
- data = response.data
- self.assertEqual(data['slug'], self.professor.slug)
- self.assertEqual(data['fullname'], self.professor.fullname)
- self.assertEqual(data['experience_years'], 7)
- self.assertEqual(data['course_count'], 1)
- self.assertEqual(data['lesson_count'], 1)
-
- def test_professor_courses_api(self):
- url = reverse('course-professor-course-list', kwargs={'slug': self.professor.slug})
- response = self.client.get(url)
- self.assertEqual(response.status_code, 200)
- self.assertEqual(response.data['count'], 1)
- course_data = response.data['results'][0]
- self.assertEqual(course_data['id'], self.course.id)
- self.assertEqual(course_data['title'], self.course.title)
-
- def test_professor_slug_generated_without_fullname(self):
- professor = ProfessorUser.objects.create(
- email='slugless@example.com',
- fullname='',
- )
- self.assertTrue(professor.slug)
-
- def test_course_creation_promotes_professor_user(self):
- professor = ProfessorUser.objects.create(
- email='pending@example.com',
- fullname='کاربر موقت',
- )
- professor.user_type = ProfessorUser.UserType.CLIENT
- professor.slug = None
- professor.save(update_fields=['user_type', 'slug'])
-
- thumbnail = SimpleUploadedFile('thumb2.jpg', b'filecontent', content_type='image/jpeg')
- Course.objects.create(
- title='Auto Promote Course',
- slug='auto-promote-course',
- category=self.category,
- professor=professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video2',
- is_online=False,
- level=Course.LevelChoices.BEGINNER,
- duration=5,
- lessons_count=0,
- description='Test',
- short_description='Test',
- status=Course.StatusChoices.REGISTERING,
- is_free=True,
- )
-
- professor.refresh_from_db()
- self.assertEqual(professor.user_type, ProfessorUser.UserType.PROFESSOR)
- self.assertTrue(professor.slug)
diff --git a/apps/course/tests/test_webhook_live_session.py b/apps/course/tests/test_webhook_live_session.py
deleted file mode 100644
index 56ff461..0000000
--- a/apps/course/tests/test_webhook_live_session.py
+++ /dev/null
@@ -1,201 +0,0 @@
-import hashlib
-import hmac
-import json
-import tempfile
-from datetime import timedelta
-from unittest import mock
-
-from django.core.management import call_command
-from django.core.files.uploadedfile import SimpleUploadedFile
-from django.test import override_settings
-from django.urls import reverse
-from django.utils import timezone
-from dj_language.models import Language
-from rest_framework import status
-from rest_framework.test import APITestCase
-
-from apps.account.models import ProfessorUser, StudentUser
-from apps.course.models import (
- Course,
- CourseCategory,
- CourseLiveSession,
- LiveSessionUser,
-)
-
-
-@override_settings(
- PLUGNMEET_API_SECRET='test-secret',
- MEDIA_ROOT=tempfile.gettempdir(),
-)
-class PlugNMeetWebhookLiveSessionTests(APITestCase):
- def setUp(self):
- Language.objects.update_or_create(
- id=69,
- defaults={
- 'name': 'English',
- 'code': 'en',
- 'status': True,
- 'countries': ['US'],
- },
- )
- self.professor = ProfessorUser.objects.create(
- email='webhook-prof@example.com',
- fullname='Webhook Professor',
- experience_years=8,
- )
- self.student = StudentUser.objects.create(
- email='webhook-student@example.com',
- fullname='Webhook Student',
- )
- self.category = CourseCategory.objects.create(
- name='Webhook Category',
- slug='webhook-category',
- )
- thumbnail = SimpleUploadedFile(
- 'thumb.jpg',
- b'filecontent',
- content_type='image/jpeg',
- )
- self.course = Course.objects.create(
- title='Webhook Course',
- slug='webhook-course',
- category=self.category,
- professor=self.professor,
- thumbnail=thumbnail,
- video_type=Course.VedioTypeChoices.YOUTUBE_LINK,
- video_link='https://example.com/video',
- is_online=True,
- online_link='https://example.com/live',
- level=Course.LevelChoices.BEGINNER,
- duration=10,
- lessons_count=1,
- description='Description',
- short_description='Short',
- status=Course.StatusChoices.ONGOING,
- is_free=True,
- )
- self.session = CourseLiveSession.objects.create(
- course=self.course,
- room_id='room-16-1781160705',
- subject='Webhook Course Live Session',
- started_at=timezone.now(),
- )
- LiveSessionUser.objects.create(
- session=self.session,
- user=self.student,
- role='participant',
- entered_at=timezone.now(),
- is_online=True,
- )
-
- def _post_webhook(self, payload: dict):
- body = json.dumps(payload, ensure_ascii=False).encode('utf-8')
- signature = hmac.new(
- b'test-secret',
- body,
- hashlib.sha256,
- ).hexdigest()
- url = reverse('plugnmeet-webhook')
- return self.client.post(
- url,
- data=body,
- content_type='application/webhook+json',
- HTTP_HASH_TOKEN=signature,
- )
-
- def test_room_finished_with_room_name_closes_live_session(self):
- response = self._post_webhook(
- {
- 'event': 'room_finished',
- 'room': {
- 'name': self.session.room_id,
- },
- }
- )
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- self.session.refresh_from_db()
- self.assertIsNotNone(self.session.ended_at)
- self.assertFalse(
- LiveSessionUser.objects.get(session=self.session, user=self.student).is_online
- )
-
- def test_session_ended_event_closes_live_session(self):
- second_session = CourseLiveSession.objects.create(
- course=self.course,
- room_id='room-16-1781160999',
- subject='Second Live Session',
- started_at=timezone.now(),
- )
-
- response = self._post_webhook(
- {
- 'event': 'session_ended',
- 'room': {
- 'name': second_session.room_id,
- },
- }
- )
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- second_session.refresh_from_db()
- self.assertIsNotNone(second_session.ended_at)
-
- def test_last_moderator_leave_schedules_auto_close(self):
- LiveSessionUser.objects.create(
- session=self.session,
- user=self.professor,
- role='moderator',
- entered_at=timezone.now(),
- is_online=True,
- )
-
- response = self._post_webhook(
- {
- 'event': 'participant_left',
- 'room': {
- 'name': self.session.room_id,
- },
- 'participant': {
- 'identity': str(self.professor.id),
- },
- }
- )
-
- self.assertEqual(response.status_code, status.HTTP_200_OK)
- self.session.refresh_from_db()
- self.assertIsNotNone(self.session.last_moderator_left_at)
- self.assertIsNotNone(self.session.auto_close_after_moderator_exit_at)
-
- @mock.patch('apps.course.management.commands.auto_close_professorless_live_sessions.PlugNMeetClient')
- def test_auto_close_command_closes_professorless_session(self, mock_client_cls):
- LiveSessionUser.objects.create(
- session=self.session,
- user=self.professor,
- role='moderator',
- entered_at=timezone.now() - timedelta(minutes=20),
- exited_at=timezone.now() - timedelta(minutes=15),
- is_online=False,
- )
- self.session.last_moderator_left_at = timezone.now() - timedelta(minutes=15)
- self.session.auto_close_after_moderator_exit_at = timezone.now() - timedelta(minutes=5)
- self.session.save(
- update_fields=[
- 'last_moderator_left_at',
- 'auto_close_after_moderator_exit_at',
- 'updated_at',
- ]
- )
-
- mock_client = mock_client_cls.return_value
- mock_client.end_room.return_value = {'status': True, 'msg': 'room ended successfully'}
-
- call_command('auto_close_professorless_live_sessions')
-
- self.session.refresh_from_db()
- self.assertIsNotNone(self.session.ended_at)
- self.assertIsNone(self.session.last_moderator_left_at)
- self.assertIsNone(self.session.auto_close_after_moderator_exit_at)
- self.assertFalse(
- LiveSessionUser.objects.get(session=self.session, user=self.student).is_online
- )
diff --git a/apps/course/token-join-guide.md b/apps/course/token-join-guide.md
deleted file mode 100644
index 7386951..0000000
--- a/apps/course/token-join-guide.md
+++ /dev/null
@@ -1,312 +0,0 @@
-# راهنمای گرفتن توکن و ورود کلاینت به کلاسهای plugNmeet
-
-این راهنما خلاصه میکند که برای سناریوی استاد/دانشجو چگونه از سرویس plugNmeet توکن بگیریم و کلاینت فرانتاند (`client/`) با آن وارد کلاس شود.
-
-## پیشنیازها
-- آدرس سرویس: `window.PLUG_N_MEET_SERVER_URL = "https://meet.imamjavad.online"` (در `config.js`).
-- `api_key` و `secret` از فایل پیکربندی بکاند (`services/plugnmeet-server/config.yaml`).
-- بدنهٔ درخواستها باید با پروتکل JSON متناظر با پیامهای پروتوباف (`plugnmeet-protocol`) ارسال شود؛ سرور طبق `HandleAuthHeaderCheck` هدرهای امنیتی را بررسی میکند.
-
-## گام ۱: ایجاد یا فعال بودن اتاق
-
-### API Endpoint برای Django Backend:
-```
-POST /api/courses//online/room/create/
-```
-
-### بدنه درخواست از فرانت به Django:
-```json
-{
- "subject": "کلاس جبر فصل ۱" // اختیاری - عنوان روم
-}
-```
-
-**⚠️ نکات مهم:**
-- **فرانت نباید `metadata` ارسال کند!**
-- بکاند Django (در `apps/course/views/live_session.py`) بهطور خودکار تنظیمات امنیتی را اعمال میکند
-- این تضمین میکند که تنظیمات امنیتی بهصورت متمرکز و یکسان اعمال شود
-
-### بدنه درخواست از Django به PlugNMeet (خودکار):
-بکاند Django این بدنه را خودش به PlugNMeet ارسال میکند:
-
-```json
-{
- "room_id": "algebra-1402",
- "metadata": {
- "room_title": "کلاس جبر فصل ۱",
- "default_lock_settings": {
- "lock_microphone": true, // 🔒 قفل - فقط میزبان میتواند باز کند
- "lock_webcam": true, // 🔒 قفل - فقط میزبان میتواند باز کند
- "lock_screen_sharing": true // 🔒 قفل - فقط میزبان میتواند باز کند
- },
- "room_features": {
- "mute_on_start": true, // 🔇 همه با میک خاموش وارد میشوند
- "waiting_room_features": {
- "is_active": false
- }
- }
- }
-}
-```
-
-> **چرا بکاند این کار را میکند؟**
-> - ✅ **امنیت متمرکز**: تنظیمات امنیتی در یک جا کنترل میشود
-> - ✅ **جلوگیری از دستکاری**: فرانت نمیتواند تنظیمات را تغییر دهد
-> - ✅ **یکپارچگی**: همه کلاسها با تنظیمات یکسان ساخته میشوند
-> - 🔒 طبق تابع `AssignLockSettingsToUser` در `pkg/models/user_lock.go` این مقادیر برای کاربران غیر-admin اعمال میشود
-
-## گام ۲: گرفتن توکن ورود
-
-### API Endpoint برای Django Backend:
-```
-POST /api/courses/online/room/token/
-```
-
-### درخواست از فرانت به Django:
-```
-Headers:
- Authorization: Token
- Content-Type: application/json
-
-Body:
-{
- "course_slug": "algebra-10"
-}
-```
-
-**⚠️ نکات مهم:**
-- **فرانت فقط `course_slug` ارسال میکند!**
-- بکاند Django از `Authorization` header کاربر را شناسایی میکند
-- بکاند خودش live session فعال دوره را پیدا میکند:
- ```python
- # 1. پیدا کردن دوره
- course = Course.objects.get(slug=course_slug)
-
- # 2. پیدا کردن live session فعال
- session = CourseLiveSession.objects.get(
- course=course,
- ended_at__isnull=True # session هایی که هنوز به پایان نرسیدهاند
- )
-
- # 3. گرفتن room_id
- room_id = session.room_id
- ```
-- بکاند خودش همه اطلاعات کاربر را میسازد:
- - `user_id` از `request.user`
- - `name` از `user.get_full_name()` یا `user.email`
- - `is_admin` از `user.can_manage_course(course)`
- - `profilePic` از `user.avatar`
- - `lock_settings` برای غیر-admin
-
-### بدنه درخواست از Django به PlugNMeet (خودکار):
-
-بکاند Django این payload را خودش میسازد و به PlugNMeet میفرستد:
-
-**برای استاد:**
-```json
-{
- "room_id": "algebra-1402",
- "user_info": {
- "user_id": "10", // 🔐 از request.user
- "name": "استاد نمونه", // 🔐 از user.get_full_name()
- "is_admin": true, // 🔐 از user.can_manage_course()
- "user_metadata": {
- "is_hidden": false,
- "profilePic": "https://..." // 🔐 از user.avatar
- }
- }
-}
-```
-
-**برای دانشجو:**
-```json
-{
- "room_id": "algebra-1402",
- "user_info": {
- "user_id": "27", // 🔐 از request.user
- "name": "دانشجو نمونه", // 🔐 از user.get_full_name()
- "is_admin": false, // 🔐 از user.can_manage_course()
- "user_metadata": {
- "profilePic": "https://...", // 🔐 از user.avatar
- "lock_settings": { // 🔒 خودکار برای غیر-admin
- "lock_microphone": true,
- "lock_screen_sharing": true,
- "lock_webcam": true
- }
- }
- }
-}
-```
-
-### نحوه کار بکاند Django:
-```python
-# 1. شناسایی کاربر از token
-user = request.user # از Authorization header
-
-# 2. پیدا کردن دوره و session فعال
-course = Course.objects.get(slug=course_slug)
-session = CourseLiveSession.objects.get(course=course, ended_at__isnull=True)
-room_id = session.room_id
-
-# 3. تشخیص نقش
-is_admin = user.can_manage_course(course) # استاد یا مالک دوره
-
-# 4. ساخت user_info
-user_info = {
- 'user_id': str(user.id),
- 'name': user.get_full_name() or user.email,
- 'is_admin': is_admin,
-}
-
-# 4. اضافه کردن profilePic
-profile_pic = request.build_absolute_uri(user.avatar.url)
-user_metadata['profilePic'] = profile_pic
-
-# 5. اضافه کردن lock_settings برای غیر-admin
-if not is_admin:
- user_metadata['lock_settings'] = {
- 'lock_microphone': True,
- 'lock_screen_sharing': True,
- 'lock_webcam': True,
- }
-```
-
-### ارسال به PlugNMeet:
-بکاند Django با هدرهای امنیتی به PlugNMeet ارسال میکند:
-- `API-KEY`: از settings
-- `HASH-SIGNATURE`: `HMAC_SHA256(body, secret)`
-- این توکن JWT اختصاصی plugNmeet است که در `GeneratePNMJoinToken` ساخته میشود
-- `is_admin: true` باعث میشود در `GetPNMJoinToken` کاربر به عنوان presenter با تمام دسترسیها ثبت شود
-- `lock_settings` باعث میشود در فرانتاند PlugNMeet دکمههای میکروفون/وبکم غیرفعال شوند
-
-### پاسخ Django به فرانت:
-```json
-{
- "room_id": "algebra-1402",
- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
- "plugnmeet": {
- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
- "expires": 300,
- ...
- }
-}
-```
-
-فرانت با این `token` میتواند کاربر را به PlugNMeet وارد کند:
-```
-https://meet.imamjavad.online/?access_token=
-```
-
-## گام ۳: ورود کلاینت با توکن
-۱. توکن را در URL یا کوکی قرار دهید؛ کلاینت مقدار را از `access_token` در کوئریاسترینگ یا از کوکی `pnm_access_token` میخواند (`getAccessToken` در `client/src/helpers/utils.ts`).
-۲. آدرس ورود: `https://meet.imamjavad.online/?access_token=`.
-۳. اپلیکیشن React موجود در `client/src/components/app/index.tsx` پس از بارگذاری:
- - درخواست `POST /api/verifyToken` را با هدر `Authorization: ` میفرستد (`HandleVerifyToken`).
- - اگر توکن معتبر باشد، لیست آدرسهای NATS و موضوعات لازم را میگیرد و اتصال را آغاز میکند (`startNatsConn`).
-۴. پس از اتصال، وضعیت کاربر و اتاق در Redux ذخیره میشود (`sessionSlice`). اگر کاربر ادمین باشد، تمام امکانات بدون محدودیت فعال است؛ در غیر این صورت مقدارهای `lock_settings` تعیین میکنند چه دکمههایی فعال باشند.
-
-## کنترل حالت صحبت/شنیدن برای استاد و دانشجو
-
-### استاد (Moderator/Host):
-- ✅ در توکن `is_admin: true` ارسال میشود
-- ✅ بکاند Django در `apps/course/views/live_session.py` این را تشخیص میدهد:
- ```python
- is_admin = user.can_manage_course(course) # استاد یا مالک دوره
- ```
-- ✅ سرور PlugNMeet در `GetPNMJoinToken` رول presenter را فعال میکند
-- ✅ **هیچ قفلی** روی میکروفون، وبکم یا اشتراک صفحه اعمال نمیشود
-- 🎤 استاد میتواند بلافاصله صحبت کند و به دانشجو **اجازه صحبت** دهد
-
-### دانشجو (Participant):
-- 🔒 در توکن `is_admin: false` ارسال میشود
-- 🔒 بکاند Django خودکار lock_settings را اضافه میکند:
- ```python
- if not is_admin:
- user_metadata['lock_settings'] = {
- 'lock_microphone': True,
- 'lock_screen_sharing': True,
- 'lock_webcam': True,
- }
- ```
-- 🔇 دکمههای میکروفون، وبکم و اشتراک صفحه **غیرفعال** هستند
-- 👂 فقط میتواند **گوش دهد** تا میزبان اجازه دهد
-- این منطق در `joinModal.tsx` با متغیر `isMicLock` پیادهسازی شده است
-
-### نحوه دادن اجازه به دانشجو:
-- میزبان باید از داخل کلاس از طریق UI کنترل کند
-- یا از API `/api/updateLockSettings` یا `switchPresenter` استفاده کند
-
-## نکات تکمیلی
-
-### توکنها و انقضا:
-- توکنها زمان انقضای مفهومی دارند (`client.token_validity` در YAML)
-- در صورت نزدیک شدن به انقضا، کلاینت خودکار با `REQ_RENEW_PNM_TOKEN` درخواست تمدید میدهد
-
-### Authorization:
-- برای درخواستهای بعدی به `/api/...` همان هدر `Authorization` را ست کنید
-- کلاینت این کار را در `helpers/api/plugNmeetAPI.ts` انجام میدهد
-
-### مدیریت دسترسیها:
-- اگر میخواهید دانشجو را به صحبتکننده ارتقا دهید: `/api/updateLockSettings` یا `switchPresenter`
-- این کار فقط توسط **میزبان** امکانپذیر است
-
-## 🔐 جمعبندی امنیت
-
-### ❌ چیزهایی که فرانت نباید انجام دهد:
-
-#### موقع ساخت روم:
-- ❌ ارسال `metadata`
-- ❌ ارسال `default_lock_settings`
-- ❌ ارسال `room_features`
-
-#### موقع گرفتن توکن:
-- ❌ ارسال `room_id` (بکاند خودش از session فعال میگیرد)
-- ❌ ارسال `user_info`
-- ❌ ارسال `is_admin`
-- ❌ ارسال `lock_settings`
-- ❌ ارسال `user_id` یا `name`
-
-### ✅ چیزهایی که فرانت فقط ارسال میکند:
-
-#### موقع ساخت روم:
-```json
-{
- "room_id": "algebra-1402", // اختیاری
- "subject": "کلاس جبر" // اختیاری
-}
-```
-
-#### موقع گرفتن توکن:
-```json
-{
- "course_slug": "algebra-10" // فقط این!
-}
-```
-+ `Authorization: Token ` در header
-
-### ✅ چیزهایی که بکاند Django خودش انجام میدهد:
-
-#### برای همه درخواستها:
-- ✅ شناسایی کاربر از `Authorization` header
-- ✅ بررسی دسترسی با `user.can_manage_course()` یا `Participant.objects.filter()`
-
-#### موقع ساخت روم:
-- ✅ تعیین `default_lock_settings` (همه `true`)
-- ✅ تعیین `room_features.mute_on_start: true`
-- ✅ ساخت `metadata` کامل برای PlugNMeet
-
-#### موقع گرفتن توکن:
-- ✅ پیدا کردن live session فعال از `course_slug`
-- ✅ گرفتن `room_id` از session
-- ✅ ساخت `user_id` از `request.user.id`
-- ✅ ساخت `name` از `user.get_full_name()` یا `user.email`
-- ✅ تشخیص `is_admin` از `user.can_manage_course(course)`
-- ✅ گرفتن `profilePic` از `user.avatar`
-- ✅ اضافه کردن `lock_settings` برای غیر-admin
-- ✅ ساخت `user_info` کامل برای PlugNMeet
-
-**نتیجه:**
-- 🔒 **امنیت کامل**: فرانت نمیتواند هیچ تنظیمات امنیتی را دستکاری کند
-- ✅ **متمرکز**: همه logic در بکاند Django است
-- 🎯 **ساده**: فرانت فقط `course_slug` و `Authorization` header ارسال میکند
-- 🔐 **قابل کنترل**: بکاند تعیین میکند کدام session فعال است
diff --git a/apps/course/urls.py b/apps/course/urls.py
deleted file mode 100644
index b4cc817..0000000
--- a/apps/course/urls.py
+++ /dev/null
@@ -1,58 +0,0 @@
-
-from django.urls import path, re_path, include
-from rest_framework.routers import DefaultRouter, SimpleRouter
-from . import views
-
-router = SimpleRouter()
-router.register(r'admin/courses', views.AdminCourseViewSet, basename='admin-courses')
-router.register(r'admin/chapters', views.AdminChapterViewSet, basename='admin-chapters')
-router.register(r'admin/course-lessons', views.AdminCourseLessonViewSet, basename='admin-course-lessons')
-router.register(r'admin/course-attachments', views.AdminCourseAttachmentViewSet, basename='admin-course-attachments')
-router.register(r'admin/course-glossaries', views.AdminCourseGlossaryViewSet, basename='admin-course-glossaries')
-router.register(r'admin/live-sessions', views.AdminLiveSessionViewSet, basename='admin-live-sessions')
-
-# Base model admin routes for the Repository Page
-router.register(r'admin/categories', views.AdminCourseCategoryViewSet, basename='admin-categories')
-router.register(r'admin/lessons', views.AdminLessonViewSet, basename='admin-lessons-base')
-router.register(r'admin/attachments', views.AdminAttachmentViewSet, basename='admin-attachments-base')
-router.register(r'admin/glossaries', views.AdminGlossaryViewSet, basename='admin-glossaries-base')
-
-# Hide admin viewsets from swagger
-for prefix, viewset, basename in router.registry:
- viewset.swagger_schema = None
-
-urlpatterns = [
- path('', include(router.urls)),
- path('categories/', views.CourseCategoryAPIView.as_view(), name='course-categories'),
- path('', views.CourseListAPIView.as_view(), name='course-list'),
- path('my-courses/', views.MyCourseListAPIView.as_view(), name='course-my-courses-list'),
- path('lesson/completion/', views.LessonCompletionToggleAPIView.as_view(), name='lesson-completion'),
- path('professors/', views.ProfessorListAPIView.as_view(), name='course-professor-list'),
- re_path(r'professors/(?P[\w-]+)/courses/$', views.ProfessorCourseListAPIView.as_view(), name='course-professor-course-list'),
- re_path(r'professors/(?P[\w-]+)/$', views.ProfessorDetailAPIView.as_view(), name='course-professor-detail'),
- path('/online/token/', views.CourseOnlineClassTokenAPIView.as_view(), name='course-online-token'),
- re_path(r'(?P[\w-]+)/online/validate/$', views.CourseOnlineClassTokenValidateAPIView.as_view(), name='course-online-validate'),
- path('online/token/validate/', views.CourseOnlineClassTokenValidateAPIView.as_view(), name='course-online-token-validate'),
- re_path(r'(?P[\w-]+)/online/room/create/$', views.CourseLiveSessionRoomCreateAPIView.as_view(), name='course-live-session-room-create'),
- path('online/room/token/', views.CourseLiveSessionTokenAPIView.as_view(), name='course-live-session-token'),
- path('online/room/recording/', views.CourseLiveSessionRecordingAPIView.as_view(), name='course-live-session-recording'),
- path('online/room/recording/web-egress/callback/', views.CourseLiveSessionWebEgressCallbackAPIView.as_view(), name='course-live-session-web-egress-callback'),
- path('online/room/set-recording-title/', views.CourseLiveSessionSetRecordingTitleAPIView.as_view(), name='course-live-session-set-recording-title'),
- path('live-sessions//recorded-file/', views.CourseLiveSessionRecordedFileAPIView.as_view(), name='course-live-session-recorded-file'),
-
- # PlugNMeet webhook endpoint
- path('plugnmeet/webhook/', views.PlugNMeetWebhookAPIView.as_view(), name='plugnmeet-webhook'),
-
- re_path(r'(?P[\w-]+)/$', views.CourseDetailAPIView.as_view(), name='course-detail'),
- re_path(r'(?P[\w-]+)/attachments/$', views.AttachmentListAPIView.as_view(), name='course-attachment-list'),
- re_path(r'(?P[\w-]+)/glossaries/$', views.GlossaryListAPIView.as_view(), name='course-glossary-list'),
- re_path(r'(?P[\w-]+)/lessons/$', views.LessonListView.as_view(), name='course-lesson-list'),
- re_path(r'v2/(?P[\w-]+)/lessons/$', views.LessonListV2APIView.as_view(), name='course-lesson-list-v2'),
- path('lesson//', views.LessonDetailView.as_view(), name='lesson-detail'),
-
- re_path(r'(?P[\w-]+)/participants/$', views.CourseParticipantsView.as_view(), name='course-participant-list'),
-
-
- # path('/participant/join/', views.ParticipantCreateView.as_view(), name='course-participant-join'),
-
-]
diff --git a/apps/course/views/__init__.py b/apps/course/views/__init__.py
deleted file mode 100644
index 6fc4005..0000000
--- a/apps/course/views/__init__.py
+++ /dev/null
@@ -1,7 +0,0 @@
-from .course import *
-from .lesson import *
-from .participant import *
-from .professor import *
-from .live_session import *
-from .webhook import *
-from .admin import *
diff --git a/apps/course/views/admin.py b/apps/course/views/admin.py
deleted file mode 100644
index cf18141..0000000
--- a/apps/course/views/admin.py
+++ /dev/null
@@ -1,827 +0,0 @@
-import logging
-import re
-from copy import deepcopy
-
-from django.db import transaction
-from django.db.models import Count, Q
-from django.utils import timezone
-from rest_framework import serializers, viewsets
-from rest_framework.permissions import IsAuthenticated
-from rest_framework.authentication import TokenAuthentication
-from rest_framework.decorators import action
-from rest_framework.response import Response
-from rest_framework.exceptions import PermissionDenied
-from utils.pagination import StandardResultsSetPagination
-from apps.account.permissions import IsPanelUser, IsSuperAdminOrReadOnlyForProfessor
-from apps.course.services.plugnmeet import PlugNMeetClient, PlugNMeetError
-from apps.course.services.web_egress import stop_session_web_egress_if_active
-from apps.course.models import (
- Course,
- CourseCategory,
- CourseChapter,
- CourseLesson,
- Lesson,
- CourseAttachment,
- Attachment,
- CourseGlossary,
- Glossary,
- CourseLiveSession,
- LiveSessionUser,
- LiveSessionRecording
-)
-from apps.course.models.course import extract_text_from_json
-from apps.quiz.models import Quiz, Question
-from apps.course.serializers.admin import (
- AdminCourseCategorySerializer,
- AdminCourseListSerializer,
- AdminCourseDetailSerializer,
- AdminCourseChapterSerializer,
- AdminCourseLessonSerializer,
- AdminCourseAttachmentSerializer,
- AdminCourseGlossarySerializer,
- AdminLessonSerializer,
- AdminGlossarySerializer,
- AdminAttachmentSerializer,
- AdminLiveSessionListSerializer,
- AdminLiveSessionDetailSerializer
-)
-from utils import FileFieldSerializer
-
-logger = logging.getLogger(__name__)
-
-
-def is_professor(request):
- return getattr(request.user, 'user_type', None) == 'professor'
-
-
-class AdminCourseViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course management.
- Professors can only access/modify their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
-
- def get_serializer_class(self):
- if self.action == 'list':
- return AdminCourseListSerializer
- return AdminCourseDetailSerializer
-
- def get_queryset(self):
- queryset = Course.objects.all().select_related('category').prefetch_related('professors')
-
- # Professors can only see their own courses
- if is_professor(self.request):
- queryset = queryset.filter(professors=self.request.user)
-
- # Search Query
- search_query = self.request.query_params.get('search', None)
- has_search = False
- if search_query:
- has_search = True
- from django.db.models import Case, When, Value, IntegerField
- queryset = queryset.filter(
- Q(title__icontains=search_query) |
- Q(description__icontains=search_query) |
- Q(short_description__icontains=search_query)
- ).annotate(
- search_relevance=Case(
- When(title__icontains=search_query, then=Value(2)),
- default=Value(1),
- output_field=IntegerField()
- )
- )
-
- # Filters
- category_id = self.request.query_params.get('category', None)
- if category_id:
- queryset = queryset.filter(category_id=category_id)
-
- professor_ids = self.request.query_params.getlist('professor')
- if professor_ids:
- queryset = queryset.filter(professors__in=professor_ids).distinct()
-
- level = self.request.query_params.get('level', None)
- if level:
- queryset = queryset.filter(level__contains=[{"title": level}])
-
- status_param = self.request.query_params.get('status', None)
- if status_param:
- queryset = queryset.filter(status__contains=[{"title": status_param}])
-
- is_free_param = self.request.query_params.get('is_free', None)
- if is_free_param is not None:
- if is_free_param.lower() == 'true':
- queryset = queryset.filter(is_free=True)
- elif is_free_param.lower() == 'false':
- queryset = queryset.filter(is_free=False)
-
- student_id = self.request.query_params.get('student_id', None)
- if student_id:
- queryset = queryset.filter(participants__student_id=student_id)
-
- if has_search:
- return queryset.order_by('-search_relevance', '-id')
- return queryset.order_by('-id')
-
- def perform_create(self, serializer):
- # If the logged-in user is a professor, force the professor field to themselves
- if is_professor(self.request):
- serializer.save(professor=self.request.user)
- else:
- serializer.save()
-
- def perform_update(self, serializer):
- # Prevent professors from reassigning a course to another professor
- if is_professor(self.request):
- instance = self.get_object()
- if not instance.professors.filter(id=self.request.user.id).exists():
- raise PermissionDenied("You can only edit your own courses.")
- serializer.save(professor=self.request.user)
- else:
- serializer.save()
-
- def _build_cloned_title(self, source_course, requested_title=None):
- custom_title = str(requested_title or "").strip()
- if custom_title:
- return [{"language_code": "en", "title": custom_title}]
-
- source_titles = deepcopy(source_course.title or [])
- source_title_text = extract_text_from_json(source_titles).strip() or f"Course {source_course.pk}"
- base_title = re.sub(r"\s*\(copied(?:#\d+)?\)$", "", source_title_text).strip() or source_title_text
- suffix = "(copied)"
-
- if isinstance(source_titles, list) and source_titles:
- localized_titles = []
- for item in source_titles:
- if isinstance(item, dict):
- localized_item = deepcopy(item)
- for key in ("title", "text", "value", "name"):
- if key in localized_item and localized_item.get(key):
- cleaned_value = re.sub(r"\s*\(copied(?:#\d+)?\)$", "", str(localized_item[key])).strip()
- localized_item[key] = f"{cleaned_value}{suffix}"
- break
- else:
- localized_item["title"] = f"{base_title}{suffix}"
- localized_titles.append(localized_item)
- elif item:
- cleaned_item = re.sub(r"\s*\(copied(?:#\d+)?\)$", "", str(item)).strip()
- localized_titles.append(f"{cleaned_item}{suffix}")
-
- if localized_titles:
- return localized_titles
-
- return [{"language_code": "en", "title": f"{base_title}{suffix}"}]
-
- @action(detail=True, methods=['post'])
- def clone(self, request, pk=None):
- source_course = self.get_object()
- requested_title = request.data.get('title')
-
- with transaction.atomic():
- cloned_course = Course.objects.create(
- title=self._build_cloned_title(source_course, requested_title),
- category=source_course.category,
- thumbnail=source_course.thumbnail.name if source_course.thumbnail else None,
- video_type=source_course.video_type,
- video_file=source_course.video_file.name if source_course.video_file else None,
- video_link=source_course.video_link,
- is_online=source_course.is_online,
- online_link=source_course.online_link,
- level=deepcopy(source_course.level),
- duration=source_course.duration,
- lessons_count=source_course.lessons_count,
- description=deepcopy(source_course.description),
- short_description=deepcopy(source_course.short_description),
- status=deepcopy(source_course.status),
- is_free=source_course.is_free,
- price=source_course.price,
- price_rub=source_course.price_rub,
- discount_percentage=source_course.discount_percentage,
- is_group_chat_locked=source_course.is_group_chat_locked,
- is_professor_chat_locked=source_course.is_professor_chat_locked,
- timing=deepcopy(source_course.timing),
- features=deepcopy(source_course.features),
- )
- cloned_course.professors.set(source_course.professors.all())
-
- chapter_map = {}
- source_chapters = source_course.chapters.all().order_by('priority', 'id')
- for chapter in source_chapters:
- cloned_chapter = CourseChapter.objects.create(
- course=cloned_course,
- title=deepcopy(chapter.title),
- priority=chapter.priority,
- is_active=chapter.is_active,
- )
- chapter_map[chapter.id] = cloned_chapter
-
- lesson_map = {}
- source_lessons = source_course.lessons.select_related('lesson', 'chapter').all().order_by('priority', 'id')
- for course_lesson in source_lessons:
- base_lesson = course_lesson.lesson
- cloned_lesson = Lesson.objects.create(
- title=deepcopy(base_lesson.title),
- content_type=deepcopy(base_lesson.content_type),
- content_file=base_lesson.content_file.name if base_lesson and base_lesson.content_file else None,
- video_link=base_lesson.video_link if base_lesson else None,
- duration=base_lesson.duration if base_lesson else 0,
- )
- cloned_course_lesson = CourseLesson.objects.create(
- course=cloned_course,
- chapter=chapter_map.get(course_lesson.chapter_id),
- lesson=cloned_lesson,
- title=deepcopy(course_lesson.title),
- priority=course_lesson.priority,
- is_active=course_lesson.is_active,
- )
- lesson_map[course_lesson.id] = cloned_course_lesson
-
- source_attachments = source_course.attachments.select_related('attachment').all()
- for course_attachment in source_attachments:
- base_attachment = course_attachment.attachment
- cloned_attachment = Attachment.objects.create(
- title=deepcopy(base_attachment.title),
- file=base_attachment.file.name if base_attachment and base_attachment.file else None,
- file_size=base_attachment.file_size if base_attachment else None,
- )
- CourseAttachment.objects.create(
- course=cloned_course,
- attachment=cloned_attachment,
- )
-
- source_glossaries = source_course.glossaries.select_related('glossary').all()
- for course_glossary in source_glossaries:
- base_glossary = course_glossary.glossary
- cloned_glossary = Glossary.objects.create(
- title=base_glossary.title,
- description=deepcopy(base_glossary.description),
- )
- CourseGlossary.objects.create(
- course=cloned_course,
- glossary=cloned_glossary,
- )
-
- source_quizzes = source_course.quizzes.prefetch_related('questions').all()
- for quiz in source_quizzes:
- cloned_quiz = Quiz.objects.create(
- lesson=lesson_map.get(quiz.lesson_id),
- course=cloned_course,
- lesson_number=quiz.lesson_number,
- title=deepcopy(quiz.title),
- description=deepcopy(quiz.description),
- each_question_timing=quiz.each_question_timing,
- status=quiz.status,
- )
- for question in quiz.questions.all():
- Question.objects.create(
- quiz=cloned_quiz,
- question=deepcopy(question.question),
- option1=deepcopy(question.option1),
- option2=deepcopy(question.option2),
- option3=deepcopy(question.option3),
- option4=deepcopy(question.option4),
- correct_answer=question.correct_answer,
- priority=question.priority,
- )
-
- cloned_course.recalculate_lessons_count()
- cloned_course.refresh_from_db()
-
- serializer = self.get_serializer(cloned_course)
- return Response(serializer.data, status=201)
-
-
-class AdminChapterViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course Chapters.
- Professors can only access chapters of their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminCourseChapterSerializer
- pagination_class = None
-
- def get_queryset(self):
- queryset = CourseChapter.objects.all()
-
- # Professors can only see chapters of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
- return queryset.order_by('priority', 'id')
-
- @action(detail=False, methods=['post'])
- def reorder(self, request):
- """
- Reorders chapters in bulk.
- Format: {"chapter_ids": [id1, id2, ...]}
- """
- chapter_ids = request.data.get('chapter_ids', [])
- if not chapter_ids:
- return Response({'error': 'chapter_ids list is required'}, status=400)
-
- from django.db import transaction
- with transaction.atomic():
- for idx, c_id in enumerate(chapter_ids):
- CourseChapter.objects.filter(id=c_id).update(priority=idx + 1)
-
- return Response({'status': 'success'})
-
-
-class AdminCourseLessonViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Lessons associated with a Course/Chapter.
- Professors can only access lessons in their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminCourseLessonSerializer
- pagination_class = None
-
- def get_queryset(self):
- queryset = CourseLesson.objects.all().select_related('lesson', 'chapter')
-
- # Professors can only see lessons of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
-
- chapter_id = self.request.query_params.get('chapter', None)
- if chapter_id:
- queryset = queryset.filter(chapter_id=chapter_id)
-
- return queryset.order_by('priority', 'id')
-
- def perform_destroy(self, instance):
- # Prevent orphans: delete the base Lesson object along with the junction model
- lesson = instance.lesson
- instance.delete()
- if lesson:
- lesson.delete()
-
- @action(detail=False, methods=['post'])
- def reorder(self, request):
- """
- Reorders lessons in bulk.
- Format: {"lesson_ids": [id1, id2, ...]}
- """
- lesson_ids = request.data.get('lesson_ids', [])
- if not lesson_ids:
- return Response({'error': 'lesson_ids list is required'}, status=400)
-
- from django.db import transaction
- with transaction.atomic():
- for idx, l_id in enumerate(lesson_ids):
- CourseLesson.objects.filter(id=l_id).update(priority=idx + 1)
-
- return Response({'status': 'success'})
-
-
-class AdminCourseAttachmentViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course Attachments.
- Professors can only access attachments of their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminCourseAttachmentSerializer
- pagination_class = None
-
- def get_queryset(self):
- queryset = CourseAttachment.objects.all().select_related('attachment')
-
- # Professors can only see attachments of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
- return queryset.order_by('-id')
-
- def create(self, request, *args, **kwargs):
- attachment_ids = request.data.get('attachment_ids')
- new_attachments = request.data.get('new_attachments')
- course_id = request.data.get('course')
-
- if not course_id or (not attachment_ids and not new_attachments):
- return super().create(request, *args, **kwargs)
-
- if is_professor(request):
- course = Course.objects.filter(id=course_id, professors=request.user).first()
- else:
- course = Course.objects.filter(id=course_id).first()
-
- if not course:
- raise PermissionDenied("Course not found or access denied.")
-
- created_links = []
- seen_attachment_ids = set()
- file_field = FileFieldSerializer()
- file_field.bind('file', None)
-
- with transaction.atomic():
- for attachment_id in attachment_ids or []:
- try:
- parsed_id = int(attachment_id)
- except (TypeError, ValueError):
- continue
-
- if parsed_id in seen_attachment_ids:
- continue
- seen_attachment_ids.add(parsed_id)
-
- attachment = Attachment.objects.filter(pk=parsed_id).first()
- if not attachment:
- continue
-
- course_attachment, created = CourseAttachment.objects.get_or_create(
- course=course,
- attachment=attachment,
- )
- if created:
- created_links.append(course_attachment)
-
- for item in new_attachments or []:
- title = item.get('title')
- file_data = item.get('file')
- if not title or not file_data:
- continue
-
- try:
- normalized_file = file_field.to_internal_value(file_data)
- except serializers.ValidationError as exc:
- raise serializers.ValidationError({
- 'new_attachments': [exc.detail]
- })
-
- attachment = Attachment.objects.create(
- title=title,
- file=normalized_file,
- )
- created_links.append(
- CourseAttachment.objects.create(
- course=course,
- attachment=attachment,
- )
- )
-
- serializer = self.get_serializer(created_links, many=True)
- return Response(serializer.data, status=201)
-
- def perform_destroy(self, instance):
- # Prevent orphans: delete base Attachment along with junction model
- attachment = instance.attachment
- instance.delete()
- if attachment:
- attachment.delete()
-
-
-class AdminCourseGlossaryViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course Glossary terms.
- Professors can only access glossaries of their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminCourseGlossarySerializer
- pagination_class = None
-
- def get_queryset(self):
- queryset = CourseGlossary.objects.all().select_related('glossary')
-
- # Professors can only see glossaries of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
- return queryset.order_by('-id')
-
- def create(self, request, *args, **kwargs):
- glossary_ids = request.data.get('glossary_ids')
- new_glossaries = request.data.get('new_glossaries')
- course_id = request.data.get('course')
-
- if not course_id or (not glossary_ids and not new_glossaries):
- return super().create(request, *args, **kwargs)
-
- if is_professor(request):
- course = Course.objects.filter(id=course_id, professors=request.user).first()
- else:
- course = Course.objects.filter(id=course_id).first()
-
- if not course:
- raise PermissionDenied("Course not found or access denied.")
-
- created_links = []
- seen_glossary_ids = set()
-
- with transaction.atomic():
- for glossary_id in glossary_ids or []:
- try:
- parsed_id = int(glossary_id)
- except (TypeError, ValueError):
- continue
-
- if parsed_id in seen_glossary_ids:
- continue
- seen_glossary_ids.add(parsed_id)
-
- glossary = Glossary.objects.filter(pk=parsed_id).first()
- if not glossary:
- continue
-
- course_glossary, created = CourseGlossary.objects.get_or_create(
- course=course,
- glossary=glossary,
- )
- if created:
- created_links.append(course_glossary)
-
- for item in new_glossaries or []:
- title = item.get('title')
- description = item.get('description')
- if not title or not description:
- continue
-
- glossary = Glossary.objects.create(
- title=title,
- description=description,
- )
- created_links.append(
- CourseGlossary.objects.create(
- course=course,
- glossary=glossary,
- )
- )
-
- serializer = self.get_serializer(created_links, many=True)
- return Response(serializer.data, status=201)
-
- def perform_destroy(self, instance):
- # Prevent orphans: delete base Glossary along with junction model
- glossary = instance.glossary
- instance.delete()
- if glossary:
- glossary.delete()
-
-
-class AdminCourseCategoryViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course Categories.
- Professors have read-only access.
- """
- permission_classes = [IsAuthenticated, IsSuperAdminOrReadOnlyForProfessor]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminCourseCategorySerializer
- pagination_class = StandardResultsSetPagination
-
- def get_queryset(self):
- queryset = CourseCategory.objects.all().order_by('-id')
- search = self.request.query_params.get('search', None)
- if search:
- queryset = queryset.filter(Q(name__icontains=search) | Q(slug__icontains=search))
- return queryset
-
-
-class AdminLessonViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for base Lesson (Repository).
- Professors can only see lessons linked to their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminLessonSerializer
- pagination_class = StandardResultsSetPagination
-
- def get_queryset(self):
- queryset = Lesson.objects.all().order_by('-id')
-
- search = self.request.query_params.get('search', None)
- if search:
- queryset = queryset.filter(title__icontains=search)
-
- content_type = self.request.query_params.get('content_type', None)
- if content_type:
- queryset = queryset.filter(content_type__contains=[{"title": content_type}])
-
- return queryset
-
-
-class AdminGlossaryViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for base Glossary (Repository).
- Professors can only see glossaries linked to their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminGlossarySerializer
- pagination_class = StandardResultsSetPagination
-
- def get_queryset(self):
- queryset = Glossary.objects.all().order_by('-id')
-
- search = self.request.query_params.get('search', None)
- if search:
- queryset = queryset.filter(Q(title__icontains=search) | Q(description__icontains=search))
- return queryset
-
-
-class AdminAttachmentViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for base Attachment (Repository).
- Professors can only see attachments linked to their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- serializer_class = AdminAttachmentSerializer
- pagination_class = StandardResultsSetPagination
-
- def get_queryset(self):
- queryset = Attachment.objects.all().order_by('-id')
-
- search = self.request.query_params.get('search', None)
- if search:
- queryset = queryset.filter(title__icontains=search)
-
- file_type = self.request.query_params.get('type', None)
- if file_type:
- image_extensions = ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.bmp']
- video_extensions = ['.mp4', '.webm', '.ogg', '.mkv', '.mov', '.avi']
- audio_extensions = ['.mp3', '.wav', '.ogg', '.m4a', '.aac', '.flac']
-
- if file_type == 'image':
- q_objs = Q()
- for ext in image_extensions:
- q_objs |= Q(file__iendswith=ext)
- queryset = queryset.filter(q_objs)
- elif file_type == 'video':
- q_objs = Q()
- for ext in video_extensions:
- q_objs |= Q(file__iendswith=ext)
- queryset = queryset.filter(q_objs)
- elif file_type == 'audio':
- q_objs = Q()
- for ext in audio_extensions:
- q_objs |= Q(file__iendswith=ext)
- queryset = queryset.filter(q_objs)
- elif file_type == 'other':
- q_objs = Q()
- for ext in image_extensions + video_extensions + audio_extensions:
- q_objs |= Q(file__iendswith=ext)
- queryset = queryset.exclude(q_objs)
-
- return queryset
-
-
-class AdminLiveSessionViewSet(viewsets.ModelViewSet):
- """
- Admin CRUD ViewSet for Course Live Sessions.
- Professors can only access live sessions of their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
-
- def get_serializer_class(self):
- if self.action == 'list':
- return AdminLiveSessionListSerializer
- return AdminLiveSessionDetailSerializer
-
- def get_queryset(self):
- queryset = CourseLiveSession.objects.all().select_related('course').annotate(
- media_count=Count('recordings', distinct=True)
- )
-
- # Professors can only see live sessions of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- search = self.request.query_params.get('search', None)
- if search:
- queryset = queryset.filter(
- Q(subject__icontains=search) |
- Q(room_id__icontains=search) |
- Q(course__title__icontains=search)
- )
-
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
-
- professor_ids = self.request.query_params.getlist('professor')
- if professor_ids:
- queryset = queryset.filter(course__professors__in=professor_ids).distinct()
-
- time_range = self.request.query_params.get('time_range', None)
- if time_range:
- from datetime import timedelta
- now = timezone.now()
- if time_range == '3_days':
- queryset = queryset.filter(started_at__gte=now - timedelta(days=3))
- elif time_range == 'week':
- queryset = queryset.filter(started_at__gte=now - timedelta(days=7))
- elif time_range == 'month':
- queryset = queryset.filter(started_at__gte=now - timedelta(days=30))
- elif time_range == 'year':
- queryset = queryset.filter(started_at__gte=now - timedelta(days=365))
-
- started_after = self.request.query_params.get('started_after', None)
- if started_after:
- queryset = queryset.filter(started_at__gte=started_after)
-
- started_before = self.request.query_params.get('started_before', None)
- if started_before:
- queryset = queryset.filter(started_at__lte=started_before)
-
- ended_after = self.request.query_params.get('ended_after', None)
- if ended_after:
- queryset = queryset.filter(ended_at__gte=ended_after)
-
- ended_before = self.request.query_params.get('ended_before', None)
- if ended_before:
- queryset = queryset.filter(ended_at__lte=ended_before)
-
- return queryset.order_by('-started_at')
-
- def list(self, request, *args, **kwargs):
- queryset = self.filter_queryset(self.get_queryset())
- page = self.paginate_queryset(queryset)
-
- if page is not None:
- self._sync_page_live_sessions(page)
- serializer = self.get_serializer(page, many=True)
- return self.get_paginated_response(serializer.data)
-
- sessions = list(queryset)
- self._sync_page_live_sessions(sessions)
- serializer = self.get_serializer(sessions, many=True)
- return Response(serializer.data)
-
- def _sync_page_live_sessions(self, sessions):
- for session in sessions:
- if session.ended_at or not session.room_id:
- continue
-
- if self._is_room_still_active(session.room_id):
- continue
-
- stop_session_web_egress_if_active(session)
- now = timezone.now()
- session.ended_at = now
- session.save(update_fields=['ended_at', 'updated_at'])
-
- LiveSessionUser.objects.filter(
- session=session,
- is_online=True,
- ).update(is_online=False, exited_at=now, updated_at=now)
-
- logger.info(
- f"[Admin Live Sessions] Auto-closed stale session - session_id={session.id} room_id={session.room_id}"
- )
-
- @staticmethod
- def _is_room_still_active(room_id: str) -> bool:
- try:
- client = PlugNMeetClient()
- response = client.is_room_active(room_id)
- is_active_raw = response.get('isActive', False)
- is_active = (
- is_active_raw
- if isinstance(is_active_raw, bool)
- else str(is_active_raw).lower() == 'true'
- )
- response_msg = response.get('msg', '')
- response_status = response.get('status', False)
-
- if (
- response_status
- and 'active' in response_msg.lower()
- and 'not' not in response_msg.lower()
- ):
- return True
-
- return is_active
- except PlugNMeetError as e:
- error_msg = str(e).lower()
- if 'not found' in error_msg or 'does not exist' in error_msg:
- return False
- logger.warning(
- f"[Admin Live Sessions] PlugNMeet API error while checking room {room_id}: {e}"
- )
- return False
- except Exception as e:
- logger.warning(
- f"[Admin Live Sessions] Unexpected error while checking room {room_id}: {type(e).__name__}: {e}"
- )
- return False
diff --git a/apps/course/views/course.py b/apps/course/views/course.py
deleted file mode 100644
index ceee2a6..0000000
--- a/apps/course/views/course.py
+++ /dev/null
@@ -1,1207 +0,0 @@
-import logging
-from typing import Optional
-
-from django.conf import settings
-from django.contrib.auth import get_user_model
-from django.core.exceptions import ImproperlyConfigured
-from django.db.models import Count, Q, F
-from django.shortcuts import get_object_or_404
-from django.utils import timezone
-
-from drf_yasg import openapi
-from drf_yasg.utils import swagger_auto_schema
-from rest_framework import status
-from rest_framework.authentication import TokenAuthentication
-from rest_framework.authtoken.models import Token
-from rest_framework.exceptions import NotFound
-from rest_framework.filters import SearchFilter
-from rest_framework.generics import GenericAPIView, ListAPIView, RetrieveAPIView
-from rest_framework.permissions import AllowAny, IsAuthenticated
-from rest_framework.response import Response
-
-from utils.pagination import StandardResultsSetPagination
-
-logger = logging.getLogger(__name__)
-
-
-from apps.course.serializers import (
- CourseListSerializer, CourseCategorySerializer, CourseDetailSerializer,
- CourseAttachmentSerializer, CourseGlossarySerializer, MyCourseListSerializer,
- OnlineClassTokenCreateSerializer, OnlineClassTokenVerifySerializer
-)
-from apps.course.models import (
- Course,
- CourseAttachment,
- CourseCategory,
- CourseGlossary,
- CourseLiveSession,
- LiveSessionUser,
- Participant,
-)
-from apps.course.models.course import extract_text_from_json
-from apps.course.doc import *
-from apps.course.services.plugnmeet import PlugNMeetClient, PlugNMeetError
-from apps.course.services.web_egress import stop_session_web_egress_if_active
-from apps.account.serializers import UserProfileSerializer
-from utils.exceptions import AppAPIException
-from utils.redis import OnlineClassTokenManager
-import time
-
-
-UserModel = get_user_model()
-
-
-def get_course_slug_value(course: Course) -> str:
- slug_data = course.slug
- if isinstance(slug_data, list) and slug_data:
- first_item = slug_data[0]
- if isinstance(first_item, dict):
- first_title = first_item.get('title')
- if first_title:
- return str(first_title)
- if isinstance(slug_data, str):
- return slug_data
- return str(slug_data or '')
-
-
-def get_online_class_frontend_base() -> str:
- base = getattr(
- settings,
- "ONLINE_CLASS_FRONTEND_DOMAIN",
- getattr(settings, "SITE_DOMAIN", ""),
- ).rstrip("/")
- if base and not base.startswith(('http://', 'https://')):
- base = f"https://{base}"
- return base
-
-
-class CourseCategoryAPIView(ListAPIView):
- queryset = CourseCategory.objects.all().order_by('-id')
- serializer_class = CourseCategorySerializer
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description=doc_course_category(),
- tags=["Imam-Javad - Course"]
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
-
-
-
-from utils.pagination import StandardResultsSetPagination
-
-class CourseListAPIView(ListAPIView):
- serializer_class = CourseListSerializer
- filter_backends = [SearchFilter]
- search_fields = ['title', 'category__name', 'professors__fullname']
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- tags=['Imam-Javad - Course'],
- operation_description=doc_course_list(),
- manual_parameters=[
- openapi.Parameter(
- 'search', openapi.IN_QUERY,
- description="Search by course title, category name, or professor's full name",
- type=openapi.TYPE_STRING,
- ),
- openapi.Parameter(
- 'category_slug', openapi.IN_QUERY,
- description="Category of the Course",
- type=openapi.TYPE_STRING,
- # enum=[category.slug for category in CourseCategory.objects.all()]
- ),
- openapi.Parameter(
- 'status', openapi.IN_QUERY,
- type=openapi.TYPE_STRING,
- description="""Status =>
- Upcoming (visible but registration not allowed)---Предстоящие
- Registering (registration is open)---регистрация
- Ongoing (course has started, registration closed)---Впроцессе
- Finished (course has ended)---закончился
- """,
- enum=[status for status in ['upcoming', 'registering', 'ongoing', 'finished']]
- ),
- openapi.Parameter(
- 'is_free', openapi.IN_QUERY,
- description="Ценообразование is_free ",
- type=openapi.TYPE_BOOLEAN,
- ),
- openapi.Parameter(
- 'is_online', openapi.IN_QUERY,
- description="Статус участия is_online ",
- type=openapi.TYPE_BOOLEAN,
- ),
- ])
- def get(self, request, *args, **kwargs):
- return self.list(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset with select_related for ForeignKey relationships and filtering
- """
- queryset = Course.objects.select_related(
- 'category',
- ).prefetch_related(
- 'professors',
- ).exclude(
- status__contains=[{"title": Course.StatusChoices.INACTIVE}]
- ).order_by('-created_at', '-id')
-
- request = self.request
- filters = request.query_params
-
- # Handle category_slug with multiple values separated by commas
- if category_slugs := filters.get('category_slug'):
- category_slugs_list = category_slugs.split(',')
- category_q = Q()
- for slug_item in category_slugs_list:
- category_q |= Q(category__slug__contains=[{"title": slug_item}])
- queryset = queryset.filter(category_q)
-
- # Handle status with multiple values separated by commas
- if statuses := filters.get('status'):
- statuses_list = statuses.split(',')
- status_q = Q()
- for status_item in statuses_list:
- status_q |= Q(status__contains=[{"title": status_item}])
- queryset = queryset.filter(status_q)
-
- if is_free := filters.get('is_free'):
- is_free = is_free.lower() == 'true'
- queryset = queryset.filter(
- Q(is_free=is_free) | Q(price_rub=0) if is_free else Q(is_free=False, price_rub__gt=0)
- )
- if is_online := filters.get('is_online'):
- is_online = is_online.lower() == 'true'
- queryset = queryset.filter(is_online=is_online)
-
- return queryset
-
-
-
-
-
-class CourseDetailAPIView(RetrieveAPIView):
- serializer_class = CourseDetailSerializer
- lookup_field = "slug"
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- tags=["Imam-Javad - Course"],
- operation_description="Get detailed information about a specific course",
- responses={
- 200: openapi.Response(
- description="Course details",
- schema=CourseDetailSerializer()
- )
- }
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset with select_related and prefetch_related for all relationships
- """
- return Course.objects.select_related(
- 'category',
- ).prefetch_related(
- 'professors',
- 'chapters__lessons__lesson',
- 'chapters__lessons__completions',
- 'attachments__attachment',
- 'glossaries__glossary',
- 'participants__student',
- 'room_messages'
- )
-
- def get_object(self):
- queryset = self.filter_queryset(self.get_queryset())
- lookup_url_kwarg = self.lookup_url_kwarg or self.lookup_field
- slug_value = self.kwargs[lookup_url_kwarg]
- obj = queryset.filter(slug__contains=[{"title": slug_value}]).first()
- if not obj:
- raise NotFound("Course not found")
- self.check_object_permissions(self.request, obj)
- return obj
-
- @swagger_auto_schema(
- operation_description=doc_course_detail(),
- tags=['Imam-Javad - Course'],
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
-from rest_framework.authentication import TokenAuthentication
-class MyCourseListAPIView(ListAPIView):
- serializer_class = MyCourseListSerializer
- permission_classes = [IsAuthenticated]
- pagination_class = StandardResultsSetPagination
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(manual_parameters=[
- openapi.Parameter(
- 'completed', openapi.IN_QUERY,
- description="мои курсы completed true",
- type=openapi.TYPE_BOOLEAN,
- ),
- openapi.Parameter(
- 'certificate', openapi.IN_QUERY,
- type=openapi.TYPE_BOOLEAN,
- ),
- ],
- operation_description=doc_courses_my_courses(),
- operation_summary="Home",
- tags=['Imam-Javad - Course']
-
- )
- def get(self, request, *args, **kwargs):
- print(f'--> my-course-> {request}/ {kwargs}')
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset for user's courses (as student and professor) with select_related and prefetch_related
- """
- queryset = Course.objects.select_related(
- 'category',
- ).prefetch_related(
- 'professors',
- 'chapters__lessons__lesson',
- 'chapters__lessons__completions',
- 'participants__student'
- ).exclude(status__contains=[{"title": Course.StatusChoices.INACTIVE}])
-
- request = self.request
- filters = request.query_params
- user = self.request.user
-
- # Include courses where user is a student OR one of the professors
- qs = queryset.filter(Q(participants__student=user) | Q(professors=user)).distinct()
-
- completed_param = filters.get('completed')
- if completed_param is not None:
- completed_only = completed_param.lower() == 'true'
- # Only active chapters/lessons should participate in completion checks.
- total_lessons_filter = Q(
- chapters__is_active=True,
- chapters__lessons__is_active=True,
- )
- completed_lessons_filter = Q(
- chapters__is_active=True,
- chapters__lessons__is_active=True,
- chapters__lessons__completions__student=user,
- )
-
- qs = qs.annotate(
- total_lessons=Count(
- 'chapters__lessons',
- filter=total_lessons_filter,
- distinct=True,
- ),
- completed_lessons=Count(
- 'chapters__lessons__completions',
- filter=completed_lessons_filter,
- distinct=True,
- ),
- )
-
- if completed_only:
- # A course is "completed" only when every active lesson is completed.
- # Courses with no active lessons should not be marked as completed.
- qs = qs.filter(
- total_lessons__gt=0,
- total_lessons=F('completed_lessons'),
- )
- else:
- qs = qs.filter(total_lessons__gt=F('completed_lessons'))
-
- if 'completed' not in filters:
- certificate = filters.get('certificate', '').lower() == 'true'
- if certificate:
- qs = qs.exclude(
- course_certificates__student=user,
- course_certificates__status__in=['pending', 'approved']
- )
-
- return qs
-
-
-
-
-class AttachmentListAPIView(ListAPIView):
- serializer_class = CourseAttachmentSerializer
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- tags=['Imam-Javad - Course'],
- manual_parameters=[
- openapi.Parameter(
- 'slug', openapi.IN_PATH,
- description="Slug of the Course",
- type=openapi.TYPE_STRING,
- required=True
- )
- ],
- operation_description="Retrieve a list of attachments for a given course by its slug."
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset with select_related for attachment relationship
- """
- course_slug = self.kwargs.get('slug')
- course = Course.objects.filter(slug__contains=[{"title": course_slug}]).first()
- if not course:
- raise NotFound("Course not found")
- return CourseAttachment.objects.select_related(
- 'course',
- 'attachment'
- ).filter(course=course)
-
-
-
-
-class GlossaryListAPIView(ListAPIView):
- serializer_class = CourseGlossarySerializer
- filter_backends = [SearchFilter]
- search_fields = ['glossary__title', 'glossary__description']
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description="Get glossary terms for a specific course",
- tags=["Imam-Javad - Course"],
- manual_parameters=[
- openapi.Parameter(
- 'slug', openapi.IN_PATH,
- description="Course slug",
- type=openapi.TYPE_STRING,
- required=True
- ),
- openapi.Parameter(
- 'search', openapi.IN_QUERY,
- description="Search in glossary title or description",
- type=openapi.TYPE_STRING,
- required=False
- )
- ],
- responses={
- 200: openapi.Response(
- description="List of glossary terms",
- schema=CourseGlossarySerializer(many=True)
- )
- }
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset with select_related for glossary relationship
- """
- course_slug = self.kwargs.get('slug')
- course = Course.objects.filter(slug__contains=[{"title": course_slug}]).first()
- if not course:
- raise NotFound("Course not found")
-
- return CourseGlossary.objects.select_related(
- 'course',
- 'glossary'
- ).filter(course=course)
-
-
-
-class CourseOnlineClassTokenAPIView(GenericAPIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
- serializer_class = OnlineClassTokenCreateSerializer
-
- @swagger_auto_schema(
- tags=['Imam-Javad - Course'],
- operation_description="Generate a temporary entry token for an online class.",
- request_body=OnlineClassTokenCreateSerializer,
- responses={
- status.HTTP_201_CREATED: openapi.Response(
- description="Token generated successfully.",
- examples={
- "application/json": {
- "token": "abc123xyz789...",
- "url": "https://imamjavad.online/join-class?token=abc123xyz789...&slug=python-basics",
- "expires_in": 300,
- }
- }
- )
- }
- )
- def post(self, request, pk, *args, **kwargs):
- serializer = self.get_serializer(data=request.data or {})
- serializer.is_valid(raise_exception=True)
-
- course = get_object_or_404(Course, pk=pk)
- if not course.is_online:
- raise AppAPIException({'message': "Course is not marked as online."}, status_code=status.HTTP_400_BAD_REQUEST)
-
- if not self._user_has_access(request.user, course):
- raise AppAPIException({'message': "You do not have access to this course."}, status_code=status.HTTP_403_FORBIDDEN)
-
- manager = OnlineClassTokenManager()
- user_token, _ = Token.objects.get_or_create(user=request.user)
- identifier = f"{request.user.id}:{user_token.key[:8]}"
- token = manager.generate_token(course_id=course.id, user_identifier=identifier)
-
- manager.store_token(token, {
- 'course_id': course.id,
- 'user_id': request.user.id,
- 'user_token': user_token.key,
- 'course_slug': get_course_slug_value(course),
- 'extra': {
- 'professor_in_class': False,
- },
- })
-
- # ساخت URL ثابت با token و course slug
- frontend_base = get_online_class_frontend_base()
- course_slug = get_course_slug_value(course)
- entry_url = f"{frontend_base}/?token={token}&slug={course_slug}"
-
- return Response({
- 'token': token,
- 'url': entry_url,
- 'expires_in': getattr(settings, 'ONLINE_CLASS_TOKEN_TTL', 300),
- }, status=status.HTTP_201_CREATED)
-
- @staticmethod
- def _user_has_access(user, course: Course) -> bool:
- if user.is_staff or course.professors.filter(id=user.id).exists():
- return True
- return Participant.objects.filter(course=course, student=user).exists()
-
-
-class CourseOnlineClassTokenValidateAPIView(GenericAPIView):
- # Changed from AllowAny to enable DRF authentication
- # Users can still access without auth, but if token is provided, it will be authenticated
- authentication_classes = [TokenAuthentication]
- permission_classes = [AllowAny]
- serializer_class = OnlineClassTokenVerifySerializer
-
- @swagger_auto_schema(
- tags=['Imam-Javad - Course'],
- operation_description="Get course and user data for authenticated user.",
- manual_parameters=[
- openapi.Parameter(
- 'slug', openapi.IN_PATH,
- description="Course Slug",
- type=openapi.TYPE_STRING,
- required=True
- )
- ],
- responses={
- status.HTTP_200_OK: openapi.Response(
- description="Course data retrieved.",
- examples={
- "application/json": {
- "course": {"id": 1, "title": "Sample Course"},
- "user": {"id": 10, "fullname": "John Doe"},
- "metadata": {
- "status": "ongoing",
- "has_started": True,
- "professor_in_class": False,
- "validated_at": "2024-01-01T10:00:00Z"
- }
- }
- }
- )
- }
- )
- def get(self, request, slug, *args, **kwargs):
- print("=" * 80)
- print(f"[Online Validate GET] REQUEST RECEIVED {request.data}")
- print(f"[Online Validate GET] slug={slug}")
- print(f"[Online Validate GET] user={request.user}")
- print(f"[Online Validate GET] user.is_authenticated={request.user.is_authenticated}")
- print(f"[Online Validate GET] user.id={request.user.id if request.user.is_authenticated else 'N/A'}")
- print("=" * 80)
-
- logger.info(f"[Online Validate GET] Request received - slug={slug} user_id={request.user.id if request.user.is_authenticated else 'anonymous'}")
-
- detail_view = CourseDetailAPIView()
- queryset = detail_view.get_queryset()
- course = queryset.filter(slug__contains=[{"title": slug}]).first()
- if not course:
- raise NotFound("Course not found")
- user = request.user
-
- print(f"[Online Validate GET] Course found - course_id={course.id} slug={slug} is_online={course.is_online}")
- logger.info(f"[Online Validate GET] Course found - course_id={course.id} slug={slug} is_online={course.is_online}")
-
- # DEPRECATED: Polling approach replaced by webhook integration
- # Room status is now updated automatically via PlugNMeet webhooks
- # self._sync_room_status_with_plugnmeet(course)
-
- course_data = CourseDetailSerializer(course, context={'request': request}).data
- user_data = UserProfileSerializer(user, context={'request': request}).data
- metadata = self._build_metadata(
- course,
- {'user_id': user.id if user.is_authenticated else None, 'extra': {}, 'generated_at': timezone.now().isoformat()},
- user=user,
- )
- redirect_path = self._resolve_redirect_path(request, course, user, metadata)
- metadata['redirect_path'] = redirect_path
-
- print(f"[Online Validate GET] Success - metadata={metadata}")
- logger.info(f"[Online Validate GET] Success - user_id={user.id if user.is_authenticated else 'anonymous'} course={slug} can_create={metadata.get('can_create_live_session')} can_join={metadata.get('can_join_live_session')}")
-
- return Response({
- 'course': course_data,
- 'user': user_data,
- 'metadata': metadata,
- 'redirect_path': redirect_path,
- }, status=status.HTTP_200_OK)
-
- @swagger_auto_schema(
- tags=['Imam-Javad - Course'],
- operation_description="Validate an online class entry token and return course/user data.",
- request_body=OnlineClassTokenVerifySerializer,
- responses={
- status.HTTP_200_OK: openapi.Response(
- description="Token validated.",
- examples={
- "application/json": {
- "course": {"id": 1, "title": "Sample Course"},
- "user": {"id": 10, "fullname": "John Doe"},
- "metadata": {
- "status": "ongoing",
- "has_started": True,
- "professor_in_class": False,
- "validated_at": "2024-01-01T10:00:00Z"
- }
- }
- }
- )
- }
- )
- def post(self, request, *args, **kwargs):
- print("=" * 80)
- print(f"[Online Validate POST] REQUEST RECEIVED")
- print(f"[Online Validate POST] request.data={request.data}")
- print(f"[Online Validate POST] has_token={'token' in request.data}")
- print("=" * 80)
-
- logger.info(f"[Online Validate POST] Request received - has_token={'token' in request.data}")
-
- serializer = self.get_serializer(data=request.data)
- serializer.is_valid(raise_exception=True)
-
- token_value = serializer.validated_data['token']
- print(f"[Online Validate POST] Token extracted - token={token_value[:16]}...")
- logger.info(f"[Online Validate POST] Token extracted - token={token_value[:16]}...")
-
- manager = OnlineClassTokenManager()
-
- try:
- payload = manager.get_payload(token_value)
- print(f"[Online Validate POST] Token decoded successfully - payload={payload}")
- logger.info(f"[Online Validate POST] Token decoded successfully - payload={payload}")
- except Exception as e:
- print(f"[Online Validate POST] Token decode FAILED - error={str(e)} type={type(e).__name__}")
- logger.error(f"[Online Validate POST] Token decode failed - error={str(e)} type={type(e).__name__}")
- raise
-
- course_id = payload.get('course_id')
- user_id = payload.get('user_id')
- if not course_id or not user_id:
- print(f"[Online Validate POST] Invalid token payload - course_id={course_id} user_id={user_id}")
- logger.warning(f"[Online Validate POST] Invalid token payload - course_id={course_id} user_id={user_id}")
- raise AppAPIException({'message': 'Token payload is invalid.'}, status_code=status.HTTP_400_BAD_REQUEST)
-
- print(f"[Online Validate POST] Processing for user_id={user_id} course_id={course_id}")
- logger.info(f"[Online Validate POST] Processing for user_id={user_id} course_id={course_id}")
-
- detail_view = CourseDetailAPIView()
- queryset = detail_view.get_queryset()
- course = get_object_or_404(queryset, pk=course_id)
- user = get_object_or_404(UserModel.objects.all(), pk=user_id)
-
- print(f"[Online Validate POST] Course found - slug={course.slug} is_online={course.is_online}")
- logger.info(f"[Online Validate POST] Course found - slug={course.slug} is_online={course.is_online}")
-
- course_data = CourseDetailSerializer(course, context={'request': request}).data
- user_data = UserProfileSerializer(user, context={'request': request}).data
- metadata = self._build_metadata(course, payload, user=user)
- redirect_path = self._resolve_redirect_path(request, course, user, metadata, token_value=token_value)
- metadata['redirect_path'] = redirect_path
-
- print(f"[Online Validate POST] Success - metadata={metadata}")
- logger.info(f"[Online Validate POST] Success - user_id={user_id} course={course.slug} can_create={metadata.get('can_create_live_session')} can_join={metadata.get('can_join_live_session')}")
-
- return Response({
- 'course': course_data,
- 'user': user_data,
- 'metadata': metadata,
- 'redirect_path': redirect_path,
- }, status=status.HTTP_200_OK)
-
- def _build_metadata(self, course: Course, payload: dict, user=None) -> dict:
- status_value = extract_text_from_json(course.status)
- has_started = status_value in [Course.StatusChoices.ONGOING, Course.StatusChoices.FINISHED]
- timing_data = course.timing if isinstance(course.timing, dict) else {}
-
- user = user or UserModel.objects.filter(pk=payload.get('user_id')).first()
- user_id = getattr(user, 'id', None)
- can_manage = bool(user and user.can_manage_course(course))
-
- live_context = self._build_live_session_context(course)
- can_join_live_session = live_context['is_online'] and self._user_can_join_live_session(user, course)
-
- logger.debug(f"[Online Validate Metadata] user_id={user_id} course={course.slug} can_manage={can_manage} is_online={live_context['is_online']} can_join={can_join_live_session}")
-
- metadata = {
- 'status': status_value,
- 'has_started': has_started,
- 'has_finished': status_value == Course.StatusChoices.FINISHED,
- 'professor_in_class': payload.get('extra', {}).get('professor_in_class', False),
- 'can_create_live_session': can_manage and not live_context['is_online'],
- 'can_join_live_session': can_join_live_session,
- 'scheduled_times': timing_data,
- 'generated_at': payload.get('generated_at'),
- 'validated_at': timezone.now().isoformat(),
- 'redirect_path': None,
- }
-
- metadata.update(live_context)
- return metadata
-
- def _resolve_redirect_path(self, request, course: Course, user, metadata: dict, token_value: str = None) -> Optional[str]:
- if not user or not user.is_authenticated:
- return None
-
- if metadata.get('is_online') and metadata.get('can_join_live_session'):
- redirect_path = self._build_live_redirect_path(request, course, user)
- if redirect_path:
- return redirect_path
-
- if metadata.get('can_create_live_session'):
- redirect_path = self._build_professor_direct_redirect_path(course, user)
- if redirect_path:
- return redirect_path
-
- if self._user_has_course_access(user, course):
- return self._build_waiting_redirect_path(course, user, token_value=token_value)
-
- return None
-
- def _build_waiting_redirect_path(self, course: Course, user, token_value: str = None) -> str:
- course_slug = get_course_slug_value(course)
- token = token_value or self._generate_entry_token(course, user)
- frontend_base = get_online_class_frontend_base()
- return f"{frontend_base}/?token={token}&slug={course_slug}"
-
- def _build_professor_direct_redirect_path(self, course: Course, user) -> Optional[str]:
- try:
- session = self._ensure_professor_live_session(course)
- redirect_path = self._build_live_redirect_path_for_room(
- course=course,
- user=user,
- room_id=session.room_id,
- )
- if redirect_path:
- return redirect_path
- except (ImproperlyConfigured, PlugNMeetError, Exception) as exc:
- logger.warning(
- "[Online Validate] Failed to create professor live session - course=%s user_id=%s error=%s",
- course.slug,
- user.id,
- str(exc),
- )
- return None
- return None
-
- def _ensure_professor_live_session(self, course: Course) -> CourseLiveSession:
- session = (
- CourseLiveSession.objects.filter(course=course, ended_at__isnull=True)
- .order_by('-started_at', '-id')
- .first()
- )
- if session and session.room_id:
- return session
-
- subject = self._get_live_session_subject(course)
- room_id = f"room-{course.id}-{int(time.time())}"
- session = CourseLiveSession.objects.create(
- course=course,
- room_id=room_id,
- subject=subject,
- started_at=timezone.now(),
- )
-
- client = PlugNMeetClient()
- client.create_room({
- 'room_id': room_id,
- 'empty_timeout': 90,
- 'metadata': self._build_live_room_metadata(subject),
- })
- return session
-
- @staticmethod
- def _get_live_session_subject(course: Course) -> str:
- next_session_number = course.live_sessions.count() + 1
- return f"Live Session {next_session_number}"
-
- def _build_live_room_metadata(self, subject: str) -> dict:
- return {
- 'room_title': subject,
- 'webhook_url': self._get_plugnmeet_webhook_url(),
- 'default_lock_settings': {
- 'lock_microphone': True,
- 'lock_webcam': True,
- 'lock_screen_sharing': True,
- 'lock_whiteboard': True,
- 'lock_shared_notepad': False,
- 'lock_chat': False,
- 'lock_chat_send_message': False,
- 'lock_chat_file_share': False,
- 'lock_private_chat': False,
- },
- 'room_features': {
- 'allow_webcams': True,
- 'mute_on_start': True,
- 'allow_screen_sharing': True,
- 'allow_recording': True,
- 'allow_rtmp': False,
- 'allow_view_other_webcams': True,
- 'allow_view_other_participants_list': True,
- 'admin_only_webcams': False,
- 'allow_polls': True,
- 'room_duration': 0,
- 'chat_features': {
- 'allow_chat': True,
- 'allow_file_upload': True,
- },
- 'shared_note_pad_features': {
- 'allowed_shared_note_pad': True,
- },
- 'whiteboard_features': {
- 'allowed_whiteboard': True,
- },
- 'breakout_room_features': {
- 'is_allow': True,
- 'allowed_number_rooms': 6,
- },
- 'waiting_room_features': {
- 'is_active': False,
- },
- 'recording_features': {
- 'is_allow': True,
- 'is_allow_cloud': True,
- 'is_allow_local': False,
- 'enable_auto_cloud_recording': False,
- 'only_record_admin_webcams': False,
- },
- },
- }
-
- @staticmethod
- def _get_plugnmeet_webhook_url() -> str:
- base = getattr(settings, 'SITE_DOMAIN', '').rstrip('/')
- if not base:
- raise ImproperlyConfigured('SITE_DOMAIN must be configured for PlugNMeet webhook delivery.')
- if not base.startswith(('http://', 'https://')):
- base = f"https://{base}"
- return f"{base}/api/courses/plugnmeet/webhook/"
-
- def _build_live_redirect_path(self, request, course: Course, user) -> Optional[str]:
- session = (
- CourseLiveSession.objects.filter(course=course, ended_at__isnull=True)
- .order_by('-started_at', '-id')
- .first()
- )
- if not session or not session.room_id:
- return None
-
- return self._build_live_redirect_path_for_room(
- course=course,
- user=user,
- room_id=session.room_id,
- request=request,
- )
-
- def _build_live_redirect_path_for_room(self, course: Course, user, room_id: str, request=None) -> Optional[str]:
- if not room_id:
- return None
-
- is_admin = bool(user.can_manage_course(course))
- user_info = {
- 'user_id': str(user.id),
- 'name': user.get_full_name() or user.email or user.username or f"user-{user.id}",
- 'is_admin': is_admin,
- }
-
- user_metadata = {}
- profile_pic = self._build_profile_url(request, user) if request is not None else None
- if profile_pic:
- user_metadata['profilePic'] = profile_pic
-
- if not is_admin:
- user_metadata['lock_settings'] = {
- 'lock_microphone': True,
- 'lock_screen_sharing': True,
- 'lock_webcam': True,
- 'lock_whiteboard': True,
- 'lock_shared_notepad': False,
- 'lock_chat': False,
- 'lock_chat_send_message': False,
- 'lock_chat_file_share': False,
- 'lock_private_chat': False,
- }
- else:
- user_metadata['is_hidden'] = False
-
- if user_metadata:
- user_info['user_metadata'] = user_metadata
-
- try:
- client = PlugNMeetClient()
- response = client.get_join_token({
- 'room_id': room_id,
- 'user_info': user_info,
- })
- except (PlugNMeetError, Exception) as exc:
- logger.warning(
- "[Online Validate] Failed to generate direct access token - course=%s user_id=%s error=%s",
- course.slug,
- user.id,
- str(exc),
- )
- return None
-
- access_token = response.get('token')
- if not access_token:
- return None
-
- self._register_fail_safe_live_session_user(
- course=course,
- room_id=room_id,
- user=user,
- is_admin=is_admin,
- )
-
- frontend_base = get_online_class_frontend_base()
- return f"{frontend_base}/?access_token={access_token}"
-
- @staticmethod
- def _register_fail_safe_live_session_user(
- course: Course,
- room_id: str,
- user,
- is_admin: bool,
- ) -> None:
- try:
- session = (
- CourseLiveSession.objects.filter(
- course=course,
- room_id=room_id,
- ended_at__isnull=True,
- )
- .order_by('-started_at', '-id')
- .first()
- )
- if not session:
- logger.warning(
- "[Online Validate] Fail-safe registration skipped - no active session found for course=%s room_id=%s user_id=%s",
- course.slug,
- room_id,
- user.id,
- )
- return
-
- role = 'moderator' if is_admin else 'participant'
- LiveSessionUser.objects.update_or_create(
- session=session,
- user=user,
- defaults={
- 'role': role,
- 'is_online': True,
- 'exited_at': None,
- 'entered_at': timezone.now(),
- },
- )
-
- if is_admin:
- session.last_moderator_left_at = None
- session.auto_close_after_moderator_exit_at = None
- session.save(
- update_fields=[
- 'last_moderator_left_at',
- 'auto_close_after_moderator_exit_at',
- 'updated_at',
- ]
- )
-
- logger.info(
- "[Online Validate] Fail-safe registered user entry - session_id=%s room_id=%s user_id=%s role=%s",
- session.id,
- room_id,
- user.id,
- role,
- )
- except Exception as exc:
- logger.error(
- "[Online Validate] Failed to register fail-safe user entry - course=%s room_id=%s user_id=%s error=%s",
- course.slug,
- room_id,
- user.id,
- str(exc),
- )
-
- def _generate_entry_token(self, course: Course, user) -> str:
- manager = OnlineClassTokenManager()
- user_token, _ = Token.objects.get_or_create(user=user)
- identifier = f"{user.id}:{user_token.key[:8]}"
- token = manager.generate_token(course_id=course.id, user_identifier=identifier)
- manager.store_token(token, {
- 'course_id': course.id,
- 'user_id': user.id,
- 'user_token': user_token.key,
- 'course_slug': get_course_slug_value(course),
- 'extra': {
- 'professor_in_class': False,
- },
- })
- return token
-
- @staticmethod
- def _user_has_course_access(user, course: Course) -> bool:
- if not user or not user.is_authenticated:
- return False
- if user.is_staff or user.can_manage_course(course):
- return True
- return Participant.objects.filter(course=course, student=user).exists()
-
- @staticmethod
- def _build_profile_url(request, user):
- avatar = getattr(user, 'avatar', None)
- if avatar and getattr(avatar, 'url', None):
- return request.build_absolute_uri(avatar.url)
- return None
-
- def _build_live_session_context(self, course: Course) -> dict:
- """
- Build live session context with real-time PlugNMeet verification.
-
- This method:
- 1. Finds the latest session for the course
- 2. Verifies with PlugNMeet if the room is actually active
- 3. Auto-closes sessions if PlugNMeet reports room is inactive
- 4. Returns accurate session state independent of webhook delays
- """
- latest_session = (
- CourseLiveSession.objects.filter(course=course)
- .order_by('-started_at', '-id')
- .first()
- )
-
- if not latest_session:
- logger.debug(f"[Live Session Context] No session found for course={course.slug}")
- return {
- 'is_online': False,
- 'live_session': None,
- 'active_room_id': None,
- 'livesession_started_at': None,
- 'livesession_ended_at': None,
- }
-
- started_at = latest_session.started_at
- ended_at = latest_session.ended_at
- is_online = bool(started_at and not ended_at)
-
- # CRITICAL: Verify room status with PlugNMeet if session appears online
- # This ensures we don't rely solely on webhooks which may fail or be delayed
- if is_online and latest_session.room_id:
- is_online = self._verify_and_sync_room_status(latest_session)
- # Refresh ended_at in case session was closed
- ended_at = latest_session.ended_at
-
- live_session_data = {
- 'id': latest_session.id,
- 'room_id': latest_session.room_id,
- 'subject': latest_session.subject,
- 'started_at': self._format_datetime(started_at),
- 'ended_at': self._format_datetime(ended_at),
- }
-
- context = {
- 'is_online': is_online,
- 'live_session': live_session_data,
- 'active_room_id': live_session_data['room_id'] if is_online and live_session_data['room_id'] else None,
- 'livesession_started_at': live_session_data['started_at'],
- 'livesession_ended_at': live_session_data['ended_at'],
- }
-
- logger.debug(f"[Live Session Context] course={course.slug} is_online={is_online} room_id={live_session_data['room_id']}")
- return context
-
- def _verify_and_sync_room_status(self, session: CourseLiveSession) -> bool:
- """
- Verify room status with PlugNMeet and sync local database.
-
- Args:
- session: The CourseLiveSession to verify
-
- Returns:
- bool: True if room is active, False if inactive or verification failed
-
- Side effects:
- - Closes session in database if PlugNMeet reports room is inactive
- - Updates LiveSessionUser records accordingly
- """
- if not session.room_id:
- logger.warning(f"[Room Sync] Session has no room_id - session_id={session.id}")
- return False
-
- try:
- client = PlugNMeetClient()
- response = client.is_room_active(session.room_id)
-
- # Debug: Log full response to understand structure
- logger.debug(f"[Room Sync] PlugNMeet response - room_id={session.room_id} response={response}")
-
- # PlugNMeet returns: {"status": true, "msg": "...", "isActive": true/false}
- # Note: isActive might be boolean or string, handle both
- is_active_raw = response.get('isActive', False)
- is_active = is_active_raw if isinstance(is_active_raw, bool) else str(is_active_raw).lower() == 'true'
- response_msg = response.get('msg', 'unknown')
- response_status = response.get('status', False)
-
- # Additional check: if status is true and msg says "active", trust that
- if response_status and 'active' in response_msg.lower() and 'not' not in response_msg.lower():
- is_active = True
-
- if is_active:
- logger.debug(f"[Room Sync] ✓ Room verified active - room_id={session.room_id} session_id={session.id} msg={response_msg}")
- return True
- else:
- # Room is not active in PlugNMeet but active in our database
- # This happens when:
- # 1. Webhook failed to fire
- # 2. Room was ended externally
- # 3. Room crashed or timed out
- logger.warning(f"[Room Sync] ✗ Room inactive in PlugNMeet - auto-closing session_id={session.id} room_id={session.room_id} msg={response_msg}")
- self._close_live_session(session)
- return False
-
- except PlugNMeetError as e:
- # PlugNMeet API returned an error
- error_msg = str(e)
- logger.error(f"[Room Sync] PlugNMeet API error - room_id={session.room_id} session_id={session.id} error={error_msg}")
-
- # Check if error message indicates room doesn't exist
- if 'not found' in error_msg.lower() or 'does not exist' in error_msg.lower():
- logger.warning(f"[Room Sync] Room not found in PlugNMeet - closing session_id={session.id}")
- self._close_live_session(session)
- return False
-
- # For other API errors, assume room might still be active (fail-safe)
- logger.warning(f"[Room Sync] Cannot verify room status, assuming inactive for safety - room_id={session.room_id}")
- return False
-
- except Exception as e:
- # Network error or unexpected exception
- logger.error(f"[Room Sync] Unexpected error verifying room - room_id={session.room_id} session_id={session.id} error={type(e).__name__}: {str(e)}")
- # For network errors, fail-safe: assume room might still be active
- # but log a warning for monitoring
- logger.warning(f"[Room Sync] Network/system error, assuming room inactive for safety")
- return False
-
- @staticmethod
- def _user_can_join_live_session(user, course: Course) -> bool:
- if not user or not user.is_authenticated:
- return False
-
- if user.is_staff or user.is_superuser or user.can_manage_course(course):
- return True
-
- return Participant.objects.filter(
- course=course,
- student_id=user.id,
- is_active=True
- ).exists()
-
- @staticmethod
- def _format_datetime(value):
- if not value:
- return None
- if isinstance(value, str):
- return value
- if timezone.is_naive(value):
- value = timezone.make_aware(value, timezone.get_current_timezone())
- return timezone.localtime(value).isoformat()
-
- # DEPRECATED: This polling approach is inefficient and has been replaced by webhook integration
- # def _sync_room_status_with_plugnmeet(self, course: Course):
- # """
- # Check if active live session's room is still active in PlugNMeet.
- # If room is inactive, close the session and all related user entries.
- #
- # DEPRECATED: This should be replaced by webhook integration.
- # PlugNMeet now sends webhooks when rooms end, eliminating the need for polling.
- # """
- # active_session = CourseLiveSession.objects.filter(
- # course=course,
- # ended_at__isnull=True
- # ).first()
- #
- # if not active_session or not active_session.room_id:
- # return
- #
- # try:
- # client = PlugNMeetClient()
- # response = client.is_room_active(active_session.room_id)
- # is_active = response.get('isActive', False)
- #
- # if not is_active:
- # logger.info(f"[Room Sync] Room inactive in PlugNMeet - room_id={active_session.room_id} session_id={active_session.id}")
- # self._close_live_session(active_session)
- # else:
- # logger.debug(f"[Room Sync] Room still active - room_id={active_session.room_id} session_id={active_session.id}")
- #
- # except (PlugNMeetError, Exception) as e:
- # logger.warning(f"[Room Sync] Failed to check room status - room_id={active_session.room_id} error={str(e)}")
-
- def _close_live_session(self, session: CourseLiveSession):
- """
- Close a live session and all related user entries.
- Sets ended_at for session and exited_at/is_online for users.
- """
- stop_session_web_egress_if_active(session)
- now = timezone.now()
-
- session.ended_at = now
- session.save(update_fields=['ended_at', 'updated_at'])
- logger.info(f"[Room Sync] Session closed - session_id={session.id} room_id={session.room_id} ended_at={now}")
-
- updated_count = LiveSessionUser.objects.filter(
- session=session,
- is_online=True,
- exited_at__isnull=True
- ).update(
- is_online=False,
- exited_at=now,
- updated_at=now
- )
-
- if updated_count > 0:
- logger.info(f"[Room Sync] User sessions closed - session_id={session.id} count={updated_count}")
diff --git a/apps/course/views/lesson.py b/apps/course/views/lesson.py
deleted file mode 100644
index a5ab621..0000000
--- a/apps/course/views/lesson.py
+++ /dev/null
@@ -1,379 +0,0 @@
-from rest_framework.generics import ListAPIView, RetrieveAPIView, GenericAPIView
-from rest_framework.permissions import IsAuthenticated, AllowAny
-from rest_framework.authentication import TokenAuthentication
-
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-from django.shortcuts import get_object_or_404
-from rest_framework import status
-from rest_framework.response import Response
-from apps.course.models import CourseChapter
-from apps.course.serializers import (
- CourseLessonSerializer,
- CourseChapterSerializer
-)
-from apps.course.models import Course, CourseLesson, LessonCompletion
-from apps.course.access import user_has_course_access
-from apps.course.doc import *
-from utils.exceptions import AppAPIException
-from utils.pagination import StandardResultsSetPagination
-from rest_framework.permissions import IsAuthenticated
-
-
-
-class LessonListView(ListAPIView):
- serializer_class = CourseLessonSerializer
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description=doc_courses_lesson(),
- tags=['Imam-Javad - Course'],
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- """
- Optimized queryset with select_related and prefetch_related for lesson relationships
- """
- course_slug = self.kwargs.get('slug')
- course = get_object_or_404(Course, slug__contains=[{"title": course_slug}])
-
- return CourseLesson.objects.select_related(
- 'chapter', # 👇 Route through chapter
- 'lesson'
- ).prefetch_related(
- 'completions',
- 'quizzes'
- ).filter(
- chapter__course=course, # 👇 Query via chapter
- is_active=True,
- chapter__is_active=True
- ).order_by('chapter__priority', 'priority') # 👇 Sort by chapter first
-
-
-
-
-class LessonDetailView(RetrieveAPIView):
- serializer_class = CourseLessonSerializer
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description="Get detailed lesson information with navigation data",
- tags=["Imam-Javad - Course"],
- manual_parameters=[
- openapi.Parameter(
- 'id', openapi.IN_PATH,
- description="Lesson ID",
- type=openapi.TYPE_INTEGER,
- required=True
- )
- ],
- responses={
- 200: openapi.Response(
- description="Lesson details with navigation information",
- schema=CourseLessonSerializer()
- )
- }
- )
- def get(self, request, *args, **kwargs):
- lesson_id = self.kwargs.get('id')
- course_lesson = get_object_or_404(
- CourseLesson.objects.select_related('chapter__course', 'lesson'),
- id=lesson_id,
- is_active=True,
- chapter__is_active=True
- )
-
- course = course_lesson.chapter.course
-
- # Get all lessons in order
- lessons = CourseLesson.objects.select_related(
- 'lesson', 'chapter'
- ).filter(
- chapter__course=course,
- is_active=True,
- chapter__is_active=True
- ).order_by('chapter__priority', 'priority')
-
- total_lessons = lessons.count()
- # Convert to list to find index
- lesson_ids = list(lessons.values_list('id', flat=True))
- try:
- current_index = lesson_ids.index(course_lesson.id)
- current_lesson_number = current_index + 1
-
- next_lesson_id = lesson_ids[current_index + 1] if current_index + 1 < len(lesson_ids) else None
- previous_lesson_id = lesson_ids[current_index - 1] if current_index > 0 else None
-
- except ValueError:
- current_lesson_number = 1
- next_lesson_id = None
- previous_lesson_id = None
-
- lesson_data = self.get_serializer(course_lesson).data
- lesson_data['total_lessons'] = total_lessons
- lesson_data['current_lesson_number'] = current_lesson_number
- lesson_data['next_lesson_id'] = next_lesson_id
- lesson_data['previous_lesson_id'] = previous_lesson_id
- lesson_data['can_go_next'] = next_lesson_id is not None
-
- return Response(lesson_data)
-
-
-
-class LessonCompletionToggleAPIView(GenericAPIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description="Toggle lesson completion status (for single ID) or mark multiple lessons as completed (for list of IDs)",
- tags=["Imam-Javad - Course"],
- request_body=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- required=['lesson_id'],
- properties={
- 'lesson_id': openapi.Schema(
- type=openapi.TYPE_INTEGER,
- description='ID of the lesson to toggle (integer), or list of IDs to mark completed (array of integers)'
- ),
- },
- ),
- responses={
- 201: 'Lesson marked as COMPLETED.',
- 200: 'Lesson marked as INCOMPLETE (Unchecked) or Bulk operation completed.',
- 400: 'Lesson ID is required or invalid.',
- 404: 'Lesson not found.',
- }
- )
- def post(self, request):
- student = request.user
- lesson_id_data = request.data.get('lesson_id')
-
- if not lesson_id_data:
- return Response({'error': 'Lesson ID is required.'}, status=status.HTTP_400_BAD_REQUEST)
-
- # List Case:
- if isinstance(lesson_id_data, list):
- try:
- lesson_ids = [int(lid) for lid in lesson_id_data]
- except (ValueError, TypeError):
- return Response({'error': 'Invalid lesson ID in list.'}, status=status.HTTP_400_BAD_REQUEST)
-
- course_lessons = CourseLesson.objects.filter(id__in=lesson_ids)
- found_ids = set(course_lessons.values_list('id', flat=True))
-
- if any(not user_has_course_access(student, course_lesson.course) for course_lesson in course_lessons):
- return Response({'error': 'You do not have access to one or more lessons.'}, status=status.HTTP_403_FORBIDDEN)
-
- existing_completions = LessonCompletion.objects.filter(
- student=student,
- course_lesson_id__in=found_ids
- ).values_list('course_lesson_id', flat=True)
- existing_completed_set = set(existing_completions)
-
- completions_to_create = []
- for cl in course_lessons:
- if cl.id not in existing_completed_set:
- completions_to_create.append(
- LessonCompletion(student=student, course_lesson=cl)
- )
-
- if completions_to_create:
- LessonCompletion.objects.bulk_create(completions_to_create)
-
- return Response(
- {
- 'message': f'Completed {len(completions_to_create)} new lessons.',
- 'completed_ids': list(found_ids)
- },
- status=status.HTTP_200_OK
- )
-
- # Single Integer Case:
- else:
- try:
- lesson_id = int(lesson_id_data)
- except (ValueError, TypeError):
- return Response({'error': 'Invalid lesson ID.'}, status=status.HTTP_400_BAD_REQUEST)
-
- try:
- course_lesson = CourseLesson.objects.get(id=lesson_id)
- except CourseLesson.DoesNotExist:
- return Response({'error': 'Lesson not found.'}, status=status.HTTP_404_NOT_FOUND)
-
- if not user_has_course_access(student, course_lesson.course):
- return Response({'error': 'You do not have access to this lesson.'}, status=status.HTTP_403_FORBIDDEN)
-
- # TOGGLE LOGIC
- completion = LessonCompletion.objects.filter(student=student, course_lesson=course_lesson).first()
-
- if completion:
- completion.delete()
- return Response(
- {'message': 'Lesson marked as incomplete.', 'is_completed': False},
- status=status.HTTP_200_OK
- )
- else:
- LessonCompletion.objects.create(student=student, course_lesson=course_lesson)
- return Response(
- {'message': 'Lesson completed successfully.', 'is_completed': True},
- status=status.HTTP_201_CREATED
- )
-
-from django.db.models import Prefetch
-class LessonListV2APIView(ListAPIView):
- """
- V2 API: Returns lessons grouped by Chapters
- """
- serializer_class = CourseChapterSerializer
- pagination_class = StandardResultsSetPagination
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description=doc_courses_lesson_v2(),
- tags=['Imam-Javad - Course (V2)'],
- manual_parameters=[
- openapi.Parameter(
- 'slug', openapi.IN_PATH,
- description="Course slug",
- type=openapi.TYPE_STRING,
- required=True
- ),
- openapi.Parameter(
- 'page', openapi.IN_QUERY,
- description="Page number for chapter pagination",
- type=openapi.TYPE_INTEGER,
- required=False
- ),
- ],
- responses={
- 200: openapi.Response(
- description="Paginated list of active chapters with nested active lessons",
- schema=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'count': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'next': openapi.Schema(type=openapi.TYPE_STRING, format='uri', nullable=True),
- 'previous': openapi.Schema(type=openapi.TYPE_STRING, format='uri', nullable=True),
- 'results': openapi.Schema(
- type=openapi.TYPE_ARRAY,
- items=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'id': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'title': openapi.Schema(type=openapi.TYPE_STRING),
- 'priority': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'is_active': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'lessons': openapi.Schema(
- type=openapi.TYPE_ARRAY,
- items=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'id': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'title': openapi.Schema(type=openapi.TYPE_STRING),
- 'priority': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'is_active': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'permission': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'duration': openapi.Schema(type=openapi.TYPE_INTEGER, nullable=True),
- 'content_type': openapi.Schema(type=openapi.TYPE_STRING, nullable=True),
- 'content_file': openapi.Schema(type=openapi.TYPE_STRING, nullable=True),
- 'video_link': openapi.Schema(type=openapi.TYPE_STRING, nullable=True),
- 'is_complated': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'quizs': openapi.Schema(
- type=openapi.TYPE_ARRAY,
- nullable=True,
- items=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'id': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'title': openapi.Schema(type=openapi.TYPE_STRING),
- 'description': openapi.Schema(type=openapi.TYPE_STRING, nullable=True),
- 'permission': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'each_question_timing': openapi.Schema(type=openapi.TYPE_INTEGER, nullable=True),
- 'is_complated': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- }
- )
- ),
- }
- )
- ),
- }
- )
- ),
- 'independent_quizzes': openapi.Schema(
- type=openapi.TYPE_ARRAY,
- nullable=True,
- items=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'id': openapi.Schema(type=openapi.TYPE_INTEGER),
- 'title': openapi.Schema(type=openapi.TYPE_STRING),
- 'description': openapi.Schema(type=openapi.TYPE_STRING, nullable=True),
- 'permission': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- 'each_question_timing': openapi.Schema(type=openapi.TYPE_INTEGER, nullable=True),
- 'is_complated': openapi.Schema(type=openapi.TYPE_BOOLEAN),
- }
- )
- ),
- }
- )
- ),
- 404: openapi.Response(description="Course not found"),
- }
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- course_slug = self.kwargs.get('slug')
- course = get_object_or_404(Course, slug__contains=[{"title": course_slug}])
-
- # We query the Chapters, and prefetch the lessons to avoid N+1 query problems
- return CourseChapter.objects.prefetch_related(
- Prefetch(
- 'lessons',
- queryset=CourseLesson.objects.select_related('lesson').filter(is_active=True).order_by('priority')
- )
- ).filter(
- course=course,
- is_active=True
- ).order_by('priority', 'id')
-
- def list(self, request, *args, **kwargs):
- queryset = self.filter_queryset(self.get_queryset())
- page = self.paginate_queryset(queryset)
-
- serializer = self.get_serializer(page if page is not None else queryset, many=True)
-
- # Get independent quizzes belonging to this course with lesson_number = 0
- course_slug = self.kwargs.get('slug')
- course = get_object_or_404(Course, slug__contains=[{"title": course_slug}])
-
- from apps.quiz.models import Quiz
- from apps.quiz.serializers import QuizListSerializer
-
- independent_quizzes_qs = Quiz.objects.filter(
- course=course,
- lesson_number=0,
- status=True
- )
- independent_quizzes_data = QuizListSerializer(
- independent_quizzes_qs,
- many=True,
- context=self.get_serializer_context()
- ).data
-
- if page is not None:
- response = self.get_paginated_response(serializer.data)
- response.data['independent_quizzes'] = independent_quizzes_data
- return response
-
- return Response({
- "independent_quizzes": independent_quizzes_data,
- "results": serializer.data
- })
diff --git a/apps/course/views/live_session.py b/apps/course/views/live_session.py
deleted file mode 100644
index 0b3ae02..0000000
--- a/apps/course/views/live_session.py
+++ /dev/null
@@ -1,1299 +0,0 @@
-import logging
-from datetime import timedelta
-
-from django.core.exceptions import ImproperlyConfigured
-from django.shortcuts import get_object_or_404
-from django.utils import timezone
-
-from rest_framework import status
-from rest_framework.generics import GenericAPIView
-from rest_framework.permissions import IsAuthenticated, AllowAny
-from rest_framework.authentication import TokenAuthentication
-from rest_framework.response import Response
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-import time
-import jwt
-from apps.course.models import Course, CourseLiveSession, Participant, LiveSessionRecording, LiveSessionUser
-from apps.course.models.lesson import Lesson, CourseLesson
-from apps.course.serializers import LiveSessionRoomCreateSerializer, LiveSessionTokenSerializer, LiveSessionRecordedFileSerializer, LiveSessionRecordingSerializer, LiveSessionRecordingControlSerializer
-from apps.course.services.plugnmeet import PlugNMeetClient, PlugNMeetError
-from apps.course.services.web_egress import WebEgressClient, WebEgressError, stop_session_web_egress_if_active
-from utils.exceptions import AppAPIException
-from django.conf import settings
-logger = logging.getLogger(__name__)
-
-
-def get_live_session_subject(course):
- next_session_number = course.live_sessions.count() + 1
- return f"Live Session {next_session_number}"
-
-
-def get_plugnmeet_webhook_url() -> str:
- base = getattr(settings, 'SITE_DOMAIN', '').rstrip('/')
- if not base:
- raise ImproperlyConfigured('SITE_DOMAIN must be configured for PlugNMeet webhook delivery.')
- return f"{base}/api/courses/plugnmeet/webhook/"
-
-
-def get_online_class_frontend_base() -> str:
- base = getattr(
- settings,
- "ONLINE_CLASS_FRONTEND_DOMAIN",
- getattr(settings, "SITE_DOMAIN", ""),
- ).rstrip("/")
- if base and not base.startswith(("http://", "https://")):
- base = f"https://{base}"
- return base
-
-
-def get_web_egress_callback_url() -> str:
- base = getattr(settings, "SITE_DOMAIN", "").rstrip("/")
- if not base:
- raise ImproperlyConfigured(
- "SITE_DOMAIN must be configured for WebEgress callback delivery."
- )
- return f"{base}/api/courses/online/room/recording/web-egress/callback/"
-
-
-def decode_plugnmeet_access_token(raw_token: str) -> dict:
- try:
- return jwt.decode(
- raw_token,
- settings.PLUGNMEET_API_SECRET,
- algorithms=["HS256"],
- )
- except jwt.PyJWTError as exc:
- raise AppAPIException(
- {"message": "Invalid or expired meeting access token."},
- status_code=status.HTTP_401_UNAUTHORIZED,
- ) from exc
-
-
-def extract_meeting_token_from_request(request) -> str:
- auth_header = request.headers.get("Authorization", "").strip()
- if auth_header.lower().startswith("bearer "):
- return auth_header[7:].strip()
- if auth_header.lower().startswith("token "):
- return auth_header[6:].strip()
- if auth_header:
- return auth_header
- token = request.data.get("access_token") or request.query_params.get("access_token")
- if token:
- return token
- raise AppAPIException(
- {"message": "Meeting access token is required."},
- status_code=status.HTTP_401_UNAUTHORIZED,
- )
-
-
-def get_session_from_meeting_token(request, *, require_admin: bool = False):
- meeting_token = extract_meeting_token_from_request(request)
- claims = decode_plugnmeet_access_token(meeting_token)
-
- room_id = claims.get("room_id")
- if not room_id:
- raise AppAPIException(
- {"message": "Meeting token is missing room information."},
- status_code=status.HTTP_400_BAD_REQUEST,
- )
-
- session = get_object_or_404(CourseLiveSession, room_id=room_id)
- if require_admin and not claims.get("is_admin"):
- raise AppAPIException(
- {"message": "Only moderators can control recording."},
- status_code=status.HTTP_403_FORBIDDEN,
- )
-
- return session, claims
-
-
-def is_web_egress_recording_status(status_value: str) -> bool:
- return status_value in {
- CourseLiveSession.WEB_EGRESS_STATUS_STARTING,
- CourseLiveSession.WEB_EGRESS_STATUS_RECORDING,
- }
-
-
-def build_web_egress_title(session: CourseLiveSession) -> str:
- return session.recording_title or f"{session.subject} - Recording"
-
-
-def sync_session_recording_titles(session: CourseLiveSession) -> None:
- base_title = session.recording_title or session.subject
- recordings = list(
- LiveSessionRecording.objects.filter(session=session).order_by(
- "created_at",
- "id",
- )
- )
- total = len(recordings)
- if not total:
- return
-
- for index, recording in enumerate(recordings, start=1):
- title = base_title if total == 1 else f"{base_title} part {index}"
-
- if recording.title != title:
- recording.title = title
- recording.save(update_fields=["title", "updated_at"])
-
- if not recording.file:
- continue
-
- lesson = Lesson.objects.filter(content_file=recording.file.name).first()
- if lesson and lesson.title != title:
- lesson.title = title
- lesson.save(update_fields=["title", "updated_at"])
- CourseLesson.objects.filter(lesson=lesson).update(
- title=title,
- updated_at=timezone.now(),
- )
-
-
-class CourseLiveSessionRoomCreateAPIView(GenericAPIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
- serializer_class = LiveSessionRoomCreateSerializer
-
- @swagger_auto_schema(
- operation_description="Create a live session room for a course",
- tags=["Imam-Javad - Course"],
- manual_parameters=[
- openapi.Parameter(
- 'slug', openapi.IN_PATH,
- description="Course slug",
- type=openapi.TYPE_STRING,
- required=True
- )
- ],
- responses={
- 201: openapi.Response(
- description="Live session room created successfully"
- )
- }
- )
-
- def post(self, request, slug, *args, **kwargs):
- # 1. Standard Permissions Logic
- course = get_object_or_404(Course, slug__contains=[{"title": slug}])
- if not request.user.can_manage_course(course):
- raise AppAPIException({'message': 'Permission denied'}, status_code=403)
-
- # 2. Setup ID and Metadata
- subject = get_live_session_subject(course)
-
- # 3. Database Logic - Check FIRST before calling PlugNMeet
- session = CourseLiveSession.objects.filter(
- course=course, ended_at__isnull=True
- ).first()
-
- needs_room_creation = False
-
- if session:
- room_id = session.room_id
- logger.info(f"[LiveSession Create] Found active session - session_id={session.id} room_id={room_id}")
- else:
- # No active session, always create a new one with a dynamic room_id
- timestamp = int(time.time())
- room_id = f"room-{course.id}-{timestamp}"
-
- session = CourseLiveSession.objects.create(
- course=course,
- room_id=room_id,
- subject=subject,
- started_at=timezone.now()
- )
- needs_room_creation = True
- logger.info(f"[LiveSession Create] Created new session - session_id={session.id} room_id={room_id}")
-
- # 4. Create room in PlugNMeet ONLY if needed
- if needs_room_creation:
- metadata = self._build_metadata(subject)
- try:
- client = PlugNMeetClient()
- plugnmeet_response = client.create_room({
- 'room_id': room_id,
- 'empty_timeout': 90,
- 'metadata': metadata,
- })
- logger.info(f"[LiveSession Create] Room created in PlugNMeet - room_id={room_id}")
- except Exception as exc:
- logger.error(f"[LiveSession Create] PlugNMeet Error: {exc}")
- # If room creation fails, revert the session changes
- if session.ended_at is None:
- session.ended_at = timezone.now()
- session.save(update_fields=['ended_at', 'updated_at'])
- raise AppAPIException({'message': f'Failed to create room: {str(exc)}'}, status_code=500)
- else:
- logger.info(f"[LiveSession Create] Skipping room creation - room already exists - room_id={room_id}")
-
- # 5. Generate the JOIN TOKEN (The Entry Ticket)
- token_payload = {
- "room_id": room_id,
- "user_info": {
- "name": f"{request.user.first_name} {request.user.last_name}",
- "user_id": str(request.user.id),
- "is_admin": True,
- "is_hidden": False
- }
- }
-
- pnm_token = jwt.encode(
- {
- "iss": settings.PLUGNMEET_API_KEY,
- "exp": int(time.time()) + 3600,
- "sub": str(request.user.id),
- **token_payload
- },
- settings.PLUGNMEET_API_SECRET,
- algorithm="HS256"
- )
-
- logger.info(f"[LiveSession Create] Success - session_id={session.id} room_id={room_id} user_id={request.user.id}")
-
- return Response({
- 'success': True,
- 'session': {'id': session.id, 'room_id': session.room_id},
- 'access_token': pnm_token
- }, status=201)
-
-
- # def post(self, request, slug, *args, **kwargs):
- # logger.info(f"[LiveSession Create] Request from user_id={request.user.id} for course={slug}")
-
- # data = dict(request.data or {})
- # if 'metadata' in data:
- # logger.warning("[LiveSession Create] 'metadata' provided by client will be ignored for security reasons.")
- # data.pop('metadata', None)
-
- # serializer = self.get_serializer(data=data)
- # serializer.is_valid(raise_exception=True)
-
- # course = get_object_or_404(Course, slug=slug)
-
- # if not request.user.can_manage_course(course):
- # logger.warning(f"[LiveSession Create] Permission denied - user_id={request.user.id} course={slug}")
- # raise AppAPIException({'message': 'You do not have permission to create a live session for this course.'}, status_code=status.HTTP_403_FORBIDDEN)
-
- # logger.info(f"[LiveSession Create] Permission granted for user_id={request.user.id} course={slug}")
-
- # subject = serializer.validated_data.get('subject') or f"{course.title} Live Session"
- # room_id = self._build_room_id(course)
- # metadata = self._build_metadata(subject)
-
- # payload = {
- # 'room_id': room_id,
- # 'metadata': metadata,
- # }
-
- # logger.info(f"[LiveSession Create] Calling PlugNMeet API - room_id={room_id} course={slug}")
-
- # try:
- # client = PlugNMeetClient()
- # plugnmeet_response = client.create_room(payload)
- # logger.info(f"[LiveSession Create] PlugNMeet room created successfully - room_id={room_id}")
- # except ImproperlyConfigured as exc:
- # logger.error(f"[LiveSession Create] Configuration error - {str(exc)}")
- # raise AppAPIException({'message': str(exc)}, status_code=status.HTTP_500_INTERNAL_SERVER_ERROR)
- # except PlugNMeetError as exc:
- # logger.error(f"[LiveSession Create] PlugNMeet API error - room_id={room_id} error={str(exc)}")
- # detail = exc.response_data or {'message': str(exc)}
- # status_code = exc.status_code or status.HTTP_502_BAD_GATEWAY
- # raise AppAPIException(detail, status_code=status_code)
-
- # session, created = CourseLiveSession.objects.get_or_create(
- # course=course,
- # room_id=room_id,
- # defaults={
- # 'subject': subject,
- # 'started_at': timezone.now(),
- # },
- # )
-
- # if created:
- # logger.info(f"[LiveSession Create] New session created - session_id={session.id} room_id={room_id} course={slug}")
- # else:
- # logger.info(f"[LiveSession Create] Existing session reactivated - session_id={session.id} room_id={room_id} course={slug}")
- # updates = {}
- # if session.subject != subject:
- # session.subject = subject
- # updates['subject'] = subject
- # if session.room_id != room_id:
- # session.room_id = room_id
- # updates['room_id'] = room_id
- # if session.started_at is None:
- # session.started_at = timezone.now()
- # updates['started_at'] = session.started_at
- # if updates:
- # session.save(update_fields=list(updates.keys()))
- # logger.info(f"[LiveSession Create] Session updated - session_id={session.id} fields={list(updates.keys())}")
-
- # logger.info(f"[LiveSession Create] Success - session_id={session.id} room_id={room_id} course={slug} user_id={request.user.id}")
-
- # return Response({
- # 'session': {
- # 'id': session.id,
- # 'room_id': session.room_id,
- # 'subject': session.subject,
- # 'started_at': session.started_at,
- # },
- # 'plugnmeet': plugnmeet_response,
- # }, status=status.HTTP_201_CREATED if created else status.HTTP_200_OK)
-
- @staticmethod
- def _build_room_id(course: Course) -> str:
- return f"room-{course.id}-imamjavad"
-
- def _build_metadata(self, subject: str) -> dict:
- # Build secured, centralized metadata. Client overrides are NOT allowed.
- return {
- 'room_title': subject,
- 'webhook_url': get_plugnmeet_webhook_url(),
- 'default_lock_settings': {
- 'lock_microphone': True,
- 'lock_webcam': True,
- 'lock_screen_sharing': True,
- 'lock_whiteboard': True,
- 'lock_shared_notepad': False,
- 'lock_chat': False,
- 'lock_chat_send_message': False,
- 'lock_chat_file_share': False,
- 'lock_private_chat': False,
- },
- 'room_features': {
- 'allow_webcams': True,
- 'mute_on_start': True,
- 'allow_screen_sharing': True,
- 'allow_recording': True,
- 'allow_rtmp': False,
- 'allow_view_other_webcams': True,
- 'allow_view_other_participants_list': True,
- 'admin_only_webcams': False,
- 'allow_polls': True,
- 'room_duration': 0,
- 'chat_features': {
- 'allow_chat': True,
- 'allow_file_upload': True,
- },
- 'shared_note_pad_features': {
- 'allowed_shared_note_pad': True,
- },
- 'whiteboard_features': {
- 'allowed_whiteboard': True,
- },
- 'breakout_room_features': {
- 'is_allow': True,
- 'allowed_number_rooms': 6,
- },
- 'waiting_room_features': {
- 'is_active': False,
- },
- 'recording_features': {
- 'is_allow': True,
- 'is_allow_cloud': True,
- 'is_allow_local': False,
- 'enable_auto_cloud_recording': False,
- 'only_record_admin_webcams': False,
- },
- },
- }
-
- def _deep_update(self, base: dict, overrides: dict) -> dict:
- for key, value in overrides.items():
- if isinstance(value, dict) and isinstance(base.get(key), dict):
- base[key] = self._deep_update(base.get(key, {}), value)
- else:
- base[key] = value
- return base
-
-
-class CourseLiveSessionTokenAPIView(GenericAPIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
- serializer_class = LiveSessionTokenSerializer
-
- @swagger_auto_schema(
- operation_description="Generate access token for live session",
- tags=["Imam-Javad - Course"],
- responses={
- 200: openapi.Response(
- description="Live session token generated successfully"
- )
- }
- )
- def post(self, request, *args, **kwargs):
- serializer = self.get_serializer(data=request.data)
- serializer.is_valid(raise_exception=True)
-
- course_slug = serializer.validated_data['course_slug']
- user = request.user
-
- logger.info(f"[LiveSession Token] Request from user_id={user.id} for course={course_slug}")
-
- try:
- course = Course.objects.filter(slug__contains=[{"title": course_slug}]).first()
- if not course:
- raise Course.DoesNotExist
- except Course.DoesNotExist:
- logger.warning(f"[LiveSession Token] Course not found - course={course_slug} user_id={user.id}")
- raise AppAPIException({'message': 'Course not found.'}, status_code=status.HTTP_404_NOT_FOUND)
-
- if not course.is_online:
- logger.warning(f"[LiveSession Token] Course not configured for online - course={course_slug} user_id={user.id}")
- raise AppAPIException({'message': 'Course is not configured for online sessions.'}, status_code=status.HTTP_400_BAD_REQUEST)
-
- try:
- session = CourseLiveSession.objects.select_related('course').get(
- course=course,
- ended_at__isnull=True
- )
- logger.info(f"[LiveSession Token] Active session found in DB - session_id={session.id} room_id={session.room_id} course={course_slug}")
- except CourseLiveSession.DoesNotExist:
- logger.warning(f"[LiveSession Token] No active session found - course={course_slug} user_id={user.id}")
- raise AppAPIException({'message': 'No active live session found for this course.'}, status_code=status.HTTP_404_NOT_FOUND)
-
- # Check user role first to determine permissions
- is_admin = user.can_manage_course(course)
- user_role = "professor" if is_admin else "student"
- logger.info(f"[LiveSession Token] User role determined - user_id={user.id} role={user_role} course={course_slug}")
-
- # CRITICAL: Verify the room is actually active in PlugNMeet before issuing token
- # This prevents issuing tokens for rooms that have crashed or ended without webhook notification
- room_id = session.room_id
- room_is_active = self._verify_room_is_active(session)
-
- if not room_is_active:
- # Room is not active in PlugNMeet but we have a session record
- if is_admin:
- # For professors: Auto-recreate the room in PlugNMeet
- logger.info(f"[LiveSession Token] Room inactive but professor requesting - recreating room - room_id={room_id} session_id={session.id}")
- try:
- self._recreate_room_in_plugnmeet(course, session)
- logger.info(f"[LiveSession Token] Room recreated successfully - room_id={room_id}")
- except Exception as e:
- logger.error(f"[LiveSession Token] Failed to recreate room - room_id={room_id} error={str(e)}")
- raise AppAPIException({
- 'status': 'False',
- 'message': f'Failed to recreate room: {str(e)}',
- 'msg': f'Failed to recreate room: {str(e)}'
- }, status_code=status.HTTP_500_INTERNAL_SERVER_ERROR)
- else:
- # For students: Refuse token - they cannot create rooms
- logger.error(f"[LiveSession Token] Room not active and user is student - refusing token - room_id={room_id} user_id={user.id}")
- raise AppAPIException({
- 'status': 'False',
- 'message': 'room is not active. Please wait for the professor to start the class.',
- 'msg': 'room is not active. Please wait for the professor to start the class.'
- }, status_code=status.HTTP_400_BAD_REQUEST)
-
- if not is_admin and not Participant.objects.filter(course=course, student_id=user.id, is_active=True).exists():
- logger.warning(f"[LiveSession Token] Access denied - user_id={user.id} not enrolled in course={course_slug}")
- raise AppAPIException({'message': 'You do not have access to this live session.'}, status_code=status.HTTP_403_FORBIDDEN)
-
- user_info = {
- 'user_id': str(user.id),
- 'name': user.get_full_name() or user.email or user.username or f"user-{user.id}",
- 'is_admin': is_admin,
- }
-
- user_metadata = {}
- profile_pic = self._build_profile_url(request, user)
- logger.info(f"[LiveSession Token] Profile pic URL - user_id={user.id} url={profile_pic}")
- if profile_pic:
- user_metadata['profilePic'] = profile_pic
-
- if not is_admin:
- user_metadata['lock_settings'] = {
- 'lock_microphone': True,
- 'lock_screen_sharing': True,
- 'lock_webcam': True,
- 'lock_whiteboard': True,
- 'lock_shared_notepad': False,
- 'lock_chat': False,
- 'lock_chat_send_message': False,
- 'lock_chat_file_share': False,
- 'lock_private_chat': False,
- }
- else:
- user_metadata['is_hidden'] = False
-
- if user_metadata:
- user_info['user_metadata'] = user_metadata
-
- payload = {
- 'room_id': room_id,
- 'user_info': user_info,
- }
-
- logger.info(f"[LiveSession Token] Requesting token from PlugNMeet - room_id={room_id} user_id={user.id} role={user_role}")
-
- try:
- client = PlugNMeetClient()
- plugnmeet_response = client.get_join_token(payload)
- logger.info(f"[LiveSession Token] Token generated successfully - room_id={room_id} user_id={user.id}")
-
- # Fail-safe participant registration in database
- try:
- role = 'moderator' if is_admin else 'participant'
- LiveSessionUser.objects.update_or_create(
- session=session,
- user=user,
- defaults={
- 'role': role,
- 'is_online': True,
- 'exited_at': None,
- 'entered_at': timezone.now()
- }
- )
- logger.info(f"[LiveSession Token] Fail-safe registered user entry - session_id={session.id} user_id={user.id}")
- except Exception as e:
- logger.error(f"[LiveSession Token] Failed to register fail-safe user entry: {e}")
- except ImproperlyConfigured as exc:
- logger.error(f"[LiveSession Token] Configuration error - {str(exc)}")
- raise AppAPIException({'message': str(exc)}, status_code=status.HTTP_500_INTERNAL_SERVER_ERROR)
- except PlugNMeetError as exc:
- logger.error(f"[LiveSession Token] PlugNMeet API error - room_id={room_id} user_id={user.id} error={str(exc)}")
- detail = exc.response_data or {'message': str(exc)}
- status_code = exc.status_code or status.HTTP_502_BAD_GATEWAY
- raise AppAPIException(detail, status_code=status_code)
-
- logger.info(f"[LiveSession Token] Success - room_id={room_id} user_id={user.id} role={user_role} course={course_slug}")
-
- return Response({
- 'room_id': room_id,
- 'token': plugnmeet_response.get('token'),
- 'plugnmeet': plugnmeet_response,
- })
-
- def _build_metadata(self, subject: str) -> dict:
- # Build secured, centralized metadata. Client overrides are NOT allowed.
- return {
- 'room_title': subject,
- 'default_lock_settings': {
- 'lock_microphone': True,
- 'lock_webcam': True,
- 'lock_screen_sharing': True,
- 'lock_whiteboard': True,
- 'lock_shared_notepad': False,
- 'lock_chat': False,
- 'lock_chat_send_message': False,
- 'lock_chat_file_share': False,
- 'lock_private_chat': False,
- },
- 'room_features': {
- 'allow_webcams': True,
- 'mute_on_start': True,
- 'allow_screen_sharing': True,
- 'allow_recording': True,
- 'allow_rtmp': False,
- 'allow_view_other_webcams': True,
- 'allow_view_other_participants_list': True,
- 'admin_only_webcams': False,
- 'allow_polls': True,
- 'room_duration': 0,
- 'chat_features': {
- 'allow_chat': True,
- 'allow_file_upload': True,
- },
- 'shared_note_pad_features': {
- 'allowed_shared_note_pad': True,
- },
- 'whiteboard_features': {
- 'allowed_whiteboard': True,
- },
- 'breakout_room_features': {
- 'is_allow': True,
- 'allowed_number_rooms': 6,
- },
- 'waiting_room_features': {
- 'is_active': False,
- },
- 'recording_features': {
- 'is_allow': True,
- 'is_allow_cloud': True,
- 'is_allow_local': False,
- 'enable_auto_cloud_recording': False,
- 'only_record_admin_webcams': False,
- },
- },
- }
-
- @staticmethod
- def _verify_room_is_active(session: CourseLiveSession) -> bool:
- """
- Verify that the room is actually active in PlugNMeet.
-
- Args:
- session: The CourseLiveSession to verify
-
- Returns:
- bool: True if room is active in PlugNMeet, False otherwise
-
- Side effects:
- - Closes session in database if PlugNMeet reports room is inactive
- """
- if not session.room_id:
- logger.warning(f"[Room Verify] Session has no room_id - session_id={session.id}")
- return False
-
- try:
- client = PlugNMeetClient()
- response = client.is_room_active(session.room_id)
-
- # Debug: Log full response
- logger.debug(f"[Room Verify] PlugNMeet response - room_id={session.room_id} response={response}")
-
- # Handle isActive as boolean or string
- is_active_raw = response.get('isActive', False)
- is_active = is_active_raw if isinstance(is_active_raw, bool) else str(is_active_raw).lower() == 'true'
- response_msg = response.get('msg', 'unknown')
- response_status = response.get('status', False)
-
- # Trust status and msg if they indicate active room
- if response_status and 'active' in response_msg.lower() and 'not' not in response_msg.lower():
- is_active = True
-
- if is_active:
- logger.debug(f"[Room Verify] ✓ Room is active - room_id={session.room_id} session_id={session.id}")
- return True
- else:
- logger.warning(f"[Room Verify] ✗ Room is NOT active - room_id={session.room_id} session_id={session.id} msg={response_msg}")
- # Auto-close the session since room is not active
- stop_session_web_egress_if_active(session)
- now = timezone.now()
- session.ended_at = now
- session.save(update_fields=['ended_at', 'updated_at'])
-
- # Also set all users offline
- try:
- updated_count = LiveSessionUser.objects.filter(
- session=session,
- is_online=True
- ).update(is_online=False, exited_at=now, updated_at=now)
- logger.info(f"[Room Verify] Set {updated_count} users offline for session {session.id}")
- except Exception as e:
- logger.error(f"[Room Verify] Failed to set users offline: {e}")
-
- logger.info(f"[Room Verify] Session auto-closed - session_id={session.id} room_id={session.room_id}")
- return False
-
- except PlugNMeetError as e:
- error_msg = str(e)
- logger.error(f"[Room Verify] PlugNMeet API error - room_id={session.room_id} error={error_msg}")
-
- # If room not found, close the session
- if 'not found' in error_msg.lower() or 'does not exist' in error_msg.lower():
- stop_session_web_egress_if_active(session)
- now = timezone.now()
- session.ended_at = now
- session.save(update_fields=['ended_at', 'updated_at'])
-
- # Also set all users offline
- try:
- updated_count = LiveSessionUser.objects.filter(
- session=session,
- is_online=True
- ).update(is_online=False, exited_at=now, updated_at=now)
- logger.info(f"[Room Verify] Set {updated_count} users offline (room not found) for session {session.id}")
- except Exception as ex:
- logger.error(f"[Room Verify] Failed to set users offline: {ex}")
-
- logger.warning(f"[Room Verify] Room not found - session closed - session_id={session.id}")
-
- return False
-
- except Exception as e:
- logger.error(f"[Room Verify] Unexpected error - room_id={session.room_id} error={type(e).__name__}: {str(e)}")
- return False
-
- def _recreate_room_in_plugnmeet(self, course: Course, session: CourseLiveSession) -> None:
- """
- Recreate a room in PlugNMeet when session exists but room is inactive.
-
- This happens when:
- - Webhook failed to notify us of room closure
- - PlugNMeet server restarted
- - Room was manually ended
-
- Args:
- course: The course for which to recreate the room
- session: The existing session to reactivate
-
- Raises:
- PlugNMeetError: If room creation fails
- """
- subject = session.subject or get_live_session_subject(course)
- room_id = session.room_id
- metadata = self._build_metadata(subject)
-
- payload = {
- 'room_id': room_id,
- 'metadata': metadata,
- }
-
- logger.info(f"[Room Recreate] Recreating room in PlugNMeet - room_id={room_id} session_id={session.id}")
-
- try:
- client = PlugNMeetClient()
- plugnmeet_response = client.create_room(payload)
- logger.info(f"[Room Recreate] Room recreated successfully - room_id={room_id} response={plugnmeet_response}")
-
- # Reset session ended_at to mark it as active again
- session.ended_at = None
- session.save(update_fields=['ended_at', 'updated_at'])
- logger.info(f"[Room Recreate] Session reactivated - session_id={session.id}")
-
- except PlugNMeetError as exc:
- logger.error(f"[Room Recreate] Failed to recreate room - room_id={room_id} error={str(exc)}")
- raise
-
- @staticmethod
- def _build_profile_url(request, user):
- avatar = getattr(user, 'avatar', None)
- if avatar and getattr(avatar, 'url', None):
- return request.build_absolute_uri(avatar.url)
- return None
-
-
-class CourseLiveSessionRecordingAPIView(GenericAPIView):
- permission_classes = [AllowAny]
- authentication_classes = []
- serializer_class = LiveSessionRecordingControlSerializer
-
- @swagger_auto_schema(
- operation_description="Get or control WebEgress recording state for the current room.",
- tags=["Imam-Javad - Course"],
- responses={200: openapi.Response(description="Recording state returned successfully")},
- )
- def get(self, request, *args, **kwargs):
- session, _ = get_session_from_meeting_token(request, require_admin=False)
- self._refresh_status_from_service(session)
- return Response(self._build_status_payload(session), status=status.HTTP_200_OK)
-
- @swagger_auto_schema(
- operation_description="Start or stop WebEgress recording for the current room.",
- tags=["Imam-Javad - Course"],
- request_body=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- required=["action"],
- properties={
- "action": openapi.Schema(
- type=openapi.TYPE_STRING,
- enum=["start", "stop"],
- description="Recording control action.",
- ),
- },
- ),
- responses={200: openapi.Response(description="Recording action completed successfully")},
- )
- def post(self, request, *args, **kwargs):
- if not getattr(settings, "ONLINE_CLASS_WEB_EGRESS_ENABLED", False):
- raise AppAPIException(
- {"message": "WebEgress recording is not enabled."},
- status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
- )
-
- session, claims = get_session_from_meeting_token(request, require_admin=True)
- action = str(request.data.get("action") or "").strip().lower()
- if action not in {"start", "stop"}:
- raise AppAPIException(
- {"message": "Invalid recording action."},
- status_code=status.HTTP_400_BAD_REQUEST,
- )
-
- if action == "start":
- payload = self._start_recording(session, claims)
- else:
- payload = self._stop_recording(session)
-
- return Response(payload, status=status.HTTP_200_OK)
-
- def _start_recording(self, session: CourseLiveSession, claims: dict) -> dict:
- if is_web_egress_recording_status(session.web_egress_status):
- return self._build_status_payload(
- session,
- message="Recording is already active or being processed.",
- )
-
- client = WebEgressClient()
- now = timezone.now()
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_STARTING
- session.web_egress_started_at = now
- session.web_egress_stopped_at = None
- session.web_egress_error = None
- session.save(
- update_fields=[
- "web_egress_status",
- "web_egress_started_at",
- "web_egress_stopped_at",
- "web_egress_error",
- "updated_at",
- ]
- )
-
- try:
- service_response = client.start_recording(
- {
- "session_id": session.id,
- "course_id": session.course_id,
- "room_id": session.room_id,
- "room_title": session.subject,
- "recording_title": build_web_egress_title(session),
- "join_url": self._build_web_egress_join_url(session),
- "callback_url": get_web_egress_callback_url(),
- "callback_token": getattr(
- settings,
- "ONLINE_CLASS_WEB_EGRESS_CALLBACK_TOKEN",
- "",
- ),
- "requested_by": {
- "user_id": str(claims.get("user_id") or claims.get("sub") or ""),
- "name": claims.get("name") or "",
- },
- }
- )
- except (ImproperlyConfigured, WebEgressError) as exc:
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_FAILED
- session.web_egress_error = str(exc)
- session.save(
- update_fields=[
- "web_egress_status",
- "web_egress_error",
- "updated_at",
- ]
- )
- raise AppAPIException(
- {"message": str(exc)},
- status_code=status.HTTP_502_BAD_GATEWAY,
- )
-
- session.web_egress_id = service_response.get("egress_id") or session.web_egress_id
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_RECORDING
- session.web_egress_error = None
- session.save(
- update_fields=[
- "web_egress_id",
- "web_egress_status",
- "web_egress_error",
- "updated_at",
- ]
- )
-
- return self._build_status_payload(
- session,
- message=service_response.get("message") or "Recording started successfully.",
- )
-
- def _stop_recording(self, session: CourseLiveSession) -> dict:
- if not is_web_egress_recording_status(session.web_egress_status):
- return self._build_status_payload(
- session,
- message="Recording is not active.",
- )
-
- client = WebEgressClient()
- try:
- service_response = client.stop_recording(
- {
- "session_id": session.id,
- "room_id": session.room_id,
- "egress_id": session.web_egress_id,
- }
- )
- except (ImproperlyConfigured, WebEgressError) as exc:
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_FAILED
- session.web_egress_error = str(exc)
- session.save(
- update_fields=[
- "web_egress_status",
- "web_egress_error",
- "updated_at",
- ]
- )
- raise AppAPIException(
- {"message": str(exc)},
- status_code=status.HTTP_502_BAD_GATEWAY,
- )
-
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_STOPPING
- session.web_egress_stopped_at = timezone.now()
- session.web_egress_error = None
- session.save(
- update_fields=[
- "web_egress_status",
- "web_egress_stopped_at",
- "web_egress_error",
- "updated_at",
- ]
- )
-
- return self._build_status_payload(
- session,
- message=service_response.get("message") or "Recording stop requested successfully.",
- )
-
- def _refresh_status_from_service(self, session: CourseLiveSession) -> None:
- if not getattr(settings, "ONLINE_CLASS_WEB_EGRESS_ENABLED", False):
- return
- if not session.web_egress_id and session.web_egress_status in {
- CourseLiveSession.WEB_EGRESS_STATUS_IDLE,
- CourseLiveSession.WEB_EGRESS_STATUS_COMPLETED,
- CourseLiveSession.WEB_EGRESS_STATUS_FAILED,
- }:
- return
-
- try:
- client = WebEgressClient()
- service_response = client.get_status(
- room_id=session.room_id,
- session_id=session.id,
- )
- except (ImproperlyConfigured, WebEgressError) as exc:
- logger.warning(
- "[WebEgress] Failed to refresh status for session=%s room_id=%s error=%s",
- session.id,
- session.room_id,
- str(exc),
- )
- return
-
- normalized_status = self._normalize_service_status(service_response)
- update_fields = ["updated_at"]
-
- if service_response.get("egress_id") is not None and session.web_egress_id != service_response.get("egress_id"):
- session.web_egress_id = service_response.get("egress_id")
- update_fields.append("web_egress_id")
-
- if normalized_status and session.web_egress_status != normalized_status:
- session.web_egress_status = normalized_status
- update_fields.append("web_egress_status")
-
- error_message = service_response.get("error") or service_response.get("message")
- if normalized_status == CourseLiveSession.WEB_EGRESS_STATUS_FAILED:
- session.web_egress_error = error_message or session.web_egress_error
- update_fields.append("web_egress_error")
-
- if normalized_status == CourseLiveSession.WEB_EGRESS_STATUS_RECORDING and not session.web_egress_started_at:
- session.web_egress_started_at = timezone.now()
- update_fields.append("web_egress_started_at")
-
- if normalized_status in {
- CourseLiveSession.WEB_EGRESS_STATUS_STOPPING,
- CourseLiveSession.WEB_EGRESS_STATUS_PROCESSING,
- CourseLiveSession.WEB_EGRESS_STATUS_COMPLETED,
- CourseLiveSession.WEB_EGRESS_STATUS_FAILED,
- } and not session.web_egress_stopped_at:
- session.web_egress_stopped_at = timezone.now()
- update_fields.append("web_egress_stopped_at")
-
- if len(update_fields) > 1:
- session.save(update_fields=update_fields)
-
- def _normalize_service_status(self, payload: dict) -> str:
- raw = str(payload.get("state") or payload.get("status") or "").strip().lower()
- if raw in {"recording", "active", "started"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_RECORDING
- if raw in {"starting", "pending"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_STARTING
- if raw in {"stopping"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_STOPPING
- if raw in {"processing", "finalizing", "uploading"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_PROCESSING
- if raw in {"completed", "done", "finished"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_COMPLETED
- if raw in {"failed", "error"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_FAILED
- if payload.get("is_recording") is True:
- return CourseLiveSession.WEB_EGRESS_STATUS_RECORDING
- if payload.get("is_recording") is False:
- return CourseLiveSession.WEB_EGRESS_STATUS_IDLE
- return ""
-
- def _build_web_egress_join_url(self, session: CourseLiveSession) -> str:
- client = PlugNMeetClient()
- join_response = client.get_join_token(
- {
- "room_id": session.room_id,
- "user_info": {
- "user_id": f"web-egress-{session.id}",
- "name": "Session Recorder",
- "is_admin": True,
- "is_hidden": True,
- },
- }
- )
- access_token = join_response.get("token")
- if not access_token:
- raise WebEgressError("PlugNMeet did not return a recorder access token.")
-
- frontend_base = get_online_class_frontend_base()
- return (
- f"{frontend_base}/?access_token={access_token}"
- f"&web_egress=1&skip_landing=1&room_id={session.room_id}"
- )
-
- def _build_status_payload(self, session: CourseLiveSession, message: str | None = None) -> dict:
- return {
- "success": True,
- "room_id": session.room_id,
- "session_id": session.id,
- "status": session.web_egress_status,
- "is_recording": is_web_egress_recording_status(session.web_egress_status),
- "egress_id": session.web_egress_id,
- "started_at": session.web_egress_started_at.isoformat()
- if session.web_egress_started_at
- else None,
- "stopped_at": session.web_egress_stopped_at.isoformat()
- if session.web_egress_stopped_at
- else None,
- "error": session.web_egress_error,
- "message": message,
- }
-
-
-class CourseLiveSessionWebEgressCallbackAPIView(GenericAPIView):
- permission_classes = [AllowAny]
- authentication_classes = []
-
- @swagger_auto_schema(
- operation_description="Receive final WebEgress recording callback and save the final file.",
- tags=["Imam-Javad - Course"],
- responses={201: openapi.Response(description="Recording callback processed successfully")},
- )
- def post(self, request, *args, **kwargs):
- self._verify_callback_token(request)
-
- room_id = request.data.get("room_id")
- session_id = request.data.get("session_id")
- status_value = str(request.data.get("status") or "completed").strip().lower()
- egress_id = request.data.get("egress_id")
- error_message = request.data.get("error") or ""
-
- if not room_id and not session_id:
- raise AppAPIException(
- {"message": "room_id or session_id is required."},
- status_code=status.HTTP_400_BAD_REQUEST,
- )
-
- session = self._get_target_session(room_id=room_id, session_id=session_id)
-
- uploaded_file = request.FILES.get("file")
- duration_seconds = request.data.get("file_time_seconds")
- recording = None
-
- if uploaded_file:
- file_duration = None
- if duration_seconds not in (None, ""):
- try:
- file_duration = timedelta(seconds=float(duration_seconds))
- except (TypeError, ValueError):
- file_duration = None
-
- recording = LiveSessionRecording.objects.create(
- session=session,
- file=uploaded_file,
- title=request.data.get("title") or build_web_egress_title(session),
- recording_type=request.data.get("recording_type") or "video",
- file_time=file_duration,
- )
-
- session.web_egress_id = egress_id or session.web_egress_id
- session.web_egress_stopped_at = session.web_egress_stopped_at or timezone.now()
- session.web_egress_error = error_message or None
- session.web_egress_status = self._normalize_callback_status(
- status_value=status_value,
- has_file=bool(uploaded_file),
- )
- session.save(
- update_fields=[
- "web_egress_id",
- "web_egress_stopped_at",
- "web_egress_error",
- "web_egress_status",
- "updated_at",
- ]
- )
-
- response_status = status.HTTP_201_CREATED if recording else status.HTTP_200_OK
- return Response(
- {
- "success": True,
- "session_id": session.id,
- "room_id": session.room_id,
- "recording_id": recording.id if recording else None,
- "status": session.web_egress_status,
- },
- status=response_status,
- )
-
- def _verify_callback_token(self, request) -> None:
- expected = getattr(settings, "ONLINE_CLASS_WEB_EGRESS_CALLBACK_TOKEN", "")
- if not expected:
- raise AppAPIException(
- {"message": "WebEgress callback token is not configured."},
- status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
- )
-
- received = (
- request.headers.get("X-Web-Egress-Token")
- or request.data.get("callback_token")
- or ""
- )
- if received != expected:
- raise AppAPIException(
- {"message": "Invalid WebEgress callback token."},
- status_code=status.HTTP_403_FORBIDDEN,
- )
-
- def _get_target_session(self, *, room_id=None, session_id=None) -> CourseLiveSession:
- queryset = CourseLiveSession.objects.order_by("-started_at", "-id")
- if session_id:
- try:
- return queryset.get(id=int(session_id))
- except (ValueError, CourseLiveSession.DoesNotExist):
- pass
- if room_id:
- return get_object_or_404(queryset, room_id=room_id)
- raise AppAPIException(
- {"message": "Unable to resolve target live session."},
- status_code=status.HTTP_404_NOT_FOUND,
- )
-
- @staticmethod
- def _normalize_callback_status(*, status_value: str, has_file: bool) -> str:
- if has_file:
- return CourseLiveSession.WEB_EGRESS_STATUS_COMPLETED
- if status_value in {"failed", "error"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_FAILED
- if status_value in {"processing", "uploading", "stopping"}:
- return CourseLiveSession.WEB_EGRESS_STATUS_PROCESSING
- return CourseLiveSession.WEB_EGRESS_STATUS_COMPLETED
-
-
-class CourseLiveSessionRecordedFileAPIView(GenericAPIView):
- permission_classes = [AllowAny]
- authentication_classes = [TokenAuthentication]
- serializer_class = LiveSessionRecordingSerializer
-
- @swagger_auto_schema(
- operation_description="Update recorded file for live session",
- tags=["Imam-Javad - Course"],
- manual_parameters=[
- openapi.Parameter(
- 'room_slug', openapi.IN_PATH,
- description="Room Slug (e.g. room-16)",
- type=openapi.TYPE_STRING,
- required=True
- )
- ],
- responses={
- 200: openapi.Response(
- description="Recorded file updated successfully"
- )
- }
- )
- def patch(self, request, room_slug, *args, **kwargs):
- logger.info(f"[LiveSession Recorded File] Request headers: {dict(request.headers)}")
- user_id = request.user.id if request.user else None
- logger.info(f"[LiveSession Recorded File] Request from user_id={user_id} for room_slug={room_slug}")
-
- import re
- match = re.search(r'\d+', room_slug)
- if not match:
- logger.error(f"[LiveSession Recorded File] Invalid room_slug: {room_slug}")
- raise AppAPIException({'message': f'Invalid room slug: {room_slug}'}, status_code=status.HTTP_400_BAD_REQUEST)
-
- course_id = int(match.group())
- logger.info(f"[LiveSession Recorded File] Extracted course_id={course_id} from room_slug={room_slug}")
-
- course = get_object_or_404(Course, id=course_id)
-
- # If user is authenticated, enforce permissions.
- # Otherwise, allow the background recording service to proceed.
- if request.user and request.user.is_authenticated:
- if not request.user.can_manage_course(course):
- logger.warning(f"[LiveSession Recorded File] Permission denied - user_id={request.user.id} course_id={course_id}")
- raise AppAPIException({'message': 'You do not have permission to update this course.'}, status_code=status.HTTP_403_FORBIDDEN)
- else:
- logger.info(f"[LiveSession Recorded File] Allowing unauthenticated recording registration for room_slug={room_slug}")
-
- try:
- session = course.live_sessions.latest('-started_at')
- except CourseLiveSession.DoesNotExist:
- logger.warning(f"[LiveSession Recorded File] No active session found - course_id={course_id}")
- raise AppAPIException({'message': 'No live session found for this course.'}, status_code=status.HTTP_404_NOT_FOUND)
-
- logger.info(f"[LiveSession Recorded File] Latest session found - session_id={session.id} course_id={course_id}")
-
- logger.info(f"[LiveSession Recorded File] Request data: {request.data}")
- serializer = self.get_serializer(data=request.data)
- if not serializer.is_valid():
- logger.error(f"[LiveSession Recorded File] Validation errors: {serializer.errors}")
- raise AppAPIException(serializer.errors, status_code=status.HTTP_400_BAD_REQUEST)
-
- recording = LiveSessionRecording.objects.create(
- session=session,
- file=serializer.validated_data['file'],
- title=serializer.validated_data.get('title') or f"{session.subject} Recording",
- recording_type=serializer.validated_data.get('recording_type', 'video'),
- file_time=serializer.validated_data.get('file_time'),
- )
-
- logger.info(f"[LiveSession Recorded File] Recording created successfully - recording_id={recording.id} session_id={session.id}")
-
- return Response({
- 'id': recording.id,
- 'session_id': session.id,
- 'title': recording.title,
- 'file': request.build_absolute_uri(recording.file.url),
- 'recording_type': recording.recording_type,
- 'file_time': recording.file_time,
- 'is_active': recording.is_active,
- }, status=status.HTTP_201_CREATED)
-
-
-class CourseLiveSessionSetRecordingTitleAPIView(GenericAPIView):
- permission_classes = [AllowAny]
- authentication_classes = []
-
- @swagger_auto_schema(
- operation_description="Set the recording title for the active live session",
- tags=["Imam-Javad - Course"],
- request_body=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- required=['room_id', 'title'],
- properties={
- 'room_id': openapi.Schema(type=openapi.TYPE_STRING, description='Room ID'),
- 'title': openapi.Schema(type=openapi.TYPE_STRING, description='Custom Recording Title'),
- }
- ),
- responses={
- 200: openapi.Response(
- description="Recording title updated successfully"
- )
- }
- )
- def post(self, request, *args, **kwargs):
- room_id = request.data.get('room_id')
- title = request.data.get('title')
-
- if not room_id or not title:
- raise AppAPIException({'message': 'room_id and title are required.'}, status_code=status.HTTP_400_BAD_REQUEST)
-
- title = title.strip()
- if not title:
- raise AppAPIException({'message': 'title cannot be empty.'}, status_code=status.HTTP_400_BAD_REQUEST)
-
- try:
- session = CourseLiveSession.objects.get(room_id=room_id, ended_at__isnull=True)
- except CourseLiveSession.DoesNotExist:
- raise AppAPIException({'message': 'Active session not found.'}, status_code=status.HTTP_404_NOT_FOUND)
-
- session.recording_title = title
- session.subject = title
- session.save(update_fields=['recording_title', 'subject', 'updated_at'])
- sync_session_recording_titles(session)
-
- logger.info(f"[LiveSession Title] Set recording title for room_id={room_id} to '{title}'")
- return Response({'success': True, 'message': 'Recording title updated successfully.'}, status=status.HTTP_200_OK)
diff --git a/apps/course/views/participant.py b/apps/course/views/participant.py
deleted file mode 100644
index b49d743..0000000
--- a/apps/course/views/participant.py
+++ /dev/null
@@ -1,79 +0,0 @@
-from rest_framework import generics
-from rest_framework.exceptions import NotFound
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-from rest_framework.permissions import IsAuthenticated
-
-from apps.account.models import StudentUser
-from apps.course.models import Participant, Course
-from apps.course.serializers import ParticipantSerializer
-from apps.account.serializers import UserProfileSerializer
-from apps.course.doc import *
-from utils.exceptions import AppAPIException
-from utils.pagination import StandardResultsSetPagination
-
-
-
-from rest_framework import serializers
-from django.db.models import Subquery, OuterRef
-
-class CourseParticipantSerializer(UserProfileSerializer):
- is_active = serializers.BooleanField(read_only=True)
-
- class Meta(UserProfileSerializer.Meta):
- fields = UserProfileSerializer.Meta.fields + ['is_active']
-
-
-class CourseParticipantsView(generics.ListAPIView):
- serializer_class = CourseParticipantSerializer
- pagination_class = StandardResultsSetPagination
-
- @swagger_auto_schema(
- operation_description=doc_course_participants(),
- tags=['Imam-Javad - Course'],
- )
- def get(self, request, *args, **kwargs):
- return self.list(request, *args, **kwargs)
- def get_queryset(self):
- """
- Optimized queryset with select_related for course relationship.
- Filters out guest users (no email) while keeping inactive students visible
- for the admin course participants table.
- """
- course_slug = self.kwargs.get('slug')
- course = Course.objects.filter(slug__contains=[{"title": course_slug}]).first()
- if not course:
- raise AppAPIException({'message': "Course not found"})
-
- return StudentUser.objects.select_related().filter(
- participated_courses__course=course,
- email__isnull=False # Exclude guest users
- ).exclude(
- email__exact='' # Extra safety just in case an email is a blank string
- ).distinct()
-# queryset = StudentUser.objects.all()
-# serializer_class = ParticipantSerializer
-# permission_classes = [IsAuthenticated]
-
-
-# def create(self, request, *args, **kwargs):
-# user = request.user
-# course_slug = self.kwargs.get('slug') # Get the slug from the URL
-# try:
-# course = Course.objects.get(slug=slug) # Retrieve the Course object
-# except Course.DoesNotExist:
-# raise AppAPIException({'message': "Course not found"}) # Handle course not found
-
-# if request.data.get('email') != request.user:
-# raise AppAPIException({'message': "The email must be for the requesting user"})
-
-# if user.user_type != User.UserType.STUDENT:
-# user.change_user_type(User.UserType.STUDENT)
-
-# participant, created = Participant.objects.get_or_create(
-# student=user,
-# course=course
-# )
-
-# serializer = self.get_serializer(participant)
-# return Response(serializer.data, status=status.HTTP_201_CREATED)
diff --git a/apps/course/views/professor.py b/apps/course/views/professor.py
deleted file mode 100644
index 895fb94..0000000
--- a/apps/course/views/professor.py
+++ /dev/null
@@ -1,206 +0,0 @@
-from django.contrib.auth import get_user_model
-from django.db.models import Count, Q
-from django.shortcuts import get_object_or_404
-
-from rest_framework.filters import SearchFilter
-from rest_framework.generics import ListAPIView, RetrieveAPIView
-from rest_framework.permissions import AllowAny
-from drf_yasg import openapi
-from drf_yasg.utils import swagger_auto_schema
-
-from apps.course.models import Course
-from apps.course.serializers import (
- CourseListSerializer,
- ProfessorDetailSerializer,
- ProfessorListSerializer,
-)
-from utils.pagination import StandardResultsSetPagination
-from django.utils.decorators import method_decorator
-from django.views.decorators.cache import never_cache
-from django.core.cache import cache
-from rest_framework.response import Response
-
-
-UserModel = get_user_model()
-
-
-class ProfessorListAPIView(ListAPIView):
- permission_classes = [AllowAny]
- serializer_class = ProfessorListSerializer
- filter_backends = [SearchFilter]
- search_fields = ['fullname', 'email']
- pagination_class = StandardResultsSetPagination
-
- @swagger_auto_schema(
- operation_description='دریافت فهرست استادها به همراه تعداد دورهها و درسهای فعال هر استاد.',
- tags=['Imam-Javad - Course'],
- responses={
- 200: openapi.Response(
- description='فهرست صفحهبندیشدهی استادها.',
- schema=ProfessorListSerializer(many=True),
- examples={
- 'application/json': {
- 'count': 1,
- 'next': None,
- 'previous': None,
- 'results': [
- {
- 'id': 7,
- 'slug': 'dr-rahimi',
- 'fullname': 'دکتر رحیمی',
- 'experience_years': 10,
- 'course_count': 4,
- 'lesson_count': 56,
- }
- ],
- }
- },
- )
- },
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- return (
- UserModel.objects.filter(user_type=UserModel.UserType.PROFESSOR, is_active=True)
- .annotate(
- course_count=Count('courses', distinct=True),
- lesson_count=Count('courses__lessons', filter=Q(courses__lessons__is_active=True), distinct=True),
- )
- .order_by('fullname')
- )
-
-
-class ProfessorDetailAPIView(RetrieveAPIView):
- permission_classes = [AllowAny]
- serializer_class = ProfessorDetailSerializer
- lookup_field = 'slug'
-
- @swagger_auto_schema(
- operation_description='دریافت جزئیات یک استاد بر اساس اسلاگ.',
- tags=['Imam-Javad - Course'],
- responses={
- 200: openapi.Response(
- description='اطلاعات کامل استاد.',
- schema=ProfessorDetailSerializer(),
- examples={
- 'application/json': {
- 'id': 7,
- 'device_id': 'abc-123',
- 'fcm': None,
- 'fullname': 'دکتر رحیمی',
- 'avatar': None,
- 'email': 'rahimi@example.com',
- 'phone_number': '+989121234567',
- 'password': None,
- 'info': 'متخصص فیزیک پزشکی.',
- 'skill': 'فیزیک، تدریس آنلاین',
- 'city': 'تهران',
- 'country': 'ایران',
- 'birthdate': '1985-04-12',
- 'gender': 'male',
- 'slug': 'dr-rahimi',
- 'experience_years': 10,
- 'course_count': 4,
- 'lesson_count': 56,
- }
- },
- )
- },
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def retrieve(self, request, *args, **kwargs):
- slug = self.kwargs.get('slug')
- cache_key = f"professor_detail_{slug}"
-
- # Try to get the data from Redis/Cache
- cached_data = cache.get(cache_key)
- if cached_data:
- return Response(cached_data)
-
- # If not in cache, let DRF do the heavy lifting (DB queries, serialization)
- response = super().retrieve(request, *args, **kwargs)
-
- # Store the serialized data in the cache for 24 hours
- cache.set(cache_key, response.data, timeout=60 * 60 * 24)
-
- return response
-
-
-
- def get_queryset(self):
- return UserModel.objects.filter(user_type=UserModel.UserType.PROFESSOR, is_active=True).annotate(
- course_count=Count('courses', distinct=True),
- lesson_count=Count('courses__lessons', filter=Q(courses__lessons__is_active=True), distinct=True),
- )
-
-
-class ProfessorCourseListAPIView(ListAPIView):
- permission_classes = [AllowAny]
- serializer_class = CourseListSerializer
- filter_backends = [SearchFilter]
- search_fields = ['title', 'category__name']
- pagination_class = StandardResultsSetPagination
-
- @method_decorator(never_cache)
- def dispatch(self, request, *args, **kwargs):
- return super().dispatch(request, *args, **kwargs)
-
-
- @swagger_auto_schema(
- operation_description='دریافت فهرست دورههای فعال یک استاد مشخصشده با اسلاگ.',
- tags=['Imam-Javad - Course'],
- responses={
- 200: openapi.Response(
- description='فهرست صفحهبندیشدهی دورهها.',
- schema=CourseListSerializer(many=True),
- examples={
- 'application/json': {
- 'count': 1,
- 'next': None,
- 'previous': None,
- 'results': [
- {
- 'id': 42,
- 'title': 'فیزیک پایه',
- 'slug': 'basic-physics',
- 'participant_count': 150,
- 'category': {
- 'name': 'علوم پایه',
- 'slug': 'basic-science',
- 'course_count': 12,
- },
- 'thumbnail': None,
- 'is_online': True,
- 'online_link': 'https://example.com/live/basic-physics',
- 'level': 'beginner',
- 'duration': '12h',
- 'lessons_count': 24,
- 'short_description': 'مروری بر مفاهیم پایه فیزیک.',
- 'status': 'published',
- 'is_free': False,
- 'price': '250000',
- 'discount_percentage': 20,
- 'final_price': '200000',
- }
- ],
- }
- },
- )
- },
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_queryset(self):
- slug = self.kwargs.get('slug')
- professor = get_object_or_404(UserModel.objects.filter(user_type=UserModel.UserType.PROFESSOR, is_active=True, slug=slug))
- return Course.objects.select_related('category').prefetch_related(
- 'professors',
- 'lessons__lesson',
- 'lessons__completions',
- 'participants__student',
- ).exclude(status__contains=[{"title": Course.StatusChoices.INACTIVE}]).filter(professors=professor)
diff --git a/apps/course/views/webhook.py b/apps/course/views/webhook.py
deleted file mode 100644
index 3cce51f..0000000
--- a/apps/course/views/webhook.py
+++ /dev/null
@@ -1,491 +0,0 @@
-import json
-import hmac
-import hashlib
-import logging
-import os
-import tempfile
-import subprocess
-import base64
-import jwt
-from typing import Dict, Any, Optional
-from datetime import timedelta
-
-from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-from django.utils import timezone
-from django.utils.decorators import method_decorator
-from django.views.decorators.csrf import csrf_exempt
-from django.core.files.base import ContentFile
-
-from rest_framework import status
-from rest_framework.views import APIView
-from rest_framework.response import Response
-from rest_framework.permissions import AllowAny
-from rest_framework.parsers import BaseParser
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-
-from apps.course.models import CourseLiveSession, LiveSessionUser, Course, Participant, LiveSessionRecording
-from apps.account.models import User
-from apps.course.services.plugnmeet import PlugNMeetClient, PlugNMeetError
-from apps.course.services.web_egress import stop_session_web_egress_if_active
-from utils.exceptions import AppAPIException
-
-logger = logging.getLogger(__name__)
-
-AUTO_CLOSE_AFTER_MODERATOR_EXIT_MINUTES = getattr(
- settings,
- "ONLINE_CLASS_AUTO_CLOSE_AFTER_MODERATOR_EXIT_MINUTES",
- 10,
-)
-
-class RawJSONParser(BaseParser):
- """
- Parser that preserves the raw body bytes for HMAC signature verification.
- """
- media_type = '*/*'
- def parse(self, stream, media_type=None, parser_context=None):
- return stream.read()
-
-@method_decorator(csrf_exempt, name='dispatch')
-class PlugNMeetWebhookAPIView(APIView):
- """
- Webhook endpoint to receive and process events from the PlugNMeet server.
-
- Handles:
- - room_finished: Closes the live session record.
- - participant_joined: Tracks student entry.
- - participant_left: Tracks student exit.
- - end_recording: Downloads and saves session recordings.
- """
- authentication_classes = []
- permission_classes = [AllowAny]
- parser_classes = [RawJSONParser]
-
- @swagger_auto_schema(
- operation_description="Handle webhook events from PlugNMeet server for live sessions",
- tags=["Imam-Javad - Course"],
- responses={
- 200: openapi.Response(description="Webhook processed successfully"),
- 403: openapi.Response(description="Invalid signature"),
- 400: openapi.Response(description="Invalid payload")
- }
- )
- def post(self, request, *args, **kwargs):
- logger.info("⚡ [PlugNMeet Webhook] Request received")
-
- # 1. Extract Signature
- hash_token = request.headers.get('Hash-Token') or request.META.get('HTTP_HASH_TOKEN')
-
- if not hash_token:
- logger.error("❌ [PlugNMeet Webhook] Missing Hash-Token header")
- return Response({'message': 'Missing Hash-Token header'}, status=403)
-
- # 2. Verify Signature
- if not self._verify_webhook_signature(request, hash_token):
- return Response({'message': 'Invalid webhook signature'}, status=403)
-
- # 3. Parse Payload
- try:
- body_bytes = request.data # RawJSONParser puts bytes here
- payload = json.loads(body_bytes.decode('utf-8'))
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] Parsing Error: {e}")
- return Response({'message': 'Invalid JSON'}, status=400)
-
- event = payload.get('event')
- logger.info(f"✅ [PlugNMeet Webhook] Event: {event}")
-
- # 4. Route Event
- handler_map = {
- 'room_finished': self._handle_room_finished,
- 'session_ended': self._handle_room_finished,
- 'participant_joined': self._handle_participant_joined,
- 'participant_left': self._handle_participant_left,
- 'recording_proceeded': self._handle_recording_proceeded,
- }
-
- handler = handler_map.get(event)
- if not handler:
- logger.info(f"ℹ️ [PlugNMeet Webhook] Event {event} ignored")
- return Response({'status': 'ok', 'message': f'Event {event} ignored'})
-
- try:
- result = handler(payload)
- return Response({'status': 'ok', **result})
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] Error in {event}: {e}", exc_info=True)
- return Response({'status': 'error', 'message': str(e)}, status=500)
-
- def _verify_webhook_signature(self, request, hash_token: str) -> bool:
- api_secret = getattr(settings, 'PLUGNMEET_API_SECRET', None)
- if not api_secret:
- logger.error("❌ [PlugNMeet Webhook] PLUGNMEET_API_SECRET not configured")
- return False
-
- body_bytes = request.data
- auth_header = request.headers.get('Authorization') or request.META.get('HTTP_AUTHORIZATION', '')
-
- logger.info(f"🔍 [PlugNMeet Webhook] Verify Signature details:")
- logger.info(f" - Hash-Token (first 30 chars): {hash_token[:30]}... (length: {len(hash_token)})")
- logger.info(f" - Authorization (first 30 chars): {auth_header[:30]}... (length: {len(auth_header)})")
- logger.info(f" - Body bytes length: {len(body_bytes)}")
- if len(body_bytes) > 0:
- logger.info(f" - Body preview (first 100 bytes): {body_bytes[:100]}")
-
- # 1. Try JWT verification (PlugNMeet production standard)
- try:
- # A JWT typically consists of three segments separated by dots
- if len(hash_token.split('.')) == 3:
- logger.info(" - Attempting JWT decode on Hash-Token...")
- decoded = jwt.decode(
- hash_token,
- api_secret,
- algorithms=['HS256'],
- options={
- "verify_signature": True,
- "verify_exp": False,
- "verify_nbf": False,
- "verify_iat": False,
- "verify_aud": False,
- "verify_iss": False
- }
- )
- logger.info(f" - Decoded JWT claims: {list(decoded.keys())}")
- token_sha256 = decoded.get('sha256')
- if token_sha256:
- hasher = hashlib.sha256()
- hasher.update(body_bytes)
- computed_sha256 = base64.b64encode(hasher.digest()).decode('utf-8')
- logger.info(f" - Claim SHA256: {token_sha256}")
- logger.info(f" - Computed SHA256: {computed_sha256}")
- if hmac.compare_digest(token_sha256, computed_sha256):
- logger.info(" - JWT SHA256 signature verification successful!")
- return True
- else:
- logger.error(f"❌ [PlugNMeet Webhook] SHA256 mismatch! Token claim: {token_sha256}, Computed: {computed_sha256}")
- else:
- logger.error("❌ [PlugNMeet Webhook] JWT missing 'sha256' claim")
- else:
- logger.info(" - Hash-Token does not have 3 segments (not a JWT).")
- except jwt.PyJWTError as e:
- logger.error(f"❌ [PlugNMeet Webhook] JWT decoding failed: {e.__class__.__name__}: {str(e)}")
- logger.warning(f"⚠️ [PlugNMeet Webhook] JWT decoding failed. Falling back to HMAC-SHA256 check.")
-
- # 2. Fallback: HMAC-SHA256 verification (for backward compatibility with test_webhook.py)
- expected_signature = hmac.new(
- api_secret.encode('utf-8'),
- body_bytes,
- hashlib.sha256
- ).hexdigest()
-
- logger.info(f" - Expected HMAC: {expected_signature}")
- if hmac.compare_digest(hash_token, expected_signature):
- logger.info(" - Fallback HMAC verification successful!")
- return True
-
- logger.error(f"❌ [PlugNMeet Webhook] Signature mismatch! \nReceived: {hash_token[:10]}...\nExpected HMAC: {expected_signature[:10]}...")
- return False
-
- @staticmethod
- def _extract_room_id(room_data: Dict[str, Any]) -> Optional[str]:
- if not isinstance(room_data, dict):
- return None
-
- return (
- room_data.get('room_id')
- or room_data.get('roomId')
- or room_data.get('identity')
- or room_data.get('name')
- )
-
- def _handle_room_finished(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- room_data = payload.get('room', {})
- room_id = self._extract_room_id(room_data)
-
- if not room_id:
- logger.warning(f"⚠️ [PlugNMeet Webhook] Missing room_id in room_finished event. Payload: {payload}")
- return {'message': 'Missing room identity'}
-
- try:
- session = CourseLiveSession.objects.get(room_id=room_id, ended_at__isnull=True)
- stop_session_web_egress_if_active(session)
- now = timezone.now()
- session.ended_at = now
- update_fields = ['ended_at', 'updated_at']
- if session.web_egress_status in {
- CourseLiveSession.WEB_EGRESS_STATUS_STARTING,
- CourseLiveSession.WEB_EGRESS_STATUS_RECORDING,
- }:
- session.web_egress_status = CourseLiveSession.WEB_EGRESS_STATUS_PROCESSING
- update_fields.append('web_egress_status')
- if not session.web_egress_stopped_at:
- session.web_egress_stopped_at = now
- update_fields.append('web_egress_stopped_at')
- session.save(update_fields=update_fields)
-
- # Close active user sessions
- updated_count = LiveSessionUser.objects.filter(
- session=session,
- is_online=True,
- exited_at__isnull=True
- ).update(is_online=False, exited_at=now, updated_at=now)
-
- logger.info(f"🏁 [PlugNMeet Webhook] Session {session.id} ended. Users disconnected: {updated_count}")
- return {'session_id': session.id, 'closed_users': updated_count}
- except CourseLiveSession.DoesNotExist:
- logger.warning(f"⚠️ [PlugNMeet Webhook] room_finished: No active session found for room_id {room_id}")
- return {'message': 'No active session found for this room'}
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] Error in room_finished for room_id {room_id}: {e}", exc_info=True)
- return {'error': str(e)}
-
- def _handle_participant_joined(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- room_data = payload.get('room', {})
- participant_data = payload.get('participant', {})
- room_id = self._extract_room_id(room_data)
- user_id = participant_data.get('identity') or participant_data.get('user_id') or participant_data.get('userId')
-
- if not room_id or not user_id:
- logger.warning(f"⚠️ [PlugNMeet Webhook] Missing room_id or user_id in participant_joined. room_id: {room_id}, user_id: {user_id}. Payload: {payload}")
- return {'message': 'Missing required metadata'}
-
- try:
- if not str(user_id).isdigit():
- logger.info(f"ℹ️ [PlugNMeet Webhook] Ignoring non-integer user join: {user_id}")
- return {'message': f'Ignored non-integer user_id {user_id}'}
-
- session = CourseLiveSession.objects.get(room_id=room_id, ended_at__isnull=True)
- user = User.objects.get(id=int(user_id))
-
- role = 'moderator' if user.can_manage_course(session.course) else 'participant'
-
- session_user, created = LiveSessionUser.objects.update_or_create(
- session=session,
- user=user,
- defaults={
- 'role': role,
- 'is_online': True,
- 'exited_at': None,
- 'entered_at': timezone.now()
- }
- )
- if role == 'moderator':
- self._clear_pending_auto_close(session)
- logger.info(f"👤 [PlugNMeet Webhook] User {user.id} joined session {session.id} (created: {created})")
- return {'session_user_id': session_user.id, 'created': created}
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] Error in participant_joined (room_id: {room_id}, user_id: {user_id}): {e}", exc_info=True)
- return {'error': str(e)}
-
- def _handle_participant_left(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- room_data = payload.get('room', {})
- participant_data = payload.get('participant', {})
- room_id = self._extract_room_id(room_data)
- user_id = participant_data.get('identity') or participant_data.get('user_id') or participant_data.get('userId')
-
- if not room_id or not user_id:
- logger.warning(f"⚠️ [PlugNMeet Webhook] Missing room_id or user_id in participant_left. room_id: {room_id}, user_id: {user_id}. Payload: {payload}")
- return {'message': 'Missing required metadata'}
-
- try:
- if not str(user_id).isdigit():
- logger.info(f"ℹ️ [PlugNMeet Webhook] Ignoring non-integer user leave: {user_id}")
- return {'message': f'Ignored non-integer user_id {user_id}'}
-
- session = CourseLiveSession.objects.get(room_id=room_id)
- user = User.objects.get(id=int(user_id))
-
- updated = LiveSessionUser.objects.filter(
- session=session, user=user, is_online=True
- ).update(is_online=False, exited_at=timezone.now(), updated_at=timezone.now())
-
- if updated:
- self._update_auto_close_state_after_leave(session, user)
-
- logger.info(f"🚪 [PlugNMeet Webhook] User {user.id} left session {session.id} (updated entries count: {updated})")
- return {'updated': bool(updated)}
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] Error in participant_left (room_id: {room_id}, user_id: {user_id}): {e}", exc_info=True)
- return {'error': str(e)}
-
- def _get_video_duration(self, video_path: str) -> timezone.timedelta:
- """Get video duration using ffprobe, return as timedelta."""
- try:
- cmd = [
- 'ffprobe',
- '-v', 'error',
- '-show_entries', 'format=duration',
- '-of', 'default=noprint_wrappers=1:nokey=1',
- video_path
- ]
- result = subprocess.run(
- cmd,
- stdout=subprocess.PIPE,
- stderr=subprocess.PIPE,
- timeout=30
- )
- if result.returncode == 0:
- duration_seconds = float(result.stdout.decode().strip())
- return timezone.timedelta(seconds=duration_seconds)
- except Exception as e:
- logger.warning(f"⚠️ [PlugNMeet Webhook] Duration extraction failed: {e}")
- return timezone.timedelta(seconds=0)
-
- def _handle_recording_proceeded(self, payload: Dict[str, Any]) -> Dict[str, Any]:
- logger.info(f"📥 [PlugNMeet Webhook] Processing recording_proceeded payload: {payload}")
- room_data = payload.get('room', {})
- recording_info = payload.get('recording_info', {})
-
- room_id = self._extract_room_id(room_data)
- recording_id = (
- recording_info.get('record_id') or
- recording_info.get('recordId') or
- recording_info.get('recording_id') or
- recording_info.get('recordingId')
- )
- file_path = recording_info.get('file_path') or recording_info.get('filePath')
-
- if not room_id or not recording_id:
- print("ERROR------------------------", recording_id, room_id, payload)
- logger.warning(f"⚠️ [PlugNMeet Webhook] Missing room_id or recording_id in recording_proceeded event. room_id: {room_id}, recording_id: {recording_id}")
- return {'message': 'Missing recording metadata'}
-
- file_name = os.path.basename(file_path) if file_path else f"{recording_id}.mp4"
-
- try:
- session = CourseLiveSession.objects.get(room_id=room_id)
- client = PlugNMeetClient()
-
- recording_info_response = client.get_recording_info(recording_id)
- recording_info_payload = (
- recording_info_response.get('recordingInfo')
- or recording_info_response.get('recording_info')
- or {}
- )
- recording_metadata = recording_info_payload.get('metadata') or {}
- extra_data = recording_metadata.get('extraData') or recording_metadata.get('extra_data') or {}
- if extra_data.get('imamjavad_recording_kind') == 'segment':
- logger.info(f"ℹ️ [PlugNMeet Webhook] Ignoring partial recording segment: {recording_id}")
- return {'message': 'Ignored partial recording segment'}
-
- # 1. Fetch download token
- token_response = client.get_recording_download_token(recording_id)
- if not token_response.get('status'):
- return {'error': 'Failed to get download token'}
-
- download_token = token_response.get('token')
- download_path = f"/download/recording/{download_token}"
-
- # 2. Download to temporary file
- with tempfile.NamedTemporaryFile(delete=False, suffix='.mp4') as tmp_file:
- tmp_file_path = tmp_file.name
-
- try:
- logger.info(f"📥 [PlugNMeet Webhook] Downloading recording {recording_id}...")
- client.download_file(download_path, tmp_file_path)
-
- # 3. Read duration using ffprobe
- duration = self._get_video_duration(tmp_file_path)
-
- # 4. Save to Database
- with open(tmp_file_path, 'rb') as f:
- content = f.read()
-
- recording = LiveSessionRecording.objects.create(
- session=session,
- title=session.recording_title or f"{session.subject} - Recording",
- file_time=duration if duration.total_seconds() > 0 else None,
- recording_type='video' if file_name.lower().endswith('.mp4') else 'voice'
- )
- recording.file.save(file_name, ContentFile(content), save=True)
-
- # 5. Generate thumbnail (Optional)
- self._generate_video_thumbnail(tmp_file_path, recording)
-
- logger.info(f"💾 [PlugNMeet Webhook] Recording saved successfully: {recording.id}")
- return {'recording_id': recording.id, 'file': file_name}
-
- finally:
- if os.path.exists(tmp_file_path):
- os.unlink(tmp_file_path)
-
- except Exception as e:
- logger.error(f"❌ [PlugNMeet Webhook] RECORDING_PROCEEDED Error: {e}", exc_info=True)
- return {'error': str(e)}
-
- def _generate_video_thumbnail(self, video_path: str, recording: LiveSessionRecording) -> bool:
- try:
- with tempfile.NamedTemporaryFile(delete=False, suffix='.jpg') as tmp_thumb:
- thumbnail_path = tmp_thumb.name
-
- cmd = [
- 'ffmpeg', '-ss', '1', '-i', video_path, '-frames:v', '1',
- '-q:v', '2', '-vf', 'scale=640:-1', '-y', thumbnail_path
- ]
-
- result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, timeout=30)
-
- if result.returncode == 0 and os.path.exists(thumbnail_path) and os.path.getsize(thumbnail_path) > 0:
- with open(thumbnail_path, 'rb') as f:
- recording.thumbnail.save(f"thumb_{recording.id}.jpg", ContentFile(f.read()), save=True)
- os.unlink(thumbnail_path)
- return True
- return False
- except Exception as e:
- logger.warning(f"⚠️ [PlugNMeet Webhook] Thumbnail failed: {e}")
- return False
-
- def _update_auto_close_state_after_leave(self, session: CourseLiveSession, user: User) -> None:
- if session.ended_at or not user.can_manage_course(session.course):
- return
-
- has_other_moderator_online = LiveSessionUser.objects.filter(
- session=session,
- role='moderator',
- is_online=True,
- ).exists()
- if has_other_moderator_online:
- self._clear_pending_auto_close(session)
- return
-
- has_non_moderator_online = LiveSessionUser.objects.filter(
- session=session,
- is_online=True,
- ).exclude(role='moderator').exists()
- if not has_non_moderator_online:
- self._clear_pending_auto_close(session)
- return
-
- now = timezone.now()
- due_at = now + timedelta(minutes=AUTO_CLOSE_AFTER_MODERATOR_EXIT_MINUTES)
- session.last_moderator_left_at = now
- session.auto_close_after_moderator_exit_at = due_at
- session.save(
- update_fields=[
- 'last_moderator_left_at',
- 'auto_close_after_moderator_exit_at',
- 'updated_at',
- ]
- )
- logger.info(
- "⏳ [PlugNMeet Webhook] Auto-close countdown scheduled - session_id=%s room_id=%s due_at=%s",
- session.id,
- session.room_id,
- due_at.isoformat(),
- )
-
- @staticmethod
- def _clear_pending_auto_close(session: CourseLiveSession) -> None:
- if not session.last_moderator_left_at and not session.auto_close_after_moderator_exit_at:
- return
-
- session.last_moderator_left_at = None
- session.auto_close_after_moderator_exit_at = None
- session.save(
- update_fields=[
- 'last_moderator_left_at',
- 'auto_close_after_moderator_exit_at',
- 'updated_at',
- ]
- )
diff --git a/apps/quiz/__init__.py b/apps/quiz/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/quiz/admin/__init__.py b/apps/quiz/admin/__init__.py
deleted file mode 100644
index 42092ad..0000000
--- a/apps/quiz/admin/__init__.py
+++ /dev/null
@@ -1,5 +0,0 @@
-from .quiz import *
-from .question import *
-from .participant import *
-# from .prize import *
-# from .user_rank_quiz import *
\ No newline at end of file
diff --git a/apps/quiz/admin/participant.py b/apps/quiz/admin/participant.py
deleted file mode 100644
index 0756e30..0000000
--- a/apps/quiz/admin/participant.py
+++ /dev/null
@@ -1,111 +0,0 @@
-from django.contrib import admin
-from django.db.models import F
-from django.contrib.admin import SimpleListFilter
-from django.utils.translation import gettext_lazy as _
-from django import forms
-
-from unfold.admin import ModelAdmin, StackedInline, TabularInline
-from unfold.decorators import display
-
-from apps.quiz.models import QuizParticipant, ParticipantAnswer
-from apps.account.models import User
-
-from utils.admin import project_admin_site
-
-# --- INLINE FOR QUIZ DETAIL PAGE ---
-class MinWidthInlineForm(forms.ModelForm):
- def __init__(self, *args, **kwargs):
- super().__init__(*args, **kwargs)
- target_dropdown_fields = ['user']
- for field_name, field in self.fields.items():
- if field_name in target_dropdown_fields and hasattr(field.widget, 'attrs'):
- existing_class = field.widget.attrs.get('class', '')
- field.widget.attrs['class'] = f"{existing_class} min-w-[250px] w-full"
- existing_style = field.widget.attrs.get('style', '')
- field.widget.attrs['style'] = f"{existing_style} min-width: 250px; width: 250px;"
-
-class QuizParticipantInline(TabularInline):
- model = QuizParticipant
- form = MinWidthInlineForm
- extra = 0
- tab = True
- fields = ('user', 'started_at', 'total_timing', 'total_score')
- readonly_fields = ('user', 'started_at', 'total_timing', 'total_score')
- autocomplete_fields = ('user',)
- show_change_link = True
- verbose_name = _("Recent Participant")
- verbose_name_plural = _("Recent Participants (Latest 10)")
-
- def get_queryset(self, request):
- qs = super().get_queryset(request)
- object_id = request.resolver_match.kwargs.get('object_id')
- if object_id:
- latest_ids = list(qs.filter(quiz_id=object_id).order_by('-started_at').values_list('id', flat=True)[:10])
- return qs.filter(id__in=latest_ids).order_by('-started_at')
- return qs.none()
-
- def has_add_permission(self, request, obj):
- return False
- def has_change_permission(self, request, obj=None):
- return False
- def has_delete_permission(self, request, obj=None):
- return False
-
-
-class ParticipantAnswerInline(StackedInline):
- model = ParticipantAnswer
- readonly_fields = (
- 'correct_answer_display', 'question', 'at_time', 'answer_timing',
- )
-
- @display(description=_("Correct Answer"))
-
- def correct_answer_display(self, obj):
- return obj.correct_answer
-
- def has_add_permission(self, request, obj):
- return False
-
- def has_delete_permission(self, request, obj=None):
- return False
-
- def get_queryset(self, request):
- return super().get_queryset(request).annotate(correct_answer=F('question__correct_answer'))
-
-
-class UserEmailFilter(SimpleListFilter):
- title = _('User Email')
- parameter_name = 'user_email'
-
- def lookups(self, request, model_admin):
- # 🔔 FILTER: Only fetch active users who have an email (not guests or deleted)
- users = User.objects.filter(is_active=True, email__isnull=False)
- return [(user.email, user.email) for user in users]
-
- def queryset(self, request, queryset):
- if self.value():
- email = self.value().replace('%40', '@')
- return queryset.filter(user__email=email)
- return queryset
-
-
-class ParticipantAdmin(ModelAdmin):
- inlines = [ParticipantAnswerInline]
- search_fields = ['user__username', 'user__fullname']
- list_display = [
- 'quiz', 'user', 'started_at', 'ended_at', 'total_timing',
- 'question_score', 'timing_score', 'total_score'
- ]
- list_filter = ['started_at', 'ended_at', 'quiz__status', UserEmailFilter]
-
- # Optional: Add these for better UI experience
- date_hierarchy = 'started_at'
- ordering = ['-started_at']
-
- # 🔔 FILTER: Restrict the user dropdown in forms to active, non-guest users
- def formfield_for_foreignkey(self, db_field, request, **kwargs):
- if db_field.name == "user":
- kwargs["queryset"] = User.objects.filter(is_active=True, email__isnull=False)
- return super().formfield_for_foreignkey(db_field, request, **kwargs)
-
-project_admin_site.register(QuizParticipant, ParticipantAdmin)
\ No newline at end of file
diff --git a/apps/quiz/admin/question.py b/apps/quiz/admin/question.py
deleted file mode 100644
index ef4e464..0000000
--- a/apps/quiz/admin/question.py
+++ /dev/null
@@ -1,91 +0,0 @@
-from django import forms
-from django.contrib import admin
-from django.utils.translation import gettext_lazy as _
-
-from unfold.admin import ModelAdmin, TabularInline, StackedInline
-from unfold.forms import forms
-
-from apps.course.models.course import extract_text_from_json
-from apps.quiz.models import Question
-
-from utils.admin import project_admin_site
-
-
-
-# Uncomment if you want to register Question as a standalone admin
-# @admin.register(Question)
-# class QuestionAdmin(ModelAdmin):
-# list_display = ('question', 'correct_answer', 'quiz', 'priority')
-# form = QuestionAdminForm
-# ordering = ("priority", "id",)
-# fieldsets = (
-# (
-# None, {
-# 'fields': (
-# 'question',
-# ('option1', 'option2'),
-# ('option3', 'option4'),
-# 'correct_answer',
-# )
-# },
-# ),
-# (
-# None, {
-# 'fields': ('priority',)
-# }
-# )
-# )
-@admin.register(Question)
-class QuestionAdmin(ModelAdmin):
- list_display = ('question_display', 'correct_answer', 'quiz', 'priority')
- ordering = ("priority", "id",)
- search_fields = ('question', 'quiz__title')
- list_filter = ('quiz',)
-
- fieldsets = (
- (
- None, {
- 'fields': (
- 'quiz',
- 'question',
- ('option1', 'option2'),
- ('option3', 'option4'),
- 'correct_answer',
- )
- },
- ),
- (
- None, {
- 'fields': ('priority',)
- }
- )
- )
-
- @admin.display(description=_('Question'))
- def question_display(self, obj):
- return extract_text_from_json(obj.question)
-
-class QuestionAdminInline(StackedInline):
- model = Question
- ordering = ("priority", "id",)
- extra = 0
-
- fieldsets = (
- (
- None, {
- 'fields': (
- 'question',
- ('option1', 'option2'),
- ('option3', 'option4'),
- 'correct_answer',
- )
- },
- ),
- (
- None, {
- 'fields': ('priority',)
- }
- )
- )
-project_admin_site.register(Question, QuestionAdmin)
-
diff --git a/apps/quiz/admin/quiz.py b/apps/quiz/admin/quiz.py
deleted file mode 100644
index 2dcbf5b..0000000
--- a/apps/quiz/admin/quiz.py
+++ /dev/null
@@ -1,194 +0,0 @@
-from django.contrib import admin, messages
-from django.db.models import Q
-from django.db.models import Count
-from django.utils.safestring import mark_safe
-from django.urls import reverse
-from django.shortcuts import redirect
-from django.utils.translation import gettext_lazy as _
-
-from unfold.admin import ModelAdmin
-from unfold.decorators import display, action
-
-from apps.course.models import CourseLesson
-from apps.course.models import Course
-from apps.course.models.course import extract_text_from_json
-from apps.quiz.models import Quiz
-from apps.quiz.admin.question import QuestionAdminInline
-from apps.quiz.admin.participant import QuizParticipantInline
-from utils.admin import project_admin_site, admin_url_generator
-
-
-class QuizAdmin(ModelAdmin):
- search_fields = ['title', 'description']
- list_display = ['title_display', 'description_display', 'lesson', 'each_question_timing', 'status_display', 'questions_display']
- list_filter = ['each_question_timing', 'status']
- inlines = [QuestionAdminInline, QuizParticipantInline]
- compressed_fields = True
-
- # 🔔 ADD THE TOP ACTION BUTTON
- actions_detail = ['manage_all_participants','go_to_course']
-
- def get_queryset(self, request):
- queryset = super().get_queryset(request).annotate(
- questions_count=Count('questions')
- )
-
- # اولویت اول: staff یا admin - دسترسی کامل
- if (request.user.is_staff or
- request.user.has_role('admin') or
- request.user.has_role('super_admin')):
- return queryset
-
- # اولویت دوم: professor - فقط کوئیزهای دورههای خود
- if request.user.has_role('professor'):
- return queryset.filter(lesson__course__professors=request.user)
-
- return queryset.none()
-
- def _find_matching_course_ids(self, search_term):
- normalized = (search_term or "").strip().lower()
- if not normalized:
- return []
-
- matching_ids = list(
- Course.objects.filter(
- Q(title__icontains=search_term) | Q(slug__icontains=search_term)
- ).values_list("id", flat=True)
- )
-
- if matching_ids:
- return matching_ids
-
- for course in Course.objects.all().only("id", "title", "slug"):
- title_text = extract_text_from_json(course.title).lower()
- slug_text = extract_text_from_json(course.slug).lower()
- if normalized in title_text or normalized in slug_text:
- matching_ids.append(course.id)
-
- return matching_ids
-
- def _find_matching_lesson_ids(self, search_term):
- normalized = (search_term or "").strip().lower()
- if not normalized:
- return []
-
- matching_ids = []
- for lesson in CourseLesson.objects.select_related("lesson").all():
- lesson_title = extract_text_from_json(
- lesson.title or (lesson.lesson.title if lesson.lesson else [])
- ).lower()
- if normalized in lesson_title:
- matching_ids.append(lesson.id)
-
- return matching_ids
-
- def get_exclude(self, request, obj=None):
- if not obj: # اگر obj وجود ندارد یعنی صفحه Add است
- return ['course']
- return []
-
- # 🔔 قفل کردن (Readonly) فیلد کورس در زمان مشاهده و ویرایش
- def get_readonly_fields(self, request, obj=None):
- if obj: # اگر obj وجود دارد یعنی صفحه Change/Detail است
- return ['course']
- return []
-
- def get_form(self, request, obj=None, **kwargs):
- form = super().get_form(request, obj, **kwargs)
-
- # محدود کردن انتخاب lesson بر اساس سطح دسترسی کاربر
- if (request.user.is_staff or
- request.user.has_role('admin') or
- request.user.has_role('super_admin')):
- # اولویت اول: staff یا admin - دسترسی کامل
- form.base_fields['lesson'].queryset = CourseLesson.objects.all()
- elif request.user.has_role('professor'):
- # اولویت دوم: professor - فقط CourseLesson های دورههای خود
- form.base_fields['lesson'].queryset = CourseLesson.objects.filter(course__professors=request.user)
- else:
- # سایر کاربران - عدم دسترسی
- form.base_fields['lesson'].queryset = CourseLesson.objects.none()
-
- form.base_fields['lesson'].widget.can_add_related = False
-
- return form
-
- def get_search_results(self, request, queryset, search_term):
- queryset, use_distinct = super().get_search_results(request, queryset, search_term)
- matching_course_ids = self._find_matching_course_ids(search_term)
- matching_lesson_ids = self._find_matching_lesson_ids(search_term)
- matching_quiz_ids = []
-
- normalized = (search_term or "").strip().lower()
- if normalized:
- for quiz in self.model.objects.all().only("id", "title", "description"):
- title_text = extract_text_from_json(quiz.title).lower()
- description_text = extract_text_from_json(quiz.description).lower()
- if normalized in title_text or normalized in description_text:
- matching_quiz_ids.append(quiz.id)
-
- if matching_course_ids or matching_lesson_ids or matching_quiz_ids:
- queryset = queryset | self.model.objects.filter(
- Q(id__in=matching_quiz_ids) |
- Q(course_id__in=matching_course_ids) |
- Q(lesson_id__in=matching_lesson_ids)
- )
- use_distinct = True
-
- return queryset, use_distinct
-
- @display(description=_('Title'))
- def title_display(self, obj):
- return extract_text_from_json(obj.title)
-
- @display(description=_('Description'))
- def description_display(self, obj):
- return extract_text_from_json(obj.description)
-
- @display(description=_('Status'), ordering='status')
- def status_display(self, obj):
- if obj.status:
- return mark_safe(f'{_("Active")}')
- return mark_safe(f'{_("Inactive")}')
-
- @display(description=_('Questions'), ordering='questions_count')
- def questions_display(self, obj):
- url = reverse('admin:quiz_question_changelist') + f'?quiz={obj.id}'
- return mark_safe(f'{_("Questions")}: {obj.questions_count}')
-
- # 🔔 THE REDIRECT LOGIC FOR THE NEW BUTTON
- @action(
- description=_("Manage All Participants"),
- icon="groups",
- )
- def manage_all_participants(self, request, object_id):
- """Redirect to the pre-filtered Quiz Participant changelist for this quiz."""
- quiz = self.get_object(request, object_id)
- if not quiz:
- messages.error(request, _("Quiz not found"))
- return redirect(admin_url_generator(request, "quiz_quiz_changelist"))
-
- # Generate base URL for quiz participant list
- base_url = admin_url_generator(request, "quiz_quizparticipant_changelist")
-
- # Append the filter query parameter
- url = f"{base_url}?quiz__id__exact={object_id}"
- return redirect(url)
-
- @action(
- description=_("View Course"),
- icon="school", # آیکون کلاه فارغالتحصیلی
- )
- def go_to_course(self, request, object_id):
- """دکمهای برای رفتن به صفحه جزئیات کورسِ این کوییز"""
- quiz = self.get_object(request, object_id)
-
- # پیدا کردن کورس از طریق درس (Lesson)
- if quiz and quiz.lesson and quiz.lesson.course_id:
- url = reverse('admin:course_course_change', args=[quiz.lesson.course_id])
- return redirect(url)
-
- messages.error(request, _("Course not found for this quiz."))
- return redirect(request.META.get('HTTP_REFERER', '/'))
-
-project_admin_site.register(Quiz, QuizAdmin)
diff --git a/apps/quiz/admin/user_rank_quiz.py b/apps/quiz/admin/user_rank_quiz.py
deleted file mode 100644
index e6b988d..0000000
--- a/apps/quiz/admin/user_rank_quiz.py
+++ /dev/null
@@ -1,132 +0,0 @@
-# import calendar
-# from django.utils import timezone
-
-# from ajaxdatatable.admin import AjaxDatatable
-# from django.contrib import admin
-# from django.utils.translation import gettext_lazy as _
-# from django.contrib.admin import SimpleListFilter
-# from django.db.models.functions import Rank, Coalesce
-# from django.db.models import Sum, F, Window, CharField
-# from django.utils.html import format_html
-# from apps.quiz.models import Quiz, QuizRankUser, Participant, QuizCategory
-# from apps.account.models import User
-
-
-# class QuizFilter(SimpleListFilter):
-# title = _('Quiz')
-# parameter_name = 'quiz'
-
-# def lookups(self, request, model_admin):
-# quizzes = Quiz.objects.all()
-# return [(quiz.id, quiz.video.title) for quiz in quizzes]
-
-# def queryset(self, request, queryset):
-# if self.value():
-# return queryset.filter(uquizzes__quiz__id=self.value())
-# return queryset
-
-# class QuizCategoryFilter(SimpleListFilter):
-# title = _('Quiz Category')
-# parameter_name = 'quiz_category'
-
-# def lookups(self, request, model_admin):
-# categories = QuizCategory.objects.all()
-# return [(category.id, category.name) for category in categories]
-
-# def queryset(self, request, queryset):
-# if self.value():
-# return queryset.filter(uquizzes__quiz__category__id=self.value())
-# return queryset
-
-# class MonthFilter(SimpleListFilter):
-# title = _('Month')
-# parameter_name = 'month'
-
-# def lookups(self, request, model_admin):
-# return [(str(i), calendar.month_name[i]) for i in range(1, 13)]
-
-# def queryset(self, request, queryset):
-# if self.value():
-# month = int(self.value())
-# year = timezone.now().year
-# return queryset.filter(uquizzes__started_at__year=year, uquizzes__started_at__month=month)
-# return queryset
-
-
-# @admin.register(QuizRankUser)
-# class QuizRankUserAdmin(AjaxDatatable):
-# list_display = ('username_link', 'get_total_score', 'get_rank')
-# list_filter = (QuizFilter, QuizCategoryFilter, MonthFilter)
-# readonly_fields = ('date_joined', 'last_login')
-
-
-# def get_queryset(self, request):
-# queryset = super().get_queryset(request)
-
-# quiz_id = request.GET.get('quiz')
-# category_id = request.GET.get('quiz_category')
-# month = request.GET.get('month')
-
-# filters = {}
-# if quiz_id:
-# filters['uquizzes__quiz_id'] = quiz_id
-# if category_id:
-# filters['uquizzes__quiz__category_id'] = category_id
-# if month:
-# month = int(month)
-# year = timezone.now().year
-# filters['uquizzes__started_at__year'] = year
-# filters['uquizzes__started_at__month'] = month
-
-# if filters:
-# queryset = queryset.filter(**filters)
-
-# users_scores = Participant.objects.filter(**{k.replace('uquizzes__', ''): v for k, v in filters.items()}).select_related('user').values(
-# username=Coalesce(F('user__username'), F('user__email'), output_field=CharField())
-# ).annotate(
-# score=Sum('total_score')
-# ).order_by('-score')
-
-# # Add rank to each user using window function
-# users_scores = users_scores.annotate(
-# rank=Window(
-# expression=Rank(),
-# order_by=F('score').desc()
-# )
-# ).order_by("rank")
-
-# user_scores_dict = {user['username']: user for user in users_scores}
-# for user in queryset:
-# user.score = user_scores_dict.get(user.username, {}).get('score', 0)
-# user.rank = user_scores_dict.get(user.username, {}).get('rank', 'N/A')
-# self.queryset = queryset
-# return queryset
-
-# def has_view_permission(self, request, obj=None):
-# return True
-
-# def has_change_permission(self, request, obj=None):
-# return False
-
-# def has_add_permission(self, request):
-# return False
-
-# def has_delete_permission(self, request, obj=None):
-# return False
-
-# def username_link(self, obj):
-# return format_html('{}', obj.id, obj.username)
-# username_link.short_description = 'Username'
-# username_link.admin_order_field = 'username'
-
-# def get_total_score(self, obj):
-# for user in self.queryset:
-# if user.id == obj.id:
-# return user.score
-# get_total_score.short_description = 'Total Score'
-
-# def get_rank(self, obj):
-# for user in self.queryset:
-# if user.id == obj.id:
-# return user.rank
-# get_rank.short_description = 'Rank'
diff --git a/apps/quiz/apps.py b/apps/quiz/apps.py
deleted file mode 100644
index 519127d..0000000
--- a/apps/quiz/apps.py
+++ /dev/null
@@ -1,6 +0,0 @@
-from django.apps import AppConfig
-
-
-class QuizConfig(AppConfig):
- default_auto_field = 'django.db.models.BigAutoField'
- name = 'apps.quiz'
diff --git a/apps/quiz/doc.py b/apps/quiz/doc.py
deleted file mode 100644
index 7099d7e..0000000
--- a/apps/quiz/doc.py
+++ /dev/null
@@ -1,131 +0,0 @@
-def doc_quiz_submit():
- return """
-# 📝 ارسال پاسخهای کوییز
-
-این API برای ثبت شرکت کاربر در کوییز و ارسال پاسخهای مربوطه استفاده میشود. زمانی که کاربر در کوییز شرکت میکند، باید به همراه پاسخهای خود، زمان پاسخدهی و اطلاعات دیگر را ارسال نماید. در این API، کاربر نمیتواند دوباره در همان کوییز شرکت کند.
-
----
-
-## 📄 توضیحات مقادیر پاسخ
-
-| کلید | نوع داده | توضیحات |
-|------------------------|-----------------|---------------------------------------------------------|
-| `quiz` | Integer | شناسه کوییز که کاربر در آن شرکت کرده است. |
-| `started_at` | DateTime | زمان شروع کوییز. |
-| `ended_at` | DateTime | زمان پایان کوییز. |
-| `total_timing` | Integer | مدت زمان کلی که کاربر برای پاسخدهی به کوییز صرف کرده است.|
-| `question_score` | Integer | امتیاز بهدستآمده توسط کاربر در پاسخ به سوالات کوییز. |
-| `timing_score` | Integer | امتیاز بهدستآمده توسط کاربر بر اساس زمان پاسخدهی. |
-| `total_score` | Integer | امتیاز کلی کاربر در کوییز (ترکیب امتیاز سوالات و زمان).|
-| `answers` | Array | لیستی از پاسخهای کاربر به سوالات. |
-| `answers.question` | Integer | شناسه سوالی که کاربر به آن پاسخ داده است. |
-| `answers.option_num` | Integer | شماره گزینهای که کاربر انتخاب کرده است. |
-| `answers.at_time` | DateTime | زمانی که کاربر پاسخ به سوال را ارسال کرده است. |
-| `answers.answer_timing`| Integer | مدت زمان پاسخدهی به سوال (در ثانیه). |
-
----
-## errors:
-# کاربر از قبل کوعیز را شرکت کرده است
-```json
-{
- "status": "error",
- "code": "validation_error",
- "status_code": 400,
- "message": "There were validation errors.",
- "errors": [
- {
- "field": "quiz",
- "message": "you have already participated in the quiz"
- }
- ]
-}
-```
-
----
-## پاسخ موفق (201 Created)
-
-در صورتی که ثبتنام موفقیتآمیز باشد و پاسخها ذخیره شوند، یک شیء JSON مشابه با نمونه زیر برگشت داده میشود:
-
-### پاسخ:
-```json
-{
- "quiz": 1,
- "started_at": "2024-11-29T12:00:00Z",
- "ended_at": "2024-11-29T12:30:00Z",
- "total_timing": 1800,
- "question_score": 80,
- "timing_score": 10,
- "total_score": 90,
- "answers": [
- {
- "question": 1,
- "option_num": 3,
- "at_time": "2024-11-29T12:05:00Z",
- "answer_timing": 30
- },
- {
- "question": 2,
- "option_num": 1,
- "at_time": "2024-11-29T12:15:00Z",
- "answer_timing": 45
- }
- ]
-}
-"""
-
-def doc_quiz_detail():
- return """
-# 📋 Quiz Detail API
-
-با ایدی درس میتواند وارد یک کوعیز شوید
-این api
-سوالات کوعیز و جزعیاتش را برمیگرداند
-
-
-## URL
-`GET /path//`
-
-## پارامترها
-
-- `lesson_id`: شناسه درس برای دریافت کوییز مرتبط.
-
-## پاسخ موفق (200 OK)
-
-در صورتی که درس دارای کوییز باشد، یک شیء JSON با اطلاعات کوییز برگشت داده میشود.
-
-### پاسخ:
-
-```json
-{
- "id": 1,
- "permission": true,
- "lesson": 101,
- "title": "Quiz on Python Basics",
- "description": "A quiz on the basics of Python programming.",
- "each_question_timing": 30,
- "questions": [
- {
- "id": 1,
- "question": "What is the output of print(2 + 3)?",
- "options": [
- {"id": 1, "title": "5"},
- {"id": 2, "title": "6"},
- {"id": 3, "title": "7"},
- {"id": 4, "title": "8"}
- ],
- "correct_answer": 1
- },
- {
- "id": 2,
- "question": "What is the result of 2 * 3?",
- "options": [
- {"id": 1, "title": "6"},
- {"id": 2, "title": "5"},
- {"id": 3, "title": "7"},
- {"id": 4, "title": "8"}
- ],
- "correct_answer": 1
- }
- ]
-}
-"""
diff --git a/apps/quiz/management/__init__.py b/apps/quiz/management/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/quiz/management/commands/__init__.py b/apps/quiz/management/commands/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/quiz/management/commands/clear_quiz_data.py b/apps/quiz/management/commands/clear_quiz_data.py
deleted file mode 100644
index c3a0192..0000000
--- a/apps/quiz/management/commands/clear_quiz_data.py
+++ /dev/null
@@ -1,78 +0,0 @@
-from django.core.management.base import BaseCommand
-from django.db import transaction
-
-from apps.quiz.models import Quiz, Question, QuizParticipant, ParticipantAnswer
-
-
-class Command(BaseCommand):
- help = 'Clear all quiz-related data from the database'
-
- def add_arguments(self, parser):
- parser.add_argument(
- '--confirm',
- action='store_true',
- help='Confirm that you want to delete all quiz data',
- )
-
- def handle(self, *args, **options):
- if not options['confirm']:
- self.stdout.write(
- self.style.WARNING(
- 'This command will delete ALL quiz-related data from the database!\n'
- 'This includes:\n'
- '- All Quizzes\n'
- '- All Questions\n'
- '- All Quiz Participants\n'
- '- All Participant Answers\n\n'
- 'Use --confirm flag to proceed with deletion.\n'
- 'Example: python manage.py clear_quiz_data --confirm'
- )
- )
- return
-
- try:
- with transaction.atomic():
- # Count records before deletion
- participant_answers_count = ParticipantAnswer.objects.count()
- quiz_participants_count = QuizParticipant.objects.count()
- questions_count = Question.objects.count()
- quizzes_count = Quiz.objects.count()
-
- self.stdout.write(
- f'Found {participant_answers_count} participant answers, '
- f'{quiz_participants_count} quiz participants, '
- f'{questions_count} questions, and '
- f'{quizzes_count} quizzes.'
- )
-
- # Delete in order to respect foreign key constraints
- # ParticipantAnswer -> QuizParticipant -> Quiz
- # Question -> Quiz
-
- self.stdout.write('Deleting participant answers...')
- ParticipantAnswer.objects.all().delete()
-
- self.stdout.write('Deleting quiz participants...')
- QuizParticipant.objects.all().delete()
-
- self.stdout.write('Deleting questions...')
- Question.objects.all().delete()
-
- self.stdout.write('Deleting quizzes...')
- Quiz.objects.all().delete()
-
- self.stdout.write(
- self.style.SUCCESS(
- f'Successfully deleted all quiz data:\n'
- f'- {participant_answers_count} participant answers\n'
- f'- {quiz_participants_count} quiz participants\n'
- f'- {questions_count} questions\n'
- f'- {quizzes_count} quizzes'
- )
- )
-
- except Exception as e:
- self.stdout.write(
- self.style.ERROR(f'Error occurred while clearing quiz data: {str(e)}')
- )
- raise
\ No newline at end of file
diff --git a/apps/quiz/migrations/0001_initial.py b/apps/quiz/migrations/0001_initial.py
deleted file mode 100644
index a496dba..0000000
--- a/apps/quiz/migrations/0001_initial.py
+++ /dev/null
@@ -1,220 +0,0 @@
-# Generated by Django 4.2.27 on 2026-01-22 10:48
-
-from django.conf import settings
-from django.db import migrations, models
-import django.db.models.deletion
-
-
-class Migration(migrations.Migration):
- initial = True
-
- dependencies = [
- migrations.swappable_dependency(settings.AUTH_USER_MODEL),
- ("course", "0001_initial"),
- ("account", "0001_initial"),
- ]
-
- operations = [
- migrations.CreateModel(
- name="Quiz",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- (
- "title",
- models.CharField(
- help_text="Quiz Title", max_length=255, verbose_name="title"
- ),
- ),
- (
- "description",
- models.CharField(
- blank=True, max_length=55, null=True, verbose_name="Description"
- ),
- ),
- ("each_question_timing", models.PositiveIntegerField()),
- ("status", models.BooleanField(default=True)),
- (
- "lesson",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="quizzes",
- to="course.courselesson",
- verbose_name="lesson",
- ),
- ),
- ],
- options={
- "verbose_name": "Quiz",
- "verbose_name_plural": "Quizzes",
- "ordering": ("-id",),
- },
- ),
- migrations.CreateModel(
- name="QuizRankUser",
- fields=[],
- options={
- "verbose_name": "Rank Quiz",
- "verbose_name_plural": "Rank Quizzes",
- "proxy": True,
- "indexes": [],
- "constraints": [],
- },
- bases=("account.user",),
- ),
- migrations.CreateModel(
- name="QuizParticipant",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- ("started_at", models.DateTimeField(verbose_name="started at")),
- ("ended_at", models.DateTimeField(verbose_name="ended at")),
- (
- "total_timing",
- models.PositiveIntegerField(
- help_text="Seconds take to finish the quiz"
- ),
- ),
- ("question_score", models.PositiveIntegerField()),
- ("timing_score", models.PositiveIntegerField()),
- ("total_score", models.PositiveIntegerField()),
- (
- "quiz",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="participants",
- to="quiz.quiz",
- ),
- ),
- (
- "user",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="uquizzes",
- to=settings.AUTH_USER_MODEL,
- verbose_name="user",
- ),
- ),
- ],
- options={
- "verbose_name": "Participant",
- "verbose_name_plural": "Participants",
- "ordering": ("-id",),
- },
- ),
- migrations.CreateModel(
- name="Question",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- ("question", models.CharField(max_length=255)),
- ("option1", models.CharField(max_length=255, verbose_name="option 1")),
- ("option2", models.CharField(max_length=255, verbose_name="option 2")),
- ("option3", models.CharField(max_length=255, verbose_name="option 3")),
- ("option4", models.CharField(max_length=255, verbose_name="option 4")),
- (
- "correct_answer",
- models.PositiveSmallIntegerField(
- choices=[
- (1, "Option 1"),
- (2, "Option 2"),
- (3, "Option 3"),
- (4, "Option 4"),
- ]
- ),
- ),
- (
- "created_at",
- models.DateTimeField(auto_now_add=True, verbose_name="created at"),
- ),
- ("priority", models.IntegerField(blank=True, null=True)),
- (
- "quiz",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="questions",
- to="quiz.quiz",
- verbose_name="quiz",
- ),
- ),
- ],
- options={
- "verbose_name": "Question",
- "verbose_name_plural": "Questions",
- "ordering": ("-priority", "-id"),
- },
- ),
- migrations.CreateModel(
- name="ParticipantAnswer",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- (
- "option_num",
- models.PositiveSmallIntegerField(
- choices=[
- (1, "Option 1"),
- (2, "Option 2"),
- (3, "Option 3"),
- (4, "Option 4"),
- ],
- verbose_name="selected option",
- ),
- ),
- ("at_time", models.DateTimeField()),
- (
- "answer_timing",
- models.PositiveSmallIntegerField(
- default=0, verbose_name="seconds take to answer"
- ),
- ),
- (
- "participant",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="answers",
- to="quiz.quizparticipant",
- ),
- ),
- (
- "question",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE, to="quiz.question"
- ),
- ),
- ],
- options={
- "verbose_name": "User Quiz Answer",
- "verbose_name_plural": "User Quiz Answers",
- "ordering": ("-id",),
- },
- ),
- ]
diff --git a/apps/quiz/migrations/0002_alter_participantanswer_answer_timing_and_more.py b/apps/quiz/migrations/0002_alter_participantanswer_answer_timing_and_more.py
deleted file mode 100644
index 173ff55..0000000
--- a/apps/quiz/migrations/0002_alter_participantanswer_answer_timing_and_more.py
+++ /dev/null
@@ -1,147 +0,0 @@
-# Generated by Django 5.2.12 on 2026-05-03 14:09
-
-import django.db.models.deletion
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('course', '0004_alter_lessoncompletion_options_and_more'),
- ('quiz', '0001_initial'),
- migrations.swappable_dependency(settings.AUTH_USER_MODEL),
- ]
-
- operations = [
- migrations.AlterField(
- model_name='participantanswer',
- name='answer_timing',
- field=models.PositiveSmallIntegerField(default=0, verbose_name='Seconds Take to Answer'),
- ),
- migrations.AlterField(
- model_name='participantanswer',
- name='at_time',
- field=models.DateTimeField(verbose_name='At Time'),
- ),
- migrations.AlterField(
- model_name='participantanswer',
- name='option_num',
- field=models.PositiveSmallIntegerField(choices=[(1, 'Option 1'), (2, 'Option 2'), (3, 'Option 3'), (4, 'Option 4')], verbose_name='Selected Option'),
- ),
- migrations.AlterField(
- model_name='participantanswer',
- name='participant',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='answers', to='quiz.quizparticipant', verbose_name='Participant'),
- ),
- migrations.AlterField(
- model_name='participantanswer',
- name='question',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='quiz.question', verbose_name='Question'),
- ),
- migrations.AlterField(
- model_name='question',
- name='correct_answer',
- field=models.PositiveSmallIntegerField(choices=[(1, 'Option 1'), (2, 'Option 2'), (3, 'Option 3'), (4, 'Option 4')], verbose_name='Correct Answer'),
- ),
- migrations.AlterField(
- model_name='question',
- name='created_at',
- field=models.DateTimeField(auto_now_add=True, verbose_name='Created At'),
- ),
- migrations.AlterField(
- model_name='question',
- name='option1',
- field=models.CharField(max_length=255, verbose_name='Option 1'),
- ),
- migrations.AlterField(
- model_name='question',
- name='option2',
- field=models.CharField(max_length=255, verbose_name='Option 2'),
- ),
- migrations.AlterField(
- model_name='question',
- name='option3',
- field=models.CharField(max_length=255, verbose_name='Option 3'),
- ),
- migrations.AlterField(
- model_name='question',
- name='option4',
- field=models.CharField(max_length=255, verbose_name='Option 4'),
- ),
- migrations.AlterField(
- model_name='question',
- name='priority',
- field=models.IntegerField(blank=True, null=True, verbose_name='Priority'),
- ),
- migrations.AlterField(
- model_name='question',
- name='question',
- field=models.CharField(max_length=255, verbose_name='Question'),
- ),
- migrations.AlterField(
- model_name='question',
- name='quiz',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='questions', to='quiz.quiz', verbose_name='Quiz'),
- ),
- migrations.AlterField(
- model_name='quiz',
- name='each_question_timing',
- field=models.PositiveIntegerField(verbose_name='Each Question Timing'),
- ),
- migrations.AlterField(
- model_name='quiz',
- name='lesson',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='quizzes', to='course.courselesson', verbose_name='Lesson'),
- ),
- migrations.AlterField(
- model_name='quiz',
- name='status',
- field=models.BooleanField(default=True, verbose_name='Status'),
- ),
- migrations.AlterField(
- model_name='quiz',
- name='title',
- field=models.CharField(help_text='Quiz Title', max_length=255, verbose_name='Title'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='ended_at',
- field=models.DateTimeField(verbose_name='Ended At'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='question_score',
- field=models.PositiveIntegerField(verbose_name='Question Score'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='quiz',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='participants', to='quiz.quiz', verbose_name='Quiz'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='started_at',
- field=models.DateTimeField(verbose_name='Started At'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='timing_score',
- field=models.PositiveIntegerField(verbose_name='Timing Score'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='total_score',
- field=models.PositiveIntegerField(verbose_name='Total Score'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='total_timing',
- field=models.PositiveIntegerField(help_text='Seconds take to finish the quiz', verbose_name='Total Timing'),
- ),
- migrations.AlterField(
- model_name='quizparticipant',
- name='user',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='uquizzes', to=settings.AUTH_USER_MODEL, verbose_name='User'),
- ),
- ]
diff --git a/apps/quiz/migrations/0003_quiz_course.py b/apps/quiz/migrations/0003_quiz_course.py
deleted file mode 100644
index ba5c3ae..0000000
--- a/apps/quiz/migrations/0003_quiz_course.py
+++ /dev/null
@@ -1,20 +0,0 @@
-# Generated by Django 5.2.12 on 2026-05-16 15:01
-
-import django.db.models.deletion
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('course', '0006_alter_course_professor_alter_course_video_file_and_more'),
- ('quiz', '0002_alter_participantanswer_answer_timing_and_more'),
- ]
-
- operations = [
- migrations.AddField(
- model_name='quiz',
- name='course',
- field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='quizzes', to='course.course', verbose_name='Course'),
- ),
- ]
diff --git a/apps/quiz/migrations/0004_alter_question_options.py b/apps/quiz/migrations/0004_alter_question_options.py
deleted file mode 100644
index 9aa00e0..0000000
--- a/apps/quiz/migrations/0004_alter_question_options.py
+++ /dev/null
@@ -1,17 +0,0 @@
-# Generated by Django 5.2.12 on 2026-06-01 15:39
-
-from django.db import migrations
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('quiz', '0003_quiz_course'),
- ]
-
- operations = [
- migrations.AlterModelOptions(
- name='question',
- options={'ordering': ('priority', 'id'), 'verbose_name': 'Question', 'verbose_name_plural': 'Questions'},
- ),
- ]
diff --git a/apps/quiz/migrations/0005_multilingual_quiz_fields.py b/apps/quiz/migrations/0005_multilingual_quiz_fields.py
deleted file mode 100644
index 449ba27..0000000
--- a/apps/quiz/migrations/0005_multilingual_quiz_fields.py
+++ /dev/null
@@ -1,137 +0,0 @@
-# Generated by Codex on 2026-06-11
-
-from django.db import migrations, models
-
-
-def _is_multilingual_list(value):
- return isinstance(value, list) and all(
- isinstance(item, dict) and item.get("language_code")
- for item in value
- )
-
-
-def _normalize_multilingual(value):
- if value in (None, "", []):
- return []
-
- if _is_multilingual_list(value):
- normalized_items = []
- for item in value:
- title = item.get("title") or item.get("text") or item.get("value") or item.get("name")
- language_code = item.get("language_code") or "en"
- if title:
- normalized_items.append({"title": title, "language_code": language_code})
- return normalized_items
-
- if isinstance(value, dict):
- language_map_keys = {"fa", "en", "ru", "ar", "tr"}
- if any(key in value for key in language_map_keys):
- return [
- {"title": title, "language_code": language_code}
- for language_code, title in value.items()
- if title
- ]
-
- title = value.get("title") or value.get("text") or value.get("value") or value.get("name")
- language_code = value.get("language_code") or "en"
- return [{"title": title, "language_code": language_code}] if title else []
-
- if isinstance(value, list):
- normalized_items = []
- for item in value:
- if isinstance(item, dict):
- title = item.get("title") or item.get("text") or item.get("value") or item.get("name")
- language_code = item.get("language_code") or "en"
- if title:
- normalized_items.append({"title": title, "language_code": language_code})
- elif item not in (None, ""):
- normalized_items.append({"title": str(item), "language_code": "en"})
- return normalized_items
-
- return [{"title": str(value), "language_code": "en"}]
-
-
-def forwards(apps, schema_editor):
- Quiz = apps.get_model("quiz", "Quiz")
- Question = apps.get_model("quiz", "Question")
-
- for quiz in Quiz.objects.all().iterator():
- quiz.title_i18n = _normalize_multilingual(quiz.title)
- quiz.description_i18n = _normalize_multilingual(quiz.description)
- quiz.save(update_fields=["title_i18n", "description_i18n"])
-
- for question in Question.objects.all().iterator():
- question.question_i18n = _normalize_multilingual(question.question)
- question.option1_i18n = _normalize_multilingual(question.option1)
- question.option2_i18n = _normalize_multilingual(question.option2)
- question.option3_i18n = _normalize_multilingual(question.option3)
- question.option4_i18n = _normalize_multilingual(question.option4)
- question.save(
- update_fields=[
- "question_i18n",
- "option1_i18n",
- "option2_i18n",
- "option3_i18n",
- "option4_i18n",
- ]
- )
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ("quiz", "0004_alter_question_options"),
- ]
-
- operations = [
- migrations.AddField(
- model_name="quiz",
- name="title_i18n",
- field=models.JSONField(default=list, help_text="Quiz Title", verbose_name="Title"),
- ),
- migrations.AddField(
- model_name="quiz",
- name="description_i18n",
- field=models.JSONField(blank=True, default=list, verbose_name="Description"),
- ),
- migrations.AddField(
- model_name="question",
- name="question_i18n",
- field=models.JSONField(default=list, verbose_name="Question"),
- ),
- migrations.AddField(
- model_name="question",
- name="option1_i18n",
- field=models.JSONField(default=list, verbose_name="Option 1"),
- ),
- migrations.AddField(
- model_name="question",
- name="option2_i18n",
- field=models.JSONField(default=list, verbose_name="Option 2"),
- ),
- migrations.AddField(
- model_name="question",
- name="option3_i18n",
- field=models.JSONField(default=list, verbose_name="Option 3"),
- ),
- migrations.AddField(
- model_name="question",
- name="option4_i18n",
- field=models.JSONField(default=list, verbose_name="Option 4"),
- ),
- migrations.RunPython(forwards, migrations.RunPython.noop),
- migrations.RemoveField(model_name="quiz", name="title"),
- migrations.RemoveField(model_name="quiz", name="description"),
- migrations.RemoveField(model_name="question", name="question"),
- migrations.RemoveField(model_name="question", name="option1"),
- migrations.RemoveField(model_name="question", name="option2"),
- migrations.RemoveField(model_name="question", name="option3"),
- migrations.RemoveField(model_name="question", name="option4"),
- migrations.RenameField(model_name="quiz", old_name="title_i18n", new_name="title"),
- migrations.RenameField(model_name="quiz", old_name="description_i18n", new_name="description"),
- migrations.RenameField(model_name="question", old_name="question_i18n", new_name="question"),
- migrations.RenameField(model_name="question", old_name="option1_i18n", new_name="option1"),
- migrations.RenameField(model_name="question", old_name="option2_i18n", new_name="option2"),
- migrations.RenameField(model_name="question", old_name="option3_i18n", new_name="option3"),
- migrations.RenameField(model_name="question", old_name="option4_i18n", new_name="option4"),
- ]
diff --git a/apps/quiz/migrations/0006_quiz_lesson_number_alter_quiz_lesson.py b/apps/quiz/migrations/0006_quiz_lesson_number_alter_quiz_lesson.py
deleted file mode 100644
index 6c5e13b..0000000
--- a/apps/quiz/migrations/0006_quiz_lesson_number_alter_quiz_lesson.py
+++ /dev/null
@@ -1,25 +0,0 @@
-# Generated by Django 5.2.12 on 2026-06-16 16:32
-
-import django.db.models.deletion
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('course', '0015_rename_course_cour_ended_a_0f47b4_idx_course_cour_ended_a_32eaaa_idx_and_more'),
- ('quiz', '0005_multilingual_quiz_fields'),
- ]
-
- operations = [
- migrations.AddField(
- model_name='quiz',
- name='lesson_number',
- field=models.PositiveIntegerField(default=0, verbose_name='Lesson Number'),
- ),
- migrations.AlterField(
- model_name='quiz',
- name='lesson',
- field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='quizzes', to='course.courselesson', verbose_name='Lesson'),
- ),
- ]
diff --git a/apps/quiz/migrations/__init__.py b/apps/quiz/migrations/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/quiz/models/__init__.py b/apps/quiz/models/__init__.py
deleted file mode 100644
index 16a10f1..0000000
--- a/apps/quiz/models/__init__.py
+++ /dev/null
@@ -1,2 +0,0 @@
-from .quiz import *
-from .participant import *
\ No newline at end of file
diff --git a/apps/quiz/models/participant.py b/apps/quiz/models/participant.py
deleted file mode 100644
index f2a46da..0000000
--- a/apps/quiz/models/participant.py
+++ /dev/null
@@ -1,68 +0,0 @@
-from django.db import models
-from django.db.models import F, Window
-from django.db.models.functions import Rank
-from django.utils.translation import gettext_lazy as _
-
-from apps.account.models import User
-
-
-class QuizParticipant(models.Model):
- quiz = models.ForeignKey('quiz.Quiz', on_delete=models.CASCADE, related_name='participants', verbose_name=_('Quiz'))
- user = models.ForeignKey('account.User', on_delete=models.CASCADE, verbose_name=_('User'), related_name='uquizzes')
- started_at = models.DateTimeField(verbose_name=_('Started At'))
- ended_at = models.DateTimeField(verbose_name=_('Ended At'))
- total_timing = models.PositiveIntegerField(verbose_name=_('Total Timing'), help_text=_('Seconds take to finish the quiz'))
-
- question_score = models.PositiveIntegerField(verbose_name=_('Question Score'))
- timing_score = models.PositiveIntegerField(verbose_name=_('Timing Score'))
- total_score = models.PositiveIntegerField(verbose_name=_('Total Score'))
-
- class Meta:
- verbose_name = _("Participant")
- verbose_name_plural = _("Participants")
- ordering = ("-id",)
-
- def __str__(self):
- return f"Participant: {self.id}, ParticipantName: {self.user}, Quiz: {self.quiz.id}"
-
- def __repr__(self):
- return f"Participant(id={self.id})"
-
-
- @staticmethod
- def get_user_ranks(quiz_id):
- return QuizParticipant.objects.filter(quiz_id=quiz_id).annotate(
- rank=Window(
- expression=Rank(),
- order_by=F('total_score').desc()
- )
- )
-
-
-class ParticipantAnswer(models.Model):
- CHOICES = [
- (1, _('Option 1')),
- (2, _('Option 2')),
- (3, _('Option 3')),
- (4, _('Option 4')),
- ]
-
- participant = models.ForeignKey(QuizParticipant, on_delete=models.CASCADE, related_name='answers', verbose_name=_('Participant'))
- question = models.ForeignKey("quiz.Question", on_delete=models.CASCADE, verbose_name=_('Question'))
- option_num = models.PositiveSmallIntegerField(choices=CHOICES, verbose_name=_('Selected Option'))
- at_time = models.DateTimeField(verbose_name=_('At Time'))
- answer_timing = models.PositiveSmallIntegerField(default=0, verbose_name=_('Seconds Take to Answer'))
-
-
- class Meta:
- verbose_name = _("User Quiz Answer")
- verbose_name_plural = _("User Quiz Answers")
- ordering = ("-id",)
-
- def __str__(self):
- return f"Participant Answer: {self.id}"
-
- def __repr__(self):
- return f"ParticipantAnswer(id={self.id})"
-
-
diff --git a/apps/quiz/models/quiz.py b/apps/quiz/models/quiz.py
deleted file mode 100644
index 5cc1587..0000000
--- a/apps/quiz/models/quiz.py
+++ /dev/null
@@ -1,102 +0,0 @@
-from django.db import models
-from django.utils.translation import gettext_lazy as _
-from apps.account.models import User
-from apps.course.models.course import extract_text_from_json, format_multilingual_field
-
-
-
-class Quiz(models.Model):
- lesson = models.ForeignKey("course.CourseLesson", verbose_name=_('Lesson'), related_name='quizzes', on_delete=models.SET_NULL, null=True, blank=True)
- course = models.ForeignKey("course.Course", verbose_name=_('Course'), related_name='quizzes', on_delete=models.CASCADE , null=True, blank=True)
- lesson_number = models.PositiveIntegerField(default=0, verbose_name=_("Lesson Number"))
-
- title = models.JSONField(default=list, verbose_name=_('Title'), help_text=_("Quiz Title"))
- description = models.JSONField(default=list, blank=True, verbose_name=_("Description"))
- each_question_timing = models.PositiveIntegerField(verbose_name=_("Each Question Timing"))
- status = models.BooleanField(default=True, verbose_name=_("Status"))
-
-
- class Meta:
- verbose_name = _("Quiz")
- verbose_name_plural = _("Quizzes")
- ordering = ("-id",)
-
- def __str__(self):
- return f"Quiz: {self.id}"
-
- def __repr__(self):
- return f"Quiz(id={self.id})"
-
- @property
- def lesson_computed(self):
- if self.lesson_number and self.lesson_number > 0 and self.course_id:
- from apps.course.models import CourseLesson
- from django.db.models import Q
- lessons = list(CourseLesson.objects.filter(
- course_id=self.course_id,
- is_active=True
- ).filter(
- Q(chapter__isnull=True) | Q(chapter__is_active=True)
- ).order_by('chapter__priority', 'priority'))
- if len(lessons) >= self.lesson_number:
- return lessons[self.lesson_number - 1]
- return self.lesson
-
- def save(self, *args, **kwargs):
- # Automatically set the course based on the selected lesson
- if self.lesson_id and hasattr(self.lesson, 'course'):
- self.course = self.lesson.course
- self.title = format_multilingual_field(self.title)
- self.description = format_multilingual_field(self.description)
- super().save(*args, **kwargs)
-
-
-class Question(models.Model):
- CHOICES = [
- (1, _('Option 1')),
- (2, _('Option 2')),
- (3, _('Option 3')),
- (4, _('Option 4')),
- ]
-
- quiz = models.ForeignKey(Quiz, verbose_name=_('Quiz'), on_delete=models.CASCADE, related_name='questions')
- question = models.JSONField(default=list, verbose_name=_('Question'))
- option1 = models.JSONField(default=list, verbose_name=_('Option 1'))
- option2 = models.JSONField(default=list, verbose_name=_('Option 2'))
- option3 = models.JSONField(default=list, verbose_name=_('Option 3'))
- option4 = models.JSONField(default=list, verbose_name=_('Option 4'))
- correct_answer = models.PositiveSmallIntegerField(choices=CHOICES, verbose_name=_('Correct Answer'))
- created_at = models.DateTimeField(auto_now_add=True, verbose_name=_('Created At'))
- priority = models.IntegerField(null=True, blank=True, verbose_name=_('Priority'))
-
-
- class Meta:
- verbose_name = _("Question")
- verbose_name_plural = _("Questions")
- ordering = ("priority", "id",)
-
- def __str__(self):
- return extract_text_from_json(self.question)
-
- def __repr__(self):
- return f"Question(id={self.id})"
-
- def save(self, *args, **kwargs):
- if self.priority is None:
- max_priority = Question.objects.filter(quiz=self.quiz).aggregate(models.Max('priority'))['priority__max']
- self.priority = (max_priority or 0) + 1
- self.question = format_multilingual_field(self.question)
- self.option1 = format_multilingual_field(self.option1)
- self.option2 = format_multilingual_field(self.option2)
- self.option3 = format_multilingual_field(self.option3)
- self.option4 = format_multilingual_field(self.option4)
- super().save(*args, **kwargs)
-
-
-class QuizRankUser(User):
- class Meta:
- proxy = True
- verbose_name = _('Rank Quiz')
- verbose_name_plural = _('Rank Quizzes')
-
-
diff --git a/apps/quiz/serializers/__init__.py b/apps/quiz/serializers/__init__.py
deleted file mode 100644
index 16a10f1..0000000
--- a/apps/quiz/serializers/__init__.py
+++ /dev/null
@@ -1,2 +0,0 @@
-from .quiz import *
-from .participant import *
\ No newline at end of file
diff --git a/apps/quiz/serializers/admin.py b/apps/quiz/serializers/admin.py
deleted file mode 100644
index 4962329..0000000
--- a/apps/quiz/serializers/admin.py
+++ /dev/null
@@ -1,224 +0,0 @@
-from rest_framework import serializers
-from apps.quiz.models import Quiz, Question, QuizParticipant, ParticipantAnswer
-from apps.course.models import Course, CourseLesson
-from apps.account.models import User
-from apps.course.models.course import get_localized_field
-
-def get_request_lang(serializer_instance):
- request = serializer_instance.context.get('request')
- return getattr(request, 'LANGUAGE_CODE', None) or 'en'
-
-
-class AdminCourseSerializer(serializers.ModelSerializer):
- class Meta:
- model = Course
- fields = ['id', 'title']
-
- def to_representation(self, instance):
- ret = super().to_representation(instance)
- lang = get_request_lang(self)
- ret['title'] = get_localized_field(lang, instance.title)
- return ret
-
-
-class AdminCourseLessonSerializer(serializers.ModelSerializer):
- title = serializers.SerializerMethodField()
-
- class Meta:
- model = CourseLesson
- fields = ['id', 'title']
- ref_name = 'QuizAdminCourseLesson'
-
- def get_title(self, obj):
- lang = get_request_lang(self)
- raw_title = obj.title or (obj.lesson.title if obj.lesson else [])
- return get_localized_field(lang, raw_title)
-
-
-class AdminQuizListSerializer(serializers.ModelSerializer):
- questions_count = serializers.SerializerMethodField()
- participants_count = serializers.SerializerMethodField()
- course_title = serializers.SerializerMethodField()
- lesson_title = serializers.SerializerMethodField()
- title_i18n = serializers.JSONField(source='title', read_only=True)
- description_i18n = serializers.JSONField(source='description', read_only=True)
-
- class Meta:
- model = Quiz
- fields = [
- 'id',
- 'title',
- 'title_i18n',
- 'description',
- 'description_i18n',
- 'each_question_timing',
- 'status',
- 'course',
- 'course_title',
- 'lesson',
- 'lesson_number',
- 'lesson_title',
- 'questions_count',
- 'participants_count'
- ]
-
- def get_questions_count(self, obj):
- return obj.questions.count()
-
- def get_participants_count(self, obj):
- return obj.participants.count()
-
- def get_course_title(self, obj):
- if not obj.course:
- return None
- lang = get_request_lang(self)
- return get_localized_field(lang, obj.course.title)
-
- def get_lesson_title(self, obj):
- lesson = obj.lesson_computed
- if not lesson:
- return None
- lang = get_request_lang(self)
- raw_title = lesson.title or (lesson.lesson.title if lesson.lesson else None)
- return get_localized_field(lang, raw_title)
-
- def to_representation(self, instance):
- ret = super().to_representation(instance)
- lang = get_request_lang(self)
- ret['title'] = get_localized_field(lang, instance.title)
- ret['description'] = get_localized_field(lang, instance.description)
- computed = instance.lesson_computed
- ret['lesson'] = computed.id if computed else None
- return ret
-
-
-class AdminQuizDetailSerializer(serializers.ModelSerializer):
- questions_count = serializers.SerializerMethodField()
- participants_count = serializers.SerializerMethodField()
- course_title = serializers.SerializerMethodField()
- lesson_title = serializers.SerializerMethodField()
- title_i18n = serializers.JSONField(source='title', read_only=True)
- description_i18n = serializers.JSONField(source='description', read_only=True)
-
- class Meta:
- model = Quiz
- fields = [
- 'id',
- 'title',
- 'title_i18n',
- 'description',
- 'description_i18n',
- 'each_question_timing',
- 'status',
- 'course',
- 'course_title',
- 'lesson',
- 'lesson_number',
- 'lesson_title',
- 'questions_count',
- 'participants_count'
- ]
- read_only_fields = ['course_title', 'lesson_title', 'questions_count', 'participants_count']
-
- def get_questions_count(self, obj):
- return obj.questions.count()
-
- def get_participants_count(self, obj):
- return obj.participants.count()
-
- def get_course_title(self, obj):
- if not obj.course:
- return None
- lang = get_request_lang(self)
- return get_localized_field(lang, obj.course.title)
-
- def get_lesson_title(self, obj):
- lesson = obj.lesson_computed
- if not lesson:
- return None
- lang = get_request_lang(self)
- raw_title = lesson.title or (lesson.lesson.title if lesson.lesson else None)
- return get_localized_field(lang, raw_title)
-
- def to_representation(self, instance):
- ret = super().to_representation(instance)
- lang = get_request_lang(self)
- ret['title'] = get_localized_field(lang, instance.title)
- ret['description'] = get_localized_field(lang, instance.description)
- computed = instance.lesson_computed
- ret['lesson'] = computed.id if computed else None
- return ret
-
-
-class AdminQuestionSerializer(serializers.ModelSerializer):
- question_i18n = serializers.JSONField(source='question', read_only=True)
- option1_i18n = serializers.JSONField(source='option1', read_only=True)
- option2_i18n = serializers.JSONField(source='option2', read_only=True)
- option3_i18n = serializers.JSONField(source='option3', read_only=True)
- option4_i18n = serializers.JSONField(source='option4', read_only=True)
-
- class Meta:
- model = Question
- fields = [
- 'id',
- 'quiz',
- 'question',
- 'question_i18n',
- 'option1',
- 'option1_i18n',
- 'option2',
- 'option2_i18n',
- 'option3',
- 'option3_i18n',
- 'option4',
- 'option4_i18n',
- 'correct_answer',
- 'priority'
- ]
-
- def _get_localized_value(self, value):
- lang = get_request_lang(self)
- return get_localized_field(lang, value)
-
- def to_representation(self, instance):
- ret = super().to_representation(instance)
- ret['question'] = self._get_localized_value(instance.question)
- ret['option1'] = self._get_localized_value(instance.option1)
- ret['option2'] = self._get_localized_value(instance.option2)
- ret['option3'] = self._get_localized_value(instance.option3)
- ret['option4'] = self._get_localized_value(instance.option4)
- return ret
-
-
-class AdminParticipantAnswerSerializer(serializers.ModelSerializer):
- class Meta:
- model = ParticipantAnswer
- fields = ['id', 'question', 'option_num', 'at_time', 'answer_timing']
-
-
-class AdminQuizParticipantSerializer(serializers.ModelSerializer):
- user_name = serializers.CharField(source='user.fullname', read_only=True)
- user_email = serializers.EmailField(source='user.email', read_only=True)
- answers = AdminParticipantAnswerSerializer(many=True, read_only=True)
-
- class Meta:
- model = QuizParticipant
- fields = [
- 'id',
- 'user_id',
- 'user_name',
- 'user_email',
- 'started_at',
- 'ended_at',
- 'total_timing',
- 'question_score',
- 'timing_score',
- 'total_score',
- 'answers'
- ]
-
-
-class AdminQuizAbsenteeSerializer(serializers.ModelSerializer):
- class Meta:
- model = User
- fields = ['id', 'fullname', 'email']
diff --git a/apps/quiz/serializers/participant.py b/apps/quiz/serializers/participant.py
deleted file mode 100644
index 4635a12..0000000
--- a/apps/quiz/serializers/participant.py
+++ /dev/null
@@ -1,69 +0,0 @@
-from rest_framework import serializers
-
-from apps.course.access import user_has_course_access
-from apps.quiz.models import QuizParticipant, ParticipantAnswer
-
-
-class ParticipantAnswerSerializer(serializers.ModelSerializer):
- class Meta:
- model = ParticipantAnswer
- fields = ['question', 'option_num', 'at_time', 'answer_timing']
-
-
-
-class QuizParticipantSerializer(serializers.ModelSerializer):
- user = serializers.HiddenField(default=serializers.CurrentUserDefault())
- answers = ParticipantAnswerSerializer(many=True)
-
- def validate_quiz(self, obj):
- if QuizParticipant.objects.filter(quiz=obj, user=self.context['request'].user).exists():
- raise serializers.ValidationError('you have already participated in the quiz')
-
- course = getattr(obj, 'course', None)
- if course and not user_has_course_access(self.context['request'].user, course):
- raise serializers.ValidationError('you do not have access to this quiz')
-
- return obj
-
- class Meta:
- model = QuizParticipant
- fields = [
- 'quiz', 'user', 'started_at', 'ended_at', 'total_timing',
- 'question_score', 'timing_score', 'total_score',
- 'answers',
- ]
-
- def create(self, validated_data):
- answers = validated_data.pop('answers', [])
-
- quiz = validated_data.get('quiz')
- total_questions = quiz.questions.count()
- correct_count = 0
- questions_map = {q.id: q.correct_answer for q in quiz.questions.all()}
-
- for ans in answers:
- # Depending on if ans['question'] is an instance or ID
- q_id = ans.get('question').id if hasattr(ans.get('question'), 'id') else ans.get('question')
- option_num = ans.get('option_num')
- if q_id in questions_map and questions_map[q_id] == option_num:
- correct_count += 1
-
- question_score = round((correct_count / total_questions) * 100) if total_questions > 0 else 0
-
- validated_data['question_score'] = question_score
- validated_data['timing_score'] = 0
- validated_data['total_score'] = question_score
-
- obj = super().create(validated_data)
- answers_objs = []
- for ans in answers:
- answers_objs.append(
- ParticipantAnswer(
- participant=obj,
- **ans,
- )
- )
-
- ParticipantAnswer.objects.bulk_create(answers_objs)
-
- return obj
diff --git a/apps/quiz/serializers/quiz.py b/apps/quiz/serializers/quiz.py
deleted file mode 100644
index 48cf1ad..0000000
--- a/apps/quiz/serializers/quiz.py
+++ /dev/null
@@ -1,130 +0,0 @@
-from rest_framework import serializers
-
-from apps.course.access import user_has_course_access
-from apps.course.models.course import get_localized_field
-from apps.quiz.models import Question, Quiz, QuizParticipant
-
-
-
-
-
-
-
-class QuizListSerializer(serializers.ModelSerializer):
- is_complated = serializers.SerializerMethodField()
- permission = serializers.SerializerMethodField()
- title = serializers.SerializerMethodField()
- description = serializers.SerializerMethodField()
-
- class Meta:
- model = Quiz
- fields = ['id', 'title', 'description', 'permission', 'each_question_timing', 'is_complated']
-
- def get_title(self, obj):
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return get_localized_field(lang, obj.title)
-
- def get_description(self, obj):
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return get_localized_field(lang, obj.description)
-
- def get_permission(self, obj):
- request = self.context.get('request')
- if not request or not request.user.is_authenticated:
- return False
- user = request.user
-
- course = obj.course
- if not course:
- course_lesson = obj.lesson_computed
- if course_lesson:
- course = course_lesson.course
-
- if not course:
- return False
-
- if not user_has_course_access(user, course):
- return False
-
- participated = QuizParticipant.objects.filter(user=user, quiz=obj).exists()
- return not participated
-
- def get_is_complated(self, obj):
- request = self.context.get('request')
- if not request or not request.user.is_authenticated:
- return False
- user = request.user
- return QuizParticipant.objects.filter(user=user, quiz=obj).exists()
-
-
-
-
-
-class QuestionSerializer(serializers.ModelSerializer):
- options = serializers.SerializerMethodField()
- question = serializers.SerializerMethodField()
-
- def get_question(self, obj):
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return get_localized_field(lang, obj.question)
-
- def get_options(self, obj) -> list:
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return [
- {
- 'id': i,
- 'title': get_localized_field(lang, getattr(obj, f"option{i}"))
- } for i in range(1, 5)
- ]
-
-
- class Meta:
- model = Question
- fields = ['id', 'question', 'options', 'correct_answer']
-
-
-class QuizSerializer(serializers.ModelSerializer):
- lesson = serializers.SerializerMethodField()
- questions = QuestionSerializer(many=True)
- permission = serializers.SerializerMethodField()
- title = serializers.SerializerMethodField()
- description = serializers.SerializerMethodField()
-
- class Meta:
- model = Quiz
- fields = ['id', 'permission', 'lesson', 'lesson_number', 'title', 'description', 'each_question_timing', 'questions']
-
- def get_title(self, obj):
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return get_localized_field(lang, obj.title)
-
- def get_description(self, obj):
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- return get_localized_field(lang, obj.description)
-
- def get_lesson(self, obj):
- computed = obj.lesson_computed
- return computed.id if computed else None
-
- def get_permission(self, obj):
- request = self.context.get('request')
- if not request or not request.user.is_authenticated:
- return False
- user = request.user
-
- course = obj.course
- if not course:
- course_lesson = obj.lesson_computed
- if course_lesson:
- course = course_lesson.course
-
- if not course:
- return False
-
- return user_has_course_access(user, course)
diff --git a/apps/quiz/tests.py b/apps/quiz/tests.py
deleted file mode 100644
index 7ce503c..0000000
--- a/apps/quiz/tests.py
+++ /dev/null
@@ -1,3 +0,0 @@
-from django.test import TestCase
-
-# Create your tests here.
diff --git a/apps/quiz/urls.py b/apps/quiz/urls.py
deleted file mode 100644
index 1705382..0000000
--- a/apps/quiz/urls.py
+++ /dev/null
@@ -1,27 +0,0 @@
-from django.urls import path, include
-from rest_framework.routers import DefaultRouter, SimpleRouter
-
-from . import views
-
-router = SimpleRouter()
-router.register(r'admin/quizzes', views.AdminQuizViewSet, basename='admin-quizzes')
-router.register(r'admin/questions', views.AdminQuestionViewSet, basename='admin-questions')
-
-# Hide admin viewsets from swagger
-for prefix, viewset, basename in router.registry:
- viewset.swagger_schema = None
-views.AdminCourseListView.swagger_schema = None
-views.AdminLessonListView.swagger_schema = None
-
-urlpatterns = [
- path('', include(router.urls)),
- path('admin/courses/', views.AdminCourseListView.as_view(), name='admin-courses-list'),
- path('admin/lessons/', views.AdminLessonListView.as_view(), name='admin-lessons-list'),
-
- # path('prizes/', PrizeListAPIView.as_view()),
- # path('ranked-list/', RankedListAPIView.as_view()),
- # path('self-rank/', SelfRankAPIView.as_view()),
- # path('my-quizzes/', UserQuizScores.as_view()),
- path('submit-quiz/', views.QuizParticipantCreateAPIView.as_view()),
- path('/', views.QuizDetailAPIView.as_view()),
-]
diff --git a/apps/quiz/views.py b/apps/quiz/views.py
deleted file mode 100644
index 91ea44a..0000000
--- a/apps/quiz/views.py
+++ /dev/null
@@ -1,3 +0,0 @@
-from django.shortcuts import render
-
-# Create your views here.
diff --git a/apps/quiz/views/__init__.py b/apps/quiz/views/__init__.py
deleted file mode 100644
index 46d88e7..0000000
--- a/apps/quiz/views/__init__.py
+++ /dev/null
@@ -1,3 +0,0 @@
-from .quiz import *
-from .participant import *
-from .admin import *
\ No newline at end of file
diff --git a/apps/quiz/views/admin.py b/apps/quiz/views/admin.py
deleted file mode 100644
index fef819a..0000000
--- a/apps/quiz/views/admin.py
+++ /dev/null
@@ -1,298 +0,0 @@
-from django.db.models import Q
-from rest_framework.viewsets import ModelViewSet
-from rest_framework.generics import ListAPIView
-from rest_framework.permissions import IsAuthenticated
-from rest_framework.authentication import TokenAuthentication
-from rest_framework.decorators import action
-from rest_framework.response import Response
-from django.shortcuts import get_object_or_404
-from utils.pagination import StandardResultsSetPagination
-
-from apps.quiz.models import Quiz, Question, QuizParticipant
-from apps.course.models import Course, CourseLesson, Participant
-from apps.course.models.course import extract_text_from_json
-from apps.account.models import User
-from apps.account.permissions import IsPanelUser
-
-from apps.quiz.serializers.admin import (
- AdminCourseSerializer,
- AdminCourseLessonSerializer,
- AdminQuizListSerializer,
- AdminQuizDetailSerializer,
- AdminQuestionSerializer,
- AdminQuizParticipantSerializer,
- AdminQuizAbsenteeSerializer
-)
-
-
-def is_professor(request):
- return getattr(request.user, 'user_type', None) == 'professor'
-
-
-def find_matching_course_ids(search_term: str):
- normalized = (search_term or "").strip().lower()
- if not normalized:
- return []
-
- matching_ids = list(
- Course.objects.filter(
- Q(title__icontains=search_term) | Q(slug__icontains=search_term)
- ).values_list("id", flat=True)
- )
-
- if matching_ids:
- return matching_ids
-
- for course in Course.objects.all().only("id", "title", "slug"):
- title_text = extract_text_from_json(course.title).lower()
- slug_text = extract_text_from_json(course.slug).lower()
- if normalized in title_text or normalized in slug_text:
- matching_ids.append(course.id)
-
- return matching_ids
-
-
-def find_matching_lesson_ids(search_term: str):
- normalized = (search_term or "").strip().lower()
- if not normalized:
- return []
-
- matching_ids = []
- for lesson in CourseLesson.objects.select_related("lesson").all():
- lesson_title = extract_text_from_json(
- lesson.title or (lesson.lesson.title if lesson.lesson else [])
- ).lower()
- if normalized in lesson_title:
- matching_ids.append(lesson.id)
-
- return matching_ids
-
-
-def find_matching_quiz_ids(search_term: str):
- normalized = (search_term or "").strip().lower()
- if not normalized:
- return []
-
- matching_ids = []
- for quiz in Quiz.objects.all().only("id", "title", "description"):
- title_text = extract_text_from_json(quiz.title).lower()
- description_text = extract_text_from_json(quiz.description).lower()
- if normalized in title_text or normalized in description_text:
- matching_ids.append(quiz.id)
-
- return matching_ids
-
-
-class AdminQuizViewSet(ModelViewSet):
- """
- Admin CRUD ViewSet for Quiz management.
- Professors can only access quizzes of their own courses.
- """
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
-
- def get_serializer_class(self):
- if self.action == 'list':
- return AdminQuizListSerializer
- return AdminQuizDetailSerializer
-
- def get_queryset(self):
- queryset = Quiz.objects.all().select_related('course', 'lesson')
-
- # Professors can only see quizzes of their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- # Handle Search
- search_query = self.request.query_params.get('search', None)
- has_search = False
- if search_query:
- has_search = True
- matching_course_ids = find_matching_course_ids(search_query)
- matching_lesson_ids = find_matching_lesson_ids(search_query)
- matching_quiz_ids = find_matching_quiz_ids(search_query)
- from django.db.models import Case, When, Value, IntegerField
- queryset = queryset.filter(
- Q(id__in=matching_quiz_ids) |
- Q(course_id__in=matching_course_ids) |
- Q(lesson_id__in=matching_lesson_ids)
- ).annotate(
- search_relevance=Case(
- When(id__in=matching_quiz_ids, then=Value(2)),
- default=Value(1),
- output_field=IntegerField()
- )
- )
-
- # Handle Course Filter
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
-
- # Handle Lesson Filter
- lesson_id = self.request.query_params.get('lesson', None)
- if lesson_id:
- try:
- lesson_obj = CourseLesson.objects.get(id=lesson_id)
- course = lesson_obj.course
- lessons = list(CourseLesson.objects.filter(
- course=course,
- is_active=True
- ).order_by('chapter__priority', 'priority'))
- try:
- pos = lessons.index(lesson_obj) + 1
- queryset = queryset.filter(
- Q(lesson_id=lesson_id) | (Q(course=course) & Q(lesson_number=pos))
- )
- except ValueError:
- queryset = queryset.filter(lesson_id=lesson_id)
- except CourseLesson.DoesNotExist:
- queryset = queryset.filter(lesson_id=lesson_id)
-
- # Handle Status Filter
- status_param = self.request.query_params.get('status', None)
- if status_param is not None:
- if status_param.lower() == 'true':
- queryset = queryset.filter(status=True)
- elif status_param.lower() == 'false':
- queryset = queryset.filter(status=False)
-
- if has_search:
- return queryset.order_by('-search_relevance', '-id')
- return queryset.order_by('-id')
-
- @action(detail=True, methods=['get'])
- def participants(self, request, pk=None):
- """
- Returns two lists:
- 1. Participants: users who have participated in the quiz.
- 2. Absentees: users who are enrolled in the course but have not participated.
- """
- quiz = self.get_object()
-
- # 1. Fetch participants
- participants_qs = QuizParticipant.objects.filter(quiz=quiz).select_related('user').prefetch_related('answers')
- participants_serializer = AdminQuizParticipantSerializer(participants_qs, many=True)
-
- # 2. Fetch absentees
- absentees_data = []
- if quiz.course:
- # Enrolled course student IDs
- enrolled_student_ids = Participant.objects.filter(
- course=quiz.course,
- is_active=True
- ).values_list('student_id', flat=True)
-
- # Participated user IDs
- participated_user_ids = participants_qs.values_list('user_id', flat=True)
-
- # Absentee IDs
- absentee_ids = set(enrolled_student_ids) - set(participated_user_ids)
-
- # Fetch User details for absentees
- absentees_qs = User.objects.filter(id__in=absentee_ids)
- absentees_serializer = AdminQuizAbsenteeSerializer(absentees_qs, many=True)
- absentees_data = absentees_serializer.data
-
- return Response({
- 'participants': participants_serializer.data,
- 'absentees': absentees_data
- })
-
-
-class AdminQuestionViewSet(ModelViewSet):
- """
- Admin CRUD ViewSet for Question management.
- Professors can only access questions of quizzes belonging to their own courses.
- """
- serializer_class = AdminQuestionSerializer
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = None
-
- def get_queryset(self):
- queryset = Question.objects.all()
-
- # Professors can only see questions of their own courses' quizzes
- if is_professor(self.request):
- queryset = queryset.filter(quiz__course__professors=self.request.user)
-
- quiz_id = self.request.query_params.get('quiz_id', None)
- if not quiz_id:
- # Fallback parameter name
- quiz_id = self.request.query_params.get('quiz', None)
-
- if quiz_id:
- queryset = queryset.filter(quiz_id=quiz_id)
-
- return queryset.order_by('priority', 'id')
-
- @action(detail=False, methods=['post'])
- def reorder(self, request):
- """
- Reorders questions in bulk.
- Accepts a list of question IDs.
- Format:
- {
- "question_ids": [10, 12, 11, 15]
- }
- """
- question_ids = request.data.get('question_ids', [])
- if not question_ids:
- return Response({'error': 'question_ids list is required'}, status=400)
-
- # Update priority for each question based on its position in the list
- from django.db import transaction
- questions = Question.objects.filter(id__in=question_ids)
- question_map = {q.id: q for q in questions}
-
- with transaction.atomic():
- for idx, q_id in enumerate(question_ids):
- if q_id in question_map:
- question = question_map[q_id]
- question.priority = idx + 1
- question.save(update_fields=['priority'])
-
- return Response({'status': 'success'})
-
-
-class AdminCourseListView(ListAPIView):
- """
- Dropdown listing helper for all courses.
- Professors only see their own courses.
- """
- serializer_class = AdminCourseSerializer
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = None # Return all courses for dropdown usage
-
- def get_queryset(self):
- queryset = Course.objects.all().order_by('-id')
- if is_professor(self.request):
- queryset = queryset.filter(professors=self.request.user)
- return queryset
-
-
-class AdminLessonListView(ListAPIView):
- """
- Dropdown listing helper for lessons. Filtered by course_id.
- Professors only see lessons of their own courses.
- """
- serializer_class = AdminCourseLessonSerializer
- permission_classes = [IsAuthenticated, IsPanelUser]
- authentication_classes = [TokenAuthentication]
- pagination_class = None # Return all matching lessons for dropdown usage
-
- def get_queryset(self):
- course_id = self.request.query_params.get('course_id', None)
- if course_id:
- qs = CourseLesson.objects.filter(course_id=course_id).select_related('lesson').order_by('priority')
- else:
- qs = CourseLesson.objects.all().select_related('lesson').order_by('-id')
-
- # Professors only see lessons of their own courses
- if is_professor(self.request):
- qs = qs.filter(course__professors=self.request.user)
-
- return qs
diff --git a/apps/quiz/views/participant.py b/apps/quiz/views/participant.py
deleted file mode 100644
index c4d89c4..0000000
--- a/apps/quiz/views/participant.py
+++ /dev/null
@@ -1,25 +0,0 @@
-from django.db.models import Value
-from rest_framework.generics import RetrieveAPIView, CreateAPIView
-from rest_framework.permissions import IsAuthenticated
-from rest_framework.authentication import TokenAuthentication
-
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-
-from apps.quiz.serializers import QuizParticipantSerializer
-from apps.quiz.doc import *
-
-
-
-class QuizParticipantCreateAPIView(CreateAPIView):
- serializer_class = QuizParticipantSerializer
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
-
- @swagger_auto_schema(
- operation_description=doc_quiz_submit(),
- tags=["Imam-Javad - Quiz"],
- )
- def post(self, request, *args, **kwargs):
- return super().post(request, *args, **kwargs)
\ No newline at end of file
diff --git a/apps/quiz/views/quiz.py b/apps/quiz/views/quiz.py
deleted file mode 100644
index 6d5284e..0000000
--- a/apps/quiz/views/quiz.py
+++ /dev/null
@@ -1,45 +0,0 @@
-from django.db.models import Value
-from django.shortcuts import get_object_or_404
-from rest_framework.generics import RetrieveAPIView
-from rest_framework.permissions import IsAuthenticated
-from rest_framework.authentication import TokenAuthentication
-
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-from apps.course.access import user_has_course_access
-from apps.quiz.models import Quiz
-from apps.quiz.serializers.quiz import QuizSerializer
-from apps.quiz.doc import *
-from utils.exceptions import AppAPIException
-
-
-
-class QuizDetailAPIView(RetrieveAPIView):
- serializer_class = QuizSerializer
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
-
- @swagger_auto_schema(
- operation_description=doc_quiz_detail(),
- tags=["Imam-Javad - Quiz"],
- )
- def get(self, request, *args, **kwargs):
- return super().get(request, *args, **kwargs)
-
- def get_object(self):
- quiz = get_object_or_404(
- Quiz.objects.filter(
- id=self.kwargs['quiz_id'],
- ).annotate(
- lesson__has_quiz=Value(True)
- ).select_related('lesson', 'course')
- )
-
- if quiz.course and not user_has_course_access(self.request.user, quiz.course):
- raise AppAPIException(
- {'message': 'You do not have access to this quiz.'},
- status_code=403,
- )
-
- return quiz
diff --git a/apps/transaction/__init__.py b/apps/transaction/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/transaction/admin.py b/apps/transaction/admin.py
deleted file mode 100644
index 80107fd..0000000
--- a/apps/transaction/admin.py
+++ /dev/null
@@ -1,165 +0,0 @@
-from django.contrib import admin
-from django.utils.translation import gettext_lazy as _
-from django.utils.html import format_html
-from django.contrib import messages
-
-from unfold.admin import ModelAdmin, StackedInline, TabularInline
-from unfold.decorators import display
-
-from apps.transaction.models import TransactionParticipant, ParticipantInfo, TransactionReceipt
-from apps.course.models import Participant
-
-from utils.admin import project_admin_site
-
-class ParticipantInfoInline(StackedInline):
- model = ParticipantInfo
- extra = 1
- fields = ['fullname', 'email', 'phone_number', 'gender', 'birthdate']
- # readonly_fields = ['email', 'phone_number']
- classes = ['collapse']
- tab = True
- show_change_link = True
-
-
-class TransactionReceiptInline(TabularInline):
- model = TransactionReceipt
- extra = 0
- fields = ['file', 'description', 'uploaded_at']
- readonly_fields = ['uploaded_at']
- classes = ['collapse']
- tab = True
- show_change_link = True
- verbose_name = _('Payment Receipt')
- verbose_name_plural = _('Payment Receipts')
-
-
-@admin.register(TransactionParticipant)
-class TransactionParticipantAdmin(ModelAdmin):
- list_display = ('user', 'course', 'payment_status', 'price_display', 'participant_status', 'receipts_count', 'created_at', 'updated_at')
- list_filter = ('status', 'course', 'created_at')
- search_fields = ('user__email', 'course__title')
- readonly_fields = ['created_at', 'updated_at']
- inlines = [ParticipantInfoInline, TransactionReceiptInline]
- autocomplete_fields = ['user',]
- show_change_link = True
- ordering = ('-created_at',)
-
- fieldsets = (
- (None, {
- 'fields': ('user', 'course', 'status', 'price')
- }),
- (_('Timestamps'), {
- 'fields': ('created_at', 'updated_at'),
- 'classes': ('collapse',)
- }),
- )
-
- @display(description=_("Payment Status"), ordering="status")
- def payment_status(self, obj):
- if obj.status == 'success':
- return format_html('{}', _("Paid"))
- elif obj.status == 'failed':
- return format_html('{}', _("Failed"))
- elif obj.status == 'waiting_approval':
- return format_html('{}', _("Waiting Approval"))
- return format_html('{}', _("Pending"))
-
- @display(description=_("Receipts Count"))
- def receipts_count(self, obj):
- """Display count of uploaded receipts"""
- count = obj.receipts.count()
- if count > 0:
- return format_html('{} {}', count, _("receipts"))
- return format_html('{}', _("No receipts"))
-
- @display(description=_("Price"), ordering="price")
- def price_display(self, obj):
- return format_html('${}', obj.price)
-
- @display(description=_("Course Participant Status"))
- def participant_status(self, obj):
- """نمایش وضعیت شرکتکننده در دوره"""
- if obj.status == TransactionParticipant.TransactionStatus.SUCCESS:
- participant_exists = Participant.objects.filter(
- student=obj.user,
- course=obj.course
- ).exists()
- if participant_exists:
- return format_html('✓ {}', _("Enrolled"))
- else:
- return format_html('⚠ {}', _("Not Enrolled"))
- else:
- return format_html('- {}', _("Not Applicable"))
-
- def save_model(self, request, obj, form, change):
- """Override save_model to show messages when participant is created"""
- if change:
- # Store the old status before saving
- old_obj = TransactionParticipant.objects.get(pk=obj.pk)
- old_status = old_obj.status
-
- # Save the object
- super().save_model(request, obj, form, change)
-
- # Check if status changed to SUCCESS
- if (old_status != TransactionParticipant.TransactionStatus.SUCCESS and
- obj.status == TransactionParticipant.TransactionStatus.SUCCESS):
-
- participant_exists = Participant.objects.filter(
- student=obj.user,
- course=obj.course
- ).exists()
-
- if participant_exists:
- messages.success(
- request,
- _("Transaction status updated to SUCCESS. User {user_email} is now enrolled in course '{course_title}'.").format(
- user_email=obj.user.email,
- course_title=obj.course.title
- )
- )
- else:
- messages.warning(
- request,
- _("Transaction status updated to SUCCESS, but there was an issue enrolling user {user_email} in course '{course_title}'. Please check the logs.").format(
- user_email=obj.user.email,
- course_title=obj.course.title
- )
- )
- else:
- super().save_model(request, obj, form, change)
-
- def get_queryset(self, request):
- # Filter out deleted transactions
- return super().get_queryset(request).filter(is_deleted=False)
-
-project_admin_site.register(TransactionParticipant, TransactionParticipantAdmin)
-
-
-@admin.register(TransactionReceipt)
-class TransactionReceiptAdmin(ModelAdmin):
- list_display = ('transaction', 'file', 'uploaded_at', 'description_preview')
- list_filter = ('uploaded_at', 'transaction__status')
- search_fields = ('transaction__user__email', 'transaction__course__title', 'description')
- readonly_fields = ['uploaded_at']
- autocomplete_fields = ['transaction']
- ordering = ('-uploaded_at',)
-
- fieldsets = (
- (None, {
- 'fields': ('transaction', 'file', 'description')
- }),
- (_('Timestamps'), {
- 'fields': ('uploaded_at',),
- 'classes': ('collapse',)
- }),
- )
-
- @display(description=_("Description"))
- def description_preview(self, obj):
- """Display truncated description"""
- if obj.description:
- return obj.description[:50] + '...' if len(obj.description) > 50 else obj.description
- return '-'
-
-project_admin_site.register(TransactionReceipt, TransactionReceiptAdmin)
diff --git a/apps/transaction/apps.py b/apps/transaction/apps.py
deleted file mode 100644
index d10da14..0000000
--- a/apps/transaction/apps.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from django.apps import AppConfig
-
-
-class TransactionConfig(AppConfig):
- default_auto_field = 'django.db.models.BigAutoField'
- name = 'apps.transaction'
-
- def ready(self):
- import apps.transaction.signals
diff --git a/apps/transaction/doc.py b/apps/transaction/doc.py
deleted file mode 100644
index 1eacff9..0000000
--- a/apps/transaction/doc.py
+++ /dev/null
@@ -1,711 +0,0 @@
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-from rest_framework import status
-
-def doc_upload_transaction_receipts():
- return """
-# 🐈 Scenario
-🛠️ آپلود رسید پرداخت برای تراکنش
-
-این API برای آپلود یک یا چند رسید پرداخت برای یک تراکنش استفاده میشود.
-پس از آپلود موفقیتآمیز، وضعیت تراکنش به 'waiting_approval' (در انتظار تایید) تغییر میکند.
-
----
-
-## 🚀 روند آپلود (دو مرحلهای)
-
-### مرحله 1️⃣: آپلود فایل به سرور موقت
-ابتدا باید فایلهای خود را به endpoint زیر آپلود کنید:
-
-```
-POST /upload-tmp-media/
-Content-Type: multipart/form-data
-
-Body:
-- file: [فایل رسید]
-```
-
-**پاسخ:**
-```json
-{
- "url": "/static/tmp/xyz123-receipt.jpg",
- "name": "receipt.jpg",
- "size": "1024000",
- "mime_type": "image/jpeg"
-}
-```
-
-### مرحله 2️⃣: ثبت URL فایلها در تراکنش
-سپس URL های دریافتی را به این endpoint ارسال کنید:
-
-```
-POST /api/transactions//receipts/upload/
-Content-Type: application/json
-```
-
----
-
-## 🚀 درخواست API (مرحله 2)
-
-### URL:
-```
-POST /api/transactions//receipts/upload/
-```
-
-### پارامترهای URL:
-| کلید | نوع داده | توضیحات |
-|------------------|-----------|----------------------------------------------------------|
-| `transaction_id` | Integer | شناسه تراکنش که میخواهید رسید برای آن ثبت کنید |
-
-### پارامترهای درخواست (JSON Body):
-| کلید | نوع داده | الزامی | توضیحات |
-|---------------|-----------|--------|----------------------------------------------------------|
-| `files` | String[] | بله | لیست URL های فایلهای آپلود شده از مرحله 1 (حداکثر 10 فایل) |
-| `description` | String | خیر | توضیحات اختیاری درباره رسیدها |
-
----
-
-## 💡 نکات مهم:
-1. **روند دو مرحلهای**:
- - **مرحله 1**: ابتدا فایلها را به `/upload-tmp-media/` آپلود کنید
- - **مرحله 2**: سپس URL های دریافتی را به این API ارسال کنید
-
-2. **محدودیت فایلها**:
- - حداکثر 10 فایل میتوانید در هر درخواست ثبت کنید
-
-3. **وضعیت تراکنش**:
- - فقط میتوانید برای تراکنشهایی با وضعیت 'pending' یا 'waiting_approval' رسید آپلود کنید
- - پس از ثبت موفقیتآمیز، وضعیت تراکنش به 'waiting_approval' تغییر میکند
-
-4. **احراز هویت**:
- - باید توکن احراز هویت را در هدر درخواست ارسال کنید
- - فقط میتوانید برای تراکنشهای خودتان رسید آپلود کنید
-
----
-
-## 📊 پاسخها
-
-| کد وضعیت | توضیحات |
-|---------------|-----------------------------------------------------------|
-| `201` | موفقیتآمیز - رسیدها با موفقیت ثبت شدند |
-| `400` | دادههای نامعتبر یا تراکنش قادر به دریافت رسید نیست |
-| `403` | عدم دسترسی - شما صاحب این تراکنش نیستید |
-| `404` | تراکنش یافت نشد |
-
----
-
-## 📄 نمونه درخواست کامل (JSON):
-
-```json
-{
- "files": [
- "/static/tmp/xyz123-receipt1.jpg",
- "/static/tmp/abc456-receipt2.jpg"
- ],
- "description": "Payment receipt for Python course"
-}
-```
-
----
-
-## 📄 نمونه پاسخ موفقیتآمیز
-
-```json
-{
- "success": true,
- "message": "Receipts uploaded successfully",
- "transaction_status": "waiting_approval",
- "receipts": [
- {
- "id": 1,
- "file": "http://example.com/media/receipts/1/receipt1.jpg",
- "description": "Payment receipt for course enrollment",
- "uploaded_at": "2025-12-03T10:30:00Z"
- },
- {
- "id": 2,
- "file": "http://example.com/media/receipts/1/receipt2.jpg",
- "description": "Payment receipt for course enrollment",
- "uploaded_at": "2025-12-03T10:30:05Z"
- }
- ]
-}
-```
-
----
-
-## 📄 نمونه درخواست کامل (cURL):
-
-### مرحله 1 - آپلود فایل:
-```bash
-curl -X POST \\
- 'http://your-api.com/upload-tmp-media/' \\
- -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\
- -F 'file=@/path/to/receipt1.jpg'
-```
-
-### مرحله 2 - ثبت رسید:
-```bash
-curl -X POST \\
- 'http://your-api.com/api/transactions/123/receipts/upload/' \\
- -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\
- -H 'Content-Type: application/json' \\
- -d '{
- "files": ["/static/tmp/xyz123-receipt1.jpg"],
- "description": "Payment receipt for Python course"
- }'
-```
-
----
-
-## 📄 نمونه پاسخ خطا (403 - عدم دسترسی):
-
-```json
-{
- "message": "You don't have permission to upload receipts for this transaction"
-}
-```
-
----
-
-## 📄 نمونه پاسخ خطا (400 - وضعیت نامعتبر):
-
-```json
-{
- "message": "Cannot upload receipts for transaction with status 'success'"
-}
-```
-"""
-
-
-def doc_list_transaction_receipts():
- return """
-# 🐈 Scenario
-🛠️ لیست رسیدهای پرداخت یک تراکنش
-
-این API برای دریافت لیست تمام رسیدهای آپلود شده برای یک تراکنش خاص استفاده میشود.
-
----
-
-## 🚀 درخواست API
-
-### URL:
-```
-GET /api/transactions//receipts/
-```
-
-### پارامترهای URL:
-| کلید | نوع داده | توضیحات |
-|------------------|-----------|----------------------------------------------------------|
-| `transaction_id` | Integer | شناسه تراکنش که میخواهید رسیدهای آن را مشاهده کنید |
-
----
-
-## 💡 نکات مهم:
-1. **احراز هویت**:
- - باید توکن احراز هویت را در هدر درخواست ارسال کنید
- - فقط میتوانید رسیدهای تراکنشهای خودتان را مشاهده کنید
-
-2. **مرتبسازی**:
- - رسیدها بر اساس تاریخ آپلود (جدیدترین اول) مرتب میشوند
-
----
-
-## 📊 پاسخها
-
-| کد وضعیت | توضیحات |
-|---------------|-----------------------------------------------------------|
-| `200` | موفقیتآمیز - لیست رسیدها بازگردانده شد |
-| `403` | عدم دسترسی - شما صاحب این تراکنش نیستید |
-| `404` | تراکنش یافت نشد |
-
----
-
-## 📄 نمونه پاسخ موفقیتآمیز
-
-```json
-[
- {
- "id": 1,
- "file": "http://example.com/media/receipts/1/receipt1.jpg",
- "description": "Payment receipt for course enrollment",
- "uploaded_at": "2025-12-03T10:30:00Z"
- },
- {
- "id": 2,
- "file": "http://example.com/media/receipts/1/receipt2.jpg",
- "description": "Second payment receipt",
- "uploaded_at": "2025-12-03T10:25:00Z"
- }
-]
-```
-
----
-
-## 📄 توضیحات مقادیر پاسخ
-
-| کلید | نوع داده | توضیحات |
-|---------------|------------|----------------------------------------------------------|
-| `id` | Integer | شناسه یکتای رسید |
-| `file` | String | URL کامل فایل رسید آپلود شده |
-| `description` | String | توضیحات اختیاری درباره رسید (ممکن است خالی باشد) |
-| `uploaded_at` | DateTime | تاریخ و زمان آپلود رسید |
-
----
-
-## 📄 نمونه درخواست (cURL):
-
-```bash
-curl -X GET \\
- 'http://your-api.com/api/transactions/123/receipts/' \\
- -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
-```
-
----
-
-## 📄 نمونه پاسخ خطا (403 - عدم دسترسی):
-
-```json
-{
- "message": "You don't have permission to view receipts for this transaction"
-}
-```
-
----
-
-## 📄 نمونه پاسخ خطا (404 - تراکنش یافت نشد):
-
-```json
-{
- "message": "Transaction not found"
-}
-```
-"""
-
-
-def doc_transaction_list():
- return """
-# 🐈 Scenario
-🛠️ لیست تراکنشهای کاربر
-
-این API برای دریافت لیست تمام تراکنشهای کاربر احراز هویت شده استفاده میشود.
-
----
-
-## 🚀 درخواست API
-
-### URL:
-```
-GET /api/transactions/list/
-```
-
----
-
-## 💡 نکات مهم:
-1. **احراز هویت**:
- - باید توکن احراز هویت را در هدر درخواست ارسال کنید
- - فقط تراکنشهای خودتان را مشاهده میکنید
-
-2. **فیلترینگ خودکار**:
- - تراکنشهای حذف شده (soft deleted) نمایش داده نمیشوند
-
-3. **وضعیتهای تراکنش**:
- - `pending`: در انتظار پرداخت
- - `waiting_approval`: در انتظار تایید (رسید آپلود شده)
- - `success`: پرداخت موفق و تایید شده
- - `failed`: پرداخت ناموفق
-
----
-
-## 📊 پاسخها
-
-| کد وضعیت | توضیحات |
-|---------------|-----------------------------------------------------------|
-| `200` | موفقیتآمیز - لیست تراکنشها بازگردانده شد |
-| `401` | عدم احراز هویت |
-
----
-
-## 📄 توضیحات مقادیر پاسخ
-
-| کلید | نوع داده | توضیحات |
-|---------------|------------|----------------------------------------------------------|
-| `id` | Integer | شناسه یکتای تراکنش |
-| `course` | Object | اطلاعات دوره مرتبط با تراکنش |
-| `status` | String | وضعیت تراکنش (pending, waiting_approval, success, failed) |
-| `price` | Decimal | مبلغ تراکنش |
-| `created_at` | DateTime | تاریخ و زمان ایجاد تراکنش |
-| `updated_at` | DateTime | تاریخ و زمان آخرین بهروزرسانی تراکنش |
-
----
-
-## 📄 نمونه پاسخ موفقیتآمیز
-
-```json
-[
- {
- "id": 1,
- "course": {
- "id": 5,
- "title": "Python Programming Basics",
- "slug": "python-programming-basics",
- "thumbnail": "http://example.com/media/courses/thumbnails/python.jpg",
- "price": "99.00",
- "final_price": "79.00"
- },
- "status": "waiting_approval",
- "price": "79.00",
- "created_at": "2025-12-01T10:00:00Z",
- "updated_at": "2025-12-03T10:30:00Z"
- },
- {
- "id": 2,
- "course": {
- "id": 8,
- "title": "Django Web Development",
- "slug": "django-web-development",
- "thumbnail": "http://example.com/media/courses/thumbnails/django.jpg",
- "price": "149.00",
- "final_price": "149.00"
- },
- "status": "success",
- "price": "149.00",
- "created_at": "2025-11-28T14:20:00Z",
- "updated_at": "2025-11-29T09:15:00Z"
- }
-]
-```
-
----
-
-## 📄 نمونه درخواست (cURL):
-
-```bash
-curl -X GET \\
- 'http://your-api.com/api/transactions/list/' \\
- -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
-```
-"""
-
-
-def doc_create_transaction():
- return """
-# 🐈 Scenario
-🛠️ ثبتنام در دوره و ایجاد تراکنش
-
-این API برای ثبتنام کاربر در یک دوره و ایجاد تراکنش استفاده میشود.
-
----
-
-## 🚀 درخواست API
-
-### URL:
-```
-POST /api/transactions//join/
-```
-
-### پارامترهای URL:
-| کلید | نوع داده | توضیحات |
-|---------|-----------|----------------------------------------------------------|
-| `slug` | String | اسلاگ دورهای که میخواهید در آن ثبتنام کنید |
-
-### پارامترهای درخواست (JSON Body):
-| کلید | نوع داده | الزامی | توضیحات |
-|---------------------|-----------|--------|----------------------------------------------------------|
-| `participant_infos` | Array | بله | لیست اطلاعات شرکتکنندگان |
-
-### ساختار `participant_infos`:
-| کلید | نوع داده | الزامی | توضیحات |
-|---------------|-----------|--------|----------------------------------------------------------|
-| `fullname` | String | بله | نام کامل شرکتکننده |
-| `email` | String | بله | ایمیل شرکتکننده (برای دوره رایگان باید با ایمیل کاربر احراز هویت شده یکسان باشد) |
-| `phone_number`| String | خیر | شماره تلفن شرکتکننده |
-| `gender` | String | خیر | جنسیت شرکتکننده (male, female) |
-| `birthdate` | Date | خیر | تاریخ تولد شرکتکننده (فرمت: YYYY-MM-DD) |
-
----
-
-## 💡 نکات مهم:
-1. **دوره رایگان**:
- - اگر دوره رایگان باشد و فقط یک شرکتکننده در لیست باشد و ایمیل او با کاربر احراز هویت شده یکسان باشد، تراکنش به صورت خودکار تایید میشود (status = 'success')
- - کاربر به صورت خودکار به عنوان دانشجو در دوره ثبت میشود
-
-2. **دوره پولی**:
- - تراکنش با وضعیت 'pending' ایجاد میشود
- - سیستم بر اساس موقعیت جغرافیایی کاربر، روش پرداخت مناسب را تعیین میکند
-
-3. **روش پرداخت (Payment Method)**:
- - **Payment_Gateway**: برای کاربران غیر روسی - پرداخت از طریق درگاه پرداخت آنلاین
- - **Receipt**: برای کاربران روسی - آپلود رسید پرداخت از طریق واتساپ
-
-4. **تشخیص موقعیت جغرافیایی**:
- - ابتدا از هدر Cloudflare (`CF-IPCountry`) استفاده میشود
- - در صورت عدم وجود، از پایگاه داده GeoIP محلی استفاده میشود
- - کاربران روسی روش پرداخت Receipt دریافت میکنند
- - کاربران سایر کشورها روش پرداخت Payment_Gateway دریافت میکنند
-
-5. **احراز هویت**:
- - باید توکن احراز هویت را در هدر درخواست ارسال کنید
-
----
-
-## 📊 پاسخها
-
-| کد وضعیت | توضیحات |
-|---------------|-----------------------------------------------------------|
-| `201` | موفقیتآمیز - تراکنش ایجاد شد |
-| `400` | دادههای نامعتبر |
-| `404` | دوره یافت نشد |
-
-### ساختار پاسخ:
-| کلید | نوع داده | توضیحات |
-|---------------------|-----------|----------------------------------------------------------|
-| `message` | String | پیام موفقیتآمیز |
-| `transaction_id` | Integer | شناسه تراکنش ایجاد شده |
-| `payment_method` | String | روش پرداخت (Payment_Gateway یا Receipt) |
-| `payment_link` | String | لینک پرداخت (فقط برای Payment_Gateway) |
-| `participant_infos` | Array | لیست اطلاعات شرکتکنندگان |
-
----
-
-## 💳 روشهای پرداخت:
-
-### Payment_Gateway (درگاه پرداخت):
-- **کاربران**: غیر روسی
-- **اقدام کاربر**: کلیک روی `payment_link` و پرداخت آنلاین
-- **فرآیند**: پرداخت مستقیم از طریق درگاه پرداخت
-
-### Receipt (رسید پرداخت):
-- **کاربران**: روسی
-- **اقدام کاربر**: آپلود رسید پرداخت از طریق واتساپ
-- **فرآیند**: آپلود رسید → بررسی توسط ادمین → تایید پرداخت
-
----
-
-## 📄 نمونه درخواست (JSON Body):
-
-```json
-{
- "participant_infos": [
- {
- "fullname": "علی رضایی",
- "email": "ali@example.com",
- "phone_number": "+989123456789",
- "gender": "male",
- "birthdate": "1995-05-15"
- }
- ]
-}
-```
-
----
-
-## 📄 نمونه پاسخ (دوره رایگان):
-
-```json
-{
- "message": "Transaction Participant created successfully.",
- "transaction_id": 123,
- "payment_method": Free,
- "payment_link": null,
- "participant_infos": [
- {
- "fullname": "علی رضایی",
- "email": "ali@example.com",
- "phone_number": "+989123456789",
- "gender": "male",
- "birthdate": "1995-05-15"
- }
- ]
-}
-```
-
----
-
-## 📄 نمونه پاسخ (دوره پولی - Payment_Gateway):
-
-```json
-{
- "message": "Transaction Participant created successfully.",
- "transaction_id": 374,
- "payment_method": "Payment_Gateway",
- "payment_link": "https://russia-payment.com/pay/374",
- "participant_infos": [
- {
- "fullname": "John Doe",
- "email": "john@example.com",
- "phone_number": "+1234567890",
- "gender": "male",
- "birthdate": "1990-01-01"
- }
- ]
-}
-```
-
----
-
-## 📄 نمونه پاسخ (دوره پولی - Receipt):
-
-```json
-{
- "message": "Transaction Participant created successfully.",
- "transaction_id": 375,
- "payment_method": "receipt",
- "payment_link": null,
- "participant_infos": [
- {
- "fullname": "Иван Иванов",
- "email": "ivan@example.ru",
- "phone_number": "+71234567890",
- "gender": "male",
- "birthdate": "1992-05-15"
- }
- ]
-}
-```
-
-**نکته**: برای روش پرداخت Receipt، کاربر باید رسید پرداخت خود را از طریق واتساپ آپلود کند.
-
----
-
-## 📄 نمونه درخواست (cURL):
-
-```bash
-curl -X POST \\
- 'http://your-api.com/api/transactions/python-programming-basics/join/' \\
- -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\
- -H 'Content-Type: application/json' \\
- -d '{
- "participant_infos": [
- {
- "fullname": "علی رضایی",
- "email": "ali@example.com",
- "phone_number": "+989123456789",
- "gender": "male",
- "birthdate": "1995-05-15"
- }
- ]
- }'
-```
-"""
-
-
-hadis_list_swagger = swagger_auto_schema(
- operation_description="""
- Retrieve a paginated list of Hadis (traditions) for a specific category.
-
- **Key Features:**
- - Returns hadis entries filtered by category ID
- - Supports pagination for large datasets
- - Translations are automatically provided based on the Accept-Language header
- - Each hadis includes its category information, title, narrator, Arabic text, and translation
-
- **Usage:**
- - Use this endpoint to browse hadis within a specific category
- - The response includes pagination links (next/previous) for navigation
- - Set the Accept-Language header to get translations in your preferred language (en, fa, ar, ur)
- - Only active (status=True) hadis are returned
-
- **Response Structure:**
- - `count`: Total number of hadis in the category
- - `next`: URL for the next page (null if on last page)
- - `previous`: URL for the previous page (null if on first page)
- - `results`: Array of hadis objects with full details
- """,
- operation_summary="List Hadis by Category",
- tags=['Hadis'],
- manual_parameters=[
- openapi.Parameter(
- 'category_slug',
- openapi.IN_PATH,
- description="Unique identifier of the Hadis category. Must be a valid category ID that exists in the system.",
- type=openapi.TYPE_STRING,
- required=True,
- example='-330'
- ),
- openapi.Parameter(
- 'page',
- openapi.IN_QUERY,
- description="Page number for pagination. Starts from 1. If not provided, returns the first page.",
- type=openapi.TYPE_INTEGER,
- required=False,
- example=1
- ),
- openapi.Parameter(
- 'Accept-Language',
- openapi.IN_HEADER,
- description="Language code for translations. Supported codes: 'en' (English), 'fa' (Persian), 'ar' (Arabic), 'ur' (Urdu). Defaults to 'en' if not specified.",
- type=openapi.TYPE_STRING,
- required=False,
- default='en',
- enum=['en', 'fa', 'ar', 'ur']
- )
- ],
- responses={
- status.HTTP_200_OK: openapi.Response(
- description="Successfully retrieved paginated list of hadis for the specified category",
- examples={
- "application/json": {
- "count": 150,
- "next": "http://example.com/api/hadis/category/1/?page=2",
- "previous": None,
- "results": [
- {
- "id": 1,
- "number": 1,
- "title": "The Opening",
- "title_narrator": "From Abu Hurairah",
- "text": "إنما الأعمال بالنيات وإنما لكل امرئ ما نوى",
- "translation": "Actions are but by intention, and every man shall have only what he intended",
- "category": {
- "id": 1,
- "title": "Book of Faith",
- "slug": "book-of-faith",
- "source_type": "hadith",
- "sect_type": "sunni"
- },
- "status": {
- "id": 130,
- "title": "Прерванный",
- "color": "orange"
- },
- "share_link": "http://example.com/hadis/1"
- },
- {
- "id": 2,
- "number": 2,
- "title": "The Second Hadith",
- "title_narrator": "From Umar ibn al-Khattab",
- "text": "بينما نحن عند رسول الله صلى الله عليه وسلم ذات يوم",
- "translation": "While we were sitting with the Messenger of Allah (peace be upon him) one day",
- "category": {
- "id": 1,
- "title": "Book of Faith",
- "slug": "book-of-faith",
- "source_type": "hadith",
- "sect_type": "sunni"
- },
- "status": {
- "id": 130,
- "title": "Прерванный",
- "color": "orange"
- },
- "share_link": "http://example.com/hadis/2"
- }
- ]
- }
- }
- ),
- status.HTTP_404_NOT_FOUND: openapi.Response(
- description="The specified category ID does not exist or the category has no active hadis",
- examples={
- "application/json": {
- "detail": "Not found."
- }
- }
- ),
- status.HTTP_500_INTERNAL_SERVER_ERROR: openapi.Response(
- description="Internal server error occurred while processing the request"
- )
- }
-)
\ No newline at end of file
diff --git a/apps/transaction/management/__init__.py b/apps/transaction/management/__init__.py
deleted file mode 100644
index 11942f5..0000000
--- a/apps/transaction/management/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# Management commands for transaction app
\ No newline at end of file
diff --git a/apps/transaction/management/commands/__init__.py b/apps/transaction/management/commands/__init__.py
deleted file mode 100644
index 0b1b20d..0000000
--- a/apps/transaction/management/commands/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# Management commands
\ No newline at end of file
diff --git a/apps/transaction/management/commands/sync_successful_transactions.py b/apps/transaction/management/commands/sync_successful_transactions.py
deleted file mode 100644
index cddae07..0000000
--- a/apps/transaction/management/commands/sync_successful_transactions.py
+++ /dev/null
@@ -1,201 +0,0 @@
-from django.core.management.base import BaseCommand, CommandError
-from django.db import transaction
-from django.utils import timezone
-from apps.transaction.models import TransactionParticipant
-from apps.course.models import Participant
-from apps.account.models import User
-
-
-class Command(BaseCommand):
- help = 'بررسی تراکنشهای موفق و ایجاد شرکتکنندگان دوره در صورت عدم وجود'
-
- def add_arguments(self, parser):
- parser.add_argument(
- '--dry-run',
- action='store_true',
- help='فقط نمایش تراکنشهایی که نیاز به بروزرسانی دارند بدون اعمال تغییرات',
- )
- parser.add_argument(
- '--transaction-id',
- type=int,
- help='بررسی تراکنش خاص با ID مشخص',
- )
- parser.add_argument(
- '--user-email',
- type=str,
- help='بررسی تراکنشهای کاربر خاص',
- )
- parser.add_argument(
- '--course-slug',
- type=str,
- help='بررسی تراکنشهای دوره خاص',
- )
-
- def handle(self, *args, **options):
- dry_run = options['dry_run']
- transaction_id = options.get('transaction_id')
- user_email = options.get('user_email')
- course_slug = options.get('course_slug')
-
- # ساخت queryset اولیه
- queryset = TransactionParticipant.objects.filter(
- status=TransactionParticipant.TransactionStatus.SUCCESS,
- is_deleted=False
- ).select_related('user', 'course')
-
- # اعمال فیلترهای اضافی
- if transaction_id:
- queryset = queryset.filter(id=transaction_id)
-
- if user_email:
- try:
- user = User.objects.get(email=user_email)
- queryset = queryset.filter(user=user)
- except User.DoesNotExist:
- raise CommandError(f'کاربر با ایمیل {user_email} یافت نشد.')
-
- if course_slug:
- queryset = queryset.filter(course__slug=course_slug)
-
- total_transactions = queryset.count()
-
- if total_transactions == 0:
- self.stdout.write(
- self.style.WARNING('هیچ تراکنش موفقی برای بررسی یافت نشد.')
- )
- return
-
- self.stdout.write(
- self.style.SUCCESS(f'تعداد {total_transactions} تراکنش موفق برای بررسی یافت شد.')
- )
-
- missing_participants = []
- existing_participants = []
- errors = []
-
- # بررسی هر تراکنش
- for trans in queryset:
- try:
- # بررسی وجود participant
- participant_exists = Participant.objects.filter(
- student=trans.user,
- course=trans.course
- ).exists()
-
- if not participant_exists:
- missing_participants.append(trans)
- self.stdout.write(
- self.style.WARNING(
- f'❌ تراکنش {trans.id}: کاربر {trans.user.email} در دوره "{trans.course.title}" ثبتنام نشده'
- )
- )
- else:
- existing_participants.append(trans)
- self.stdout.write(
- self.style.SUCCESS(
- f'✅ تراکنش {trans.id}: کاربر {trans.user.email} در دوره "{trans.course.title}" قبلاً ثبتنام شده'
- )
- )
-
- except Exception as e:
- errors.append((trans, str(e)))
- self.stdout.write(
- self.style.ERROR(
- f'⚠️ خطا در بررسی تراکنش {trans.id}: {str(e)}'
- )
- )
-
- # نمایش خلاصه
- self.stdout.write('\n' + '='*50)
- self.stdout.write(f'📊 خلاصه نتایج:')
- self.stdout.write(f' • کل تراکنشهای بررسی شده: {total_transactions}')
- self.stdout.write(f' • شرکتکنندگان موجود: {len(existing_participants)}')
- self.stdout.write(f' • شرکتکنندگان ناموجود: {len(missing_participants)}')
- self.stdout.write(f' • خطاها: {len(errors)}')
- self.stdout.write('='*50 + '\n')
-
- if not missing_participants:
- self.stdout.write(
- self.style.SUCCESS('🎉 همه تراکنشهای موفق دارای شرکتکننده مربوطه هستند!')
- )
- return
-
- if dry_run:
- self.stdout.write(
- self.style.WARNING(
- f'🔍 حالت Dry Run: {len(missing_participants)} شرکتکننده نیاز به ایجاد دارند.'
- )
- )
- self.stdout.write(
- 'برای اعمال تغییرات، دستور را بدون --dry-run اجرا کنید.'
- )
- return
-
- # ایجاد شرکتکنندگان ناموجود
- created_count = 0
- failed_count = 0
-
- self.stdout.write(
- self.style.SUCCESS(f'🚀 شروع ایجاد {len(missing_participants)} شرکتکننده...')
- )
-
- for trans in missing_participants:
- try:
- with transaction.atomic():
- # اضافه کردن نقش student اگر وجود نداشته باشد
- if not trans.user.has_role('student'):
- trans.user.add_role('student')
- self.stdout.write(
- f' 👤 نقش student به کاربر {trans.user.email} اضافه شد'
- )
-
- # ایجاد participant
- participant = Participant.objects.create(
- student=trans.user,
- course=trans.course
- )
-
- created_count += 1
- self.stdout.write(
- self.style.SUCCESS(
- f' ✅ شرکتکننده ایجاد شد: {trans.user.email} در دوره "{trans.course.title}"'
- )
- )
-
- except Exception as e:
- failed_count += 1
- self.stdout.write(
- self.style.ERROR(
- f' ❌ خطا در ایجاد شرکتکننده برای تراکنش {trans.id}: {str(e)}'
- )
- )
-
- # نمایش نتیجه نهایی
- self.stdout.write('\n' + '='*50)
- self.stdout.write('🏁 نتیجه نهایی:')
- self.stdout.write(f' • شرکتکنندگان ایجاد شده: {created_count}')
- self.stdout.write(f' • شکستها: {failed_count}')
-
- if created_count > 0:
- self.stdout.write(
- self.style.SUCCESS(f'✅ {created_count} شرکتکننده با موفقیت ایجاد شد!')
- )
-
- if failed_count > 0:
- self.stdout.write(
- self.style.ERROR(f'❌ {failed_count} مورد با خطا مواجه شد!')
- )
-
- self.stdout.write('='*50)
-
- def get_transaction_info(self, trans):
- """اطلاعات کامل تراکنش را برمیگرداند"""
- return {
- 'id': trans.id,
- 'user_email': trans.user.email,
- 'course_title': trans.course.title,
- 'course_slug': trans.course.slug,
- 'price': trans.price,
- 'created_at': trans.created_at,
- 'status': trans.status
- }
\ No newline at end of file
diff --git a/apps/transaction/migrations/0001_initial.py b/apps/transaction/migrations/0001_initial.py
deleted file mode 100644
index 3c50f2f..0000000
--- a/apps/transaction/migrations/0001_initial.py
+++ /dev/null
@@ -1,209 +0,0 @@
-# Generated by Django 4.2.27 on 2026-01-22 10:48
-
-import apps.transaction.models
-from django.conf import settings
-from django.db import migrations, models
-import django.db.models.deletion
-import phonenumber_field.modelfields
-import utils.validators
-
-
-class Migration(migrations.Migration):
- initial = True
-
- dependencies = [
- migrations.swappable_dependency(settings.AUTH_USER_MODEL),
- ("course", "0001_initial"),
- ]
-
- operations = [
- migrations.CreateModel(
- name="TransactionParticipant",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- (
- "payment_method",
- models.CharField(
- choices=[
- ("receipt", "Receipt"),
- ("free", "Free"),
- ("Payment_Gateway", "Payment Gateway"),
- ],
- default="Payment_Gateway",
- max_length=20,
- verbose_name="Transaction Payment Method",
- ),
- ),
- (
- "price",
- models.DecimalField(
- decimal_places=2,
- default=0.0,
- max_digits=10,
- verbose_name="Transaction Price",
- ),
- ),
- (
- "status",
- models.CharField(
- choices=[
- ("pending", "Pending"),
- ("waiting_approval", "Waiting for Approval"),
- ("success", "Success"),
- ("failed", "Failed"),
- ],
- default="pending",
- max_length=20,
- verbose_name="Transaction Status",
- ),
- ),
- (
- "created_at",
- models.DateTimeField(auto_now_add=True, verbose_name="Created at"),
- ),
- (
- "updated_at",
- models.DateTimeField(auto_now=True, verbose_name="Updated at"),
- ),
- ("is_deleted", models.BooleanField(default=False)),
- (
- "course",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="course_transactions",
- to="course.course",
- ),
- ),
- (
- "user",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="transactions",
- to=settings.AUTH_USER_MODEL,
- ),
- ),
- ],
- ),
- migrations.CreateModel(
- name="TransactionReceipt",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- (
- "file",
- models.FileField(
- help_text="Upload payment receipt image or document",
- upload_to=apps.transaction.models.receipt_file_upload_to,
- verbose_name="Receipt File",
- ),
- ),
- (
- "uploaded_at",
- models.DateTimeField(auto_now_add=True, verbose_name="Uploaded At"),
- ),
- (
- "description",
- models.TextField(
- blank=True,
- help_text="Optional description or notes about the receipt",
- null=True,
- verbose_name="Description",
- ),
- ),
- (
- "transaction",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="receipts",
- to="transaction.transactionparticipant",
- verbose_name="Transaction",
- ),
- ),
- ],
- options={
- "verbose_name": "Transaction Receipt",
- "verbose_name_plural": "Transaction Receipts",
- "ordering": ["-uploaded_at"],
- },
- ),
- migrations.CreateModel(
- name="ParticipantInfo",
- fields=[
- (
- "id",
- models.BigAutoField(
- auto_created=True,
- primary_key=True,
- serialize=False,
- verbose_name="ID",
- ),
- ),
- (
- "fullname",
- models.CharField(
- help_text="Enter the full name of the user.",
- max_length=255,
- verbose_name="Full Name",
- ),
- ),
- (
- "email",
- models.EmailField(
- help_text="Enter the user's email address.",
- max_length=254,
- verbose_name="Email Address",
- ),
- ),
- (
- "phone_number",
- phonenumber_field.modelfields.PhoneNumberField(
- blank=True,
- max_length=128,
- null=True,
- region=None,
- validators=[utils.validators.validate_possible_number],
- verbose_name="phone",
- ),
- ),
- (
- "gender",
- models.CharField(
- blank=True,
- choices=[("male", "Male"), ("female", "Female")],
- help_text="Select the user's gender.",
- max_length=20,
- null=True,
- verbose_name="Gender",
- ),
- ),
- (
- "birthdate",
- models.DateField(blank=True, null=True, verbose_name="birthdate"),
- ),
- (
- "transaction_participant",
- models.ForeignKey(
- on_delete=django.db.models.deletion.CASCADE,
- related_name="participant_infos",
- to="transaction.transactionparticipant",
- verbose_name="Transaction Participant",
- ),
- ),
- ],
- ),
- ]
diff --git a/apps/transaction/migrations/0002_alter_participantinfo_options_and_more.py b/apps/transaction/migrations/0002_alter_participantinfo_options_and_more.py
deleted file mode 100644
index 3bc0270..0000000
--- a/apps/transaction/migrations/0002_alter_participantinfo_options_and_more.py
+++ /dev/null
@@ -1,40 +0,0 @@
-# Generated by Django 5.2.12 on 2026-05-03 14:09
-
-import django.db.models.deletion
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('course', '0004_alter_lessoncompletion_options_and_more'),
- ('transaction', '0001_initial'),
- migrations.swappable_dependency(settings.AUTH_USER_MODEL),
- ]
-
- operations = [
- migrations.AlterModelOptions(
- name='participantinfo',
- options={'verbose_name': 'Participant Info', 'verbose_name_plural': 'Participant Infos'},
- ),
- migrations.AlterModelOptions(
- name='transactionparticipant',
- options={'verbose_name': 'Transaction Participant', 'verbose_name_plural': 'Transaction Participants'},
- ),
- migrations.AlterField(
- model_name='transactionparticipant',
- name='course',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='course_transactions', to='course.course', verbose_name='Course'),
- ),
- migrations.AlterField(
- model_name='transactionparticipant',
- name='is_deleted',
- field=models.BooleanField(default=False, verbose_name='Is Deleted'),
- ),
- migrations.AlterField(
- model_name='transactionparticipant',
- name='user',
- field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='transactions', to=settings.AUTH_USER_MODEL, verbose_name='User'),
- ),
- ]
diff --git a/apps/transaction/migrations/0003_alter_transactionparticipant_status.py b/apps/transaction/migrations/0003_alter_transactionparticipant_status.py
deleted file mode 100644
index a5c364d..0000000
--- a/apps/transaction/migrations/0003_alter_transactionparticipant_status.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Generated by Django 5.2.12 on 2026-07-08 13:01
-
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
- dependencies = [
- ('transaction', '0002_alter_participantinfo_options_and_more'),
- ]
-
- operations = [
- migrations.AlterField(
- model_name='transactionparticipant',
- name='status',
- field=models.CharField(choices=[('pending', 'Pending'), ('waiting_approval', 'Waiting for Approval'), ('success', 'Success'), ('failed', 'Failed'), ('refunded', 'Refunded')], default='pending', max_length=20, verbose_name='Transaction Status'),
- ),
- ]
diff --git a/apps/transaction/migrations/__init__.py b/apps/transaction/migrations/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/apps/transaction/models.py b/apps/transaction/models.py
deleted file mode 100644
index d37ee61..0000000
--- a/apps/transaction/models.py
+++ /dev/null
@@ -1,128 +0,0 @@
-from django.db import models
-import os
-
-from django.utils.translation import gettext_lazy as _
-
-from apps.account.models import StudentUser, User
-from apps.course.models import Course
-from phonenumber_field.modelfields import PhoneNumberField
-from utils.validators import validate_possible_number
-
-
-def receipt_file_upload_to(instance, filename):
- return os.path.join(f"receipts/{instance.transaction.id}/{filename}")
-
-
-class TransactionParticipant(models.Model):
-
-
- class TransactionStatus(models.TextChoices):
- PENDING = 'pending', _('Pending')
- WAITING_APPROVAL = 'waiting_approval', _('Waiting for Approval')
- SUCCESS = 'success', _('Success')
- FAILED = 'failed', _('Failed')
- REFUNDED = 'refunded', _('Refunded')
-
- class PaymentMethods(models.TextChoices):
- RECEIPT = 'receipt', _('Receipt')
- FREE = 'free', _('Free')
- PAYMENT_GATEWAY = 'Payment_Gateway', _('Payment Gateway')
-
- user = models.ForeignKey(User, on_delete=models.CASCADE, related_name='transactions', verbose_name=_('User'))
- course = models.ForeignKey(Course, on_delete=models.CASCADE, related_name='course_transactions', verbose_name=_('Course'))
- payment_method=models.CharField(max_length=20, choices=PaymentMethods.choices, default=PaymentMethods.PAYMENT_GATEWAY, verbose_name=_('Transaction Payment Method'))
- # is_paid = models.BooleanField(default=False, verbose_name='Payment Status', help_text='Indicates whether the payment has been completed or not')
- price = models.DecimalField(max_digits=10, decimal_places=2, default=0.00, verbose_name=_('Transaction Price'))
- status = models.CharField(max_length=20, choices=TransactionStatus.choices, default=TransactionStatus.PENDING, verbose_name=_('Transaction Status'))
- created_at = models.DateTimeField(auto_now_add=True, verbose_name=_("Created at"))
- updated_at = models.DateTimeField(auto_now=True, verbose_name=_("Updated at"))
- is_deleted = models.BooleanField(default=False, verbose_name=_('Is Deleted'))
-
- def __str__(self):
- return f"{self.user.email} - {self.course.title} ({self.status})"
-
- def is_participant_enrolled(self):
- """بررسی اینکه آیا کاربر در دوره ثبتنام شده یا نه"""
- from apps.course.models import Participant
- return Participant.objects.filter(
- student=self.user,
- course=self.course
- ).exists()
-
- def get_participant(self):
- """دریافت شرکتکننده دوره اگر وجود داشته باشد"""
- from apps.course.models import Participant
- return Participant.objects.filter(
- student=self.user,
- course=self.course
- ).first()
-
- class Meta:
- verbose_name = _('Transaction Participant')
- verbose_name_plural = _('Transaction Participants')
-
-
-class ParticipantInfo(models.Model):
- class GenderChoices(models.TextChoices):
- MALE = 'male', _('Male')
- FEMALE = 'female', _('Female')
-
- transaction_participant = models.ForeignKey(
- TransactionParticipant,
- on_delete=models.CASCADE,
- related_name='participant_infos',
- verbose_name=_("Transaction Participant")
- )
- fullname = models.CharField(max_length=255, verbose_name=_("Full Name"), help_text=_("Enter the full name of the user."))
- email = models.EmailField(verbose_name=_("Email Address"), help_text=_("Enter the user's email address."))
- phone_number = PhoneNumberField(validators=[validate_possible_number], null=True, blank=True, verbose_name=_('phone'))
- gender = models.CharField(
- max_length=20, choices=GenderChoices.choices, null=True, blank=True, verbose_name=_('Gender'), help_text=_("Select the user's gender.")
- )
- birthdate = models.DateField(verbose_name=_('birthdate'), null=True, blank=True)
-
- def __str__(self):
- return f"{self.fullname} (Transaction: {self.transaction_participant.id}) - {self.email}"
-
- class Meta:
- verbose_name = _('Participant Info')
- verbose_name_plural = _('Participant Infos')
-
-
-class TransactionReceipt(models.Model):
- """
- Model for storing payment receipts uploaded by users for transactions
- """
- transaction = models.ForeignKey(
- TransactionParticipant,
- on_delete=models.CASCADE,
- related_name='receipts',
- verbose_name=_('Transaction')
- )
- file = models.FileField(
- upload_to=receipt_file_upload_to,
- verbose_name=_('Receipt File'),
- help_text=_('Upload payment receipt image or document')
- )
- uploaded_at = models.DateTimeField(auto_now_add=True, verbose_name=_('Uploaded At'))
- description = models.TextField(
- blank=True,
- null=True,
- verbose_name=_('Description'),
- help_text=_('Optional description or notes about the receipt')
- )
-
- class Meta:
- verbose_name = _('Transaction Receipt')
- verbose_name_plural = _('Transaction Receipts')
- ordering = ['-uploaded_at']
-
- def __str__(self):
- return f"Receipt for Transaction #{self.transaction.id} - {self.uploaded_at.strftime('%Y-%m-%d %H:%M')}"
-
-
-
-
-
-
-
diff --git a/apps/transaction/serializers.py b/apps/transaction/serializers.py
deleted file mode 100644
index 1e49e32..0000000
--- a/apps/transaction/serializers.py
+++ /dev/null
@@ -1,155 +0,0 @@
-
-from rest_framework import serializers
-
-from apps.transaction.models import TransactionParticipant, ParticipantInfo, TransactionReceipt
-from apps.course.serializers import CourseDetailSerializer
-from utils import FileFieldSerializer
-
-
-
-
-class ParticipantInfoSerializer(serializers.ModelSerializer):
- phone_number = serializers.CharField(max_length=30)
-
- class Meta:
- model = ParticipantInfo
- fields = ['fullname', 'email', 'phone_number', 'gender', 'birthdate']
-
- def validate_phone_number(self, value):
- return value
-
-
-class TransactionParticipantSerializer(serializers.ModelSerializer):
- participant_infos = ParticipantInfoSerializer(many=True)
-
- class Meta:
- model = TransactionParticipant
- fields = ['participant_infos']
-
-
- def create(self, validated_data):
- participant_infos_data = validated_data.pop('participant_infos', [])
- transaction_participant = TransactionParticipant.objects.create(**validated_data)
-
- for participant_info_data in participant_infos_data:
- ParticipantInfo.objects.create(transaction_participant=transaction_participant, **participant_info_data)
-
- return transaction_participant
-
-
-
-class TransactionListSerializer(serializers.ModelSerializer):
- course = serializers.SerializerMethodField()
- receipts = serializers.SerializerMethodField()
-
- class Meta:
- model = TransactionParticipant
- fields = ['id', 'course', 'status', 'price', 'receipts', 'created_at', 'updated_at']
-
- def get_course(self, obj):
- return CourseDetailSerializer(obj.course, context=self.context).data
-
- def get_receipts(self, obj):
- receipts = obj.receipts.all()
- return TransactionReceiptSerializer(receipts, many=True, context=self.context).data
-
-
-class TransactionReceiptSerializer(serializers.ModelSerializer):
- """
- Serializer for uploading payment receipts
- Uses FileFieldSerializer to handle pre-uploaded files from /upload-tmp-media/
- """
- file = FileFieldSerializer()
-
- class Meta:
- model = TransactionReceipt
- fields = ['id', 'file', 'description', 'uploaded_at']
- read_only_fields = ['id', 'uploaded_at']
-
-
-class UploadReceiptsSerializer(serializers.Serializer):
- """
- Serializer for uploading multiple receipt files for a transaction.
- Files should be pre-uploaded using /upload-tmp-media/ endpoint,
- then their URLs should be sent here.
- """
- files = serializers.ListField(
- child=FileFieldSerializer(),
- allow_empty=False,
- max_length=10,
- help_text="List of file URLs (max 10 files) - files should be pre-uploaded via /upload-tmp-media/"
- )
- description = serializers.CharField(
- required=False,
- allow_blank=True,
- max_length=1000,
- help_text="Optional description for the receipts"
- )
-
- def validate_files(self, files):
- """
- Validate uploaded file URLs
- """
- if len(files) > 10:
- raise serializers.ValidationError("You can upload a maximum of 10 files.")
-
- return files
-
-
-# =============================================================================
-# Admin Panel Serializers
-# =============================================================================
-
-class AdminTransactionReceiptSerializer(serializers.ModelSerializer):
- file = serializers.SerializerMethodField()
-
- class Meta:
- model = TransactionReceipt
- fields = ['id', 'file', 'description', 'uploaded_at']
-
- def get_file(self, obj):
- request = self.context.get('request')
- if obj.file:
- if request:
- return request.build_absolute_uri(obj.file.url)
- return obj.file.url
- return None
-
-
-class AdminParticipantInfoSerializer(serializers.ModelSerializer):
- phone_number = serializers.CharField(read_only=True)
-
- class Meta:
- model = ParticipantInfo
- fields = ['id', 'fullname', 'email', 'phone_number', 'gender', 'birthdate']
-
-
-class AdminTransactionSerializer(serializers.ModelSerializer):
- user_name = serializers.CharField(source='user.fullname', read_only=True)
- user_email = serializers.CharField(source='user.email', read_only=True)
- course_title = serializers.SerializerMethodField()
- receipts = AdminTransactionReceiptSerializer(many=True, read_only=True)
- participant_infos = AdminParticipantInfoSerializer(many=True, read_only=True)
-
- class Meta:
- model = TransactionParticipant
- fields = [
- 'id', 'user', 'user_name', 'user_email',
- 'course', 'course_title',
- 'price', 'status', 'payment_method',
- 'participant_infos', 'receipts',
- 'created_at', 'updated_at'
- ]
- read_only_fields = [
- 'id', 'user', 'user_name', 'user_email',
- 'course', 'course_title', 'price', 'payment_method',
- 'participant_infos', 'receipts', 'created_at', 'updated_at'
- ]
-
- def get_course_title(self, obj):
- if not obj.course:
- return None
- request = self.context.get('request')
- lang = getattr(request, 'LANGUAGE_CODE', None) or 'en'
- from apps.course.models.course import get_localized_field
- return get_localized_field(lang, obj.course.title)
\ No newline at end of file
diff --git a/apps/transaction/signals.py b/apps/transaction/signals.py
deleted file mode 100644
index 13677ec..0000000
--- a/apps/transaction/signals.py
+++ /dev/null
@@ -1,123 +0,0 @@
-from django.db.models.signals import post_save, pre_save
-from django.dispatch import receiver
-from django.db import transaction
-
-from apps.transaction.models import TransactionParticipant
-from apps.course.models import Participant
-
-
-@receiver(pre_save, sender=TransactionParticipant)
-def store_previous_status(sender, instance, **kwargs):
- """
- Store the previous status before saving to compare with new status
- """
- if instance.pk:
- try:
- previous_instance = TransactionParticipant.objects.get(pk=instance.pk)
- instance._previous_status = previous_instance.status
- except TransactionParticipant.DoesNotExist:
- instance._previous_status = None
- else:
- instance._previous_status = None
-
-
-@receiver(post_save, sender=TransactionParticipant)
-def create_participant_on_success(sender, instance, created, **kwargs):
- """
- Create course participant when transaction status changes to SUCCESS
- """
- # اگر تراکنش جدید ایجاد شده و وضعیت آن SUCCESS است
- if created and instance.status == TransactionParticipant.TransactionStatus.SUCCESS:
- create_course_participant(instance)
-
- # اگر تراکنش موجود بوده و وضعیت آن از حالت دیگری به SUCCESS تغییر کرده
- elif not created and hasattr(instance, '_previous_status'):
- if (instance._previous_status != TransactionParticipant.TransactionStatus.SUCCESS and
- instance.status == TransactionParticipant.TransactionStatus.SUCCESS):
- create_course_participant(instance)
-
-
-def create_course_participant(transaction_instance):
- """
- Create course participant for successful transaction
- """
- try:
- with transaction.atomic():
- # بررسی اینکه آیا کاربر نقش student دارد یا نه
- if not transaction_instance.user.has_role('student'):
- transaction_instance.user.add_role('student')
-
- # بررسی اینکه آیا قبلاً participant ایجاد شده یا نه
- existing_participant = Participant.objects.filter(
- student_id=transaction_instance.user.id,
- course=transaction_instance.course
- ).first()
-
- if not existing_participant:
- # ایجاد participant جدید
- participant = Participant.objects.create(
- student=transaction_instance.user,
- course=transaction_instance.course
- )
- print(f"Course participant created: {participant}")
- else:
- print(f"Course participant already exists: {existing_participant}")
-
- except Exception as e:
- print(f"Error creating course participant: {e}")
-
-
-from apps.account.notification_service import create_and_send_notification
-from apps.course.models.course import get_localized_field
-
-@receiver(post_save, sender=TransactionParticipant)
-def notify_transaction_status_changed(sender, instance, created, **kwargs):
- """
- Send notifications when transaction status transitions to SUCCESS, FAILED, or REFUNDED.
- """
- status_changed = False
-
- if created:
- status_changed = True
- elif hasattr(instance, '_previous_status') and instance._previous_status != instance.status:
- status_changed = True
-
- if not status_changed:
- return
-
- course_title_en = get_localized_field('en', instance.course.title)
- course_title_fa = get_localized_field('fa', instance.course.title)
-
- # 1. SUCCESS
- if instance.status == TransactionParticipant.TransactionStatus.SUCCESS:
- create_and_send_notification(
- user=instance.user,
- title_en="Payment Successful",
- body_en=f"Your payment for course '{course_title_en}' was successful.",
- title_fa="پرداخت موفقیتآمیز",
- body_fa=f"پرداخت شما برای دوره «{course_title_fa}» با موفقیت انجام شد.",
- service='imam-javad',
- data={'type': 'payment_successful', 'transaction_id': instance.id, 'course_id': instance.course.id}
- )
- # 2. FAILED
- elif instance.status == TransactionParticipant.TransactionStatus.FAILED:
- create_and_send_notification(
- user=instance.user,
- title_en="Payment Failed",
- body_en=f"Your payment attempt for course '{course_title_en}' failed.",
- title_fa="خطا در پرداخت",
- body_fa=f"عملیات پرداخت شما برای دوره «{course_title_fa}» ناموفق بود.",
- service='imam-javad',
- data={'type': 'payment_failed', 'transaction_id': instance.id, 'course_id': instance.course.id}
- )
- # 3. REFUNDED
- elif instance.status == TransactionParticipant.TransactionStatus.REFUNDED:
- create_and_send_notification(
- user=instance.user,
- title_en="Refund Completed",
- body_en=f"Your refund for course '{course_title_en}' has been processed.",
- title_fa="بازگشت وجه انجام شد",
- body_fa=f"مبلغ پرداختی شما برای دوره «{course_title_fa}» بازگردانده (ریفاند) شد.",
- service='imam-javad',
- data={'type': 'refund_completed', 'transaction_id': instance.id, 'course_id': instance.course.id}
- )
\ No newline at end of file
diff --git a/apps/transaction/tests.py b/apps/transaction/tests.py
deleted file mode 100644
index 08f1014..0000000
--- a/apps/transaction/tests.py
+++ /dev/null
@@ -1,137 +0,0 @@
-from django.test import TestCase
-from django.contrib.auth import get_user_model
-from apps.account.models import StudentUser
-from apps.course.models import Course, CourseCategory, Participant
-from apps.transaction.models import TransactionParticipant
-from apps.account.models import ProfessorUser
-
-User = get_user_model()
-
-
-class TransactionParticipantSignalTest(TestCase):
- def setUp(self):
- """تنظیمات اولیه برای تست"""
- # ایجاد کاربر
- self.user = User.objects.create_user(
- email='test@example.com',
- password='testpass123'
- )
-
- # ایجاد استاد
- self.professor = ProfessorUser.objects.create(
- email='professor@example.com',
- password='testpass123'
- )
-
- # ایجاد دستهبندی دوره
- self.category = CourseCategory.objects.create(
- name='Test Category',
- slug='test-category'
- )
-
- # ایجاد دوره
- self.course = Course.objects.create(
- title='Test Course',
- slug='test-course',
- category=self.category,
- professor=self.professor,
- video_type='youtube_link',
- level='beginner',
- duration=10,
- lessons_count=5,
- description='Test course description',
- is_free=False,
- price=100.00,
- final_price=100.00
- )
-
- def test_participant_created_on_success_status(self):
- """تست ایجاد participant هنگام تغییر وضعیت به SUCCESS"""
- # ایجاد تراکنش با وضعیت PENDING
- transaction = TransactionParticipant.objects.create(
- user=self.user,
- course=self.course,
- price=100.00,
- status=TransactionParticipant.TransactionStatus.PENDING
- )
-
- # بررسی که participant ایجاد نشده
- self.assertFalse(
- Participant.objects.filter(student=self.user, course=self.course).exists()
- )
-
- # تغییر وضعیت به SUCCESS
- transaction.status = TransactionParticipant.TransactionStatus.SUCCESS
- transaction.save()
-
- # بررسی که participant ایجاد شده
- self.assertTrue(
- Participant.objects.filter(student=self.user, course=self.course).exists()
- )
-
- # بررسی که کاربر نقش student دارد
- self.assertTrue(self.user.has_role('student'))
-
- def test_participant_created_on_direct_success(self):
- """تست ایجاد participant هنگام ایجاد تراکنش با وضعیت SUCCESS"""
- # ایجاد تراکنش مستقیماً با وضعیت SUCCESS
- transaction = TransactionParticipant.objects.create(
- user=self.user,
- course=self.course,
- price=100.00,
- status=TransactionParticipant.TransactionStatus.SUCCESS
- )
-
- # بررسی که participant ایجاد شده
- self.assertTrue(
- Participant.objects.filter(student=self.user, course=self.course).exists()
- )
-
- # بررسی که کاربر نقش student دارد
- self.assertTrue(self.user.has_role('student'))
-
- def test_no_duplicate_participant(self):
- """تست عدم ایجاد participant تکراری"""
- # ایجاد participant دستی
- existing_participant = Participant.objects.create(
- student=self.user,
- course=self.course
- )
-
- # ایجاد تراکنش با وضعیت SUCCESS
- transaction = TransactionParticipant.objects.create(
- user=self.user,
- course=self.course,
- price=100.00,
- status=TransactionParticipant.TransactionStatus.SUCCESS
- )
-
- # بررسی که فقط یک participant وجود دارد
- self.assertEqual(
- Participant.objects.filter(student=self.user, course=self.course).count(),
- 1
- )
-
- def test_model_helper_methods(self):
- """تست متدهای کمکی مدل"""
- # ایجاد تراکنش
- transaction = TransactionParticipant.objects.create(
- user=self.user,
- course=self.course,
- price=100.00,
- status=TransactionParticipant.TransactionStatus.PENDING
- )
-
- # بررسی که participant وجود ندارد
- self.assertFalse(transaction.is_participant_enrolled())
- self.assertIsNone(transaction.get_participant())
-
- # ایجاد participant
- participant = Participant.objects.create(
- student=self.user,
- course=self.course
- )
-
- # بررسی که participant وجود دارد
- self.assertTrue(transaction.is_participant_enrolled())
- self.assertEqual(transaction.get_participant(), participant)
diff --git a/apps/transaction/urls.py b/apps/transaction/urls.py
deleted file mode 100644
index 49862f7..0000000
--- a/apps/transaction/urls.py
+++ /dev/null
@@ -1,23 +0,0 @@
-
-from django.urls import path, re_path, include
-from rest_framework.routers import DefaultRouter, SimpleRouter
-
-from . import views
-from .views import AdminTransactionViewSet
-
-router = SimpleRouter()
-router.register(r'admin/transactions', AdminTransactionViewSet, basename='admin-transactions')
-
-# Hide admin viewsets from swagger
-for prefix, viewset, basename in router.registry:
- viewset.swagger_schema = None
-
-urlpatterns = [
- path('', include(router.urls)),
- re_path(r'(?P[\w-]+)/join/$', views.TransactionParticipantCreateView.as_view(), name='transaction-participant-create'),
- path('list/', views.TransactiontListView.as_view(), name='transaction-list'),
- path('/delete/', views.SoftDeleteTransactionParticipantView.as_view(), name='soft-delete-transaction-participant'),
- path('/receipts/upload/', views.UploadTransactionReceiptsView.as_view(), name='upload-transaction-receipts'),
- path('/receipts/', views.TransactionReceiptsListView.as_view(), name='transaction-receipts-list'),
-
-]
\ No newline at end of file
diff --git a/apps/transaction/views.py b/apps/transaction/views.py
deleted file mode 100644
index 66d6a61..0000000
--- a/apps/transaction/views.py
+++ /dev/null
@@ -1,556 +0,0 @@
-from rest_framework import generics, status
-from rest_framework.permissions import IsAuthenticated
-from rest_framework.response import Response
-from rest_framework.views import APIView
-from rest_framework.authentication import TokenAuthentication
-from django.db.models import Q
-from apps.course.models import Participant, Course
-from apps.course.models.course import extract_text_from_json
-from apps.transaction.models import TransactionParticipant, TransactionReceipt
-from apps.transaction.serializers import (
- TransactionParticipantSerializer,
- TransactionListSerializer,
- UploadReceiptsSerializer,
- TransactionReceiptSerializer
-)
-from utils.exceptions import AppAPIException
-from apps.account.models import User
-from drf_yasg.utils import swagger_auto_schema
-from drf_yasg import openapi
-from apps.transaction.models import TransactionParticipant
-from apps.transaction.doc import (
- doc_upload_transaction_receipts,
- doc_list_transaction_receipts,
- doc_transaction_list,
- doc_create_transaction
-)
-
-from utils.ip_helper import get_client_ip, get_country_code
-
-
-def find_course_by_multilingual_identifier(identifier: str):
- normalized = (identifier or "").strip()
- if not normalized:
- return None
-
- course = Course.objects.filter(slug__contains=[{"title": normalized}]).first()
- if course:
- return course
-
- course = Course.objects.filter(
- Q(title__icontains=normalized) |
- Q(slug__icontains=normalized)
- ).first()
- if course:
- return course
-
- normalized_lower = normalized.lower()
- for item in Course.objects.all().only("id", "title", "slug"):
- title_text = extract_text_from_json(item.title).lower()
- slug_text = extract_text_from_json(item.slug).lower()
- if normalized_lower in title_text or normalized_lower in slug_text:
- return item
-
- return None
-
-
-
-class TransactionParticipantCreateView(generics.CreateAPIView):
- queryset = TransactionParticipant.objects.all()
- serializer_class = TransactionParticipantSerializer
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_description=doc_create_transaction(),
- responses={
- status.HTTP_201_CREATED: openapi.Response(
- description="Transaction participant created successfully",
- examples={
- "application/json": {
- "message": "Transaction Participant created successfully.",
- "transaction_id": 374,
- "payment_method": "Payment_Gateway",
- "payment_link": "https://russia-payment.com/pay/374",
- "participant_infos": [
- {
- "fullname": "string",
- "email": "admin@gmail.com",
- "phone_number": "string",
- "gender": "male",
- "birthdate": "2025-12-28"
- }
- ]
- }
- },
- schema=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'message': openapi.Schema(type=openapi.TYPE_STRING, description="Success message"),
- 'transaction_id': openapi.Schema(type=openapi.TYPE_INTEGER, description="Unique transaction identifier"),
- 'payment_method': openapi.Schema(
- type=openapi.TYPE_STRING,
- enum=['Payment_Gateway', 'receipt'],
- description="Payment method: 'Payment_Gateway' for online payment, 'receipt' for WhatsApp upload"
- ),
- 'payment_link': openapi.Schema(
- type=openapi.TYPE_STRING,
- nullable=True,
- description="Payment gateway URL (only present when payment_method is 'Payment_Gateway')"
- ),
- 'participant_infos': openapi.Schema(
- type=openapi.TYPE_ARRAY,
- items=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'fullname': openapi.Schema(type=openapi.TYPE_STRING),
- 'email': openapi.Schema(type=openapi.TYPE_STRING),
- 'phone_number': openapi.Schema(type=openapi.TYPE_STRING),
- 'gender': openapi.Schema(type=openapi.TYPE_STRING, enum=['male', 'female']),
- 'birthdate': openapi.Schema(type=openapi.TYPE_STRING, format='date'),
- }
- ),
- description="List of participant information"
- ),
- },
- required=['message', 'transaction_id', 'participant_infos']
- )
- ),
- status.HTTP_400_BAD_REQUEST: openapi.Response(
- description="Invalid data provided",
- schema=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'detail': openapi.Schema(type=openapi.TYPE_STRING),
- }
- )
- ),
- status.HTTP_404_NOT_FOUND: openapi.Response(
- description="Course not found",
- schema=openapi.Schema(
- type=openapi.TYPE_OBJECT,
- properties={
- 'message': openapi.Schema(type=openapi.TYPE_STRING),
- }
- )
- ),
- },
- tags=['Imam-Javad - Transaction']
- )
- def post(self, request, *args, **kwargs):
- # Simply call the create method
- return self.create(request, *args, **kwargs)
-
- def create(self, request, *args, **kwargs):
- user = request.user
- course_slug = self.kwargs.get('slug')
-
- # 1. Retrieve Course
- course = find_course_by_multilingual_identifier(course_slug)
- if not course:
- raise AppAPIException({'message': "Course not found"})
-
- participant_infos = request.data.get('participant_infos', [])
-
- # 2. Validate and Initialize
- serializer = self.get_serializer(data=request.data)
- serializer.is_valid(raise_exception=True)
- statis = TransactionParticipant.TransactionStatus.PENDING
-
- # 3. Handle Free/Self-Enrollment Logic
- if len(participant_infos) == 1 and (course.final_price == 0 or course.is_free):
- participant = participant_infos[0]
- if participant.get('email') != user.email:
- raise AppAPIException({'message': "The email must be for the requesting user"})
-
- if not user.has_role('student'):
- user.add_role('student')
-
- existing_participant = Participant.objects.filter(student=user, course=course).first()
- if existing_participant:
- participant = existing_participant
- else:
- participant = Participant.objects.create(student=user, course=course)
- statis = TransactionParticipant.TransactionStatus.SUCCESS
-
- # 4. Save Transaction
- transaction_participant = serializer.save(
- user=user,
- course=course,
- price=course.final_price,
- status=statis
- )
- print(f'---> {type(transaction_participant)}/ {transaction_participant}')
-
- # 5. Update user birthdate based on participant infos
- validated_participant_infos = serializer.validated_data.get('participant_infos', [])
- for info in validated_participant_infos:
- email = info.get('email')
- birthdate = info.get('birthdate')
- if email and birthdate:
- try:
- target_user = User.objects.filter(email__iexact=email.strip()).first()
- if target_user:
- target_user.birthdate = birthdate
- target_user.save(update_fields=['birthdate'])
- except Exception as e:
- print(f"Error updating user birthdate: {e}")
-
- # =======================================================
- # NEW LOGIC: HYBRID GEOLOCATION CHECK (Cloudflare + Local DB)
- # =======================================================
-
- payment_link = None
-
- payment_method = TransactionParticipant.PaymentMethods.FREE
- if statis == TransactionParticipant.TransactionStatus.PENDING:
-
- # Step A: Fast Path - Check Cloudflare Header
- # Cloudflare sends the 2-letter code (e.g., 'RU', 'US') in this header
- country_code = request.META.get('HTTP_CF_IPCOUNTRY')
-
- # Step B: Slow Path - Fallback to Local DB
- # If header is missing (e.g., Localhost, direct connection, or CF failed)
- if not country_code:
- try:
- client_ip =get_client_ip(request)
- # "188.93.104.1"
- # get_client_ip(request)
- # Assuming your helper handles errors gracefully and returns None
- country_code = get_country_code(client_ip)
- except Exception as e:
- print(f"GeoIP Lookup Failed: {e}")
- country_code = None
- payment_method = TransactionParticipant.PaymentMethods.RECEIPT
- # Step C: Apply Logic
- if country_code != 'RU':
- payment_method = TransactionParticipant.PaymentMethods.PAYMENT_GATEWAY
- payment_link = f"https://russia-payment.com/pay/{transaction_participant.id}"
-
- # Uncomment if you want a global fallback link
- # else:
- # payment_link = f"https://global-payment.com/pay/{transaction_participant.id}"
-
- # =======================================================
-
- return Response({
- 'message': 'Transaction Participant created successfully.',
- 'transaction_id': transaction_participant.id,
- 'payment_method':payment_method,
- 'payment_link': payment_link,
- 'participant_infos': serializer.data['participant_infos']
- }, status=status.HTTP_201_CREATED)
-
-
-
-
-from utils.pagination import StandardResultsSetPagination
-
-
-
-class TransactiontListView(generics.ListAPIView):
- queryset = TransactionParticipant.objects.all()
- serializer_class = TransactionListSerializer
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
-
- @swagger_auto_schema(
- operation_description=doc_transaction_list(),
- tags=['Imam-Javad - Transaction']
- )
- def get(self, request, *args, **kwargs):
- return self.list(request, *args, **kwargs)
- def get_queryset(self):
- queryset = super().get_queryset()
- queryset = queryset.filter(user=self.request.user, is_deleted=False)
- return queryset
-
-
-
-class SoftDeleteTransactionParticipantView(APIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_summary="Soft delete a transaction participant",
- operation_description="Marks a transaction participant as deleted without removing it from the database",
- tags=['Imam-Javad - Transaction'],
- manual_parameters=[
- openapi.Parameter(
- 'id',
- openapi.IN_PATH,
- description="Transaction Participant ID",
- type=openapi.TYPE_INTEGER,
- required=True
- )
- ],
- responses={
- 200: openapi.Response(
- description="Transaction participant successfully marked as deleted",
- examples={
- "application/json": {
- "success": True,
- "message": "Transaction participant successfully marked as deleted"
- }
- }
- ),
- 404: "Transaction participant not found",
- 403: "Permission denied"
- }
- )
- def delete(self, request, pk):
- try:
- transaction = TransactionParticipant.objects.get(pk=pk)
- if transaction.user == request.user:
- transaction.is_deleted = True
- transaction.save()
- return Response({
- "success": True,
- "message": "Transaction participant successfully marked as deleted"
- }, status=status.HTTP_200_OK)
- else:
- raise AppAPIException(
- detail={'message': "You don't have permission to delete this transaction"},
- status_code=status.HTTP_403_FORBIDDEN
- )
-
- except TransactionParticipant.DoesNotExist:
- raise AppAPIException({'message': "Transaction participant not found"})
-
-
-class UploadTransactionReceiptsView(APIView):
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
-
- @swagger_auto_schema(
- operation_summary="Upload payment receipts for a transaction",
- operation_description=doc_upload_transaction_receipts(),
- tags=['Imam-Javad - Transaction'],
- request_body=UploadReceiptsSerializer,
- responses={
- 201: openapi.Response(
- description="Receipts uploaded successfully",
- examples={
- "application/json": {
- "success": True,
- "message": "Receipts uploaded successfully",
- "transaction_status": "waiting_approval",
- "receipts": [
- {
- "id": 1,
- "file": "http://example.com/media/receipts/1/receipt.jpg",
- "description": "Payment receipt",
- "uploaded_at": "2025-12-03T10:30:00Z"
- }
- ]
- }
- }
- ),
- 400: "Invalid data or transaction cannot accept receipts",
- 403: "Permission denied",
- 404: "Transaction not found"
- }
- )
- def post(self, request, transaction_id):
- try:
- transaction = TransactionParticipant.objects.get(pk=transaction_id, is_deleted=False)
- except TransactionParticipant.DoesNotExist:
- raise AppAPIException({'message': "Transaction not found"})
-
- # Check if user owns this transaction
- if transaction.user != request.user:
- raise AppAPIException(
- detail={'message': "You don't have permission to upload receipts for this transaction"},
- status_code=status.HTTP_403_FORBIDDEN
- )
-
- # Check if transaction is in a state that can accept receipts
- if transaction.status not in [
- TransactionParticipant.TransactionStatus.PENDING,
- TransactionParticipant.TransactionStatus.WAITING_APPROVAL
- ]:
- raise AppAPIException(
- detail={'message': f"Cannot upload receipts for transaction with status '{transaction.status}'"},
- status_code=status.HTTP_400_BAD_REQUEST
- )
-
- # Validate using serializer
- serializer = UploadReceiptsSerializer(data=request.data, context={'request': request})
- serializer.is_valid(raise_exception=True)
-
- # Create receipt records
- receipts = []
- description = serializer.validated_data.get('description', '')
- file_urls = serializer.validated_data.get('files', [])
-
- for file_url in file_urls:
- receipt = TransactionReceipt.objects.create(
- transaction=transaction,
- file=file_url,
- description=description
- )
- receipts.append(receipt)
-
- # Update transaction status to waiting_approval
- transaction.status = TransactionParticipant.TransactionStatus.WAITING_APPROVAL
- transaction.save()
-
- # Serialize receipts for response
- receipts_data = TransactionReceiptSerializer(receipts, many=True, context={'request': request}).data
-
- return Response({
- 'success': True,
- 'message': 'Receipts uploaded successfully',
- 'transaction_status': transaction.status,
- 'receipts': receipts_data
- }, status=status.HTTP_201_CREATED)
-
-
-class TransactionReceiptsListView(generics.ListAPIView):
- serializer_class = TransactionReceiptSerializer
- permission_classes = [IsAuthenticated]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
-
- @swagger_auto_schema(
- operation_summary="List receipts for a transaction",
- operation_description=doc_list_transaction_receipts(),
- tags=['Imam-Javad - Transaction'],
- manual_parameters=[
- openapi.Parameter(
- 'transaction_id',
- openapi.IN_PATH,
- description="Transaction ID",
- type=openapi.TYPE_INTEGER,
- required=True
- )
- ],
- responses={
- 200: TransactionReceiptSerializer(many=True),
- 403: "Permission denied",
- 404: "Transaction not found"
- }
- )
- def get(self, request, *args, **kwargs):
- return self.list(request, *args, **kwargs)
-
- def get_queryset(self):
- transaction_id = self.kwargs.get('transaction_id')
-
- try:
- transaction = TransactionParticipant.objects.get(pk=transaction_id, is_deleted=False)
- except TransactionParticipant.DoesNotExist:
- raise AppAPIException({'message': "Transaction not found"})
-
- # Check if user owns this transaction
- if transaction.user != self.request.user:
- raise AppAPIException(
- detail={'message': "You don't have permission to view receipts for this transaction"},
- status_code=status.HTTP_403_FORBIDDEN
- )
-
- return TransactionReceipt.objects.filter(transaction=transaction)
-
-
-# =============================================================================
-# Admin Panel ViewSet
-# =============================================================================
-
-from rest_framework.viewsets import ModelViewSet
-from apps.transaction.serializers import AdminTransactionSerializer
-from apps.account.permissions import IsPanelUser, IsSuperAdmin
-from django.db.models import Q
-from utils.pagination import StandardResultsSetPagination
-
-
-def is_professor(request):
- return getattr(request.user, 'user_type', None) == 'professor'
-
-
-class AdminTransactionViewSet(ModelViewSet):
- """
- Admin-only viewset for viewing and updating transactions.
- Only GET (list/retrieve) and PATCH (update status) are allowed.
- Professors only see transactions for their own courses.
- """
- queryset = TransactionParticipant.objects.all()
- serializer_class = AdminTransactionSerializer
-
- permission_classes = [IsAuthenticated, IsSuperAdmin]
- authentication_classes = [TokenAuthentication]
- pagination_class = StandardResultsSetPagination
- http_method_names = ['get', 'patch', 'head', 'options']
-
- def get_queryset(self):
- queryset = TransactionParticipant.objects.all().select_related('user', 'course').prefetch_related('receipts', 'participant_infos')
-
- # Professors can only see transactions for their own courses
- if is_professor(self.request):
- queryset = queryset.filter(course__professors=self.request.user)
-
- # Search
- search_query = self.request.query_params.get('search', None)
- has_search = False
- if search_query:
- has_search = True
- matching_course_ids = list(
- Course.objects.filter(
- Q(title__icontains=search_query) |
- Q(slug__icontains=search_query)
- ).values_list("id", flat=True)
- )
- if not matching_course_ids:
- normalized_search = search_query.lower().strip()
- matching_course_ids = [
- course.id
- for course in Course.objects.all().only("id", "title", "slug")
- if normalized_search in extract_text_from_json(course.title).lower()
- or normalized_search in extract_text_from_json(course.slug).lower()
- ]
-
- from django.db.models import Case, When, Value, IntegerField
- queryset = queryset.filter(
- Q(user__fullname__icontains=search_query) |
- Q(user__email__icontains=search_query) |
- Q(course_id__in=matching_course_ids)
- ).annotate(
- search_relevance=Case(
- When(user__fullname__icontains=search_query, then=Value(3)),
- When(user__email__icontains=search_query, then=Value(2)),
- When(course_id__in=matching_course_ids, then=Value(1)),
- default=Value(0),
- output_field=IntegerField()
- )
- )
-
- # Status filter
- status_param = self.request.query_params.get('status', None)
- if status_param:
- queryset = queryset.filter(status=status_param)
-
- # Course filter
- course_id = self.request.query_params.get('course', None)
- if course_id:
- queryset = queryset.filter(course_id=course_id)
-
- # Payment method filter
- payment_method = self.request.query_params.get('payment_method', None)
- if payment_method:
- queryset = queryset.filter(payment_method=payment_method)
-
- transaction_date = self.request.query_params.get('date', None)
- if transaction_date:
- queryset = queryset.filter(created_at__date=transaction_date)
-
- date_after = self.request.query_params.get('date_after', None)
- if date_after:
- queryset = queryset.filter(created_at__date__gte=date_after)
-
- date_before = self.request.query_params.get('date_before', None)
- if date_before:
- queryset = queryset.filter(created_at__date__lte=date_before)
-
- if has_search:
- return queryset.order_by('-search_relevance', '-created_at')
- return queryset.order_by('-created_at')
diff --git a/config/middleware/site_middleware.py b/config/middleware/site_middleware.py
index 9e3a169..24cc65d 100644
--- a/config/middleware/site_middleware.py
+++ b/config/middleware/site_middleware.py
@@ -20,13 +20,6 @@ class SiteMiddleware:
self.get_response = get_response
def __call__(self, request):
- host = request.get_host()
-
- # Check if the request is from Dovoodi domain
- if 'dovodi' in host or 'dovoodi' in host:
- request.urlconf = 'config.urls_dovoodi'
- # Otherwise, use Imam Javad configuration (default)
- else:
- request.urlconf = 'config.urls_imamjavad'
-
+ # Force Dovoodi URL configuration for all domains
+ request.urlconf = 'config.urls_dovoodi'
return self.get_response(request)
diff --git a/config/settings/base.py b/config/settings/base.py
index 23fd839..d7525f9 100644
--- a/config/settings/base.py
+++ b/config/settings/base.py
@@ -46,11 +46,6 @@ X_FRAME_OPTIONS = 'SAMEORIGIN'
LOCAL_APPS = [
'apps.account.apps.AccountConfig',
'apps.api.apps.ApiConfig',
- 'apps.course.apps.CourseConfig',
- 'apps.chat.apps.ChatConfig',
- 'apps.quiz.apps.QuizConfig',
- 'apps.transaction.apps.TransactionConfig',
- 'apps.certificate.apps.CertificateConfig',
'apps.hadis.apps.HadisConfig',
'apps.library.apps.LibraryConfig',
'apps.video.apps.VideoConfig',
@@ -58,7 +53,6 @@ LOCAL_APPS = [
'apps.bookmark.apps.BookmarkConfig',
'apps.article.apps.ArticleConfig',
'apps.dobodbi_calendar.apps.DobodbiCalendarConfig',
- 'apps.blog.apps.BlogConfig',
'apps.agent.apps.AgentConfig',
'dynamic_preferences',
'apps.geolocation_package',
@@ -391,21 +385,7 @@ LOGIN_REDIRECT_URL = reverse_lazy("home")
######################################################################
from utils.admin import admin_url_generator , is_dovoodi_panel , is_main_panel
-# --- ENHANCED DYNAMIC BADGE FUNCTION ---
-def get_pending_certificates_badge(request):
- try:
- from apps.certificate.models import Certificate
- qs = Certificate.objects.filter(status='pending')
-
- # If user is a professor (not staff/admin), only show their pending certificates
- if request.user.is_authenticated and not request.user.is_staff and not getattr(request.user, 'is_superuser', False):
- qs = qs.filter(course__professor=request.user)
-
- count = qs.count()
- return str(count) if count > 0 else None
- except Exception as e:
- print(f"Badge Error: {e}") # Fails safely in terminal if DB isn't migrated yet
- return None
+# get_pending_certificates_badge removed
UNFOLD = {
# "SITE_TITLE": _("Imam Jawad Admin"),
@@ -536,78 +516,7 @@ UNFOLD = {
},
],
},
- {
- "page": "courses",
- "models": [
- "course.course",
- "course.courselesson",
- "course.courseglossary",
- "course.courseattachment",
- "quiz.quiz",
- "quiz.quizparticipant",
- ],
- "items": [
- {
- "title": _("Courses"),
- "icon": "school",
- "link": lambda request: admin_url_generator(request, "course_course_changelist"),
- "active": lambda request: request.path.startswith(str(lambda request: admin_url_generator(request, "course_course_changelist"))),
- },
- {
- "title": _("Course Lessons"),
- "icon": "menu_book",
- "link": lambda request: admin_url_generator(request, "course_courselesson_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_courselesson_changelist")),
- },
- {
- "title": _("Course Attachments"),
- "icon": "attach_file",
- "link": lambda request: admin_url_generator(request, "course_courseattachment_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_courseattachment_changelist")),
- },
- {
- "title": _("Course Glossary"),
- "icon": "book",
- "link": lambda request: admin_url_generator(request, "course_courseglossary_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_courseglossary_changelist")),
- },
- {
- "title": _("Quizzes"),
- "icon": "quiz",
- "link": lambda request: admin_url_generator(request, "quiz_quiz_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "quiz_quiz_changelist")),
- },
-
- ],
- },
- {
- "page": "course_online",
- "models": [
- "course.courselivesession",
- "course.livesessionuser",
- "course.livesessionrecording",
- ],
- "items": [
- {
- "title": _("Live Sessions"),
- "icon": "video_call",
- "link": lambda request: admin_url_generator(request, "course_courselivesession_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_courselivesession_changelist")),
- },
- {
- "title": _("Session Users"),
- "icon": "groups",
- "link": lambda request: admin_url_generator(request, "course_livesessionuser_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_livesessionuser_changelist")),
- },
- {
- "title": _("Session Recordings"),
- "icon": "play_circle",
- "link": lambda request: admin_url_generator(request, "course_livesessionrecording_changelist"),
- "active": lambda request: request.path.startswith(admin_url_generator(request, "course_livesessionrecording_changelist")),
- },
- ],
- },
+ # Courses and online course tabs removed
{
"page": "podcast",
"models": ["podcast.podcastcollection", "podcast.pinnedpodcastcollection", "podcast.middlepodcastcollection"],
@@ -681,74 +590,7 @@ UNFOLD = {
},
],
},
- # --- 3. ACADEMICS (Collapsible) ---
- {
- "title": _("Courses"),
- "collapsible": True,
- "separator": True,
- "permission": is_main_panel,
- "items": [
- {
- "title": _("Categories"),
- "icon": "category",
- "link": lambda request: admin_url_generator(request, "course_coursecategory_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Courses"),
- "icon": "school",
- "link": lambda request: admin_url_generator(request, "course_course_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Live Sessions"),
- "icon": "video_camera_front",
- "link": lambda request: admin_url_generator(request, "course_courselivesession_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Certificates"),
- "icon": "workspace_premium",
- "link": lambda request: admin_url_generator(request, "certificate_certificate_changelist"),
- "permission": is_main_panel,
- "badge": "utils.admin.get_pending_certificates_badge",
- },
- ]
- },
-
- # --- 4. ASSESSMENTS ---
- {
- "title": _(""),
- "separator": True,
- "permission": is_main_panel,
- "items": [
- {
- "title": _("Transactions"),
- "icon": "payments",
- "link": lambda request: admin_url_generator(request, "transaction_transactionparticipant_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Chat Rooms"),
- "icon": "forum",
- "link": lambda request: admin_url_generator(request, "chat_roommessage_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Blogs"),
- "icon": "article",
- "link": lambda request: admin_url_generator(request, "blog_blog_changelist"),
- "permission": is_main_panel,
- },
- {
- "title": _("Live Chat"),
- "icon": "forum", # آیکون چت
- "link": lambda request: admin_url_generator(request, "live_chat_dashboard"),
- "permission": is_main_panel,
- "badge": "utils.admin.get_unread_chat_messages_badge",
- },
- ]
- },
+ # Academics and Assessments sidebar sections removed
# --- DOVOODI SECTIONS ---
{
"title": _("Libraries"),
diff --git a/config/urls.py b/config/urls.py
index 0cdf656..7ede0fe 100644
--- a/config/urls.py
+++ b/config/urls.py
@@ -38,7 +38,7 @@ import requests
from filer import views
# Import custom API views
-from apps.api.views import CustomAPIDocumentationView, CustomSwaggerView, SwaggerTokenAuthView, clear_swagger_auth ,admin_dashboard, ProfessorDashboardStatsView
+from apps.api.views import CustomAPIDocumentationView, CustomSwaggerView, SwaggerTokenAuthView, clear_swagger_auth
from apps.api.permissions import IsAdminOrSwaggerToken
from apps.api.decorators import swagger_auth_required
@@ -72,10 +72,6 @@ api_patterns = [
path('list/', include('apps.api.urls')),
path('account/', include('apps.account.urls')),
- path('courses/', include('apps.course.urls')),
- path('quiz/', include('apps.quiz.urls')),
- path('transaction/', include('apps.transaction.urls')),
- path('certificates/', include('apps.certificate.urls')),
path('hadis/', include('apps.hadis.urls')),
path('library/', include('apps.library.urls')),
path('videos/', include('apps.video.urls')),
@@ -84,10 +80,6 @@ api_patterns = [
path('agent/', include('apps.agent.urls')),
path('bookmarks/', include('apps.bookmark.urls')),
path('calendar/', include('apps.dobodbi_calendar.urls')),
- path('blog/', include('apps.blog.urls')),
- path('chat/', include('apps.chat.urls')),
- path('admin/dashboard-stats/' , admin_dashboard.AdminDashboardStatsView.as_view()),
- path('professor/dashboard-stats/' , ProfessorDashboardStatsView.as_view()),
path('settings/', include('dynamic_preferences.urls')),
diff --git a/utils/admin.py b/utils/admin.py
index 097ec96..9b7890e 100644
--- a/utils/admin.py
+++ b/utils/admin.py
@@ -32,6 +32,41 @@ def slugify(value):
return _unicode_slugify(value)
# -------------------------------------------------------
+# Unfold Imports
+import json
+import random
+from functools import lru_cache
+
+from django import forms
+from django.conf import settings
+from django.contrib.humanize.templatetags.humanize import intcomma
+from django.urls import reverse, path
+from django.utils.safestring import mark_safe
+from django.utils.translation import gettext_lazy as _
+from django.views.generic import RedirectView
+from django.utils.translation import get_language
+from django.http import JsonResponse
+from django.utils.html import format_html
+from django.views.decorators.http import require_POST
+
+# --- AGGRESSIVE UNICODE PATCH FOR UNFOLD 0.64.1 TABS ---
+import django.utils.text
+from django.template.defaultfilters import register
+
+_original_slugify = django.utils.text.slugify
+
+def _unicode_slugify(value, allow_unicode=True):
+ # We forcefully pass allow_unicode=True to preserve Russian characters for tab IDs
+ return _original_slugify(value, allow_unicode=True)
+
+django.utils.text.slugify = _unicode_slugify
+
+# We must also override the template filter explicitly because Unfold calls it directly in 0.64.1
+@register.filter(is_safe=True)
+def slugify(value):
+ return _unicode_slugify(value)
+# -------------------------------------------------------
+
# Unfold Imports
from unfold.sites import UnfoldAdminSite
@@ -41,29 +76,21 @@ from unfold.sites import UnfoldAdminSite
def is_dovoodi_panel(request):
"""
- Returns True if the user is accessing the Dovoodi admin panel.
- Checks if 'dovodi' or 'dovoodi' is in the host domain, or if '/dovoodi/'
- exists anywhere in the path.
+ Returns True unconditionally as the system is now locked to Dovoodi domain features.
"""
- host = request.get_host()
- return 'dovodi' in host or 'dovoodi' in host or '/dovoodi/' in request.path
+ return True
def is_main_panel(request):
"""Returns True if the user is accessing the Main (Imam Javad) admin panel."""
- return not is_dovoodi_panel(request)
+ return False
def admin_url_generator(request, url_name):
"""
Dynamically generates admin URLs based on the current active panel.
"""
- _ = project_admin_site.urls
_ = dovoodi_admin_site.urls
- if is_dovoodi_panel(request):
- namespace = 'dovoodi_admin'
- else:
- namespace = 'imam_javad_admin'
-
+ namespace = 'dovoodi_admin'
full_view_name = f"{namespace}:{url_name}"
try:
@@ -72,50 +99,10 @@ def admin_url_generator(request, url_name):
return "#"
def get_pending_certificates_badge(request):
- """Generates the integer for the sidebar badge"""
- try:
- from apps.certificate.models import Certificate
- qs = Certificate.objects.filter(status='pending')
-
- if request.user.is_authenticated and not request.user.is_staff and not getattr(request.user, 'is_superuser', False):
- qs = qs.filter(course__professor=request.user)
-
- count = qs.count()
- return count if count > 0 else None
- except Exception as e:
- print(f"Badge Error: {e}")
- return None
+ return None
def get_unread_chat_messages_badge(request):
- """Generates the integer for the Live Chat sidebar badge"""
- try:
- from apps.chat.models import RoomMessage, ChatMessage
- from django.db.models import Q
-
- user = request.user
- if not user.is_authenticated:
- return None
-
- personal_q = Q(initiator=user) | Q(recipient=user)
-
- if user.is_superuser or getattr(user, 'has_role', lambda x: False)('admin') or getattr(user, 'has_role', lambda x: False)('super_admin') or getattr(user, 'has_role', lambda x: False)('consultant'):
- room_filter = personal_q | Q(room_type=RoomMessage.RoomTypeChoices.GROUP)
- else:
- room_filter = personal_q | \
- Q(room_type=RoomMessage.RoomTypeChoices.GROUP, course__professor=user) | \
- Q(room_type=RoomMessage.RoomTypeChoices.GROUP, course__participants__student=user, course__participants__is_active=True)
-
- rooms = RoomMessage.objects.filter(room_filter)
-
- count = ChatMessage.objects.filter(
- room__in=rooms,
- is_read=False
- ).exclude(sender=user).count()
-
- return count if count > 0 else None
- except Exception as e:
- print(f"Chat Badge Error: {e}")
- return None
+ return None
def variables(request):
return {"plausible_domain": getattr(settings, 'PLAUSIBLE_DOMAIN', '')}
@@ -187,19 +174,8 @@ class FormulaAdminSite(UnfoldAdminSite):
def get_urls(self):
urls = super().get_urls()
- from apps.chat.admin_views import live_chat_dashboard_view, api_get_rooms, api_get_messages, api_send_message, api_create_or_get_room , api_get_users
custom_urls = [
path('toggle_sidebar/', toggle_sidebar, name='toggle_sidebar'),
-
- # روت اصلی صفحه:
- path('live-chat/', self.admin_view(live_chat_dashboard_view), name='live_chat_dashboard'),
-
- # روتهای API برای Polling جاوااسکریپت:
- path('live-chat/api/rooms/', self.admin_view(api_get_rooms), name='live_chat_api_rooms'),
- path('live-chat/api/messages//', self.admin_view(api_get_messages), name='live_chat_api_messages'),
- path('live-chat/api/send//', self.admin_view(api_send_message), name='live_chat_api_send'),
- path('live-chat/api/create-or-get-room/', self.admin_view(api_create_or_get_room), name='live_chat_api_create_room'),
- path('live-chat/api/get-users/', self.admin_view(api_get_users), name='live_chat_api_users'),
]
return custom_urls + urls
@@ -500,8 +476,6 @@ class HomeView(RedirectView):
def dashboard_callback(request, context):
from django.apps import apps
- from django.db.models import Count, Sum
- from django.utils import timezone
if context is None:
context = {}
@@ -510,118 +484,28 @@ def dashboard_callback(request, context):
"navigation": [{"title": _("Dashboard"), "link": "/", "active": True}],
"kpi": [],
"top_courses": [],
- "tx_stats": {}, # New dict for our multi-segment donut chart
+ "tx_stats": {},
})
if not hasattr(request, "user") or not request.user.is_authenticated:
return context
- # -------------------------------------------------------------
- # 1. IMAM JAVAD PANEL STATS
- # -------------------------------------------------------------
- if is_main_panel(request):
- try:
- StudentUser = apps.get_model('account', 'StudentUser')
- ProfessorUser = apps.get_model('account', 'ProfessorUser')
- Course = apps.get_model('course', 'Course')
- Blog = apps.get_model('blog', 'Blog')
- Certificate = apps.get_model('certificate', 'Certificate')
- Transaction = apps.get_model('transaction', 'TransactionParticipant')
-
- # --- 1. Basic Counts ---
- active_students = StudentUser.objects.filter(is_active=True).count()
- active_professors = ProfessorUser.objects.filter(is_active=True).count()
- active_courses = Course.objects.exclude(status='inactive').count()
- total_blogs = Blog.objects.count()
-
- # --- 2. Certificates ---
- certs_qs = Certificate.objects.filter(status='pending')
- if not request.user.is_staff and not getattr(request.user, 'is_superuser', False):
- certs_qs = certs_qs.filter(course__professor=request.user)
- pending_certs = certs_qs.count()
-
- # --- 3. Revenue (Last 30 Days) ---
- thirty_days_ago = timezone.now() - timezone.timedelta(days=30)
- revenue_data = Transaction.objects.filter(
- status='success',
- created_at__gte=thirty_days_ago
- ).aggregate(Sum('price'))
- revenue = revenue_data['price__sum'] or 0
-
- # --- 4. Transaction Multi-Status Breakdown ---
- total_tx = Transaction.objects.count()
- if total_tx > 0:
- success_count = Transaction.objects.filter(status='success').count()
- pending_count = Transaction.objects.filter(status='pending').count()
- waiting_count = Transaction.objects.filter(status='waiting_approval').count()
- failed_count = Transaction.objects.filter(status='failed').count()
-
- # Calculate percentages
- pct_success = (success_count / total_tx) * 100
- pct_pending = (pending_count / total_tx) * 100
- pct_waiting = (waiting_count / total_tx) * 100
- pct_failed = (failed_count / total_tx) * 100
-
- # Calculate SVG Dash Offsets (Accumulative for overlapping circles)
- offset_success = 100 - pct_success
- offset_pending = 100 - (pct_success + pct_pending)
- offset_waiting = 100 - (pct_success + pct_pending + pct_waiting)
- offset_failed = 100 - (pct_success + pct_pending + pct_waiting + pct_failed) # Should be 0
- else:
- pct_success = pct_pending = pct_waiting = pct_failed = 0
- offset_success = offset_pending = offset_waiting = offset_failed = 100
-
- context["tx_stats"] = {
- "total": total_tx,
- "pct_success": round(pct_success, 1),
- "pct_pending": round(pct_pending, 1),
- "pct_waiting": round(pct_waiting, 1),
- "pct_failed": round(pct_failed, 1),
- # Format as strings to prevent Django from converting dots to commas in Russian
- "offset_success": f"{offset_success:.2f}",
- "offset_pending": f"{offset_pending:.2f}",
- "offset_waiting": f"{offset_waiting:.2f}",
- }
+ try:
+ Video = apps.get_model('video', 'Video')
+ Book = apps.get_model('library', 'Book')
+ Article = apps.get_model('article', 'Article')
+ Hadis = apps.get_model('hadis', 'Hadis')
+ Podcast = apps.get_model('podcast', 'Podcast')
+
+ total_multimedia = Video.objects.count() + Podcast.objects.count()
+ total_reading = Book.objects.count() + Article.objects.count()
- # --- 5. Top 5 Courses ---
- top_courses = Course.objects.select_related('professor').annotate(
- participant_count=Count('participants')
- ).order_by('-participant_count')[:5]
-
- context["top_courses"] = top_courses
-
- # --- Map to KPIs ---
- context["kpi"] = [
- {"title": _("Active Students"), "metric": f"{active_students:,}"},
- {"title": _("Professors"), "metric": f"{active_professors:,}"},
- {"title": _("Active Courses"), "metric": f"{active_courses:,}"},
- {"title": _("Total Blogs"), "metric": f"{total_blogs:,}"},
- {"title": _("30-Day Revenue"), "metric": f"${revenue:,.2f}", "footer": format_html('+ {}', _("Updated Today"))},
- {"title": _("Pending Certificates"), "metric": f"{pending_certs:,}", "footer": format_html('{}', _("Requires Action")) if pending_certs > 0 else ""},
- ]
- except Exception as e:
- print(f"Dashboard KPI Error (Main Panel): {e}")
-
- # -------------------------------------------------------------
- # 2. DOVOODI PANEL STATS
- # -------------------------------------------------------------
- else:
- try:
- Video = apps.get_model('video', 'Video')
- Book = apps.get_model('library', 'Book')
- Article = apps.get_model('article', 'Article')
- Hadis = apps.get_model('hadis', 'Hadis')
- Podcast = apps.get_model('podcast', 'Podcast')
-
- total_multimedia = Video.objects.count() + Podcast.objects.count()
- total_reading = Book.objects.count() + Article.objects.count()
-
- context["kpi"] = [
- {"title": _("Hadith Database"), "metric": f"{Hadis.objects.count():,}"},
- {"title": _("Books & Articles"), "metric": f"{total_reading:,}"},
- {"title": _("Multimedia"), "metric": f"{total_multimedia:,}"},
- ]
- except Exception as e:
- print(f"Dashboard KPI Error (Dovoodi Panel): {e}")
-
+ context["kpi"] = [
+ {"title": _("Hadith Database"), "metric": f"{Hadis.objects.count():,}"},
+ {"title": _("Books & Articles"), "metric": f"{total_reading:,}"},
+ {"title": _("Multimedia"), "metric": f"{total_multimedia:,}"},
+ ]
+ except Exception as e:
+ print(f"Dashboard KPI Error (Dovoodi Panel): {e}")
+
return context