# EDIÇÃO DE CONTEÚDO LM SHIRT REVIVALIST — MANUAL COMPLETO
**Tudo o que existe sobre como se edita um vídeo da LM, num só documento.**
Compilado a 09/08/2026 a partir de: as diretrizes do dono desde o início da operação · três gerações de pipeline (V1→V2→V3) · a auditoria independente P2 · e os **104 vereditos do dono** na revisão de 09/08, que são a prova empírica mais valiosa que existe.
Universal: colável em qualquer modelo com visão, em qualquer plataforma.

---

# PARTE I — O QUE É UM VÍDEO LM

Um reel vertical 9:16 (1080×1920), **14 a 22 segundos**, **sem música** (decisão fechada — o áudio não se adiciona), que conta UMA história: **uma camisola de futebol a ser transformada**.

Dois tipos de trabalho, e a distinção governa tudo:
- **Personalização (tipo A)** — nameset novo numa camisola lisa. O "antes" é a camisola **em branco**.
- **Restauro (tipos B1–B4)** — devolver o que estava danificado. O "antes" é o estado **degradado**.

O espetador tem de sair a perceber três coisas: o que a peça **era**, o que lhe **foi feito**, e como **ficou**. Falta uma ponta, o vídeo falhou — por muito bonito que esteja.

---

# PARTE II — A LEI Nº1, PROVADA POR 104 VEREDITOS

Na revisão de 09/08 o dono viu 104 reels: aprovou 35, mandou corrigir 31, rejeitou 38.
**Nos 31 "MUDAR", a falha dominante — em pelo menos 16 casos, mais de metade — é sempre a mesma:**

> ## ❌ NÃO MOSTRA A PEÇA RESTAURADA NO PLANO FINAL
> falta o depois · falta a traseira estampada · falta a frente restaurada · o "depois" é fraco

As palavras dele, caso a caso: *"falta traseira restaurada"* · *"falta o Ronaldo estampado nas costas"* · *"falta frente restaurada"* · *"não mostra o depois"* · *"falta costas completas no fecho"* · *"mostra a parte não restaurada várias vezes"* · *"falta antes/depois frente e trás"* · *"quase aprovado — só falta mostrar a frente restaurada no final"*.

**A regra que daqui sai, e que vale mais do que todas as outras juntas:**

> **Um reel LM não pode fechar sem um plano PARADO, LIMPO e SEM MÃOS da peça acabada — frente E costas, com o trabalho (nameset ou patrocínio) legível.**
> Se o vídeo não tem esse plano, usa-se uma **FOTO**. Se não há foto, o reel não está pronto.

Segunda falha mais citada: **foco a mais no processo** (*"foco a mais na prensa"*). O processo prova-se, não se contempla.

---

# PARTE III — A ESTRUTURA (a lei das cinco batidas — definitiva, 10/08/2026)

O dono ditou-a doze vezes na revisão dos 132. Não se reinterpreta, não se decora com ganchos, não se pede outra vez:

```
1 · ANTES FRENTE   → peça por restaurar, frente
2 · ANTES TRÁS     → peça por restaurar, costas
3 · PRENSA         → o momento do trabalho (se a pasta o tiver; sem ele, salta-se — decisão nº8)
4 · DEPOIS FRENTE  → peça acabada, frente
5 · DEPOIS TRÁS    → peça acabada, costas — é aqui que o reel fecha
LOGO LM (2,0s)     → fecho de marca, inteiro. Sem watermark durante o vídeo.
```

**São CINCO tempos, não seis. O reel abre no ANTES FRENTE — não leva gancho nenhum à frente**, nem das costas, nem do resultado. O primeiro 203 renderizado levou um sexto tempo à frente e foi por isso que o dono perdeu a paciência.

**"Fora da prensa" define os tempos 1, 2, 4 e 5:** peça pendurada ou pousada limpa, sem mãos, sem braços ou pernas. Um plano da peça deitada na prensa NÃO conta como antes nem como depois, mesmo com o restauro visível.

O motor foi alterado (10/08, autorizado): `result_side_order` fecha agora em DEPOIS TRÁS. Não reverter.

**Duração do reel principal: 14–17s** (decisão nº4 — o `qa_check` não se mexe). Antes e prensa até 2,5s por plano; depois entre 2,0 e 3,5s; foto com zoom/pan vale como plano.

## O REEL-FLASH (segunda peça de media, definida 10/08)
Um segundo vídeo por projeto, **só de fotos**, para alternar com os reels principais — foge da prensa, vive do contraste, e é curto para impacto:

```
ANTES FRENTE → ANTES TRÁS → DEPOIS FRENTE → DEPOIS TRÁS → LOGO LM
MÁXIMO 8 SEGUNDOS — nem isso. Quatro fotos e o logo.
```
Não passa pelo `edit_reel.py` (o mínimo de 14s do qa_check não se aplica) — monta-se direto por ffmpeg.

## A ESTRUTURA FINAL DO PROJETO — o que cada camisola aprovada produz
| # | Media | Formato | Especificação |
|---|---|---|---|
| 1 | **Reel principal** | 9:16 | as cinco batidas, 14–17s — o que o dono aprova |
| 2 | **Reel-flash** | 9:16 | 4 fotos + logo, ≤8s |
| 3 | **Grelha de 4 fotos** | 4:5 | antes-frente · antes-trás · depois-frente · depois-trás (capa do carrossel) |

As mesmas 4 fotos alimentam o flash e a grelha. Se um projeto não tiver as 4 fora da prensa, entra na lista de refilmagem — não se força.

**Ritmo — nas palavras do dono: "momentos estáticos, repetição, lento".**
- Nunca mais de **2 planos consecutivos da mesma vista**, mesmo vindos de clips diferentes.
- Nenhuma vista repete sem informação nova (geral → closeup é informação nova; geral → geral igual não é).
- 5+ frames quase idênticos seguidos (≥2,5s parados) = plano morto = corta.
- Tempo cortado devolve-se ao **antes** e ao **depois**. Nunca ao processo.
- ⚠️ **Armadilha do pipeline:** se o total descer abaixo do mínimo interno do `edit_reel.py` (14s), ele **acrescenta planos sozinho** e volta a meter repetições. Um reel honesto de 8–12s é MELHOR que um de 14s enchido: nesse caso baixa o mínimo no pipeline ou dá mais respiração ao antes/depois com zoom/pan — nunca aceites os planos que ele acrescenta.

---

# PARTE IV — AS PROIBIÇÕES ABSOLUTAS
Uma basta para reprovar.
1. **Cara ou cabeça do dono** — inteira, parcial, de perfil, desfocada, **refletida** em vidros/espelhos/ecrãs. Na dúvida, é cara.
2. **Pés ou pernas em destaque.** Outras pessoas.
3. **Cigarro, charro, fumo, isqueiro, álcool** em qualquer frame.
4. **Clips de outra camisola.** Aconteceu: um reel do Mathieu levava uma camisola do Nani; o `024_inter_2015_16_away_icardi` misturava Kane/Inglaterra com Icardi/Inter e foi **rejeitado sem apelo**.
5. **Texto interno queimado no vídeo:** "REVISAO MANUAL", "None", "?", "VERSION", nomes de pastas, estados de pipeline.
6. **Nome de cliente tratado como conteúdo.** A peça publica-se; o cliente nunca se identifica.

**O que É permitido:** mãos a trabalhar nos planos de processo — são o ofício. Só não podem tapar o "depois".
**O que NÃO é defeito:** as camisolas penduradas **ao fundo** do plano são decoração intencional da oficina (há uma do Messi). Nunca contam. Só conta a peça **em foco**.

---

# PARTE V — O TÍTULO (0–3s)
- Linha 1: **JOGADOR + NÚMERO lidos do que está ESTAMPADO na camisola no próprio vídeo.** Linha 2: CLUBE + ÉPOCA.
- **Nunca do nome da pasta.** Os nomes das pastas mentem. Casos reais: um reel ia sair a chamar **"RONALDINHO 6" a uma camisola estampada IBRAHIMOVIC 9**; outro saiu como "VERSION"; dezanove tinham "REVISAO MANUAL" queimado.
- Sem certeza do jogador ou do tipo → **uma linha só** (CLUBE ÉPOCA).
- A época confirma-se por evidência **na peça** (patch de final com data, patrocinador da era certa), nunca por palpite.
- O dono reprovou reels **só** por causa do título: *"vídeo perfeito, só o título está errado"* (Portugal 08 away) e *"só o título/display está mal, resto ok"* (Portugal 2018).
- Estilo fixo: caixa escura em baixo à esquerda, dentro das safe zones (nada nos 250px inferiores nem nos 220px superiores).

---

# PARTE VI — A CAMISOLA CERTA
O teste que derrotou duas auditorias automáticas.

**Compara cada plano com as FOTOS DA PASTA FONTE — nunca os planos uns com os outros.** Se todos os planos forem da mesma camisola errada, a comparação interna passa e o erro publica-se. Foi o que aconteceu com o "Benfica 06/07 Rui Costa", que ia sair com uma foto de outra peça e sem nunca mostrar o patrocínio — apanhado pelo dono em dez segundos.

Confere por plano: cor, marca, emblema, patches, gola, patrocinador frontal, patrocinador traseiro, nameset, e sinais da peça física (desgaste, vincos).
⚠️ **Cuidado com irmãs:** a biblioteca tem várias unidades do mesmo clube/época ("Version 2/3"). É o engano mais provável.

---

# PARTE VII — VERIFICAÇÃO FINAL
**O único objeto que existe é o MP4 final renderizado.** Nem manifesto, nem seleção, nem intenção.

```
ffmpeg -i reel.mp4 -vf "fps=2,scale=240:-1,tile=6x5" grelha.jpg
```
Olha para a grelha e responde por escrito:
□ É a peça da ficha em todos os planos em foco?
□ O trabalho aparece legível num plano limpo?
□ Antes e depois com contraste claro?
□ **O fecho tem frente E costas acabadas, sem mãos?** (a lei nº1)
□ Título correto e legível 0–3s, batendo com o que está estampado?
□ Zero caras, pés, substâncias?
□ Sem frames pretos, congelados, saltos, costuras ou planos mortos?
□ Logo LM inteiro a fechar?

Falha qualquer uma → corrige e **re-verifica o novo MP4**. Máximo 3 voltas; à terceira, escala ao dono com a grelha.
**Guarda a grelha + o veredito escrito.** Sem recibo, o vídeo não está feito.

> **Quem edita nunca se aprova sozinho em lote.** Uma sessão deu PASS a 108 vídeos seus; a auditoria independente achou 30 defeitos; e o dono, depois, rejeitou 38 e mandou corrigir 31. Cada camada apanhou o que a anterior deixou passar.

---

# PARTE VIII — A CAUSA A MONTANTE (para o dono)
**30 dos 45 reels da V3 só conseguiram fechar porque havia FOTOS.** Onde não havia, o "depois" ficou pousado na prensa — que é exatamente a falha nº1.

> ## 📸 A REGRA QUE MUDA TUDO
> **No fim de cada peça: 2 fotos — frente e costas, penduradas, sem mãos.**
> Dez segundos por camisola. Resolvem sozinhas o defeito mais comum de toda a biblioteca.

Guião completo por peça: ①antes frente ②antes costas ③processo ④depois frente ⑤depois costas ⑥closeup nameset ⑦closeup patrocínio. Pendurado, fundo limpo, vertical, sem caras nem pés.

---

# PARTE IX — VEREDICTOS E FORÇA
`APROVADO` (passa tudo) · `MUDAR` (matéria boa, montagem falha — diz o quê, com timestamp) · `ESCALAR AO DONO` (falta material; propõe a solução, quase sempre "uma foto resolve") · `FORA` (proibição insanável, camisola errada sem alternativa, réplica óbvia, ou estampagem falhada).

**Força 1–5** para ordenar publicação: 5 = contraste antes/depois óbvio + nameset/patrocínio bem legíveis + peça desejável (clube grande, estrela, nostalgia).

---

# PARTE X — COMO SE APLICA ISTO A UM REEL NOVO

As Partes I a IX dizem **o que é** um vídeo LM. Esta diz **o que se faz**, por ordem, desde a camisola em cima da bancada até ao post publicado. Vale para todos os reels de hoje em diante, sem exceção.

## Passo 0 — Captura (o dono, na oficina)
É aqui que 80% dos problemas se resolvem ou se criam. **Antes de começar a trabalhar a peça**, o antes já tem de estar filmado — depois não há volta atrás.

Sete planos por peça, pendurada, fundo limpo, vertical, sem caras nem pés:
①antes frente ②antes costas ③processo ④depois frente ⑤depois costas ⑥closeup nameset ⑦closeup patrocínio.

**④ e ⑤ podem ser fotos.** Dez segundos. São a lei nº1 e o defeito mais comum de toda a biblioteca.

## Passo 1 — Porta de entrada: a peça tem material?
Antes de qualquer edição, responde a **uma** pergunta:

> Existe um plano ou foto da peça **acabada**, parada, sem mãos, **frente e costas**, com o trabalho legível?

**Não → a peça NÃO entra em edição.** Vai para a lista de refilmagem. Editar sem isto é fabricar um "MUDAR" — foi assim que se acumularam 66 reels para corrigir.
**Sim →** segue. Classifica o tipo (personalização / restauro) porque governa o que é o "antes".

**Regras de material (decisões do dono, 10/08/2026):**
- **O antes pode ser FOTO** com zoom/pan aplicado — vale tanto como clip. O mesmo já valia para o depois.
- **O processo é opcional.** Sem prensa nem peel no material, a peça continua COMPLETA se tiver antes e depois.
- Peças com nome próprio de cliente publicam-se **se o trabalho for bom**; o cliente nunca se identifica.
- Um **name & number swap** é UMA peça: o antes tem legitimamente um nameset diferente do depois (caso Gary 78 → Quaresma 10). Não confundir com material misto, que são duas peças físicas.

## Passo 2 — Montagem
Estrutura da Parte III, proibições da Parte IV, título da Parte V. Concretamente:
1. `ffprobe` a cada clip que vais usar — janelas forçadas não podem exceder a duração real.
2. Escolhe os planos e escreve-os em `reel_edit_overrides.json`. Compara sempre com as **fotos da pasta fonte** (Parte VI), nunca os planos uns com os outros.
3. Lê o título **do que está estampado na peça**, no próprio vídeo. Grava-o em `overlay_overrides.json`.
4. Render com `edit_reel.py --triage-v2`.
5. Se o total ficar abaixo de 14s, **não deixes o pipeline preencher** — estica os planos bons.

## Passo 3 — Verificação (nunca se salta)
Grelha de frames do **MP4 final** e as 8 perguntas da Parte VII, respondidas por escrito. Guarda grelha + veredito. Máximo 3 voltas.

**Quem monta não se aprova a si próprio em lote.** Um modelo monta, outro julga, o dono decide. As três camadas existem porque cada uma apanhou o que a anterior deixou passar.

## Passo 4 — Embalagem (faz-se NA MESMA SESSÃO da montagem — pacote completo)
Um reel sem legenda e capa não está feito. Quem monta, embala:
- **Legenda** — abertura descritiva (o que a peça é, em linguagem de pessoa) + o trabalho feito + `Guarda para veres o processo.` (ou `Disponível — link na bio.` se estiver à venda) + 5 hashtags. **Nunca duas legendas com a mesma frase de abertura.**
  **Factos históricos: só se forem inequívocos** — patch de final com data, época de título famosa, evidência na própria peça. Sem certeza absoluta, legenda simples e honesta. **Proibido pesquisar por palpite ou inventar.** Um facto errado custa mais do que uma legenda simples.
- **Capa 4 fotos** — `make_capa.py`, layout congelado, com nome do jogador.
- **4:5 para stories** — crop por ffmpeg.

## Passo 5 — Publicação
Rotas fixas, e só estas: **Instagram → Buffer · TikTok → Metricool · Facebook → Composio.** Media servida pela bridge do Lenovo (http-server, suporta Range/206 — obrigatório).
Formato padrão de cada peça: **1 post (reel) + 2 stories (grelha 4 fotos, depois o reel).**
O documento que manda é `SISTEMA\COMO_SE_PUBLICA.md`; ganha a qualquer outro que o contradiga.

## Passo 6 — Registo
Grava em `PUBLICACOES.json` **no momento**, não depois. É a única defesa contra republicar a mesma camisola — e já falhou uma vez, por eu ter deixado duas stories numa nota em vez do ficheiro.

---

## O bloco de arranque (colar em qualquer modelo, qualquer plataforma)
```
Vais editar um reel para a LM Shirt Revivalist.
LÊ PRIMEIRO E DE PONTA A PONTA: SISTEMA\EDICAO_LM_MANUAL_COMPLETO.md.

A LEI Nº1, acima de tudo o resto:
  Um reel LM não pode fechar sem um plano PARADO, LIMPO e SEM MÃOS da peça acabada
  — FRENTE E COSTAS, com o trabalho legível. Sem isso, o reel não está pronto.

Regras que se violam por distração e custam o reel inteiro:
  · O título lê-se do que está ESTAMPADO na camisola, NUNCA do nome da pasta.
  · Compara cada plano com as FOTOS DA PASTA FONTE, nunca os planos uns com os outros.
  · Zero caras, pés, cigarros, álcool, texto interno queimado, clips de outra camisola.
  · Processo ≤5s. O tempo que sobra vai para o antes e o depois.
  · O único objeto que existe é o MP4 final. Verifica-o em grelha e escreve o veredito.

Não publiques nada. Não te aprovas a ti próprio.
```

## Checklist de uma página
```
CAPTURA    □ 7 planos  □ depois frente E costas, sem mãos
ENTRADA    □ tem "depois" legível?  não → refilmagem, não editas
MONTAGEM   □ ffprobe  □ overrides  □ título do estampado  □ ≥14s sem preenchimento automático
VERIFICA   □ grelha do MP4  □ 8 perguntas por escrito  □ recibo guardado
EMBALA     □ legenda única  □ capa 4 fotos  □ 4:5
PUBLICA    □ IG-Buffer  □ TikTok-Metricool  □ FB-Composio  □ 1 post + 2 stories
REGISTA    □ PUBLICACOES.json na hora
```

---

# ANEXO A — PIPELINE LOCAL (torre)
- **Render:** `python pipeline/edit_reel.py "<pasta fonte>" --output "<...>/reel.mp4" --triage-v2 "<...>/GUARD/triagem_v2.json"` — sem a flag recusa-se a correr.
- **Planos forçados:** `pipeline/reel_edit_overrides.json` (chave = nome exato da pasta fonte; `hook` + `story_clips` com source/phase/side/start/end).
- **Títulos:** `pipeline/overlay_overrides.json` (`line_1_text`/`line_2_text`; linha 2 vazia = título de uma linha).
- **Capa 4 fotos:** `python pipeline/make_capa.py --titulo "CLUBE 00/00" --subtitulo "JOGADOR N — SHIRT RESTORATION" --tl <f1> --tr <f2> --bl <f3> --br <f4> --out <...>/POST_CARROSSEL/02_capa_4fotos.jpg` — layout **congelado**.
- **4:5 para stories:** `ffmpeg -i reel.mp4 -vf "crop=1080:1350:0:180" -c:v libx264 -crf 18 -an 01_reel_4x5.mp4`.

**Armadilhas do pipeline (todas custaram tempo real):**
1. Total <14s → o pipeline **acrescenta planos sozinho** e repete vistas.
2. Janela forçada não pode exceder a duração real do clip (ffprobe primeiro).
3. Rótulos `side` (front/back) da triagem **mentem** nalguns projetos — olha, não confies.
4. Após render fora do executor, **refrescar o hardlink** em `output/REVISAO_REELS/`.
5. `_V3_PROGRESSO.json` **não é fonte de verdade** sobre o que está montado — escondia 58 reels já feitos. A verdade é `os.path.isfile(pasta/reel.mp4)`.

# ANEXO B — CALIBRAÇÃO DE MODELOS NOVOS
Antes de confiar num modelo para julgar, testa-o: 6 grelhas com verdade conhecida em `output/BIBLIOTECA/00{1..6}*/GUARD/juiz_grid.jpg` — 2 aprovados (002, 004), 4 para re-editar (001 planos mortos, 003 e 006 sem fecho de costas, 005 sem contraste). Armadilhas: a camisola do Messi ao fundo no 001 e o "7" ao fundo no 003 — quem as marcar como defeito, falha. Pontuação em `SISTEMA/BAKEOFF_MODELOS_VISAO.md`. **Menos de 7/10 não julga sozinho.**
