Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/CHECKPOINT_DELTA.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Checkpoint Delta — CD06

## DIF-V2-WO-021 — Bíblia audiovisual, presets e herança (2026-11-20) — PROPOSED / NOT PROMOTED

- **Status:** auditoria round 1 **CORRECTION REQUIRED**; correções HIGH/MEDIUM aplicadas; CI final/reauditoria/merge pendentes. Sem deploy.
- **Base:** `main` `2fcfd89` (checkpoint WO-020 promovido); branch `feat/dif-v2-wo-021`.
- **Delivered:** presets versionados por série/temporada com revisão imutável e quota 200; overrides owner-only por episódio/cena com clear real e `reducedMotion` tri-state; precedência/origem/versão por campo; snapshot congelado no plano com opt-in explícito; legenda/fonte/área segura aplicadas no render; CTA/template no final; clipe-amostra sintético; `/app/style`; export/import JSON estrito; auditoria de SFX; 4 tabelas RLS.
- **Limits:** SFX/voz/capa/final permanecem referências para telas especializadas; amostra é sintética; backup/restore das novas tabelas não exercitado; sem backfill de séries existentes; falta E2E de render antigo byte-idêntico.
- **Gate:** pendente de CI/auditoria; WO-014 release segue bloqueada por OPS 015–021.

## DIF-V2-WO-020 — Laboratório de retenção (2026-11-20) — PROMOTED

- **Status:** **PROMOTED**; code/test head `02d9cae`; CI `44694433465` PASS (318+3 unit, PgTAP 229/229, E2E 18/18, Sonar PASS), docs-only `f22a4f7` CI `44696127263` PASS, policy 34/37; auditoria final **APPROVED WITH RESIDUALS**; squash-merged em `d9dd82b` (PR #67); issue #37 fechada.
Expand Down
21 changes: 21 additions & 0 deletions docs/EVIDENCE_BUNDLE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,26 @@
# DIF Studio — Evidence Bundle

## V2 WO-021 — Bíblia audiovisual, presets e herança (2026-11-20) — PROPOSED / NOT PROMOTED

- **Work Order:** `DIF-V2-WO-021` · issue #38 · epic #17
- **Base:** `main` `2fcfd89` (checkpoint WO-020 promovido); branch `feat/dif-v2-wo-021`
- **Status:** auditoria independente round 1 **CORRECTION REQUIRED**; correções HIGH/MEDIUM aplicadas; CI final/reauditoria, merge e promoção pendentes. Sem deploy.

| Check | Result | Evidence |
| ---------- | ---------- | ------------------------------------------------------------------------------------------ |
| Model | PASS local | presets + revisões imutáveis por série/temporada; overrides owner-only por episódio/cena |
| Precedence | PASS local | DEFAULT<SERIES<SEASON<EPISODE<SCENE, origem por campo, false/zero explícitos |
| Snapshot | PASS local | `styleBible` congelado, versão/origem por campo, opt-in explícito, drift no timeline |
| Config | PASS local | Zod estrito; enums/cores/templates/IDs; sem URLs, binários, shell ou filtros |
| SFX | PASS local | licença validada no save (unit), reauditoria na resolução com fallback warning |
| UI | PASS local | `/app/style` escopos, editor, clipe-amostra, revisões, clear de override, import/export |
| API | PASS local | `/api/style/[presetId]` owner-only, no-store, sem segredos |
| PgTAP | PASS local | 247/247 RLS, imutabilidade, concorrência, quota 200, clear owner-only |
| Policy | PASS local | 35 invariantes / 41 tabelas; backup/restore incluem as 4 tabelas |
| E2E | PASS local | duas séries, overrides, clear, export/import estrito, screenshots 360/768/1440 |
| CI | PENDENTE | quality/Sonar/E2E no HEAD final |
| Limites | — | render aplica cor/legenda/fonte; SFX/voz/capa/final são referências; backup não exercitado |

## V2 WO-020 — Laboratório de retenção (2026-11-20) — PROMOTED

- **Work Order:** `DIF-V2-WO-020` · issue #37 · epic #17
Expand Down
9 changes: 9 additions & 0 deletions docs/OPERATIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,15 @@ The Free project was backed up without relying on provider snapshots:

This procedure was executed against the hosted `dif` project and a local Supabase target on 2026-11-11; the restored counts matched the export, the owner login returned 200, anonymous REST returned 401, and the private Cloudinary image returned 235 bytes with a matching SHA-256. Auth passwords are intentionally re-provisioned, not copied from the backup.

## Bíblia audiovisual — retenção e cotas (WO-021)

- `style_presets` e `style_preset_revisions` são owner-read/service-write; revisões são imutáveis e nunca sobrescrevem um plano ou render antigo.
- Cada preset aceita até **200 revisões** (`style_revision_quota`). Ao atingir o limite, duplique o preset para continuar; não há poda automática de histórico aprovado.
- Overrides de episódio/cena são upserts pequenos, sem histórico próprio; `reducedMotion` aceita herdar/true/false. Enviar o formulário todo vazio chama `clear_*_style_override` e a camada volta a herdar.
- Planos novos congelam o estilo no primeiro save quando há preset/override configurado; sem estilo, nenhum snapshot é inventado. Planos existentes só recebem uma revisão nova quando o owner marca “Aplicar estilo atual” no timeline ou reconstrói; saves comuns preservam o snapshot. O render aplica cor, legenda, área segura e fonte ao snapshot; SFX/voz/capa/final continuam referências das telas especializadas.
- SFX referenciados são revalidados na resolução do snapshot. Assets removidos ou sem licença comercial/social são retirados do config efetivo com warning (`STYLE_SFX_UNAVAILABLE`/`STYLE_SFX_LICENSE`), sem alterar o preset aprovado.
- Backup/restore scripts incluem as quatro tabelas; a execução deste ciclo ficou pendente. Restaure presets antes das revisões e overrides depois de episódios/cenas para respeitar as FKs.

## Temporary public access via Cloudflare Tunnel (owner-authorized)

The owner may expose the local production server through a free Cloudflare quick tunnel for private use:
Expand Down
82 changes: 82 additions & 0 deletions docs/V2_STYLE_WO021.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# DIF-V2-WO-021 — Bíblia audiovisual, presets e herança

**Issue:** #38 · **Branch:** `feat/dif-v2-wo-021` · **Base:** `main` `2fcfd89`
**Status:** implementação concluída localmente; PR Draft/CI/auditoria independente pendentes. Sem deploy e sem promoção de checkpoint.

## Objetivo entregue

Uma camada única de identidade audiovisual por série/temporada, com revisões versionadas, overrides owner-only por episódio e por cena, resolução de precedência campo a campo, export/import JSON allowlisted e snapshot congelado dentro do plano de edição.

## Modelo de dados

| Tabela | Papel |
| ------------------------- | ------------------------------------------------------------------------ |
| `style_presets` | um preset por `(owner, scope_type, scope_id)`; escopos `SERIES`/`SEASON` |
| `style_preset_revisions` | histórico imutável (`DRAFT`/`APPROVED`), hash SHA-256 versionado |
| `episode_style_overrides` | override esparso por episódio, upsert com owner |
| `scene_style_overrides` | override esparso por cena, upsert com owner |

- RLS forçada e leitura owner-only; escrita apenas via RPC `SECURITY DEFINER` concedida a `service_role`.
- `save_style_preset_revision` exige `expectedRevision` (concorrência otimista, `40001`) e valida que o escopo pertence ao owner.
- Revisões são imutáveis (`55000` em UPDATE/DELETE), com bypass restrito a prune interno via GUC.
- Quota: 200 revisões por preset (`style_revision_quota`); presets são pequenos e o histórico aprovado nunca é descartado.
- Nenhuma URL, fonte binária, comando, filtro FFmpeg, JS/CSS ou asset sem licença é aceito: o config é um objeto Zod estrito de enums, cores `#rrggbb`, IDs de template conhecidos e IDs de SFX owner-scoped.

## Precedência e snapshot

`resolveStyle` aplica, nesta ordem: `DEFAULT < SERIES < SEASON < EPISODE < SCENE`. Cada campo recebe a origem (`sources[field]`) e valores explícitos como `false`/`0` não são confundidos com ausência.

`resolveEpisodeStyleSnapshot` considera apenas presets **aprovados** nas camadas série/temporada, aplica o override do episódio e congela:

- `presetId`, `presetRevision`, `presetHash`, `scopeType`, `scopeId`;
- `config` efetivo, `sources` e `versions` por campo (revisão da camada que venceu; `null` para default/override sem revisão);
- `scenes[]` com o config efetivo de cada cena que possui override, incluindo `sources` (`SCENE`) e `versions`;
- `warnings` (`STYLE_PRESET_MISSING`, `STYLE_SFX_UNAVAILABLE`, `STYLE_SFX_LICENSE`);
- `capturedAt` em UTC.

SFX são auditados no momento da resolução. Referências removidas ou sem licença comercial/social são retiradas do config congelado e geram warning legível, sem bloquear o render.

O plano novo grava `styleBible` no primeiro save quando há estilo configurado (`attachStyleSnapshot`) e entra no hash canônico. Planos existentes **preservam** o snapshot ao salvar edições comuns; aplicar uma revisão nova exige marcar “Aplicar estilo atual” (ou reconstruir), criando uma nova versão. Planos legados sem snapshot não são alterados silenciosamente: o timeline sinaliza a ausência e só aplica com opt-in. A cor do estilo é injetada apenas nessa aplicação; um color grade explícito é preservado.

Legendas e tipografia são aplicadas no render/export a partir do snapshot congelado (`applyStyleToCaptionTrack` + `buildCaptionAss`): `horror` → tratamento VHS, `clean` → limpo, área segura e fonte da bíblia. O `/app/finale` usa `endCardTemplateId` e `ctaPrompt` como defaults de um novo card; `/app/covers` pré-seleciona `coverTemplateId` quando há estilo; o `/app/style` mostra um clipe-amostra sintético com legenda, CTA, áudio do primeiro SFX (quando licenciado), capa aprovada renderizada, dados do final aprovado e áudio da narração aprovada; badges permanecem para voz/SFX. Voz e SFX continuam referências validadas para as telas especializadas; não são inventados automaticamente em jobs existentes.

## UI e API

- `/app/style`: seletor de escopo, editor completo, clipe-amostra sintético com paleta/tipografia/legenda/CTA e fatos aprovados (cor, SFX, voz, abertura, capa, final A/B, CTA), tabela de origem/versão por campo, revisões com aprovar/restaurar, importar, duplicar e exportar.
- Overrides de episódio e cena com formulários esparsos (“vazio = herdar”), `reducedMotion` tri-state (herdar/true/false), limpeza real via RPC quando todos os campos ficam vazios, seleção de cena e lista de cenas congeladas no snapshot.
- `/api/style/[presetId]`: JSON `dif-studio-style-preset/v1`, owner-only, `private, no-store`, sem binários/URLs/segredos; download opcional.
- Item “Estilo” na navegação do workspace.

## Testes e provas

| Suíte | Resultado |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Unit/domain `style-bible.test.ts` | 9 testes: precedência/versões, todos os 19 campos com cena vencendo, hash determinístico, import/export estrito, cenas congeladas, drift, fallback de SFX |
| Unit/actions `style-actions.test.ts` | 8 testes: save, override esparso, limpeza vazia, `reducedMotion=false`, SFX explícito, aprovação da revisão clicada, JSON inválido, conflito 409 |
| Unit/plan `video-edit-plans.test.ts` | 3 testes: opt-in explícito, snapshot no plano + injeção de cor, neutro/color explícito preservados |
| Unit/caption `style-caption.test.ts` | 3 testes: mapeamento horror→VHS, área segura e fonte no ASS; legado sem snapshot intacto |
| Unit/licença `style-bible.test.ts` | 2 testes: asset ausente e sem licença comercial/social antes de qualquer escrita |
| PgTAP `rls_and_integrity.sql` | **247/247** — RLS das 4 tabelas, revisão imutável, conflito, escopo inválido, leitura por owner, escrita direta negada, quota 200, clear owner-only |
| Policy audit | **35 invariantes / 41 tabelas** |
| E2E `style.spec.ts` | 2 séries com estilos distintos, sem contaminação; override de episódio/cena; export sem segredos; import DRAFT-only; títulos longos; screenshots 360/768/1440 |
| Build/typecheck/lint | `npm run build`, `npm run check`, `npm run lint` PASS |
| Suíte unit/integração completa | **350 passed + 3 skipped** |

## Matriz de aceitação

| AC | Estado | Evidência |
| --------------------------------------------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Duas séries com estilos radicalmente distintos, sem interferência | PASS local | E2E: Alfa (mono/horror/vermelho/CTA A) × Beta (serif/clean/verde/CTA B); previews e origem por campo divergem |
| Precedência correta; override de legenda da cena não muda preset da série | PASS | Unit (todos os campos) + E2E (override de cena, export da série mantém `horror`/`tiktok`) |
| Novo preset não muda renders/exports antigos; aplicar exige opt-in | PASS com residual | Snapshot/hash congelados; edições preservam o snapshot; “Aplicar estilo atual”/rebuild é o opt-in; helper testado. Falta E2E de versão antiga renderizada. |
| Export/import preserva referências válidas sem secrets/URLs; erro legível | PASS | Envelope e config Zod estritos, export owner-only, unidade de asset ausente/sem licença, E2E sem `http`/segredos |
| Previews refletem cor/áudio/capa/CTA aprovados; retenção/cotas documentadas | PASS com residual | Clipe-amostra sintético, áudio do SFX licenciado, capa aprovada via API, final aprovado, legenda/fonte no render e final usando CTA/template; voz tem áudio aprovado quando existe take READY. Quota 200 documentada. |

## Limites conhecidos (residuais)

- O render consome cor, estilo de legenda, área segura e fonte do snapshot; SFX, voz e templates de capa/final permanecem referências validadas para as telas especializadas e não são auto-injetados em planos existentes.
- O override de cena entra no snapshot com precedência, origem e versão, mas a aplicação por cena no MP4 depende de a cena estar no plano/render novo; planos já renderizados não mudam.
- A amostra do `/app/style` é sintética (CSS), não um frame real do episódio; a prova visual final é o MP4 renderizado.
- Backup/restore das novas tabelas está incluído nos scripts, mas não foi executado neste ciclo.
- Import/export cobre `schemaVersion: 1`; versões futuras devem ser rejeitadas e migradas explicitamente.
- Sem backfill de presets para séries existentes; a criação é manual e nenhum dado V1/cânone é migrado sem aceite.
Loading