SUIVI DES VENTES CLIM-SPLIT — APPLICATION EXTERNE (v2.0.0)
===========================================================

Contenu du ZIP
--------------
  app/                     → l'application, à mettre sur le sous-domaine (ex. suivi.clim-split.com)
  climsuivilink.zip        → petit module PrestaShop (pastille + bouton « Ouvrir dans le suivi »)
  LISEZMOI-INSTALLATION.txt


ÉTAPE 1 — Créer le sous-domaine (cPanel O2switch)
-------------------------------------------------
1. cPanel → « Domaines » (ou « Sous-domaines ») → Créer :
     sous-domaine : suivi   ·   domaine : clim-split.com
     racine du document : /home/kole3907/suivi.clim-split.com
2. cPanel → « SSL/TLS Status » → cocher suivi.clim-split.com → « Run AutoSSL »
   (le certificat HTTPS gratuit arrive en quelques minutes).


ÉTAPE 2 — Créer la base de données
----------------------------------
cPanel → « Bases de données MySQL® » :
1. Créer une base : suivi   → elle s'appellera kole3907_suivi
2. Créer un utilisateur : suivi + mot de passe fort → kole3907_suivi
3. « Ajouter l'utilisateur à la base » → cocher TOUS LES PRIVILÈGES.
Notez le nom de la base, l'utilisateur et le mot de passe.


ÉTAPE 3 — Envoyer l'application (FileZilla)
-------------------------------------------
Envoyez le CONTENU du dossier app/ (pas le dossier lui-même) dans :
   /home/kole3907/suivi.clim-split.com/
Vous devez y voir directement index.php, install.php, orders.php, lib/, assets/, storage/…
Pensez à afficher les fichiers cachés dans FileZilla (Serveur → Forcer l'affichage des fichiers cachés)
pour que les fichiers .htaccess soient bien envoyés.


ÉTAPE 4 — Installer
-------------------
Ouvrez https://suivi.clim-split.com → la page d'installation s'affiche.
Saisissez la base (serveur : localhost) et créez votre compte administrateur
(votre email + un mot de passe d'au moins 10 caractères). Puis connectez-vous.


ÉTAPE 5 — Relier à PrestaShop (lecture seule)
---------------------------------------------
Dans le back-office PrestaShop :
1. Paramètres avancés → Webservice → « Activer le service web de PrestaShop » : OUI → Enregistrer.
2. « Ajouter une nouvelle clé de service web » :
     - Clé : cliquez sur « Générer »
     - Description : Suivi des ventes
     - État : Oui
     - Permissions : cochez UNIQUEMENT la colonne « Voir (GET) » pour :
          customers, order_states, orders
     → Enregistrer, et copiez la clé.
Dans l'application : Réglages → Connexion à PrestaShop
     - Adresse de la boutique : https://lastclim-split.com
     - Clé Webservice : collez la clé
     - Adresse du back-office : https://lastclim-split.com/vic2024
     → Enregistrer, puis « Tester la connexion » : les 3 lignes doivent être vertes.
Si une ligne est rouge en 403 : le pare-feu Tiger Protect bloque peut-être /api/ →
cPanel → Tiger Protect / ModSecurity : autoriser l'adresse du serveur, ou contacter le support O2switch.


ÉTAPE 6 — Reprendre les données de l'ancien module
--------------------------------------------------
Dans l'application : Réglages → « Importer les données de l'ancien module »
1. Téléchargez export-suivi-ventes.php et envoyez-le par FTP à la racine de PrestaShop :
     /home/kole3907/lastclim-split.com/export-suivi-ventes.php
2. Cliquez sur « Importer maintenant » (fournisseurs, montants, factures reçues, mise en service,
   kit, avoirs, statuts de saisie et nom de la personne qui a saisi sont repris).
3. SUPPRIMEZ export-suivi-ventes.php de PrestaShop par FTP.
4. Vérifiez le tableau d'un mois passé, puis dans PrestaShop : Modules → « Clim-split — Suivi des
   ventes & marge » → Désinstaller (ses tables restent en base, rien n'est perdu).


ÉTAPE 7 — Module PrestaShop « Lien suivi des ventes » (facultatif mais conseillé)
-------------------------------------------------------------------------------
Il remet dans PrestaShop la pastille « Saisie fourn. » (liste des commandes + haut de la fiche
commande) et un bouton « Ouvrir dans le suivi des ventes ». Il ne modifie rien dans PrestaShop.
1. Décompressez climsuivilink.zip et envoyez le dossier climsuivilink par FTP dans
     /home/kole3907/lastclim-split.com/modules/
2. Modules → Gestionnaire de modules → « Lien suivi des ventes » → Installer → Configurer.
3. Recopiez l'adresse (https://suivi.clim-split.com) et la clé d'API affichées dans
   l'application : Réglages → Module PrestaShop.  → Enregistrer (un message confirme la connexion).


ÉTAPE 8 — Email mensuel automatique
-----------------------------------
1. Dans l'application : Réglages → Email mensuel : destinataires + adresse d'expédition
   (créez de préférence une adresse @clim-split.com dans cPanel, ex. suivi@clim-split.com,
   pour que l'email n'arrive pas en spam).
2. cPanel → « Tâches Cron » → Ajouter :
     Paramètre courant : « Une fois par mois » (ou minute 0, heure 7, jour 1, mois *, jour sem. *)
     Commande : php /home/kole3907/suivi.clim-split.com/cron.php
   Le 1er de chaque mois à 7 h, l'export du mois précédent est créé, archivé (page Exports)
   et envoyé par email.
3. Supprimez l'ancienne tâche cron de climsuivivente si vous l'aviez créée.


ÉTAPE 9 — Créer les comptes
---------------------------
Utilisateurs → Ajouter : nom, email, mot de passe. Cochez « Administrateur » seulement pour
les personnes qui doivent gérer les comptes et les réglages.


UTILISATION AU QUOTIDIEN
------------------------
- Tableau du mois : les commandes sont récupérées automatiquement depuis PrestaShop
  (toutes les 10 min au plus, ou bouton « Actualiser maintenant »). Filtres par statut
  (À saisir / En cours / Validée / Factures en attente) et recherche.
- Cliquez sur un n° de commande pour saisir : prix fournisseurs HT + « Facture reçue »,
  mise en service TTC, kit installation TTC, avoir (+ Reçu), « Saisie validée ».
  « Enregistrer et passer à la suivante » pour enchaîner.
- Exports : téléchargement Excel de n'importe quel mois, envoi immédiat par email, archives.

Calculs (identiques au module) :
  CA HT net = (CA TTC − mise en service TTC − kit installation TTC) ÷ (1 + TVA de la commande)
  Marge brute = CA HT net − achats fournisseurs HT
  L'avoir n'entre dans aucun calcul.

Sécurité : accès par identifiant/mot de passe, HTTPS forcé, pages non indexées par Google,
5 essais de connexion max / 15 min, clé PrestaShop en lecture seule.
Sauvegarde : la base kole3907_suivi est incluse dans les sauvegardes JetBackup d'O2switch.
