화이트보드 협업: 어디서나 실시간 아키텍처 워크숍

커리어 초기의 최고의 아키텍처 논의를 아직도 기억합니다. 다섯 명의 엔지니어가 화이트보드 앞에 모여 마커를 들고, 결제 서비스가 알림 시스템과 직접 통신해야 하는지 토론하면서 박스와 화살표를 그렸습니다. 누군가 다이어그램의 절반을 지우고 다르게 다시 그리면, 갑자기 모든 것이 맞아떨어졌습니다.

그런 세션에서 우리의 최고의 설계가 탄생했습니다. 실시간 협업의 에너지, 즉각적인 피드백, 떠오르는 아키텍처에 대한 공유된 주인의식 — 다른 어떤 것도 비교할 수 없었습니다.

그리고 원격 근무가 시작되었습니다. 화상 통화로 그 세션을 재현하려 했지만 같은 느낌이 아니었습니다. 한 사람이 화면을 공유하고 그리는 동안 나머지는 수동적으로 지켜볼 뿐이었습니다. 마법은 사라졌습니다.

오늘, 우리는 그것을 되찾습니다. Archyl이 이제 실시간 화이트보드 협업을 지원하며, 여러분이 기대하는 그대로 작동합니다.

팀이 작업하는 모습을 확인하세요

Archyl에서 아무 화이트보드나 열면 더 이상 혼자 작업하지 않습니다. 팀원들이 참여하면 그들의 커서가 캔버스에 나타납니다 — 이름이 옆에 떠 있는 색상 화살표입니다. Sarah가 왼쪽 상단에서 인증 플로우를 탐색하는 동안 Marcus가 오른쪽에서 데이터베이스 연결을 다듬고 있는 것을 볼 수 있습니다.

이것은 단순한 장식이 아닙니다. 존재 인식은 협업 방식을 바꿉니다. 자연스럽게 서로의 작업에 방해되지 않습니다. 누군가 특정 영역에 집중하고 있을 때 그것을 볼 수 있어서 끝날 때까지 기다리거나 도와줄 수 있습니다. 물리적 공간에서 자연스럽게 일어나는 무언의 조율이 이제 디지털로 이루어집니다.

누군가 요소를 선택하면 그들의 색상으로 강조 표시된 것을 볼 수 있습니다. 편집 중인 컨테이너 주위에 은은한 빛이 나타나며 그 위에 이름이 떠 있습니다. "잠깐, 그거 바꾸고 있어?"라는 중단 없이 — 그냥 알 수 있습니다.

변경 사항이 즉시 나타납니다

모든 작업이 실시간으로 모든 참가자에게 동기화됩니다. 새 시스템을 만들면 모든 사람의 캔버스에 나타납니다. 컨테이너를 드래그하여 위치를 변경하면 모든 사람이 움직임을 봅니다. 설명을 업데이트하면 전체 팀에게 텍스트가 변경됩니다.

아키텍처가 협업으로 형태를 갖추는 것을 보는 것에는 깊은 만족감이 있습니다. 한 사람이 상위 수준 시스템을 스케치하는 동안 다른 사람이 컨테이너 세부 사항을 채웁니다. 누군가 외부 의존성을 추가하는 동안 여러분은 관계를 문서화합니다. 다이어그램이 여러 관점에 의해 동시에 형성되며 유기적으로 성장합니다.

동시 편집을 우아하게 처리하도록 동기화 인프라를 구축했습니다. 두 사람이 정확히 같은 순간에 같은 요소를 수정하는 경우, 시스템이 변경 사항을 지능적으로 조정합니다. 실제로는 커서 존재감으로 인해 이런 상황은 드물게 발생합니다 — 자연스럽게 다이어그램의 다른 부분에서 작업하게 됩니다.

단순한 그림이 아닌 아키텍처

Miro나 FigJam과 다른 점이 바로 이것입니다: 여러분이 만드는 모든 것이 실제 아키텍처 문서입니다.

브레인스토밍 중에 스케치한 시스템? 이제 C4 모델의 일급 엔티티이며, API를 통해 쿼리 가능하고, ADR에 연결 가능하며, 아키텍처 보고서에서 볼 수 있습니다. 그린 관계들? 추적되고, 검증되며, AI 분석에 활용됩니다.

Archyl에서의 협업 세션은 누군가가 나중에 "정리하고 제대로 문서화해야" 하는 임시 그림의 스크린샷이 아닌, 지속적인 산출물을 만들어냅니다. 문서가 곧 워크숍의 결과물입니다.

구축 방법

대규모 실시간 협업은 흥미로운 엔지니어링 도전입니다. WebSocket을 고려했지만 결국 1초 간격의 하트비트를 사용하는 폴링 기반 접근 방식을 선택했습니다. 운영이 더 간단하고, 기업 프록시와 로드 밸런서 뒤에서 안정적으로 작동하며, 아키텍처 작업에 허용 가능한 지연 시간을 제공합니다 — 비디오 게임을 하는 것이 아니라 시스템을 설계하는 것이니까요.

각 참가자는 매 하트비트마다 커서 위치와 현재 선택된 요소를 전송합니다. 서버는 활성 세션을 추적하고, 신중하게 선택한 10가지 구별 가능한 색상 팔레트에서 색상을 할당하며, 30초 동안 비활성인 세션을 정리합니다. 작업은 참가자들이 업데이트를 폴링하는 작업 로그를 통해 브로드캐스트되며, 버전 번호를 통해 아무도 변경 사항을 놓치지 않도록 보장합니다.

프론트엔드는 서버 상태와 로컬 낙관적 업데이트를 병합하는 복잡성을 처리합니다. 요소를 드래그하면 변경 사항이 다른 사람에게 전파되는 동안 커서 아래에서 즉시 이동합니다. 콘텐츠 해싱 시스템이 서버 상태가 로컬 상태와 실제로 다른지 감지하여 불필요한 리렌더링과 요소가 이리저리 튀는 거슬리는 경험을 방지합니다.

원격 아키텍처 작업을 위한 설계

원격 협업이 자연스럽게 느껴지도록 세부 사항을 신중하게 고려했습니다.

협업자 목록은 왼쪽 하단에 겹치는 스택으로 아바타를 보여줍니다. 5명 이상이 참여하면 "+N명 더" 표시가 나타나지만 — 우리 경험상 최고의 아키텍처 세션은 작고 집중된 상태를 유지합니다.

집중이 필요할 때 화면을 가로지르는 모든 커서를 억지로 볼 필요가 없습니다. 집중 모드는 시각적 존재 표시기를 숨기면서 변경 사항 동기화는 계속 유지합니다. 평온하게 작업하고, 올려다보면 무엇이 변경되었는지 볼 수 있습니다.

시간대 인식은 분산 팀의 조율을 돕습니다. 존재 표시기는 각 협업자의 현지 시간을 보여주므로 싱가포르의 동료가 하루를 마무리하는지 막 시작하는지 알 수 있습니다.

시작하기

화이트보드 협업은 모든 플랜에서 사용할 수 있습니다. 특별한 설정이 필요 없습니다 — 프로젝트의 다이어그램 뷰를 열고 도구 모음의 "Collaborate" 버튼을 클릭한 후 세션 링크를 팀과 공유하면 됩니다.

아키텍트들을 모으고, 화이트보드를 열고, 함께 무언가를 설계하세요. 최고의 아키텍처 결정은 어디에 앉아 있든 모든 사람이 기여할 수 있을 때 이루어집니다.

Archyl이 처음이신가요? AI-Powered Architecture Discovery가 기존 코드베이스를 자동으로 매핑하는 방법을 알아본 다음, 팀을 초대하여 함께 아키텍처를 다듬고 발전시키세요.