Overview

Artifact ID: 6f7fe4d5ea1aac37834543c48ec23492fbcb462e
Page Name:Garradin
Date: 2016-02-20 11:52:14
Original User: bohwaz
Parent: 4dcc7c834ffc9c1a1c950d46fdaa219a8a43c4a8 (diff)
Next 3ff04f49b5455cdf3a0bdcb1a8ac80e38b3f5989
Content

Garradin est un gestionnaire d'association libre, développé à l'aide de PHP5 et SQLite3, permettant de gérer les adhérents, archiver les documents, prendre en note les réunions, gérer la comptabilité, générer reçus de dons et d'adhésion, donner à l'association un site web, et bien plus.

Garradin signifie « argent » en Wagiman, dialecte aborigène de l'Australie.

Une description complète du projet est disponible sur http://dev.kd2.org/garradin/ (copie de la page about de ce wiki). Vous y trouverez aussi l'archive à télécharger pour installer Garradin, des captures d'écran, la documentation, etc.

Utilisation de Garradin

Garradin a été développé pour les besoins de deux associations au départ mais de nombreuses autres associations l'utilisent aujourd'hui.

Vous pouvez tester et utiliser Garradin sans rien installer sur http://garradin.eu/

Développement du projet :

  • On utilise Fossil qui sert de DVCS, wiki, gestionnaire de tickets, etc.
  • La Roadmap pour se faire une idée de ce qui est prévu dans les prochaines versions
  • Le Changelog pour voir ce qui a été fait
  • Le code est en PHP 5.4, nous changeons de version de PHP avec la version stable de Debian
  • On utilise SQLite3 comme base de données qui stocke tout : compta, membres, configuration, fichiers, wiki... Ainsi un seul fichier à sauvegarder et à gérer.
  • On essaye de suivre PSR-0 (enfin à peu près) pour le nommage des classes etc.
  • Convention de code : principalement PSR-1 et PSR-2, enfin pas à la lettre mais globalement (certaines règles ne sont pas des plus pratiques).

Comment développer avec Garradin ?

  • Installer Fossil, le gestionnaire de version utilisé par Garradin (équivalent de Git mais en mieux)
  • Cloner le repository dans un nouveau répertoire : fossil clone https://fossil.kd2.org/garradin/ ../garradin.fossil
  • Ouvrir le repository (va créer les fichiers du trunk) : fossil open ../garradin.fossil
  • Y'a plus qu'à coder !

Comment proposer un patch ?

  • Créer sa propre branche de développement : fossil branch new --private perso
  • Se positionner sur cette branche : fossil checkout perso
  • Faire ses modifs sur le code...
  • Exporter un patch : fossil -N --branch perso > mon-patch.txt
  • Envoyer le patch à la liste de discussion des patchs : patch@garradin.eu (en pièce jointe, ne pas oublier d'inclure une description de ce que le patch fait)

Comment participer à Garradin sans développer ?

  • En aidant les autres utilisateurs sur le channel IRC ou la liste de discussions (voir plus bas).
  • On peut Rapporter un bug
  • Pour participer à la documentation il suffit de se connecter et de modifier le wiki.
  • Pour développer une extension / un plugin : voir la page Plugins
  • Pour développer sur Garradin : consulter la Documentation développeur

Contact développeurs :

  • IRC : Salon #garradin sur le serveur irc.freenode.net
  • Mailing-liste : fermée

Autres solutions de gestion d'association : voir la page Inspiration

Source logo : http://www.flickr.com/photos/pikous/4462304300/in/photostream/