managarten/docs/CONSISTENCY_REPORT.md

Monorepo Konsistenz-Bericht

Erstellt: 29. Januar 2026

Übersicht

Nach eingehender Analyse aller Web-Apps im Monorepo wurden folgende Bereiche auf Inkonsistenzen untersucht:

Bereich	Konsistenz	Priorität
Dependencies & Versionen	⚠️ Mittel	Hoch
API Client Patterns	❌ Niedrig	Hoch
i18n Implementation	⚠️ Mittel	Mittel
Auth Implementation	✅ Gut	Niedrig
Styling & Tailwind	✅ Sehr gut	Niedrig
Komponenten & Layouts	⚠️ Mittel	Mittel

---

1. Dependencies & Versionen

Kritische Inkonsistenzen

Tailwind CSS Ansatz (2 verschiedene Methoden)

Methode	Apps
@tailwindcss/postcss	manadeck, chat, manacore, presi
@tailwindcss/vite	clock, planta, skilltree, todo, contacts, nutriphi, questions, calendar, storage, matrix

SvelteKit Versionen

Version	Apps
^2.0.0 (minimal)	planta, clock, skilltree, todo, contacts, nutriphi, presi, questions, calendar, storage
^2.15.7 - ^2.47.1	manadeck, chat, manacore, picture, matrix

Vite Major Version Split

Version	Apps
v6.0.x	clock, skilltree, todo, contacts, nutriphi, questions, calendar, storage, manacore
v7.1.x	manadeck, chat, picture

TypeScript Versionen

• ^5.9.x (spezifisch): manadeck, chat, manacore, picture
• ^5.0.0 (locker): planta, clock, skilltree, todo, contacts, nutriphi, presi, questions, calendar, storage

Empfehlungen

1. Tailwind auf Vite-Plugin vereinheitlichen - alle 4 PostCSS-Apps migrieren
2. SvelteKit auf ^2.47.1 für alle Apps aktualisieren
3. TypeScript auf ^5.9.3 festlegen
4. Vite auf eine Major-Version (v7.x empfohlen)

---

2. API Client Patterns

Kritische Inkonsistenzen

3 verschiedene Architektur-Patterns

Pattern	Apps	Beispiel
Factory Function	calendar, manacore	createApiClient()
Class-Based Singleton	clock, nutriphi, skilltree, questions, planta, todo	new ApiClient()
Functional API Objects	chat, picture, contacts, presi, storage	conversationApi.getAll()

4 verschiedene Token-Handling Ansätze

Ansatz	Apps	Problem
authStore.getAccessToken()	clock, contacts, nutriphi, planta, storage	Kein Auto-Refresh
authStore.getValidToken()	picture, planta, chat	✅ Auto-Refresh
localStorage.getItem()	presi, skilltree, questions	Sync, veraltete Tokens möglich
Manuelles Token-Property	todo, skilltree	Erfordert externen Setter

5 verschiedene Error-Handling Strategien

Strategie	Apps
Result Type {data, error}	calendar, manacore
Response Wrapper	clock, storage
Throw-on-Error	nutriphi, contacts, skilltree, questions, planta, todo
Domain-specific Fallbacks	chat, picture
Retry mit Backoff	nur manacore

Base URL Handling

Methode	Apps	Status
Hardcoded localhost	clock, todo, storage	❌ Nicht für Produktion
Environment Variables	calendar, chat, picture, nutriphi	⚠️ Build-Zeit
Runtime Injection (Docker)	skilltree, questions, planta	✅ Flexibel

Empfehlungen

1. @manacore/shared-api-client Package erstellen mit:

   • Standardisiertem createApiClient(config) Factory
   • ApiResult<T> Type (Go-style)
   • Auto-Token-Refresh bei 401
   • Retry mit Exponential Backoff
   • FormData Support

2. authStore.getValidToken() als Standard für alle Apps

3. Runtime URL Injection (Window-Objekt) für Docker-Kompatibilität

---

3. i18n Implementation

Status

Apps MIT i18n (10)

App	Sprachen
chat	DE, EN, IT, FR, ES
picture	DE, EN, IT, FR, ES
calendar	DE, EN, IT, FR, ES
presi	DE, EN, IT, FR, ES
manadeck	DE, EN, IT, FR, ES
manacore	DE, EN, IT, FR, ES
contacts	DE, EN
storage	DE, EN
clock	DE, EN

Apps OHNE i18n (7)

• zitare
• skilltree
• planta
• nutriphi
• todo
• matrix
• questions

Inkonsistenzen

• Verschiedene localStorage Keys: chat_locale, picture_locale, locale
• Unterschiedliche Sprachanzahl (2-5 Sprachen)
• Manacore Landing nutzt Custom-Implementation statt svelte-i18n

Empfehlungen

1. i18n zu allen 7 fehlenden Apps hinzufügen
2. Storage Key vereinheitlichen auf {app}_locale
3. Mindestens DE + EN für alle Apps

---

4. Auth Implementation

Status: ✅ Gut (97% konsistent)

Alle Apps nutzen Mana Core Auth mit @manacore/shared-auth.

Kleine Variationen

Aspekt	Pattern A	Pattern B
Init	initializeWebAuth (8 Apps)	Custom Setup (ManaDeck)
URL Config	Window Injection (modern)	Static Import
Route Guards	(protected)/ Ordner	(app)/ Ordner

Empfehlungen

1. Window Injection für URLs als Standard dokumentieren
2. Auth Store Pattern in Shared Package extrahieren
3. Server-Side Route Guards ergänzen (aktuell nur Client-Side)

---

5. Styling & Tailwind

Status: ✅ Sehr gut (97% konsistent)

• Alle Apps nutzen @manacore/shared-tailwind/preset
• Einheitliches Theme-System mit CSS Variables
• Dark Mode über .dark Klasse
• 4 Themes verfügbar: Lume, Nature, Stone, Ocean

Kleine Inkonsistenzen

• App-spezifische Farben in app.css vs tailwind.config.js
• Manche Apps definieren Shadows für Dark Mode doppelt
• Mixed --theme-* und --color-* Prefixe

Empfehlungen

1. App-Farben in tailwind.config.js statt app.css
2. Dark Mode Shadows in Shared Preset konsolidieren

---

6. Komponenten & Layouts

Duplikationen gefunden

Toast System (2 Versionen)

Version	Apps	Status
Svelte 5 Runes	chat, etc.	✅ Modern
Writable Store	contacts, etc.	⚠️ Legacy

AuthGateModal

• Dupliziert in: chat, todo, contacts, calendar
• Sollte in @manacore/shared-auth-ui

AppLoadingSkeleton

• Jede App hat eigene Version
• Könnte mit @manacore/shared-ui Skeletons vereinheitlicht werden

Global Error Handler

• Nur in Contacts App vollständig implementiert
• Sollte extrahiert werden

Empfehlungen (nach Priorität)

Hoch

1. Toast Store & Component vereinheitlichen - Svelte 5 Runes Standard
2. AuthGateModal nach shared-auth-ui verschieben
3. Global Error Handler als Composable extrahieren

Mittel

4. @manacore/shared-sveltekit-layout Package mit Root-Layout Template
5. FormModal Generator für config-driven Formulare
6. AppLoadingSkeleton vereinheitlichen

---

Zusammenfassung der Prioritäten

🔴 Hohe Priorität

Aufgabe	Aufwand	Impact
API Client Package erstellen	Hoch	Alle Apps
Tailwind auf Vite-Plugin migrieren (4 Apps)	Mittel	Build-Konsistenz
Toast System vereinheitlichen	Niedrig	UX Konsistenz

🟡 Mittlere Priorität

Aufgabe	Aufwand	Impact
i18n zu 7 Apps hinzufügen	Mittel	Internationalisierung
AuthGateModal in Shared Package	Niedrig	Code-Reduktion
Global Error Handler extrahieren	Niedrig	Error UX
Dependencies aktualisieren	Mittel	Maintenance

🟢 Niedrige Priorität

Aufgabe	Aufwand	Impact
SvelteKit/Vite Versionen angleichen	Niedrig	Konsistenz
App-Skeletons vereinheitlichen	Niedrig	Code-Reduktion
Auth Store Pattern dokumentieren	Niedrig	Onboarding

---

Nächste Schritte

1. API Client Package als erstes angehen (höchster Impact)
2. Tailwind Migration für 4 Apps durchführen
3. Toast System konsolidieren
4. Schrittweise weitere Punkte abarbeiten

---

Anhang: Analysierte Apps

Web Apps (16)

• calendar, chat, clock, contacts, manadeck, manacore, matrix, nutriphi, picture, planta, presi, questions, skilltree, storage, todo, zitare

Shared Packages

• @manacore/shared-auth
• @manacore/shared-auth-ui
• @manacore/shared-icons (Phosphor)
• @manacore/shared-i18n
• @manacore/shared-tailwind
• @manacore/shared-ui
• @manacore/shared-theme