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
+26
View File
@@ -197,8 +197,34 @@ export type Clip = {
aspect?: Aspect;
/** Idioma da sessão de origem (resolvido pelo serviço). Opcional: o serviço antigo não manda (= padrão, pt-BR). */
language?: string;
/** Vídeo de revisão (`file`): camadas de teste que entraram nele ([] = nenhuma; null = não se sabe). doc/clipador/REVISAO.md */
review?: { devLayers: string[] | null };
/** Vídeo final, gerado ao aprovar (sem as camadas de teste); null = ainda não aprovado. */
final?: ClipFinal | null;
/** O único arquivo que vai para as redes: o final pronto. null = ainda não (a publicação espera). */
publishFile?: string | null;
};
export type ClipFinal = {
status: "pending" | "rendering" | "ready" | "error";
file: string | null;
thumb: string | null;
cover: string | null;
error: string | null;
at: string | null;
/** O vídeo de revisão não tinha camada de teste: ele mesmo virou o final (sem render novo). */
reused: boolean;
};
/** Nome das camadas de teste do vídeo de revisão (grupo `dev` da configuração do corte). */
export const DEV_LAYER_LABEL: Record<string, string> = { translation: "tradução em português", dub: "dublagem em português" };
/** O vídeo de revisão (o da fila) tem camadas de teste? null = não se sabe (corte antigo). */
export function reviewHasDevLayers(clip: Pick<Clip, "review">): boolean | null {
const layers = clip.review?.devLayers;
return layers == null ? null : layers.length > 0;
}
/* ---------- Configuração do corte ---------- */
/** Retângulo normalizado (0–1) sobre o quadro original 16:9; x, y = canto superior esquerdo. */