# Home Assistant Dashboard - Complete Implementation Guide

## Phase 1: Required Add-ons Installation

### 1.1 Install HACS (if not installed)

**Method A - Via Home Assistant UI:**
1. Go to **Settings** → **Add-ons**
2. Click **ADD-ON STORE** (bottom right)
3. Search for **"HACS"** or use: https://my.home-assistant.io/redirect/hacs
4. Install and start HACS
5. Complete GitHub authorization

**Method B - Via SSH (alternative):**
```bash
wget -q -O /config/custom_components.zip https://github.com/hacs/integration/releases/latest/download/hacs.zip
unzip -o /config/custom_components.zip -d /config/
rm /config/custom_components.zip
# Restart Home Assistant
```

---

### 1.2 Install Recommended Add-ons via HACS

Open HACS → Frontend →搜索并安装:

| Add-on | Version | Purpose |
|-------|---------|---------|
| **Mushroom** | Latest | Beautiful card templates |
| **button-card** | Latest | Customizable buttons |
| **card-mod** | Latest | CSS styling |
| **layout-card** | Latest | Advanced grids |
| **mini-graph-card** | Latest | Sparkline graphs |

After installation:
1. **Settings** → **System** → **Restart Home Assistant**
2. Clear browser cache (Ctrl+Shift+R)

---

## Phase 2: Area Configuration

### 2.1 Create Areas (via UI)

Go to **Settings** → **Areas & Zones** → **Add Area**:

| Area Name | Icon | Entities to Add |
|----------|------|-----------------|
| **Wohnzimmer** | sofa | lights, covers, media_player |
| **Schlafzimmer** | bed | lights, climate |
| **Küche** | kitchen | dishwasher, todo |
| **Badezimmer** | shower | lights, washer |
| **Technikraum** | server | server, sensors |
| **Arbeitszimmer** | desk | pc, printer |

---

## Phase 3: Device Naming Guide

### Recommended Renames (Entity ID → Friendly Name)

| Current | Rename To | Area |
|---------|----------|------|
| `light.wohnzimmerlichter` | Wohnzimmer Decke | Wohnzimmer |
| `light.led_streifen` | TV Hintergrund | Wohnzimmer |
| `light.innr_fl_120_c_licht` | Wohnzimmer Tischlampe | Wohnzimmer |
| `cover.rollos` | Wohnzimmer Rollos | Wohnzimmer |
| `cover.lumi_lumi_curtain_acn002` | Fenster Rollos | Wohnzimmer |
| `media_player.tagesprophet` | Wohnzimmer Sonos | Wohnzimmer |
| `switch.tv_anlage_steckdose` | TV Strom | Wohnzimmer |
| `light.leselampe` | Leselampe | Schlafzimmer |
| `light.whisky_lampe` | Nachttischlampe | Schlafzimmer |
| `switch.dobby_einschalter` | Geschirrspüler | Küche |
| `switch.dobby_extra_trocken` | Spüler Extra Trocken | Küche |
| `switch.dobby_halbe_beladung` | Spüler Halbe Ladung | Küche |
| `switch.dobby_hygiene` | Spüler Hygiene+ | Küche |
| `light.spiegellicht` | Spiegellicht | Badezimmer |
| `switch.waschmaschine_steckdose` | Waschmaschine | Badezimmer |
| `sensor.waschmaschine_steckdose_leistung` | Waschmaschine Leistung | Badezimmer |
| `switch.server` | Server | Technikraum |
| `switch.3d_drucker_steckdose` | 3D-Drucker | Technikraum |
| `switch.pc_setup_steckdose` | PC Strom | Arbeitszimmer |
| `sensor.pc_setup_leistung` | PC Leistung | Arbeitszimmer |
| `sensor.brother_mfc_l2750dw_series` | Drucker | Arbeitszimmer |
| `sensor.niles_*` | Niles (various) | Wohnzimmer |
| `vacuum.niles` | Saugroboter | Wohnzimmer |

---

## Phase 4: Label Configuration

Create labels in **Settings** → **Labels**:

| Label | Color | Entities |
|-------|-------|----------|
| **Energy** | Yellow | power sensors |
| **Climate** | Blue | temp/humidity |
| **Media** | Purple | media players |
| **Power** | Red | switches |
| **Appliances** | Green | washer/dishwasher |
| **Vacuum** | Orange | vacuum |

---

## Phase 5: Dashboard YAML

### Complete Dashboard Configuration

Copy the following to your `dashboards/uebersicht.yaml` or create via UI:

```yaml
title: Übersicht
theme: minimal-light
icon: mdi:home-variant
views:
  # === MAIN VIEW ===
  - title: Übersicht
    icon: mdi:home-variant
    cards:
      # Header Row - Weather, Time, Quick Actions
      - type: custom:mushroom-chips-card
        chips:
          - type: weather
            entity: weather.forecast_home
          - type: template
            icon: mdi:clock-outline
            value: "{{ now().strftime('%H:%M') }}"
          - type: template
            icon: mdi:thermometer
            value: "{{ states('sensor.thermometer_temperatur') }}°C"
          - type: template
            icon: mdi:account-group
            value: "{{ states('zone.home') | int }} zu Hause"
            entity: zone.home

      # Row 1: Main Room Cards
      - type: grid
        columns: 2
        cards:
          # Wohnzimmer Card
          - type: custom:mushroom-entity-card
            entity: light.wohnzimmerlichter
            name: Wohnzimmer
            icon: mdi:sofa
            tap_action:
              action: navigate
              navigation_path: /wiewohnzimmer
            features:
              - type: light-brightness

          # Küche Card
          - type: custom:mushroom-entity-card
            entity: todo.einkaufsliste_2
            name: Küche
            icon: mdi:kitchen
            tap_action:
              action: navigate
              navigation_path: /view/kueche

      # Row 2: Climate & Appliances
      - type: grid
        columns: 2
        cards:
          # Climate Card
          - type: custom:mushroom-climate-card
            entity: sensor.thermometer_temperatur
            name: Innenraum
            icon: mdi:thermometer
            show_temperature_control: false

          # Waschmaschine
          - type: custom:mushroom-entity-card
            entity: switch.waschmaschine_steckdose
            name: Waschmaschine
            icon: mdi:washing-machine
            tap_action:
              action: toggle
            attributes:
              power: sensor.waschmaschine_steckdose_leistung

          # Geschirrspüler
          - type: custom:mushroom-entity-card
            entity: switch.dobby_einschalter
            name: Geschirrspüler
            icon: mdi:dishwasher
            tap_action:
              action: toggle
            attributes:
              state: sensor.dobby_betriebszustand

          # Saugroboter
          - type: custom:mushroom-vacuum-card
            entity: vacuum.niles
            name: Niles
            icon: mdi:robot-vacuum

      # Row 3: Energy Monitoring
      - type: custom:mini-graph-card
        entities:
          - sensor.pc_setup_leistung
          - sensor.tv_anlage_leistung
          - sensor.waschmaschine_steckdose_leistung
        name: Aktueller Verbrauch
        hours_to_show: 24
        update_interval: 30

      # Row 4: System Status
      - type: grid
        columns: 3
        cards:
          # Backup Status
          - type: custom:mushroom-entity-card
            entity: event.backup_automatiches_backup
            name: Backup
            icon: mdi:backup-restore

          # Printer
          - type: custom:mushroom-entity-card
            entity: sensor.brother_mfc_l2750dw_series
            name: Drucker
            icon: mdi:printer

          # Server
          - type: custom:mushroom-entity-card
            entity: switch.server
            name: Server
            icon: mdi:server

  # === ENERGY VIEW ===
  - title: Energie
    icon: mdi:flash
    cards:
      - type: grid
        columns: 2
        cards:
          - type: gauge
            name: Aktueller Verbrauch
            entity: sensor.all_standby_power
            min: 0
            max: 500
            unit: W

          - type: statistic
            name: Heute (kWh)
            entity: sensor.pc_setup_energie_kwh
            stat_type: change
            period: day

          - type: history-graph
            entities:
              - sensor.pc_setup_leistung
              - sensor.tv_anlage_leistung
              - sensor.waschmaschine_steckdose_leistung
            name: Verbrauch Over Time

  # === SYSTEM VIEW ===
  - title: System
    icon: mdi:cog
    cards:
      - type: grid
        columns: 2
        cards:
          - type: entity
            entity: sensor.backup_nachstes_geplantes_automatiches_backup
            name: Nächster Backup

          - type: entity
            entity: sensor.backup_letztes_erfolgreiches_automatiches_backup
            name: Letzter Backup

          - type: entity
            entity: update.home_assistant_core_update
            name: HA Update

          - type: entities
            name: WLAN Status
            entities:
              - binary_sensor.archer_ax55_wan_status
              - sensor.archer_ax55_download_geschwindigkeit
              - sensor.archer_ax55_upload_geschwindigkeit