Prepare HACS distribution

README.md

@@ -1,45 +1,42 @@
-# Arkteos — développement
+# Arkteos
 
-Ce dépôt prépare une intégration custom Home Assistant en lecture seule pour
-une PAC Arkteos Zuran 4.
+Intégration custom Home Assistant en lecture seule pour une PAC Arkteos Zuran
+4. Elle expose les données décodées du protocole REG3 par des entités natives
+Home Assistant.
 
-L'intégration devra lire exclusivement le flux du proxy TCP fourni par l'addon
-Home Assistant séparé, sur le port de référence `9641`. Elle ne doit jamais se
-connecter directement à la PAC ni écrire sur le proxy.
+L’intégration se connecte exclusivement au proxy Arkteos fourni par l’addon
+Home Assistant séparé. Elle ne se connecte jamais directement à la PAC et
+n’envoie aucune commande. Le port du proxy est configurable ; sa valeur par
+défaut est `9641`.
 
-## Références disponibles
+## Installation avec HACS
 
-- `references/arkteos_nodered_flow.json` : flow Node-RED fonctionnel en
-  production et seule référence actuelle pour le parsing.
-- `references/proxy_protocol_notes.md` : notes de contexte sur le proxy et les
-  tailles de trames rapportées.
+1. Dans HACS, ouvre **Intégrations** puis le menu à trois points.
+2. Choisis **Dépôts personnalisés**.
+3. Ajoute `https://gitea.i-host.fr/raph666/home-assistant-arkteos` avec la
+   catégorie **Intégration**.
+4. Installe **Arkteos**.
+5. Redémarre Home Assistant.
+6. Ajoute l’intégration dans **Paramètres > Appareils et services**.
 
-## État du dépôt
+Le proxy Arkteos doit être disponible avant la configuration de l’intégration.
 
-L'intégration Home Assistant n'est pas encore écrite. Aucun comportement de
-framing TCP ne doit être supposé sans captures ou tests démonstratifs.
+## Migration et validation
 
-## Arborescence cible proposée
+Conserve temporairement le flow Node-RED existant pendant la comparaison des
+valeurs publiées. Il reste la référence fonctionnelle actuelle des champs
+décodés.
 
-```text
-custom_components/
-  arkteos/
-    __init__.py
-    manifest.json
-    config_flow.py
-    const.py
-    coordinator.py
-    parser.py
-    sensor.py
-    binary_sensor.py
-    strings.json
-    translations/
-      fr.json
-tests/
-  components/
-    arkteos/
-references/
-```
+Le protocole REG3 est observé depuis des captures et le flow Node-RED de
+référence ; aucune documentation officielle complète du protocole n’est
+actuellement disponible. Les champs et les règles de découpage sont limités à
+ce qui est démontré par ces références.
 
-Cette arborescence est une proposition : elle ne crée encore aucun de ces
-fichiers.
+## Développement
+
+- `references/arkteos_nodered_flow.json` : flow Node-RED de référence.
+- `references/proxy_protocol_notes.md` : contexte connu sur le proxy.
+- `tests/fixtures/` : trames réelles anonymisées utilisées par les tests.
+
+Les captures privées et les informations de connexion ne doivent pas être
+versionnées.