# 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.