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.