feat: Ajout d'une API pour les Emplois

back/config/settings/base.py

@@ -61,6 +61,7 @@
     "dora.auth_links",
     "dora.nexus",
     "dora.decoupage_administratif",
+    "dora.emplois",
 ]
 
 MIDDLEWARE = [
@@ -373,6 +374,8 @@
     os.getenv("DATA_INCLUSION_EXCLUDE_DUPLICATES") == "true"
 )
 
+EMPLOIS_EMAIL = os.getenv("EMPLOIS_EMAIL")
+
 SKIP_DI_INTEGRATION_TESTS = True
 
 # BREVO :

back/config/urls.py

@@ -129,10 +129,14 @@
     path("api/v2/", include("dora.api.urls", namespace="v2")),
 ]
 
+emplois_api_patterns = [
+    path("api/emplois/", include("dora.emplois.urls", namespace="emplois")),
+]
 
 urlpatterns = [
     *private_api_patterns,
     *di_api_patterns,
+    *emplois_api_patterns,
     # anciennes routes Inclusion-Connect (en attente de suppression)
     *oidc_patterns,
     # nouvelles routes OIDC pour ProConnect

back/dora/decoupage_administratif/models.py

@@ -38,6 +38,14 @@ def get_from_code(self, code):
         self._cache[code] = value
         return value
 
+    def warm_cache(self, codes):
+        codes_to_fetch = {c.upper() for c in codes if c} - self._cache.keys()
+        if not codes_to_fetch:
+            return
+        found = {obj.code.upper(): obj for obj in self.filter(code__in=codes_to_fetch)}
+        for code in codes_to_fetch:
+            self._cache[code] = found.get(code)
+
 
 # Cache instantané pour les tables comportant peu d'entités
 # on fait la requête une fois pour toute

back/dora/emplois/serializers.py

@@ -0,0 +1,90 @@
+from rest_framework import serializers
+
+from dora.orientations.models import Orientation, OrientationStatus
+from dora.services.models import Service
+from dora.structures.models import DisabledDoraFormDIStructure
+
+
+class ReferenceDataSerializer(serializers.Serializer):
+    kind = serializers.CharField()
+    label = serializers.CharField()
+    value = serializers.CharField()
+
+
+class ServiceSerializer(serializers.ModelSerializer):
+    funding_labels = serializers.SlugRelatedField(
+        many=True, read_only=True, slug_field="value"
+    )
+    coach_orientation_modes = serializers.SlugRelatedField(
+        many=True, read_only=True, slug_field="value"
+    )
+    beneficiaries_access_modes = serializers.SlugRelatedField(
+        many=True, read_only=True, slug_field="value"
+    )
+    forms = serializers.ListField(child=serializers.CharField())
+    access_conditions = serializers.SlugRelatedField(
+        many=True, read_only=True, slug_field="name"
+    )
+    credentials = serializers.SlugRelatedField(
+        many=True, read_only=True, slug_field="name"
+    )
+    is_orientable_with_form = serializers.SerializerMethodField()
+    average_orientation_response_delay_days = serializers.SerializerMethodField()
+
+    class Meta:
+        model = Service
+
+        fields = [
+            "id",
+            "short_desc",
+            "recurrence",
+            "funding_labels",
+            "coach_orientation_modes",
+            "coach_orientation_modes_other",
+            "coach_orientation_modes_external_form_link",
+            "coach_orientation_modes_external_form_link_text",
+            "beneficiaries_access_modes",
+            "beneficiaries_access_modes_other",
+            "beneficiaries_access_modes_external_form_link",
+            "beneficiaries_access_modes_external_form_link_text",
+            "forms",
+            "online_form",
+            "access_conditions",
+            "credentials",
+            "is_orientable_with_form",
+            "contact_name",
+            "contact_phone",
+            "contact_email",
+            "is_contact_info_public",
+            "average_orientation_response_delay_days",
+        ]
+
+    def get_is_orientable_with_form(self, obj):
+        return obj.is_orientable() and any(
+            mode.value == "formulaire-dora"
+            for mode in obj.coach_orientation_modes.all()
+        )
+
+    def get_average_orientation_response_delay_days(self, obj):
+        """Délai moyen de réponse aux demandes d'orientation, en jours."""
+        orientations = getattr(obj, "answered_orientations", None)
+        if orientations is None:
+            orientations = Orientation.objects.filter(
+                service=obj,
+                status__in=[
+                    OrientationStatus.ACCEPTED,
+                    OrientationStatus.REJECTED,
+                ],
+                processing_date__isnull=False,
+            ).only("creation_date", "processing_date")
+
+        delays = [(o.processing_date - o.creation_date).days for o in orientations]
+        if not delays:
+            return None
+        return round(sum(delays) / len(delays))
+
+
+class DisabledDoraFormDIStructureSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = DisabledDoraFormDIStructure
+        fields = ["source", "structure_id"]

back/dora/emplois/tests/conftest.py

@@ -0,0 +1,41 @@
+import pytest
+from data_inclusion.schema.v0 import TypologieStructure
+from model_bakery import baker
+
+from dora.core.test_utils import make_published_service
+from dora.services.models import FranceTravailOrientableService
+
+
+@pytest.fixture(autouse=True)
+def _set_emplois_email(settings):
+    settings.EMPLOIS_EMAIL = "emplois@example.com"
+
+
+@pytest.fixture
+def emplois_user(api_client, settings):
+    user = baker.make("users.User", is_valid=True, email=settings.EMPLOIS_EMAIL)
+    api_client.force_authenticate(user=user)
+    return user
+
+
+@pytest.fixture
+def orientable_service_via_dora_form():
+    service = make_published_service(contact_email="contact@example.org")
+    service.structure.disable_orientation_form = False
+    service.structure.save()
+    service.save()
+    return service
+
+
+@pytest.fixture
+def ft_orientable_service():
+    service = make_published_service()
+    service.structure.typology = TypologieStructure.FT
+    service.structure.save()
+
+    FranceTravailOrientableService.objects.create(
+        structure=service.structure,
+        service=service,
+    )
+
+    return service