Produits Entr'ouvert » Passerelle

Les données d'origine (l'objet réponse serialisé) ont l'aspect suivant:

[
    {
        "unit": {
            "id": "A10003123492",
            "idActivity": "A10003123490",
            "libelle": "2 2020-2021  RESTAURATION SCOLAIRE",
            "motif": "X" 
        },
        "listDays": [
            {
                "datePlanning": "2020-11-02T18:12:36.038+01:00",
                "dayType": {
                    "code": "DAY" 
                }
            },
            {
                "datePlanning": "2020-11-03T18:12:36.038+01:00",
                "dayType": {
                    "code": "DAY" 
                }
            }
        ]
    }
]

je les transforme en:

[
    {
        "unit": {
            "id": "A10003123492",
            "idActivity": "A10003123490",
            "libelle": "2 2020-2021  RESTAURATION SCOLAIRE",
            "motif": "X" 
        },
        "id": "A10003123490",
        "text": "2 2020-2021  RESTAURATION SCOLAIRE",
        "days": [
            {
                "type": "DAY",
                "id": "2020-11-02T18:12:36.038+01:00",
                "text": "02/11/2020 18:12:36" 
            },
            {
                "type": "DAY",
                "id": "2020-11-03T18:12:36.038+01:00",
                "text": "03/11/2020 18:12:36" 
            }
        ]
    }
]

A priori,
Les unité sont un découpage des activités par tranches de dates.
Il y a encore un troisième niveau de découpage avec les "placeList", qui correspondent aux différents lieux (ex: "ALSH PAGNOL", "ALSH MISTRAL"), mais qui n'entre pas en compte ici.

$ curl 'https://passerelle.dev.publik.love/maelis/test/activity-list/?NameID=local&personID=21293'
{"data" : [{
   "text" : "2020-2021 ALSH VACANCES PAGNOL (CAPA)",   // activité
   "id" : "A10003131850",
   "openDayList" : [...],
   "unitPortailList" : [
   {
      "dateStart" : "2021-02-28T00:00:00+01:00",   // unité
      "dateEnd" : "2021-03-05T00:00:00+01:00",
      "idUnit" : "A10003131861",
      "label" : "HIVER 2EME SEMAINE",
   },
   {
      "dateStart" : "2020-10-26T00:00:00+01:00",   // unité
      "dateEnd" : "2020-10-30T00:00:00+01:00",
      "idUnit" : "A10003131879",
      "label" : "TOUSSAINT 2EME SEMAINE",
   },
}

Ici, le service web 'readChildMonthPlanning' permet aussi de filtrer sur les unités.
Peut-être ajouter ce paramètre ?

Pour la présentation du résultat, j'avoue être content de ne pas être à ta place,
car je ne saurais pas comment présenter une arborescence sous forme de liste.

De nos discussions sur la liste, nous avons esquissé ce format en sortie du endpoint :

   {
     "data": [
        {
           "id": "[ID_ACTIVITY]-[ID_UNIT]-[JOUR]-[USER]",
           "category": "École",                      # label activité
           "text": "Accueil Matin",                  # label unit
           "datetime": "2020-08-12 08:00",           # jour
           "user_booking_status": "not-booked",      # statut
           "api": {                                  # (ou pas)
              "fillslots_url": ...,
              "cancel_callback_url": None,
           }
        }
        ...

Aussi, pour les 4 unités libellées : JOURNEE, MATIN, MATIN ET REPAS, APRES MIDI
on prévoit de retourner à leur place 3 unités factices "temps de la journée" : MATIN, REPAS et SOIR.

Ce sera ensuite au endpoint de réservation de retrouver la vrai unité en combinant les occurrences des 3 unités factices.
Le but de cette manipulation est de ne pas à avoir à afficher un bouton radio sur les combinaisons exposées par maélis (jusqu'à 8 ici), mais des cases à cocher sur leur (3) composantes.

• sans dates : il retourne le planning sur la semaine courante
• avec une date de début : il retourne le planning sur la semaine qui comprend cette date
• avec un intervalle de 2 dates : il retourne le planning sur intervalle

Je propose ce format (il manque #47172 pour avoir les URLs de réservations) :

   "data" : [
      {
         "category" : "MULTI ACCUEIL LES OLIVIERS",
         "category_id" : "A10000003840",
         "datetime" : "2020-12-14 00:00",
         "id" : "2020-12-14 00:00-A10000003840-A10000003844",
         "slot_id" : "A10000003844",
         "text" : "MULTI ACCUEIL LES OLIVIERS - Réguliers",
         "user_booking_status" : "not-booked" 
      },
      {
         "category" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "category_id" : "A10003132030",
         "datetime" : "2020-12-16 08:00",
         "id" : "2020-12-16 08:00-A10003132030-EO0000000001",
         "slot_id" : "EO000000000001",
         "text" : "Matinée",
         "user_booking_status" : "not-booked" 
      },

J'ai retiré l'usager (user_id) de l'identifiant puisqu'on ne prévoit pas d'en traiter plusieurs en même temps.
J'ai mis la date en premier dans l'id et j'ai trié la liste sur l'identifiant afin qu'elle suive l'ordre attendu sur la maquette.
J'ai ajouté les identifiants des activités ( category_id ) et des unités ( slot_id ), pour clarifier un peu le code du connecteur.

J'ai bien testé et les résultats me semblent cohérents avec ce que remonte les webservices.
Cependant, ça ne colle pas ce que présente le portail de maélis. Cf les accès donnés ici https://dev.entrouvert.org/projects/parsifal-mairie-de-toulouse (puis Gestion des Activtés > Gestion des plannings de vos enfants > voir la semaine du 14 au 20 décembre) à mettre en regard avec le fichier passerelle/tests/data/maelis/child_planning_before_decomposition.json.

• n'affiche que 4 lignes alors que le connecteur retourne 8 activités et 14 unités.
• affiche 4 inscriptions à l'unité "2 2020-2021 RESTAURATION SCOLAIRE", le connecteur aussi.
• n'affiche pas de ligne concernant les inscriptions pour "1 2020-2021 GARDERIE MATIN" retournées par le connecteur.
• affiche "2020-2021 CENTRE DE LOISIRS MERCREDI" non réservé le mercredi alors que d'après le connecteur c'est réservé.
• (sur janvier le planning me renvoyait au connecteur une journée réservée qui n'existe pas dans les activités. Il s'agissait d'une réservation que j'avais faite en testant le WS de réservation. Je l'ai retiré.)

J'ai revu le code de décomposition des unités en me basant sur leur id.
Et j'ai pris en compte un bug du WS readActivityList qui n'accepte pas de borne supérieure si on l'interroge avec deux dates à cheval sur deux année.

En voulant respecter l'ordre d'affichage de la maquette, j'ai réalisé que je pouvais retirer l'heure de l'identifiant,

• category_id pour coller aux catégories de la maquette ; ce que Maélis appelle l'activité.
• slot_id représenter chaque case à cocher sur la maquette ; ce que Maélis appelle l'unité.

Voici le rendu sur la journée du 16.
Pour la catégorie CENTRE DE LOISIRS MERCREDI il y a une 4ème unité qui vient en plus de Matin, Repas. Je ne sais pas à quoi elle correspond mais je devrais peut-être aussi la découper...

      {
         "category" : "MULTI ACCUEIL LES OLIVIERS",
         "category_id" : "A10000003840",
         "datetime" : "2020-12-16 00:00:00",
         "id" : "2020-12-16-A10000003840-A10000003845",
         "slot_id" : "A10000003845",
         "text" : "MULTI ACCUEIL LES OLIVIERS - Occasionnels",
         "user_booking_status" : "not-booked" 
      },
      {
         "category" : "HALTE GARDERIE LES MAGNOLIAS",
         "category_id" : "A10000006100",
         "datetime" : "2020-12-16 00:00:00",
         "id" : "2020-12-16-A10000006100-A10000006104",
         "slot_id" : "A10000006104",
         "text" : "HALTE GARDERIE LES MAGNOLIAS - Réguliers",
         "user_booking_status" : "not-booked" 
      },
      {
         "category" : "HALTE GARDERIE LES MAGNOLIAS",
         "category_id" : "A10000006100",
         "datetime" : "2020-12-16 00:00:00",
         "id" : "2020-12-16-A10000006100-A10000006105",
         "slot_id" : "A10000006105",
         "text" : "HALTE GARDERIE LES MAGNOLIAS - Occasionnels",
         "user_booking_status" : "not-booked" 
      },

      {
         "category" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "category_id" : "A10003132030",
         "datetime" : "2020-12-16 00:00:00",
         "id" : "2020-12-16-A10003132030-A10003132032",
         "slot_id" : "A10003132032",
         "text" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "user_booking_status" : "booked" 
      },
      {
         "category" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "category_id" : "A10003132030",
         "datetime" : "2020-12-16 08:00:00",
         "id" : "2020-12-16-A10003132030-EO0001PART01",
         "slot_id" : "EO0001PART01",
         "text" : "Matinée",
         "user_booking_status" : "not-booked" 
      },
      {
         "category" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "category_id" : "A10003132030",
         "datetime" : "2020-12-16 12:00:00",
         "id" : "2020-12-16-A10003132030-EO0001PART02",
         "slot_id" : "EO0001PART02",
         "text" : "Repas",
         "user_booking_status" : "not-booked" 
      },
      {
         "category" : "2020-2021 CENTRE DE LOISIRS MERCREDI",
         "category_id" : "A10003132030",
         "datetime" : "2020-12-16 14:00:00",
         "id" : "2020-12-16-A10003132030-EO0001PART03",
         "slot_id" : "EO0001PART03",
         "text" : "Après-midi",
         "user_booking_status" : "not-booked" 
      },

      {
         "category" : "COURS DE DANSE",
         "category_id" : "A10003132090",
         "datetime" : "2020-12-16 00:00:00",
         "id" : "2020-12-16-A10003132090-A10003132091",
         "slot_id" : "A10003132091",
         "text" : "COURS DE DANSE",
         "user_booking_status" : "not-booked" 
      },

Oui, ils affichent vraiment ça.

personID -> childID

oui c'est mieux (le WS s'appelle readChildMonthPlanning mais il prend un numPerson en paramètre)

J'ai juste changé personID en childID et utilisé la fonction parse_date de django.

0001: Je décompose le format des dates pour pouvoir le réutiliser ensuite sur les dates et/ou l'heure.

0002: Je me suis demandé pourquoi tu a fais démarrer la nouvelle année scolaire au 31 juillet plutôt qu'au 1er août (mais de toute façon Brice me dit qu'il n'y a pas de "vrai" date).

0003: Je vais chercher les infos d'abord via readActivityList pour avoir tous les événements réservables, et accessoirement aussi parce qu'il le nom de l'activité (qui permet de remonter une "catégorie"). Ensuite je les rapproche des événements déjà réservés donnés readChildMonthPlanning .

0004: Fait le découpage des unités qui concernant la journée de centre aéré ( matin, repas, aprés-midi) avec en tête que ce soit facile ensuite de faire l'opération inverse (je ne l'ai pas encore fait). J'ai ajouté au endpoint un paramètre qui permettra d'obtenir la réponse originale, ne serait-ce que pour faciliter la mise à jour du fichier de test.

Dans le 0004 petite erreur de typo dans la description du paramètre legacy: Decompose events releted to parts of the day if set => related.
Sinon go.

commit f9885e2fab49510a09022b5aa12dd0904129e317
Author: Nicolas ROCHE <nroche@entrouvert.com>
Date:   Wed Dec 23 17:11:56 2020 +0100

    maelis: decompose units related to moments of the day (#48480)

commit b6fa7108472b49682cf247e5f1058f548b090897
Author: Nicolas ROCHE <nroche@entrouvert.com>
Date:   Wed Dec 23 16:45:32 2020 +0100

    maelis: add child month planning listing (#48480)

commit b5da0a74ea6a7aae543af50b02f255e5c59cb9ed
Author: Nicolas ROCHE <nroche@entrouvert.com>
Date:   Wed Dec 23 15:18:51 2020 +0100

    maelis: allow school year computation from a given date (#48480)

commit bb748877fae9156afd6dab041b6cee5d2ebabd56
Author: Nicolas ROCHE <nroche@entrouvert.com>
Date:   Wed Dec 23 15:08:14 2020 +0100

    maelis: decompose datetime format constante (#48480)