cgt-nc-treso/README.md

3.6 KiB

Cotisations-Nextcloud — Trésorerie UL CGT (ul_tresorerie)

Application native Nextcloud (versions 33 à 35) conçue pour l'Union Locale CGT de Foix et de la Haute-Ariège permettant le suivi rapide des cotisations mensuelles des syndiqués isolés (INDIVIDUELS UL FOIX HAUTE-ARIEGE / Multipros), l'import depuis CoGétise (.asp) et le publipostage intégré.


Fonctionnalités principales

  • Grille annuelle de saisie rapide : Suivi mois par mois (Janvier à Décembre) des cotisations par adhérent, filtrage en temps réel, édition groupée et totaux mensuels/annuels.
  • Système d'alertes à deux niveaux :
    • Niveau 1 (Orange) : Retard modéré (configurable, par défaut 3 mois impayés).
    • Niveau 2 (Rouge) : Retard critique (configurable, par défaut 6 mois impayés).
  • Import CoGétise (.asp) : Importation et synchronisation des syndiqués depuis un fichier d'export tabulé CoGétise avec détection d'encodage (UTF-8 / Windows-1252) et aperçu des créations/mises à jour.
  • Publipostage & Reçus fiscaux (66 %) :
    • Génération de reçus fiscaux (déduction fiscale de 66 % des cotisations syndicales versées sur l'année).
    • Lettres de rappel de mois manquants et de rappel annuel.
    • Modèles personnalisables avec variables dynamiques et impression directe.
  • Contrôle d'accès : Gestion des administrateurs, utilisateurs et groupes Nextcloud autorisés à consulter et modifier la trésorerie.

Structure du dépôt

Cotisations-Nextcloud/
├── documentation/          # Sous-module Git officiel Nextcloud Documentation
├── ul_tresorerie/          # Code source de l'application Nextcloud
│   ├── appinfo/            # Métadonnées (info.xml) et routes (routes.php)
│   ├── css/                # Feuilles de style de l'interface
│   ├── img/                # Logos et bannières UL CGT
│   ├── js/                 # Logique front-end de l'application
│   ├── lib/                # Contrôleurs, Services et Migrations PHP
│   └── templates/          # Template principal Nextcloud (main.php)
├── .gitignore              # Exclusion des exports sensibles (*.asp) et archives (*.zip)
├── .gitmodules             # Configuration du sous-module de documentation Nextcloud
└── README.md               # Documentation du projet

Gestion de la documentation officielle Nextcloud

La documentation Nextcloud est gérée directement depuis le dépôt officiel (https://github.com/nextcloud/documentation.git) via un sous-module Git situé dans le dossier documentation/.

Cloner le projet avec la documentation

git clone --recurse-submodules <url-du-depot>

Si le dépôt a déjà été cloné sans l'option --recurse-submodules :

git submodule update --init --recursive

Mettre à jour la documentation depuis le dépôt officiel Nextcloud

git submodule update --remote documentation

Installation de l'application dans Nextcloud

Prérequis

  • Nextcloud : 33 à 35
  • PHP : 8.3 minimum

Déploiement

  1. Copier ou lier le dossier ul_tresorerie dans le répertoire custom_apps/ (ou apps/) de votre instance Nextcloud :
    cp -r ul_tresorerie /var/www/nextcloud/custom_apps/
    chown -R www-data:www-data /var/www/nextcloud/custom_apps/ul_tresorerie
    
  2. Activer l'application via occ ou depuis l'interface d'administration Nextcloud :
    sudo -u www-data php /var/www/nextcloud/occ app:enable ul_tresorerie
    

Licence

Distribué sous licence AGPL-3.0-or-later.