Clipador: vídeo final sem camadas de teste ao aprovar; publicação só usa o final

Pedido do dono: o vídeo da fila é de revisão (com as camadas `dev`, ex.: tradução);
ao aprovar, o serviço renderiza de novo sem elas, e só esse vai para as redes.

- db v14: clips.review_dev_json (camadas que entraram na revisão) e final_status/
  final_file/final_thumb/final_cover/final_error/final_at; backfill dos cortes antigos.
- Motor: queue_final/drop_final/render_final; fila renderiza finais primeiro com
  render_clip_edit(dev=False) em clip-<id>-final.mp4; revisão sem camada de teste
  vira o final sem render novo; prune guarda os blocos de quem ainda precisa do final.
- API: clip traz review.devLayers, final e publishFile; aprovar enfileira o final;
  desaprovar, mudar trecho, exportar, re-render e rejudge derrubam o final;
  POST /v1/clips/{id}/final (tentar de novo).
- Painel: etiqueta na lista, player Final/Revisão e estado do final no modal
  (gerando/pronto/erro com "Tentar de novo"), aviso no "Publicar"; o despachante
  relê o corte antes de enviar e espera o final (clipPublishFile), nunca a revisão.
- Testes: clipper/tests/test_final_render.py e testes do despachante no painel.
- Doc: doc/clipador/REVISAO.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Mateuus
2026-11-18 03:27:26 -03:00
co-authored by Claude Opus 5.5
parent 54eac7cebf
commit dc0917b114
16 changed files with 819 additions and 23 deletions
+41 -8
View File
@@ -19,9 +19,9 @@ import { ServiceError } from "./http";
import { REPO_ROOT, SERVABLE_ROOTS, resolveInside, storyDir } from "./paths";
import { cancelJob, createJob, getJob, profileIdFor, publisherStatus, type PublisherJob } from "./publisher";
import {
OCCUPYING, UNSENT, aiGeneratedFor, clientRefFor, isDue, jobActions, mayBeLive, needsReflow, parseVideoUrl, placeJob, planClipSync, readPublisherJob,
OCCUPYING, UNSENT, aiGeneratedFor, clientRefFor, clipPublishFile, isDue, jobActions, mayBeLive, needsReflow, parseVideoUrl, placeJob, planClipSync, readPublisherJob,
sendBlocker, tagsFromCaption,
type ClipAction, type ClipInfo, type ClipTarget, type ExistingJob,
type ClipAction, type ClipInfo, type ClipTarget, type ClipVideo, type ExistingJob,
} from "./publishing-rules";
import { autoCollectMetrics } from "./metrics-sync";
import { getSettings } from "./settings";
@@ -197,8 +197,14 @@ export function placeApproved(jobId: number, opts: {
type ClipView = {
id: number; status: string; channelId: string | null; createdAt: string; title: string; caption: string;
file: string | null; thumb: string | null; edit: { cover: string | null } | null;
/** Vídeo final (sem as camadas de teste do vídeo de revisão): só ele vai para as redes. doc/clipador/REVISAO.md */
publishFile?: ClipVideo["publishFile"];
final?: (NonNullable<ClipVideo["final"]> & { cover: string | null }) | null;
};
/** Arquivo que fica no job: o final, se já existe; senão o de revisão só como referência — `sendDue` troca pelo final. */
const jobFileOf = (clip: ClipView) => clip.publishFile ?? clip.file;
async function fetchClip(clipId: number): Promise<ClipView | null> {
const response = await clipperFetch(`/v1/clips/${clipId}`, {}, 15_000);
if (response.status === 404) return null;
@@ -479,7 +485,7 @@ export async function publishClip(clipId: number, input: { accountId?: unknown;
if (!existing) {
const info = run(`INSERT INTO publish_jobs (account_id, platform, source_kind, source_id, source_label, file, cover, title, caption, status, origin, created_at, updated_at)
VALUES (?, ?, 'clip', ?, ?, ?, ?, ?, ?, 'awaiting_approval', 'manual', ?, ?)`,
account.id, platform, String(clipId), clip.channelId ?? "", clip.file, cover, title, caption, ts, ts);
account.id, platform, String(clipId), clip.channelId ?? "", jobFileOf(clip), cover, title, caption, ts, ts);
toPlace.push(Number(info.lastInsertRowid));
} else if (existing.status === "published") {
skipped.push({ platform, reason: "já foi publicado nesta rede" });
@@ -494,7 +500,7 @@ export async function publishClip(clipId: number, input: { accountId?: unknown;
} else {
// Aguardando aprovação, cancelado, falhou (sem envio no Publicador) ou pediu login: volta com o vídeo atual.
run("UPDATE publish_jobs SET file = ?, cover = ?, title = ?, caption = ?, origin = 'manual', updated_at = ? WHERE id = ?",
clip.file, cover, title, caption, ts, existing.id);
jobFileOf(clip), cover, title, caption, ts, existing.id);
toPlace.push(existing.id);
}
}
@@ -712,11 +718,12 @@ async function listClips(query: string): Promise<FullClip[]> {
return ((await response.json()) as { clips: FullClip[] }).clips;
}
/** Capa do corte: a do editor; senão `clip-<id>-cover.jpg` ao lado do vídeo; senão a miniatura. */
/** Capa do corte: a do vídeo final; senão a do editor; senão `clip-<id>-cover.jpg` ao lado do vídeo; senão a miniatura. */
function clipCover(clip: FullClip): string | null {
const exists = (rel: string | null | undefined) => !!rel && fs.existsSync(path.resolve(REPO_ROOT, rel));
let found: string | null = null;
if (exists(clip.edit?.cover)) found = clip.edit!.cover;
if (clip.publishFile && exists(clip.final?.cover)) found = clip.final!.cover;
else if (exists(clip.edit?.cover)) found = clip.edit!.cover;
else if (clip.file) {
const cover = path.posix.join(path.posix.dirname(clip.file.replace(/\\/g, "/")), `clip-${clip.id}-cover.jpg`);
if (exists(cover)) found = cover;
@@ -840,7 +847,7 @@ async function applyClipActions(actions: ClipAction[], clips: Map<number, FullCl
const info = run(`INSERT INTO publish_jobs (account_id, platform, source_kind, source_id, source_label, file, cover, title, caption, status, created_at, updated_at)
VALUES (?, ?, 'clip', ?, ?, ?, ?, ?, ?, 'awaiting_approval', ?, ?)
ON CONFLICT (account_id, platform, source_kind, source_id) DO NOTHING`,
a.accountId, a.platform, String(clip.id), clip.channelId ?? "", clip.file, clipCover(clip),
a.accountId, a.platform, String(clip.id), clip.channelId ?? "", jobFileOf(clip), clipCover(clip),
(clip.title || `Corte ${clip.id}`).slice(0, 100), (clip.caption ?? "").slice(0, 2200), ts, ts);
if (approved && info.changes > 0) placeApproved(Number(info.lastInsertRowid), { from: ["awaiting_approval"] });
break;
@@ -860,7 +867,7 @@ async function applyClipActions(actions: ClipAction[], clips: Map<number, FullCl
progress = 0, attempts = attempts + 1, schedule_source = 'auto', step = 'O corte está pronto de novo.', file = ?, cover = ?,
title = ?, caption = ?, scheduled_at = NULL, updated_at = ?
WHERE id = ? AND status = 'canceled' AND cancel_reason IN ('source_changed', 'unlinked')`,
clip.file, clipCover(clip), (clip.title || `Corte ${clip.id}`).slice(0, 100), (clip.caption ?? "").slice(0, 2200), ts, a.jobId).changes;
jobFileOf(clip), clipCover(clip), (clip.title || `Corte ${clip.id}`).slice(0, 100), (clip.caption ?? "").slice(0, 2200), ts, a.jobId).changes;
if (revived && a.approved && !failedApprovals.has(clip.id)) placeApproved(a.jobId, { from: ["awaiting_approval"] });
break;
}
@@ -1023,6 +1030,20 @@ function episodeUsesPersonaVoice(episodeId: number): boolean {
}
}
/** Vídeo final de um job de corte, lido no Clipador agora; ou o motivo de esperar (Clipador fora, final não pronto). */
async function clipFinalForJob(job: JobRow): Promise<{ file: string; cover: string | null } | { wait: string }> {
let clip: ClipView | null;
try {
clip = await fetchClip(Number(job.source_id));
} catch (error) {
return { wait: `Esperando o Clipador para conferir o vídeo final (${errorText(error)}).` };
}
if (!clip) return { wait: "Esperando: o corte não existe mais no Clipador." };
const target = clipPublishFile(clip);
if ("wait" in target) return target;
return { file: target.file, cover: clip.publishFile ? clipCover(clip) : null };
}
/**
* Envia ao Publicador os jobs vencidos cujo perfil está pronto (um envio por perfil por vez). Seguro contra:
* - cancelamento no meio do ciclo: relê a linha antes de enviar e grava com UPDATE condicional; se o job mudou
@@ -1055,6 +1076,18 @@ async function sendDue(): Promise<void> {
}
const key = `${job.account_id}|${job.platform}`;
if (busy.has(key) || sent >= MAX_SENDS_PER_TICK) { setStep("Esperando o envio anterior terminar."); continue; }
if (job.source_kind === "clip") {
// Corte: só o vídeo FINAL vai para as redes (doc/clipador/REVISAO.md). Relê no Clipador na hora de enviar e,
// sem final pronto, espera — nunca manda o vídeo de revisão (com as camadas de teste).
const target = await clipFinalForJob(job);
if ("wait" in target) { setStep(target.wait); continue; }
if (target.file !== job.file || (target.cover && target.cover !== job.cover)) {
run("UPDATE publish_jobs SET file = ?, cover = COALESCE(?, cover), updated_at = ? WHERE id = ? AND status = 'queued'",
target.file, target.cover, now(), job.id);
job.file = target.file;
if (target.cover) job.cover = target.cover;
}
}
// O Publicador só aceita arquivos dentro de output/, stories/ ou assets/ (as mesmas pastas que o painel serve).
const file = resolveInside(job.file, SERVABLE_ROOTS);
if (!file || !fs.existsSync(file)) {