apps/api/plane/db/models/__init__.py (1)

87-87: Expose Description models here is fine; watch for potential confusion with IssueDescriptionVersion.

Importing and re-exporting Description and DescriptionVersion is consistent with the rest of this module. Small nit: we now have both IssueDescriptionVersion and DescriptionVersion in the same namespace, which are distinct but similarly named. This is OK, but be mindful in call sites to import the intended one explicitly to avoid mistakes.

apps/api/plane/db/models/description.py (2)

19-24: Consider adding a composite index to match likely query patterns.

Common access patterns will likely filter by workspace and order by created_at. A composite index helps.

Suggested Meta addition:

     class Meta:
         verbose_name = "Description"
         verbose_name_plural = "Descriptions"
         db_table = "descriptions"
         ordering = ("-created_at",)
+        indexes = [
+            models.Index(fields=["workspace", "created_at"], name="descr_ws_created_idx"),
+        ]

If you want, I can update the model and generate the migration for this index.

---

51-56: Add the same composite index here for parity and query performance.

     class Meta:
         verbose_name = "Description Version"
         verbose_name_plural = "Description Versions"
         db_table = "description_versions"
         ordering = ("-created_at",)
+        indexes = [
+            models.Index(fields=["workspace", "created_at"], name="descrv_ws_created_idx"),
+            models.Index(fields=["description", "created_at"], name="descrv_desc_created_idx"),
+        ]

apps/api/plane/db/migrations/0101_description_descriptionversion.py (2)

88-94: Optionally add indexes aligned with expected access patterns.

If you adopt the indexes suggested in the model Meta, regenerate this migration to include them. This will speed queries like “all descriptions in a workspace sorted by created_at” and “versions for a description sorted by created_at.”

I can add the indexes to the models and generate an updated migration if you’d like.

---

115-124: Minor: primary_key already implies unique + index; redundant flags on id can be avoided (not a blocker).

The UUIDField includes primary_key=True which makes it unique and indexed by default. The duplicated unique/db_index often comes from a shared base; no action required unless you are touching the base model.

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

• MCP integration is disabled by default for public repositories
• Jira integration is disabled by default for public repositories
• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

apps/api/plane/db/models/description.py (3)

32-35: Docstring should reflect version-tracking purpose

Clarify that this model stores historical versions linked to Description.

 class DescriptionVersion(WorkspaceBaseModel):
-    """
-    DescriptionVersion is a model that stores the description of an issue.
-    """
+    """
+    DescriptionVersion stores historical versions of a Description for auditing
+    and change tracking over time.
+    """

---

22-29: Optional: DRY the save logic via a small mixin

Both models duplicate identical save logic. A simple abstract mixin keeps it in one place.

Alternative to the two save() patches above:

@@
-from django.db import models
+from django.db import models
 from django.utils.html import strip_tags
 from .workspace import WorkspaceBaseModel
 
 
+class DescriptionHtmlStripMixin(models.Model):
+    class Meta:
+        abstract = True
+
+    # Override these in subclasses if field names differ
+    _html_field = "description_html"
+    _stripped_field = "description_stripped"
+
+    def save(self, *args, **kwargs):
+        update_fields = kwargs.get("update_fields")
+        if update_fields is None or self._html_field in update_fields:
+            html = getattr(self, self._html_field, "") or ""
+            plain = strip_tags(html).strip()
+            setattr(self, self._stripped_field, plain or None)
+            if update_fields is not None:
+                s = set(update_fields)
+                s.add(self._stripped_field)
+                kwargs["update_fields"] = s
+        super().save(*args, **kwargs)
+
@@
-class Description(WorkspaceBaseModel):
+class Description(DescriptionHtmlStripMixin, WorkspaceBaseModel):
@@
-    def save(self, *args, **kwargs):
-        # Strip the html tags using html parser
-        self.description_stripped = (
-            None
-            if (self.description_html == "" or self.description_html is None)
-            else strip_tags(self.description_html)
-        )
-        super(Description, self).save(*args, **kwargs)
+    # save() inherited from DescriptionHtmlStripMixin
@@
-class DescriptionVersion(WorkspaceBaseModel):
+class DescriptionVersion(DescriptionHtmlStripMixin, WorkspaceBaseModel):
@@
-    def save(self, *args, **kwargs):
-        # Strip the html tags using html parser
-        self.description_stripped = (
-            None
-            if (self.description_html == "" or self.description_html is None)
-            else strip_tags(self.description_html)
-        )
-        super(DescriptionVersion, self).save(*args, **kwargs)
+    # save() inherited from DescriptionHtmlStripMixin

Also applies to: 51-58

---

51-58: Mirror robust save(update_fields=...) logic for DescriptionVersion

Same issues as Description.save. Normalize blanks to None and ensure derived field is persisted on partial updates, recomputing only when HTML changes.

     def save(self, *args, **kwargs):
-        # Strip the html tags using html parser
-        self.description_stripped = (
-            None
-            if (self.description_html == "" or self.description_html is None)
-            else strip_tags(self.description_html)
-        )
-        super(DescriptionVersion, self).save(*args, **kwargs)
+        update_fields = kwargs.get("update_fields")
+        if update_fields is None or "description_html" in update_fields:
+            plain = strip_tags(self.description_html or "").strip()
+            self.description_stripped = plain or None
+            if update_fields is not None:
+                s = set(update_fields)
+                s.add("description_stripped")
+                kwargs["update_fields"] = s
+        super(DescriptionVersion, self).save(*args, **kwargs)

apps/api/plane/db/models/description.py (2)

14-14: Mark derived field as non-editable

description_stripped is computed; setting editable=False avoids accidental admin/form edits.

-    description_stripped = models.TextField(blank=True, null=True)
+    description_stripped = models.TextField(blank=True, null=True, editable=False)

Apply the same change to DescriptionVersion.

Also applies to: 43-43

---

12-12: Consider default "" for HTML instead of "

"

Using an empty string as the default avoids sentinel HTML. Your new save() logic will already normalize blanks, but this change improves data cleanliness.

-    description_html = models.TextField(blank=True, default="<p></p>")
+    description_html = models.TextField(blank=True, default="")

Apply the same change to DescriptionVersion.

Also applies to: 41-41

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

• MCP integration is disabled by default for public repositories
• Jira integration is disabled by default for public repositories
• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.