Deine Video-Fabrik erklärt

Was hier eigentlich läuft

Zeitsplitter ist ein YouTube-Kanal mit kurzen Geschichtsvideos — „1588: Der Sturm, der Spanien stoppte“, „Wien 1683“, „Nancy 1477“. Jedes ist etwa 60 Sekunden lang, hochkant, mit Bildern, Erzählstimme und Musik.

Das Besondere: Niemand schneidet diese Videos. Kein Mensch sucht Bilder aus, spricht den Text ein oder lädt etwas hoch. Das erledigt eine Kette von Programmen — vollautomatisch, jede Nacht.

Stell dir eine Zeitungsredaktion vor

Nachts, wenn alle schlafen, arbeitet eine kleine Crew: Die Redakteurin sucht ein Thema. Der Autor schreibt den Text. Die Bildredaktion besorgt Fotos. Die Druckerei setzt alles zusammen. Am Morgen liegt die Zeitung am Kiosk.

Genau so ist dein System gebaut — nur dass jede dieser Rollen ein Stück Software ist.

Der Moment, in dem alles beginnt

Um 6:00 Uhr UTC passiert etwas sehr Unspektakuläres: Eine Uhr schlägt. Genauer gesagt: ein Cron-Job feuert und startet ein Programm namens Orchestrator.

Diese fünf Zeichen sind eine Zeitangabe: Minute, Stunde, Tag, Monat, Wochentag. Ein Stern heißt „jeder“. 0 6 * * * heißt also: Minute 0, Stunde 6, an jedem Tag.

Die Reise eines Videos

Klick dich einmal durch. Das ist der komplette Weg von „es gibt noch nichts“ bis „das Video steht auf YouTube“.

Wie ein Video „weiß“, wo es gerade steht

Jedes Video ist eine Zeile in einer Tabelle. Und diese Zeile hat ein Feld, das alles steuert: production_status.

Der Monitor liest alle 6 Stunden diese Zeilen und fragt bei jeder: Muss ich hier etwas anstoßen? So sieht das im echten Code aus:

const { id, production_status, idea } = prod;
const status = (production_status || '').toLowerCase().trim();

Kurz nachgedacht

Ein Filmteam, das nie schläft

Bei einem Filmdreh macht niemand alles gleichzeitig. Es gibt eine Regie, eine Kamera, einen Schnitt, einen Verleih. Jeder beherrscht sein Handwerk — und keiner mischt sich in die anderen ein.

Dein System ist genau so besetzt. Lern die sechs kennen, dann verstehst du jede Fehlermeldung schneller.

Wo wohnt wer?

Alle sechs laufen auf einem einzigen Server, den du gemietet hast. Manche in eigenen abgeschotteten Bereichen, sogenannten Containern.

Hör den dreien beim Arbeiten zu

So klingt es, wenn LARZ prüfen will, ob ein Video fertig ist. Klick dich durch das Gespräch.

Wie LARZ die Tabelle fragt

Drei kurze Befehle — mehr braucht es nicht, um mit der Datenbank zu reden.

async function readAll(tab) {
  return asArray(await gateway({ op: 'getAll', tab }));
}

async function readRow(tab, matchField, matchValue) {
  const rows = asArray(await gateway({ op: 'getRow', tab, matchField, matchValue }));
  return rows[0];
}

Kurz nachgedacht

Ein Problem, das du nicht siehst

In alten Bürohäusern gab es Rohrpost: Man steckte einen Zettel in eine Kapsel, warf sie in ein Rohr, und Druckluft schoss sie in die richtige Abteilung. Der Absender sah den Empfänger nie.

Genau dieses Problem haben deine Programme. Sie laufen in getrennten Containern und können sich nicht direkt „anfassen“. Sie brauchen Rohre.

Die fünf Rohre deines Systems

Jede Produktionsstufe hat ihre eigene Adresse. Diese Liste ist im Alltag Gold wert.

Ein Auftrag auf seinem Weg

Verfolge, was passiert, wenn LARZ ein Video rendern lassen will. Fünf Stationen, ein winziges Datenpaket.

Der Trick mit dem Zwischenstecker

Früher lagen alle Daten in einer Google-Tabelle. Heute in einer Datenbank auf deinem Server. Das ist ein kompletter Umbau — trotzdem musste kaum ein Skript umgeschrieben werden.

Der Grund: ein Adapter, der sich nach außen genau so verhält wie die alte Tabelle.

const GW_HOST = process.env.N8N_DATA_HOST || 'n8n';
const GW_PORT = parseInt(process.env.N8N_DATA_PORT || '5678', 10);
const GW_PATH = process.env.N8N_DATA_PATH ||
  '/webhook/LARZDataGateway01/webhook/data-gateway';

Kurz nachgedacht

Wenn du einsteigst, läuft die Uhr

In einem Taxi zahlst du nicht für das Auto, sondern für die gefahrenen Kilometer. Steht es, kostet es fast nichts. Fährt es, tickt der Zähler.

Genau so funktionieren die Dienste, die dein System benutzt. Und der teuerste Zähler läuft beim Bildermalen.

Welcher Status welche Rechnung auslöst

Das ist die praktisch wichtigste Tabelle des ganzen Kurses. Ein Status ist kein Etikett — er ist ein Auslöser.

Was ein Schlüssel ist — und warum er wehtut

Damit kie.ai weiß, wem es die Rechnung schickt, schickt dein System bei jeder Anfrage einen API-Schlüssel mit. Ein langes Passwort für Maschinen.

So sieht ein sauberer Zugriff aus

// Credentials kommen aus credentials.yaml (ausserhalb des Repos).
const creds = yaml.parse(fs.readFileSync('…/credentials.yaml', 'utf8'));

const auth = new google.auth.JWT(
  creds.google.client_email, null,
  creds.google.private_key.replace(/\\n/g, '\n'),
  ['https://www.googleapis.com/auth/spreadsheets.readonly']
);

Kurz nachgedacht

Der Tag, an dem es peinlich wurde

Im Juli tauchten auf dem Kanal plötzlich Videos doppelt auf. Dieselbe Geschichte, zweimal hochgeladen — nur mit unterschiedlichen Titeln, weil die KI jedes Mal einen neuen erfand.

Das Tückische: Es war kein Absturz. Jeder einzelne Upload war technisch erfolgreich. Das System tat exakt, was man ihm gesagt hatte — nur eben mehrfach.

Ein Türsteher mit Gästeliste

Vor einem gut geführten Club steht jemand mit einer Liste. Wer schon drin ist, kommt nicht nochmal rein — egal wie oft er sich anstellt. Der Türsteher fragt nicht, warum jemand nochmal will. Er schaut auf die Liste und sagt Nein.

Genau das fehlte deinem Upload-Ablauf. Es gab keine Liste. Jeder, der klopfte, kam rein.

Die Liste des Türstehers

Er prüft zwei Dinge. Wenn eines davon zutrifft, ist Schluss.

String($json.publishing_status || "").toLowerCase().includes("uploaded")
|| String($json.youtube_video_id || "").trim() !== ""

Finde den Fehler

Hier ist eine erfundene Version des Türstehers — mit einem Denkfehler. Klick auf die Zeile, die das Problem verursacht.

Was „BLOCKED“ bedeutet

Seit dem Umbau antwortet der Ablauf in so einem Fall mit einem klaren Satz statt mit einem Upload:

Das ist keine Fehlermeldung. Das ist der Türsteher, der seinen Job macht. Wer das für einen Fehler hält und „repariert“, indem er die Felder leert, baut den ursprünglichen Bug eigenhändig wieder ein.

Kurz nachgedacht

Wenn niemand mehr fährt

Stell dir eine Kreuzung ohne Ampel vor. Vier Autos kommen gleichzeitig an, jedes will links abbiegen, jedes wartet auf das andere. Niemand hat einen Unfall. Niemand macht etwas falsch. Trotzdem bewegt sich nichts — für immer.

Das ist ein Deadlock — und genau der hat deine Videoproduktion tagelang lahmgelegt.

Die Wächter-Uhr, die nie klingelte

Für solche Fälle gab es bereits einen Wachhund: Passiert fünf Minuten lang nichts, brich ab und versuch es neu.

Er löste nie aus. Und der Grund dafür ist die eigentliche Lehre dieses Moduls.

Die Reparatur

Zwei Änderungen. Die erste beseitigt die Blockade, die zweite macht den Wachhund ehrlich.

command = command.outputOptions(["-filter_complex_threads", "1", "-threads", "1"]);

// Only treat as activity if the encode position actually advanced.
if (progress && progress.timemark) {
  const tp = String(progress.timemark).split(":");
  const secs = (parseInt(tp[0])||0)*3600 + (parseInt(tp[1])||0)*60 + (parseFloat(tp[2])||0);
  if (secs > (lastProgressSec || 0)) { lastProgressSec = secs; lastActivity = Date.now(); }
}

Vier Fehler, vier Fragen

Alle vier sind in diesem Projekt wirklich passiert. Präg dir die Fragen ein — sie sparen dir Stunden.

Kurz nachgedacht

Von der Mietwohnung ins eigene Haus

In einer Mietwohnung ist vieles bequem: Der Hausmeister kümmert sich, du zahlst monatlich, kein Aufwand. Aber du darfst keine Wände versetzen, die Miete steigt, und wenn der Vermieter kündigt, musst du raus.

Genau so verhält sich die Cloud zu einem eigenen VPS. Ein eigenes Haus ist mehr Arbeit — aber alles darin gehört dir.

Was beim Umzug nicht weggeworfen wurde

Die alte Wohnung steht noch — leer, aber möbliert. Alle alten Abläufe sind abgeschaltet, aber nicht gelöscht.

await sheets.spreadsheets.values.clear({ spreadsheetId: SHEET_ID, range: `${tab}!A:Z` });
await sheets.spreadsheets.values.update({
  spreadsheetId: SHEET_ID,
  range: `${tab}!A1`,
  valueInputOption: 'RAW',
  requestBody: { values: data }
});

Das ganze Bild

Alles, was du in sechs Modulen kennengelernt hast, auf einen Blick.

Kurz nachgedacht