# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

HANDLER-NAME
============
haushalt

BESCHREIBUNG
============
Haushaltsmanagement mit Routinen, Inventar, Einkaufslisten und Kostenplanung.
Verwaltet tägliche Aufgaben, Vorratsverwaltung mit Ampel-System (rot/gelb/gruen),
Lieferanten und Fixkosten. Integration mit Routine Handler und BACH Unified Database.


OPERATIONEN
===========

status
  Haushalts-Dashboard: Routinen-Überblick, Inventar-Ampel, monatliche Fixkosten,
  Einkaufsliste, oberfällige Routinen. Kombination aller Subsysteme.
  Syntax: bach haushalt status

due [TAGE]
  Faellige Aufgaben in den kommenden N Tagen (Standard: 7 Tage).
  Trennt überfällige (ROT) von anstehenden (GELB) Routinen.
  Syntax: bach haushalt due | bach haushalt due 14

today
  Tages-Übersicht: Was steht heute an? (Routinen + Termine).
  Ladet DailyOverview Service.
  Syntax: bach haushalt today

week
  Wochenplan (Mo-So): Routinen + Termine mit Zeitangabe.
  Markiert Überfallige in der aktuellen Woche.
  Syntax: bach haushalt week

costs
  Monatliche Fixkosten-Übersicht.
  Berechnet monatliche Lasten aus Verträgen (fin_contracts):
  - monatlich: direkt
  - jaehrlich: /12
  - quartalsweise: /3
  Syntax: bach haushalt costs

kosten-monat [FILTER]
  Erwartete irregulaere Kosten pro Monat (Versicherungen, Wartungen).
  Optional: Filter nach Kategorie.
  Syntax: bach haushalt kosten-monat | bach haushalt kosten-monat "auto"

add-kosten NAME KATEGORIE BETRAG INTERVALL
  Irregulare Kosten hinzufügen.
  INTERVALL: monatlich|quartalsweise|jaehrlich|einmalig
  Syntax: bach haushalt add-kosten "TÜV" "auto" 150 "jaehrlich"

kosten-list [FILTER]
  Alle Kosten-Einträge anzeigen mit Status.
  Syntax: bach haushalt kosten-list

insurance-check
  Versicherungs-Check: Alle aktiven Policen mit Beitraegen.
  Ladet fin_insurances, berechnet monatliche Summe.
  Syntax: bach haushalt insurance-check

shopping
  Einkaufsliste: Alle noch zu kaufenden Artikel mit Priorität.
  Syntax: bach haushalt shopping

add-shopping NAME [KATEGORIE] [PRIORITAET]
  Artikel zur Einkaufsliste hinzufügen.
  PRIORITAET: normal|hoch|niedrig (Standard: normal)
  Syntax: bach haushalt add-shopping "Milch" "Lebensmittel" "hoch"

done-shopping ID [ID2 ID3...]
  Artikel als gekauft markieren.
  Syntax: bach haushalt done-shopping 5 6 7

inventory
  Vorratsbestand mit Ampel-Übersicht (rot/gelb/gruen).
  Benutzt InventoryEngine mit Lagerschwellen.
  Syntax: bach haushalt inventory

add-item NAME KATEGORIE LAGERSCHWELLE [LAGERMAX]
  Artikel zum Inventar hinzufügen.
  LAGERSCHWELLE: Wert, bei dem rot angezeigt wird.
  Syntax: bach haushalt add-item "Olivenoel" "Kochen" 0.5 2

stock-in ITEM-NAME MENGE [DATUM]
  Wareneingang buchen (Zu Lager). Erstellt Transaktion.
  Syntax: bach haushalt stock-in "Olivenoel" 1.5 2026-03-04

stock-out ITEM-NAME MENGE [DATUM]
  Verbrauch buchen (Aus Lager). Erstellt Transaktion.
  Syntax: bach haushalt stock-out "Olivenoel" 0.3 2026-03-04

pull-check
  Einkaufs-Pull-Liste: Welche Artikel muessen gekauft werden?
  Zeigt ROT (unter Schwelle) und GELB (unter Max) Artikel.
  Syntax: bach haushalt pull-check

ampel
  Ampel-Übersicht: Alle Inventar-Artikel mit Status (ROT/GELB/GRUEN).
  Syntax: bach haushalt ampel

order [ARTIKEL] [MENGE]
  Order für Artikel anlegen oder ausstehende Orders anzeigen.
  Syntax: bach haushalt order | bach haushalt order "Olivenoel" 5

supplier
  Lieferanten anzeigen mit Kontakt und verfügbaren Artikeln.
  Syntax: bach haushalt supplier

add-supplier NAME KONTAKT [VERSANDTAGE]
  Lieferant hinzufügen.
  VERSANDTAGE: Durchschnittliche Lieferzeit (Standard: 5).
  Syntax: bach haushalt add-supplier "BioGro GmbH" "info@biogro.de" 3

export-routine [FILTER]
  Routinen exportieren für externe Nutzung/Backup.
  Optional: Filter nach Kategorie.
  Syntax: bach haushalt export-routine | bach haushalt export-routine "Kueche"

help
  Diese Hilfe anzeigen.
  Syntax: bach haushalt help


BEISPIELE
=========

1. Dashboard anzeigen:
   bach haushalt status

2. Überfällige Routinen für diese Woche:
   bach haushalt due 7

3. Wochenplan mit Routinen + Terminen:
   bach haushalt week

4. Artikel zur Einkaufsliste hinzufügen:
   bach haushalt add-shopping "Mehl" "Lebensmittel" "normal"

5. Wareneingang buchen:
   bach haushalt stock-in "Mehl" 2.5

6. Einkaufs-Pull-Liste (Was fehlt?):
   bach haushalt pull-check

7. Monatliche Fixkosten:
   bach haushalt costs

8. Irregulare Kosten hinzufügen:
   bach haushalt add-kosten "KFZ-Versicherung" "auto" 80 "monatlich"


DATEIEN
=======
hub/haushalt.py                      Haupthandler
hub/_services/household/             Household Services
  inventory_engine.py                Inventar + Ampel-Logik
  shopping_service.py                Einkaufslisten-Verwaltung
hub/_services/dashboard/
  daily_overview.py                  Tages-Übersicht


DATENBANK-TABELLEN
===================
bach.db / Unified Database (seit v1.1.84):
- household_routines              Tägliche Aufgaben/Routine-Verwaltung
- household_inventory             Artikel mit Schwellen
- household_orders                Bestellungen an Lieferanten
- household_suppliers             Lieferanten-Kontakte
- household_stock_transactions    Ein/Ausbuchungen (Audit Log)
- household_shopping              Einkaufslisten
- household_costs                 Irregulaere Kosten
- assistant_calendar              Termine (für Wochenplan)
- fin_contracts                   Verträge (für Fixkosten)
- fin_insurances                  Versicherungen (für Status-Dashboard)


SIEHE AUCH
==========
bach routine ...                  Routine-Verwaltung (Einzelzustaende)
bach routine done <id>            Routine als erledigt markieren
bach fin costs                    Finanz-Kostenmanagement
bach calendar ...                 Termin-Verwaltung
