mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 19:01:08 +02:00
7c1e2aca49
Deleted: - DOCKER_REGISTRY_SETUP.md, QUICK_START_CICD.md (legacy CI/CD docs) - docs/ULOAD-DEPLOYMENT.md (Hetzner VPS deployment guide) - scripts/get-ssh-key.sh, scripts/remove-coolify-references.sh (legacy scripts) Updated Hetzner → MinIO references in: - shared-storage (package.json, README, client.ts, types.ts) - App CLAUDE.md files (mukke, storage, planta, picture) - .claude/GUIDELINES.md, sveltekit-web.md guideline - TROUBLESHOOTING.md, SETUP_TEMPLATES.md (replaced IPs with placeholders) - GIT_WORKFLOW.md, COMMANDS.md - services/matrix-project-doc-bot/CLAUDE.md Remaining Hetzner mentions are in historical devlogs/audits and docs that list Hetzner as a hosting alternative (not as active infrastructure). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
11 KiB
11 KiB
Manacore Monorepo - Befehle
Alles starten (PostgreSQL, Redis, Auth, Chat)
pnpm docker🆙all
pnpm docker:down
pnpm dev:chat:full pnpm dev:picture:full pnpm dev📆full pnpm dev:contacts:full pnpm dev:todo:full pnpm dev:presi:full pnpm dev:storage:full pnpm dev:skilltree:full pnpm dev:questions:full
pnpm dev:manacore:app # Nur ManaCore Web pnpm dev:manacore:backends # Alle 7 Backends für Dashboard-Widgets pnpm dev:manacore:full # Web + alle Backends (empfohlen)
Deployment Landingpages:
Einzelne Landing Page
pnpm deploy:landing:chat pnpm deploy:landing:picture pnpm deploy:landing:manacore pnpm deploy:landing:manadeck
Hier sind alle Landing Page URLs:
| Projekt | URL |
|---|---|
| Chat | https://chat-landing-90m.pages.dev |
| Picture | https://picture-landing.pages.dev |
| ManaCore | https://manacore-landing.pages.dev |
| ManaDeck | https://manadeck-landing.pages.dev |
Alle auf einmal
pnpm deploy:landing:all
Übersicht aller wichtigen Befehle zum Starten, Stoppen und Verwalten der Apps.
Inhaltsverzeichnis
- Voraussetzungen
- Docker & Infrastruktur
- Mana Core Auth
- Chat
- Picture
- Manadeck
- SkillTree
- Questions
- Mana Search
- Manacore
- Mana Games
- Allgemeine Befehle
- Stoppen & Aufräumen
Voraussetzungen
# Dependencies installieren (generiert auch .env Dateien)
pnpm install
# Nur .env Dateien neu generieren
pnpm setup:env
# Shared Packages bauen
pnpm build:packages
Docker & Infrastruktur
Starten
# Nur PostgreSQL + Redis (Basis-Infrastruktur)
pnpm docker:up
# Mit Mana Core Auth Service
pnpm docker:up:auth
# Mit Chat Backend
pnpm docker:up:chat
# Alles starten (PostgreSQL, Redis, Auth, Chat)
pnpm docker:up:all
Status & Logs
# Container-Status anzeigen
pnpm docker:ps
# Alle Logs anzeigen (live)
pnpm docker:logs
# Nur Auth-Logs
pnpm docker:logs:auth
# Nur Chat-Logs
pnpm docker:logs:chat
Stoppen
# Alle Container stoppen
pnpm docker:down
# Stoppen + Volumes löschen (Datenbank-Reset!)
pnpm docker:clean
Mana Core Auth
Der zentrale Authentifizierungs-Service (Port 3001).
# Im Docker starten (empfohlen)
pnpm docker:up:auth
# Oder lokal starten
cd services/mana-core-auth
pnpm start:dev
# Datenbank-Migration
cd services/mana-core-auth
pnpm migration:generate # Migration erstellen
pnpm migration:run # Migration ausführen
pnpm db:push # Schema direkt pushen (dev)
pnpm db:studio # Drizzle Studio öffnen
Chat
| App | Port | Befehl |
|---|---|---|
| Web | 5174 | pnpm dev:chat:web |
| Backend | 3002 | pnpm dev:chat:backend |
| Mobile | 8081 | pnpm dev:chat:mobile |
| Landing | - | pnpm dev:chat:landing |
# Web + Backend zusammen starten
pnpm dev:chat:app
# Alles (Web, Backend, Mobile, Landing)
pnpm chat:dev
Picture
| App | Port | Befehl |
|---|---|---|
| Web | 5173 | pnpm dev:picture:web |
| Backend | - | pnpm dev:picture:backend |
| Mobile | 8081 | pnpm dev:picture:mobile |
| Landing | - | pnpm dev:picture:landing |
# Web + Backend zusammen starten
pnpm dev:picture:app
# Alles
pnpm picture:dev
Manadeck
| App | Port | Befehl |
|---|---|---|
| Web | - | pnpm dev:manadeck:web |
| Backend | - | pnpm dev:manadeck:backend |
| Mobile | 8081 | pnpm dev:manadeck:mobile |
| Landing | - | pnpm dev:manadeck:landing |
# Web + Backend zusammen starten
pnpm dev:manadeck:app
# Alles
pnpm manadeck:dev
SkillTree
Gamified Skill-Tracking App - wie ein RPG Skill Tree für echte Fähigkeiten.
| App | Port | Befehl |
|---|---|---|
| Web | 5195 | pnpm dev:skilltree:web |
| Backend | 3024 | pnpm dev:skilltree:backend |
# Web + Backend zusammen starten
pnpm dev:skilltree:app
# Mit Auth + automatischem DB-Setup (empfohlen)
pnpm dev:skilltree:full
# Datenbank
pnpm skilltree:db:push # Schema pushen
pnpm skilltree:db:studio # Drizzle Studio
Questions
AI-powered Research Assistant - sammelt Fragen und führt Web-Recherche durch.
| App | Port | Befehl |
|---|---|---|
| Web | 5111 | pnpm dev:questions:web |
| Backend | 3011 | pnpm dev:questions:backend |
# Web + Backend zusammen starten
pnpm dev:questions:app
# Mit Auth + Search Service + automatischem DB-Setup (empfohlen)
pnpm dev:questions:full
# Datenbank
cd apps/questions/apps/backend
pnpm drizzle-kit push # Schema pushen
pnpm drizzle-kit studio # Drizzle Studio
Hinweis: Questions benötigt den mana-search Service für Web-Recherche.
Mana Search
Zentraler Such-Microservice mit SearXNG für Web-Suche und Content-Extraktion.
| Service | Port | Befehl |
|---|---|---|
| API | 3021 | pnpm dev:search |
| SearXNG | 8080 | (Docker) |
| Redis | 6380 | (Docker) |
# SearXNG + Redis in Docker starten
pnpm dev:search:docker
# NestJS API starten
pnpm dev:search
# Beides zusammen (empfohlen)
pnpm dev:search:full
# Docker stoppen
pnpm dev:search:docker:down
# Logs anzeigen
pnpm dev:search:docker:logs
API testen
# Health Check
curl http://localhost:3021/api/v1/health
# Web-Suche
curl -X POST http://localhost:3021/api/v1/search \
-H "Content-Type: application/json" \
-d '{"query": "TypeScript tutorial", "options": {"limit": 5}}'
# Content extrahieren
curl -X POST http://localhost:3021/api/v1/extract \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "options": {"includeMarkdown": true}}'
Manacore
| App | Port | Befehl |
|---|---|---|
| Web | 5173 | pnpm dev:manacore:web |
| Mobile | 8081 | pnpm dev:manacore:mobile |
| Landing | - | pnpm dev:manacore:landing |
| Backends | - | pnpm dev:manacore:backends |
# Nur ManaCore Web
pnpm dev:manacore:app
# Alle Backends für Dashboard-Widgets starten (7 Services parallel)
# Startet: auth, chat, calendar, contacts, todo, picture, manadeck
pnpm dev:manacore:backends
# ManaCore Web + alle Backends zusammen (empfohlen für Dashboard-Entwicklung)
pnpm dev:manacore:full
# Alles inkl. Mobile
pnpm manacore:dev
Dashboard-Backends Übersicht
Die Dashboard-Widgets benötigen diese Backend-Services:
| Widget | Backend | Port |
|---|---|---|
| Credits | auth | 3001 |
| Chat Recent | chat | 3002 |
| Calendar Events | calendar | 3014 |
| Contacts Favorites | contacts | 3015 |
| Tasks Today/Upcoming | todo | 3018 |
| Picture Recent | picture | 3006 |
| Manadeck Progress | manadeck | 3009 |
Mana Games
# Web + Backend zusammen starten
pnpm dev:mana-games:app
# Einzeln
pnpm dev:mana-games:web
pnpm dev:mana-games:backend
# Alles
pnpm mana-games:dev
Allgemeine Befehle
# Alles bauen
pnpm build
# Type-Check
pnpm type-check
# Linting
pnpm lint
# Formatierung
pnpm format # Formatieren
pnpm format:check # Nur prüfen
# Tests
pnpm test
# Cache leeren
pnpm clean
Stoppen & Aufräumen
Prozesse stoppen
# Alle Node-Prozesse beenden (macOS/Linux)
pkill -f "node"
# Spezifischen Port freigeben
lsof -ti:3001 | xargs kill -9 # Port 3001 (Auth)
lsof -ti:3002 | xargs kill -9 # Port 3002 (Chat Backend)
lsof -ti:5174 | xargs kill -9 # Port 5174 (Chat Web)
# Turbo Cache leeren
pnpm clean
Docker stoppen
# Container stoppen (Daten bleiben)
pnpm docker:down
# Container + Volumes löschen (Datenbank-Reset!)
pnpm docker:clean
Komplettes Cleanup
# Alles stoppen und aufräumen
pnpm docker:down
pkill -f "node"
pnpm clean
rm -rf node_modules/.cache
Typische Workflows
Chat-Entwicklung starten
# 1. Infrastruktur starten
pnpm docker:up
# 2. Auth-Service starten (neues Terminal)
cd services/mana-core-auth && pnpm start:dev
# 3. Chat App starten (neues Terminal)
pnpm dev:chat:app
Alles mit Docker
# Alles in Docker starten
pnpm docker:up:all
# Nur Frontend lokal
pnpm dev:chat:web
Nach Code-Änderungen in Shared Packages
# Packages neu bauen
pnpm build:packages
# Oder spezifisches Package
pnpm --filter @manacore/shared-ui build
App-Übersicht
Aktive Apps (apps/) - 12 Apps
- calendar - Kalender-App für persönliches und geteiltes Zeitmanagement mit wiederkehrenden Terminen, CalDAV/iCal-Sync und Erinnerungen
- chat - KI-Chat-Anwendung mit verschiedenen KI-Modellen und Konversationsverlauf
- contacts - Kontaktverwaltung mit Import/Export und Google-Synchronisation
- context - AI document context (Expo mobile only)
- manacore - Multi-App Ecosystem Platform - zentrales Dashboard für alle Mana-Apps
- manadeck - Karteikarten-/Lernkarten-Management für Spaced Repetition Learning
- nutriphi - Nutrition tracking (geplant, noch kein Backend)
- picture - KI-Bildgenerierung mit verschiedenen Modellen und Galerie-Verwaltung
- questions - AI-powered Research Assistant mit Web-Recherche über mana-search
- skilltree - Gamified Skill-Tracking mit XP-System, Leveln und 6 Skill-Branches
- storage - Cloud storage (geplant, noch kein Backend)
- todo - Task-Management mit Projekten, Subtasks, Labels und wiederkehrenden Aufgaben
Games (games/) - 5 Games
- figgos - Collectible Figure Game mit KI-generierten Fantasy-Figuren zum Sammeln
- mana-games - Browser-Spieleplatform mit 22+ Spielen und KI-Spielgenerierung
- voxel-lava - 3D Voxel Building & Platforming Game mit Level-Editor und Sharing
- whopixels - Pixel-Art-Editor-Spiel mit Phaser.js
- worldream - Text-first World-Building-Plattform für fiktive Welten mit @slug-Referenzen
Services (services/) - 2 Services
- mana-core-auth - Zentraler Authentifizierungs-Service für alle Apps (Better Auth + EdDSA JWT)
- mana-search - Zentraler Such-Service mit SearXNG für Web-Suche und Content-Extraktion (Port 3021)
Shared Packages (packages/) - 4 Kern-Packages
shared-ui - Gemeinsame UI-Komponenten für alle Web-Apps shared-auth - Client-seitige Auth-Integration für Web/Mobile shared-nestjs-auth - NestJS Guards/Decorators für JWT-Validierung shared-storage - S3-kompatible Storage-Abstraktion (MinIO)