facturation/README.md

81 lines
3.7 KiB
Markdown
Raw Normal View History

2019-11-02 17:46:18 +01:00
# Plugin Facturation pour Garradin
2019-11-02 17:47:20 +01:00
Plugin de facturation pour le logiciel de gestion d'association Garradin ( https://garradin.eu/ - https://fossil.kd2.org/garradin ).
2019-11-02 22:47:00 +01:00
Source : https://gitlab.com/ramoloss/garradin-plugin-facturation
2019-11-02 17:47:20 +01:00
## Installation:
2020-09-17 00:54:13 +02:00
Vous pouvez télécharger l'archive depuis la page des [releases](https://gitlab.com/ramoloss/garradin-plugin-facturation/-/releases).
2019-11-02 17:47:20 +01:00
Normalement, les plugins de Garradin doivent seulement être laissé sous forme d'archive .tar.gz dans le dossier plugins, or pour la génération des PDF, la librairie mPDF a besoin d'écrire des fichiers temporaires.
Il faut pour cela faire :
tar xvf garradin-plugin-facturation-v0.2.0.tar.gz
2020-09-17 00:59:10 +02:00
mv garradin-plugin-facturation-v0.2.0 facturation
rm garradin-plugin-facturation-v0.2.0.tar.gz
2019-11-02 17:47:20 +01:00
chown -R www-data:www-data facturation/
chmod -R g+w facturation/
Supprimer l'archive permet à Garradin de ne pas la lire à la place du dossier.
Pour le moment, le fonctionnement du plugin se repose sur l'existence d'un champs « nom » (comme créé à l'installation de Garradin) dans les fiches membres. Celui-ci sert à remplir le champs du destinataire lorsqu'un document est adressé à un membre. S'il n'existe pas, la page « Nouveau document » renverra une erreur.
2019-11-02 17:47:20 +01:00
## Fonctionnalités :
2019-11-02 23:02:16 +01:00
- Créer et gérer une base de client·es
- Créer et modifier des factures et devis adressés aux membres de l'association ou des client·es ajouté·es
2019-11-02 17:47:20 +01:00
- Génération des documents (facture et devis) en PDF grâce à la librairie mPDF
2019-11-02 23:02:16 +01:00
- Liste les documents associés sur la fiche d'un·e client·e
2019-11-02 17:47:20 +01:00
- Permet de définir le statut du document sur reglée
- **Configuration** :
- Possibilité d'ajouter le numéro de SIRET de l'association si elle en possède un (apparait alors sur les documents)
- Modification du pied de page des documents (notament pour y inscrire des mentions légales)
- Vérifier le code postal : si coché, lors d'ajout ou de modification de client, le plugin vérifiera que le code postal entré est bien formaté (par rapport aux codes postaux français seulement)
2019-11-02 23:02:16 +01:00
- Noms de client·es uniques : si coché, lors d'ajout ou de modicifation de client·e, le nom du/de la client·e ne pourra pas être le même que celui d'un·e client·e déjà existant
2019-11-02 17:47:20 +01:00
2020-10-12 20:49:32 +02:00
Note : pour le moment, les actions sur la liste des clients à cocher ne fonctionnent pas. Pour supprimer un client, le faire depuis sa fiche.
2019-11-02 17:47:20 +01:00
## Futur :
- Ajout des champs Référence, Prix unitaire, Quantité sur les documents
2019-11-02 23:02:16 +01:00
- Actions sur liste de client·es (exporter, supprimer)
2019-11-02 17:47:20 +01:00
- Afficher/filtrer les documents par statuts réglé/archivé
- Changer statut depuis la liste des documents
- Système de template ou jsp pour modifier facilement l'apparence de la facture par l'utilisateur ?
- Petite modif/fix CSS
- Gestion TVA ?
- Un devis ne devrait pas pouvoir être réglé
2019-11-02 23:02:16 +01:00
- Quid si un·e membre de l'asso est supprimé·e alors que des documents lui sont adressés ?
2019-11-02 17:47:20 +01:00
## Futur improbable :
- Opérations de paiements dans la compta liés à une facture
- Gestion de produits
2019-11-04 01:21:17 +01:00
Le plugin nécessite l'extension PHP mbstring.
2019-11-02 17:47:20 +01:00
## Inclus les bibliothèques suivantes :
- Composer :
https://getcomposer.org/
Copyright (c) Nils Adermann, Jordi Boggiano,
Licence: MIT
- mPDF :
https://mpdf.github.io/
Copyright (C) 2010 Ian Back,
Licence : GNU GPL v2
Et les dépendances de mPDF :
- DeepCopy :
https://travis-ci.org/myclabs/DeepCopy
Copyright (c) 2013 My C-Sens,
Licence: MIT
- random_compat :
https://github.com/paragonie/random_compat
Copyright (c) 2015 Paragon Initiative Enterprises,
Licence: MIT
- fpdi :
https://www.setasign.com/products/fpdi/
Copyright (c) 2017 Setasign - Jan Slabon, https://www.setasign.com ,
Licence: MIT