chore: atualização geral

2026-08-19 16:35:29 -04:00
parent 8fca456ceb
commit e7748c2c58
66 changed files with 13037 additions and 4237 deletions
@@ -0,0 +1,65 @@
+# 08 — Formato de saída
+
+O produto do seu trabalho é **este JSON**. É ele que vai para o programa
+gerar o FCPXML. Você nunca escreve XML.
+
+## Estrutura
+
+```json
+{
+  "source": "0E6A8290.mp4",
+  "actions": [
+    {"kind": "cut",    "start": 21.9,  "end": 127.6,
+     "reason": "tomadas descartadas, frases interrompidas e conversa com a equipe"},
+    {"kind": "zoom",   "start": 2.0,   "end": 10.7,
+     "params": {"scale": 1.15}, "reason": "abertura: \"Aquela mama\" (ênfase 0.42)"},
+    {"kind": "text",   "start": 127.7, "end": 129.0,
+     "params": {"content": "MASTOPEXIA"}, "reason": "fixa o termo central"},
+    {"kind": "marker", "start": 21.85, "end": 22.0,
+     "reason": "EMENDA 1 — conferir junção entre tomadas"}
+  ]
+}
+```
+
+## Regras
+
+### 1. Tempos em segundos da mídia ORIGINAL
+Exatamente como aparecem no `voice_timeline.json`.
+
+**Nunca compense para "depois do corte".** O programa faz esse deslocamento
+sozinho: ele resolve os cortes primeiro e reposiciona todo o resto. Se você
+compensar por conta própria, **todo destaque cai no frame errado** — e o
+erro é silencioso.
+
+### 2. `end` sempre maior que `start`
+Ambos ≥ 0. Um `end <= start` é rejeitado.
+
+### 3. Tipos
+`cut` · `zoom` · `text` · `marker`
+
+### 4. Parâmetros por tipo
+
+| Tipo | `params` |
+|---|---|
+| `cut` | nenhum |
+| `zoom` | `scale` entre 1.0 e 3.0 (padrão 1.3 se omitido) |
+| `text` | `content` **obrigatório**, até 120 caracteres |
+| `marker` | opcional: `content` vira o nome do marcador |
+
+### 5. `reason` — sempre preencha
+É o que o usuário lê para revisar sua decisão, e o que te obriga a **ter**
+uma. Um `reason` vazio é sinal de decisão sem critério.
+
+Inclua o dado que embasou: *"abertura: 'Aquela mama' (ênfase 0.42)"* é útil;
+*"zoom"* não é.
+
+## Como o programa trata erros
+
+- **Ação inválida** → rejeitada e reportada **individualmente**. Uma linha
+  malformada nunca derruba as outras.
+- **Ação apontando para material cortado** → descartada e reportada, nunca
+  deslizada para o conteúdo vizinho.
+- **Ação fora da mídia** → reportada como não colocada.
+
+Você recebe o relatório dos três casos. **Repasse ao usuário** — nunca
+relate só os acertos.