Class ChangeRequest

api/features/workflows/core/models.py:57–257

class ChangeRequest(  # type: ignore[django-manager-missing]
    LifecycleModelMixin,  # type: ignore[misc]
    SoftDeleteExportableModel,
    abstract_base_auditable_model_factory(["uuid"]),  # type: ignore[misc]
):
    related_object_type = RelatedObjectType.CHANGE_REQUEST
    history_record_class_path = "features.workflows.core.models.HistoricalChangeRequest"

    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    title = models.CharField(max_length=500)
    description = models.TextField(blank=True, null=True)

    # We allow null here so that deleting users does not cascade to deleting change
    # requests which can be used for historical purposes.
    user = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.SET_NULL,
        related_name="change_requests",
        null=True,
    )

    project = models.ForeignKey(
        "projects.Project",
        on_delete=models.CASCADE,
        related_name="change_requests",
        null=False,
    )

    environment = models.ForeignKey(
        "environments.Environment",
        on_delete=models.CASCADE,
        related_name="change_requests",
        null=True,
    )

    committed_at = models.DateTimeField(null=True)
    committed_by = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.SET_NULL,
        related_name="committed_change_requests",
        null=True,
    )

    ignore_conflicts = models.BooleanField(default=False)

    class Meta:
        # Explicit ordering to prevent pagination warnings.
        ordering = ("id",)

    def approve(self, user: "FFAdminUser"):  # type: ignore[no-untyped-def]
        if user.id == self.user_id:
            raise CannotApproveOwnChangeRequest(
                "User cannot approve their own Change Request."
            )

        ChangeRequestApproval.objects.update_or_create(