Video-Produktion
Management-Plattform

1.1 Was ist XteVision Producer?

XteVision Producer (früher VidPro) ist eine vollständig offline funktionierende, selbst gehostete Video-Produktionsmanagement-Plattform, die die gesamte Werbefilm-Pipeline abdeckt — von der Kundenerkennung bis zur Auslieferung — in einem einheitlichen System. Keine externen Dienste, keine Cloud-Abhängigkeit, läuft auf lokaler Hardware.

1.2 Kernfähigkeiten

• Vollständige Pipeline-Abdeckung: Pre-Production → Production → Post-Production → Delivery → Client Management
• Client-CRM: Pipeline-Stufen (LEAD→ACTIVE), Kommunikationsprotokoll, Kontaktverwaltung
• Budget-Motor: 11 Positionskategorien, Rücklagen-Prozentsatz, geplant vs. tatsächlich, 9-Währungs-Umwandlung
• Skript- & Aufnahmesicherung: Szenenbasierter Drehbuch-Editor, 12 Aufnahmetypen, 13 Kamera-Bewegungen, Storyboard
• Produktionsplanung: Mehrtägiger Drehplaner, Crew-Anrufe (19 Rollen), Ausrüstungs-Buchung, Call Sheets
• Zeitplan & Gantt-Diagramm: Interaktive Zeitleiste aus Real-Daten mit Ziehen zum Vergrößern/Verkleinern, Abhängigkeitspfeilen, Zoom-Stufen
• Post-Produktions-Tracker: Edit/Farbe/Ton/VFX-Pipeline, Review-Runden, Picture Lock
• Auslieferung & Archiv: Mastering-Spezifikationen, Plattform-Optimierung, QC, Archiv-Verfolgung
• Rechnungsstellung: Kostenvoranschläge, Anzahlungen, Zwischen-, Schlussrechnungen mit Positionen, Steuer, Drucklayout
• KI-Assistent: Konfigurierbarer Chatbot mit Datenbankabfrage und Wettervorhersage über Tool-Calling
• Wettervorhersage: Live-Open-Meteo-Integration — Geocoding, Tagesvorhersage (Temperatur, Bedingungen, Sonnenaufgang/Sonnenuntergang), lokalisierungsaware Formatierung (EN °F, DE/ZH °C), Tagesdaten für mehrtägige Drehs
• KI-Zeitbewusstsein: System-Prompt wird automatisch mit aktuellem Serverdatum/-zeit/-Zeitzone eingefügt, um relative Daten zu lösen („heute Abend“, „morgen“, „dieses Wochenende“)
• Vollständiges i18n: Englisch, Deutsch, 中文 — über 500 Übersetzungsschlüssel pro Sprache
• Workspace-Backup: Vollständiger XLSX-Export/Import mit 34 Tabellen und FK-sicherer ID-Neuzuordnung

1.3 Zielgruppe

• Primär: Kleine bis mittlere Video-Produktionsunternehmen (2–50 Personen), die Werbefilme, Marken-Inhalte oder Dokumentationen produzieren
• Sekundär: Unabhängige Produzenten und freischreitende Produktions-Koordinatoren, die mehrere Projekte verwalten

1.4 Implementierungsstatus

Alle 5 Phasen aus dem Spec sind ab v1.8.3 (2026-07-25) implementiert. die Plattform umfasst 49 API-Routen, 14 Projekt-Tabs, 3 Sprachen, 40+ Datenbanktabellen und ein neu gestaltetes Glassmorphic-UI mit themenbarem Akzent. Alle Routen sind authentifiziert und Workspace-isoliert.

2.1 High-Level-Architektur

┌─────────────────────────────────────────────────────────────────┐
│                         Browser (Client)                         │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │              Next.js 16 (App Router)                       │  │
│  │  ┌────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ ┌──────┐  │  │
│  │  │ Auth   │ │ Dashboard│ │Project │ │ Budget │ │Script│  │  │
│  │  │        │ │          │ │ Detail │ │        │ │      │  │  │
│  │  └────────┘ └──────────┘ └────────┘ └────────┘ └──────┘  │  │
│  │  ┌────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ ┌──────┐  │  │
│  │  │ Shot   │ │ Shooting │ │Schedule │ │ Post-  │ │Invoice│  │  │
│  │  │ List   │ │ Day      │ │(Gantt) │ │Prod    │ │       │  │  │
│  │  └────────┘ └──────────┘ └────────┘ └────────┘ └──────┘  │  │
│  └───────────────────────────────────────────────────────────┘  │
└──────────────────────────────┬──────────────────────────────────┘
                               │ HTTP/REST API
┌──────────────────────────────┴──────────────────────────────────┐
│                    Next.js API-Routen (Server)                    │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌──────────────┐  │
│  │ Auth   │ │Project │ │ Budget │ │ Script │ │ AI Chat      │  │
│  │-Routen │ │ CRUD   │ │ Motor  │ │ Editor │ │ + Tool Calls │  │
│  └────────┘ └────────┘ └────────┘ └────────┘ └──────────────┘  │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌──────────────┐  │
│  │Export  │ │Upload  │ │Currency│ │  DB    │ │ Settings     │  │
│  │(XLSX)  │ │(Dateien)│ │(API)   │ │ (pg)   │ │              │  │
│  └────────┘ └────────┘ └────────┘ └────────┘ └──────────────┘  │
└──────────────────────────────┬──────────────────────────────────┘
                               │
                    ┌──────────┴──────────┐
                    │  PostgreSQL 18.4     │
                    │  xtevision_producer  │
                    │  40+ Tabellen, 14 Enums │
                    └─────────────────────┘

2.2 Kommunikationsablauf

1. Frontend → Backend: RESTful-HTTP-Anfragen an Next.js API-Routen für alle CRUD-Operationen
2. Backend → Datenbank: Rohe SQL-Abfragen über pg (Node.js-Treiber) — parametrisiert, Workspace-begrenzt
3. Backend → KI-Backend: OpenAI-kompatible API-Anfragen an MLX, Ollama, LM Studio oder OpenRouter
4. Frontend → KI: Streaming-KI-Antworten über SSE, Tool-Calls für Datenbankabfragen

2.3 Bereitstellungsmodell

XteVision Producer ist auf selbst gehosteten, vollständig offline laufenden Betrieb ausgelegt:

• Lauft als eigenständiger Node.js-Server auf Ihrer eigenen Hardware
• PostgreSQL auf localhost, Port 5432, Datenbank: xtevision_producer
• Alle Daten bleiben auf Ihrem lokalen Server — keine Cloud-Abhängigkeit

4.1 Voraussetzungen

• PostgreSQL 18.4 auf dem Ziel-Server laufend
• Node.js (für den Lauf des Standalone-Builds)
• Modern Browser (Chrome/Edge/Firefox)
• KI-Modell-Server (optional, für KI-Assistant-Funktionen)

4.2 Installation (3 Schritte)

Paket entpacken, den Ein-Befehl-Setup ausführen und die App starten. Das Setup-Skript erstellt die Datenbank, wendet das Schema an, generiert ein sicheres AUTH_SECRET und schreibt Ihre .env automatisch.

# 1. Paket entpacken
mkdir -p /opt/xtevision
cd /opt/xtevision
tar zxvf xtevision-producer-build.tar.gz -C deploy/
cd deploy

# 2. Ein-Befehl-Setup (erstellt DB, wendet Schema an, schreibt .env)
./setup.sh

# 3. App starten
sudo npm install -g pm2
pm2 start server.js --name xtevision-producer
pm2 save
pm2 startup   # folgenden Anweisungen folgen, um auf Boot automatisch zu starten

Das Setup können Sie mit Umgebungsvariablen anpassen, z. B. DB_NAME=myproducer DB_PASS=mysecret APP_PORT=8080 ./setup.sh.

4.3 Zugriff auf die Anwendung

http://dein-server-ip:3000

Die App läuft standardmäßig auf Port 3000. Um einen anderen Port zu verwenden, setzen APP_PORT beim Ausführen des Setups oder ändern PORT in .env und starten neu.

4.4 Ersteinrichtung

1. Registrieren: Erstellen Sie das erste Admin-Konto über die Login/Registrierungsseite
2. Workspace konfigurieren: Firmennamen, Standardwährung und Lokalisierung in den Einstellungen setzen
3. Team einladen: Teammitglieder über Einstellungen → Team-Verwaltung hinzufügen
4. Projekte erstellen: Mit einem Projekt-Brief und Kundeninformationen starten

4.5 Beispiel-Workspace testen

Das Paket enthält Example_Workspace.xlsx — ein vorgefertigtes Demo- Workspace mit 3 fictiven Kunden und einem vollen Projekt (Brief, Budget, Skript, Aufnahmesicherung, Drehtage, Meilensteine, Aufgaben, Rechnung, Post-Produktion, Auslieferung), plus Beispiel-Ausrüstung, Talente, Standorte, Crew und Anbieter.

Um es zu importieren und die Total Recall-Funktion in Aktion zu sehen, öffnen Einstellungen → Workspace → Import, wählen Example_Workspace.xlsx und bestätigen. Der Import weist alle IDs automatisch neu zu, so dass die Demodaten vollständig eigenständig und sicher in jeden Workspace zu importieren sind. Erkunden Sie es, ändern oder löschen dann die Demo-Einträge, um den Workspace zu Ihrem eigenen zu machen.

5.1 Verzeichnislayout

XteVision-Producer/
├── src/
│   ├── app/
│   │   ├── [locale]/
│   │   │   ├── (main)/             # Authentizierte Seiten
│   │   │   │   ├── dashboard/      # Dashboard-Statistiken + Schnellaktionen
│   │   │   │   ├── projects/       # Projektliste + Detail (14 Tabs)
│   │   │   │   ├── clients/        # Client-CRM
│   │   │   │   ├── invoices/       # Rechnungs-CRUD + Detail/Druck
│   │   │   │   ├── crew/           # Crew-Roster
│   │   │   │   ├── vendors/        # Anbieter-Verwaltung
│   │   │   │   ├── casting/        # Talente & Standorte
│   │   │   │   ├── inventory/      # Studio & Ausrüstung
│   │   │   │   ├── calendar/       # Globaler Kalender
│   │   │   │   └── settings/       # Firma, Team, Profil
│   │   │   └── (auth)/             # Login, Registrierung
│   │   └── api/                    # 49 API-Routen-Dateien
│   ├── components/                 # Geteilte UI-Komponenten
│   │   ├── ui/                     # Button, Eingabe, Paginierung, etc.
│   │   ├── projects/               # Projekt-Tabs (14 Funktionsmodule)
│   │   ├── layout/                 # Sidebar, Topbar
│   │   ├── ai/                     # Chat-Wizard-FAB + Modal
│   │   ├── budget/                 # Budget-Positionen
│   │   ├── calendar/               # Kalender-Komponenten
│   │   └── production/             # Produktionslog-Komponenten
│   ├── lib/                        # Geteilte Bibliothek
│   │   ├── db.ts                   # pg-Abfragehelfer
│   │   ├── auth.ts                 # Sitzungsverwaltung
│   │   ├── currency.ts             # Währungsumwandlung & Formatierung
│   │   ├── workspace-export.ts     # XLSX-Export-Builder
│   │   └── workspace-import.ts     # XLSX-Import-Parser
│   ├── i18n/                       # next-intl-Routing-Konfiguration
│   └── messages/                   # en.json, de.json, zh.json
├── migrations/                     # SQL-Migrationen (001–013)
├── schema.sql                      # Vollständiges PostgreSQL-Schema
├── public/                         # Statische Assets, Uploads, Favicons
└── deploy/                         # Extrahierter Standalone-Build

5.2 Projekt-Tab-Details (14)

6.1 Phase 1: Pre-Production

Planung und kreative Grundlage für jedes Projekt.

6.2 Phase 2: Production

Ausführung und Set-Management während des Drehs.

6.3 Phase 3: Post-Produktion

Schnitt, Politur und Kunden-Billigungs-Workflow.

6.4 Phase 4: Auslieferung & Verteilung

Plattform-bereite Ausgabe und langfristiges Archiv.

6.5 Phase 5: Kunden- & Projektverwaltung

Behält die Pipeline im Laufe der Zeit transparent und auf Kurs.

8.1 Authentifizierung & Workspace

Eigenes, sitzungsbasiertes Auth mit crypto.scrypt für Passwort-Hashing und signierten Sitzungs-Cookies. Jeder Nutzer gehört zu einem Workspace mit RBAC-Rollen (Admin, Producer, Crew, Client-Viewer, Accountant).

• Login/Registrierung: Email/Passwort-Authentifizierung mit Sitzungs-Cookies
• Workspace-Umschaltung: Multi-Workspace-Support für Produktionsunternehmen
• Team-Verwaltung: Mitglieder einladen, Rollen über Einstellungen → Team zuweisen
• Workspace-Izolierung: Alle Abfragen nach workspaceId gefiltert

8.2 Dashboard

Übersichtsseite mit wichtigsten Kennzahlen und Schnellaktionen:

• Statistik-Karten: Gesamtprojekte, aktive Kunden, Inventar-Elemente, anstehende Fälligkeiten
• Drehtage in den nächsten 7 Tagen über alle Projekte
• Schnellaktions-Links für gängige Aufgaben

8.3 Client-CRM

Vollständige Kunden-Beziehungsverwaltung mit Pipeline-Stufen:

• Pipeline-Stufen: LEAD → QUALIFIED → PROPOSAL → NEGOTIATION → ACTIVE
• Kunden-CRUD mit Kontaktinformationen, Firmeninformationen, Kommunikations-Historie
• Kommunikations-Log verknüpft mit jedem Kunden
• Projekt-editierte Kundenfelder mit Upsert-Logik

8.4 Budget-Motor

Interaktive Budgetierung mit umfassenden Finanzkontrollen:

• 11 Kategorien: CREW, TALENT, GEAR, LOCATION, TRAVEL, POST-PRODUCTION, MUSIC, INSURANCE, LEGAL, CONTINGENCY, MISC
• Kategorien-getriebene Dropdowns: CREW/TALENT/GEAR-Auswahlen werden automatisch aus realen DB-Daten mit Satz- und Einheitspreisen aufgefüllt
• Mehrfach-Währung: 9 Währungen (USD, CNY, EUR, GBP, HKD, CAD, NZD, AUD, SGD) mit live Frankfurter-API-Rates
• Rücklagen-Prozentsatz: Automatisch berechneter Rücklagen-Prozentsatz auf Zwischensumme
• Geplant vs. tatsächlich: Budget-Adjazenz verfolgen
• Nur-Anzeige-Umwandlung: Umschalten der Währung berechnet Totale sofort neu; Originalwerte erhalten

8.5 Skript-Editor

Szenenbasierte Drehbuch-Verwaltung:

• Szenen-CRUD mit Metadaten (Zeichen, Requisiten, Standort, Szenennummer)
• Status-Workflow: Entwurf → In Review → Genehmigt → Gesperrt
• Aufnahmesicherung aus Szenen automatisch generieren

8.6 Aufnahmesicherung

Umfassende Aufnahme-Planung mit industriestandard-Optionen:

• 12 Aufnahmetypen: Close-Up, Medium, Wide, Extreme Wide, Over-the-Shoulder, POV, Two-Shot, Insert, Cutaway, Tracking, Crane, Aerial
• 13 Kamera-Bewegungen: Pan, Tilt, Dolly In/Out, Truck Left/Right, Pedestal Up/Down, Zoom In/Out, Rack Focus, Handheld, Steadicam, Gimbal
• 11 Objektive: 18mm, 24mm, 35mm, 50mm, 85mm, 100mm, 135mm, 200mm, 24-70mm, 70-200mm, 100-400mm
• Template aus Szenen automatisch generieren
• Clientseitige Paginierung (10/25/50/100)

8.7 Storyboard

Visuelle Aufnahme-Planung mit Bild-Uploads:

• Visuelles Grid mit Ziehen zur Neuanordnung
• Serverseitiger Bild-Upload (dateibasiert, nicht base64) — hebt Body-Größen-Limits auf
• Tempus-Zeitleiste-Übersicht
• Szenennummer-Badge („Sc N“) in Informationssektion angezeigt
• Aufnahmesicherung ↔ Storyboard-Sync: sceneId über Speicherungen erhalten

8.8 Drehtag-Planer

Mehrtägige Produktionsplanung mit vollständiger Ressourcen-Verwaltung:

• Mehrtägige Unterstützung: startDate + endDate (Migration 010), Inkrement-Datum
• 19 Crew-Rollen: Regisseur, DP, 1st AD, 2nd AD, Sound Mixer, Gaffer, Key Grip, Production Designer, Script Supervisor, Makeup, Wardrobe, BTS, Stills, Data Wrangler, DIT, Set PA, Production Coordinator, Craft Service, Medic
• Crew-Dropdown: Aus Crew-Roster auswählen mit Auto-Fill-Rolle
• Ausrüstungs-Buchung: Pro Drehtag-Ausrüstungs-Buchung aus Inventar
• Szenen-Zuteilung: Szenen an Drehtage knüpfen für Planung
• Abhängigkeits-Tracking: „Depends On“-Dropdown für Drehtag-Reihenfolge
• Kalender-Integration: Mehrtägige Drehs erstrecken sich über alle Tage im Bereich

8.9 Call Sheet

Druckbares Produktionsdokument aus Drehtag-Daten generiert:

• Crew-Mitglieder nach Anrufzeit sortiert
• Standort-Details, Ausrüstungsliste, Szenen-Zeitplan
• Druck-CSS verbirgt Sidebar/Topbar für saubere Ausgabe

8.10 Kalender & Zeitplan

Zwei ergänzende Views für Produktions-Zeitplan-Verwaltung:

Kalender

• Projektbezogener Monatsview + globaler Kalender, der alle Projekte aggregiert
• Mehrtägige Aufnahmeererstrecken sich über alle Tage im Bereich
• Farblich je Projekt im globalen View kodiert
• Anklickbare Ereignisse → Navigation zu Drehtagen/Zeitplan-Tab
• Aggregiert Meilensteine über Projekte

Zeitplan (Gantt-Diagramm)

• Real-Daten-getrieben: Bezieht sich auf ShootingDay-, Milestone- und Task-Tabellen
• Ziehen zum Verschieben/Vergrößern Balken mit Datum-Persistenz (PATCH-API)
• Monats/Wochen/Tag-Zoom-Stufen
• Orthogonale 90°-Abhängigkeitspfeile mit Rechtsklick-Kontextmenü
• localStorage-First-Persistenz stellt sicher, dass Pfeile Tab-Umschaltungen überstehen
• Zusammengefasste Phasen-Zusammenfassung-Balken zeigen versteckte Ereignis-Bereiche
• Doppelklick auf ein beliebiges Ereignis zur Navigation zu seinem Edit-Tab

8.11 Produktionslog

Set-Dokumentation mit 4 Untersektionen:

• Tagesbericht: Allgemeine Produktions-Notizen pro Tag
• Kamera-Log: Multi-Cam-Tracking (A–D) mit Medien-Details
• DIT-Log: Checksumme-Verifikation, Karten-Offload-Tracking
• Kontinuitäts-Notizen: Script-Kontinuitäts-Tracking

8.12 Post-Produktions-Tracker

End-to-End-Post-Produktions-Pipeline:

• Schnitt-Workflow: Nicht gestartet → Grobschnitt → Feinschnitt → Picture Lock
• Lock/Unlock mit Timestamp-Tracking
• Farbgebung: Kreative Look-Notizen, Marken-Konsistenz-Checks
• Ton-Design: Foley/Ambience/ADR-Tracking, Musik-Lizenzierung
• VFX: Compositing, Titel, Lower-Thirds, Animations-Aufgaben-Tracking
• Kunden-Review-Runden: Revisions-Runden mit Status und Feedback

8.13 Auslieferungs-Tracker

Endausgabe-Spezifikationen und Verteilung:

• Codec/Auflösung/Bildrate/Lautheits-Standards-Auswahl (-24 LUFS Broadcast)
• Plattform-Optimierung: Mehrfach-Auswahl von Seitenverhältnissen (16:9, 9:16, 1:1, Cinema)
• Untertitel-Sprachen-Konfiguration
• QC-Pass/Fail-Umschalter mit Auslieferungs-Datums-Tracking
• Archiv-Pfad und Auslieferungs-Notizen

8.14 Meilensteine & Aufgaben

Projekt-Verwaltung mit Abhängigkeits-Tracking:

• Meilensteine: Fälligkeitsdaten, Status (Ausstehend/In Arbeit/Abgeschlossen/Gesperrt), Phasenzuteilung
• Aufgaben: Titel, Status, Priorität (Niedrig→Dringend), Fälligkeitsdatum, Zugewiesener, Phase
• Abhängigkeits-Tracking für Meilensteine und Aufgaben
• Fertstellungs-Zähler je Phase
• Clientseitige Paginierung

8.15 Kommunikations-Log

• E-Mail/Telefon/Sitzung/Notiz-Einträge pro Kunde
• Auf einzelne Projekte beschränkt
• Clientseitige Paginierung

8.16 Rechtliche Freigaben

• 5 Freigabe-Typen: Talent, Location, Music, Photo, General
• Jetzt-Signieren mit Timestamp + Dokument-Hash-Audit-Trail
• Clientseitige Paginierung

8.17 Rechnungsstellung

• Rechnungs-Typen: Kostenvoranschlag, Anzahlung, Zwischen, Schluss
• Positionen mit Steuer-Handling
• Status-Workflow: DRAFT → SENT → PAID
• Detail-Ansicht mit Drucklayout (A4, verbirgs Sidebar/Topbar)
• Mehrfach-Währungs-Unterstützung

8.18 Crew, Anbieter, Casting & Standorte

8.19 Studio & Ausrüstung (Inventar)

• 12 Ausrüstungs-Kategorien: Kameras, Aufnahmemedien, Ausrüstung, Objektive, Drohnen, Dolly & Tracking, Slider, Gimbals, Beleuchtung, Grip & Rigging, Standortspezifisch, Misc
• Zustands-Tracking (Neu/Gut/Mäßig/Schlecht)
• Pro Drehtag-Ausrüstungs-Buchung
• Inline-Edit/Lösch je Element
• Clientseitige Paginierung

8.20 Einstellungen

• Firma-Profil: Firmennamen, Standardwährung, Lokalisierung
• Team-Verwaltung: Workspace-Mitglieder mit Rollen, Einladungs-Workflow
• Nutzer-Profil: Name, Email, Passwort, Lokalisierung
• Backup & Wiederherstellung: XLSX-Export/Import (nur Admin/Producer)
• KI-Konfiguration: Backend-URL, Modell, System-Prompt

9.1 KI-Chat-Wizard

Floatender KI-Assistant auf allen Seiten:

• FAB-Schaltfläche: Fixe Position unten rechts, auf allen Seiten sichtbar
• Ziehbarer Modal: Kopfzeile greifen, auf Desktop neu positionieren
• Skalierbarer Modal: Unten-rechte Handhabe, 360×400 Mindestgröße
• Konfigurierbares Backend: MLX, LM Studio, Ollama, Copilot, OpenRouter
• Benutzerdefiniertes System-Prompt: Pro Workspace in Einstellungen setzen
• Powered-by-Footer: Zeigt aktuelles Backend + Modell
• Chat zurücksetzen: Refresh-Icon zum Löschen der Unterhaltung

9.2 KI-Datenbank-Tool-Calling

Der KI-Wizard kann direkt in die PostgreSQL-Datenbank des Workspace abfragen:

• OpenAI-kompatible Tools: Verwendet tools/tool_calls-Protokoll
• query_database-Tool: Nur-SELECT mit Sicherheitsprüfungen — DDL/DML blockiert
• 200-Zeilen-Limit: Verhindert übermäßige Datenabfrage
• 10-Sekunden-Zeitlimit: Verhindert lang laufende Abfragen
• Vollständige DB-Schema-Bewusstsein: System-Prompt automatisch mit 43 Tabellen-Schemata erweitert
• Workspace-Izolierung: Abfragen injizieren automatisch workspaceId als Parameter
• Max 10 Runden: Verhindert Endlos-Tool-Calling-Schleifen

9.3 KI-Wetter-Tool-Calling

Der KI-Wizard kann über die Open-Meteo-API live Wettervorhersagen abrufen:

• get_weather_forecast-Tool: Geocodiert Stadtnamen zu Koordinaten, ruft Tagesvorhersage ab
• Gibt zurück: Temperatur (max/min), Wetterbedingungen, Sonnenaufgang/Sonnenuntergang-Zeiten
• Lokalisierungsaware Formatierung: EN in °F mit 12-Stunden-Zeit, DE/ZH in °C mit 24-Stunden-Zeit
• Relative-Daten-Auflösung: System-Prompt enthält aktuelle Serverzeit — KI löst „heute Abend“, „morgen“, „dieses Wochenende“ korrekt
• Quellen-Attribution: Jede Antwort enthält „Daten: Open-Meteo (api.open-meteo.com)“ und die technische API-Endpunkt-URL
• Datenquelle: Kostenlose Open-Data-REST-API, kein API-Schlüssel erforderlich

9.4 Unterstützte KI-Backends

10.1 Voraussetzungen

• Node.js v20+
• PostgreSQL v14+
• pm2 (optional, aber empfohlen) — sudo npm install -g pm2

10.2 App starten

cd /opt/xtevision/deploy
pm2 start server.js --name xtevision-producer
pm2 save
pm2 startup   # folgenden Anweisungen folgen, um auf Boot automatisch zu starten

Ohne pm2, rufen Sie ./start.sh direkt auf, oder halten Sie es im Hintergrund mit nohup ./start.sh > app.log 2>&1 &.

10.3 Umgebungsvariablen

Diese werden automatisch in .env von setup.sh geschrieben. .env ändern, um sie zu ändern, dann die App neu starten.

10.4 Auf eine neue Version upgraden

pm2 stop xtevision-producer
cp .env /tmp/xv-env.bak
cp -r uploads /tmp/xv-uploads.bak
rm -fr deploy && mkdir deploy
tar zxvf xtevision-producer-build.tar.gz -C deploy/
cp /tmp/xv-env.bak deploy/.env
cp -r /tmp/xv-uploads.bak deploy/uploads
pm2 start xtevision-producer

Wenden Sie dann etwaige neue Datenbank-Migrationen an, die im Paket enthalten sind:

cd deploy
for f in migrations/*.sql; do
  echo "Wendet $f an"
  psql "$(grep DATABASE_URL .env | cut -d'=' -f2- | tr -d '"')" -f "$f"
done

11.1 Routen-Übersicht

Alle 49 API-Routen sind authentifiziert und Workspace-begrenzt. Jede Route ruft requireAuth() auf und filtert Abfragen nach workspaceId.

v1.8.3 — 2026-07-25

• Glassmorphic-UI-Neugestaltung: Vollständiger visueller Überholung inspiriert von DRYL Components — transluzente Glas-Oberflächen, backdrop-blur, themenbare Akzent-Gradients (7 Presets + benutzerdefinierte Farben).
• Themen-System: Einstellungen → Themen-Tab mit Akzent-Farbwähler (Nebula, Ember, Verdant, Mono, Ocean, Cherry, Midnight), benutzerdefinierte Hex-Farben und Licht/Dunkel/System-Modus-Umschalter. In localStorage gespeichert.
• Aurora-Ambient-Glow: Langsam-driftende, akzent-farbene Hintergrund-Kugeln (Violett + Cyan) durch Glas-Oberflächen sichtbar.
• Kompakte Formular-Felder: Alle Eingaben, Dropdowns, Textareas und Buttons auf 12px mit engerem Padding für einen dichteren, professionellen Look reduziert.
• Help-Handbuch: Help-Icon öffnet jetzt das Handbuch in einem neuen Browser-Tab statt eines Inline-Modals, um Safari-Positionierungs-Probleme mit fixed Overlays zu vermeiden.
• Drehtag-Faltbar: Jeder Drehtag-Karte ist jetzt kollabierbar (Kopfzeile klicken zum Umschalten), passend zum Skript- und Aufnahmesicherung-Muster.
• Settings-Tabs scrollbar: Tab-Leiste scrollt jetzt horizontal auf schmalen Bildschirmen — Themen-Tab auf iPhone zugänglich.
• Version-Bump: v1.0.2 → v1.8.3

v1.0.2 — 2026-07-15

• KI-Chat — Zeitbewusstsein: System-Prompt automatisch mit aktuellem Serverdatum/-zeit/-Zeitzone eingefügt. KI löst jetzt relative Daten („heute Abend“, „morgen“, „dieses Wochenende“) für Wetter-Abfragen und Fälligkeiten.
• Wetter-Quellen-Attribution: Jede Wetter-Antwort enthält „Daten: Open-Meteo (api.open-meteo.com)“ und die technische API-Endpunkt-URL. Kalender-View zeigt „Wetter: Open-Meteo“-Footer.
• Tages-Wetterdaten: Mehrtägige Drehtage speichern Tagesvorhersagen in der neuen weatherData-JSONB-Spalte (Migration 024). Kalender zeigt jetzt richtiges Wetter für jedes einzelne Datum, nicht nur das erste Tagesdaten.
• Wetter-Tool-Calling: KI-Wizard kann über get_weather_forecast-Tool live Wettervorhersagen abrufen. Geocoding + lokalisierungsaware Formatierung mit Quellen-Attribution.
• Help-Handbuch: Top-Bar-Help-Icon (?) öffnet das Technische Handbuch in einem vollbildigen Modal. Handbuch-Text wird aus public/XteVision_Producer_Manual.html bedient.
• Datenbank-Nutzer-Änderung: Von postgres auf dedizierter producer-Rolle migriert (Migration 023).
• Wetter-Dokumentation: Wettervorhersage und KI-Wetter-Tool-Calling zu docs/overview.md und docs/how-to.md hinzugefügt.
• Version-Bump: v1.0.1 → v1.0.2

v1.0.1 — 2026-07-11

• Workspace-Backup (XLSX-Export/Import): Vollständiger Workspace-Export nach Excel (.xlsx) mit 34 Tabellen in FK-sicherer Reihenfolge. Import erstellt alle Datensätze mit neuen UUIDs, erhält Beziehungen über ID-Neuzuordnung und erstellt Platzhalter-Nutzer-Konto für Workspace-Mitglieder. Zugänglich über Einstellungen → Backup & Wiederherstellung.
• Neue Abhängigkeit: xlsx (SheetJS) — rein JS, architektur-agnostisch
• Neue Routen: GET /api/workspaces/[id]/export, POST /api/workspaces/import

v0.9.0 — 2026-07-10

• Live-Währungs-Umwandlung: Budget-Seite wandelt alle Positionen sofort um mit live Frankfurter-API-Rates. 9 Währungen (USD, CNY, EUR, GBP, HKD, CAD, NZD, AUD, SGD). Zentralisierter src/lib/currency.ts. Nur-Anzeige-Umwandlung — Originalwerte erhalten.
• Neue Route: GET /api/currency/rates mit 6-Stunden-Serverseitigem-Caching
• Settings-Seiten-Währung-Dropdown auf 9 Währungen erweitert
• Crew, Casting und Inventory-Seiten verwenden zentralisierte Währungs-Formatierung

v0.7.0 — 2026-07-09

• KI-Datenbank-Tool-Calling: KI-Wizard fragt PostgreSQL über query_database-Tool ab. Nur-SELECT, 200-Zeilen-Limit, 10s-Zeitlimit, vollständiges DB-Schema-Bewusstsein, Workspace-isoliert.
• Zeitplan (Gantt-Diagramm): Von „Gantt-Diagramm“ zu „Zeitplan“ umbenannt. Real-Daten aus ShootingDay/Milestone/Task. Ziehen zum Verschieben/Vergrößern, Abhängigkeitspfeile, Zoom-Stufen, localStorage-First-Persistenz.
• Mehrtägige Drehtage: startDate + endDate-Unterstützung, Inkrement-Datum, Kalender-Mehrtags-Span.
• Abhängigkeits-Tracking: Meilensteine, Aufgaben, Drehtage unterstützen alle dependsOn.
• Clientseitige Paginierung: Zu 10 Tabs hinzugefügt (Skript, Aufnahmesicherung, Storyboard, Drehtage, Produktionslog, Meilensteine & Aufgaben, Kommunikations-Log, Freigaben, Studio & Ausrüstung, Auslieferung).
• Storyboard-Bild-Fix: serverseitiges Bild-Upload ersetzt base64-Speicherung.
• Aufnahmesicherung ↔ Storyboard-Sync: sceneId erhalten, Szenennummer-Badge angezeigt.

v0.5.0 — 2026-07-07

• Branding-Überholung: XteVision-Logo, App zu „Producer“ umbenannt, Version + Footer-Copyright.
• Gantt-Diagramm: Interaktives Timeline mit 4 Phasen, 29 Standard-Aufgaben, Abhängigkeits-Ketten, SVG-Pfeile.
• Vollständiges CRUD: Projekt-Edit/Lösch-Modal, Inline-Edit/Lösch-Inventar, Workspace-Danger-Zone-Lösch.
• Inventar zu „Studio & Ausrüstung“ umbenannt.
• Kalender-Verknüpfung: Drehtage anklickbar → Navigation zum Zeitplan-Tab.

v0.4.0 — 2026-07-05

• Alle 5 Phasen abgeschlossen — volle Pipeline von Briefing bis Auslieferung.
• Post-Produktions-Tracker, Auslieferungs-Tracker, Meilensteine & Aufgaben, Kommunikations-Log, Rechtliche Freigaben.
• Globaler Kalender, Dashboard-Fälligkeiten, Crew-Dropdown, Rechnungs-Druck-CSS.
• Sicherheits-Audit: 7 Handler mit fehlender Workspace-Izolierung gefixt.
• ~120 neue i18n-Schlüssel über EN/DE/ZH.

v0.3.0 — 2026-07-05

• Produktionslog (4 Untersektionen), Storyboard-View, Ausrüstungs-Buchung, Crew-Call-Sheet, Szenen-Zuteilung.
• Migrationen 006–008 für Bild-Aufnahmen, Szenen-Planung, Produktions-Phase.

v0.2.5 — 2026-07-04

• Auslieferungs-System, Crew- & Anbieter-Verwaltung, Casting & Standorte, Inventar-Verwaltung, Settings-Seite.

v0.2.0 — 2026-07-03

• Prisma entfernt, ersetzt mit pg (rohe SQL). Sitzungsbasiertes Auth mit crypto.scrypt.
• Auth-Daten-Migration für bestehende Workspace-Datsätze.

v0.1.5 — 2026-07-02

• Aufnahmesicherungs-Generator, Drehtag-Planer, Kalender-View, Client-CRM, i18n vollständig (EN/DE/ZH).

v0.1.0 — 2026-07-01

• Projekt-Scaffolding (Next.js 16, Tailwind v4, TypeScript 5.9), Auth-System, Dashboard, Projekt-Verwaltung, Budget-Motor, Skript-Editor, Datenbank-Schema, Cross-Build-Pipeline.

v0.0.0 — 2026-07-01

• Initielles Projekt-Scaffolding aus dem spec-first-Workflow erstellt. Spec-Dokument: vidpro-spec.md über alle 5 Produktionsphasen.

13.1 Server startet nicht

• Problem: EADDRINUSE-Fehler auf dem konfigurierten Port
• Lösung: Den bestehenden Prozess mit kill $(lsof -ti:3000) töten (Ihren Port verwenden) oder PORT in .env ändern.

13.2 Datenbank-Verbindung fehlgeschlagen

• Problem: „Connection refused“ zu PostgreSQL
• Lösung: Prüfen, ob PostgreSQL läuft: systemctl status postgresql. DATABASE_URL in .env prüfen. Stellen Sie sicher, dass die xtevision_producer-Datenbank existiert. ./setup.sh erneut ausführen, um Rolle/Datenbank zu fixen.

13.3 Daten nach Auth nicht sichtbar

• Problem: Alle Seiten nach Login leer
• Lösung: Jedes Konto hat seinen eigenen Workspace. Wenn Sie Daten sehen wollten, stellen Sie sicher, dass Sie im richtigen Workspace angemeldet sind (umschalten über den Workspace-Menü).

13.4 pm2 nicht gefunden

• Problem: Command 'pm2' not found
• Lösung: Mit sudo npm install -g pm2 installieren. Wenn npm nicht verfügbar ist, die App direkt mit ./start.sh oder nohup ./start.sh > app.log 2>&1 & laufen lassen.

13.5 Storyboard-Bilder werden nicht angezeigt

• Problem: Bilder nach dem Speichern fehlend
• Lösung: Prüfen, ob das uploads/<projectId>/-Verzeichnis existiert und Schreibberechtigungen hat. Prüfen, ob die Upload-API-Route funktioniert.

13.6 KI-Chat antwortet nicht

• Problem: „Connection refused“ oder keine Antwort von KI
• Lösung: Stellen Sie sicher, dass der KI-Backend-Server auf dem konfigurierten Host/Port läuft. Prüfen Sie Backend-URL und Modelleinstellungen in Einstellungen → KI-Konfiguration.

13.7 Währungs-Rates laden nicht

• Problem: Budget-Spinner löst nie auf
• Lösung: Internet-Verbindung prüfen (Frankfurter-API erfordert Internet). Der serverseitige 6-Stunden-Cach bedient veraltete Rates bei Fetch-Fehler.