Ownership Map: 아키텍처 전반의 소유권을 시각화하세요

간단해 보이지만 대부분의 엔지니어링 조직을 곤란하게 만드는 질문이 있습니다: 이 서비스의 책임자가 누구인가요?

누가 만들었는지가 아닙니다. 누가 마지막으로 커밋했는지도 아닙니다. 지금 현재 누가 책임지고 있는지 — 가용성, 기술 부채, API 계약, 보안 상태까지. 새벽 2시에 장애가 나면 누가 호출되나요? 새로운 팀이 연동해야 할 때 누구에게 연락하나요?

작은 회사에서는 모두가 압니다. 성장하는 회사에서는 답이 금방 모호해집니다. 팀이 나뉘고, 서비스가 늘어나고, 사람들이 역할을 바꿉니다. 조직도는 한 가지를 말하고, 코드베이스는 다른 것을 말하고, 아키텍처 다이어그램은 아무 말도 하지 않습니다 — 소유권이 처음부터 그 그림에 포함되지 않았기 때문입니다.

우리는 이 문제를 해결하기 위해 Ownership Map을 만들었습니다.

무엇인가요

Ownership Map은 Archyl의 글로벌 아키텍처 뷰에 있는 새로운 탭입니다. 조직 내 모든 팀과 사용자를 소유한 C4 요소 수에 비례하는 크기의 인터랙티브 버블로 표시합니다. 버블 위에 마우스를 올리면 연결된 소유자들로의 의존성 라인이 나타납니다. 클릭하면 해당 팀이 책임지는 모든 시스템, 컨테이너, 컴포넌트를 상세히 볼 수 있습니다.

이미 관리하고 있는 C4 모델을 기반으로 구축된 "누가 무엇을 책임지는가"에 대한 실시간 시각적 답변입니다.

Ownership Map 시각화

소유권 문제는 아키텍처 문제입니다

대부분의 팀은 스프레드시트, 위키 페이지, 또는 Slack 채널 설명으로 소유권을 추적합니다. 이러한 참조 자료는 몇 주 만에 낡아집니다. 서비스가 이관되고, 팀이 재편되고, 인턴의 사이드 프로젝트가 프로덕션 인프라가 되지만 — 소유권 문서는 업데이트되지 않습니다. 아무도 그 존재를 기억하지 못하기 때문입니다.

이것이 중요한 이유는 소유권이 단순한 행정적 기록이 아니기 때문입니다. 그것은 아키텍처 신호입니다. 한 팀이 40개 서비스를 소유하고 다른 팀이 3개를 소유한다면, 그것은 용량 문제입니다. 두 팀의 서비스가 깊이 연결되어 있지만 서로 소통하지 않는다면, 그것은 결합도 문제입니다. 아키텍처의 30%에 소유자가 없다면, 그것은 리스크 문제입니다.

Ownership Map은 이러한 신호를 설계 단계부터 가시화합니다.

작동 방식

소유권 할당

모든 C4 요소 — 시스템, 컨테이너 또는 컴포넌트 — 는 하나 이상의 팀이나 사용자에게 할당할 수 있습니다. 프로젝트 다이어그램의 요소 상세 패널에서 소유권을 설정하거나, AI 기반 디스커버리 프로세스에서 자동으로 설정되게 할 수 있습니다.

요소는 팀 소유자와 개인 사용자 소유자를 동시에 가질 수 있습니다. 시스템이 "Platform Engineering" 팀에 속하면서 특정 테크 리드가 개인 책임자로 지정될 수 있습니다.

버블 뷰

개요 화면에서는 모든 소유자가 힘 기반 레이아웃의 색상 원으로 표시됩니다. 레이아웃은 배치가 스마트합니다: 의존 관계가 있는 팀들은 더 가까이 배치되어, 조직의 실제 토폴로지를 반영하는 자연스러운 클러스터링이 만들어집니다.

각 버블에는 다음이 표시됩니다:

  • 팀 또는 사용자 이름
  • 아이콘 또는 아바타 (업로드된 경우)
  • 소유한 요소 총 수
  • C4 레벨별 분류 (시스템, 컨테이너, 컴포넌트)

의존성 라인

여기서 흥미로워집니다. 서로 다른 팀이 소유한 요소 간에 C4 관계가 존재하면, Ownership Map은 해당 소유자 간에 의존성 라인을 그립니다. 아무 버블 위에 마우스를 올리면 의존성 라인이 애니메이션으로 나타나며, 어떤 다른 팀과 결합되어 있는지, 얼마나 많은 관계가 연결되어 있는지 보여줍니다.

이를 통해 기존 조직도에서는 보이지 않는 팀 간 의존성이 드러납니다. 프론트엔드 팀의 BFF 레이어가 4개의 다른 백엔드 팀이 소유한 15개의 다른 엔드포인트에 의존한다면, 그 결합이 즉시 보입니다. 같은 도메인에 있으면서도 두 팀 간 의존성이 전혀 없다면, 그것도 조사할 가치가 있습니다.

상세 뷰

아무 버블이나 클릭하면 부드러운 원형 공개 애니메이션으로 확대됩니다. 상세 뷰에는 다음이 표시됩니다:

  • 팀의 아이콘, 이름, 유형이 포함된 히어로 헤더
  • 전체 요소, 시스템, 컨테이너, 컴포넌트의 통계 카드 — 각각 필터로 클릭 가능
  • C4 레벨별로 그룹화된 모든 소유 요소의 카드 그리드
  • 같은 요소에 대한 책임을 공유하는 다른 팀을 보여주는 공동 소유 뱃지
  • 전체 맥락을 위한 요소 설명 및 프로젝트 이름

Escape를 누르거나 뒤로를 클릭하면 개요로 돌아갑니다.

커버리지 추적

페이지 헤더에는 소유권 커버리지 비율이 표시됩니다 — 소유자가 한 명이라도 있는 요소의 전체 요소 대비 비율입니다. 커버리지는 C4 레벨별로 세분화되어, 시스템은 잘 할당되어 있지만 컴포넌트가 방치되어 있는지 확인할 수 있습니다.

토글을 사용하면 소유자가 없는 요소가 별도의 회색 버블로 표시되어 커버리지 갭이 즉시 드러납니다.

검색

검색 바는 소유자 이름, 요소 이름, 프로젝트 이름 전체에 걸쳐 전문 검색으로 작동합니다. "payments"를 입력하면 팀 이름에 "payments"가 포함되어 있는지와 관계없이 결제 관련 항목을 소유한 모든 팀이 표시됩니다.

무엇이 달라지나요

이전: 소유권은 부족의 지식

  • "Payments 팀이 담당하는 것 같은데, Sarah한테 확인해 봐"
  • 위키 페이지는 2분기 이후로 업데이트 안 됨
  • 신규 엔지니어들은 누구에게 물어봐야 하는지 파악하는 데 며칠이 걸림
  • 장애 대응이 "이 서비스 누구 거야?"로 10분간 시작됨

이후: 소유권은 가시적이고 추적 가능

  • 모든 요소에 명확한 소유자가 있음 (또는 가시적인 공백이 있음)
  • 팀 간 의존성이 자동으로 표면화됨
  • 신규 엔지니어가 첫날부터 전체 소유권 현황을 파악할 수 있음
  • 커버리지 비율이 측정 가능한 관리 목표를 만듦

워크플로에 통합됨

Ownership Map은 독립형 도구가 아닙니다 — Archyl 전체에 통합되어 있습니다:

AI Chat — "API Gateway 소유자가 누구야?" 또는 "소유자 없는 컴포넌트가 가장 많은 팀은?" 같은 질문을 할 수 있습니다. 아키텍처 챗이 이제 소유권 데이터를 컨텍스트에 포함하므로, 책임 관련 질문에 직접 답할 수 있습니다.

MCP Server — Archyl MCP 서버는 get_ownership_map 도구를 제공하여, AI 코딩 어시스턴트(Claude Code, Cursor 등)가 작업 중에 소유권 데이터를 조회할 수 있습니다. "이 서비스에 대해 누구와 얘기해야 해?"라고 물으면 에디터를 떠나지 않고 답을 얻을 수 있습니다.

DORA Metrics — 소유권을 DORA 지표와 결합하여 어떤 팀이 가장 빠르게 배포하는지, 어떤 팀의 장애율이 가장 높은지, 어디서 복구 시간이 가장 긴지 파악할 수 있습니다. 소유권 + 배포 성능 = 실행 가능한 팀 건강 데이터.

Release Management — 어떤 팀의 서비스가 가장 자주 배포되는지, 어떤 릴리스가 스테이징에 멈춰 있는지 확인할 수 있습니다. 소유권 맥락이 릴리스 추적을 더 의미 있게 만들어 줍니다.

시작하기

이미 Archyl을 사용하고 계시다면, Ownership Map은 지금 바로 글로벌 아키텍처 뷰에서 사용할 수 있습니다.

  1. 글로벌 아키텍처 -> Ownership 탭으로 이동
  2. 다이어그램 상세 패널에서 C4 요소에 소유자 할당
  3. 버블이 나타나고 의존성 라인이 형성되는 것을 확인
  4. 커버리지 목표를 설정하고 시간 경과에 따른 진행 상황을 추적

데모를 사용 중이라면 다섯 개의 도메인 팀(Platform Engineering, Payments Squad, Security & Fraud, Frontend & Mobile, Data & Analytics)으로 소유권 데이터가 미리 설정되어 있어 전체 경험을 바로 탐색할 수 있습니다.

Ownership Map은 무료 플랜을 포함한 모든 플랜에서 사용할 수 있습니다.


더 읽어보기: