Artifact ID: | 6f7fe4d5ea1aac37834543c48ec23492fbcb462e |
---|---|
Page Name: | Garradin |
Date: | 2016-02-20 12:52:14 |
Original User: | bohwaz |
Parent: | 4dcc7c834ffc9c1a1c950d46fdaa219a8a43c4a8 (diff) |
Next | 3ff04f49b5455cdf3a0bdcb1a8ac80e38b3f5989 |
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/