# Task Wheel of Fortune

> Open-Source-Integration für Home Assistant (Aufgaben-Glücksrad): verteilt Haushaltsaufgaben fair per Auslosung mit acht Animationen, berücksichtigt Abwesenheiten und Belastbarkeit, mit Zeitplänen, Verlauf und Statistik. Installierbar über HACS.

Wer saugt heute das Wohnzimmer? Das Glücksrad entscheidet: fair, mit Spaß und direkt in Home Assistant. Wer zuletzt weniger getan hat oder mehr leisten kann, bekommt die größere Chance.

## Eckdaten

- Lizenz: MIT
- Installation: HACS
- Home Assistant: ab 2025.6
- Sprachen: DE · EN
- Version: 0.4.0
- Quellcode: https://github.com/stacknoise/hass-task-wheel-of-fortune

## Funktionen

Aufgaben fair verteilen, ohne Streit.

### Fair nach Belastung

Wer im betrachteten Zeitraum weniger Punkte hatte, als ihm zusteht, bekommt eine größere Chance. Der faire Anteil richtet sich nach Belastbarkeit (voll, halb, pausiert) und den Tagen, an denen die Person da ist.

### Acht Animationen

Glücksrad, Lostrommel, Slot-Machine, Plinko, Scheinwerfer, Rubbellose, Eilmeldung und Oscar-Verleihung. Bei den ersten fünf entspricht die Größe der Chance; die übrigen zeigen bewusst keine Chancen. Je Zeitplan wählen Sie die erlaubten Varianten, bei mehreren wird jedes Mal zufällig eine gewählt.

Tags: Plinko, Rubbellose

### Personen und Abwesenheiten

Personen sind eigene Objekte, unabhängig von Home-Assistant-Benutzern, mit Farbe, Belastbarkeit und optionaler Benachrichtigung. Abwesenheiten gelten einmalig, an festen Wochentagen, im Wochenrhythmus oder wiederkehrend, etwa „jeden zweiten Mittwoch“.

### Aufgaben mit Regeln

Erlaubte Personen, Punkte als Aufwand, Frist und Häufigkeit: jede Runde, höchstens n× pro Zeitraum oder ein fester Intervall mit Toleranz. Dazu eine Mindest-Belastbarkeit und optional ein Raum aus Home Assistant.

### Zeitpläne

Wiederkehrend, einmalig oder nur manuell, mit Erinnerung, wenn zu lange nicht ausgelost wurde. Ausgelost wird automatisch oder im Panel mit Animation; jede Person bekommt höchstens eine Aufgabe pro Runde.

### Tauschen mit Joker

Aufgaben lassen sich innerhalb einer Auslosung mit Personen tauschen, die sie übernehmen dürfen. „Bleibt unerledigt“ gibt es auch: zählt in Punkten und Statistik wie versäumt.

### Verlauf und Statistik

Jede Auslosung im Verlauf mit CSV-Export. Die Statistik zeigt fairen Anteil, Erledigungsquote, die Matrix Aufgabe × Person und die Auslosungen je Aufgabe gegen das Soll.

Tags: CSV

### Tief in Home Assistant

Dienste (task_wheel.draw, complete, swap, set_absence), Ereignisse für Automationen, Sensoren für offene Aufgaben und Punkte, eine To-do-Liste je Person (Abhaken erledigt die Aufgabe) und ein Knopf je Zeitplan. Push-Nachrichten gehen über jedes notify-Ziel.

Tags: Automationen

## Auslosung

Acht Arten, wer dran ist.

- Glücksrad
- Lostrommel
- Slot-Machine
- Plinko
- Scheinwerfer
- Rubbellose: selbst rubbeln, bis „Gewonnen!“ erscheint
- Eilmeldung
- Oscar-Verleihung: „Und die Aufgabe geht an …“

## Ansichten

Alles im Seitenmenü von Home Assistant.

Übersicht, Aufgaben, Zeitpläne, Verlauf und Statistik, am Tablet und Smartphone genauso bedienbar wie am Rechner.

- Aufgabe bearbeiten: Personen, Punkte, Frist, Häufigkeit und Regeln
- Zeitplan mit Wochentagen, Aufgaben und Animationen
- Verlauf aller Auslosungen
- Statistik: fairer Anteil, Erledigungsquote, Aufgabe × Person

## Installation

In vier Schritten eingerichtet.

[In HACS öffnen ↗](https://my.home-assistant.io/redirect/hacs_repository/?owner=stacknoise&repository=hass-task-wheel-of-fortune&category=integration)

1. In HACS das Menü (⋮) → Benutzerdefinierte Repositories öffnen, `https://github.com/stacknoise/hass-task-wheel-of-fortune` mit Typ Integration hinzufügen, oder den Button oben nutzen.
2. „Task Wheel of Fortune“ in HACS herunterladen und Home Assistant neu starten.
3. Einstellungen → Geräte & Dienste → Integration hinzufügen → Task Wheel of Fortune.
4. Im Seitenmenü „Aufgaben-Glücksrad“ öffnen, Personen, Aufgaben und Zeitpläne anlegen und die erste Runde starten.

Beispiel (YAML):

```yaml
action: task_wheel.draw
data:
  schedule: weekly-plan
```

Die Integration steht noch nicht in der HACS-Standardliste und wird als benutzerdefiniertes Repository installiert. Alle Dienste, Ereignisse und Entitäten stehen im README auf GitHub.

## Kontakt

- Entwickler: Anton Graichen-Hartl, Stacknoise (https://www.stacknoise.com/)
- E-Mail: anton.hartl@stacknoise.com
- GitHub: https://github.com/stacknoise
- Webseite: https://www.stacknoise.com/task-wheel/
- English version: https://www.stacknoise.com/en/task-wheel.md