tauri

2026-05-23 15:14:29 +02:00
parent d61472f069
commit 15fe7670c8
34 changed files with 6098 additions and 13 deletions
@@ -0,0 +1,311 @@
+# Omnyx Backend Migrationsplan
+
+## Ziel
+
+Migration von PHP + MySQL zu Bun + Hono + Drizzle ORM für eine Hybrid-Architektur:
+- **Lokal:** SQLite (Desktop/Mobile, offline-fähig)
+- **Server:** PostgreSQL (Docker, Multi-User)
+- **Desktop:** Tauri + Bun-Sidecar
+- **Mobile:** Capacitor + SQLite via WASM
+
+## Tech Stack
+
+| Komponente | Technologie |
+|---|---|
+| **Runtime** | Bun (TypeScript-nativ, bun:sqlite built-in) |
+| **Server** | Hono (leicht, Zod-Validation) |
+| **ORM** | Drizzle ORM (bun:sqlite / node-postgres) |
+| **DB lokal** | bun:sqlite |
+| **DB Server** | PostgreSQL (Docker) |
+| **Desktop** | Tauri + Bun-Sidecar |
+| **Mobile** | Capacitor + @libsql/client-web (WASM) |
+
+## Projektstruktur (separates Repo)
+
+```
+omnyx-backend/
+├── src/
+│   ├── index.ts               ← Hono-Server + Router
+│   ├── db/
+│   │   ├── schema.ts          ← Drizzle-Schema (alle Tabellen)
+│   │   ├── index.ts           ← DB-Connection (bun:sqlite / pg)
+│   │   └── migrate.ts         ← Migration runner
+│   ├── routes/
+│   │   ├── media.ts           ← CRUD /api/media
+│   │   ├── cast.ts            ← CRUD /api/cast
+│   │   └── settings.ts        ← CRUD /api/settings
+│   ├── middleware/
+│   │   ├── cors.ts
+│   │   └── error.ts
+│   └── lib/
+│       └── json-fields.ts     ← Helper für JSON-Array-Felder
+├── scripts/
+│   └── migrate-from-php.ts    ← Import-Skript von alter MySQL-DB
+├── package.json
+├── tsconfig.json
+├── Dockerfile
+└── docker-compose.yml
+```
+
+## Datenbank-Tabellen
+
+### media
+| Spalte | Typ | Anmerkung |
+|--------|-----|-----------|
+| id | integer | PK autoIncrement |
+| title | text | NOT NULL |
+| year | integer | NOT NULL |
+| poster | text | nullable |
+| banner | text | nullable |
+| description | text | nullable |
+| rating | real | nullable |
+| category | text | nullable |
+| type | text | default 'Movie' |
+| status | text | default 'Released' |
+| aspect_ratio | text | nullable |
+| runtime | integer | nullable |
+| director | text | nullable |
+| writer | text | nullable |
+| release_date | text | nullable |
+| source | text | nullable |
+| created_at | text | default datetime() |
+| updated_at | text | default datetime() |
+| genres | text | JSON-Array |
+| tags | text | JSON-Array |
+| studios | text | JSON-Array |
+| categories | text | JSON-Array |
+| series | text | JSON-Array |
+| platforms | text | JSON-Array |
+| developers | text | JSON-Array |
+| completion_status | text | nullable |
+| play_count | integer | default 0 |
+| last_activity | text | nullable |
+| playtime | integer | default 0 |
+
+### episodes
+| Spalte | Typ |
+|--------|-----|
+| id | integer PK |
+| media_id | integer FK → media |
+| season | integer |
+| episode_number | integer |
+| title | text |
+| description | text |
+| air_date | text |
+| duration | integer |
+| thumbnail | text |
+
+### tracks
+| Spalte | Typ |
+|--------|-----|
+| id | integer PK |
+| media_id | integer FK → media |
+| track_number | integer |
+| title | text |
+| duration | text (format: "M:SS") |
+| artist | text |
+
+### cast (staff)
+| Spalte | Typ |
+|--------|-----|
+| id | integer PK |
+| name | text NOT NULL |
+| cleanname | text nullable |
+| photo | text nullable |
+| bio | text nullable |
+| birth_date | text nullable |
+| birth_place | text nullable |
+| occupations | text (JSON-Array) |
+| created_at | text |
+| updated_at | text |
+| media_types | text (JSON-Array) |
+| bust_size | integer nullable |
+| cup_size | text nullable |
+| waist_size | integer nullable |
+| hip_size | integer nullable |
+| height | integer nullable |
+| weight | integer nullable |
+| hair_color | text nullable |
+| eye_color | text nullable |
+| ethnicity | text nullable |
+
+### adult_specifics
+| Spalte | Typ |
+|--------|-----|
+| id | integer PK |
+| cast_id | integer FK → cast |
+| tattoos | text nullable |
+| piercings | text nullable |
+| measurements | text nullable |
+| shoe_size | integer nullable |
+
+### media_cast_staff (Junction)
+| Spalte | Typ |
+|--------|-----|
+| media_id | integer FK |
+| cast_id | integer FK |
+| role | text |
+| character_name | text nullable |
+| character_image | text nullable |
+| PK | (media_id, cast_id) |
+
+### cast_media_filmography (Junction)
+| Spalte | Typ |
+|--------|-----|
+| cast_id | integer FK |
+| media_id | integer FK |
+| role | text |
+| character_name | text nullable |
+
+### settings
+| Spalte | Typ |
+|--------|-----|
+| id | integer PK |
+| enabled_categories | text (JSON-Array) |
+| items_per_page | integer default 20 |
+| grid_item_size | integer default 5 |
+| default_view | text default 'grid' |
+| show_adult_content | integer (boolean) default 0 |
+| auto_play_trailers | integer (boolean) default 0 |
+| language | text default 'en' |
+| theme | text default 'system' |
+| jellyfin_library_mappings | text nullable |
+| page_title | text nullable |
+| favicon | text nullable |
+| custom_colors | text nullable (JSON) |
+| created_at | text |
+| updated_at | text |
+
+## API-Endpoints (1:1 von PHP)
+
+### Media
+```
+GET    /api/media?page=1&limit=10000  → PaginatedResponse<ApiMediaItem>
+GET    /api/media/:id                 → ApiResponse<ApiMediaItem>
+POST   /api/media                     → ApiResponse<ApiMediaItem>
+PUT    /api/media/:id                  → ApiResponse<ApiMediaItem>
+DELETE /api/media/:id                  → ApiResponse<{message}>
+```
+
+### Cast
+```
+GET    /api/cast?page=1&limit=100000  → PaginatedResponse<ApiCastItem>
+GET    /api/cast/:id                  → ApiResponse<ApiCastItem>
+GET    /api/cast/:id/media            → PaginatedResponse<ApiMediaItem>
+POST   /api/cast                      → ApiResponse<ApiCastItem>
+PUT    /api/cast/:id                  → ApiResponse<ApiCastItem>
+DELETE /api/cast/:id                  → ApiResponse<{message}>
+```
+
+### Settings
+```
+GET    /api/settings   → ApiResponse<ApiSettingsItem>
+POST   /api/settings   → ApiResponse<ApiSettingsItem>
+PUT    /api/settings   → ApiResponse<ApiSettingsItem>
+```
+
+## Response-Format (identisch zu PHP)
+```json
+{
+  "success": true,
+  "data": { ... }
+}
+```
+
+## DB-Connection (Driver-Abstraktion)
+
+```typescript
+if (process.env.DATABASE_URL) {
+  // Server-Modus → PostgreSQL
+  const { Pool } = await import('pg');
+  const { drizzle } = await import('drizzle-orm/node-postgres');
+  db = drizzle(new Pool({ connectionString: process.env.DATABASE_URL }));
+} else {
+  // Lokaler Modus → bun:sqlite
+  const { Database } = await import('bun:sqlite');
+  const { drizzle } = await import('drizzle-orm/bun-sqlite');
+  const sqlite = new Database('./data/omnyx.db', { create: true });
+  sqlite.exec('PRAGMA journal_mode=WAL;');
+  db = drizzle(sqlite);
+}
+```
+
+## Desktop-Bundle (Tauri)
+
+- Bun-Binary via `bun build --compile` (~50MB Single-File)
+- Tauri startet Binary als Sidecar
+- React-Frontend (produktions-Build) in Tauri-WebView
+- API auf `localhost:3001`
+
+## Mobile (Capacitor + WASM SQLite)
+
+- SQLite läuft direkt im WebView via `@libsql/client/web`
+- Drizzle-Queries identisch zum Backend
+- Kein separater Server nötig
+- Optional: Sync mit Server bei Internet-Verbindung
+
+## Docker-Deployment
+
+```yaml
+services:
+  backend:
+    build: .
+    environment:
+      DATABASE_URL: postgres://user:pass@db:5432/omnyx
+  db:
+    image: postgres:16-alpine
+```
+
+## Status (23.05.2026)
+
+| Phase | Beschreibung | Status |
+|---|---|---|
+| P1 | Backend-Projekt (Bun + Hono + Drizzle) | ✅ **Fertig** |
+| P2 | Hono-Routen (Media, Cast, Settings) | ✅ **Fertig** |
+| P3 | Tests + TypeScript-Lint | ✅ **Fertig** |
+| P4 | Docker-Config aktualisiert | ✅ **Fertig** |
+| P5 | Tauri Desktop (Bun-Sidecar) | ✅ **Fertig** |
+| P6 | PostgreSQL-Support + Deployment | ⏳ Ausstehend |
+| P7 | Sync-Logik (Hybrid) | ⏳ Optional |
+| P8 | Capacitor Mobile (lokales SQLite) | ⏳ Ausstehend |
+
+### Aktuelle Struktur
+
+```
+G:\kyoo\
+├── backend/           ← Bun + Hono + Drizzle
+│   ├── src/
+│   │   ├── index.ts           ← Hono-Server (Port 3001)
+│   │   ├── db/
+│   │   │   ├── schema.ts      ← Drizzle-Schema (9 Tabellen)
+│   │   │   ├── index.ts       ← DB-Connection (bun:sqlite / pg-fähig)
+│   │   │   └── migrate.ts     ← Auto-Migration (CREATE TABLE IF NOT EXISTS)
+│   │   ├── routes/
+│   │   │   ├── media.ts       ← CRUD /api/media
+│   │   │   ├── cast.ts        ← CRUD /api/cast + POST /adult
+│   │   │   ├── settings.ts    ← CRUD /api/settings
+│   │   │   └── images.ts      ← Proxy-/Cache-Endpunkt /api/images/proxy
+│   │   ├── lib/converters.ts  ← Type-Converter
+│   │   └── types.ts           ← API-Types
+│   ├── uploads/               ← Gecachte Bilder (offline-fähig)
+│   ├── dist-exe/              ← Compiled binary (~50MB)
+│   ├── Dockerfile             ← Bun-basiert
+│   ├── package.json
+│   └── README.md
+├── frontend/          ← React SPA + Tauri-Desktop-Shell
+│   ├── src-tauri/             ← Tauri v2 Desktop-Konfiguration
+│   │   ├── src/lib.rs         ← Sidecar-Spawn (omnyx-backend)
+│   │   ├── binaries/          ← Kompilierte Binaries pro Target
+│   │   ├── tauri.conf.json    ← Window 1280x800, externalBin
+│   │   ├── capabilities/      ← shell:default, shell:allow-spawn
+│   │   └── Cargo.toml         ← tauri-plugin-shell
+│   └── .env.tauri             ← VITE_API_URL=http://localhost:3001
+└── docker-compose.yml
+```
+
+### Nächste Schritte
+
+1. **PostgreSQL-Support** (P6) — pg-Treiber für Drizzle, docker-compose mit Postgres
+2. **Capacitor Mobile** (P8) — Android-App mit embedded SQLite via WASM
+3. **Sticky Footer Bug** — Footer klebt nicht am unteren Rand bei kurzen Seiten
+4. **PUT /api/cast/:id** um adult-Felder erweitern (height, weight etc. aktuell nicht updatbar)