from django.db import models from django.contrib.auth import get_user_model from common.models import NameSlugModel from simple_history.models import HistoricalRecords from django.core.exceptions import ValidationError User = get_user_model() class Process(NameSlugModel): """مدل فرآیند اصلی""" description = models.TextField(verbose_name="توضیحات", blank=True) is_active = models.BooleanField(default=True, verbose_name="فعال") created_by = models.ForeignKey(User, on_delete=models.CASCADE, verbose_name="ایجاد کننده") history = HistoricalRecords() class Meta: verbose_name = "فرآیند" verbose_name_plural = "فرآیندها" ordering = ['-created'] def __str__(self): return self.name class ProcessStep(NameSlugModel): """مدل مراحل فرآیند""" process = models.ForeignKey(Process, on_delete=models.CASCADE, related_name='steps', verbose_name="فرآیند") order = models.PositiveIntegerField(verbose_name="ترتیب") description = models.TextField(verbose_name="توضیحات", blank=True) is_required = models.BooleanField(default=True, verbose_name="اجباری") estimated_duration = models.PositiveIntegerField(verbose_name="مدت زمان تخمینی (روز)", null=True, blank=True) # فیلدهای جدید برای کنترل وابستگی‌ها blocks_previous = models.BooleanField( default=False, verbose_name="مسدود کننده مراحل قبلی", help_text="اگر فعال باشد، پس از تکمیل این مرحله، مراحل قبلی غیرقابل ویرایش می‌شوند" ) can_go_back = models.BooleanField( default=True, verbose_name="قابل بازگشت", help_text="آیا می‌توان به مراحل قبلی بازگشت" ) history = HistoricalRecords() class Meta: verbose_name = "مرحله فرآیند" verbose_name_plural = "مراحل فرآیند" ordering = ['process', 'order'] unique_together = ['process', 'order'] def __str__(self): return f"{self.process.name} - {self.name}" def get_dependencies(self): """دریافت مراحل وابسته""" return StepDependency.objects.filter(dependent_step=self).values_list('dependency_step', flat=True) def get_dependents(self): """دریافت مراحلی که به این مرحله وابسته هستند""" return StepDependency.objects.filter(dependency_step=self).values_list('dependent_step', flat=True) class StepDependency(models.Model): """مدل وابستگی بین مراحل""" dependent_step = models.ForeignKey( ProcessStep, on_delete=models.CASCADE, related_name='dependencies', verbose_name="مرحله وابسته" ) dependency_step = models.ForeignKey( ProcessStep, on_delete=models.CASCADE, related_name='dependents', verbose_name="مرحله مورد نیاز" ) created_at = models.DateTimeField(auto_now_add=True, verbose_name="تاریخ ایجاد") class Meta: verbose_name = "وابستگی مرحله" verbose_name_plural = "وابستگی‌های مراحل" unique_together = ['dependent_step', 'dependency_step'] ordering = ['dependent_step__order', 'dependency_step__order'] def __str__(self): return f"{self.dependent_step} ← {self.dependency_step}" def clean(self): """اعتبارسنجی مدل""" if self.dependent_step == self.dependency_step: raise ValidationError("مرحله نمی‌تواند به خودش وابسته باشد") if self.dependent_step.process != self.dependency_step.process: raise ValidationError("مراحل باید از یک فرآیند باشند") if self.dependent_step.order <= self.dependency_step.order: raise ValidationError("مرحله وابسته باید بعد از مرحله مورد نیاز باشد") class ProcessInstance(NameSlugModel): """مدل نمونه فرآیند (برای هر درخواست)""" process = models.ForeignKey(Process, on_delete=models.CASCADE, related_name='instances', verbose_name="فرآیند") requester = models.ForeignKey(User, on_delete=models.CASCADE, verbose_name="درخواست کننده") current_step = models.ForeignKey('ProcessStep', on_delete=models.SET_NULL, null=True, blank=True, verbose_name="مرحله فعلی") status = models.CharField( max_length=20, choices=[ ('pending', 'در انتظار'), ('in_progress', 'در حال انجام'), ('completed', 'تکمیل شده'), ('cancelled', 'لغو شده'), ('rejected', 'رد شده'), ], default='pending', verbose_name="وضعیت" ) started_at = models.DateTimeField(auto_now_add=True, verbose_name="تاریخ شروع") completed_at = models.DateTimeField(null=True, blank=True, verbose_name="تاریخ تکمیل") history = HistoricalRecords() class Meta: verbose_name = "نمونه فرآیند" verbose_name_plural = "نمونه‌های فرآیند" ordering = ['-started_at'] def __str__(self): return f"{self.process.name} - {self.requester.get_full_name()}" def get_available_steps(self): """دریافت مراحل قابل دسترس""" available_steps = [] for step in self.process.steps.all(): if self.can_access_step(step): available_steps.append(step) return available_steps def can_access_step(self, step): """بررسی امکان دسترسی به مرحله""" # بررسی وابستگی‌ها dependencies = step.get_dependencies() for dependency_id in dependencies: step_instance = self.step_instances.filter(step_id=dependency_id).first() if not step_instance or step_instance.status != 'completed': return False return True def can_edit_step(self, step): """بررسی امکان ویرایش مرحله""" # اگر مرحله مسدود کننده باشد و مراحل بعدی تکمیل شده باشند if step.blocks_previous: later_steps = self.step_instances.filter( step__order__gt=step.order, status='completed' ) if later_steps.exists(): return False return True class StepInstance(models.Model): """مدل نمونه مرحله (برای هر مرحله در هر درخواست)""" process_instance = models.ForeignKey(ProcessInstance, on_delete=models.CASCADE, related_name='step_instances', verbose_name="نمونه فرآیند") step = models.ForeignKey(ProcessStep, on_delete=models.CASCADE, verbose_name="مرحله") assigned_to = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="واگذار شده به") status = models.CharField( max_length=20, choices=[ ('pending', 'در انتظار'), ('in_progress', 'در حال انجام'), ('completed', 'تکمیل شده'), ('skipped', 'رد شده'), ('blocked', 'مسدود شده'), ('rejected', 'رد شده و نیاز به اصلاح'), ], default='pending', verbose_name="وضعیت" ) notes = models.TextField(verbose_name="یادداشت‌ها", blank=True) started_at = models.DateTimeField(auto_now_add=True, verbose_name="تاریخ شروع") completed_at = models.DateTimeField(null=True, blank=True, verbose_name="تاریخ تکمیل") history = HistoricalRecords() class Meta: verbose_name = "نمونه مرحله" verbose_name_plural = "نمونه‌های مرحله" ordering = ['process_instance', 'step__order'] def __str__(self): return f"{self.process_instance} - {self.step.name}" def save(self, *args, **kwargs): """ذخیره با اعتبارسنجی""" # بررسی وابستگی‌ها if self.status == 'in_progress' or self.status == 'completed': if not self.process_instance.can_access_step(self.step): raise ValidationError("مراحل وابسته تکمیل نشده‌اند") # بررسی امکان ویرایش if self.status == 'completed' and not self.process_instance.can_edit_step(self.step): raise ValidationError("این مرحله قابل ویرایش نیست") super().save(*args, **kwargs) def get_status_display_with_color(self): """نمایش وضعیت با رنگ""" status_colors = { 'pending': 'secondary', 'in_progress': 'primary', 'completed': 'success', 'skipped': 'warning', 'blocked': 'danger', 'rejected': 'danger', } color = status_colors.get(self.status, 'secondary') return '{}'.format(color, self.get_status_display()) def get_rejection_count(self): """دریافت تعداد رد شدن‌ها""" return self.rejections.count() def get_latest_rejection(self): """دریافت آخرین رد شدن""" return self.rejections.order_by('-created_at').first() class StepRejection(models.Model): """مدل رد شدن مرحله""" step_instance = models.ForeignKey( StepInstance, on_delete=models.CASCADE, related_name='rejections', verbose_name="نمونه مرحله" ) rejected_by = models.ForeignKey( User, on_delete=models.CASCADE, verbose_name="رد کننده", related_name='step_rejections' ) reason = models.TextField(verbose_name="دلیل رد شدن", help_text="توضیح کامل دلیل رد شدن") instructions = models.TextField( verbose_name="دستورالعمل‌های اصلاح", help_text="دستورالعمل‌هایی برای اصلاح مرحله", blank=True ) created_at = models.DateTimeField(auto_now_add=True, verbose_name="تاریخ رد شدن") history = HistoricalRecords() class Meta: verbose_name = "رد شدن مرحله" verbose_name_plural = "رد شدن‌های مراحل" ordering = ['-created_at'] def __str__(self): return f"رد شدن {self.step_instance} توسط {self.rejected_by.get_full_name()}" def save(self, *args, **kwargs): """ذخیره با تغییر وضعیت مرحله""" # تغییر وضعیت مرحله به رد شده self.step_instance.status = 'rejected' self.step_instance.save() super().save(*args, **kwargs) class StepRevision(models.Model): """مدل بازبینی و اصلاح مرحله""" step_instance = models.ForeignKey( StepInstance, on_delete=models.CASCADE, related_name='revisions', verbose_name="نمونه مرحله" ) rejection = models.ForeignKey( StepRejection, on_delete=models.CASCADE, related_name='revisions', verbose_name="رد شدن مربوطه" ) revised_by = models.ForeignKey( User, on_delete=models.CASCADE, verbose_name="اصلاح کننده", related_name='step_revisions' ) changes_description = models.TextField( verbose_name="توضیح تغییرات", help_text="توضیح تغییراتی که برای اصلاح انجام شده" ) created_at = models.DateTimeField(auto_now_add=True, verbose_name="تاریخ اصلاح") history = HistoricalRecords() class Meta: verbose_name = "بازبینی مرحله" verbose_name_plural = "بازبینی‌های مراحل" ordering = ['-created_at'] def __str__(self): return f"بازبینی {self.step_instance} توسط {self.revised_by.get_full_name()}"