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:
@@ -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.
|
||||
Reference in New Issue
Block a user