Afficher les événements VA dans l'app INKK

Salut la VA,

Suite à notre rencontre en début d'année, vous m'avez proposé de faire évoluer vos événements pour ajouter les quelques champs nécessaires afin qu'ils puissent être automatiquement (sans avoir besoin de passer par une autre plateforme) affichés sur l'app INKK - INSA Lyon.

Pour rappel l'idée étant de voir INKK comme un nouveau moyen de communication sur lequel les assos peuvent s'appuyer pour diffuser leurs événements. De même, il me semble que l'affichage des événements de la VA sur INKK peut se comparer à ce qui est déjà disponible sur le télé affichage du campus.

Voici une proposition d'adaptation :

Évolution modèle Événement

Afin qu'un événement puisse correctement s'afficher dans INKK, il nous faudrait ces quelques champs supplémentaires :

• preview_url : lien vers la bannière/affiche de l'événement
• publication_datetime et expiration_datetime : dates et heure de début et de fin d'affichage de l'événements sur l'app. Par exemple pour un événement ayant lieu le 10 avril de 20h00 à 23h00, le début d'affichage peut être le 9 avril à 20h et la fin de l'affichage le samedi 11 à 9h00.
• inkk_app : un booléen précisant si l'événement doit être affiché dans INKK ou non

Idéalement, il faudrait également que le champ location contienne une propriété address, correspondant à l'adresse postale. Cependant si cette propriété n'est pas donnée, elle sera générée automatiquement à partir des coordonnées GPS.

Validation d'un événement

Pour que l’événement soit automatiquement ajouté dans l'app, il faut qu'il présente obligatoirement :

• un titre et une description
• une bannière
• les dates de début et de fin
• les dates de publication et d'expiration
• une localisation valide (long, lat, name et éventuellement address)
• une association valide qui soit référencée dans le BotINSA

Les champs facultatifs (mais affichés) dans INKK :

• website_url
• facebook_url

Les autres champs ne seront pas supportés pour l'instant (short_description, prices , logo_url).

Éventuellement, INKK permet d'afficher un bouton "Inscription", dans ce cas, il faudrait qu'une propriété registration_url (lien vers l'inscription) existe. Mais ce n'est pas obligatoire.

Synchronisation INKK/VA

Les événements de la VA seront, avec votre accord, synchronisés et formatés pour être diffusés sur INKK plusieurs fois par jour par tâche planifiée. À chaque synchronisation ils seront tous supprimés d'INKK, puis les événements valides seront ré-insérés. Ainsi si vous supprimez ou modifiez un événement sur la VA, les modifications/suppressions seront répercutées sur INKK avec un délai (quelques heures je pense).

La récupération des événements sur la VA peuvent se faire directement par l'API, avec authentification si vous le souhaitez (par exemple, avec un jeton à présenter dans le Header Authorization des requêtes). De même, INKK n'aura pas besoin d'accéder à tous les événements, mais seulement à ceux qui auront la propriété inkk_app à true, et dont la publication_datetime est dans moins de 3 jours. Si tous les événements sont retournés par l'API, seuls les événements respectant les 2 précédents critères seront validés/synchronisés/publiés.

PS 1 : je n'ai pas d'attache particulière aux noms des propriétés, ni à leur position dans les objets (parent, enfants, petits enfants, etc), ce ne sont que des propositions, je m'adapterai.

PS 2 : pouvez-vous me précisez la timezone de vos datetimes svp ? Est-ce Europe/Paris ou UTC ?

N'hésitez pas à répondre ici si vous avez la moindre remarque ou question. Je suis ouvert à d'autres propositions pour permettre de relayer les événements VA sur INKK ! Notre but est d'aider les étudiants et associations, en améliorant la visibilité des événements des assos auprès des étudiants !

Aurélien pour INKK.