Feature/#554 filter destruction lists

backend/src/openarchiefbeheer/accounts/api/views.py

@@ -9,6 +9,38 @@
 from .serializers import UserSerializer
 
 
+@extend_schema(
+    tags=["Users"],
+    summary=_("Users list"),
+    description=_("List all the users."),
+    responses={
+        200: UserSerializer(many=True),
+    },
+)
+class UsersView(ListAPIView):
+    serializer_class = UserSerializer
+
+    def get_queryset(self) -> QuerySet[User]:
+        return User.objects.all()
+
+
+@extend_schema(
+    tags=["Users"],
+    summary=_("Record managers list"),
+    description=_(
+        "List all the users that have the permission to create destruction lists."
+    ),
+    responses={
+        200: UserSerializer(many=True),
+    },
+)
+class RecordManagersView(ListAPIView):
+    serializer_class = UserSerializer
+
+    def get_queryset(self) -> QuerySet[User]:
+        return User.objects.record_managers()
+
+
 @extend_schema(
     tags=["Users"],
     summary=_("Main reviewers list"),

backend/src/openarchiefbeheer/accounts/managers.py

@@ -4,6 +4,50 @@
 
 
 class UserQuerySet(QuerySet):
+    def record_managers(self) -> "UserQuerySet":
+        """
+        Returns a QuerySet of users that have the permission to start a destruction list.
+        """
+        permission = Permission.objects.get(codename="can_start_destruction")
+        return self._users_with_permission(permission)
+
+    def reviewers(self) -> "UserQuerySet":
+        """
+        Returns a QuerySet of users that have the permission to review a destruction list.
+        """
+        return self.filter(  # noqa
+            Q(groups__permissions__codename="can_review_destruction")
+            | Q(user_permissions__codename="can_review_destruction")
+            | Q(groups__permissions__codename="can_review_final_list")
+            | Q(user_permissions__codename="can_review_final_list")
+        ).distinct()
+
+    def main_reviewers(self) -> "UserQuerySet":
+        """
+        Returns a QuerySet of users that have the permission to review a destruction list (main reviewers ony).
+        """
+        permission = Permission.objects.get(codename="can_review_destruction")
+        return self._users_with_permission(permission)
+
+    def co_reviewers(self) -> "UserQuerySet":
+        """
+        Returns a QuerySet of users that have the permission to review a destruction list (co reviewers ony).
+        """
+        permission = Permission.objects.get(codename="can_co_review_destruction")
+        return self._users_with_permission(permission)
+
+    def archivists(self) -> "UserQuerySet":
+        """
+        Returns a QuerySet of users that have the permission to perform a final review on a destruction list.
+        """
+        permission = Permission.objects.get(codename="can_review_final_list")
+        return self._users_with_permission(permission)
+
+    def _users_with_permission(self, permission: Permission) -> "UserQuerySet":
+        return self.filter(  # noqa
+            Q(groups__permissions=permission) | Q(user_permissions=permission)
+        ).distinct()
+
     def annotate_permissions(self) -> "UserQuerySet":
         """
         Adds `user_permission_codenames` and `group_permission_codenames` as `ArrayField` to the current QuerySet
@@ -71,20 +115,3 @@ def create_superuser(self, username, email, password, **extra_fields):
             raise ValueError("Superuser must have is_superuser=True.")
 
         return self._create_user(username, email, password, **extra_fields)
-
-    def _users_with_permission(self, permission: Permission) -> UserQuerySet:
-        return self.filter(
-            Q(groups__permissions=permission) | Q(user_permissions=permission)
-        ).distinct()
-
-    def main_reviewers(self) -> UserQuerySet:
-        permission = Permission.objects.get(codename="can_review_destruction")
-        return self._users_with_permission(permission)
-
-    def archivists(self) -> UserQuerySet:
-        permission = Permission.objects.get(codename="can_review_final_list")
-        return self._users_with_permission(permission)
-
-    def co_reviewers(self) -> UserQuerySet:
-        permission = Permission.objects.get(codename="can_co_review_destruction")
-        return self._users_with_permission(permission)

backend/src/openarchiefbeheer/accounts/tests/test_managers.py

@@ -9,6 +9,67 @@
 
 
 class UserQuerySetTests(TestCase):
+    def test_can_start_destruction_user_permission(self):
+        user = UserFactory.create()
+        record_manager = UserFactory.create(post__can_start_destruction=True)
+        qs = User.objects.record_managers()
+        self.assertEqual(len(qs), 1)
+        self.assertIn(record_manager, qs)
+        self.assertNotIn(user, qs)
+
+    def test_can_start_destruction_group_permission(self):
+        record_managers = Group.objects.create()
+        record_managers.permissions.add(
+            Permission.objects.get(
+                codename="can_start_destruction",
+            )
+        )
+
+        user = UserFactory.create()
+        record_manager = UserFactory.create()
+        record_manager.groups.add(record_managers)
+
+        qs = User.objects.record_managers()
+        self.assertEqual(len(qs), 1)
+        self.assertIn(record_manager, qs)
+        self.assertNotIn(user, qs)
+
+    def test_can_review_destruction_user_permission(self):
+        user = UserFactory.create()
+        reviewer = UserFactory.create(post__can_review_destruction=True)
+        archivist = UserFactory.create(post__can_review_final_list=True)
+        qs = User.objects.reviewers()
+        self.assertEqual(len(qs), 2)
+        self.assertIn(reviewer, qs)
+        self.assertIn(archivist, qs)
+        self.assertNotIn(user, qs)
+
+    def test_can_review_destruction_group_permission(self):
+        reviewers = Group.objects.create(name="reviewers")
+        reviewers.permissions.add(
+            Permission.objects.get(
+                codename="can_review_destruction",
+            )
+        )
+        archivists = Group.objects.create(name="archivists")
+        archivists.permissions.add(
+            Permission.objects.get(
+                codename="can_review_final_list",
+            )
+        )
+
+        user = UserFactory.create()
+        reviewer = UserFactory.create()
+        reviewer.groups.add(reviewers)
+        archivist = UserFactory.create()
+        archivist.groups.add(archivists)
+
+        qs = User.objects.reviewers()
+        self.assertEqual(len(qs), 2)
+        self.assertIn(reviewer, qs)
+        self.assertIn(archivist, qs)
+        self.assertNotIn(user, qs)
+
     def test_annotate_permissions(self):
         content_type = ContentType.objects.get_for_model(DestructionList)
 

backend/src/openarchiefbeheer/api/tests/test_role_endpoints.py

@@ -11,6 +11,35 @@ def test_user_not_logged_in(self):
 
         self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
 
+    def test_retrieve_users(self):
+        admin = UserFactory.create(is_superuser=True)
+        UserFactory.create_batch(2)
+
+        self.client.force_authenticate(user=admin)
+        response = self.client.get(reverse("api:users"))
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+        data = response.json()
+
+        self.assertEqual(len(data), 3)
+
+    def test_retrieve_record_managers(self):
+        admin = UserFactory.create(is_superuser=True)
+        UserFactory.create_batch(2, post__can_start_destruction=True)
+        UserFactory.create_batch(2, post__can_start_destruction=False)
+
+        self.client.force_authenticate(user=admin)
+        response = self.client.get(reverse("api:record-managers"))
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+        data = response.json()
+
+        self.assertEqual(len(data), 2)
+        self.assertTrue(data[0]["role"]["canStartDestruction"])
+        self.assertTrue(data[1]["role"]["canStartDestruction"])
+
     def test_retrieve_reviewers(self):
         admin = UserFactory.create(is_superuser=True)
         UserFactory.create_batch(2, post__can_review_destruction=True)

backend/src/openarchiefbeheer/api/urls.py

@@ -11,6 +11,8 @@
     ArchivistsView,
     CoReviewersView,
     MainReviewersView,
+    RecordManagersView,
+    UsersView,
     WhoAmIView,
 )
 from openarchiefbeheer.config.api.views import ArchiveConfigView, OIDCInfoView
@@ -114,6 +116,16 @@
         "v1/",
         include(
             [
+                path(
+                    "users/",
+                    UsersView.as_view(),
+                    name="users",
+                ),
+                path(
+                    "record-managers/",
+                    RecordManagersView.as_view(),
+                    name="record-managers",
+                ),
                 path("reviewers/", MainReviewersView.as_view(), name="reviewers"),
                 path("archivists/", ArchivistsView.as_view(), name="archivists"),
                 path("co-reviewers/", CoReviewersView.as_view(), name="co-reviewers"),

backend/src/openarchiefbeheer/destruction/api/filtersets.py

@@ -3,13 +3,15 @@
 
 from django_filters import (
     BooleanFilter,
+    CharFilter,
+    ChoiceFilter,
     FilterSet,
     NumberFilter,
     OrderingFilter,
     UUIDFilter,
 )
 
-from ..constants import InternalStatus
+from ..constants import InternalStatus, ListRole, ListStatus
 from ..models import (
     DestructionList,
     DestructionListCoReview,
@@ -93,15 +95,30 @@ def filter_order_review_ignored(
 
 
 class DestructionListFilterset(FilterSet):
+    name = CharFilter(lookup_expr="icontains")
+    status = ChoiceFilter(choices=ListStatus.choices)
+    author = NumberFilter()
+    reviewer = NumberFilter(
+        field_name="assignees__user",
+        method="filter_reviewer",
+    )
     assignee = NumberFilter(
         field_name="assignee",
         help_text="The pk of the user currently assigned to the list.",
     )
-    ordering = OrderingFilter(fields=("created", "created"))
+
+    def filter_reviewer(self, queryset, name, value):
+        return queryset.filter(
+            Q(assignees__role=ListRole.main_reviewer)
+            | Q(assignees__role=ListRole.co_reviewer),
+            assignees__user=value,
+        )
+
+    ordering = OrderingFilter(fields=(("created", "created"), ("name", "name")))
 
     class Meta:
         model = DestructionList
-        fields = ("assignee", "ordering")
+        fields = ("name", "status", "author", "reviewer", "assignee", "ordering")
 
 
 class DestructionListReviewFilterset(FilterSet):