Clipador: subpáginas, jogos, idioma por canal e juiz com Gemini e IA reserva

- Clipador em subpáginas (Cortes, Sessões, Fontes, Jogos, Ajustes) com moldura comum, lista + diálogo
  dos cortes e submenu na barra lateral.
- Perfis de jogo (o que a IA sabe de cada jogo), parar pausa o monitor e idioma por fonte e por canal
  de publicação (migração v9: accounts.language).
- Juiz: Gemini CLI como terceiro provedor e IA reserva por chamada — se a IA escolhida cair por cota,
  login, chave ou rede, a próxima da ordem de Configurações → IA responde (com pausa da que caiu).
  Lê data/ai/settings.json e o cofre data/ai/vault.bin (DPAPI) escritos pelo painel; contrato em doc/ia.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 01:51:12 -03:00
co-authored by Claude Opus 5.5
parent 2d8b1a582d
commit 0567c7454a
55 changed files with 6514 additions and 2506 deletions
+75
View File
@@ -0,0 +1,75 @@
# Clipador — perfis de jogo bilíngues, missões e gatilhos (18/11/2026)
## Pedido do dono
- Perfil do jogo em **português para ler** e em **inglês para a IA** (é o que vai nos prompts).
- Cadastrar **jogo novo** pelo painel (antes só nascia quando uma live trazia a categoria).
- **Missões** do jogo (quando já estão publicadas na internet) e **gatilhos de fim de missão**.
- Jogos em **lista**; clicar abre um **modal** (o cartão grande ocupava a tela).
- **GTA 6 completo**.
## Contrato (serviço `clipper/` ↔ painel)
### Perfil (mesmo formato nos dois idiomas)
```jsonc
{
"name": "Grand Theft Auto VI",
"aliases": ["GTA 6", "GTA VI", "GTA6"], // outros nomes: a categoria da Twitch e o que a IA vê na tela caem no mesmo jogo
"summary": "…", "genre": "…",
"mechanics": [], "clip_worthy": [], "avoid": [], "jargon": [], "news": [], "hashtags": [], "sources": [],
"missions": [ // [] quando ainda não há lista pública confiável
{ "name": "…", "chapter": "…", "summary": "…", "completion_triggers": ["…"] }
],
"end_triggers": ["…"] // sinais gerais de fim de missão/objetivo (banner, tela de resultado, fala)
}
```
### `GET /v1/games` — cada jogo
| Campo | O que é |
|---|---|
| `profile` | Perfil em **português** (o que o painel mostra). Jogos antigos: o perfil que já existia. |
| `profileAi` | Perfil em **inglês** (o que vai para a IA). `null` = ainda não traduzido (a IA usa `profile`). |
| `aiLanguage` | `"en-US"` |
| `translatedAt` | Quando a versão da IA foi gerada a partir da outra (ou vice-versa). |
| `aliases` | Atalho de `profileAi.aliases ∪ profile.aliases`. |
| demais | `id, name, status (pending/ready/error), error, model, researchedAt, editedAt, notes` (como antes) |
### Rotas
| Rota | O que faz |
|---|---|
| `POST /v1/games` `{name, notes?}` | Cadastra jogo (status `pending`) e pesquisa em segundo plano. 409 se já existe (inclusive por alias). |
| `POST /v1/games/{id}/research` | Pesquisa na web **em inglês** (missões e gatilhos inclusos) e traduz para português. |
| `PUT /v1/games/{id}?lang=pt\|en` | Grava a edição à mão no idioma `lang` (padrão `pt`) e traduz para o outro. Sem IA ligada: grava e marca a outra versão como desatualizada. |
| `POST /v1/games/{id}/refine` | Pedido à IA (em português): atualiza a versão em inglês e traduz para português. Resposta `reply` em português. |
| `POST /v1/games/{id}/translate` | Gera a versão em inglês a partir da portuguesa (jogos antigos). |
| `DELETE /v1/games/{id}` | Apaga o jogo (sessões não mudam; o perfil é pesquisado de novo se o jogo voltar). |
Detalhes da implementação (serviço):
- `POST /v1/games` responde `{games, id}` (201); `DELETE` responde a lista. `PUT ?lang=` aceita `pt` (padrão) ou `en`.
- `refine` aceita também as seções `missions`, `end_triggers` e `aliases`.
- Tradução que falha (ou IA desligada): a versão traduzida fica como estava (na pesquisa, as duas em inglês) e
`error` explica; `translatedAt` só muda quando a tradução deu certo. A tradução nunca mexe em nome, hashtags,
fontes e outros nomes, e é recusada se perder missões.
- Limites: até 120 missões, 8 gatilhos por missão (200 caracteres), 10 outros nomes, 12 `end_triggers`.
### Sementes
`clipper/app/seeds/games/*.json` (formato: `{name, aliases, researchedAt, sources, profileAi, profile}`) é
importado na subida do serviço **só se o jogo ainda não existe** (nunca sobrescreve edição). O GTA VI vem assim.
### Prompts
- O contexto da IA (`game_context`) usa `profileAi` (fallback `profile`), inclui `end_triggers` e as missões
(nome + gatilhos, limitado) e diz ao editor: corte de missão termina logo depois do gatilho de fim.
- Busca por nome casa `id` **ou** alias (categoria "Grand Theft Auto VI", tela "GTA 6" → mesmo perfil).
## Painel
- `/clipper/games`: tabela (nome, gênero, estado, missões, última pesquisa/edição) + "Adicionar jogo" (diálogo).
- Clique abre o **modal do jogo**: abas Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags ·
Fontes · Pedidos à IA; alternância **Português (você lê) / English (vai para a IA)**; ações Pesquisar de novo, Editar, Pedir à
IA, Apagar.
+64
View File
@@ -0,0 +1,64 @@
# Clipador — reorganização da interface (18/11/2026)
## Por que
A página `/clipper` cresceu por acréscimo: um resumo com 4 cartões, a barra da live, 5 abas, e dentro
delas cartões gigantes (um corte ocupa meia tela; uma sessão, uma tela inteira). Os cliques ficaram
confusos (ação primária e secundária no mesmo peso), a informação do corte aprovado se perde, e não há
lugar para o que vem a seguir: canais em outros idiomas (público gringo) ao lado dos canais em português.
## O que muda
### Navegação: subpáginas, não abas
| Rota | O que é | Conteúdo |
|---|---|---|
| `/clipper` | **Cortes** | Lista (uma linha por corte), filtros por etapa / fonte / sessão / idioma, ordenação. Clique abre o **modal do corte** (`?clip=ID`), com anterior/próximo para aprovar em sequência. Ações rápidas na linha (Aprovar, Rejeitar, Publicar). |
| `/clipper/sessions` | **Sessões** | Lista compacta (estado, fonte, duração, cortes, saúde em uma frase). "Gravar pelo link" vira um botão que abre diálogo. |
| `/clipper/sessions/[id]` | **Detalhe da sessão** | O que hoje é o cartão da sessão (saúde, "agora na live", chat/transcrição/IA/cortes, gráfico, emotes, câmera, jogo, configuração do corte) e os cortes dela. |
| `/clipper/sources` | **Fontes** | Lista das fontes (streamers): ao vivo/offline, monitor (ligado / **pausado** / desligado), autorização, idioma da live, canais de publicação ligados. "Adicionar fonte" em diálogo. |
| `/clipper/games` | **Jogos** | O que a IA sabe dos jogos (como hoje). |
| `/clipper/settings` | **Ajustes** | Juiz (IA), estado do serviço e das ferramentas, transcrição, idioma padrão. |
A sidebar mostra os subitens do Clipador quando ele está ativo; a mesma sub-navegação aparece no topo
das páginas, com contadores (para aprovar, gravando agora). O editor em tela cheia (`/clipper/edit/[id]`)
fica fora desse quadro (grupo de rotas `(studio)`).
### Hierarquia visual
- Um bloco **"Ao vivo agora · N"** acima do conteúdo em todas as subpáginas enquanto algo grava: uma linha
fina por live (nome, relógio, chat, "Cortar agora", Parar só com ícone). Pensado para 5 canais no ar ao
mesmo tempo sem tomar a tela. É a única coisa que precisa estar sempre à mão.
- O "Resumo" com 4 cartões sai. O estado do serviço vira uma linha discreta ao lado da sub-navegação
(ponto verde/vermelho + texto) e o detalhe mora em Ajustes.
- Listas antes de cartões: a lista mostra o que decide (título, nota da IA, situação, fonte, duração,
estado); o modal mostra o resto (vídeo, veredito completo, sinais, legenda, ajuste de trecho, transcrição,
publicação).
### Sessão: parar é parar
Hoje o monitor da fonte reabre uma sessão nova 60 s depois de você parar à mão, porque a live continua no ar.
Regra nova:
- **Parar à mão pausa o monitor daquela fonte** (`channels.monitor_paused_at` + a sessão que motivou). O
monitor pula a fonte enquanto a pausa existir. A fonte aparece como "monitor pausado · você parou a sessão
#11" com o botão **Religar**. Ligar o switch "Monitorar" também limpa a pausa.
- No diálogo de parar há a opção "voltar a gravar sozinho quando a live cair e voltar": marcada, não pausa.
- Queda de live (captura cai sem ninguém pedir) continua sendo **retomada na mesma sessão** (`interrupted`
→ `keep_live`), como já era. Isso é o "caso caia, liga".
### Idioma e público (preparação para canais gringos)
- **Fonte** e **sessão** ganham `language` (idioma falado na live; padrão `CLIPPER_LANGUAGE`). A transcrição
(Whisper) usa o idioma da sessão; os prompts da IA recebem o idioma de saída (título, legenda, hashtags).
- **Canal de publicação** (`accounts`) ganha `language` (idioma/público: pt-BR, en-US, es-419…). O diálogo
"Publicar" avisa quando o idioma do corte difere do idioma do canal.
- Lista de cortes e sessões filtram por idioma. Versões traduzidas de um corte (legenda queimada e textos em
outro idioma a partir da mesma sessão) são a **próxima etapa**; o modelo já tem onde encaixar.
## Arquivos
- Dados compartilhados: `panel/src/components/clipper-provider.tsx` (contexto + consulta periódica).
- Moldura: `panel/src/components/clipper-shell.tsx` (cabeçalho compacto, sub-navegação, barra da live).
- Páginas: `panel/src/app/clipper/(studio)/…`.
- Serviço: `clipper/app/worker.py` (pausa do monitor), `db.py` (colunas novas), `main.py` (rotas/visões).