managarten/MANACORE-TODOS.md

# Manacore App - Entwicklungs-Roadmap

> Erstellt am: 2024-12-05
> Status: Aktive Entwicklung

## Inhaltsverzeichnis

- [Aktueller Stand](#aktueller-stand)
- [Kritische TODOs](#kritische-todos-hohe-priorität)
- [Mittlere Priorität](#mittlere-priorität)
- [Nice-to-have](#niedrige-priorität-nice-to-have)
- [Empfohlene Reihenfolge](#empfohlene-reihenfolge)

---

## Aktueller Stand

### Vorhandene Features

| Feature        | Status | Beschreibung                                  |
| -------------- | ------ | --------------------------------------------- |
| Dashboard      | ✅     | Anpassbare Widgets, Drag & Drop               |
| Credits-System | ✅     | Übersicht, Transaktionen, Pakete, Stripe-Kauf |
| Teams          | ✅     | Team-Verwaltung                               |
| Organizations  | ✅     | Organisations-Verwaltung                      |
| Settings       | ✅     | Benutzereinstellungen                         |
| Themes         | ✅     | Theme-Auswahl                                 |
| Feedback       | ✅     | Feedback-Formular                             |
| Profil         | ✅     | Basis-Profil-Ansicht                          |
| i18n           | ✅     | 5 Sprachen (DE, EN, ES, FR, IT)               |
| Apps-Übersicht | ✅     | Alle Mana-Apps anzeigen                       |

### Dashboard-Widgets (6 Typen)

| Widget             | Status |
| ------------------ | ------ |
| Credits            | ✅     |
| Tasks Today        | ✅     |
| Calendar Events    | ✅     |
| Quick Actions      | ✅     |
| Chat Recent        | ✅     |
| Contacts Favorites | ✅     |

### API-Integrationen

| Service  | Status | Datei                          |
| -------- | ------ | ------------------------------ |
| Calendar | ✅     | `lib/api/services/calendar.ts` |
| Chat     | ✅     | `lib/api/services/chat.ts`     |
| Contacts | ✅     | `lib/api/services/contacts.ts` |
| Todo     | ✅     | `lib/api/services/todo.ts`     |
| Zitare   | ✅     | `lib/api/services/zitare.ts`   |
| Credits  | ✅     | `lib/api/credits.ts`           |

---

## Kritische TODOs (Hohe Priorität)

### 1. ✅ Stripe-Integration für Credit-Kauf (ERLEDIGT)

**Status:** Abgeschlossen am 2026-02-13

**Implementiert:**

- [x] Stripe SDK integrieren (`@stripe/mcp` v17.5.0)
- [x] `StripeService` für PaymentIntent-Erstellung
- [x] `POST /credits/purchase` Endpoint
- [x] Webhook-Handler für `payment_intent.succeeded`/`payment_intent.payment_failed`
- [x] Credit-Gutschrift nach erfolgreicher Zahlung (idempotent)
- [x] Stripe MCP Server eingerichtet (OAuth-basiert)
- [x] Test-Pakete angelegt (Starter, Basic, Pro, Ultra)

**Credit-Pakete:**

| Paket   | Credits | Preis  | Hinweis                 |
| ------- | ------- | ------ | ----------------------- |
| Starter | 100     | €1,00  | 1 Mana = 1 Cent (immer) |
| Basic   | 500     | €5,00  | Kein Mengenrabatt       |
| Pro     | 1.500   | €15,00 | Kein Mengenrabatt       |
| Ultra   | 5.000   | €50,00 | Kein Mengenrabatt       |

> **Preisregel:** 1 Mana = 1 Cent. Keine Rabatte für größere Pakete.

**Dateien:**

- `services/mana-core-auth/src/stripe/` - Stripe-Module
- `services/mana-core-auth/src/credits/credits.service.ts` - Purchase-Methoden

**Noch offen:**

- [ ] Rechnungs-PDF generieren
- [ ] Frontend: Stripe Elements einbinden

---

### 2. App-Config aktualisieren

**Problem:** `apps.ts` enthält veraltete Apps und fehlt neue

**Betroffene Datei:** `apps/manacore/apps/web/src/lib/config/apps.ts`

**Aktuell konfiguriert:**

- memoro (archiviert!)
- manadeck ✅
- storyteller (archiviert!)
- manacore ✅

**Fehlende Apps:**
| App | Typ | Priorität |
|-----|-----|-----------|
| chat | AI-Chat | Hoch |
| picture | AI-Bilder | Hoch |
| zitare | Zitate | Hoch |
| calendar | Kalender | Hoch |
| todo | Aufgaben | Hoch |
| contacts | Kontakte | Mittel |
| clock | Uhren | Mittel |
| presi | Präsentationen | Mittel |
| finance | Finanzen | Mittel |
| mail | E-Mail | Niedrig |
| storage | Cloud-Speicher | Niedrig |
| moodlit | Ambient Lighting | Niedrig |

**Aufgaben:**

- [ ] Archivierte Apps entfernen (memoro, storyteller)
- [ ] Alle aktiven Apps hinzufügen
- [ ] Features pro App definieren
- [ ] Icons/Emojis festlegen
- [ ] Farben pro App definieren

**Geschätzter Aufwand:** 2-4 Stunden

---

### 3. Dashboard-Widgets erweitern

**Problem:** Nur 6 Widget-Typen, neue Apps fehlen

**Betroffene Dateien:**

- `lib/components/dashboard/widgets/`
- `lib/types/dashboard.ts`
- `lib/config/default-dashboard.ts`

**Neue Widgets erstellen:**

| Widget                 | App      | Beschreibung                    |
| ---------------------- | -------- | ------------------------------- |
| PictureRecentWidget    | picture  | Letzte AI-Generierungen         |
| ManadeckProgressWidget | manadeck | Lernfortschritt, fällige Karten |
| FinanceBalanceWidget   | finance  | Kontostand, Budget-Status       |
| ZitareQuoteWidget      | zitare   | Tägliches Zitat                 |
| ClockAlarmsWidget      | clock    | Nächste Wecker/Timer            |
| MailInboxWidget        | mail     | Ungelesene E-Mails              |
| StorageUsageWidget     | storage  | Speicherplatz-Übersicht         |

**Aufgaben:**

- [ ] Widget-Komponenten erstellen
- [ ] API-Services erweitern
- [ ] Widget-Registry aktualisieren
- [ ] Default-Dashboard anpassen

**Geschätzter Aufwand:** 1-2 Tage

---

### 4. Profil-Features vervollständigen

**Problem:** Mehrere Profil-Aktionen sind nicht implementiert

**Betroffene Datei:** `apps/manacore/apps/web/src/routes/(app)/profile/+page.svelte`

```typescript
// Zeile 20-22: Nur Alert
onDeleteAccount: () => {
  alert('Konto löschen ist noch nicht implementiert.');
},
```

**Fehlende Features:**

| Feature           | Status | Priorität |
| ----------------- | ------ | --------- |
| Profil bearbeiten | ❌     | Hoch      |
| Passwort ändern   | ❌     | Hoch      |
| Konto löschen     | ❌     | Mittel    |
| Avatar hochladen  | ❌     | Niedrig   |
| 2FA aktivieren    | ❌     | Niedrig   |

**Aufgaben:**

- [ ] Profil-Edit Modal/Seite erstellen
- [ ] Passwort-Ändern Dialog
- [ ] Konto-Löschung mit Bestätigung
- [ ] Backend-Endpoints prüfen/erstellen

**Geschätzter Aufwand:** 1-2 Tage

---

## Mittlere Priorität

### 5. Benachrichtigungen/Notifications

**Beschreibung:** Zentrales Benachrichtigungssystem für alle Apps

**Use Cases:**

- Kalender-Erinnerungen (15 min vor Termin)
- Todo-Deadlines (Heute fällig)
- Credit-Warnungen (< 10 Credits)
- Neue Chat-Nachrichten
- Manadeck (Karten zum Lernen)

**Aufgaben:**

- [ ] Notification-Service erstellen
- [ ] Push-Notification Setup (Web Push API)
- [ ] Notification-Center UI
- [ ] Einstellungen pro Notification-Typ
- [ ] Backend: Notification-Queue

**Geschätzter Aufwand:** 3-5 Tage

---

### 6. ✅ Subscription/Plan-Management (Backend ERLEDIGT)

**Status:** Backend implementiert am 2026-02-13

**Implementiert:**

- [x] DB-Schema: `subscriptions.plans`, `subscriptions.subscriptions`, `subscriptions.invoices`
- [x] `SubscriptionsService` mit Checkout, Portal, Cancel, Reactivate
- [x] `SubscriptionsController` mit REST-Endpoints
- [x] Stripe Checkout Session für Subscriptions
- [x] Stripe Customer Portal Integration (Self-Service Billing)
- [x] Webhook-Handler für Subscription/Invoice Events
- [x] Pläne angelegt (Free, Pro, Enterprise)

**Subscription-Pläne:**

| Plan       | Mana/Monat | Monatlich | Jährlich | Features                                |
| ---------- | ---------- | --------- | -------- | --------------------------------------- |
| Free       | 150        | €0        | €0       | Basis-Features, Community Support       |
| Pro        | 1.500      | €9,99     | €99,90   | Alle Features, Priority Support, API    |
| Enterprise | 10.000     | €49,99    | €499,90  | SSO, Audit Logs, SLA, Dedicated Support |

**API-Endpoints:**

```
GET  /api/v1/subscriptions/plans          # Alle Pläne
GET  /api/v1/subscriptions/current        # Aktuelles Abo
POST /api/v1/subscriptions/checkout       # Stripe Checkout starten
POST /api/v1/subscriptions/portal         # Billing Portal öffnen
POST /api/v1/subscriptions/cancel         # Kündigen
POST /api/v1/subscriptions/reactivate     # Reaktivieren
GET  /api/v1/subscriptions/invoices       # Rechnungen
```

**Noch offen (Frontend):**

- [ ] Plan-Übersicht Seite im Frontend
- [ ] Plan-Vergleichs-UI
- [ ] Stripe Price IDs in DB eintragen (nach Stripe-Setup)

---

### 7. API-Keys Verwaltung

**Beschreibung:** Für Entwickler/Power-User API-Zugang ermöglichen

**Features:**

- API-Key generieren
- Key-Liste mit Berechtigungen
- Key widerrufen
- Usage-Statistiken pro Key

**Aufgaben:**

- [ ] API-Keys Seite erstellen
- [ ] Backend: Key-Generation
- [ ] Scopes/Berechtigungen definieren
- [ ] Rate-Limiting pro Key

**Geschätzter Aufwand:** 2-3 Tage

---

### 8. Onboarding-Flow

**Beschreibung:** Welcome-Wizard für neue Benutzer

**Schritte:**

1. Willkommen & Kurze Einführung
2. Profil vervollständigen (Name, Avatar)
3. Bevorzugte Apps auswählen
4. Dashboard personalisieren
5. Credits-System erklären
6. Tour durch wichtigste Features

**Aufgaben:**

- [ ] Onboarding-Wizard Komponente
- [ ] Progress-Tracking (User hat Onboarding abgeschlossen)
- [ ] Skip-Option
- [ ] Feature-Tour (Tooltip-basiert)

**Geschätzter Aufwand:** 2-3 Tage

---

## Niedrige Priorität (Nice-to-have)

### 9. Mobile App aktivieren

**Beschreibung:** Die Mobile App (`apps/mobile`) existiert, aber scheint nicht aktiv genutzt

**Status:** Expo-Projekt vorhanden, aber möglicherweise veraltet

**Aufgaben:**

- [ ] Dependencies aktualisieren
- [ ] Funktionalität mit Web-App abgleichen
- [ ] Auth-Flow testen
- [ ] App Store Submission vorbereiten

---

### 10. DSGVO-konformer Daten-Export

**Beschreibung:** Benutzer können alle ihre Daten exportieren

**Features:**

- "Meine Daten exportieren" Button
- ZIP mit allen Daten (JSON/CSV)
- Inkl. aller App-Daten
- Account-Migration zu anderer Instanz

**Aufgaben:**

- [ ] Export-Job Backend
- [ ] Download-Link per E-Mail
- [ ] Fortschrittsanzeige

---

### 11. Aktivitäts-Feed

**Beschreibung:** Übergreifende Timeline aller Aktivitäten

**Features:**

- "Was habe ich heute gemacht?"
- Filter nach App
- Zeitraum-Auswahl
- Export als Report

---

### 12. Keyboard Shortcuts

**Beschreibung:** Power-User Shortcuts

**Shortcuts:**

- `Cmd/Ctrl + K` - Quick Search/Command Palette
- `Cmd/Ctrl + 1-9` - Schnellzugriff auf Apps
- `Cmd/Ctrl + N` - Neue Aktion (kontextabhängig)

---

## Empfohlene Reihenfolge

| #   | Task                        | Aufwand  | Impact   | Abhängigkeiten |
| --- | --------------------------- | -------- | -------- | -------------- |
| 1   | App-Config aktualisieren    | 2-4h     | Hoch     | Keine          |
| 2   | Stripe-Integration          | 2-3 Tage | Kritisch | mana-core-auth |
| 3   | Dashboard-Widgets erweitern | 1-2 Tage | Hoch     | App-Config     |
| 4   | Profil-Features             | 1-2 Tage | Mittel   | Keine          |
| 5   | Notifications               | 3-5 Tage | Hoch     | Backend-Arbeit |
| 6   | Onboarding                  | 2-3 Tage | Mittel   | Keine          |
| 7   | Subscription-Management     | 2-3 Tage | Mittel   | Stripe         |
| 8   | API-Keys                    | 2-3 Tage | Niedrig  | Keine          |

---

## Quick Wins (< 1 Stunde)

Diese Tasks können schnell erledigt werden:

- [ ] Archivierte Apps aus `apps.ts` entfernen
- [ ] Deutsche Übersetzungen vervollständigen
- [ ] "Coming Soon" Badges für fehlende Features
- [ ] Loading-States verbessern
- [ ] Error-Handling mit Toast-Notifications

---

## Technische Schulden

| Issue                     | Priorität | Beschreibung                   |
| ------------------------- | --------- | ------------------------------ |
| Supabase → mana-core-auth | Hoch      | Auth-Migration abschließen     |
| Tests fehlen              | Mittel    | Unit/E2E Tests hinzufügen      |
| TypeScript strict mode    | Niedrig   | Strikte Typisierung aktivieren |
| Bundle-Size               | Niedrig   | Tree-shaking optimieren        |

---

_Zuletzt aktualisiert: 2026-02-13_