.
D 2016-02-20T11:52:14.995
L Garradin
P 4dcc7c834ffc9c1a1c950d46fdaa219a8a43c4a8
U bohwaz
W 3541
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.
<h3>Utilisation de Garradin</h3>
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/]
<h3>Développement du projet :</h3>
* 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 [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md|PSR-0] (enfin à peu près) pour le nommage des classes etc.
* Convention de code : principalement [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md|PSR-1] et [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md|PSR-2], enfin pas à la lettre mais globalement (certaines règles ne sont pas des plus pratiques).
<h3>Comment développer avec Garradin ?</h3>
* Installer [http://fossil-scm.org/|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 !
<h3>Comment proposer un patch ?</h3>
* 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)
<h3>Comment participer à Garradin sans développer ?</h3>
* 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]
<h3>Contact développeurs :</h3>
* 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/]
Z 711281d1ff8b73b0fca8e91e9b55f876