Self-hosted Next.js 14 family app with: - Kids board with star/reward system and toilet training - Tasks & chores with approval workflow - Calendar with iCal subscriptions - Meal planning, recipes with URL import - Shopping lists, meal wishes - Multi-profile with PIN protection - JSON file backend, SSE live-sync, PWA https://flessinglabs.com Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
Familytool – Architektur
Überblick
Familytool besteht aus zwei getrennten Verzeichnissen/Diensten:
/var/www/html/familytool(dieses Repo) — Next.js 14 App (Server-Mode, Port 3030), eigenes JSON-Datei-Backend (data/db.json) übersrc/app/api/*-Routen. Enthält das gesamte Frontend, alle Community-Module sowie das Lizenz-/Feature-Gate-System./opt/familytool-api(separates Repo, NICHT Teil dieses Repos) — Express + MySQL-Backend (Port 3001), erreichbar unter/familytool/api/. Enthält das manifestbasierte Backend-Modulsystem (lib/moduleLoader.js,data/modules/<id>/), inkl. der Discord-Integration und der Lizenzserver-Anbindung (licenseCheck.js,FLESSING_PROGRAM_API_KEY).
Diese Trennung ist bereits strukturell vorhanden und bildet die Grundlage für die Community/Premium-Aufteilung.
Lizenz- & Modulsystem (dieses Repo)
src/features/tiers.ts—LicenseTier-Enum (COMMUNITY, TRIAL, PREMIUM, UNLIMITED, LIFETIME),getLicenseTier(),hasTier(),TIER_LABELS,TIER_COLORSsrc/features/access.ts—hasFeature(),getAvailableModules(), re-exportiert die Tier-Helfer austiers.tssrc/features/registry.ts—ADD_ONS(Marketing-/Feature-Übersicht für die Einstellungsseite), jeweils mittier: LicenseTiersrc/modules/registry.ts—MODULE_REGISTRY, jedes Modul mitrequiredTier: LicenseTier(sieheMODULE_SYSTEM.md)
Geplante Community/Premium-Trennung (Phase 2, noch nicht umgesetzt)
familytool-community(öffentliches GitHub-Repo): dieses Repo, bereinigt um Discord-UI, Kiosk/Wallboard-Routen und alle Premium-spezifischen Inhalte — diese sind bereits überrequiredTier/hasFeature()gegated, müssen für die Veröffentlichung aber tatsächlich aus dem Quellbaum entfernt werden.familytool-premium(privates Repo): Discord-Modul, Wallboard, Kiosk, Lizenzserver-Integration (/opt/familytool-api-Teile), baut auf der Community-Codebasis auf bzw. erweitert sie.
Datenschutz
data/db.json, data/db.json.backup-*.json und data/backups/ enthalten
echte Familiendaten und sind in .gitignore ausgeschlossen. .env.local
und .env.*.local (Legacy-Migrationszugänge) ebenfalls. Vor jedem Commit/
Push prüfen: git status und git diff --cached auf versehentlich
gestagte Datendateien oder Secrets.