odin/hellth-hub
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
hellth-hub/docs/projekt.md
Sebastian Mayer 2436dd9cac Initial commit: Hellth Hub monorepo 
Mobile-first Web-App fuer persoenliches Health-, Ernaehrungs-,
Aktivitaets- und Einkaufs-Tracking im Home-Lab-Betrieb.

Stack: pnpm Monorepo - Next.js 16 + React 19 + Tailwind (apps/admin) -
Hono + tRPC + Better Auth mit 2FA und Passkeys (packages/api) -
PostgreSQL + Drizzle ORM (packages/db) - Docker fuer Postgres und pgAdmin.

Module:
- Auth mit Login, 2FA (TOTP + Backup-Codes), Passkeys und Admin-Recovery
- Tagesansicht mit Essen, Trinken, Gewicht, Aktivitaeten und Coach-Hinweisen
- Lebensmittelkatalog mit Naehrwerten, Portionen, OCR/Barcode/Open Food Facts
- Rezepte mit Live-Naehrwertberechnung und Community-Vorschlaegen
- Essensplanung und Wochenbudget mit Sportbonus
- Einkaufslisten mit Maerkten und Laufweg-Sortierung
- Hellfireclub mit Aktivitaetspunkten und gemeinsamer Aktivitaetsplanung
- Wearables-Vorbereitung (Fitbit / Google Fit / Health Connect)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 22:15:16 +02:00

1.5 KiB
Raw Blame History

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.