mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-17 22:09:39 +02:00
ace7fa8f7f
- Move finance, mail, moodlit to apps-archived for later development - Rename games/voxel-lava to games/voxelava 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
295 lines
8.7 KiB
Markdown
295 lines
8.7 KiB
Markdown
# Moodlit Project Guide
|
|
|
|
## Übersicht
|
|
|
|
**Moodlit** ist eine Ambient-Lighting-App, die es Benutzern ermöglicht, benutzerdefinierte Lichtstimmungen mit Farbverläufen und Animationen zu erstellen. Die App unterstützt sowohl bildschirmbasierte Beleuchtung als auch Geräte-Taschenlampensteuerung.
|
|
|
|
| App | Port | URL |
|
|
|-----|------|-----|
|
|
| Backend | 3012 | http://localhost:3012 |
|
|
| Web App | 5182 | http://localhost:5182 |
|
|
| Landing Page | 4332 | http://localhost:4332 |
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
apps/moodlit/
|
|
├── apps/
|
|
│ ├── backend/ # NestJS API server (@moodlit/backend)
|
|
│ │ └── src/
|
|
│ │ ├── main.ts
|
|
│ │ ├── app.module.ts
|
|
│ │ ├── db/
|
|
│ │ │ ├── database.module.ts
|
|
│ │ │ ├── connection.ts
|
|
│ │ │ └── schema/
|
|
│ │ │ ├── moods.schema.ts
|
|
│ │ │ └── sequences.schema.ts
|
|
│ │ ├── moods/
|
|
│ │ │ ├── moods.module.ts
|
|
│ │ │ ├── moods.controller.ts
|
|
│ │ │ ├── moods.service.ts
|
|
│ │ │ └── dto/
|
|
│ │ ├── sequences/
|
|
│ │ │ ├── sequences.module.ts
|
|
│ │ │ ├── sequences.controller.ts
|
|
│ │ │ ├── sequences.service.ts
|
|
│ │ │ └── dto/
|
|
│ │ └── health/
|
|
│ │
|
|
│ ├── web/ # SvelteKit web app (@moodlit/web)
|
|
│ │ └── src/
|
|
│ │ ├── app.html
|
|
│ │ ├── app.css
|
|
│ │ └── routes/
|
|
│ │ ├── +layout.svelte
|
|
│ │ └── +page.svelte
|
|
│ │
|
|
│ ├── mobile/ # Expo React Native app (@moodlit/mobile)
|
|
│ │ ├── app/ # Expo Router routes
|
|
│ │ ├── components/
|
|
│ │ ├── hooks/
|
|
│ │ ├── store/
|
|
│ │ └── utils/
|
|
│ │
|
|
│ └── landing/ # Astro landing page (@moodlit/landing)
|
|
│
|
|
├── package.json
|
|
└── CLAUDE.md
|
|
```
|
|
|
|
## Commands
|
|
|
|
### Root Level (from monorepo root)
|
|
|
|
```bash
|
|
# Alle Apps starten
|
|
pnpm moodlit:dev # Run all moodlit apps
|
|
|
|
# Einzelne Apps starten
|
|
pnpm dev:moodlit:backend # Start backend server (port 3012)
|
|
pnpm dev:moodlit:web # Start web app (port 5182)
|
|
pnpm dev:moodlit:mobile # Start mobile app
|
|
pnpm dev:moodlit:landing # Start landing page (port 4332)
|
|
pnpm dev:moodlit:app # Start web + backend together
|
|
|
|
# Datenbank
|
|
pnpm moodlit:db:push # Push schema to database
|
|
pnpm moodlit:db:studio # Open Drizzle Studio
|
|
pnpm moodlit:db:seed # Seed initial data
|
|
|
|
# Deploy
|
|
pnpm deploy:landing:moodlit # Deploy landing to Cloudflare Pages
|
|
```
|
|
|
|
### Backend (apps/moodlit/apps/backend)
|
|
|
|
```bash
|
|
pnpm dev # Start with hot reload
|
|
pnpm build # Build for production
|
|
pnpm start:prod # Start production server
|
|
pnpm db:push # Push schema to database
|
|
pnpm db:studio # Open Drizzle Studio
|
|
```
|
|
|
|
### Web App (apps/moodlit/apps/web)
|
|
|
|
```bash
|
|
pnpm dev # Start dev server
|
|
pnpm build # Build for production
|
|
pnpm preview # Preview production build
|
|
```
|
|
|
|
### Mobile App (apps/moodlit/apps/mobile)
|
|
|
|
```bash
|
|
pnpm dev # Start Expo dev server
|
|
pnpm ios # Build and run iOS simulator
|
|
pnpm android # Build and run Android emulator
|
|
pnpm build:dev # EAS development build
|
|
```
|
|
|
|
### Landing Page (apps/moodlit/apps/landing)
|
|
|
|
```bash
|
|
pnpm dev # Start dev server (port 4332)
|
|
pnpm build # Build for production
|
|
pnpm preview # Preview build
|
|
```
|
|
|
|
## Technology Stack
|
|
|
|
| Layer | Technology |
|
|
|-------|------------|
|
|
| **Backend** | NestJS 10, Drizzle ORM, PostgreSQL |
|
|
| **Web** | SvelteKit 2.x, Svelte 5 (runes), Tailwind CSS 4 |
|
|
| **Mobile** | Expo SDK 54, React Native 0.81, NativeWind, Zustand |
|
|
| **Landing** | Astro 5.x, Tailwind CSS |
|
|
| **Auth** | Mana Core Auth (JWT) |
|
|
|
|
## Features
|
|
|
|
### 1. Mood Library
|
|
- Vorkonfigurierte Lichtstimmungen (Fire, Breath, Northern Lights, Thunder, etc.)
|
|
- Verschiedene Farbverläufe und Animationstypen
|
|
- Standard-Moods für jeden Benutzer
|
|
|
|
### 2. Custom Moods
|
|
- Erstelle eigene Lichtstimmungen
|
|
- Anpassbare Farben und Animationen
|
|
- Speichern und Wiederverwenden
|
|
|
|
### 3. Sequences
|
|
- Mehrere Moods zu einer Sequenz verketten
|
|
- Konfigurierbare Dauer und Übergänge
|
|
- Automatische Wiedergabe
|
|
|
|
### 4. Dual Output
|
|
- Bildschirmbasierte Beleuchtung
|
|
- Geräte-Taschenlampensteuerung
|
|
- Umschalten zwischen Modi
|
|
|
|
## API Endpoints
|
|
|
|
### Health
|
|
```
|
|
GET /api/v1/health # Health check
|
|
```
|
|
|
|
### Moods
|
|
```
|
|
GET /api/v1/moods # List all moods
|
|
POST /api/v1/moods # Create mood
|
|
GET /api/v1/moods/:id # Get mood
|
|
PUT /api/v1/moods/:id # Update mood
|
|
DELETE /api/v1/moods/:id # Delete mood
|
|
```
|
|
|
|
### Sequences
|
|
```
|
|
GET /api/v1/sequences # List all sequences
|
|
POST /api/v1/sequences # Create sequence
|
|
GET /api/v1/sequences/:id # Get sequence
|
|
PUT /api/v1/sequences/:id # Update sequence
|
|
DELETE /api/v1/sequences/:id # Delete sequence
|
|
```
|
|
|
|
## Database Schema
|
|
|
|
### moods
|
|
| Column | Type | Description |
|
|
|--------|------|-------------|
|
|
| `id` | UUID | Primary key |
|
|
| `user_id` | TEXT | Owner |
|
|
| `name` | TEXT | Mood name |
|
|
| `colors` | JSONB | Array of color hex codes |
|
|
| `animation` | TEXT | Animation type |
|
|
| `is_default` | BOOLEAN | Default mood flag |
|
|
| `created_at` | TIMESTAMP | Created date |
|
|
| `updated_at` | TIMESTAMP | Updated date |
|
|
|
|
### sequences
|
|
| Column | Type | Description |
|
|
|--------|------|-------------|
|
|
| `id` | UUID | Primary key |
|
|
| `user_id` | TEXT | Owner |
|
|
| `name` | TEXT | Sequence name |
|
|
| `mood_ids` | JSONB | Array of mood IDs |
|
|
| `duration` | INTEGER | Duration per mood (seconds) |
|
|
| `created_at` | TIMESTAMP | Created date |
|
|
| `updated_at` | TIMESTAMP | Updated date |
|
|
|
|
## Environment Variables
|
|
|
|
### Backend (.env)
|
|
```env
|
|
NODE_ENV=development
|
|
PORT=3012
|
|
DATABASE_URL=postgresql://manacore:devpassword@localhost:5432/moods
|
|
MANA_CORE_AUTH_URL=http://localhost:3001
|
|
CORS_ORIGINS=http://localhost:5173,http://localhost:5182,http://localhost:8081
|
|
DEV_BYPASS_AUTH=true
|
|
DEV_USER_ID=your-test-user-id
|
|
```
|
|
|
|
### Web (.env)
|
|
```env
|
|
PUBLIC_BACKEND_URL=http://localhost:3012
|
|
PUBLIC_MANA_CORE_AUTH_URL=http://localhost:3001
|
|
```
|
|
|
|
### Mobile (.env)
|
|
```env
|
|
EXPO_PUBLIC_BACKEND_URL=http://localhost:3012
|
|
EXPO_PUBLIC_MANA_CORE_AUTH_URL=http://localhost:3001
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
### 1. Datenbank erstellen
|
|
|
|
```bash
|
|
# PostgreSQL Container muss laufen
|
|
docker compose -f docker-compose.dev.yml up -d postgres
|
|
|
|
# Datenbank erstellen
|
|
PGPASSWORD=devpassword psql -h localhost -U manacore -d postgres -c "CREATE DATABASE moods;"
|
|
|
|
# Schema pushen
|
|
pnpm moodlit:db:push
|
|
```
|
|
|
|
### 2. Apps starten
|
|
|
|
```bash
|
|
# Backend + Web zusammen
|
|
pnpm dev:moodlit:app
|
|
|
|
# Oder einzeln:
|
|
pnpm dev:moodlit:backend # Terminal 1
|
|
pnpm dev:moodlit:web # Terminal 2
|
|
pnpm dev:moodlit:mobile # Terminal 3
|
|
pnpm dev:moodlit:landing # Terminal 4 (optional)
|
|
```
|
|
|
|
### 3. URLs öffnen
|
|
|
|
- Web App: http://localhost:5182
|
|
- Landing: http://localhost:4332
|
|
- API Health: http://localhost:3012/api/v1/health
|
|
|
|
## Testing API (mit curl)
|
|
|
|
```bash
|
|
# Health Check
|
|
curl http://localhost:3012/api/v1/health
|
|
|
|
# Login (get token)
|
|
TOKEN=$(curl -s -X POST http://localhost:3001/api/v1/auth/login \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"email": "test@example.com", "password": "password"}' | jq -r '.accessToken')
|
|
|
|
# Moods abrufen
|
|
curl http://localhost:3012/api/v1/moods \
|
|
-H "Authorization: Bearer $TOKEN"
|
|
|
|
# Neues Mood erstellen
|
|
curl -X POST http://localhost:3012/api/v1/moods \
|
|
-H "Authorization: Bearer $TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"name": "Sunset", "colors": ["#ff6b6b", "#feca57", "#ff9ff3"], "animation": "gradient"}'
|
|
|
|
# Sequence erstellen
|
|
curl -X POST http://localhost:3012/api/v1/sequences \
|
|
-H "Authorization: Bearer $TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"name": "Evening Flow", "moodIds": ["mood-id-1", "mood-id-2"], "duration": 30}'
|
|
```
|
|
|
|
## Important Notes
|
|
|
|
1. **Authentication**: Nutzt Mana Core Auth (JWT im Authorization Header)
|
|
2. **Database**: PostgreSQL mit Drizzle ORM (Port 5432)
|
|
3. **Port**: Backend läuft auf Port 3012, Web auf 5182, Landing auf 4332
|
|
4. **Mobile**: Verwendet Expo Dev Client (nicht Expo Go) wegen nativer Dependencies
|
|
5. **Theme**: Purple/Violet als Primärfarbe für die Mood-Thematik
|