Un logiciel fédéré pour organiser des évènements. https://mobilizon.chapril.org/

Anim'sys: Philippe et Tykayn.

Outils du Chapril :

• Suivi Icinga
• tickets en cours sur Agir

Dépots sources utilisés :

• Outils https://forge.april.org/Chapril/mobilizon.chapril.org-tools
• Source de l'instance Chapril https://forge.april.org/Chapril/mobilizon.chapril.org-mobilizon
• Dépot upstream: https://framagit.org/framasoft/mobilizon

voir cette page dédiée d'installation

Pour fusionner les avancées de l'upstream avec la branche chapril:

• Communiquer le début de migration
• Fusionner la nouvelle version dans notre branche “chapril”
• Compiler les assets du frontend et les envoyer sur la VM biliz
• prendre les vernières modifications et migrer la base de données
• relancer le service mobilizon
• Vérfier que tout est bon
• Communiquer la fin de migration

Voici le détail des opérations:

disons dans le dossier /var/www/html/mobilizon - fusionner le tag le plus récent sur la branche chapril

1. pour voir la liste des tags: git tag
2. git merge 1.0.6 (par exemple, mais il faut utiliser la version la plus récente)
3. résoudre les éventuels conflits

- vérifier que tout fonctionne bien - en effectuant les migrations de base données mix ecto.migrate - en lançant localement le serveur mix phx.server et en naviguant sur http://localhost:4000 - créer un tag avec le préfixe chapril et le numéro de tag, par exemple git tag chapril-1.0.6 - envoyer vers la forge chapril notre nouveau tag

1. git push –tags
2. Se positionner sur la branche master: git checkout master
3. Prendre les avancées du dépot upstream, tags inclus:
   1. Si vous n'avez pas ajouté le dépot upstream, ajoutez le en https ou en ssh selon votre préférence
      1. git remote add upstream https://framagit.org/framasoft/mobilizon.git
      2. git remote add upstream git@framagit.org:framasoft/mobilizon.git
   2. git pull –all

- Recompiler les assets du frontend et les mettre dans le dossier live/priv/static

- Syncroniser les assets compilés avec la VM biliz (nécessite d'avoir rsync installé sur la VM)

- se connecter à la VM biliz, aller dans le dossier “live”,

se mettre en tant qu'utilisateur mobilizon et récupérer les dernières modifications de la branche chapril. (attention à avoir comme dépot d'origine le dépot de la forge april, et non l'upstream pour bien avoir votre branche personnelle) Ce qui nous amène sur le tag le plus récent:

- Stopper le service mobilizon: service mobilizon stop

(on en a pas forcément besoin à tous les coups, si dans la partie locale vous aviez remarqué que seule la partie frontend changeait, vous pouvez relancer le service après avoir uniquement mis à jour les assets de priv/static et faire service mobilizon restart). Ne pas oublier de spécifier l'environnement de prod.

	<note tip>
	su -H mobilizon MIX_ENV=prod mix deps.get
	su -H mobilizon MIX_ENV=prod mix ecto.migrate
	</note>

- Remettre l'utilisateur mobilizon comme owner des fichiers

- relancer le service mobilizon: service mobilizon start ce qui doit prendre environ 5 secondes sur Biliz.

- vérifier les erreur dans le journal du service

<note tip>journalctl -fu mobilizon -n1000</note>
- si c'est bon, interrompre la lecture du journal d'erreurs: Ctrl + C.
- vérifier le frontend sur https://mobilizon.chapril.org , nécessite un vidage de votre cache navigateur (ctrl + R)

- Communiquer la fin de mise à jour sur les canaux qui vont bien.

• une favicon chapril
• un logo dans la barre de menu
• une palette de couleur incorporant le bleu Chapril: rgb(0,81,132), alias #ff5e00
• l'image par défaut des évènements reprend une illustration de David Revoy
• quelques marges différentes
• ajout d'une liste de services en ligne dans la page de documents pour les groupes
• la barre de menus du chapril

- rien de plus pour le moment que ce qui est en production sur https://mobilizon.chapril.org

Changer le texte de présentation de l'instance: https://mobilizon.chapril.org/settings/admin/settings nom de l'instance, slogan, description courte, description longue, lien vers les CGU du chapril. https://www.chapril.org/cgu.html

ne pas oublier d'enregistrer.

s'abonner aux autres instances le plus tôt possible pour profiter de la fédération. liste des autres instances: https://instances.joinmobilizon.org

Les images par défaut des évènements créé sans avoir uploadé d'affiche ont une image par défaut que l'on peut changer. Pareillement pour le favicon et le logo dans la barre de navigation.

Dans les sources du projet, certaines images ont été remplacées dans le dossier js/public/img Pour les palettes de couleur, les variables scss ont été modifiées dans js/src/variables.scss les espacements ont été modifiés dans js/src/common.scss

Pour les liens dans le composant de Ressources js/src/views/Resources/ResourceFolder.vue une simple liste de liens à été ajoutée.

Mettre en place un environnement de développement local permet de personnaliser au mieux sa version de Mobilizon. Pour cela il faut comprendre sa stack technique, constituée d'un côté d'un projet Phoenix écrit en Elixir / Erlang, avec une base de données Postgresql, une interface en GraphQL qui communique avec la lib Absinthe, et de l'autre côté pour le front end: une app en vueJS version 3 (dans le dossier js), utilisant Appollo pour parler avec GraphQL. Le code du front end est majoritairement en typescript et les feuilles de style en SCSS.

Pour personnaliser les couleurs, il faut enlever les définitions de couleurs dans les composants vue pour éviter les surcharges indésirées, et modifier les couleurs dans les fichiers js/src/variables.sccss et faire référence à ces variables ailleurs dans les composants vue si nécessaire. Le gros du style est fourni par la lib CSS Bulma ( https://www.bulma.io ) et agrémenté de quelques retouches dans le fichier common.scss

Pour avoir son instance fonctionnant localement il faut installer les dépendances de dev du back (les dépendances Elixir) et du front (les dépendances NPM), configurer l'accès à la base de données postgresql dans le fichier de config .exs, effectuer les migrations de la base avec Ecto (mix ecto.migrate) puis lancer la commande.

mix phx.server

ce qui permet de lancer un serveur sur localhost:8000 qui se rafraîchira à l'enregistrement de vos modifications grâce à des filewatcher inode.

On a une version personnalisée de Mobilizon, mise à disposition sur la forge https://forge.april.org/Chapril/mobilizon.chapril.org

Sa branche master est notre version personnalisée. Nous la rebasons quand nécessaire par dessus la branche master de l'upstream, fournie par framagit.

Pour proposer du code, il convient de créer une branche, faire ses commits, vérifier que les tests passent, faire une merge request avec au moins une autre personne révisant le code à fusionner, et si tout passe bien, fusionner dans la branche master.

En cas de question concernant le logiciel libre Mobilizon, se référer en premier lieu à la documentation officielle du dépot upstream. https://docs.joinmobilizon.org/

bugs détectés sur mobilizon.chapril.org et ouvert sur la forge upstream

https://framagit.org/framasoft/mobilizon/-/issues/529

• mise en place d'un honeypot pour empêcher le spam
• ajout d'itinéraire utilisant openstreetmap dans la page d'évènement, dans la popup montrant une carte.