Publication initiale de RelaisSMS : documentation et sources nettoyees

2026-10-21 09:29:39 +02:00
commit ac186b03b1
158 changed files with 24818 additions and 0 deletions
@@ -0,0 +1,37 @@
+# afpma-sms-api
+
+Il faut créer une interface weeb d’envoi de SMS à destination de personnes ou de groupes.
+
+Dans un premier temps, il faut définir les champs nécessaires et les sources de données possibles. Il peut y avoir plusieurs sources potentielles de contacts.
+
+La première source est Galette, le logiciel de gestion associative. À partir de la liste des adhérents, on récupère les informations de contact, notamment les numéros de téléphone. Un contact peut avoir plusieurs numéros de téléphone.
+
+Une seconde source possible, c’est des contacts carddav (carnet d’adresse nextcloud par exemple) 
+
+On stockera un cache local dans une base de données. On récupérera également les groupes auxquels appartient l’adhérent. La notion de groupe est importante dans l’interface.
+
+C’est sync donc si un utilisateur est supprimer dans la source on le supprime en base 
+
+Le sync ce fait via tâche cron mais aussi forcé via un bouton dans l'interface... 
+
+On peut cumuler ces sources
+
+On peut ajouter des utilisateurs “locaux” (non distant, non sync…) donc en base sur chaque contact on doit se rappeler d’où ça vient…)
+
+Les groupes peuvent être importés depuis la source, rester présents dans l’interface, et ne pas forcément être supprimables. Ils peuvent aussi être créés à la volée par l’utilisateur.
+
+L’interface devra proposer un formulaire d’envoi de SMS. Ce formulaire devra permettre de choisir une destination, de saisir un texte, puis d’envoyer le SMS.
+
+La destination pourra être un ou plusieurs contacts, un ou plusieurs groupes, qu’il s’agisse de groupes locaux ou de groupes issus de Galette.
+
+Il faudra gérer le cas où un contact disparaît d’un groupe, ainsi que la mise à jour des informations importées.
+
+Une autre fonctionnalité envisagée est la connexion à un agenda. L’idée serait de pouvoir déclencher un envoi ou un rappel lié à un événement, par exemple une notification quelques minutes avant un événement.
+
+Il faudra conserver une trace des SMS envoyés par l’interface.
+
+Il peut aussi être utile de prévoir une gestion de groupes favoris ou de contacts favoris, afin de les faire remonter plus facilement dans les listes.
+
+Il s’agit d’une interface pour envoyer des SMS. L’envoi final ce fait via des API. Principalement ici compatible avec l’API OVH SMS dans un premier temps, mais il faudrait rester compatible avec d'autres... une sorte de gestion "plugin" / class...
+
+À partir de ces besoins exprimés, il faut réaliser une sorte de cahier des charges Markdown.