Souvenirs et Célébrations

Souvenirs et Célébrations (date_countdown) est une intégration personnalisée pour Home Assistant qui permet de suivre les jours restants avant des événements personnels : anniversaires, anniversaires de mariage, promotions, mémoriaux ou événements spéciaux.

Entièrement configurable via l’interface graphique, aucun YAML requis. Les capteurs sont automatiquement créés pour vos dashboards Lovelace, automatisations, notifications ou alertes.

---

✨ Fonctionnalités

• ✅ Interface graphique pour ajouter, modifier ou supprimer des événements
• 📅 Types d’événements :
  • 🎂 Anniversaire
  • 💍 Anniversaire de mariage (avec intitulés des noces)
  • 🕯️ Mémorial (âge qu’aurait eu la personne, années depuis le décès)
  • 🏆 Promotion
  • 🌟 Événement spécial
• ⚙️ Capteurs automatiques :
  • État = nombre de jours restants
  • Attributs : type, date, prénom, années, intitulé des noces, etc.
• 🎨 Icônes dynamiques selon le type
• 🇫🇷 Interface et traduction en français
• 🔔 Prêt pour Lovelace, automatisations, TTS, notifications

---

🧱 Prérequis

• Home Assistant >= 2024.6.0
• HACS installé

---

⚙️ Installation via HACS

1. Ouvrez HACS > Intégrations
2. Cliquez sur ⋮ > Dépôt personnalisé
3. Ajoutez ce dépôt :

   https://github.com/XAV59213/date_countdown
   

   Type : Intégration
4. Installez Souvenirs et Célébrations
5. Redémarrez Home Assistant
6. Allez dans Paramètres > Appareils & Services > Ajouter une intégration
7. Recherchez Souvenirs et Célébrations ou Date Countdown

---

🔧 Configuration

➕ Ajouter un événement

• Type : sélectionnez parmi les 5 types disponibles
• Nom (obligatoire), Prénom (optionnel)
• Date : JJ/MM/AAAA
• Pour les mémoriaux : date de décès (optionnelle)

🔁 Modifier ou supprimer

• Dans l’intégration : ⋮ > Options
• Choisissez l’action souhaitée : ajouter, modifier ou supprimer un événement

---

🐞 Capteurs générés

Format :

sensor.<type>_<nom>_<date>

Exemple :

sensor.memorial_jean_01011950:
  state: 15
  attributes:
    friendly_name: "Jean - Mémorial"
    first_name: "Jean"
    event_type: "memorial"
    event_date: "01/01/1950"
    years: 76
    death_date: "15/06/2000"
    age_if_alive: 75
    years_since_death: 25

---

🖼️ Exemple Lovelace (mémoriaux à venir)

type: markdown
content: |
  ## 🕯️ Mémoriaux à venir
  {% set ns = namespace(events=[]) %}
  {% for entity in states.sensor if entity.entity_id.endswith('memorial') %}
    {% if (entity.state | int(0)) > 0 %}
      {% set ns.events = ns.events + [entity] %}
    {% endif %}
  {% endfor %}
  {% for e in ns.events | sort(attribute='state') | slice(2) %}
  - **{{ state_attr(e.entity_id, 'friendly_name') }}** : {{ e.state }} jours
    - Âge au prochain anniversaire : {{ state_attr(e.entity_id, 'years') }} ans
    - Âge s’il était en vie : {{ state_attr(e.entity_id, 'age_if_alive') }}
    {% if state_attr(e.entity_id, 'death_date') %}
    - Décès : {{ state_attr(e.entity_id, 'death_date') }} ({{ state_attr(e.entity_id, 'years_since_death') }} ans)
    {% endif %}
  {% endfor %}

---

🔔 Exemple d’automatisation

automation:
  - alias: "Rappel mémorial 7 jours avant"
    trigger:
      platform: numeric_state
      entity_id: sensor.memorial_jean_01011950
      value: 7
    action:
      service: notify.notify
      data:
        message: >
          📅 Dans 7 jours : anniversaire de {{ state_attr('sensor.memorial_jean_01011950', 'friendly_name') }}.
          Âge s’il était en vie : {{ state_attr('sensor.memorial_jean_01011950', 'age_if_alive') }} ans.

---

🛠️ Dépannage

Les capteurs n’apparaissent pas ?

• Vérifiez que les dates sont bien au format JJ/MM/AAAA
• Redémarrez Home Assistant après ajout ou suppression d’événements

Problème avec les mémoriaux ?

• death_date : format JJ/MM/AAAA
• Vérifiez les attributs dans Développeur > États

Activer les logs de debug

logger:
  default: info
  logs:
    custom_components.date_countdown: debug

---

📁 Structure technique

Fichier	Rôle
__init__.py	Initialisation du composant
config_flow.py	Flux de configuration UI
sensor.py	Création et mise à jour des capteurs
const.py	Types, formats, intitulés, noces
translations/fr.json	Traduction en français
manifest.json	Métadonnées HACS
brand/icon.png	Icône HACS (512×512)
brand/logo.png	Logo

---

👨‍💻 Crédits

• Auteur : @XAV59213
• Licence : MIT
• Dépôt : https://github.com/XAV59213/date_countdown

---

📢 Support

💬 Pour toute question, bug ou suggestion : ➡️ Créer une issue sur GitHub