# Hellth Hub - Projektbeschreibung

Hellth Hub ist eine mobile-first Web-App für persönliches Health- und Ernährungstracking im Home-Lab. Die Anwendung nutzt das stabile Grundgerüst aus Admin-UI, Auth, 2FA, Benutzerverwaltung, API, Datenbank und Docker, ist fachlich aber vollständig auf Ernährung, Ziele, Aktivität und Alltagstauglichkeit ausgerichtet.

## Kernbereiche

- Tagesansicht: Mahlzeiten, Getränke, Gewicht, Aktivitäten, Ziele und Coach-Hinweise.
- Lebensmittel: eigener Katalog mit Nährwerten pro 100 g, Portionen, Favoriten, Barcode-/OCR-Vorbereitung.
- Rezepte: Zutaten aus Lebensmitteln, flexible Einheiten, Portionen, Bewertungen und Meal-Prep.
- Planung: Tages- und Wochenplanung mit Mahlzeiten und Zukunftslogik.
- Wochenbudget: flexible Kalorienplanung inklusive Sportbonus.
- Einkauf: automatische Einkaufslisten nach Markt, Abteilung und Laufweg.
- Ziele und Onboarding: persönliche Zielableitung pro Benutzer.
- Motivation: Erinnerungen, Aktivitätspunkte und Hellfireclub-Aktivitäten.
- Wearables: vorbereitete Struktur für Fitbit/Google-Fit-Importe.

## Architektur

- `apps/admin`: Next.js Admin- und App-Frontend.
- `packages/api`: Hono, Better Auth und tRPC.
- `packages/db`: Drizzle-Schema und Migrationen.
- `docker`: PostgreSQL und pgAdmin für lokale/Home-Lab-Setups.

## Prinzipien

- Motivierend statt strafend.
- Benutzerbezogene Einstellungen statt globale Health-Defaults.
- Alltagseinheiten vor perfekter Laborpräzision.
- Erweiterbar für Wearables, OCR, Barcode, Preisvergleich und Offline-Einkaufsmodus.