feat(domotique): update

Author: AymericLeFeyer

CODE_OF_CONDUCT.md

@@ -0,0 +1,50 @@
+# 🤝 Code de Conduite de la Communauté AyLabs
+
+## Notre Engagement
+
+Dans l'intérêt de favoriser un environnement ouvert et accueillant, nous nous engageons à faire de la participation à notre projet et à notre communauté une expérience exempte de harcèlement pour tous, quels que soient l'âge, la taille corporelle, le handicap visible ou invisible, l'ethnicité, le niveau d'expérience, la nationalité, l'apparence physique, la race, la religion, ou l'identité et l'orientation sexuelle.
+
+## Nos Normes
+
+Les exemples de comportement qui contribuent à créer un environnement positif comprennent :
+
+* Faire preuve d'empathie et de gentillesse envers les autres.
+* Être attentif aux personnes d'origines et de points de vue différents.
+* Accepter poliment les critiques constructives.
+* Se concentrer sur ce qui est le mieux pour la communauté.
+* Faire preuve de courtoisie et de professionnalisme envers les autres membres de la communauté.
+
+Les exemples de comportement inacceptable comprennent :
+
+* L'utilisation de langage ou d'images sexualisés et l'attention ou l'approche sexuelle de toute nature.
+* Les commentaires insultants ou désobligeants, et les attaques personnelles ou politiques (trolling).
+* Le harcèlement public ou privé.
+* La publication d'informations privées d'autrui, telles que des adresses physiques ou électroniques, sans permission explicite.
+* Toute autre conduite qui pourrait raisonnablement être considérée comme inappropriée dans un cadre professionnel.
+
+## Responsabilités d'Application
+
+Les responsables du projet (mainteneurs) ont la responsabilité d'interpréter les normes de comportement acceptable et de prendre des mesures correctives appropriées et justes en réponse à tout comportement qui ne respecte pas ce Code de Conduite.
+
+Les responsables du projet ont le droit et la responsabilité de supprimer, modifier ou rejeter les commentaires, commits, codes, modifications de wiki, problèmes (issues) et autres contributions qui ne sont pas alignés sur ce Code de Conduite, et de bannir temporairement ou définitivement tout contributeur pour d'autres comportements jugés inappropriés, menaçants, offensants ou nuisibles.
+
+## Application
+
+Les cas de comportement abusif, de harcèlement ou d'une autre manière inacceptable peuvent être signalés aux responsables du projet chargés de l'application à l'adresse suivante : **contact@aylabs.fr**
+
+Tous les responsables du projet sont tenus de respecter la confidentialité et la vie privée de la personne signalant un incident.
+
+### Lignes Directrices d'Application
+
+Les responsables du projet suivront ces lignes directrices d'impact communautaire pour déterminer les conséquences de toute action qu'ils jugent contraire à ce Code de Conduite :
+
+1.  **Correction :** Utilisation d'avertissements non publics écrits. Aucune conséquence immédiate, mais le responsable du projet peut demander l'arrêt du comportement.
+2.  **Avertissement :** Conséquences liées à une violation spécifique (ex: un blocage temporaire).
+3.  **Bannissement Temporaire :** Suspension temporaire de la participation à la communauté pour une durée spécifiée.
+4.  **Bannissement Permanent :** Exclusion définitive de toute participation au projet.
+
+## Attribution
+
+Ce Code de Conduite est adapté du [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, disponible à [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
+
+---

CONTRIBUTING.md

@@ -0,0 +1,104 @@
+# 🤝 Guide de Contribution à la Documentation AyLabs
+
+Bienvenue ! Nous sommes ravis que vous souhaitiez contribuer à la documentation Domotique & Homelab d'AyLabs. Notre projet est 100% communautaire et Open Source.
+
+Ce guide vous explique le processus à suivre pour soumettre vos modifications et articles.
+
+## 🌟 Principes de Contribution
+
+1.  **Respect et Bienveillance :** Toutes les contributions sont les bienvenues. Soyez respectueux envers les autres contributeurs et les modérateurs.
+2.  **Un Sujet = Une PR :** Pour faciliter la relecture et la validation, chaque Pull Request (PR) doit concerner un seul sujet (une correction, un nouvel article, ou une mise à jour d'un outil spécifique).
+3.  **Langue :** Toutes les documentations doivent être rédigées en **français**.
+
+---
+
+## 📝 Standards de Contenu et Règles Spécifiques
+
+Afin de maintenir la neutralité et la qualité du contenu, les règles suivantes s'appliquent à toutes les contributions :
+
+### Liens d'Affiliation
+
+| Type de Contribution | Règle d'Affiliation |
+| :--- | :--- |
+| **Création d'un article COMPLET** | **Autorisé.** Si vous rédigez un guide ou une revue complète et détaillée sur un produit/service, vous pouvez y apposer **votre propre lien affilié unique et clairement identifié comme tel** à la fin de l'article ou dans une section dédiée. |
+| **Modification/Correction mineure** | **Interdit.** L'ajout d'un lien affilié n'est pas permis pour de simples corrections, mises à jour ou modifications de contenu existant. |
+
+### Contenu Multimédia
+
+* Vous êtes autorisé à ajouter ou supprimer des **vidéos YouTube ou des liens vers des articles externes** si et seulement si leur contenu est **directement pertinent** et apporte une valeur ajoutée au sujet de l'article.
+
+### Éthique et Qualité
+
+* **Publicité Mensongère :** Il est strictement interdit d'insérer de la publicité mensongère, des informations trompeuses, ou de promouvoir des produits de manière déloyale.
+* **Respect du Travail Existant :** Toute modification ou réécriture doit être constructive. Il est interdit de dénigrer ou de discréditer le travail d'un précédent contributeur dans les articles de documentation ou dans les commentaires de PR.
+
+---
+
+## 🚀 Le Processus de Contribution (Fork & Pull Request)
+
+Notre workflow de contribution s'articule autour de **GitHub Flow** :
+
+### Étape 1 : Fork et Clonage
+
+Pour proposer des modifications, vous devez créer votre propre copie (un **fork**) du dépôt original.
+
+1.  **Forkez** le dépôt : Rendez-vous sur la page GitHub du projet (`AyLabsCode/docs`) et cliquez sur le bouton **"Fork"** en haut à droite.
+2.  **Clonez** votre fork en local sur votre machine. Remplacez `[VOTRE-NOM-UTILISATEUR]` par votre identifiant GitHub :
+
+    ```bash
+    git clone [https://github.com/](https://github.com/)[VOTRE-NOM-UTILISATEUR]/docs.git
+    cd docs
+    ```
+3.  **Créez une branche** pour vos modifications. Nommez la branche de manière descriptive (`fix/nom-article-corrigé` ou `feat/nouvel-article-mqtt`) :
+
+    ```bash
+    git checkout -b fix/mise-a-jour-zigbee2mqtt
+    ```
+
+### Étape 2 : Développement et Tests
+
+1.  **Modifiez les fichiers :** Rédigez ou modifiez le contenu dans le dossier `docs/`.
+2.  **Testez en local :** Il est crucial de vérifier que votre documentation s'affiche correctement avant de soumettre la PR.
+    ```bash
+    # Installer les dépendances si ce n'est pas déjà fait
+    yarn install
+    # Lancer le serveur de développement Docusaurus
+    yarn start
+    ```
+3.  **Committez vos changements :** Utilisez des messages de commit clairs et concis.
+    ```bash
+    git add .
+    git commit -m "fix: corriger l'étape 3 du guide Zigbee2MQTT"
+    ```
+
+### Étape 3 : Soumission de la Pull Request (PR)
+
+1.  **Poussez la branche** sur votre fork GitHub :
+    ```bash
+    git push origin fix/mise-a-jour-zigbee2mqtt
+    ```
+2.  **Ouvrez une Pull Request (PR) :** Sur la page GitHub de votre fork, cliquez sur **"Compare & pull request"**.
+    * Assurez-vous que vous demandez à fusionner de votre branche vers la branche `main` du dépôt AyLabsCode/docs.
+    * Décrivez clairement les objectifs de votre PR dans le champ de description.
+
+---
+
+## 🤖 Vérification par la CI/CD
+
+Une fois votre Pull Request soumise, un processus d'**Intégration Continue (CI)** s'exécute automatiquement.
+
+Ce système a pour rôle de :
+
+1.  **Vérifier la syntaxe :** S'assurer qu'il n'y a pas d'erreurs Docusaurus ou de Markdown.
+2.  **Construire le site :** Tenter de générer une version complète du site pour s'assurer qu'il n'y a pas de liens cassés ou d'erreurs de build.
+
+🚨 **Votre PR ne sera pas validée tant que les vérifications de la CI/CD ne sont pas au vert (✅).** Si la CI échoue, veuillez consulter les logs pour corriger le problème avant de repousser vos modifications.
+
+## ✅ Validation Finale
+
+Une fois que la CI/CD a réussi, les mainteneurs du dépôt AyLabs (Aymeric ou un modérateur) examineront votre code.
+
+* Si des changements mineurs sont nécessaires, un commentaire sera laissé sur la PR.
+* Si tout est conforme, votre contribution sera **fusionnée** (merged) dans la branche principale !
+
+Merci encore pour votre aide et votre soutien au projet AyLabs !

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) [Année de création] [Votre Nom/Nom de l'organisation (ex: AyLabs)]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,41 +1,84 @@
-# Website
+# 🏠 Docs AyLabs : Documentation Domotique & Homelab Communautaire
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+[![GitHub](https://img.shields.io/github/license/AyLabsCode/docs?style=for-the-badge)](./LICENSE)
+[![GitHub contributors](https://img.shields.io/github/contributors/AyLabsCode/docs?style=for-the-badge)](https://github.com/AyLabsCode/docs/graphs/contributors)
+[![Docusaurus V2](https://img.shields.io/badge/Made%20with-Docusaurus%20v2-blue?style=for-the-badge)](https://docusaurus.io/)
 
-## Installation
+Bienvenue sur le dépôt officiel des documentations **AyLabs** ! Ce site a pour vocation de devenir la ressource de référence, centralisée et communautaire, pour tous les passionnés de **Domotique** et de **Homelab**.
 
-```bash
-yarn
-```
+## 🎯 Objectifs du Projet
 
-## Local Development
+Notre but est de fournir des guides, des astuces et des configurations toujours à jour, grâce à l'effort collectif.
 
-```bash
-yarn start
-```
+* **Centralisation :** Regrouper toutes les connaissances de la chaîne AyLabs et de la communauté en un seul endroit facile d'accès.
+* **Open Source :** Chaque article, chaque tutoriel est modifiable. La transparence est notre mot d'ordre.
+* **Actualité Garantie :** Fini les guides obsolètes ! Le modèle communautaire garantit une mise à jour rapide lorsque les technologies évoluent.
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+---
 
-## Build
+## 🛠️ Comment Contribuer ? 
 
-```bash
-yarn build
-```
+Ces documentations vivent grâce à vous. Si vous détectez une erreur, si un outil a été mis à jour, ou si vous avez une meilleure méthode, votre contribution est essentielle !
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+### 1. 🐛 Signaler un Problème
 
-## Deployment
+Si vous trouvez une erreur, un lien cassé, ou une information manquante, veuillez ouvrir une [Issue GitHub](https://github.com/AyLabs/docs-repo/issues/new/choose) pour le signaler.
 
-Using SSH:
+### 2. ✍️ Proposer une Modification (Pull Request)
 
-```bash
-USE_SSH=true yarn deploy
-```
+Vous souhaitez ajouter un nouveau guide ou corriger/améliorer un article existant ? Suivez ces étapes simples :
 
-Not using SSH:
+1.  **Forkez** ce dépôt.
+2.  Clonez votre fork en local.
+3.  Créez une nouvelle branche pour votre modification : `git checkout -b ma-super-contribution`.
+4.  Effectuez vos modifications (les fichiers de documentation se trouvent principalement dans le dossier `docs/`).
+5.  **Testez en local** (voir la section ci-dessous).
+6.  Commitez vos changements et pushez-les sur votre fork.
+7.  Ouvrez une **Pull Request** vers la branche `main` de ce dépôt.
 
-```bash
-GIT_USER=<Your GitHub username> yarn deploy
-```
+Nous examinerons votre proposition dans les plus brefs délais !
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+---
+
+## 🧑‍💻 Démarrer le Projet en Local
+
+Pour visualiser la documentation ou tester vos contributions avant de soumettre une PR, vous pouvez lancer le site Docusaurus en local.
+
+### Prérequis
+
+* Node.js (version 18 ou supérieure recommandée)
+* Yarn ou npm
+
+### Installation et Lancement
+
+1.  **Cloner le dépôt :**
+    ```bash
+    git clone https://github.com/AyLabsCode/docs
+    cd docs
+    ```
+
+2.  **Installer les dépendances :**
+    ```bash
+    yarn install
+    # ou
+    npm install
+    ```
+
+3.  **Lancer le serveur de développement :**
+    ```bash
+    yarn start
+    # ou
+    npm start
+    ```
+
+Le site sera accessible à l'adresse `http://localhost:3000`. Toute modification des fichiers sources (dans `docs/` ou `src/`) sera automatiquement rechargée.
+
+---
+
+## 📄 Licence
+
+Ce projet est distribué sous licence **MIT**. Voir le fichier [LICENSE](./LICENSE) pour plus d'informations.
+
+---
+
+**Un grand merci à tous les contributeurs qui font vivre cette documentation !**

docs/domotique/home-assistant/advanced/_category_.json

@@ -1,8 +1,8 @@
 {
-  "label": "⚙️ Configuration avancée",
-  "position": 3,
+  "label": "Avancé",
+  "position": 4,
   "link": {
     "type": "generated-index",
     "description": "Une fois Home Assistant installé, c'est parti pour la configuration !"
   }
-}
+}

docs/domotique/home-assistant/advanced/automations.md

@@ -0,0 +1,27 @@
+---
+sidebar_position: 2
+---
+
+import YouTube from '@site/src/components/YouTube';
+
+# Automatisations
+Les automatisations dans Home Assistant vous permettent de créer des scénarios personnalisés pour automatiser le comportement de vos appareils connectés. Voici comment les configurer et les optimiser. 🤖
+
+C'est grâce aux automatisations que vous pourrez relier des appareils qui normalement ne communiquent pas ensemble, ou encore créer des scénarios avancés en fonction de conditions spécifiques (heure, état d'un capteur, etc.).  
+Voici des idées d'automatisations courantes, possibles lorsque vous maîtrisez bien le concept :
+- Allumer les lumières du salon lorsque vous arrivez à la maison après le coucher du soleil ☀️
+- Envoyer une notification lorsque la porte d'entrée est ouverte entre 22h et 6h 📲
+- Régler le thermostat en fonction de la météo extérieure 🌡️
+- Activer une scène d'éclairage spécifique lorsque vous lancez votre film préféré 🎬
+
+## Créer une automatisation simple 🤖
+<YouTube videoId="gbyNcv_Tl6A" />
+
+Le système d'automatisations intégré de Home Assistant est très puissant et permet de créer des automatisations simples en quelques clics.
+
+## Node-RED ⚙️
+<YouTube videoId="d1s9VAD1ClM" />
+
+Node-RED est une plateforme de programmation visuelle qui permet de créer des automatisations complexes dans Home Assistant à l'aide d'une interface graphique.  
+Il est particulièrement utile pour les utilisateurs avancés qui souhaitent aller au-delà des capacités d'automatisation intégrées de Home Assistant.  
+Gardez à l'esprit que l'installation et la configuration de Node-RED peuvent nécessiter des connaissances techniques supplémentaires.

docs/domotique/home-assistant/advanced/dashboards.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 1
+---
+
+import YouTube from '@site/src/components/YouTube';
+
+# Dashboards
+Les tableaux de bord dans Home Assistant vous permettent de visualiser et de contrôler vos appareils connectés
+et automatisations de manière personnalisée. Voici comment les configurer et les optimiser. 📊
+
+## Création d'un dashboard complet 🎨
+J'avais fait une vidéo complète sur la création d'un dashboard personnalisé dans Home Assistant. 
+[Cet article](https://aylabs.fr/video/mon-dashboard-sur-home-assistant) détaillait les étapes principales, mais pour une compréhension approfondie, je vous recommande de regarder la vidéo ci-dessous
+
+<YouTube videoId="GBd8ngtlAbA" />
+
+## Génération d'un dashboard automatique ⚡
+Pour ceux qui préfèrent une approche plus rapide, Home Assistant propose une fonctionnalité de génération automatique de dashboards basée sur vos appareils et entités existants.  
+Il est également possible de générer un dashboard avec [Linus Dashboard](https://github.com/Thank-you-Linus/Linus-Dashboard), une solution française qui permet de générer vos dashboards automatiquement avec un rendu très propre.
+<YouTube videoId="T5vjP3gI1Zw" />
+
+## Ressources supplémentaires
+- [📹 Vidéo par Zatoufly (Août 2024)](https://www.youtube.com/watch?v=Xbdju2eLy20)
+- [📹 Vidéo par Howmation (Avril 2024)](https://www.youtube.com/watch?v=h-ikQ8G6YWk)
+- [📹 Vidéo par DomoTech (Juillet 2023)](https://www.youtube.com/watch?v=-ApdURkkVFU)

docs/domotique/home-assistant/advanced/gestion-des-poubelles.md

@@ -0,0 +1,10 @@
+---
+sidebar_position: 5
+---
+
+import YouTube from '@site/src/components/YouTube';
+
+# Gestion des tâches ménagères 
+La gestion des poubelles et du tri des déchets peut être facilitée grâce à Home Assistant. Voici quelques idées pour automatiser et organiser cette tâche ménagère essentielle. 🗑️
+
+<YouTube videoId="UQ9OAEBx6Ho" />