João Henrique
63e5e3c22b
- corrigido o carregamento automático do plano editorial salvo após carregar a análise do Scanner - corrigido erro que impedia ler a saída do carregador de planos no painel Resumo: - 3 arquivos alterados - 0 novos - 3 modificados - 0 removidos 3 files changed, 13 insertions(+), 1 deletion(-) Arquivos: - .jhonny/analises.db - CONTEXT.md - code/cep-plugin/main.js
4.3 KiB
4.3 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_ide nomeada pelo camposequencia. - Projeto de edição: unidade de trabalho que contém exatamente uma sequência, suas escolhas de faixas e clipes, e os planos editoriais associados; uma sequência pode usar vários arquivos de mídia.
- Arquivo de mídia: arquivo físico de vídeo ou áudio usado por um ou mais clipes da sequência; não é sinônimo de projeto nem de sequência.
- 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.
- Trilha musical: obra sonora catalogada para possível uso como música de fundo; possui identidade própria e não depende de um projeto de vídeo.
- Catálogo de trilhas: conjunto pesquisável de trilhas musicais e suas análises, separado do índice de conteúdo dos vídeos.
- Análise musical: observações calculadas a partir do sinal de áudio, como BPM, tonalidade, gênero, humor e intensidade; tags do arquivo não são evidência da análise.
- Etiqueta musical: classificação produzida por um modelo para uma trilha, sempre acompanhada do tipo, da confiança, do provider e da versão do modelo.
Decisões atuais
- A arquitetura Python ficará isolada em
code/engineenquanto 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.
- Cada projeto possui uma única sequência, mas pode reunir vários arquivos de mídia e vários clipes dessa sequência; a seleção do projeto nunca deve misturar timelines diferentes.
- 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. - O catálogo de trilhas musicais é independente dos projetos de edição e não possui
video_idna sua unidade principal. - A identidade da trilha deve usar uma impressão digital do conteúdo; o caminho do arquivo é uma localização mutável e não a identidade definitiva.
- O banco deve guardar referências ao arquivo, descritores compactos, etiquetas com proveniência e versões das análises; não deve guardar o áudio binário.
- Uma mesma trilha pode ter várias análises, produzidas por providers ou versões de modelos diferentes. O resultado ativo deve ser selecionável sem apagar o histórico.
- O vínculo entre uma trilha musical e um projeto de edição será criado posteriormente em uma relação própria, permitindo reutilização da mesma trilha em vários projetos.