mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 18:21:09 +02:00
docs: add comprehensive overview of local-first migration and service extraction
Summary document covering: - Local-first status for all 19/22 apps (which stores are done vs pending) - Service extraction progress (mana-credits, mana-user done) - What's left to extract (subscriptions, analytics) - Phase 5 plan (auth Hono rewrite) - All commits from this session - Prioritized next steps Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS
parent
ef19018e71
commit
21a5f875f9
1 changed files with 154 additions and 0 deletions
154
.claude/plans/local-first-and-service-extraction-overview.md
Normal file
154
.claude/plans/local-first-and-service-extraction-overview.md
Normal file
|
|
@ -0,0 +1,154 @@
|
|||
# Local-First Migration & Service-Extraktion — Gesamtübersicht
|
||||
|
||||
> **Stand:** 2026-03-27
|
||||
> **Autor:** Claude Code + Till Schneider
|
||||
|
||||
---
|
||||
|
||||
## Teil 1: Local-First Migration (Phase 3)
|
||||
|
||||
**Ziel:** Alle Web-Apps auf IndexedDB (Dexie.js) + Sync umstellen → Guest-Mode, Offline CRUD, Instant UI.
|
||||
|
||||
### Erledigt: 19/22 Apps
|
||||
|
||||
| # | App | Collections | Stores umgeschrieben? |
|
||||
| --- | --------------- | ---------------------------------------------------- | ------------------------------------------------------------ |
|
||||
| 1 | Todo | tasks, projects, labels, taskLabels, reminders | Ja (komplett) |
|
||||
| 2 | Zitare | favorites, lists | Ja (komplett) |
|
||||
| 3 | Calendar | calendars, events | Ja (komplett) |
|
||||
| 4 | Clock | alarms, timers, worldClocks | Ja (komplett) |
|
||||
| 5 | Contacts | contacts | Ja (komplett) |
|
||||
| 6 | ManaDeck | decks, cards | Ja (komplett) |
|
||||
| 7 | **Presi** | decks, slides | Ja (Store + Pages umgeschrieben) |
|
||||
| 8 | **Picture** | images, boards, boardItems, tags, imageTags | Ja (Gallery + Boards umgeschrieben) |
|
||||
| 9 | **Inventar** | collections, items, locations, categories | Nein (local-store angelegt, Stores nutzen noch localStorage) |
|
||||
| 10 | **NutriPhi** | meals, goals, favorites | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 11 | **Planta** | plants, plantPhotos, wateringSchedules, wateringLogs | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 12 | **Storage** | files, folders, tags, fileTags | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 13 | **Chat** | conversations, messages, templates | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 14 | **Questions** | collections, questions, answers | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 15 | **Mukke** | songs, playlists, playlistSongs, projects, markers | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 16 | **Context** | spaces, documents | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 17 | **Photos** | albums, albumItems, favorites, tags, photoTags | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
| 18 | **SkilltTree** | skills, activities, achievements | Ja (eigene idb → @manacore/local-store migriert) |
|
||||
| 19 | **CityCorners** | locations, favorites | Nein (local-store angelegt, Stores nutzen noch API) |
|
||||
|
||||
**Nicht migriert (kein CRUD):** ManaCore (Hub), Matrix (Protocol), Playground (stateless)
|
||||
|
||||
### Was pro App gemacht wurde (9-19):
|
||||
|
||||
- `local-store.ts` mit `createLocalStore()` und typisierten Collections
|
||||
- `guest-seed.ts` mit Onboarding-Daten
|
||||
- Layout mit `AuthGate allowGuest={true}` + `handleAuthReady()` (initialize + startSync)
|
||||
- `GuestWelcomeModal` für Erst-Besuch
|
||||
- `@manacore/local-store` als Dependency
|
||||
|
||||
### Was noch fehlt (Stores vertiefen):
|
||||
|
||||
Apps 9-17 und 19 haben die Datenschicht (IndexedDB), aber die Svelte-Stores lesen noch von der API. Die Stores müssen umgeschrieben werden wie bei Presi (7), Picture (8), und SkilltTree (18).
|
||||
|
||||
---
|
||||
|
||||
## Teil 2: Service-Extraktion aus mana-core-auth (Phase 4)
|
||||
|
||||
**Ziel:** mana-core-auth aufteilen in fokussierte Microservices auf Hono + Bun.
|
||||
|
||||
### Erledigt
|
||||
|
||||
| Service | Port | Was extrahiert | LOC (neu) | LOC (entfernt aus Auth) |
|
||||
| ---------------- | ---- | ---------------------------------------------- | --------- | ----------------------- |
|
||||
| **mana-credits** | 3061 | Credits, Gifts, Guild Pools, Stripe Payments | ~2.400 | ~4.200 |
|
||||
| **mana-user** | 3062 | Settings, Tags, Tag-Groups, Tag-Links, Storage | ~780 | ~2.800 |
|
||||
|
||||
**Ergebnis:** mana-core-auth von ~20k auf ~13k LOC reduziert.
|
||||
|
||||
**Was gemacht wurde:**
|
||||
|
||||
- Neuer Service mit Hono + Bun (kein NestJS)
|
||||
- Drizzle ORM Schemas adaptiert (keine FK zu Auth-Tabellen)
|
||||
- Zod statt class-validator für Validation
|
||||
- JWT-Validierung via JWKS von mana-core-auth
|
||||
- Service-to-Service Auth via X-Service-Key
|
||||
- CreditClientService URL auf `MANA_CREDITS_URL` umgestellt
|
||||
- mana-core-auth Registration Hooks auf HTTP-Calls umgestellt
|
||||
- Docker-Compose Einträge + Cloudflare Tunnel Labels
|
||||
- Alter Code komplett aus mana-core-auth entfernt
|
||||
|
||||
### Noch zu extrahieren
|
||||
|
||||
| Service | Was | LOC in Auth | Priorität |
|
||||
| ---------------------- | ------------------------------------ | ----------- | --------- |
|
||||
| **mana-subscriptions** | Subscriptions, Pläne, Stripe Billing | ~1.100 | Mittel |
|
||||
| **mana-analytics** | Feedback, Analytics (DuckDB), AI | ~1.000 | Niedrig |
|
||||
|
||||
### Nach vollständiger Extraktion bleibt in mana-core-auth:
|
||||
|
||||
- Better Auth (JWT, Sessions, 2FA, Passkeys, Magic Links)
|
||||
- OIDC Provider (Matrix/Synapse SSO)
|
||||
- Organizations (Better Auth Org Plugin)
|
||||
- Guilds (Org-Wrapper, ohne Pool — Pool ist in mana-credits)
|
||||
- API Keys
|
||||
- Security (Audit Logs, Lockout)
|
||||
- Me (GDPR Export/Delete)
|
||||
- Health, Metrics
|
||||
|
||||
→ Geschätzt ~8-10k LOC reines Auth → Dann Hono-Rewrite (Phase 5)
|
||||
|
||||
---
|
||||
|
||||
## Teil 3: Hono-Rewrite von mana-core-auth (Phase 5)
|
||||
|
||||
**Noch nicht begonnen.** Geplante Schritte:
|
||||
|
||||
1. Hono App-Skeleton + Better Auth native Handler
|
||||
2. JWT Middleware + Auth-Guards als Hono Middleware
|
||||
3. Health + JWKS + Token-Validation Endpoints
|
||||
4. Auth-Endpoints (Register, Login, Refresh, SSO)
|
||||
5. Organizations/Guilds
|
||||
6. OIDC Provider + Matrix Session
|
||||
7. API Keys, Me (GDPR), Admin
|
||||
8. Tests + Umschalten
|
||||
|
||||
**Voraussetzung:** Subscriptions + Analytics zuerst extrahieren.
|
||||
|
||||
---
|
||||
|
||||
## Teil 4: Infrastruktur (Phase 5b)
|
||||
|
||||
- [ ] NestJS Dependencies aus dem Monorepo entfernen
|
||||
- [ ] `packages/shared-nestjs-auth` → `packages/shared-hono-auth`
|
||||
- [ ] `@mana-core/nestjs-integration` → `@mana-core/hono-integration`
|
||||
- [ ] Docker-Images auf Bun Base Image umstellen
|
||||
- [ ] CI/CD Pipeline anpassen (Go Build + Bun Build)
|
||||
- [ ] Monitoring: Prometheus Metrics für neue Services
|
||||
- [ ] Load Testing: Sync-Protokoll unter Last testen
|
||||
|
||||
---
|
||||
|
||||
## Zusammenfassung der Commits (diese Session)
|
||||
|
||||
```
|
||||
# Local-First (Phase 3)
|
||||
ce51fd5f feat(apps): migrate Presi, Picture, Inventar, NutriPhi, Planta, Storage
|
||||
8d880f1f feat(apps): migrate Chat, Questions, Mukke, Context, Photos
|
||||
a31ccc6c feat(apps): add local-store to SkilltTree and CityCorners
|
||||
7754cf6e refactor(skilltree): replace custom idb → @manacore/local-store
|
||||
97ef728e docs: update migration plan to 19/19
|
||||
|
||||
# Service-Extraktion (Phase 4)
|
||||
15deaf4e feat(services): create mana-credits (Hono + Bun)
|
||||
b0009c20 refactor(credits): route calls to mana-credits
|
||||
c0798713 refactor(auth): remove credits/gifts (-4,185 LOC)
|
||||
feeebfb7 feat(infra): docker-compose for mana-credits
|
||||
ef19018e feat(services): create mana-user + remove from auth (-2,834 LOC)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Nächste Schritte (Priorität)
|
||||
|
||||
1. **mana-subscriptions extrahieren** — Stripe Billing raus aus Auth
|
||||
2. **mana-analytics extrahieren** — Feedback + DuckDB raus aus Auth
|
||||
3. **Auth Hono-Rewrite** — Better Auth mit nativem Hono-Adapter
|
||||
4. **Store-Migrationen vertiefen** — Apps 9-17, 19: Stores auf IndexedDB umschreiben
|
||||
5. **mana-sync Go Server** — Collections aller 19 Apps registrieren
|
||||
Loading…
Add table
Add a link
Reference in a new issue