Files
jhonny-editor/CONTEXT.md
T
João Henrique a9e5b5ff58 feat: copiada a skill editar-por-voz e seus critérios para as skil
- copiada a skill editar-por-voz e seus critérios para as skills do projeto
- adaptada a skill editar-por-voz para usar o banco SQLite como fonte oficial
- corrigida a cópia do JSON do tipo de vídeo para priorizar clipboard Unicode
- criado carregador único do contexto de edição por voz a partir do SQLite
- criada entrada para registrar planos no SQLite e reaproveitar o mesmo plano na aplicação
- habilitado carregamento do plano editorial diretamente do SQLite na interface
- corrigido o bloqueio visual da etapa de carregamento do plano salvo
- configurado carregamento automático do plano salvo após selecionar a sequência
- documentada a sequência como raiz de retomada do fluxo de edição
- criada a estrutura local para análise de músicas instrumentais com Essentia

Resumo:
- 22 arquivos alterados
- 11 novos
- 11 modificados
- 0 removidos

 11 files changed, 270 insertions(+), 34 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - CONTEXT.md
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/README.md
  - code/engine/aplicar_plano_de_edicao.py
  - code/engine/integracoes/audio/__init__.py
  - code/engine/persistencia/consultas.py
  - code/engine/requirements-audio.txt
  - code/engine/testes/test_consultas_de_persistencia.py
  - code/tests/cep-tipos-video-encoding.test.ts
  - code/.jhonny/
  - code/engine/carregar_plano_de_edicao.py
  - code/engine/integracoes/audio/contratos.py
  - code/engine/integracoes/audio/modelos_de_analise_musical.py
  - code/engine/integracoes/audio/provider_de_analise_musical_essentia.py
  - code/engine/preparar_edicao_por_voz.py
  - code/engine/registrar_plano_de_edicao.py
  - code/engine/testes/test_analisador_de_musica_essentia.py
  - code/engine/testes/test_carregar_plano_de_edicao.py
  - code/engine/testes/test_registrar_plano_de_edicao.py
  - code/plugins/premiere-pro/skills/editar-por-voz/
2026-09-10 13:09:01 -04:00

2.4 KiB

Contexto do sistema

Vocabulário

  • Scanner: caso de uso que coordena a leitura, análise, decisão, planejamento, aplicação e validação de uma edição.
  • Sequência: timeline do Premiere e raiz operacional de um trabalho de edição; no banco é representada pelo vídeo identificado por video_id e nomeada pelo campo sequencia.
  • Edição de vídeo: versão da configuração editorial concluída para uma sequência; registra tipo, instruções e origem, mas não representa ainda uma aplicação na timeline.
  • Conteúdo: unidade analisável identificada por um content_id, com texto e metadados.
  • Análise: observações estruturadas produzidas a partir do conteúdo.
  • Decisão: escolha de ações editoriais baseada na análise e na configuração.
  • Plano de edição: sequência ordenada e auditável de operações.
  • Aplicador: módulo que executa um plano sobre um conteúdo.
  • Validador: módulo que verifica se o resultado satisfaz as invariantes do plano.
  • Provider de IA: adaptador opcional que fornece análise ou decisão assistida por modelo.
  • Transcrição: segmentos de texto sincronizados com um clipe, produzidos por um provider; não é decisão editorial.
  • Cena: intervalo contínuo da timeline com características visuais e/ou textuais semelhantes.
  • Evento: observação temporal detectada no áudio, texto ou vídeo; não implica corte.

Decisões atuais

  • A arquitetura Python ficará isolada em code/engine enquanto o sistema existente continuar em TypeScript.
  • O domínio não conhece filesystem, banco de dados, SDK de IA ou plataforma de edição; essas integrações entram por interfaces e adaptadores.
  • O primeiro fluxo é síncrono e determinístico, permitindo evolução posterior para operações assíncronas sem alterar o domínio.
  • A sequência é a unidade de retomada: ao selecioná-la, o sistema deve localizar a edição concluída mais recente, reutilizar suas análises e oferecer o plano pendente para aprovação e aplicação.
  • Uma edição concluída, um plano gerado e uma aplicação realizada são estados distintos e devem permanecer auditáveis; concluir a configuração não significa que o Premiere já foi alterado.
  • O plano deve evoluir para referenciar diretamente a versão de edição que o originou, além do video_id, para impedir que uma nova configuração editorial seja aplicada por engano sobre um plano antigo.