아키텍처 타임랩스

타임랩스는 프로젝트의 버전 이력을 한 편의 짧은 필름으로 바꿔 줍니다. 가장 먼저 기록된 리비전에서 시작해 아키텍처가 눈앞에서 스스로 만들어집니다. 요소가 그려지고, 관계가 캔버스를 가로지르며 이어지고, 수정이 번쩍이고, 폐기된 요소는 빨간 줄로 지워집니다. 마지막에는 전체 여정을 요약하는 크레딧 밴드로 끝맺습니다.

모든 것은 Archyl이 이미 자동으로 기록하고 있는 버전에서 계산됩니다 — 따로 설정할 것은 없으며, 필름은 읽기 전용입니다. 재생하거나 내보내도 모델이 변경되는 일은 결코 없습니다.

요구 사항

타임랩스에는 필름의 레벨에서 눈에 보이는 변경을 담고 있는 버전이 2개 이상 필요합니다. 버전은 편집하는 동안 자동으로 기록되므로, 보통은 약간의 편집 이력만 있으면 충분합니다.

*"아직 기록이 충분하지 않습니다"*가 표시된다면 다이어그램을 계속 편집하세요 — 편집 세션마다 새 버전으로 기록됩니다.

필름 열기

  1. 프로젝트의 다이어그램 뷰를 엽니다.
  2. 툴바(우측 상단)에서 타임 트래블을 클릭합니다.
  3. 패널 헤더에서 타임랩스를 클릭합니다.

플레이어가 전체 화면으로 열리며 곧바로 재생을 시작합니다. 언제든 Esc를 눌러 닫을 수 있습니다.

타임랩스 버튼은 프로젝트에 기록된 버전이 2개 이상일 때만 나타납니다.

무엇을 보게 되나요

필름은 가장 많은 정보를 담은 레벨을 자동으로 선택합니다 — 프로젝트가 단일 시스템이면 컨테이너, 그렇지 않으면 시스템 컨텍스트 — 그리고 눈에 보이는 변경이 있었던 리비전마다 하나의 챕터를 재생합니다.

시각 언어

보이는 것 의미
은은한 광채와 함께 서서히 나타나는 카드 이 리비전에서 새 요소가 추가되었습니다
두 카드 사이에 스스로 그려지는 선 새 관계이며, 설명 또는 유형이 레이블로 표시됩니다
앰버색 수정 플래시 기존 요소가 업데이트되었습니다(설명, 기술 등)
빨간 취소선, 폐기 스탬프, 점선 고스트 요소가 제거되었습니다 — 제거도 이야기의 일부이므로 고스트로 계속 보입니다

카메라는 액션을 따라갑니다. 각 리비전의 변경을 화면에 담고, 가장 의미 있는 클러스터로 밀고 들어가며, 새 관계의 양 끝을 언제나 화면 안에 유지합니다.

화면에 표시되는 정보

  • 좌측 상단 — 프로젝트 이름과 현재 리비전 번호, 날짜, 작성자.
  • 캡션 — 각 챕터는 해당 버전의 설명을 보여주므로, 필름이 팀 자신의 언어로 이야기를 풀어냅니다. 설명이 없는 챕터는 *"리비전 N"*으로 대체됩니다.
  • 칩 — 리비전별 요약: +N 요소, +N 관계, ~N 수정, −N 제거.
  • 우측 하단 — 전체 요소와 관계 수를 실시간으로 보여주는 카운터.
  • 엔드 카드 — 마일스톤 스트립(리비전당 눈금 하나), 카운트업 통계, 기여한 작성자, 그리고 Rev NN — 최신 스탬프가 담긴 크레딧 밴드.

필름은 완전히 현지화되어 있습니다. 캡션, 칩, 스탬프, 크레딧 모두 여러분의 인터페이스 언어를 따릅니다.

조작

동작 조작 방법
재생 / 일시정지 재생 버튼 또는 Space
특정 시점으로 이동 진행 바를 클릭하거나 드래그
특정 리비전으로 이동 타임라인의 REV 배지 클릭
플레이어 닫기 닫기 버튼 또는 Esc

타임라인에는 챕터마다 눈금이 표시되므로, 관심 있는 리비전으로 곧바로 건너뛸 수 있습니다.

어떤 리비전을 보여줄지 선택하기

긴 이력에는 이야기에 아무것도 더하지 않는 리비전이 섞여 있기 마련입니다. 재생 바의 필터 버튼을 클릭해 리비전 목록을 열고, 눈 모양 토글로 원하는 리비전을 숨기세요.

  • 숨긴 리비전의 변경 사항은 다음에 표시되는 리비전으로 병합됩니다 — 필름에 구멍이 생기는 일은 없습니다.
  • 최소 2개의 리비전은 표시된 상태로 남아야 하며, 마지막 두 행은 자동으로 잠깁니다.
  • 모두 표시를 누르면 필터가 초기화됩니다.
  • 선택한 내용은 이 브라우저에서 프로젝트별로 기억됩니다.

긴 이력

필름을 볼 만한 길이로 유지하기 위해 타임랩스는 최근 10개 리비전을 다룹니다. 그보다 오래된 것은 오프닝 챕터로 접혀 들어가, 기존 아키텍처를 설정 샷처럼 그려냅니다 — 따라서 사라지는 것은 없고, 단지 리비전 단위로 애니메이션되지 않을 뿐입니다.

MP4로 내보내기

재생 바에서 MP4로 내보내기를 클릭하세요. 필름은 브라우저 안에서 프레임 단위로 렌더링되어 <project-slug>-timelapse.mp4로 다운로드됩니다.

  • 1920×1080, 24 fps, H.264
  • 렌더링 중에는 진행률이 실시간으로 표시되며 언제든 취소할 수 있습니다
  • 아무것도 업로드되지 않습니다 — 아키텍처가 여러분의 컴퓨터를 벗어나지 않으며, 서버 측 렌더링도 전혀 사용하지 않습니다

렌더링에는 필름 길이의 대략 34배가 걸립니다 — 30초짜리 필름이라면 12분 정도입니다. 렌더링하는 동안 탭을 앞쪽에 두세요.

요구 사항

MP4 내보내기는 브라우저의 WebCodecs API를 사용하며, 다음이 필요합니다.

  • 최신 Chrome, Edge 또는 Safari. WebCodecs를 지원하지 않는 브라우저에서는 버튼이 비활성화된 상태로 표시됩니다.
  • 보안 컨텍스트 — 페이지가 HTTPS(또는 localhost)로 제공되어야 합니다. 일반 HTTP 내부 주소에서는 버튼이 비활성화된 채로 남으며, 버튼 위에 마우스를 올리면 정확한 이유를 확인할 수 있습니다.

Archyl을 일반 HTTP로 셀프 호스팅하는 것이 내보내기 버튼이 비활성화되는 가장 흔한 원인입니다 — 앱을 TLS 뒤에 두면 해결됩니다.

어디에 활용할까

  • 온보딩 — 새로 합류한 엔지니어가 2년치 아키텍처 결정을 30초 만에 파악합니다.
  • 아키텍처 리뷰와 회고 — 정적인 다이어그램 대신 필름으로 시작하세요.
  • 릴리스 및 마일스톤 공지 — Slack이나 릴리스 노트에 MP4를 올리세요.
  • 이해관계자 데모 — 엔드 카드에 프로젝트 이름, 통계, 기여자가 함께 담깁니다.

문제 해결

"아직 기록이 충분하지 않습니다" — 눈에 보이는 변경이 있는 버전이 2개 미만이거나, 리비전 필터가 너무 많이 숨기고 있습니다. 필터를 열고 모두 표시를 선택하거나, 계속 편집해 이력을 더 쌓으세요.

타임랩스 버튼이 보이지 않음 — 프로젝트에 기록된 버전이 2개 미만입니다.

내보내기 버튼이 비활성화됨 — 브라우저가 WebCodecs를 지원하지 않거나, 앱이 HTTPS/localhost로 제공되지 않고 있습니다. 버튼 위에 마우스를 올리면 정확한 이유가 표시됩니다.

내보내기가 도중에 실패함 — 다시 시도하세요. 반복해서 실패한다면 인코딩이 메모리를 많이 사용하므로 다른 무거운 탭을 닫으세요.

관련 문서