Domoticz Mobile

Application mobile pour piloter les équipements Domoticz. Développée avec React Native et Expo, elle cible principalement Android et le web.

Prérequis

• Node.js 21 ou supérieur
• npm 6 ou supérieur
• Expo CLI (npm install -g expo-cli)

Installation

git clone https://github.com/vzwingma/domoticz-mobile.git
cd domoticz-mobile
npm install

Variables d'environnement

La configuration passe exclusivement par des variables d'environnement préfixées EXPO_PUBLIC_.
Créez un fichier .env.local à la racine du projet (non versionné) :

# URL du serveur Domoticz (inclure le port si nécessaire)
EXPO_PUBLIC_DOMOTICZ_URL=http://192.168.1.x:8080/

# Authentification Basic Auth encodée en Base64 (format : "login:password" encodé)
EXPO_PUBLIC_DOMOTICZ_AUTH=<Base64 de login:password>

# Environnement courant (optionnel)
EXPO_PUBLIC_MY_ENVIRONMENT=development

# Domaine du serveur Domoticz pour la configuration SSL (sans protocole ni port)
# Requis pour le support HTTPS avec certificat auto-signé
EXPO_PUBLIC_DOMOTICZ_DOMAIN=192.168.1.x

Générer la valeur Base64 : echo -n "monlogin:monmotdepasse" | base64

Certificat SSL auto-signé (HTTPS)

Si votre serveur Domoticz utilise HTTPS avec un certificat auto-signé, suivez ces étapes :

1. Exporter le certificat depuis votre serveur

openssl s_client -connect <HOST>:<PORT> -showcerts </dev/null 2>/dev/null \
  | openssl x509 -outform PEM > domoticz.crt
# Exemple :
openssl s_client -connect 192.168.1.100:8443 -showcerts </dev/null 2>/dev/null \
  | openssl x509 -outform PEM > domoticz.crt

Ou via un navigateur : cadenas → Certificat → Exporter au format PEM/Base64.

2. Placer le certificat dans le projet

assets/
  certificates/
    domoticz.crt   ← votre certificat ici (format PEM)

3. Configurer l'URL dans .env.local

EXPO_PUBLIC_DOMOTICZ_URL=https://domatique.freeboxos.fr:38243/

Le domaine est configuré directement dans app.json en option du plugin (pas via variable d'environnement).

4. Lancer le build natif

Le plugin SSL ne s'applique pas avec npm start (Expo Go). Il faut un build natif :

Commande	Contexte	SSL
npm start	Expo Go — développement rapide	❌
npm run android	Build local Android (nécessite SDK + JDK)	✅
npm run android:clean	Build local force-clean (plugin garanti)	✅
npm run start:dev-client	Dev-client déjà buildé (EAS development)	✅
eas build --profile previewV	APK distribution interne	✅

Pour développer localement avec SSL :

npm run android          # prebuild + compile + installe sur l'appareil/émulateur

Les modifications JS sont ensuite rechargées à chaud sans recompiler.

Si le premier build ne résout pas le problème (fichiers natifs en cache) :

npm run android:clean    # force un prebuild complet

Note Web : Pour le navigateur, acceptez l'exception de sécurité en naviguant manuellement vers l'URL HTTPS de Domoticz une première fois.

Scripts npm

npm start                                           # Serveur Metro (Expo Go — sans SSL)
npm run start:dev-client                            # Serveur Metro pour expo-dev-client (avec SSL)
npm run android                                     # Build natif Android + lancement (avec SSL)
npm run android:clean                               # Build natif Android force-clean (avec SSL)
npm run web                                         # Lancer dans le navigateur
npm test                                            # Tests Jest en mode watch
npm test -- path/to/file.test.tsx                   # Un fichier de test précis
npm test -- --testNamePattern="nom du test"         # Tests filtrés par nom
npm run lint                                        # ESLint via Expo

Builds EAS (distribution APK Android) :

eas build --profile development   # Dev-client (à utiliser avec npm run start:dev-client)
eas build --profile previewV      # APK à distribution interne (variante V)
eas build --profile previewC      # APK à distribution interne (variante C)
eas build --profile production    # Build de production

Architecture

Flux de données

UI (onglet)  →  Controller  →  ClientHTTP.service  →  Serveur Domoticz
                                       ↓
                       Mise à jour du Context → re-rendu UI

Toutes les requêtes HTTP sont centralisées dans app/services/ClientHTTP.service.ts via callDomoticz() avec Basic Auth et traçage UUID.

app/services/DataUtils.service.ts regroupe les utilitaires de données : tri des équipements (sortEquipements, sortFavorites), détection du type d'équipement depuis le nom (getDeviceType), évaluation de la cohérence des niveaux de groupe (evaluateGroupLevelConsistency), et gestion des favoris en AsyncStorage (getFavoritesFromStorage, saveFavoritesToStorage, clearFavoritesFromStorage).

Structure des dossiers

app/
  (tabs)/       # Écrans principaux : favoris, lumières/volets, températures, maison
  components/   # Composants de niveau écran (*.component.tsx)
  controllers/  # Pont entre l'UI et les services (*.controller.tsx)
  services/     # Client HTTP, fournisseur de contexte (*.service.ts)
  models/       # Modèles de données TypeScript sous forme de classes (*.model.ts)
  enums/        # Constantes, enums, couleurs, endpoints API

components/     # Composants UI génériques partagés (ThemedText, icônes…)
hooks/          # Hooks React personnalisés
assets/         # Polices, icônes, images

Routing : Expo Router avec routage basé sur les fichiers (routes typées activées).
État global : React Context API via DomoticzContextProvider.

Fonctionnalités

• Navigation par 5 onglets (Favoris, Lumières, Volets, Températures, Maison) avec header unifié (icône d'onglet + titre + badge de connexion)
• Badge de connexion unifié sur tous les onglets avec 4 états UI canoniques : Connecté, Synchronisation, Déconnecté, Erreur
• Écran Favoris orienté actions rapides : cartes 1 tap (action principale + bouton), slider conditionnel disponible en mode previewC, limité aux 8 favoris actifs les plus utilisés
• Affichage et contrôle des lumières (on/off, variateur) avec labels métier "Allumé"/"Éteint" et état synthétique pour les groupes ("Éteintes" / "Allumées" / "Mixte" / niveau%)
• Gestion des volets/stores (ouverture/fermeture via slider et clic icône) avec labels "Ouvert"/"Fermé" ; confirmation modale pour les actions sur groupe de volets (nom contenant "Tous")
• Consultation des capteurs de température avec indicateurs "Déconnecté"/"Inconnu" pour les capteurs inactifs
• Contrôle des thermostats (point de consigne ajustable par paliers de ±0,5°C, affichage distinct Mesure / Consigne)
• Gestion des groupes d'équipements (indicateur "Mixte" pour niveaux incohérents)
• Écran Maison : paramètres interactifs (présence, phase) via chips segmentés + section "À propos" (version app, version serveur Domoticz, statut connexion)

Composants UI principaux

Composant	Fichier	Rôle
DeviceComponent	app/components/device.component.tsx	Orchestrateur : délègue à ViewLightDevice ou ViewBlindDevice selon le type
ViewLightDevice	app/components/lightDevice.component.tsx	Affichage et contrôle d'une lumière individuelle ou groupe (on/off, variateur)
ViewBlindDevice	app/components/blindDevice.component.tsx	Affichage et contrôle d'un volet individuel ou groupe (slider, résumé groupe)
DeviceCard	app/components/deviceCard.component.tsx	Carte générique réutilisée par ViewLightDevice et ViewBlindDevice
FavoriteCard	app/components/favoriteCard.component.tsx	Carte favori "action rapide" (1 tap) ; slider conditionnel en mode previewC
PrimaryIconAction	app/components/primaryIconAction.component.tsx	Bouton icône principal utilisé dans les cartes d'équipements et favoris
DisconnectedState	app/components/disconnectedState.component.tsx	Indicateur visuel "Déconnecté" pour les équipements inactifs
TemperatureComponent	app/components/temperature.component.tsx	Card compacte pour un capteur de température
ThermostatComponent	app/components/thermostat.component.tsx	Contrôle de consigne thermostat avec boutons ±0,5°C
ParamListComponent	app/components/paramList.component.tsx	Paramètres interactifs (présence, phase) via chips segmentés

Tests

Les tests utilisent Jest avec le preset jest-expo (snapshot testing et tests unitaires).

npm test           # Lance Jest en mode watch
npm run lint       # Vérifie le code avec ESLint

Contribution

Consultez CONTRIBUTING.md pour les conventions et le processus de contribution.

Licence

Ce projet est sous licence MIT. Consultez le fichier LICENSE pour plus d'informations.