""" Complaint signals - Automatic SMS notifications on status changes This module handles automatic SMS notifications to complainants when: 1. Complaint is created (confirmation) 2. Complaint status changes to resolved or closed 3. Auto-sync department from staff when staff is assigned """ import logging from django.db.models.signals import pre_save, post_save from django.dispatch import receiver from django.contrib.sites.shortcuts import get_current_site from .models import Complaint, ComplaintUpdate logger = logging.getLogger(__name__) @receiver(pre_save, sender=Complaint) def sync_department_from_staff(sender, instance, **kwargs): """ Automatically set complaint.department from staff.department when staff is assigned. This ensures the department is always in sync with the assigned staff member, regardless of how the complaint is saved (API, admin, forms, etc.). """ if instance.staff: # If staff is assigned, set department from staff's department staff_department = instance.staff.department if staff_department and instance.department_id != staff_department.id: instance.department = staff_department logger.info( f"Complaint #{instance.id}: Auto-synced department to '{staff_department.name}' " f"from staff '{instance.staff.name}'" ) elif instance.pk: # If staff is being removed (set to None), check if we should clear department # Only clear if the department was originally from a staff member # We keep the department if it was manually set pass @receiver(post_save, sender=Complaint) def send_complaint_creation_sms(sender, instance, created, **kwargs): """ Send SMS notification when complaint is created. Only sends for public complaints (those with contact_phone). """ if not created: return # Only send SMS if phone number is provided if not instance.contact_phone: logger.info(f"Complaint #{instance.id} created but no phone number provided. Skipping SMS.") return # Send SMS notification try: from apps.notifications.services import NotificationService # Get tracking URL tracking_url = instance.get_tracking_url() # Bilingual SMS messages messages = { 'en': f"PX360: Your complaint #{instance.reference_number} has been received. Track: {tracking_url}", 'ar': f"PX360: تم استلام شكوتك #{instance.reference_number}. تتبع الشكوى: {tracking_url}" } # Default to English (can be enhanced to detect language) sms_message = messages['en'] # Send SMS notification_log = NotificationService.send_sms( phone=instance.contact_phone, message=sms_message, related_object=instance, metadata={ 'notification_type': 'complaint_created', 'reference_number': instance.reference_number, 'tracking_url': tracking_url, 'language': 'en' # Default to English } ) logger.info(f"Creation SMS sent to {instance.contact_phone} for complaint #{instance.id}") # Create complaint update to track SMS ComplaintUpdate.objects.create( complaint=instance, update_type='communication', message=f"SMS notification sent to complainant: Your complaint has been received", metadata={ 'notification_type': 'complaint_created', 'notification_log_id': str(notification_log.id) if notification_log else None } ) except Exception as e: # Log error but don't fail the complaint save logger.error(f"Failed to send creation SMS for complaint #{instance.id}: {str(e)}") @receiver(post_save, sender=Complaint) def send_complaint_status_change_sms(sender, instance, created, **kwargs): """ Send SMS notification when complaint status changes to resolved or closed. Uses update_fields to detect actual status changes (not just re-saves). """ # Skip on creation (handled by creation signal) if created: return # Check if this is a status change to resolved or closed # Use update_fields to detect actual status changes if not hasattr(instance, '_status_was'): return old_status = instance._status_was new_status = instance.status # Only send SMS for resolved or closed status changes if new_status not in ['resolved', 'closed']: return # Only send if status actually changed if old_status == new_status: return # Only send SMS if phone number is provided if not instance.contact_phone: logger.info(f"Complaint #{instance.id} status changed to {new_status} but no phone number. Skipping SMS.") return # Send SMS notification try: from apps.notifications.services import NotificationService # Bilingual SMS messages messages_en = { 'resolved': f"PX360: Your complaint #{instance.reference_number} has been resolved. Thank you for your feedback.", 'closed': f"PX360: Your complaint #{instance.reference_number} has been closed. Thank you for your feedback." } messages_ar = { 'resolved': f"PX360: تم حل شكوتك #{instance.reference_number}. شكراً لتعاونكم.", 'closed': f"PX360: تم إغلاق شكوتك #{instance.reference_number}. شكراً لتعاونكم." } # Default to English (can be enhanced to detect language) sms_message = messages_en.get(new_status, '') # Send SMS notification_log = NotificationService.send_sms( phone=instance.contact_phone, message=sms_message, related_object=instance, metadata={ 'notification_type': 'complaint_status_change', 'reference_number': instance.reference_number, 'old_status': old_status, 'new_status': new_status, 'language': 'en' # Default to English } ) logger.info(f"Status change SMS sent to {instance.contact_phone} for complaint #{instance.id}: {old_status} -> {new_status}") # Create complaint update to track SMS ComplaintUpdate.objects.create( complaint=instance, update_type='communication', message=f"SMS notification sent to complainant: Status changed to {new_status}", metadata={ 'notification_type': 'complaint_status_change', 'old_status': old_status, 'new_status': new_status, 'notification_log_id': str(notification_log.id) if notification_log else None } ) except Exception as e: # Log error but don't fail the complaint save logger.error(f"Failed to send status change SMS for complaint #{instance.id}: {str(e)}") # Hook into ComplaintUpdate to track SMS sent manually via API @receiver(post_save, sender=ComplaintUpdate) def track_manual_sms(sender, instance, created, **kwargs): """ Track manually sent SMS notifications. This ensures that SMS sent via API endpoints (like send_resolution_notification) are also properly tracked. """ if not created: return # Check if this update was for a communication/notification if instance.update_type == 'communication': # Log tracking info logger.info( f"Manual communication update created for complaint #{instance.complaint.id}: " f"{instance.message[:50]}..." )