You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Django多态模型架构咨询:任务系统升级的技术疑问

项目背景与模型架构

我正在升级一个原本仅用于某部门向对应科室分配报告的项目,希望将报告扩展为任务,以覆盖全公司的使用场景。最初我使用独立模型分别处理报告、更新、报告文件、更新文件(这些表的字段几乎完全相同),现在尝试采用单表区分类型的架构替代独立模型,具体代码如下:

# 任务类型(任务、更新)
class TipoTarea(models.Model): 
    nombre = models.CharField(max_length=50, unique=True)

    def __str__(self):
        return self.nombre    

# 任务分类(主题及指向的业务领域)
class CategoriaTarea(models.Model): 
    nombre = models.CharField(max_length=50, unique=True)
    area = models.ForeignKey(Area, on_delete=models.CASCADE)
    tiempo_atencion = models.IntegerField(default=2)
    
    def __str__(self):
        return self.nombre

# 任务状态(已创建、处理中、已完成、已转派)
# 转派状态会生成一个分类不同的新任务
class EstadoTarea(models.Model):
    nombre = models.CharField(max_length=50)
    
    def __str__(self):
        return self.nombre

# 任务
# 父任务字段原本用于关联更新,但转派该如何归类?
class Tarea(models.Model):
    tipo = models.ForeignKey(TipoTarea, on_delete=models.CASCADE, related_name = 'tarea') 
    categoria = models.ForeignKey(CategoriaTarea, on_delete=models.CASCADE, related_name = 'tarea')
    descripcion = models.CharField(max_length=500)
    fecha = models.DateField(default=datetime.date.today)
    estado = models.ForeignKey(EstadoTarea, default= 1, on_delete=models.CASCADE)
    creado_por = models.ForeignKey(User, on_delete=models.CASCADE, related_name='creador')
    creado = models.DateTimeField(auto_now_add=True)
    parent = models.ForeignKey('self', on_delete=models.CASCADE, related_name="actualizaciones", null=True, blank=True)
    modificado = models.DateTimeField(auto_now=True)
    modificado_por = models.ForeignKey(User, blank=True, null=True, default=None, on_delete=models.CASCADE, related_name='modificador')
    extras = models.JSONField(null=True)
    
    class Meta:
        ordering = ["fecha"]

    def save(self, *args, **kwargs):
        user = get_current_user()
        if user and not user.pk:
            user = None
        if not self.pk:
            self.creado_por = user
        else:
            self.modificado_por = user
        super(Tarea, self).save(*args, **kwargs)

# 任务文件:是否应该用Tarea模型里的extras字段(JSONField)来存储文件路径?
class ArchivoTarea(models.Model):
    tarea = models.ForeignKey(Tarea, on_delete=models.CASCADE)       
    archivo = models.FileField(upload_to=upload_reporte_file_to)
技术疑问解答

1. 当前的类型区分方案是否最优?是否存在过度设计?

你当前的方案不算严格的多态模型,而是用TipoTarea做类型标记的单表复用方案,这个设计在你的场景下非常合理,不存在过度设计:

  • 原报告、更新字段高度重合,单表复用能避免重复代码与冗余表结构,完全符合DRY原则;
  • 扩展到全公司后,新增任务类型(如审批、通知)只需在TipoTarea中添加数据,无需修改模型,扩展性足够;
  • 关于转派归类:转派属于任务状态变更+分类调整,无需单独建模。可以通过parent字段关联原任务,同时在extras中记录转派原因、原分类等信息;如果转派原因需要标准化管理,也可以新增MotivoReasignacion关联表,但当前阶段没必要提前做。

2. JSONField存储差异化参数的键格式设计建议

JSONField的键设计要兼顾可读性、扩展性和查询便利性,给你几个实用规则:

  • 统一用小写蛇形命名(如approval_deadline、notify_users),避免风格混乱;
  • 按功能模块分组嵌套,比如审批相关参数放在approval子对象中:{"approval": {"deadline": "2024-10-01", "approver_ids": [1,3]}},结构更清晰;
  • 高频查询的字段尽量设为顶级键,避免嵌套(比如经常要筛选的external_task_id,不要放在子对象里);
  • 提前在模型注释中定义常用键的含义与场景,避免团队成员随意命名导致结构混乱;
  • 如果某个差异化字段后续成为高频查询或需要约束的字段,直接将其从JSONField抽为独立模型字段(比如大部分任务都需要优先级,就加priority字段,不要放在JSON里)。

3. 文件路径应该存在独立表还是JSONField?

优先选择独立表ArchivoTarea,原因如下:

  • Django的FileField自带完整的文件管理功能(上传、下载、删除),存在JSON里需要自行处理文件生命周期,容易出错;
  • 独立表支持更灵活的查询(如统计任务文件数量、按文件类型筛选),JSON存路径的话查询会非常繁琐;
  • 虽然当前限制最多5个文件,但独立表扩展性更好——未来放开数量限制无需修改模型;
  • 独立表可记录更多文件元数据(如上传时间、上传人、文件大小),这些信息放在JSON里会零散且难以管理;
  • 唯一的小缺点是多一次关联查询,但Django的select_related/prefetch_related可轻松解决,性能影响可忽略。

内容的提问来源于stack exchange,提问作者LCD_

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.15 19:35:35