===============================================================================
  ZendureEvGuard — protection de batterie Zendure pendant la charge d'un
                   véhicule électrique
  ZendureEvGuard — Zendure battery protection while an electric vehicle charges
===============================================================================

-------------------------------------------------------------------------------
  FRANÇAIS
-------------------------------------------------------------------------------

1. AVANT DE COMMENCER

   Ouvrez « appsettings.json » et renseignez au minimum :
     - l'adresse de votre compteur (Shelly ou Smappee)
     - l'adresse de votre hub Zendure
     - votre clé d'abonnement (Subscription.SecretKey)

   Le détail de chaque réglage est dans USER_GUIDE_FR.md.

2. INSTALLATION

   Linux    :  sudo sh install-linux.sh
   macOS    :  sudo sh install-macos.sh
   Windows  :  clic droit sur PowerShell > « Exécuter en tant qu'administrateur »
               puis :  powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

               (Windows bloque par défaut les scripts téléchargés : c'est pour cela
                qu'on passe -ExecutionPolicy Bypass. Sans ça, rien ne se lance.)

   ⚠ Le service Windows tourne sous le compte SYSTEM, qui n'a pas le même espace
     de données que votre session. Renseignez donc bien Subscription.SecretKey dans
     appsettings.json AVANT d'installer : un essai activé en lançant le programme à
     la main ne serait pas vu par le service.

   Le programme s'installe DEPUIS CE DOSSIER : rien n'est copié ailleurs, et le
   dossier que vous avez décompressé est celui qui tourne. Relancer le script
   met à jour l'installation sans jamais écraser votre appsettings.json.

3. POUR L'ESSAYER SANS L'INSTALLER

   Lancez simplement l'exécutable. Touches : [P] pause, [R] reprise,
   Ctrl+C deux fois pour arrêter.

4. LANGUE ET COÛT

   "Messages": { "Language": "fr" }   met les notifications en français
   "Energy": { "PricePerKwhCents": 28 }   affiche le coût de chaque charge
                                          (28 = 0,28 €/kWh — un ENTIER, en centimes)

   Les journaux (logs) restent toujours en anglais : ce sont eux qu'on lit pour
   diagnostiquer une panne.

-------------------------------------------------------------------------------
  ENGLISH
-------------------------------------------------------------------------------

1. BEFORE YOU START

   Open "appsettings.json" and fill in at least:
     - your meter address (Shelly or Smappee)
     - your Zendure hub address
     - your subscription key (Subscription.SecretKey)

   Every setting is documented in USER_GUIDE_EN.md.

2. INSTALLATION

   Linux    :  sudo sh install-linux.sh
   macOS    :  sudo sh install-macos.sh
   Windows  :  right-click PowerShell > "Run as administrator", then:
               powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

               (Windows blocks downloaded scripts by default, which is why
                -ExecutionPolicy Bypass is needed. Without it, nothing runs.)

   ⚠ The Windows service runs as SYSTEM, which does not share your session's data
     folder. Fill in Subscription.SecretKey in appsettings.json BEFORE installing:
     a trial activated by running the program by hand would not be seen by the
     service.

   The program installs FROM THIS FOLDER: nothing is copied elsewhere, and the
   folder you unzipped is the folder that runs. Re-running the script upgrades
   the installation and never overwrites your appsettings.json.

3. TO TRY IT WITHOUT INSTALLING

   Just run the executable. Keys: [P] pause, [R] resume, Ctrl+C twice to stop.

4. LANGUAGE AND COST

   "Messages": { "Language": "en" }   language of the notifications
   "Energy": { "PricePerKwhCents": 28 }   shows the cost of each charge
                                          (28 = 0.28 €/kWh — a WHOLE number of cents)

   Logs always stay in English: they are what you read to diagnose a fault.

-------------------------------------------------------------------------------
  Digital3D — https://digital3d.com
-------------------------------------------------------------------------------
