O

OLIGAA

Outil est à destination des associations désirant faciliter la gestion et la communication autour des actions qu'elles entreprennent.

Name Last Update
app Loading commit data...
config Loading commit data...
db Loading commit data...
doc Loading commit data...
lib Loading commit data...
public Loading commit data...
script Loading commit data...
spec Loading commit data...
vendor/assets/javascripts Loading commit data...
.env.example Loading commit data...
.gitignore Loading commit data...
.pryrc Loading commit data...
.rspec Loading commit data...
.ruby-version Loading commit data...
CHANGELOG.md Loading commit data...
CONTRIBUTING.md Loading commit data...
Gemfile Loading commit data...
Gemfile.lock Loading commit data...
LICENSE.txt Loading commit data...
README.md Loading commit data...
Rakefile Loading commit data...
config.ru Loading commit data...

Outil en Ligne d'Information et de Gestion des Activités des Associations

Projet initié par le Comité départemental du sport adapté de Gironde (CDSA33), cet outil est à destination des associations désirant faciliter la gestion et la communication autour des actions qu'elles entreprennent. Commanditaire des développements depuis 2010, le CDSA33 libére le projet en 2016, sensible aux arguments de la démarche d'essaimage.

Ainsi, toute organisation se retrouvant dans les fonctionnalités imaginées et développées au fil des ans est maintenant libre de les utiliser, voire de les améliorer, en ajouter…

Quelques fonctionnalités

Grâce à OLIGAA :

  • vous organisez vos événements et en rendez visible le calendrier ;
  • vous mettez en avant les actions et les acteurs du changement que vous promouvez ;
  • vous partagez votre actualité par des articles en ligne et une lettre d'information ;
  • vous constituez un carnet d'adresses partagé entre tous les collaborateurs, avec la rédaction et l'envoi de courriels ciblés.

Retrouvez plus de détails sur la page dédiée au projet chez les développeurs ayant commis les premières versions :-)

Un effort particulier a notamment été fait d'un point de vue accessibilité pour permettre aux personnes ayant des difficultés d'avoir accès aux informations.

Et des idées pour la suite

Ce logiciel n'est pas terminé, loin de là. Il reste de nombreuses fonctionnalités à imaginer et à développer. Citons par exemple :

  • Un système d'invitation/inscription aux événements ;
  • Le choix entre des cartes Google Maps ou OpenStreetMap ;
  • Un web service de synchronisation des contacts pour carnet d'adresses sur ordinateur de bureau ou téléphone.

Vous trouverez tout en bas de ce document les modalités pour apporter votre pierre à l'édifice.

Comment l'utiliser ?

Cet outil respecte les us et coutumes du cadriciel grâce auquel il est développé : Ruby on Rails. Les instructions que vous trouverez ci-après ne devraient pas surprendre un habitué… Pour lancer OLIGAA, vous devez pouvoir exécuter Ruby dans la version mentionnée par le .ruby-version. Si vous devez l'installer, nous vous recommandons l'utilisation de rbenv et son greffon ruby-build.

Si ce que vous venez de lire ne vous parle pas, nous vous invitons à vous rapprocher d'une personne à l'aise avec les mots-clés ci-dessus :-)

Poste de développement

Avant de démarrer l'application pour la première fois, vous devez, dans le répertoire du projet :

  1. Installer les dépendances : bundle install ;
  2. Configurer votre environnement
    1. Copier le fichier .env.example vers .env ;
    2. Modifier les informations dans ce nouveau fichier.
  3. Initialiser la base de données : bundle exec rake db:setup ;
  4. Créer le compte administrateur : bundle exec rake oligaa:create_admin
    • N'oubliez pas de noter le mot de passe affiché dans votre terminal.

Vous pouvez alors :

  1. Lancer le serveur : bundle exec rails s Puma ;
  2. Vous connecter avec l'identifiant admin et le mot de passe noté plus tôt.

Éxécution des tests

Tout nouveau développement doit être accompagné de son jeu de tests, qui garantira qu'aucune régression ne pourra se glisser dans le futur. Pour leur écriture, nous utilisons la bibliothèque RSpec pour tous les types de test. Pour vous assurer que tout fonctionne comme attendu, vous pouvez lancer la suite de tests complète et vérifier que tout se déroule sans erreur, grâce à la commande habituelle :

$ bundle exec rake
[…]
XXX examples, 0 failures

Déploiement sur serveur

OLIGAA se déploie comme nombre d'applications Rails, sur hébergement dédié ou mutualisé. Les solutions habituelles telles que Phusion Passenger ou Nginx/Apache + Puma/Unicorn/Thin… fonctionnent sans problème. À titre d'exemple, le CDSA33 utilise un hébergement mutualisé chez AlwaysData, servi par Apache + Passenger.

Vous devez également avoir à disposition une base de données relationnelle (MySQL par exemple), les bases SQLite utilisées en environnement de développement et test n'étant pas adaptées à un environnement de production.

NB : OLIGAA n'a pas été testé sur les plateformes de cloud PaaS telles que Heroku.

Comment contribuer ?

Le code source n'est pas la seule contribution de valeur. Avis, problèmes, guides d'utilisation… Entrez dans la danse et appréciez la construction collaborative de biens communs offerte par le logiciel libre.

Informations détaillées et coordonnées dans le guide de contribution.