Order export csv

CHANGELOG.md

@@ -34,6 +34,7 @@ and this project adheres to
   to `Product`model
 - Add admin api endpoints to CRUD `Teacher` and `Skill` resources.
 - Add certification section in back office product detail view
+- Add order export to CSV in back office
 
 ### Changed
 

Makefile

@@ -347,7 +347,6 @@ clean: ## restore repository state as it was freshly cloned
 .PHONY: clean
 
 tunnel: ## Run a proxy through localtunnel
-	@$(MAKE) run
 	@echo
 	npx localtunnel -s $(LOCALTUNNEL_SUBDOMAIN) -h $(LOCALTUNNEL_HOST) --port $(LOCALTUNNEL_PORT) --print-requests
 .PHONY: tunnel

src/backend/joanie/core/api/admin/__init__.py

@@ -6,7 +6,8 @@
 
 from django.core.cache import cache
 from django.core.exceptions import ValidationError
-from django.http import JsonResponse
+from django.http import JsonResponse, StreamingHttpResponse
+from django.utils import timezone
 
 from django_filters.rest_framework import DjangoFilterBackend
 from drf_spectacular.types import OpenApiTypes
@@ -614,7 +615,9 @@ class OrderViewSet(
     permission_classes = [permissions.IsAdminUser & permissions.DjangoModelPermissions]
     serializer_classes = {
         "list": serializers.AdminOrderLightSerializer,
+        "export": serializers.AdminOrderExportSerializer,
     }
+    serializer_class = serializers.AdminOrderSerializer
     default_serializer_class = serializers.AdminOrderSerializer
     filterset_class = filters.OrderAdminFilterSet
     queryset = models.Order.objects.all().select_related(
@@ -632,7 +635,6 @@ class OrderViewSet(
         "credit_card",
     )
     filter_backends = [DjangoFilterBackend, OrderingFilter]
-    ordering_fields = ["created_on"]
 
     def destroy(self, request, *args, **kwargs):
         """Cancels an order."""
@@ -689,6 +691,29 @@ def refund(self, request, pk=None):  # pylint:disable=unused-argument
 
         return Response(status=HTTPStatus.ACCEPTED)
 
+    @extend_schema(
+        request=None,
+        responses={
+            (200, "text/csv"): OpenApiTypes.OBJECT,
+            404: serializers.ErrorResponseSerializer,
+        },
+    )
+    @action(methods=["GET"], detail=False)
+    def export(self, request):
+        """
+        Export orders to a CSV file.
+        """
+        queryset = self.filter_queryset(self.get_queryset())
+        serializer = serializers.AdminOrderListExportSerializer(
+            queryset.iterator(), child=self.get_serializer()
+        )
+        now = timezone.now().strftime("%d-%m-%Y_%H-%M-%S")
+        return StreamingHttpResponse(
+            serializer.csv_stream(),
+            content_type="text/csv",
+            headers={"Content-Disposition": f'attachment; filename="orders_{now}.csv"'},
+        )
+
 
 class OrganizationAddressViewSet(
     mixins.CreateModelMixin,

src/backend/joanie/core/factories.py

@@ -89,6 +89,8 @@ class Meta:
         model = settings.AUTH_USER_MODEL
         django_get_or_create = ("username",)
 
+    # In our database, first_name is set by authtoken with the user's full name
+    first_name = factory.Faker("name")
     username = factory.Sequence(lambda n: f"user{n!s}")
     email = factory.Faker("email")
     language = factory.fuzzy.FuzzyChoice([lang[0] for lang in settings.LANGUAGES])

src/backend/joanie/core/models/accounts.py

@@ -67,6 +67,13 @@ def __init__(self, *args, **kwargs):
     def __str__(self):
         return self.username
 
+    @property
+    def name(self):
+        """
+        Return the full name of the user if available, otherwise the username.
+        """
+        return self.get_full_name() or self.username
+
     def clean(self):
         """
         Normalize the `phone_number` value for consistency in database.

src/backend/joanie/core/models/certifications.py

@@ -246,7 +246,7 @@ def get_document_context(self, language_code=None):
             "delivery_stamp": timezone.now(),
             "verification_link": self.verification_uri,
             "student": {
-                "name": self.owner.get_full_name() or self.owner.username,
+                "name": self.owner.name,
             },
             "site": {
                 "name": settings.JOANIE_CATALOG_NAME,