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
+91 -1
View File
@@ -1000,6 +1000,12 @@ class Engine:
def render_pending(self) -> None:
self.recover_orphan_renders()
self.discard_pending_duplicates()
# Vídeos finais primeiro: o corte já foi aprovado e a publicação está esperando por ele (REVISAO.md).
for clip in self.db.all("SELECT * FROM clips WHERE final_status = 'pending' AND status IN ('approved', 'published')"
" ORDER BY updated_at, id LIMIT 3"):
if self.stop_event.is_set():
return
self.render_final(clip)
for clip in self.db.all("SELECT * FROM clips WHERE status = 'pending' ORDER BY score DESC, id LIMIT 3"):
if self.stop_event.is_set():
return
@@ -1105,8 +1111,87 @@ class Engine:
self.db.run("UPDATE edits SET cover = ? WHERE clip_id = ?", cover, clip["id"])
self.db.run("UPDATE clips SET status = 'ready', file = ?, thumb = ?, error = NULL, updated_at = ? WHERE id = ?",
rel(out), rel(thumb), now(), clip["id"])
self.drop_final(clip["id"]) # vídeo de revisão novo = conteúdo novo: o final antigo deixa de valer
self._render_attempts.pop(clip["id"], None)
# ---------- vídeo final (doc/clipador/REVISAO.md)
def queue_final(self, clip_id: int) -> str | None:
"""Corte aprovado: pede o vídeo FINAL (sem camadas de desenvolvimento). Se o vídeo de revisão não teve nenhuma
camada `dev` (`review_dev_json` = []), ele já é o final: reaproveita sem renderizar. Devolve o `final_status`."""
with self.db.lock:
clip = self.db.get("SELECT c.*, e.cover AS edit_cover FROM clips c LEFT JOIN edits e ON e.clip_id = c.id"
" WHERE c.id = ?", clip_id)
if not clip or clip["status"] not in ("approved", "published"):
return None
if loads(clip["review_dev_json"], None) == [] and clip["file"]:
self.db.run("UPDATE clips SET final_status = 'ready', final_file = ?, final_thumb = ?, final_cover = ?,"
" final_error = NULL, final_at = ? WHERE id = ?",
clip["file"], clip["thumb"], clip["edit_cover"], now(), clip_id)
return "ready"
self.db.run("UPDATE clips SET final_status = 'pending', final_file = NULL, final_thumb = NULL, final_cover = NULL,"
" final_error = NULL, final_at = NULL WHERE id = ?", clip_id)
self.wake_clips.set()
return "pending"
def drop_final(self, clip_id: int) -> None:
"""O final deixa de valer (aprovação desfeita, corte editado ou renderizado de novo). O arquivo fica no disco
até o próximo final (mesmo nome) ou até apagar o corte; nada mais aponta para ele."""
self.db.run("UPDATE clips SET final_status = NULL, final_file = NULL, final_thumb = NULL, final_cover = NULL,"
" final_error = NULL, final_at = NULL WHERE id = ?", clip_id)
def render_final(self, clip: dict) -> None:
"""Renderiza o vídeo final de um corte aprovado. Falha vira `final_status = 'error'` (o corte continua
aprovado; "tentar de novo" no painel = POST /v1/clips/{id}/final)."""
with self.lock:
# Apagado depois de a fila ler a lista, ou já em render: não começa (clip_delete recusa enquanto estiver aqui).
if clip["id"] in self._rendering or not self.db.get("SELECT 1 FROM clips WHERE id = ?", clip["id"]):
return
self._rendering.add(clip["id"])
try:
self._render_final(clip)
except Exception as exc: # noqa: BLE001 - nunca fica preso em 'rendering'
log.exception("vídeo final do corte %s falhou", clip["id"])
self._final_error(clip["id"], f"falha inesperada no render final: {type(exc).__name__}: {exc}")
finally:
with self.lock:
self._rendering.discard(clip["id"])
def _render_final(self, clip: dict) -> None:
taken = self.db.run("UPDATE clips SET final_status = 'rendering', final_error = NULL WHERE id = ? AND final_status = 'pending'"
" AND status IN ('approved', 'published')", clip["id"]).rowcount
if not taken:
return
session = self.db.get("SELECT * FROM sessions WHERE id = ?", clip["session_id"])
if not session:
self._final_error(clip["id"], "sessão do corte não existe mais")
return
segments = self.db.all("SELECT deleted FROM segments WHERE session_id = ? AND end_s > ? AND start_s < ?",
clip["session_id"], clip["start_s"], clip["end_s"])
if not segments or any(s["deleted"] for s in segments):
self._final_error(clip["id"], "os blocos gravados deste trecho já foram apagados")
return
out_dir = self.settings.clips_dir / str(clip["session_id"])
out = out_dir / f"clip-{clip['id']}-final.mp4"
thumb = out_dir / f"clip-{clip['id']}-final.jpg"
from . import editor, editor_api # import tardio (ver _render_clip)
t = time.monotonic()
try:
edit = editor_api.ensure_edit(self, clip, session)
cover = editor_api.render_clip_edit(self, clip, session, edit, out, thumb, dev=False)
except (media.MediaError, editor.EditError) as exc:
self._final_error(clip["id"], str(exc))
return
# Só grava se ninguém desfez a aprovação (ou editou) durante o render: aí `final_status` já não é 'rendering'.
done = self.db.run("UPDATE clips SET final_status = 'ready', final_file = ?, final_thumb = ?, final_cover = ?, final_error = NULL,"
" final_at = ? WHERE id = ? AND final_status = 'rendering'",
rel(out), rel(thumb), cover, now(), clip["id"]).rowcount
log.info("vídeo final do corte %s em %.1f s%s", clip["id"], time.monotonic() - t,
"" if done else " (descartado: o corte mudou durante o render)")
def _final_error(self, clip_id: int, message: str) -> None:
self.db.run("UPDATE clips SET final_status = 'error', final_error = ? WHERE id = ? AND final_status IN ('pending', 'rendering')",
message[:500], clip_id)
def _clip_error(self, clip_id: int, message: str) -> None:
self.db.run("UPDATE clips SET status = 'error', error = ?, updated_at = ? WHERE id = ?", message[:500], now(), clip_id)
@@ -1128,8 +1213,13 @@ class Engine:
return
limit = time.time() - self.settings.keep_hours * 3600
for seg in self.db.all("SELECT * FROM segments WHERE deleted = 0 AND analyzed = 1 AND wall_end < ? LIMIT 200", limit):
# Também guarda o trecho de quem ainda vai precisar do vídeo final: aprovado com final por fazer ou com erro, e
# pronto para aprovar cujo vídeo de revisão tem camadas de desenvolvimento (ou não se sabe) — REVISAO.md.
needed = self.db.get(
"SELECT 1 FROM clips WHERE session_id = ? AND status IN ('candidate', 'pending', 'rendering') AND start_s < ? AND end_s > ?",
"SELECT 1 FROM clips WHERE session_id = ? AND start_s < ? AND end_s > ? AND ("
"status IN ('candidate', 'pending', 'rendering')"
" OR (status IN ('approved', 'published') AND final_status IN ('pending', 'rendering', 'error'))"
" OR (status = 'ready' AND COALESCE(review_dev_json, '') != '[]'))",
seg["session_id"], seg["end_s"], seg["start_s"])
if needed:
continue