Add per-project hierarchical collaborative notes

ghostwriter/api/views.py

@@ -53,6 +53,7 @@
 from ghostwriter.reporting.views2.report_finding_link import get_position
 from ghostwriter.rolodex.models import (
     Project,
+    ProjectCollabNote,
     ProjectContact,
     ProjectObjective,
     ProjectSubTask,
@@ -1373,6 +1374,8 @@ class CheckEditPermissions(JwtRequiredMixin, HasuraActionView):
         "report_finding_link": ReportFindingLink,
         "report": Report,
         "project": Project,
+        "project_collab_note": ProjectCollabNote,
+        "project_tree_sync": Project,
     }
 
     def post(self, request):

ghostwriter/factories.py

@@ -579,6 +579,32 @@ class Meta:
     operator = factory.SubFactory(UserFactory)
 
 
+class ProjectCollabNoteFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = "rolodex.ProjectCollabNote"
+
+    title = Faker("sentence", nb_words=3)
+    node_type = "note"
+    content = Faker("rich_text")
+    position = factory.Sequence(lambda n: n * 1000)
+    project = factory.SubFactory(ProjectFactory)
+
+
+class ProjectCollabNoteFolderFactory(ProjectCollabNoteFactory):
+    node_type = "folder"
+    content = ""
+
+
+class ProjectCollabNoteFieldFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = "rolodex.ProjectCollabNoteField"
+
+    field_type = "rich_text"
+    content = Faker("rich_text")
+    position = factory.Sequence(lambda n: n)
+    note = factory.SubFactory(ProjectCollabNoteFactory)
+
+
 class ClientInviteFactory(factory.django.DjangoModelFactory):
     class Meta:
         model = "rolodex.ClientInvite"

ghostwriter/rolodex/migrations/0062_projectcollabnote_projectcollabnotefield.py

@@ -0,0 +1,194 @@
+import django.db.models.deletion
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("rolodex", "0061_projectrole_position_ordering"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="ProjectCollabNote",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "title",
+                    models.CharField(
+                        help_text="Title of the note or folder",
+                        max_length=255,
+                        verbose_name="Title",
+                    ),
+                ),
+                (
+                    "node_type",
+                    models.CharField(
+                        choices=[("folder", "Folder"), ("note", "Note")],
+                        default="note",
+                        help_text="Whether this is a folder or a note",
+                        max_length=10,
+                        verbose_name="Type",
+                    ),
+                ),
+                (
+                    "content",
+                    models.TextField(
+                        blank=True,
+                        default="",
+                        help_text="Rich text content (for notes only, empty for folders)",
+                        verbose_name="Content",
+                    ),
+                ),
+                (
+                    "position",
+                    models.PositiveIntegerField(
+                        default=0,
+                        help_text="Order within parent (lower values first)",
+                        verbose_name="Position",
+                    ),
+                ),
+                (
+                    "created_at",
+                    models.DateTimeField(default=django.utils.timezone.now),
+                ),
+                (
+                    "updated_at",
+                    models.DateTimeField(default=django.utils.timezone.now),
+                ),
+                (
+                    "parent",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Parent folder (null for root-level items)",
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="children",
+                        to="rolodex.projectcollabnote",
+                    ),
+                ),
+                (
+                    "project",
+                    models.ForeignKey(
+                        help_text="The project this note belongs to",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="collab_notes",
+                        to="rolodex.project",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Project collaborative note",
+                "verbose_name_plural": "Project collaborative notes",
+                "ordering": ["position", "title"],
+            },
+        ),
+        migrations.AddConstraint(
+            model_name="projectcollabnote",
+            constraint=models.CheckConstraint(
+                check=models.Q(("node_type", "note"), ("content", ""), _connector="OR"),
+                name="folder_has_no_content",
+            ),
+        ),
+        migrations.CreateModel(
+            name="ProjectCollabNoteField",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "field_type",
+                    models.CharField(
+                        choices=[("rich_text", "Rich Text"), ("image", "Image")],
+                        default="rich_text",
+                        help_text="Type of content in this field",
+                        max_length=10,
+                        verbose_name="Field Type",
+                    ),
+                ),
+                (
+                    "content",
+                    models.TextField(
+                        blank=True,
+                        default="",
+                        help_text="HTML content for rich text fields",
+                        verbose_name="Content",
+                    ),
+                ),
+                (
+                    "image_width",
+                    models.IntegerField(
+                        blank=True,
+                        editable=False,
+                        null=True,
+                        verbose_name="Image Width",
+                    ),
+                ),
+                (
+                    "image_height",
+                    models.IntegerField(
+                        blank=True,
+                        editable=False,
+                        null=True,
+                        verbose_name="Image Height",
+                    ),
+                ),
+                (
+                    "image",
+                    models.ImageField(
+                        blank=True,
+                        help_text="Image file for image fields",
+                        height_field="image_height",
+                        null=True,
+                        upload_to="collab_note_images/%Y/%m/%d/",
+                        verbose_name="Image",
+                        width_field="image_width",
+                    ),
+                ),
+                (
+                    "position",
+                    models.PositiveIntegerField(
+                        default=0,
+                        help_text="Order within note (lower values first)",
+                        verbose_name="Position",
+                    ),
+                ),
+                (
+                    "created_at",
+                    models.DateTimeField(default=django.utils.timezone.now),
+                ),
+                (
+                    "updated_at",
+                    models.DateTimeField(default=django.utils.timezone.now),
+                ),
+                (
+                    "note",
+                    models.ForeignKey(
+                        help_text="The note this field belongs to",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="fields",
+                        to="rolodex.projectcollabnote",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Project collaborative note field",
+                "verbose_name_plural": "Project collaborative note fields",
+                "ordering": ["note", "position"],
+            },
+        ),
+    ]

ghostwriter/rolodex/migrations/0063_migrate_collab_notes.py

@@ -0,0 +1,39 @@
+"""Data migration to move content from Project.collab_note to ProjectCollabNote."""
+
+from django.db import migrations
+
+
+def migrate_collab_notes(apps, schema_editor):
+    Project = apps.get_model("rolodex", "Project")
+    ProjectCollabNote = apps.get_model("rolodex", "ProjectCollabNote")
+    ProjectCollabNoteField = apps.get_model("rolodex", "ProjectCollabNoteField")
+
+    for project in Project.objects.exclude(collab_note=""):
+        note = ProjectCollabNote.objects.create(
+            project=project,
+            title="Notes",
+            node_type="note",
+            content=project.collab_note,
+            position=0,
+        )
+        ProjectCollabNoteField.objects.create(
+            note=note,
+            field_type="rich_text",
+            content=project.collab_note,
+            position=0,
+        )
+
+
+def reverse_migrate(apps, schema_editor):
+    ProjectCollabNote = apps.get_model("rolodex", "ProjectCollabNote")
+    ProjectCollabNote.objects.all().delete()
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("rolodex", "0062_projectcollabnote_projectcollabnotefield"),
+    ]
+
+    operations = [
+        migrations.RunPython(migrate_collab_notes, reverse_migrate),
+    ]

ghostwriter/rolodex/migrations/0064_alter_projectcollabnote_id_and_more.py

@@ -0,0 +1,26 @@
+# Generated by Django 4.2.16 on 2026-03-31 21:26
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("rolodex", "0063_migrate_collab_notes"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="projectcollabnote",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="projectcollabnotefield",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

ghostwriter/rolodex/migrations/0065_set_collabnote_timestamp_defaults.py

@@ -0,0 +1,33 @@
+"""Set database-level defaults for collab note timestamp columns.
+
+Django 4.2's ``default=timezone.now`` only applies at the ORM level.
+Hasura and the collab server insert rows directly, bypassing the ORM,
+so database-level defaults are required.
+"""
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("rolodex", "0064_alter_projectcollabnote_id_and_more"),
+    ]
+
+    operations = [
+        migrations.RunSQL(
+            sql="ALTER TABLE rolodex_projectcollabnote ALTER COLUMN created_at SET DEFAULT NOW();",
+            reverse_sql="ALTER TABLE rolodex_projectcollabnote ALTER COLUMN created_at DROP DEFAULT;",
+        ),
+        migrations.RunSQL(
+            sql="ALTER TABLE rolodex_projectcollabnote ALTER COLUMN updated_at SET DEFAULT NOW();",
+            reverse_sql="ALTER TABLE rolodex_projectcollabnote ALTER COLUMN updated_at DROP DEFAULT;",
+        ),
+        migrations.RunSQL(
+            sql="ALTER TABLE rolodex_projectcollabnotefield ALTER COLUMN created_at SET DEFAULT NOW();",
+            reverse_sql="ALTER TABLE rolodex_projectcollabnotefield ALTER COLUMN created_at DROP DEFAULT;",
+        ),
+        migrations.RunSQL(
+            sql="ALTER TABLE rolodex_projectcollabnotefield ALTER COLUMN updated_at SET DEFAULT NOW();",
+            reverse_sql="ALTER TABLE rolodex_projectcollabnotefield ALTER COLUMN updated_at DROP DEFAULT;",
+        ),
+    ]