# Dashboard 2 — modèle de démonstration

Ce modèle reprend les trois colonnes et les cartes du deuxième dashboard. Tous les identifiants `demo_`, les illustrations et les liens d'exemple sont fictifs. Aucun capteur ni équipement n'est créé par l'import du dashboard.

## Contenu

- `dashboard-demo.yaml` : dashboard complet, avec une vue sous `views:`.
- `vue-demo.yaml` : vue seule à ajouter à un dashboard existant.
- `theme-demo.yaml` : thème sombre fourni, nommé `dashboard_2_demo`.
- `helpers-demo.yaml` : exemples de helpers facultatifs, à fusionner avec votre configuration existante.
- `personnalisation.json` : inventaire des identifiants fictifs et des images à personnaliser.
- `www/dashboard-2/` : illustrations SVG neutres et page d'iframe de démonstration.

## 1. Installer les dépendances

Dans HACS, installer **Button Card**, **Mushroom**, **Card Mod** et **Clock Weather Card**. Ajouter **Browser Mod** pour les fenêtres contextuelles et son intégration dans Home Assistant. Recharger le navigateur après installation et vérifier les ressources JavaScript.

Les cartes Mushroom Template utilisent ici `custom:mushroom-legacy-template-card`, la version conservée par Mushroom pour les styles Card Mod des anciens dashboards. Une installation Mushroom trop ancienne peut ne pas connaître ce type : mettre à jour Mushroom avant d'importer. Ne pas remplacer ce type par la nouvelle Template Card sans adapter les styles.

Documentation des projets :

- https://github.com/custom-cards/button-card
- https://github.com/piitaya/lovelace-mushroom
- https://github.com/piitaya/lovelace-mushroom/blob/main/docs/cards/legacy-template.md
- https://github.com/thomasloven/lovelace-card-mod
- https://github.com/pkissling/clock-weather-card
- https://github.com/thomasloven/hass-browser_mod

Les cartes natives (Sections, conditionnelles, carte, agenda, liste de tâches, image, piles et grilles) ne se téléchargent pas dans HACS.

## 2. Copier les illustrations et le thème

Créer le dossier `www/dashboard-2` dans votre configuration Home Assistant. Télécharger les illustrations individuellement depuis la rubrique « Les ressources » du guide, puis les placer dans ce dossier en conservant leurs noms. Vous pouvez aussi utiliser vos propres images et adapter les chemins dans le YAML. Le résultat attendu est `www/dashboard-2/image-demo-01.svg`, accessible à `/local/dashboard-2/image-demo-01.svg`. Le chemin `/local/` concerne Home Assistant, pas le site TechEnClair.

Copier `theme-demo.yaml` dans votre dossier `themes`. Si le chargement des thèmes n'est pas encore configuré, ajouter ceci à votre section `frontend` existante de `configuration.yaml` :

```yaml
frontend:
  themes: !include_dir_merge_named themes
```

Ne pas créer deux clés `frontend:`. Vérifier la configuration puis recharger les thèmes ou redémarrer Home Assistant. Vous pouvez aussi remplacer `theme: dashboard_2_demo` dans la vue par le nom d'un thème déjà installé.

## 3. Choisir le bon export

### Nouveau dashboard

Créer un dashboard personnel vide dans les paramètres Home Assistant. Ouvrir son éditeur de configuration brute et utiliser **tout** le fichier `dashboard-demo.yaml`. Il contient déjà `title:` et `views:`. Sauvegarder votre configuration précédente avant de la remplacer.

### Vue dans un dashboard existant

Utiliser `vue-demo.yaml` dans l'éditeur YAML d'une vue. Dans la configuration brute d'un dashboard, ajouter cette vue comme un élément de la liste `views:` en respectant l'indentation. Ne pas remplacer la configuration entière d'un dashboard par la vue seule.

Références : https://www.home-assistant.io/dashboards/views/ et https://www.home-assistant.io/dashboards/sections/

## 4. Personnaliser les identifiants

Ouvrir **Outils de développement → États** pour trouver vos entités réelles. Dans un éditeur de texte, remplacer chaque identifiant `demo_` par votre propre identifiant **dans toutes ses occurrences** : champs `entity`, conditions, cibles d'actions, JavaScript `states[...]` et modèles Jinja `states(...)` ou `state_attr(...)`.

Exemples :

```text
person.demo_membre_1             → votre entité person
weather.demo_meteo               → votre entité météo
sensor.demo_salon_temperature    → votre capteur de température
camera.demo_entree               → votre caméra
light.demo_salon                 → votre lumière ou groupe
```

Le fichier `personnalisation.json` donne l'inventaire complet. Aucun identifiant d'origine du créateur n'est nécessaire. Le préfixe `demo_` identifie les exemples ; ce ne sont pas des entités qui fonctionneront automatiquement chez vous.

Deux familles sont construites dynamiquement : `sensor.demo_film_1` à `sensor.demo_film_10` et `sensor.demo_energie_periode_p1_mensuel` à `p6_mensuel`. Si vous changez leurs noms, adapter aussi les préfixes construits dans le JavaScript/Jinja. Les suffixes des six périodes doivent correspondre à vos compteurs. Le nombre de capteurs cinéma réellement parcourus dépend de la boucle du module.

Les images `image-demo-01.svg`, etc. sont des illustrations neutres. Vous pouvez les remplacer par vos propres visuels ou adapter chaque chemin. La page `/local/dashboard-2/page-demo.html` et le lien `https://example.com/profil-demo` sont des exemples à remplacer ou des boutons à retirer. La navigation `/dashboard-demo/demo` suppose un dashboard dont l'URL est `dashboard-demo` et une vue `demo` : l'adapter au chemin réellement choisi.

## 5. Helpers et scripts

Les alertes utilisent des `input_boolean`, le poulailler un `input_select`, et la messagerie un `input_text`. Créer les helpers depuis l'interface avec les identifiants attendus, ou fusionner `helpers-demo.yaml` avec votre configuration. Ne pas écraser vos sections existantes.

Les **onze scripts métier ne sont pas fournis**. Le fichier `personnalisation.json` liste leurs identifiants fictifs. Leur rôle : messages aux membres, envoi collectif, envoi de courses, quatre annonces vocales et affichage d'une caméra. Créer vos propres scripts et renseigner vos appareils, services et destinataires dans votre instance. Retirer les boutons correspondants si ces fonctions ne vous intéressent pas. Aucun contact ni service de notification du créateur n'est inclus.

Le mode nuit repose sur un helper de planification ; l'alarme sur votre automatisation. Les évènements, données multimédias, stations de carburant et capteurs de consommation nécessitent vos propres intégrations. L'import du YAML ne les installe pas.

## 6. Énergie et coûts

Les valeurs dans `TARIFS`, `ABONNEMENT` et les calculs de prix sont des **exemples de démonstration**, sans valeur contractuelle. Les remplacer par vos prix, votre abonnement et votre méthode de calcul. La répartition en six périodes suppose des compteurs adaptés ; retirer ou réécrire cette partie si votre contrat fonctionne autrement.

Les cartes de coût affichent des estimations. Certaines formules héritées utilisent zéro en l'absence de capteur : un zéro avant configuration ne doit pas être interprété comme une mesure réelle. Vérifier les unités W, VA et kWh et le comportement des capteurs indisponibles avant d'utiliser les résultats.

## 7. Garder uniquement les modules utiles

Vous n'avez pas à posséder tous les équipements montrés. Dans l'éditeur, retirer les cartes ou blocs conditionnels des modules inutiles : spa, véhicule, caméra, présence, consoles, Plex, robot ou stations de carburant. Pour les membres, retirer leurs cartes et leurs références dans la carte de localisation et les boutons de message.

## Dépannage

- **Custom element doesn't exist** : vérifier l'installation et les ressources de la carte concernée, puis recharger sans cache.
- **Entité introuvable** : rechercher `demo_` et remplacer l'identifiant ou retirer le module.
- **Illustration absente** : ouvrir son URL `/local/dashboard-2/...` dans Home Assistant et vérifier le dossier copié.
- **Fenêtre contextuelle absente** : vérifier Browser Mod, son intégration et le navigateur utilisé.
- **Bouton sans effet** : vérifier le script ou l'entité cible dans les outils de développement.
- **Tarif à zéro / coût incorrect** : configurer les compteurs, les tarifs et l'abonnement ; vérifier les unités.
- **Rendu différent** : vérifier le thème, les dépendances, leur version et la largeur d'écran. Les trois colonnes se réorganisent sur mobile.

La syntaxe YAML et les templates JavaScript sont contrôlés lors de la préparation du modèle. L'affichage et les actions de vos intégrations doivent être vérifiés dans votre instance Home Assistant. Commencer avec un dashboard de test et garder une sauvegarde.
