Time-lapse de Arquitetura

O time-lapse transforma o histórico de versões do seu projeto em um curta-metragem. A partir da revisão capturada mais antiga, a sua arquitetura se constrói diante de você: os elementos se desenham, as relações traçam seu caminho pelo canvas, as atualizações piscam e os elementos removidos são riscados em vermelho. Tudo termina com uma faixa de créditos que resume a jornada inteira.

Tudo é calculado a partir de versões que o Archyl já captura automaticamente — não há nada para configurar, e o filme é somente leitura: reproduzi-lo ou exportá-lo nunca altera o seu modelo.

Requisitos

O time-lapse precisa de pelo menos duas versões do projeto que contenham mudanças visíveis no nível do filme. As versões são capturadas automaticamente conforme você edita, então normalmente basta ter um pouco de histórico de edição.

Se você vir "Ainda não há histórico suficiente", continue editando o diagrama — cada sessão de edição é capturada como uma nova versão.

Abrir o filme

  1. Abra a visão Diagrama de um projeto.
  2. Clique em Viagem no Tempo na barra de ferramentas (canto superior direito).
  3. No cabeçalho do painel, clique em Time-lapse.

O player abre em tela cheia e começa a reproduzir. Pressione Esc a qualquer momento para fechá-lo.

O botão Time-lapse só aparece quando o projeto tem duas ou mais versões capturadas.

O que você está assistindo

O filme escolhe automaticamente o nível mais informativo — containers quando o seu projeto é um único sistema, contexto de sistema caso contrário — e reproduz um capítulo por revisão que tenha mudado algo visível.

A linguagem visual

O que você vê O que significa
Um cartão surgindo com um halo brilhante Um novo elemento foi adicionado nesta revisão
Uma linha se desenhando entre dois cartões Uma nova relação, rotulada com sua descrição ou tipo
Um flash âmbar MOD Um elemento existente foi atualizado (descrição, tecnologia, …)
Um risco vermelho, um carimbo Removido e um fantasma tracejado O elemento foi removido — ele continua visível como fantasma, porque as remoções fazem parte da história

A câmera acompanha a ação: ela enquadra as mudanças de cada revisão, dá um close no cluster mais significativo e sempre mantém as duas pontas de uma nova relação no quadro.

As informações na tela

  • Canto superior esquerdo — o nome do projeto e o número da revisão atual, sua data e seu autor.
  • Legendas — cada capítulo mostra a descrição daquela versão, então o filme se narra com as palavras da sua própria equipe. Capítulos sem descrição recorrem a "Revisão N".
  • Chips — um resumo por revisão: +N elementos, +N relações, ~N atualizados, −N removidos.
  • Canto inferior direito — um contador ao vivo do total de elementos e relações.
  • Cartela final — uma faixa de créditos com uma régua de marcos (um traço por revisão), estatísticas em contagem crescente, os autores que contribuíram e um carimbo Rev NN — atual.

O filme é totalmente localizado: legendas, chips, carimbos e créditos seguem o idioma da sua interface.

Controles

Ação Controle
Reproduzir / Pausar O botão de reprodução, ou Space
Pular para um momento Clique ou arraste a barra de progresso
Pular para uma revisão Clique em uma pílula REV na linha do tempo
Fechar o player O botão de fechar, ou Esc

A linha do tempo mostra um traço para cada capítulo, então você pode pular direto para a revisão que interessa.

Escolha quais revisões aparecem

Históricos longos costumam conter revisões que não acrescentam nada à história. Clique no botão de filtro na barra de transporte para abrir a lista de revisões e use o botão de olho para ocultar qualquer revisão.

  • As mudanças de uma revisão oculta são mescladas na próxima revisão visível — o filme nunca mostra um buraco.
  • Pelo menos duas revisões precisam permanecer visíveis; as duas últimas linhas são bloqueadas automaticamente.
  • Mostrar todas redefine o filtro.
  • A sua seleção é lembrada por projeto neste navegador.

Históricos longos

Para manter os filmes assistíveis, o time-lapse cobre as últimas 10 revisões. Tudo o que for mais antigo é agrupado no capítulo de abertura, que desenha a sua arquitetura preexistente como plano de estabelecimento — assim nada desaparece, apenas não é animado revisão por revisão.

Exportar como MP4

Clique em Exportar como MP4 na barra de transporte. O filme é renderizado quadro a quadro dentro do seu navegador e baixado como <project-slug>-timelapse.mp4:

  • 1920×1080, 24 fps, H.264
  • A renderização mostra uma porcentagem ao vivo e pode ser cancelada a qualquer momento
  • Nada é enviado para servidores — a sua arquitetura nunca sai da sua máquina, e não há nenhuma renderização do lado do servidor

A renderização leva por volta de três a quatro vezes a duração do filme — um filme de 30 segundos precisa de um ou dois minutos. Mantenha a aba em primeiro plano enquanto ela renderiza.

Requisitos

A exportação em MP4 usa a API WebCodecs do navegador, que precisa de:

  • Um Chrome, Edge ou Safari recente. Navegadores sem WebCodecs mostram o botão desativado.
  • Um contexto seguro — a página precisa ser servida via HTTPS (ou localhost). Em um endereço interno em HTTP puro, o botão permanece desativado; passe o mouse sobre ele para ver o motivo exato.

Hospedar o Archyl por conta própria em HTTP puro é a causa mais comum de um botão de exportação desativado — colocar o app atrás de TLS resolve.

Onde usar

  • Onboarding — uma pessoa recém-chegada vê dois anos de decisões arquiteturais em trinta segundos.
  • Revisões de arquitetura e retrospectivas — abra com o filme em vez de um diagrama estático.
  • Anúncios de releases e marcos — jogue o MP4 no Slack ou em uma nota de release.
  • Demos para stakeholders — a cartela final leva o nome do seu projeto, as estatísticas e as pessoas que contribuíram.

Solução de problemas

"Ainda não há histórico suficiente" — o projeto tem menos de duas versões com mudanças visíveis, ou o filtro de revisões oculta demais. Abra o filtro e escolha Mostrar todas, ou continue editando para capturar mais histórico.

O botão Time-lapse não aparece — o projeto tem menos de duas versões capturadas.

O botão de exportação está desativado — o seu navegador não tem WebCodecs, ou o app não é servido via HTTPS/localhost. Passe o mouse sobre o botão para ver o motivo exato.

A exportação falhou no meio — tente novamente; se falhar repetidamente, feche outras abas pesadas, porque a codificação consome muita memória.

Relacionados