Painel: ordenar fila de cortes, horário específico ao publicar e capas preservadas

Clipador (fila de cortes)
- Seletor "Ordenar": mais novos, mais antigos, maior/menor nota da IA, sinal
  mais forte e mais longos; a escolha fica lembrada no navegador.
- A fila abre filtrada pela sessão que está gravando.
- Gancho automático logo abaixo da câmera e legenda desviada enquanto o gancho
  a cobriria; posição do gancho editável no painel.

Publicação
- "Publicar este corte" ganha "Horário específico": um dia e hora para todas
  as redes ou um diferente por rede (timing "at" + scheduledAt por rede na rota
  POST /api/publishing/clips/[id]), com validação e testes.
- Capa do vídeo publicado copiada para output/publishing/covers/: apagar a
  sessão no Clipador não quebra mais a miniatura do dashboard; jobs antigos
  migram no ciclo de sincronização.
- Dashboard só usa capa que existe no disco; corrige a regex do número do
  episódio (link do episódio).
- Canais de publicação: seletor compacto de canais e detalhe reorganizado.
- Publicador: confirmação pela página pública quando o YouTube Studio fica com
  a caixa de envio aberta; estatísticas por rede.

Skill cenaforge 1.44.0 com as regras e a armadilha das capas.

Testes: painel 68/68, Clipador 279, Publicador 84.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 19:54:13 -03:00
co-authored by Claude Opus 5.5
parent 84f30bbc2d
commit f165659e4e
30 changed files with 1174 additions and 370 deletions
@@ -37,7 +37,7 @@ Painel (4500) = cérebro ──► Publicador (4530) = executor ──► YouTub
| Regras puras (horário bom, limite, ações do job, sincronização de cortes, leitura do resultado, reencaixe, idempotência) | `panel/src/lib/publishing-rules.ts` (`placeJob`, `nextFreeSlot`, `planClipSync`, `readPublisherJob`, `jobActions`, `aiGeneratedFor`, `tagsFromCaption`, `needsReflow`/`STALE_AFTER_MS`, `clientRefFor`, `mayBeLive`, `parseVideoUrl`) + `publishing-rules.test.ts` |
| Fila, aprovação, envio, episódio | `panel/src/lib/publishing.ts` (`approveJob`, `placeApproved`, `retryJob`, `sendDue`, `promoteDue`, `pollPublishing`, `finishFromPublisher`, `markPublished`) + `publishing-db.test.ts` |
| Pausar tudo, horários bons, fuso | `panel/src/lib/settings.ts` (tabela `app_settings`) |
| Banco | `panel/src/lib/db.ts`: **v5** (`account_networks` reconstruída sem `mock`, `publish_jobs`, `publications` com `clip_id`/`job_id`, `app_settings`, `clip_auto_approvals`, colunas novas em `accounts` e `episodes`), **v6** (`publish_jobs` reconstruída: `schedule_source` `auto`/`manual`/`now`, `cancel_reason` aceita `unlinked`) e **v7** (`publish_jobs.origin` `link`/`manual`, padrão `link`) |
| Banco | `panel/src/lib/db.ts`: **v5** (`account_networks` reconstruída sem `mock`, `publish_jobs`, `publications` com `clip_id`/`job_id`, `app_settings`, `clip_auto_approvals`, colunas novas em `accounts` e `episodes`), **v6** (`publish_jobs` reconstruída: `schedule_source` `auto`/`manual`/`now`, `cancel_reason` aceita `unlinked`), **v7** (`publish_jobs.origin` `link`/`manual`, padrão `link`) e **v8** (`metric_syncs`) |
| "Publicar" no cartão do corte (sem fonte ligada) | UI `panel/src/components/clip-publish.tsx` (`ClipPublishButton` + diálogo; usado em `clipper-queue.tsx`, em `approved` e, como "Publicar em outra rede", em `published`; `useClipPublishing().reload()`); cliente `publishClip` em `publishing-client.ts`; rota `POST /api/publishing/clips/[id]` (`app/api/publishing/clips/[id]/route.ts`); servidor `publishClip` em `publishing.ts` |
| Guarda da API do painel | `panel/src/proxy.ts` (Next 16: o middleware se chama `proxy`; `checkRequest` exportado) + `proxy.test.ts`; `readJson` em `panel/src/lib/http.ts` (415 sem JSON) |
| Rotas | `/api/settings` e `/api/settings/apps/[platform]`, `/api/publisher/status`, `/api/publishing/jobs[/[id][/[action]]]`, `/api/publishing/summary`, `/api/episodes/[id]/approve`, `/api/accounts/[id]/networks/[platform]/(connect|token|check|reopen|creator-info)` |
@@ -75,12 +75,24 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
cortes do intervalo desligado). Cancelar no meio de um ciclo vale (UPDATEs condicionais; se o Publicador já criou o
envio, o painel cancela lá). Aprovação automática é registrada em `clip_auto_approvals` antes do PATCH no Clipador.
- **Botão "Publicar" do corte** (`POST /api/publishing/clips/<id>`, corpo `{accountId, platforms[], timing?: "now"|"best_slot"}`,
resposta `{jobs, skipped[{platform, reason}], placed}`; `publishClip`): serve para corte aprovado cuja fonte **não** está
resposta `{jobs, skipped[{platform, reason}], placed}`; `publishClip`; `timing` também aceita `"at"`, ver abaixo): serve para corte aprovado cuja fonte **não** está
ligada a canal (`account_channels`) ou para outra rede. O clique é a aprovação humana. `timing` omitido = o do canal.
`"now"` força `queued` com `schedule_source='now'` e ignora o limite do dia. Job existente cancelado, `failed` ou
`needs_login` é reaproveitado (`attempts`+1 via `placeApproved`, que ganhou `opts.timing`); rede não conectada,
pausada, já publicada, na fila, agendada, enviando ou "pode ter saído" (`mayBeLive`) entra em `skipped` com motivo.
O diálogo lista essas redes bloqueadas com o motivo. Título e legenda são os do cartão.
- **"Horário específico"** no diálogo do corte: `timing: "at"` + `scheduledAt: { youtube?, tiktok?, instagram? }` (ISO, um
por rede escolhida, obrigatório para cada uma). `ClipTiming = PublishTiming | "at"` (`publishing.ts` e
`publishing-client.ts`; o "quando sai" do canal continua `now|best_slot`). `readChosenTimes` ⇒ `UserError` em português
para rede sem horário, horário passado (> 1 min) ou além de 1 ano. `placeApproved` com `preferredAt` (mínimo agora+5 s)
⇒ `scheduled`, `schedule_source 'manual'`, "Agendado por você."; ignora horário bom e limite do dia (como "now"). Rede
já `scheduled`/`queued` sem `publisher_job_id` é reagendada. UI: terceira opção, `datetime-local` (sugestão: próxima
hora cheia ≥ 30 min, horário do navegador); com mais de uma rede, "Horário diferente para cada rede". `toLocalInput()`
agora é export de `publishing-client.ts`. Testes: 2 em `publishing-db.test.ts` ("horário específico: …"); painel 68/68
(informado, `npx tsx --test src/lib/*.test.ts`; não reexecutado).
- **Capa do corte publicado** (gotchas 155): `clipCover()` copia a capa para `output/publishing/covers/clip-<id>.<ext>`
(`keepCover`); `keepClipCovers()` roda no início de `syncClips` e migra jobs antigos; `metrics.ts` só devolve capa que
existe no disco.
- **`publish_jobs.origin`**: `link` (criado pelo vínculo fonte↔canal) ou `manual` (botão "Publicar"). Job `manual` **não**
é cancelado por "fonte desligada" (`planClipSync` com `ExistingJob.origin`, `linkActive`, `accounts.endChannel` só
cancela `origin = 'link'`); corte editado, rejeitado ou apagado ainda cancela o job. Armadilha de migração: gotchas 138.
@@ -116,7 +128,8 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
- **Primeiro envio real (TikTok, modo sessão, 17/11/2026 13:35):** público, `https://www.tiktok.com/@vortplay/video/7709179978520284437`
(informado; login, upload, legenda, privacidade e "Publicar" funcionaram com conta real). O job terminou `failed` por falta
do link (gotchas 140) e foi marcado como publicado pela rota acima. Seletores do TikTok validados nesse envio; **YouTube e
Instagram em modo sessão: só o ensaio sem publicar (próxima regra); YouTube segue sem validação.**
Instagram em modo sessão: só o ensaio sem publicar (próxima regra). YouTube: o vídeo saiu em envio real, mas o painel não
confirmou (regra "YouTube Studio"); a confirmação nova não foi testada.**
- **Instagram em modo sessão** (`publisher/app/platforms/session/instagram_web.py`; layout novo de 17/11/2026, barra
lateral só de ícones). Fluxo: o botão é `<a>` com `<svg aria-label="Postar">` e abre DIRETO o diálogo "Criar novo
post" (sem submenu; `create_post` só para o layout antigo), com o `input[type=file]` dentro do diálogo.
@@ -153,6 +166,57 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
roda antes da legenda e antes de "Publicar". `TIP_BUTTONS` só aceita `^(Entendi|Entendido|Ok, entendi|Got it)$`:
**nunca aceitar ou recusar opções por esse caminho**, só fechar avisos. Gotchas 142.
- **YouTube Studio (modo sessão): confirmar a publicação** (`youtube_studio.py`; gotchas 151). O `#done-button` é um
componente `ytcp-button`, não um `<button>` nativo: o Playwright clica mesmo desativado e o clique se perde.
`is_enabled`/`wait_enabled` leem `disabled`/`aria-disabled` do elemento e do `<button>` de dentro e esperam até 10 min;
`dismiss_tips` + `click_through` rodam antes do clique. `confirm_published(page, done, sleep, checks=45, retry_at=8)`
(45 checagens de 2 s) conta como publicado a caixa "Vídeo/Short publicado", "ainda está sendo processado" ou a caixa
de envio fechar (o botão sumir); se o botão continua na tela e liberado depois de ~16 s, clica de novo UMA vez (o
vídeo já existe, não duplica). O erro final traz o link visto antes do clique e manda usar "Já saiu: informar o link".
Teste: `test_youtube_confirms_when_upload_box_closes_and_retries_once` (`publisher/tests/test_browser.py`). Só vale
depois de reiniciar o `pnpm dev`; **não testado num envio real**.
## Números dos posts (views, curtidas, comentários)
Fluxo: despachante → `collectMetrics` → Publicador lê → grava `publication_metrics` (`simulated = 0`, `INSERT OR REPLACE`).
- **Publicador**: rota `POST /v1/profiles/{id}/stats`, corpo `{ids: [...]}`, resposta `{capturedAt, items[{remoteId, views,
likes, comments, shares, saves}], missing}` (`Publisher.post_stats` em `service.py`). Arquivos: `app/platforms/stats.py`
(`PostStats`, `parse_count`, `youtube_public`, `youtube_from_html`) e `app/platforms/session/stats.py` (`tiktok_stats`,
`tiktok_row_stats`, `instagram_stats`, `instagram_media`, `READERS`). `SessionRunner.read_stats` usa a trava de
navegador, espera um envio até 120 s e fecha a janela só se ela não estava aberta antes. Testes:
`publisher/tests/test_stats.py`; `pnpm test:publisher` → **83 passed** (reexecutado na skill, 17/11/2026).
- **Como cada rede é lida** (medido com conta real, 17/11/2026):
- YouTube: página pública `watch?v=` sem navegador dá `viewCount` e `likeCount` exatos; comentários só arredondados
("5,2 mil"). Funciona em qualquer modo.
- TikTok: a página pública devolve só verificação (1,4 KB): precisa da janela logada. Em `/tiktokstudio/content`, cada
linha `data-tt="components_RowLayout_FlexRow"` tem o link `/video/<id>` e termina em "Todos\n<views>\n<curtidas>\n<comentários>".
~4 s.
- Instagram: sem login não há números. Pela aba Reels do perfil a página chama `/api/graphql` com `code`, `play_count`
(views), `like_count`, `comment_count`; a grade mostra só views ("1.499"). **A grade aparece ANTES da resposta da API**:
parar ao achá-la perde curtidas e comentários. Por isso a API tem prioridade e a grade é reserva, depois de 3 voltas.
~15 s.
- Modo oficial do TikTok/Instagram: ainda não lê (409 "por enquanto só funciona no modo Sessão logada").
- `parse_count`: "1.499" → 1499, "1,2 mil" / "1.2K" → 1200, "3,4 mi" → 3400000.
- **Painel**: migração **v8** (`metric_syncs`: account_id, platform, last_run_at, last_ok_at, last_error, read_count,
missing_count). `panel/src/lib/metrics-sync.ts`: `collectMetrics({accountId?, force?})` nunca roda duas ao mesmo tempo
(estado em `globalThis`) e para em 503; `autoCollectMetrics` é chamado sem `await` no fim do `dispatcherTick`, no máximo
a cada 10 min. Configuração `metricsEveryHours` (0/3/6/12/24; padrão 6; `app_settings.metrics_every_hours`): a automática
lê só posts dos últimos 90 dias; o botão lê todos. Rota `/api/dashboard/metrics`: GET `{running, syncs}`; POST lê tudo agora.
`lib/metrics.ts` `dashboard()` ganhou `byVideo` (um por corte/episódio, total e números por rede; título de
`publish_jobs.title`) e `syncs`.
- **UI**: `VideoTable` (`components/metrics-view.tsx`: colunas YouTube/TikTok/Instagram com link, total, curtidas,
comentários); `MetricsSyncControls` (`dashboard-controls.tsx`: "Atualizar números agora", "lido há X h" ou o erro de
cada rede); card "Números das redes" em Configurações → Publicação. Cards de episódio e história somem sem dados.
- Painel: `test:panel` 66/66 e typecheck verde (informados, não reexecutados). Não verificado: leitura automática com o
painel ao vivo.
## Botão "Publicar no <rede>" nos cartões de Publicações
`components/publishing-board.tsx`: para cortes, mostra as redes conectadas e ligadas do canal que ainda não têm job do
corte (job cancelado conta como livre). Confirma com `askConfirm` e chama `publishClip(clipId, {accountId, platforms:
[rede], timing})` com o timing do canal ("now" ou "best_slot"). O quadro carrega `/api/accounts` junto com o status.
## Fatos das plataformas (resumo; detalhe e fontes em `doc/publicacao/PESQUISA.md`)
- YouTube: projeto não verificado já publica público (desde 02/11/2026); `videos.insert` 100 envios/dia; app em