diff --git a/clipper/app/db.py b/clipper/app/db.py index 58aee48..7e35e0d 100644 --- a/clipper/app/db.py +++ b/clipper/app/db.py @@ -212,6 +212,26 @@ SCHEMA = [ """ ALTER TABLE clips ADD COLUMN translation_json TEXT; """, + # v14: vídeo de revisão × vídeo final (doc/clipador/REVISAO.md). O render da fila é o de REVISÃO (com as camadas + # `dev` ligadas); ao aprovar, sai o FINAL (`dev=False`) em `clip--final.mp4`, que é o único que se publica. + # `review_dev_json` = camadas de desenvolvimento que entraram no arquivo de revisão (["translation", ...]; [] = + # nenhuma → o de revisão já é o final; NULL = desconhecido → renderiza o final). `final_status`: pending | + # rendering | ready | error (NULL = sem final: não aprovado, ou a aprovação foi desfeita/editada). + # Cortes de antes da v14: a única camada de desenvolvimento era a tradução, que só entra com `translation_json`; + # sem ela o arquivo já é limpo ([]). + """ + ALTER TABLE clips ADD COLUMN review_dev_json TEXT; + ALTER TABLE clips ADD COLUMN final_status TEXT CHECK (final_status IN ('pending', 'rendering', 'ready', 'error')); + ALTER TABLE clips ADD COLUMN final_file TEXT; + ALTER TABLE clips ADD COLUMN final_thumb TEXT; + ALTER TABLE clips ADD COLUMN final_cover TEXT; + ALTER TABLE clips ADD COLUMN final_error TEXT; + ALTER TABLE clips ADD COLUMN final_at TEXT; + UPDATE clips SET review_dev_json = '[]' WHERE file IS NOT NULL AND translation_json IS NULL; + UPDATE clips SET final_status = 'pending' WHERE status = 'approved' AND review_dev_json IS NULL AND file IS NOT NULL; + UPDATE clips SET final_status = 'ready', final_file = file, final_thumb = thumb, final_at = updated_at + WHERE status IN ('approved', 'published') AND review_dev_json = '[]'; + """, ] @@ -237,6 +257,7 @@ class Database: # Chat só fica "conectado" enquanto grava (sessões antigas ficaram com o estado velho gravado). self.run("UPDATE sessions SET chat_status = 'off' WHERE status NOT IN ('starting', 'recording') AND chat_status != 'off'") self.run("UPDATE clips SET status = 'pending' WHERE status = 'rendering'") + self.run("UPDATE clips SET final_status = 'pending' WHERE final_status = 'rendering'") # vídeo final idem def _migrate(self) -> None: version = self.conn.execute("PRAGMA user_version").fetchone()[0] diff --git a/clipper/app/editor_api.py b/clipper/app/editor_api.py index a104ee0..ef6cc77 100644 --- a/clipper/app/editor_api.py +++ b/clipper/app/editor_api.py @@ -93,8 +93,10 @@ def load_edit(engine, clip_id: int) -> dict | None: return row -def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, thumb: Path) -> str | None: - """Render do corte pelo projeto de edição (chamado pela fila do motor). Devolve o caminho da capa (ou None).""" +def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, thumb: Path, dev: bool = True) -> str | None: + """Render do corte pelo projeto de edição (chamado pela fila do motor). Devolve o caminho da capa (ou None). + `dev=True` = vídeo de REVISÃO (com as camadas `dev` ligadas; grava quais entraram em `clips.review_dev_json`); + `dev=False` = vídeo FINAL, depois de aprovar (sem nenhuma camada de desenvolvimento) — doc/clipador/REVISAO.md.""" project = validate_for(engine, clip, session, edit["project"]) segments = session_segments(engine, clip["session_id"]) if engine._encoder is None: @@ -111,9 +113,13 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t except media.MediaError as exc: # capa é extra: o vídeo vale mesmo sem ela log.warning("capa do corte %s falhou: %s", clip["id"], exc) cover = None + translation = translation_for(engine, clip, project, base, dev=dev) editor_render.render_project(ffmpeg, engine.settings.ffprobe, engine._encoder, segments, project, base, credit, out, REPO_ROOT, chat=chat_for(engine, project), cover_file=cover, - translation=translation_for(engine, clip, project, base)) + translation=translation, dev=dev) + if dev: + layers = review_layers(editor.effective_settings(base, project), translation) + engine.db.run("UPDATE clips SET review_dev_json = ? WHERE id = ?", json.dumps(layers), clip["id"]) total = editor.output_duration(project["cuts"]) media.thumbnail(ffmpeg, out, min(3.0, total / 2), thumb) # Formato em que ESTE arquivo saiu (camadas padrão ← canal ← sessão ← projeto): a fila desenha o player por ele. @@ -121,6 +127,16 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t return cover.relative_to(REPO_ROOT).as_posix() if cover else None +def review_layers(cfg: dict, translation: list[dict] | None) -> list[str]: + """Camadas de desenvolvimento que entraram no vídeo de revisão (vazio = ele já é o vídeo final). A tradução só + conta se havia frases para desenhar (fonte em português nunca tem); as outras chaves do grupo `dev` (dublagem…) + contam pela configuração, por cautela: na dúvida, o final é renderizado de novo.""" + flags = dict(layout.dev_flags(cfg, True)) + if not translation: + flags["translation"] = False + return sorted(k for k, on in flags.items() if on) + + def translation_for(engine, clip: dict, project: dict, base: dict, dev: bool = True) -> list[dict] | None: """Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `dev.translation` ligado, render de desenvolvimento e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução.""" @@ -401,6 +417,7 @@ def register(app: FastAPI, engine, clip_view, get_clip) -> None: db.run("UPDATE clips SET start_s = ?, end_s = ?, status = 'pending', error = NULL, transcript = ?, updated_at = ? WHERE id = ?", start, end, " ".join(w.word for w in words)[:4000], ts, clip_id) db.run("UPDATE edits SET exported_at = ? WHERE clip_id = ?", ts, clip_id) + engine.drop_final(clip_id) # editou: o final antigo deixa de valer; volta a ser revisão (aprovar de novo) engine.wake_clips.set() return clip_view(get_clip(clip_id)) | {"editedDurationS": editor.output_duration(project["cuts"])} diff --git a/clipper/app/main.py b/clipper/app/main.py index b2516a2..405e6d1 100644 --- a/clipper/app/main.py +++ b/clipper/app/main.py @@ -170,6 +170,19 @@ class ClipsDeleteIn(BaseModel): confirmPublished: bool = False +APPROVED = ("approved", "published") # estados em que o corte tem (ou espera) vídeo final + + +def final_view(row: dict) -> dict | None: + """Vídeo final do corte (doc/clipador/REVISAO.md); None = sem final (não aprovado ou a aprovação foi desfeita).""" + if not row.get("final_status"): + return None + return {"status": row["final_status"], "file": row.get("final_file"), "thumb": row.get("final_thumb"), + "cover": row.get("final_cover"), "error": row.get("final_error"), "at": row.get("final_at"), + # O vídeo de revisão não tinha nenhuma camada de desenvolvimento: ele mesmo virou o final (sem render novo). + "reused": bool(row.get("final_file")) and row.get("final_file") == row.get("file")} + + def clip_view(row: dict) -> dict: return { "id": row["id"], "sessionId": row["session_id"], "peakS": row["peak_s"], "startS": row["start_s"], @@ -191,6 +204,12 @@ def clip_view(row: dict) -> dict: "edit": ({"updatedAt": row["edit_updated_at"], "exportedAt": row.get("edit_exported_at"), "cover": row.get("edit_cover"), "origin": row.get("edit_origin")} if row.get("edit_updated_at") else None), + # Revisão × final (doc/clipador/REVISAO.md). `file` é sempre o vídeo de REVISÃO (o da fila, para aprovar); + # `review.devLayers` = camadas de teste que entraram nele ([] = nenhuma; None = desconhecido). + "review": {"devLayers": loads(row.get("review_dev_json"), None)}, + "final": final_view(row), + # O ÚNICO arquivo que pode ser publicado: o final pronto de um corte aprovado. None = ainda não (esperar). + "publishFile": row.get("final_file") if row["status"] in APPROVED and row.get("final_status") == "ready" else None, } @@ -743,6 +762,11 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s if retime: editor_api.retime_edit(engine, clip_id, start, end) # corte com edição: estica/encolhe as pontas do projeto engine.wake_clips.set() + # Aprovou → pede o vídeo final (sem camadas de teste); desaprovou/mudou o trecho → o final deixa de valer. + if status in APPROVED and row["status"] not in APPROVED: + engine.queue_final(clip_id) + elif row["status"] in APPROVED and status not in APPROVED: + engine.drop_final(clip_id) if body.status in ("approved", "rejected") and body.status != row["status"]: # Sua decisão é o sinal forte: emotes da reação deste corte ganham/perdem peso no canal (uma vez). engine.intel.learn_from_clip(row, positive=body.status == "approved", mark=True) @@ -753,9 +777,20 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s """Força o render (ex.: corte que a IA descartou ou que deu erro).""" _clip(clip_id) db.run("UPDATE clips SET status = 'pending', error = NULL, updated_at = ? WHERE id = ?", now(), clip_id) + engine.drop_final(clip_id) engine.wake_clips.set() return clip_view(_clip(clip_id)) + @app.post("/v1/clips/{clip_id}/final") + def render_final(clip_id: int): + """(Re)gera o vídeo final de um corte aprovado ("tentar de novo" depois de um erro). 409 se não aprovado.""" + row = _clip(clip_id) + if row["status"] not in APPROVED: + raise UserError("Só corte aprovado tem vídeo final. Aprove o corte primeiro.", 409) + if row.get("final_status") not in ("pending", "rendering"): + engine.queue_final(clip_id) + return clip_view(_clip(clip_id)) + @app.post("/v1/clips/{clip_id}/translate") def translate_clip(clip_id: int): """Traduz (de novo) a fala do corte para o português. Só para fonte em inglês; 409 se não couber.""" @@ -768,6 +803,7 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s def rejudge(clip_id: int): _clip(clip_id) db.run("UPDATE clips SET status = 'candidate', updated_at = ? WHERE id = ?", now(), clip_id) + engine.drop_final(clip_id) engine.wake_clips.set() return clip_view(_clip(clip_id)) diff --git a/clipper/app/worker.py b/clipper/app/worker.py index 345d7d0..85506da 100644 --- a/clipper/app/worker.py +++ b/clipper/app/worker.py @@ -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 diff --git a/clipper/tests/test_final_render.py b/clipper/tests/test_final_render.py new file mode 100644 index 0000000..dab940b --- /dev/null +++ b/clipper/tests/test_final_render.py @@ -0,0 +1,283 @@ +"""Vídeo de revisão × vídeo final (doc/clipador/REVISAO.md, pedido do dono 18/11/2026): "quando o clipe está ali para +a gente aprovar, a legenda é só de dev. Quando a gente aprovar, ele vai renderizar o vídeo de novo, removendo as coisas +de dev". O render da fila é o de revisão (dev=True); aprovar enfileira o final (dev=False); publicar só usa o final.""" +import json +import sqlite3 +from pathlib import Path + +import app.db as db_module +import app.editor_api as editor_api +import app.worker as worker_module +from app import layout +from app.db import Database + +from .test_sources_and_api import auth, env, seed_session # noqa: F401 - fixture reaproveitada + + +def add_ready_clip(engine, sid, cid=1, layers: list[str] | None = None, status="ready"): + engine.db.run( + "INSERT INTO clips (id, session_id, peak_s, start_s, end_s, score, source, status, title, file, thumb, review_dev_json," + " created_at, updated_at) VALUES (?, ?, 100, 90, 160, 8, 'chat', ?, 't', ?, ?, ?, 'x', 'x')", + cid, sid, status, f"output/clipper/{sid}/clip-{cid}.mp4", f"output/clipper/{sid}/clip-{cid}.jpg", + None if layers is None else json.dumps(layers)) + + +class RenderSpy: + """Troca o render de verdade: guarda com que `dev` e para qual arquivo cada render foi pedido.""" + + def __init__(self, monkeypatch, engine, fail: bool = False): + self.calls: list[dict] = [] + self.fail = fail + monkeypatch.setattr(worker_module, "REPO_ROOT", engine.settings.data_dir.parent) # caminhos relativos do teste + monkeypatch.setattr(editor_api, "ensure_edit", lambda eng, clip, session: {"project": {}}) + monkeypatch.setattr(editor_api, "render_clip_edit", self) + + def __call__(self, engine, clip, session, edit, out: Path, thumb: Path, dev: bool = True): + self.calls.append({"clip": clip["id"], "out": out.name, "thumb": thumb.name, "dev": dev}) + if self.fail: + from app import media + raise media.MediaError("ffmpeg caiu") + return f"output/clipper/{clip['session_id']}/{out.stem}-cover.jpg" + + +def view(client, cid=1) -> dict: + return client.get(f"/v1/clips/{cid}", headers=auth()).json() + + +def approve(client, cid=1, status="approved") -> dict: + r = client.patch(f"/v1/clips/{cid}", json={"status": status}, headers=auth()) + assert r.status_code == 200, r.text + return r.json() + + +# ---------------------------------------------------------------- aprovar → final com dev=False +def test_approve_queues_final_render_without_dev_layers(env, monkeypatch): # noqa: F811 + client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=["translation"]) + spy = RenderSpy(monkeypatch, engine) + + before = view(client) + assert before["review"]["devLayers"] == ["translation"] and before["final"] is None and before["publishFile"] is None + + body = approve(client) + assert body["status"] == "approved" + assert body["final"]["status"] == "pending" and body["publishFile"] is None # nada publicável ainda + assert engine.wake_clips.is_set() + + engine.render_pending() + assert spy.calls == [{"clip": 1, "out": "clip-1-final.mp4", "thumb": "clip-1-final.jpg", "dev": False}] + after = view(client) + final = after["final"] + assert final["status"] == "ready" and not final["reused"] and final["error"] is None + assert final["file"].endswith("clip-1-final.mp4") and final["thumb"].endswith("clip-1-final.jpg") + assert final["cover"].endswith("clip-1-final-cover.jpg") + assert after["publishFile"] == final["file"] != after["file"] # o de revisão continua sendo `file` + engine.render_pending() + assert len(spy.calls) == 1 # pronto não renderiza de novo + + +def test_review_render_of_the_queue_stays_dev_true(env, monkeypatch): # noqa: F811 + client, engine = env + monkeypatch.setattr(worker_module, "REPO_ROOT", engine.settings.data_dir.parent) + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=None, status="pending") + spy = RenderSpy(monkeypatch, engine) + engine.render_pending() + assert spy.calls == [{"clip": 1, "out": "clip-1.mp4", "thumb": "clip-1.jpg", "dev": True}] + assert view(client)["status"] == "ready" and view(client)["final"] is None + + +def test_unknown_layers_render_final(env, monkeypatch): # noqa: F811 + """Sem saber o que entrou no vídeo de revisão (`review_dev_json` NULL), o final é renderizado por cautela.""" + client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=None) + spy = RenderSpy(monkeypatch, engine) + assert approve(client)["final"]["status"] == "pending" + engine.render_pending() + assert [c["dev"] for c in spy.calls] == [False] + + +# ---------------------------------------------------------------- sem camadas dev: reaproveita +def test_without_dev_layers_review_is_already_final(env, monkeypatch): # noqa: F811 + client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=[]) + engine.db.run("INSERT INTO edits (clip_id, project_json, created_at, updated_at, cover) VALUES (1, '{}', 'x', 'x', ?)", + f"output/clipper/{sid}/clip-1-cover.jpg") + spy = RenderSpy(monkeypatch, engine) + body = approve(client) + assert body["final"]["status"] == "ready" and body["final"]["reused"] + assert body["publishFile"] == body["file"] and body["final"]["cover"].endswith("clip-1-cover.jpg") + engine.render_pending() + assert spy.calls == [] # não renderizou de novo + + +# ---------------------------------------------------------------- publicação nunca pega o de revisão +def test_publish_file_is_never_the_review_video(env, monkeypatch): # noqa: F811 + client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, 1, layers=["translation"]) + add_ready_clip(engine, sid, 2, layers=["dub", "translation"]) + spy = RenderSpy(monkeypatch, engine, fail=True) + + def publishable() -> dict[int, str | None]: + clips = client.get("/v1/clips?status=ready,approved,published", headers=auth()).json()["clips"] + return {c["id"]: c["publishFile"] for c in clips} + + assert publishable() == {1: None, 2: None} # pronto para aprovar = só revisão + approve(client, 1) + approve(client, 2, status="published") # marcado publicado direto também pede o final + assert publishable() == {1: None, 2: None} # final na fila + engine.render_pending() # o render final falha + for cid in (1, 2): + v = view(client, cid) + assert v["final"]["status"] == "error" and "ffmpeg caiu" in v["final"]["error"] + assert v["publishFile"] is None and v["status"] in ("approved", "published") # erro não vira revisão publicável + # "Tentar de novo" (POST /final): volta à fila e, desta vez, sai. + spy.fail = False + assert client.post("/v1/clips/1/final", headers=auth()).json()["final"]["status"] == "pending" + engine.render_pending() + v = view(client, 1) + assert v["publishFile"] and v["publishFile"] != v["file"] and v["publishFile"].endswith("-final.mp4") + assert all(f is None or f.endswith("-final.mp4") for f in publishable().values()) + # Só corte aprovado tem final. + client.patch("/v1/clips/2", json={"status": "ready"}, headers=auth()) + assert client.post("/v1/clips/2/final", headers=auth()).status_code == 409 + + +# ---------------------------------------------------------------- desaprovar / editar +def test_unapprove_edit_and_rerender_drop_the_final(env, monkeypatch): # noqa: F811 + client, engine = env + monkeypatch.setattr(worker_module, "REPO_ROOT", engine.settings.data_dir.parent) + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=["translation"]) + spy = RenderSpy(monkeypatch, engine) + approve(client) + engine.render_pending() + assert view(client)["publishFile"] + + # Desaprovar (voltar para pronto) ou rejeitar: o final deixa de valer. + body = client.patch("/v1/clips/1", json={"status": "ready"}, headers=auth()).json() + assert body["final"] is None and body["publishFile"] is None + approve(client) + assert view(client)["final"]["status"] == "pending" # aprovar de novo = final novo + engine.render_pending() + + # Mudar o trecho de um aprovado: volta a ser revisão (renderiza de novo) e o final some. + body = client.patch("/v1/clips/1", json={"startS": 95, "endS": 160}, headers=auth()).json() + assert body["status"] == "pending" and body["final"] is None and body["publishFile"] is None + + # Render de revisão novo também derruba qualquer final (ex.: export do editor). + engine.db.run("UPDATE clips SET status = 'approved', final_status = 'ready', final_file = 'x-final.mp4' WHERE id = 1") + engine.render_pending() # o final está pronto; nada pendente + engine.db.run("UPDATE clips SET status = 'pending' WHERE id = 1") + engine.render_pending() + v = view(client) + assert v["status"] == "ready" and v["final"] is None and spy.calls[-1]["dev"] is True + + # Pedir render de novo (botão) também. + approve(client) + engine.render_pending() + assert client.post("/v1/clips/1/render", headers=auth()).json()["final"] is None + + +def test_unapprove_during_final_render_discards_it(env, monkeypatch): # noqa: F811 + client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=["translation"]) + approve(client) + + def slow_render(eng, clip, session, edit, out, thumb, dev=True): + client.patch("/v1/clips/1", json={"status": "ready"}, headers=auth()) # desaprovou no meio do render + return None + monkeypatch.setattr(editor_api, "ensure_edit", lambda eng, clip, session: {"project": {}}) + monkeypatch.setattr(editor_api, "render_clip_edit", slow_render) + engine.render_pending() + v = view(client) + assert v["final"] is None and v["publishFile"] is None and engine._rendering == set() + + +# ---------------------------------------------------------------- quais camadas entraram na revisão +def test_review_layers(): + lines = [{"s": 0, "e": 1, "text": "hi", "pt": "oi"}] + on = layout.merge({"dev": {"translation": True}}) + assert editor_api.review_layers(on, lines) == ["translation"] + assert editor_api.review_layers(on, None) == [] # fonte em português: nada desenhado + assert editor_api.review_layers(layout.merge(), lines) == [] + assert editor_api.review_layers(layout.merge({"dev": {"dub": True}}), None) == ["dub"] + legacy = layout.merge({"caption": {"translation": True}}) + assert editor_api.review_layers(legacy, lines) == ["translation"] + + +def test_render_clip_edit_passes_dev_and_records_layers(env, monkeypatch): # noqa: F811 + """render_clip_edit: dev=True grava as camadas da revisão; dev=False não pede tradução nem mexe no registro.""" + _client, engine = env + sid = seed_session(engine) + add_ready_clip(engine, sid, layers=None) + seen: list[dict] = [] + project = {"cover": {"enabled": False}, "cuts": [{"start": 90, "end": 150, "mode": None}]} + monkeypatch.setattr(editor_api, "validate_for", lambda eng, clip, session, data: project) + monkeypatch.setattr(editor_api.editor, "effective_settings", lambda base, p: layout.merge({"dev": {"translation": True}})) + monkeypatch.setattr(editor_api, "translation_for", + lambda eng, clip, p, base, dev=True: [{"s": 0, "e": 1, "text": "hi", "pt": "oi"}] if dev else None) + monkeypatch.setattr(editor_api.editor_render, "render_project", + lambda *a, **k: seen.append({"dev": k["dev"], "translation": k["translation"]})) + monkeypatch.setattr(editor_api.media, "thumbnail", lambda *a, **k: None) + monkeypatch.setattr(editor_api.media, "pick_encoder", lambda *a, **k: []) + session = engine.db.get("SELECT * FROM sessions WHERE id = ?", sid) + clip = engine.db.get("SELECT * FROM clips WHERE id = 1") + out = engine.settings.clips_dir / "clip-1.mp4" + editor_api.render_clip_edit(engine, clip, session, {"project": project}, out, out.with_suffix(".jpg")) + assert seen[-1]["dev"] is True and seen[-1]["translation"] + assert json.loads(engine.db.get("SELECT review_dev_json FROM clips WHERE id = 1")["review_dev_json"]) == ["translation"] + final = engine.settings.clips_dir / "clip-1-final.mp4" + editor_api.render_clip_edit(engine, clip, session, {"project": project}, final, final.with_suffix(".jpg"), dev=False) + assert seen[-1] == {"dev": False, "translation": None} + assert json.loads(engine.db.get("SELECT review_dev_json FROM clips WHERE id = 1")["review_dev_json"]) == ["translation"] + + +# ---------------------------------------------------------------- limpeza e migração +def test_prune_keeps_segments_that_the_final_still_needs(env, monkeypatch): # noqa: F811 + _client, engine = env + monkeypatch.setattr(worker_module, "REPO_ROOT", engine.settings.data_dir.parent) + sid = seed_session(engine) # blocos de 30 s, todos "velhos" (wall_end ≈ 1970) + engine.db.run("INSERT INTO clips (id, session_id, peak_s, start_s, end_s, score, source, status, review_dev_json, created_at," + " updated_at) VALUES (1, ?, 100, 90, 110, 8, 'chat', 'ready', '[\"translation\"]', 'x', 'x')", sid) + engine.db.run("INSERT INTO clips (id, session_id, peak_s, start_s, end_s, score, source, status, review_dev_json, created_at," + " updated_at) VALUES (2, ?, 200, 190, 200, 8, 'chat', 'ready', '[]', 'x', 'x')", sid) + engine.db.run("INSERT INTO clips (id, session_id, peak_s, start_s, end_s, score, source, status, final_status, created_at," + " updated_at) VALUES (3, ?, 400, 400, 410, 8, 'chat', 'approved', 'error', 'x', 'x')", sid) + engine.prune() + kept = {r["idx"] for r in engine.db.all("SELECT idx FROM segments WHERE session_id = ? AND deleted = 0", sid)} + assert kept == {3, 13} # 90–110 s (revisão com tradução) e 400–410 s (final com erro); o 190–200 s (limpo) saiu + + +def test_migration_v14_backfills_old_clips(tmp_path): + path = tmp_path / "clipper.db" + conn = sqlite3.connect(path) # banco como estava na v13 + for script in db_module.SCHEMA[:13]: + for statement in db_module._split(script): + conn.execute(statement) + conn.execute("PRAGMA user_version = 13") + conn.execute("INSERT INTO sessions (id, platform, kind, url, status, dir, started_at) VALUES (1, 'twitch', 'live', 'u', 'done', '', 'x')") + rows = [(1, "approved", "a.mp4", None), (2, "approved", "b.mp4", '{"lines": []}'), (3, "published", "c.mp4", '{"lines": []}'), + (4, "ready", "d.mp4", None), (5, "published", "e.mp4", None), (6, "candidate", None, None)] + for cid, status, file, translation in rows: + conn.execute("INSERT INTO clips (id, session_id, peak_s, start_s, end_s, score, source, status, file, translation_json," + " created_at, updated_at) VALUES (?, 1, 1, 0, 10, 1, 'chat', ?, ?, ?, 'x', 'u')", (cid, status, file, translation)) + conn.commit() + conn.close() + db = Database(path) + got = {r["id"]: (r["review_dev_json"], r["final_status"], r["final_file"]) + for r in db.all("SELECT id, review_dev_json, final_status, final_file FROM clips")} + db.close() + assert got == { + 1: ("[]", "ready", "a.mp4"), # sem tradução: o arquivo já era limpo → é o final + 2: (None, "pending", None), # com tradução e aprovado: renderiza o final + 3: (None, None, None), # publicado (já saiu): só gera final se pedirem (POST /final) + 4: ("[]", None, None), + 5: ("[]", "ready", "e.mp4"), + 6: (None, None, None), + } diff --git a/doc/clipador/REVISAO.md b/doc/clipador/REVISAO.md new file mode 100644 index 0000000..3b9d8ad --- /dev/null +++ b/doc/clipador/REVISAO.md @@ -0,0 +1,85 @@ +# Clipador — vídeo de revisão × vídeo final + +Pedido do dono (18/11/2026): + +> Quando o clipe está ali para a gente aprovar, a legenda é só de dev. Quando a gente aprovar, ele vai renderizar o +> vídeo de novo, removendo as coisas de dev. + +## Fluxo + +``` +fila de render ─► VÍDEO DE REVISÃO clip-.mp4 (dev=True: entram as camadas `dev` ligadas) + │ status ready → equipe assiste e decide + ▼ + Aprovar (PATCH status=approved|published) + │ + review_dev_json = []? ──sim──► o de revisão JÁ É o final (sem render novo; final.reused = true) + │não / não se sabe + ▼ + VÍDEO FINAL clip--final.mp4 (+ -final.jpg, -final-cover.jpg) (dev=False) + │ final_status: pending → rendering → ready | error + ▼ + Publicação: SÓ `publishFile` (o final pronto); sem ele, o envio espera +``` + +- **Camadas `dev`** (`layout.py`, grupo `dev` da configuração do corte): hoje `translation` (português embaixo da + legenda) e `dub` (dublagem em português). `layout.dev_flags(cfg, dev=False)` desliga todas. +- O render da fila (`worker._render_clip` → `editor_api.render_clip_edit(..., dev=True)`) grava em + `clips.review_dev_json` quais camadas entraram de fato (`editor_api.review_layers`): a tradução só conta se havia + frases para desenhar (fonte em português nunca tem); as outras chaves contam pela configuração, por cautela. +- O final roda na mesma fila do motor (`Engine.render_pending`: finais primeiro, até 3 por volta), com + `render_clip_edit(..., dev=False)` sobre o MESMO projeto de edição. Não pede tradução, não grava `review_dev_json`. +- Falha no final vira `final_status = 'error'` com `final_error`; o corte continua aprovado e nada é publicado. + Serviço caiu no meio: na subida `rendering` volta a `pending`. + +## O final deixa de valer quando… + +| Ação | Efeito | +| --- | --- | +| Desfazer aprovação / rejeitar (`PATCH status=ready|rejected`) | final some (`drop_final`); aprovar de novo gera outro | +| Mudar início/fim de um aprovado (`PATCH startS/endS`) | volta para `pending` (revisão nova) e o final some | +| Exportar do editor (`POST /export`), re-render (`POST /render`), mandar de novo para a IA (`POST /rejudge`) | final some; o corte volta a ser revisão e precisa ser aprovado de novo | +| Qualquer render de revisão novo terminar | final some (conteúdo novo) | +| Desaprovar DURANTE o render do final | o resultado é descartado (só grava se ainda estiver `rendering`) | + +O arquivo `clip--final.mp4` antigo fica no disco até o próximo final (mesmo nome) ou até apagar o corte +(`clip_delete` apaga `clip--*`). Apagar é recusado enquanto o final renderiza. + +**Limpeza dos blocos** (`CLIPPER_KEEP_HOURS`): além dos cortes em andamento, `prune` guarda o trecho de quem ainda vai +precisar do final — aprovado com final `pending`/`rendering`/`error`, e pronto para aprovar cujo vídeo de revisão tem +camada de teste (ou não se sabe). Corte pronto **sem** camada de teste não segura blocos (o de revisão já é o final). + +## Banco (migração v14, `clipper/app/db.py`) + +`clips.review_dev_json` (JSON: `["translation", …]`; `[]` = nenhuma; NULL = desconhecido) · `final_status` +(`pending|rendering|ready|error`; NULL = sem final) · `final_file` · `final_thumb` · `final_cover` · `final_error` · +`final_at`. Cortes antigos: sem `translation_json` → `review_dev_json = []` (a tradução era a única camada); aprovados +assim ganham o final = o próprio arquivo; aprovados com tradução ficam `pending` (renderiza na subida); publicados com +tradução ficam sem final (gera com `POST /final` se forem para outra rede). + +## API (`/v1/clips…`) + +- Cada corte traz `review: {devLayers}`, `final: {status, file, thumb, cover, error, at, reused} | null` e + `publishFile` = `final.file` quando o corte está `approved|published` e o final está `ready`; senão `null`. + `file`/`thumb` continuam sendo os do vídeo de revisão. +- `POST /v1/clips/{id}/final` — (re)gera o final de um corte aprovado ("Tentar de novo"); 409 se não aprovado. + +## Publicação (painel) + +- `panel/src/lib/publishing-rules.ts` → `clipPublishFile(clip)`: devolve `publishFile` ou o motivo de esperar. Nunca + devolve `file` quando o Clipador manda o campo (Clipador antigo, sem `publishFile`, segue com `file`). +- `publishing.ts → sendDue`: antes de mandar um job de corte ao Publicador, relê o corte no Clipador + (`clipFinalForJob`); sem final pronto o job fica na fila com o passo "Esperando o vídeo final…"; com o final, troca + `file` (e a capa, se o final tiver) do job e envia. O arquivo gravado ao criar o job é só referência. +- Capa do corte (`clipCover`): a do final primeiro. + +## Painel (`/clipper`) + +- Lista: etiqueta `revisão · teste` (vídeo com camadas de teste), `gerando final`, `final` ou `final com erro`. +- Modal: o player toca o final quando existe (botões **Final / Revisão** para comparar); texto dizendo se é o de + revisão (e quais camadas de teste) ou o final; estado do final depois de aprovar (na fila/gerando… · pronto · erro com + **Tentar de novo**); aprovado sem final: **Gerar vídeo final**. +- Diálogo "Publicar": aviso de que o envio espera o vídeo final enquanto ele não está pronto. + +Testes: `clipper/tests/test_final_render.py`; `panel/src/lib/publishing-rules.test.ts` (regra) e +`publishing-db.test.ts` (despachante espera o final e envia o arquivo final). diff --git a/panel/src/components/clip-publish.tsx b/panel/src/components/clip-publish.tsx index c88bc0b..0a4ac24 100644 --- a/panel/src/components/clip-publish.tsx +++ b/panel/src/components/clip-publish.tsx @@ -213,6 +213,16 @@ function PublishDialog({ clip, jobs, onClose, onDone }: {

Vai com o título e a legenda do cartão. Para mudar, edite no cartão e salve antes.

+ {clip.publishFile === null && ( + // Só o vídeo final (sem as camadas de teste) vai para as redes: os envios esperam por ele (doc/clipador/REVISAO.md). +

+ + {clip.final?.status === "error" + ? <>O vídeo final deu erro no Clipador. Pode agendar: nada sai até ele ficar pronto — use “Tentar de novo” no corte. + : <>O vídeo final (sem as camadas de teste) ainda está sendo gerado. Pode agendar: o envio espera por ele e nunca usa o vídeo de revisão.} +

+ )} + {loadError ? ( Não deu para ler os canais de publicação ({loadError}). ) : !accounts ? ( diff --git a/panel/src/components/clipper-client.ts b/panel/src/components/clipper-client.ts index ef812ff..5563e79 100644 --- a/panel/src/components/clipper-client.ts +++ b/panel/src/components/clipper-client.ts @@ -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 = { 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): 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. */ diff --git a/panel/src/components/clipper-clip-dialog.tsx b/panel/src/components/clipper-clip-dialog.tsx index dad16c9..e80a692 100644 --- a/panel/src/components/clipper-clip-dialog.tsx +++ b/panel/src/components/clipper-clip-dialog.tsx @@ -6,7 +6,7 @@ import { useEffect, useState } from "react"; import { CLIP_STATUS, SOURCE_LABEL, clipperCall, formatClock, formatDuration, languageLabel, useClipperAction, type Clip, type ClipperSession } from "./clipper-client"; import { - ChatSignals, ClipActions, ClipMedia, DeleteControl, FaceSignal, JudgeVerdict, TrimControl, situationLabel, type DeleteClip, + ChatSignals, ClipActions, ClipMedia, ClipVideoState, DeleteControl, FaceSignal, JudgeVerdict, TrimControl, situationLabel, type DeleteClip, } from "./clipper-clip-parts"; import { Dialog } from "./dialog"; import { ArrowLeftIcon, ArrowRightIcon, CheckIcon, ClockIcon } from "./icons"; @@ -91,11 +91,14 @@ function ClipBody({ clip, onChanged, publishJobs }: { clip: Clip; onChanged: () } const showPublication = clip.status === "approved" || clip.status === "published"; + // Player: o vídeo final quando existe (é o que vai para as redes); dá para voltar ao de revisão. + const [show, setShow] = useState<"review" | "final">("final"); return (
- + +
diff --git a/panel/src/components/clipper-clip-parts.tsx b/panel/src/components/clipper-clip-parts.tsx index 7e0c325..6baf796 100644 --- a/panel/src/components/clipper-clip-parts.tsx +++ b/panel/src/components/clipper-clip-parts.tsx @@ -5,7 +5,8 @@ // confirmação curta no lugar. Nada aqui busca dados: tudo vem por props; cada ação chama `run` (useClipperAction). import { useEffect, useRef, useState, type ReactNode } from "react"; import { - ACTIVE_CLIP, CLIP_STATUS, FACE_LABEL, SITUATION_LABEL, TAG_LABEL, UNDELETABLE_CLIP, aspectOf, clipperCall, formatClock, formatDuration, formatScore, + ACTIVE_CLIP, CLIP_STATUS, DEV_LAYER_LABEL, FACE_LABEL, SITUATION_LABEL, TAG_LABEL, UNDELETABLE_CLIP, aspectOf, clipperCall, formatClock, formatDuration, formatScore, + reviewHasDevLayers, type Clip, type ClipAnalysis, type ClipTags, type Situation, type useClipperAction, } from "./clipper-client"; import { ClipPublishButton } from "./clip-publish"; @@ -84,14 +85,20 @@ export function DeleteControl({ clip, deleting, disabled, onDelete }: { clip: Cl /* ---------- Cartão do corte ---------- */ -export function ClipMedia({ clip, version }: { clip: Clip; version: string }) { +/** `show = "final"` toca o vídeo final (quando pronto); o padrão é o de revisão (o da fila). */ +export function ClipMedia({ clip, version, show = "review" }: { clip: Clip; version: string; show?: "review" | "final" }) { const busy = ACTIVE_CLIP.includes(clip.status); - const poster = clip.thumb ? fileUrl(clip.thumb) : undefined; + const final = show === "final" && clip.final?.status === "ready" && clip.final.file ? clip.final : null; + const file = final ? final.file : clip.file; + const thumb = final?.thumb ?? clip.thumb; + const poster = thumb ? fileUrl(thumb) : undefined; const frame = aspectOf(clip) === "horizontal" ? "aspect-video" : "aspect-9/16 max-sm:max-w-60"; - if (clip.file && !busy) { + if (file && !busy) { + const v = final ? `final-${final.at ?? ""}` : version; return ( -
diff --git a/panel/src/lib/clipper.ts b/panel/src/lib/clipper.ts index e74f73d..1fa77fe 100644 --- a/panel/src/lib/clipper.ts +++ b/panel/src/lib/clipper.ts @@ -30,14 +30,16 @@ function serviceUrl(pathname: string): { url: string; key: string } { * status · judge · emotes · games[/id[/research|refine|translate|notes/n]] (POST games = cadastrar; PUT/DELETE games/id) · channels[/id[/check|settings]] * sessions[/id[/timeline|stop|resume|finish|clips|settings|frame|preview|detect-cam|game|face[/reset]]] · clips[/id[/render|rejudge]] * editor de cortes: clips/id/(edit|proxy|waveform|export|preview-render|retranscribe|tts|suggest) + * vídeo final (doc/clipador/REVISAO.md): POST clips/id/final * apagar cortes: DELETE clips/id · POST clips/delete (lote) — o método é conferido em METHODS */ -const ALLOWED = /^(status|judge|emotes|games(\/[a-z0-9-]{1,60}(\/(research|refine|translate|notes\/\d{1,3}))?)?|channels(\/(twitch|youtube|kick)-[a-z0-9._-]{2,60}(\/(check|settings))?)?|sessions(\/\d{1,9}(\/(timeline|stop|resume|finish|clips|settings|frame|preview|detect-cam|game|face(\/reset)?))?)?|clips(\/(delete|\d{1,9}(\/(render|rejudge|edit|proxy|waveform|export|preview-render|retranscribe|tts|suggest))?))?)$/; +const ALLOWED = /^(status|judge|emotes|games(\/[a-z0-9-]{1,60}(\/(research|refine|translate|notes\/\d{1,3}))?)?|channels(\/(twitch|youtube|kick)-[a-z0-9._-]{2,60}(\/(check|settings))?)?|sessions(\/\d{1,9}(\/(timeline|stop|resume|finish|clips|settings|frame|preview|detect-cam|game|face(\/reset)?))?)?|clips(\/(delete|\d{1,9}(\/(render|rejudge|edit|proxy|waveform|export|preview-render|retranscribe|tts|suggest|final))?))?)$/; /** Métodos aceitos nos caminhos de apagar corte (os demais caminhos seguem só pela regex acima). */ const METHODS: [RegExp, string[]][] = [ [/^clips\/delete$/, ["POST"]], [/^clips\/\d{1,9}$/, ["GET", "PATCH", "DELETE"]], + [/^clips\/\d{1,9}\/final$/, ["POST"]], // Jogos: listar e cadastrar; gravar a edição (PUT ?lang=pt|en) e apagar (doc/clipador/JOGOS.md). [/^games$/, ["GET", "POST"]], [/^games\/[a-z0-9-]{1,60}$/, ["PUT", "DELETE"]], diff --git a/panel/src/lib/publishing-db.test.ts b/panel/src/lib/publishing-db.test.ts index f04b2a7..9eba053 100644 --- a/panel/src/lib/publishing-db.test.ts +++ b/panel/src/lib/publishing-db.test.ts @@ -234,8 +234,19 @@ describe("despachante: corridas, clientRef e vínculos (ALTOS)", () => { }; const clearQueue = () => dbm.run(`UPDATE publish_jobs SET status = 'canceled', cancel_reason = 'user' WHERE status IN ('queued', 'scheduled', 'awaiting_approval', 'publishing')`); + // Clipador falso: cada corte responde aprovado e com o vídeo final pronto (doc/clipador/REVISAO.md); `finals` + // troca isso por corte. A listagem fica fora do ar (nada de sincronizar cortes neste bloco, como antes). + const clipperEnv = path.join(ROOT, "clipper", ".env"); + const finals = new Map(); + const clipBody = (id: string) => ({ + id: Number(id), status: "approved", channelId: "twitch-xis", createdAt: "2026-11-01T00:00:00.000Z", title: "Corte", caption: "#corte", + file: MP4, thumb: null, edit: null, + ...(finals.get(id) ?? { publishFile: MP4, final: { status: "ready", error: null, cover: null } }), + }); before(() => { + fs.mkdirSync(path.dirname(clipperEnv), { recursive: true }); + fs.writeFileSync(clipperEnv, "CLIPPER_SERVICE_KEY=chave-de-teste\nCLIPPER_PORT=4520\n"); fs.mkdirSync(path.join(ROOT, "publisher"), { recursive: true }); fs.writeFileSync(path.join(ROOT, "publisher", ".env"), "PUBLISHER_SERVICE_KEY=chave-de-teste\nPUBLISHER_PORT=4530\n"); dbm.run("UPDATE account_networks SET status = 'connected', mode = 'official', enabled = 1 WHERE account_id = 'canal'"); @@ -247,6 +258,9 @@ describe("despachante: corridas, clientRef e vínculos (ALTOS)", () => { const body = typeof init?.body === "string" ? (JSON.parse(init.body) as Record) : null; calls.push({ method, path: url.pathname, body }); if (url.pathname === "/v1/status") return json({ browser: { found: true, kind: "chrome", path: "x" }, worker: "idle", queue: 0 }); + if (url.pathname === "/v1/clips") throw new TypeError("fetch failed"); + const clip = /^\/v1\/clips\/(\d+)$/.exec(url.pathname); + if (clip) return json(clipBody(clip[1])); const prof = /^\/v1\/profiles\/([^/]+)$/.exec(url.pathname); if (prof && method === "GET") return json(profile(decodeURIComponent(prof[1]))); if (url.pathname === "/v1/jobs" && method === "POST") return onCreate(body!); @@ -260,6 +274,35 @@ describe("despachante: corridas, clientRef e vínculos (ALTOS)", () => { after(() => { globalThis.fetch = realFetch; + fs.rmSync(clipperEnv, { force: true }); + }); + + it("corte sem vídeo final pronto espera na fila; com o final pronto sai com o arquivo FINAL, nunca o de revisão", async () => { + clearQueue(); + const id = queuedClipJob(); + const sourceId = dbm.get<{ source_id: string }>("SELECT source_id FROM publish_jobs WHERE id = ?", id)!.source_id; + const files: string[] = []; + onCreate = async (body) => { files.push(String(body.file)); return json(remoteJob("pj-final"), 201); }; + finals.set(sourceId, { publishFile: null, final: { status: "rendering", error: null } }); + await pub.dispatcherTick(); + let job = pub.getJobView(id)!; + assert.equal(job.status, "queued"); + assert.match(job.step, /vídeo final/); + finals.set(sourceId, { publishFile: null, final: { status: "error", error: "ffmpeg caiu" } }); + await pub.dispatcherTick(); + assert.equal(pub.getJobView(id)!.status, "queued"); + assert.deepEqual(files, []); // nada foi ao Publicador enquanto não havia final + + const finalFile = "output/clipper/3/clip-9-final.mp4"; + fs.mkdirSync(path.join(ROOT, "output", "clipper", "3"), { recursive: true }); + fs.writeFileSync(path.join(ROOT, finalFile), "mp4 final"); + finals.set(sourceId, { publishFile: finalFile, final: { status: "ready", error: null } }); + await pub.dispatcherTick(); + job = pub.getJobView(id)!; + assert.equal(job.status, "publishing"); + assert.equal(job.file, finalFile); + assert.deepEqual(files, [path.resolve(ROOT, finalFile)]); + finals.delete(sourceId); }); it("cancelar enquanto o Publicador cria o envio: o job fica cancelado e o envio é cancelado lá", async () => { diff --git a/panel/src/lib/publishing-rules.test.ts b/panel/src/lib/publishing-rules.test.ts index d59024d..8ffbbff 100644 --- a/panel/src/lib/publishing-rules.test.ts +++ b/panel/src/lib/publishing-rules.test.ts @@ -4,7 +4,7 @@ import assert from "node:assert/strict"; import { describe, it } from "node:test"; import { - DEFAULT_SLOTS, clientRefFor, isDue, localDay, mayBeLive, needsReflow, nextFreeSlot, parseVideoUrl, placeJob, planClipSync, readPublisherJob, sendBlocker, + DEFAULT_SLOTS, clientRefFor, clipPublishFile, isDue, localDay, mayBeLive, needsReflow, nextFreeSlot, parseVideoUrl, placeJob, planClipSync, readPublisherJob, sendBlocker, tagsFromCaption, zonedTimeToUtc, type ClipInfo, type ClipTarget, type ExistingJob, } from "./publishing-rules"; @@ -254,3 +254,25 @@ describe("envio: idempotência, reencaixe e confirmação", () => { assert.match(sendBlocker({ status: "expired", enabled: 1 }, false)!, /venceu/); }); }); + +describe("corte: só o vídeo final vai para as redes (doc/clipador/REVISAO.md)", () => { + const review = "output/clipper/3/clip-9.mp4"; + + it("final pronto: publica o final, não o de revisão", () => { + assert.deepEqual(clipPublishFile({ file: review, publishFile: "output/clipper/3/clip-9-final.mp4", final: { status: "ready", error: null } }), + { file: "output/clipper/3/clip-9-final.mp4" }); + }); + + it("sem final pronto espera, nunca devolve o vídeo de revisão", () => { + for (const final of [null, { status: "pending" as const, error: null }, { status: "rendering" as const, error: null }, { status: "error" as const, error: "ffmpeg" }]) { + const target = clipPublishFile({ file: review, publishFile: null, final }); + assert.ok("wait" in target, JSON.stringify(final)); + } + assert.match((clipPublishFile({ file: review, publishFile: null, final: { status: "error", error: "ffmpeg caiu" } }) as { wait: string }).wait, /ffmpeg caiu/); + }); + + it("Clipador antigo (sem `publishFile`) continua usando o arquivo do corte", () => { + assert.deepEqual(clipPublishFile({ file: review }), { file: review }); + assert.ok("wait" in clipPublishFile({ file: null })); + }); +}); diff --git a/panel/src/lib/publishing-rules.ts b/panel/src/lib/publishing-rules.ts index 78d5220..342ca48 100644 --- a/panel/src/lib/publishing-rules.ts +++ b/panel/src/lib/publishing-rules.ts @@ -182,6 +182,31 @@ export type ClipAction = | { kind: "forget_auto"; clipId: number } | { kind: "mark_clip_published"; clipId: number }; +/** O que o Clipador diz do vídeo de um corte (doc/clipador/REVISAO.md). `publishFile` ausente = Clipador antigo. */ +export type ClipVideo = { + file: string | null; + publishFile?: string | null; + final?: { status: "pending" | "rendering" | "ready" | "error"; error: string | null } | null; +}; + +/** + * Arquivo de um corte que pode ir para as redes: SÓ o vídeo final (sem as camadas de teste do vídeo de revisão). + * Sem final pronto, devolve o motivo de esperar — nunca o vídeo de revisão (`file`). Clipador antigo (sem o campo + * `publishFile`) não tem vídeo de revisão separado: vale `file`. + */ +export function clipPublishFile(clip: ClipVideo): { file: string } | { wait: string } { + if (clip.publishFile) return { file: clip.publishFile }; + if (clip.publishFile === undefined) return clip.file ? { file: clip.file } : { wait: "Esperando: o corte ainda não tem vídeo pronto." }; + const final = clip.final; + if (final?.status === "pending" || final?.status === "rendering") { + return { wait: "Esperando o vídeo final do Clipador (gerando, sem as camadas de teste)." }; + } + if (final?.status === "error") { + return { wait: `Esperando: o vídeo final deu erro no Clipador (${final.error ?? "erro"}). Use “Tentar de novo” no corte.` }; + } + return { wait: "Esperando o vídeo final: o corte precisa estar aprovado no Clipador." }; +} + const PUBLISHABLE = new Set(["ready", "approved"]); /** Estados do corte em que os jobs não enviados continuam válidos. */ const KEEPS_JOBS = new Set(["ready", "approved", "published"]); diff --git a/panel/src/lib/publishing.ts b/panel/src/lib/publishing.ts index 9b1f8b9..c71a6d4 100644 --- a/panel/src/lib/publishing.ts +++ b/panel/src/lib/publishing.ts @@ -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 & { 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 { 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 { return ((await response.json()) as { clips: FullClip[] }).clips; } -/** Capa do corte: a do editor; senão `clip--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--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 0) placeApproved(Number(info.lastInsertRowid), { from: ["awaiting_approval"] }); break; @@ -860,7 +867,7 @@ async function applyClipActions(actions: ClipAction[], clips: Map { + 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 { } 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)) {