如何基于Django模型管理器实现Stockentry逾期查询集？

问题说明 #

现有Stockentry模型，包含实例方法is_payment_overdue()用于判断单条记录是否逾期。需要通过自定义ModelManager实现链式调用is_overdue()，筛选出符合逾期条件的查询集，比如：

stockentries = Stockentry.objects.filter(store=store).is_overdue()

已编写初步Manager代码，但不清楚如何完成逻辑实现。

解决方案 #

1. 核心思路 #

实例方法is_payment_overdue()是针对单个对象的内存判断，而Manager需要将逻辑转化为数据库层面的查询条件，这样能避免加载全量数据，提升性能。

原实例方法的逻辑拆解：

• 记录未支付（paid=False）
• 计算的逾期天数 ≥ 关联经销商的信用天数（days >= distributor.credit_days）
• 经销商不存在时（外键为null），判定为未逾期

2. 完整实现自定义Manager #

假设daysdue()方法是计算当前日期与entry_date字段的天数差（请根据实际业务逻辑调整日期字段），实现代码如下：

from django.db import models
from django.db.models import F, Q, DateDiff, Now

class StockentryManager(models.Manager):
    def is_overdue(self):
        # 链式调用时，基于当前已过滤的查询集继续筛选
        return self.get_queryset().filter(
            # 条件1：未支付
            paid=False,
            # 条件2：关联经销商存在（避免null引发异常）
            distributor__isnull=False,
            # 条件3：逾期天数 ≥ 经销商信用天数
            DateDiff(Now(), 'entry_date') >= F('distributor__credit_days')
        )

3. 关联Manager到模型 #

在Stockentry模型中指定使用自定义Manager：

class Stockentry(models.Model):
    id = models.AutoField(primary_key=True, unique=True)
    distributor = models.ForeignKey(
        Distributor, blank=True, null=True, on_delete=models.SET_NULL)
    paid = models.BooleanField(default=False)
    entry_date = models.DateField()  # 请替换为实际用于计算逾期的日期字段
    # ...其他原有字段

    # 绑定自定义Manager
    objects = StockentryManager()

    def daysdue(self):
        # 原有天数计算逻辑，保持不变
        return (datetime.date.today() - self.entry_date).days

    def is_payment_overdue(self):
        # 原有实例方法，保持不变
        days = self.daysdue()
        if self.paid:
            return False
        try:
            if days >= self.distributor.credit_days:
                return True
            else:
                return False
        except:
            return False

4. 关键细节说明 #

• 数据库层面过滤：使用DateDiff、F表达式直接在数据库中计算和比较，避免将所有记录加载到内存后再判断，大幅提升大数据量场景下的性能。
• 兼容性处理：DateDiff是Django 3.2+新增的函数，若使用旧版本Django，可替换为ExtractDay(TruncDate(Now()) - F('entry_date'))，需导入from django.db.models.functions import ExtractDay, TruncDate。
• 自定义逻辑适配：如果daysdue()的计算逻辑不是基于entry_date，请将DateDiff(Now(), 'entry_date')替换为对应业务的数据库表达式。

内容的提问来源于stack exchange，提问作者Joel G Mathew