feat: aprimorado o preview de falantes na tela Refinar para reprod

- aprimorado o preview de falantes na tela Refinar para reproduzir os trechos do vídeo
- corrigida a leitura dos timestamps do preview de falantes usando os clipes do banco

Resumo:
- 5 arquivos alterados
- 1 novos
- 4 modificados
- 0 removidos

 4 files changed, 142 insertions(+), 3 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - code/cep-plugin/main.js
  - code/engine/persistencia/consultas.py
  - code/engine/testes/test_consultas_de_persistencia.py
  - code/engine/consultar_preview_de_falantes.py

code/engine/persistencia/consultas.py

@@ -135,6 +135,86 @@ class ConsultasDeAnalises:
             },
         }
 
+    def listar_intervalos_de_preview_dos_falantes(self, video_id: str) -> list[dict]:
+        """
+        Lista os intervalos dos falantes convertidos para o arquivo de vídeo.
+
+        Os segmentos de transcrição usam segundos da timeline e normalmente
+        pertencem a um clipe de áudio. A consulta encontra o clipe de vídeo
+        correspondente e calcula os segundos na origem usando os campos
+        ``inicio_na_timeline`` e ``inicio_na_origem`` da tabela ``clipes``.
+
+        Parâmetros:
+            video_id: Identificador do vídeo analisado.
+
+        Retorna:
+            Lista ordenada de intervalos com falante, tempos da timeline,
+            tempos no arquivo de origem e caminho do vídeo.
+
+        Pode gerar:
+            ErroDeConsultaInvalida: quando ``video_id`` estiver vazio.
+        """
+        self._validar_texto_obrigatorio("video_id", video_id)
+        linhas = self.conexao.execute(
+            """SELECT s.clipe_id, s.inicio, s.fim, s.falante,
+                      a.arquivo AS arquivo_do_audio,
+                      v.id AS clipe_de_video, v.inicio_na_timeline,
+                      v.fim_na_timeline, v.inicio_na_origem,
+                      v.fim_na_origem, v.arquivo AS arquivo_do_video
+                 FROM segmentos_de_transcricao AS s
+                 LEFT JOIN clipes AS a
+                   ON a.video_id = s.video_id AND a.id = s.clipe_id
+                 LEFT JOIN clipes AS v
+                   ON v.video_id = s.video_id
+                  AND v.inicio_na_timeline < s.fim
+                  AND v.fim_na_timeline > s.inicio
+                 LEFT JOIN faixas AS f
+                   ON f.video_id = v.video_id AND f.id = v.faixa_id
+                  AND f.tipo = 'video'
+                WHERE s.video_id = ?
+                  AND s.falante IS NOT NULL
+                  AND TRIM(s.falante) <> ''
+                  AND (f.id IS NOT NULL OR v.id IS NULL)
+                ORDER BY s.inicio, s.fim,
+                         (v.arquivo = a.arquivo) DESC, s.id""",
+            (video_id,),
+        ).fetchall()
+
+        resultado = []
+        vistos = set()
+        for linha in linhas:
+            chave = (linha["clipe_id"], linha["inicio"], linha["fim"], linha["falante"])
+            if chave in vistos:
+                continue
+            vistos.add(chave)
+            inicio_na_timeline = float(linha["inicio"])
+            fim_na_timeline = float(linha["fim"])
+            inicio_na_origem = linha["inicio_na_origem"]
+            fim_na_origem = linha["fim_na_origem"]
+            arquivo = linha["arquivo_do_video"] or linha["arquivo_do_audio"]
+            if inicio_na_origem is None:
+                inicio_no_arquivo = inicio_na_timeline
+                fim_no_arquivo = fim_na_timeline
+            else:
+                deslocamento = inicio_na_timeline - float(linha["inicio_na_timeline"])
+                inicio_no_arquivo = float(inicio_na_origem) + deslocamento
+                fim_no_arquivo = inicio_no_arquivo + (fim_na_timeline - inicio_na_timeline)
+            if fim_na_origem is not None:
+                fim_no_arquivo = min(fim_no_arquivo, float(fim_na_origem))
+            if not arquivo or fim_no_arquivo <= inicio_no_arquivo:
+                continue
+            resultado.append({
+                "clipe_id": linha["clipe_id"],
+                "falante": linha["falante"],
+                "inicio_na_timeline": inicio_na_timeline,
+                "fim_na_timeline": fim_na_timeline,
+                "inicio": max(0.0, inicio_no_arquivo),
+                "fim": max(0.0, fim_no_arquivo),
+                "arquivo": arquivo,
+                "clipe_de_video": linha["clipe_de_video"],
+            })
+        return resultado
+
     def listar_falas_no_intervalo(
         self,
         video_id: str,