52 lines
2.5 KiB
Python
52 lines
2.5 KiB
Python
from django.db import models
|
|
|
|
|
|
class CustomerNameFixJob(models.Model):
|
|
"""وضعیت و checkpoint عملیات «افزودن پیشوند آقای/خانم به نام مشتریان».
|
|
|
|
این مدل **فقط** برای مدیریت/بازیابی job است و هیچ اطلاعاتی دربارهٔ جنسیت یا
|
|
هویت مشتری نگه نمی‌دارد. مدل ``Customer`` هیچ تغییر ساختاری نمی‌گیرد.
|
|
"""
|
|
|
|
class Status(models.TextChoices):
|
|
RUNNING = "running", "در حال اجرا"
|
|
PAUSED = "paused", "متوقف‌شده (قابل ادامه)"
|
|
COMPLETED = "completed", "تکمیل‌شده"
|
|
FAILED = "failed", "ناموفق"
|
|
|
|
# شناسهٔ فایل ورودی: اگر hash تغییر کند، ادامهٔ job رد می‌شود.
|
|
source_hash = models.CharField(max_length=64)
|
|
algorithm_version = models.CharField(max_length=16, default="1")
|
|
status = models.CharField(max_length=16, choices=Status.choices, default=Status.PAUSED)
|
|
batch_size = models.PositiveIntegerField(default=200)
|
|
|
|
# دامنهٔ job: بیشترین primary key مشتریان در لحظهٔ آغاز. مشتریان جدیدتر
|
|
# (pk > initial_max_pk) عمداً خارج از دامنه می‌مانند.
|
|
initial_max_pk = models.BigIntegerField(null=True, blank=True)
|
|
# checkpoint: آخرین pk پردازش‌شده (به‌صورت اتمیک با تغییرات همان batch ثبت می‌شود).
|
|
last_processed_pk = models.BigIntegerField(default=0)
|
|
|
|
stats = models.JSONField(default=dict, blank=True)
|
|
note = models.CharField(max_length=255, blank=True, default="")
|
|
|
|
started_at = models.DateTimeField(auto_now_add=True)
|
|
updated_at = models.DateTimeField(auto_now=True)
|
|
finished_at = models.DateTimeField(null=True, blank=True)
|
|
# ضربان قفل: برای تشخیص job رهاشده پس از crash و جلوگیری از اجرای هم‌زمان.
|
|
heartbeat_at = models.DateTimeField(null=True, blank=True)
|
|
|
|
class Meta:
|
|
verbose_name = "job اصلاح نام مشتری"
|
|
verbose_name_plural = "jobهای اصلاح نام مشتری"
|
|
|
|
def __str__(self):
|
|
return f"job#{self.pk} {self.status} hash={self.source_hash[:8]} pk<={self.last_processed_pk}"
|
|
|
|
|
|
class CacheTable(models.Model):
|
|
key = models.CharField(max_length=50, unique=True)
|
|
value = models.CharField(max_length=400)
|
|
|
|
def __str__(self):
|
|
return f'{self.key} # {self.value}'
|