# 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**.