GESTION LEASING - Installation sur hébergement cPanel
======================================================

Prérequis : PHP 8.0 ou plus avec PDO (SQLite ou MySQL). Aucune autre extension requise.

1. Dans cPanel > Gestionnaire de fichiers, créez un dossier (ex. public_html/leasing).
2. Envoyez le fichier gestion_leasing.zip dans ce dossier, puis "Extraire".
3. Vérifiez que les dossiers data/ et uploads/ sont en écriture (droits 755 ; 775 si besoin).
4. Ouvrez https://votre-domaine/leasing/install.php
   - SQLite : rien à configurer (recommandé, base stockée dans data/, protégée).
   - MySQL : créez d'abord la base et l'utilisateur dans cPanel > Bases de données MySQL.
   - Choisissez l'identifiant et le mot de passe administrateur.
   - Laissez cochée l'importation des 30 contrats et 6 avenants.
5. SUPPRIMEZ install.php après l'installation.
6. Connectez-vous, puis créez les autres utilisateurs dans le menu Utilisateurs.

Profils : Administrateur (tout + utilisateurs + paramètres), Gestionnaire (ajout/modification),
Lecture seule (consultation, simulations, exports).

Sauvegarde : téléchargez régulièrement le dossier data/ (SQLite) ou exportez la base MySQL
avec phpMyAdmin, ainsi que le dossier uploads/.

Données importées : extraites des PDF scannés. Les contrats marqués d'un point jaune ont une
date de 1re échéance estimée : corrigez-la dans "Modifier" puis décochez "Données à vérifier".
Le contrat Maghrebail 1827350 (bon de commande) attend durée, loyer et VR.

Calculs :
- RAP = loyers restant à échoir après la date de calcul (avenants appliqués à leur date d'effet).
- Coût = total des loyers + VR - valeur d'acquisition HT.
- Taux = taux implicite (valeur HT = loyers actualisés + VR), hors frais et préloyers.
- Montant du rachat : réglable dans Paramètres (loyers restants + VR, ou capital restant dû + VR,
  avec indemnité en %).

MISE À JOUR D'UNE INSTALLATION EXISTANTE
----------------------------------------
Envoyez le nouveau ZIP et extrayez-le par-dessus l'ancien dossier. Ne supprimez pas
config.local.php, data/ ni uploads/. Supprimez à nouveau install.php.
La base est mise à jour automatiquement à la première connexion (e-mail des utilisateurs,
règles de notification, historique des envois).

NOTIFICATIONS PAR E-MAIL
------------------------
1. cPanel > Comptes de messagerie : créez par ex. leasing@votre-domaine.ma.
   "Connect Devices" (Configurer le client) donne le serveur SMTP : souvent
   mail.votre-domaine.ma, port 465 (SSL).
2. Application > Notifications > Configuration e-mail : mode SMTP, serveur, port 465, SSL,
   identifiant = adresse complète, mot de passe du compte, adresse d'expédition = la même.
   Cliquez "Tester la configuration".
3. Utilisateurs : renseignez l'e-mail de chaque personne à prévenir.
4. Notifications > Nouvelle règle : fréquence (jour, semaine, mois), seuils 1/2/3/6 mois,
   destinataires (utilisateurs cochés + autres adresses), organismes.
   "Tester" envoie le rapport à une seule adresse ; "Envoyer maintenant" à tous.
5. cPanel > Tâches Cron : une fois par jour, commande affichée dans la page Notifications :
   /usr/local/bin/php -q /home/COMPTE/public_html/leasing/cron.php >/dev/null 2>&1

CRÉDITS MOYEN TERME (CMT)
-------------------------
Menu "Crédits (CMT)". Les 3 crédits fournis (BMCE Oxygène 71058805, BMCE Relance 71032561,
BMCI 4065952 01) sont importés automatiquement à la première connexion après la mise à jour,
avec leurs tableaux d'amortissement PDF.
- Intérêts en jours exacts/360 (BMCE) ou 30/360 (BMCI), TVA 10 % sur intérêts, franchise de capital.
- Taux variable : ajoutez chaque révision (date d'effet, nouveau taux, échéance si connue)
  dans la fiche du crédit ; le tableau est recalculé.
- Simulations : remboursement anticipé total ou partiel, variation de taux, nouveau crédit,
  capacité d'emprunt.
- Les CMT sont inclus dans le tableau de bord, la vue globale et les alertes e-mail.


============================================================
TRÉSORERIE KENZ POWER HOLDING
============================================================
Module de suivi de trésorerie du groupe : 5 sociétés, 6 comptes bancaires
(Kenz Power Holding BMCE + SGMB, Empower Facilities, Windon Energy, Marshpark,
Empower Reality Management). Il est indépendant des modules Leasing et CMT.

1) Accès
   - Les administrateurs y ont toujours accès.
   - Pour les autres utilisateurs : menu Administration > Utilisateurs, cocher
     la case « Trésorerie ». Un profil « lecteur » consulte sans pouvoir saisir.

2) Première ouverture après la mise à jour
   - Les tables sont créées automatiquement et les 6 fichiers Excel de
     trésorerie sont importés (279 mouvements, du 01/05/2023 au 17/09/2026).
   - Une fois vérifié, vous pouvez supprimer inc/treso_seed.json (données
     déjà en base ; ce fichier n'est plus utilisé).

3) Saisie (menu Trésorerie > Saisie)
   - Saisie rapide : compte, + Encaissement / − Décaissement, date, montant,
     libellé du relevé. La catégorie est proposée automatiquement. Le montant
     accepte une somme (2,75+7,5+20). « Enregistrer et saisir un autre »
     garde le compte et la date.
   - Relevé bancaire : grille à la manière d'un relevé (date, libellé, débit,
     crédit). On peut coller des lignes copiées depuis Excel ou charger un
     fichier CSV. Les lignes déjà saisies sont ignorées (pas de doublon).
     On peut indiquer le solde final du relevé pour contrôler l'écart.
   - Un libellé non reconnu est placé dans « À classer » et se classe ensuite
     en un clic depuis Mouvements (filtre « À classer »).

4) Classement automatique (menu Classement)
   - Ordre de décision : 1) même libellé déjà classé, 2) mots-clés.
   - Mots-clés et catégories modifiables ; zone de test d'un libellé.
   - Les règles sont lues de haut en bas : la colonne « Ordre » décide.

5) Autres écrans
   - Tableau de bord : trésorerie totale, position par société, flux du mois,
     courbes sur 12 mois, derniers mouvements, alertes (dépassement, relevé
     ancien, écart de rapprochement, lignes à classer).
   - Mouvements : recherche, filtres, export CSV, modification, suppression.
   - Plan de trésorerie : présentation mensuelle identique à vos fichiers
     Excel (recettes, dépenses, solde final), par groupe, société ou compte.
   - Comptes bancaires : soldes, autorisation de découvert, contrôle avec le
     relevé de la banque, journal d'un compte avec solde courant.
   - Les virements entre sociétés du groupe sont repérés (badge « groupe ») et
     isolés dans les flux du mois et dans le plan consolidé.
   - Un mouvement daté dans le futur est traité comme prévisionnel : il
     n'entre pas dans le solde actuel mais dans la prévision à 30 jours.

6) Mise à jour
   Extraire ce ZIP dans le dossier de l'application (ds.somalev.tech/leasing)
   en écrasant les fichiers, puis Ctrl+F5. Le fichier install.php, la base
   (data/), config.local.php et uploads/ ne sont pas touchés.
