83 lines
3.6 KiB
Markdown
83 lines
3.6 KiB
Markdown
# 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
|
|
|
|
```text
|
|
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
|
|
```bash
|
|
git clone --recurse-submodules <url-du-depot>
|
|
```
|
|
|
|
Si le dépôt a déjà été cloné sans l'option `--recurse-submodules` :
|
|
```bash
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
### Mettre à jour la documentation depuis le dépôt officiel Nextcloud
|
|
```bash
|
|
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 :
|
|
```bash
|
|
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 :
|
|
```bash
|
|
sudo -u www-data php /var/www/nextcloud/occ app:enable ul_tresorerie
|
|
```
|
|
|
|
---
|
|
|
|
## Licence
|
|
Distribué sous licence **AGPL-3.0-or-later**.
|