Feat projects tabs

apps/commons/views.py

@@ -10,7 +10,7 @@
 from apps.accounts.permissions import ProjectNestedPermission
 from apps.organizations.models import Organization
 from apps.organizations.utils import get_below_hierarchy_codes
-from apps.projects.models import Project
+from apps.projects.models import Project, ProjectTab
 
 from .mixins import HasMultipleIDs
 
@@ -185,6 +185,19 @@ def get_permissions(self):
         return [ProjectNestedPermission(), *super().get_permissions()]
 
 
+class NestedProjectTabViewMixins:
+    tab: ProjectTab
+    project: Project
+
+    def initial(self, request, *args, **kwargs):
+
+        self.tab = get_object_or_404(
+            self.project.modules_by_user(request.user).tabs(), pk=kwargs["tab_id"]
+        )
+
+        super().initial(request, *args, **kwargs)
+
+
 class NestedPeopleGroupViewMixins:
     def initial(self, request, *args, **kwargs):
         self.people_group = get_object_or_404(

apps/modules/__init__.py

@@ -1,4 +1,5 @@
 from .group import PeopleGroupModules
 from .project import ProjectModules
+from .tab import TabModules
 
-__all__ = ["PeopleGroupModules", "ProjectModules"]
+__all__ = ["PeopleGroupModules", "ProjectModules", "TabModules"]

apps/modules/project.py

@@ -12,6 +12,7 @@
     Location,
     Project,
     ProjectMessage,
+    ProjectTab,
 )
 
 
@@ -114,3 +115,6 @@ def reviews(self) -> QuerySet[Review]:
 
     def messages(self) -> QuerySet[ProjectMessage]:
         return self.instance.messages.all()
+
+    def tabs(self) -> QuerySet[ProjectTab]:
+        return self.instance.additional_tabs.all()

apps/modules/tab.py

@@ -0,0 +1,12 @@
+from django.db.models import QuerySet
+
+from apps.modules.base import AbstractModules, register_module
+from apps.projects.models import ProjectTab, ProjectTabItem
+
+
+@register_module(ProjectTab)
+class TabModules(AbstractModules):
+    instance: ProjectTab
+
+    def items(self) -> QuerySet[ProjectTabItem]:
+        return self.instance.items.all()

apps/projects/filters.py

@@ -10,7 +10,7 @@
 )
 from apps.organizations.utils import get_below_hierarchy_codes
 
-from .models import Location, Project
+from .models import Location, Project, ProjectTab, ProjectTabItem
 
 
 class ProjectFilterMixin(filters.FilterSet):
@@ -118,3 +118,28 @@ class ProjectGroupsFilter(filters.FilterSet):
     class Meta:
         model = PeopleGroup
         fields = ("role",)
+
+
+class ProjectTabFilter(filters.FilterSet):
+    type = filters.CharFilter()  # noqa: A003
+    show_preview = filters.BooleanFilter()
+
+    class Meta:
+        model = ProjectTab
+        fields = ("type", "show_preview")
+
+
+class ProjectTabItemFilter(filters.FilterSet):
+    from_date = filters.CharFilter(method="range_filter_from", label="form_date")
+    to_date = filters.CharFilter(method="range_filter_to", label="to_date")
+
+    class Meta:
+        model = ProjectTabItem
+        fields = ("from_date", "to_date")
+
+    def range_filter_from(self, queryset, name, value):
+        return queryset.filter(created_at__gte=value)
+
+    def range_filter_to(self, queryset, name, value):
+        # same above but with start_date
+        return queryset.filter(created_at__lte=value)

apps/projects/migrations/0004_projecttab_show_preview_alter_projecttab_description_and_more.py

@@ -0,0 +1,33 @@
+# Generated by Django 6.0.4 on 2026-06-15 13:44
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("projects", "0003_alter_location_type"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="projecttab",
+            name="show_preview",
+            field=models.BooleanField(default=True),
+        ),
+        migrations.AlterField(
+            model_name="projecttab",
+            name="description",
+            field=models.TextField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name="projecttab",
+            name="icon",
+            field=models.CharField(blank=True, max_length=255, null=True),
+        ),
+        migrations.AlterField(
+            model_name="projecttabitem",
+            name="content",
+            field=models.TextField(blank=True, null=True),
+        ),
+    ]

apps/projects/models.py

@@ -1005,7 +1005,9 @@ def is_owned_by(self, user: "ProjectUser") -> bool:
         return self.author == user
 
 
-class ProjectTab(HasAutoTranslatedFields, ProjectRelated, models.Model):
+class ProjectTab(
+    HasRelatedModules, HasAutoTranslatedFields, ProjectRelated, models.Model
+):
     """A tab in the project page.
 
     Attributes
@@ -1037,9 +1039,10 @@ class TabType(models.TextChoices):
         max_length=32, choices=TabType.choices, default=TabType.TEXT
     )
     title = models.CharField(max_length=255)
-    description = models.TextField(blank=True)
-    icon = models.CharField(max_length=255, blank=True)
+    description = models.TextField(blank=True, null=True)
+    icon = models.CharField(max_length=255, blank=True, null=True)
     images = models.ManyToManyField("files.Image", related_name="project_tabs")
+    show_preview = models.BooleanField(default=True)
 
     def get_related_project(self) -> Project:
         """Return the projects related to this model."""
@@ -1072,7 +1075,7 @@ class ProjectTabItem(HasAutoTranslatedFields, ProjectRelated, models.Model):
         "projects.ProjectTab", on_delete=models.CASCADE, related_name="items"
     )
     title = models.CharField(max_length=255)
-    content = models.TextField(blank=True)
+    content = models.TextField(blank=True, null=True)
     images = models.ManyToManyField("files.Image", related_name="project_tab_items")
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)

apps/projects/serializers.py

@@ -900,6 +900,7 @@ def get_string_images_kwargs(
 
 @auto_translated
 class ProjectTabSerializer(
+    ModulesSerializers,
     StringsImagesSerializer,
     serializers.ModelSerializer,
 ):
@@ -914,13 +915,14 @@ class ProjectTabSerializer(
 
     class Meta:
         model = ProjectTab
-        read_only_fields = ["id"]
+        read_only_fields = ["id", "modules"]
         fields = read_only_fields + [
             "type",
             "title",
             "description",
             "icon",
             "images",
+            "show_preview",
         ]
 
     def validate_type(self, value: str):

apps/projects/tests/views/test_project_tab.py

@@ -109,13 +109,16 @@ def test_retrieve_project_tab(self, role, retrieved_tabs):
             user = self.get_parameterized_test_user(role, instances=[project])
             self.client.force_authenticate(user)
             response = self.client.get(reverse("ProjectTab-list", args=(project.id,)))
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            content = response.json()["results"]
             if publication_status in retrieved_tabs:
+                self.assertEqual(response.status_code, status.HTTP_200_OK)
+                content = response.json()["results"]
                 self.assertEqual(len(content), 1)
                 self.assertEqual(content[0]["id"], tab.id)
             else:
-                self.assertEqual(len(content), 0)
+                self.assertIn(
+                    response.status_code,
+                    (status.HTTP_401_UNAUTHORIZED, status.HTTP_403_FORBIDDEN),
+                )
 
 
 class UpdateProjectTabTestCase(JwtAPITestCase):

apps/projects/tests/views/test_project_tab_image.py

@@ -50,7 +50,6 @@ def setUpTestData(cls):
             (TestRoles.ANONYMOUS, ("public",)),
             (TestRoles.DEFAULT, ("public",)),
             (TestRoles.SUPERADMIN, ("public", "org", "private")),
-            (TestRoles.OWNER, ("public", "org", "private")),
             (TestRoles.ORG_ADMIN, ("public", "org", "private")),
             (TestRoles.ORG_FACILITATOR, ("public", "org", "private")),
             (TestRoles.ORG_USER, ("public", "org")),
@@ -73,7 +72,10 @@ def test_retrieve_project_tab_image(self, role, retrieved_images):
             if publication_status in retrieved_images:
                 self.assertEqual(response.status_code, status.HTTP_302_FOUND)
             else:
-                self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+                self.assertIn(
+                    response.status_code,
+                    (status.HTTP_401_UNAUTHORIZED, status.HTTP_403_FORBIDDEN),
+                )
 
 
 class CreateProjectTabImageTestCase(JwtAPITestCase):

apps/projects/tests/views/test_project_tab_item.py

@@ -112,16 +112,19 @@ def test_retrieve_project_tab_items(self, role, retrieved_items):
             response = self.client.get(
                 reverse("ProjectTabItem-list", args=(project.id, tab.id))
             )
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            content = response.json()["results"]
             if publication_status in retrieved_items:
+                self.assertEqual(response.status_code, status.HTTP_200_OK)
+                content = response.json()["results"]
                 self.assertEqual(len(content), 2)
                 self.assertSetEqual(
                     {item["id"] for item in content}, {item.id for item in item}
                 )
                 self.assertGreater(content[0]["created_at"], content[1]["created_at"])
             else:
-                self.assertEqual(len(content), 0)
+                self.assertIn(
+                    response.status_code,
+                    (status.HTTP_401_UNAUTHORIZED, status.HTTP_403_FORBIDDEN),
+                )
 
 
 class UpdateProjectTabItemTestCase(JwtAPITestCase):

apps/projects/tests/views/test_project_tab_item_image.py

@@ -59,7 +59,6 @@ def setUpTestData(cls):
             (TestRoles.ANONYMOUS, ("public",)),
             (TestRoles.DEFAULT, ("public",)),
             (TestRoles.SUPERADMIN, ("public", "org", "private")),
-            (TestRoles.OWNER, ("public", "org", "private")),
             (TestRoles.ORG_ADMIN, ("public", "org", "private")),
             (TestRoles.ORG_FACILITATOR, ("public", "org", "private")),
             (TestRoles.ORG_USER, ("public", "org")),
@@ -85,7 +84,10 @@ def test_retrieve_tab_item_image(self, role, retrieved_images):
             if publication_status in retrieved_images:
                 self.assertEqual(response.status_code, status.HTTP_302_FOUND)
             else:
-                self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+                self.assertIn(
+                    response.status_code,
+                    (status.HTTP_401_UNAUTHORIZED, status.HTTP_403_FORBIDDEN),
+                )
 
 
 class CreateProjectTabItemImageTestCase(JwtAPITestCase):