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_
相关产品推荐
相关产品推荐

