단일 진실 공급원: 한 번 정의하고 어디서나 사용하는 조직 수준 시스템

일정 규모 이상의 모든 조직에서 나타나는 패턴입니다. A 팀이 아키텍처를 문서화합니다. 인증 서비스를 위한 상자를 추가합니다 — 이름, 설명, 기술 스택. B 팀도 자기 프로젝트에서 같은 일을 합니다. C 팀도 마찬가지입니다. 세 프로젝트, 같은 시스템의 세 개의 별도 정의, 각각 약간 다릅니다. 하나는 "Auth Service", 다른 하나는 "Authentication Platform", 세 번째는 "Identity Provider"라고 합니다. 같은 시스템. 세 가지 이름. 다른 것을 강조하는 세 가지 설명. 연결 없음.

6개월 후, 인증 팀이 서비스 이름을 바꾸고 기술 스택을 업데이트합니다. 변경은 세 다이어그램 중 어디에도 전파되지 않습니다. 각 프로젝트의 현실 버전이 조용히 실제 시스템과, 그리고 서로로부터 벌어집니다.

이것이 일관성 문제입니다. 부주의에서 오는 것이 아닙니다. 모든 프로젝트를 섬으로 취급하는 아키텍처 도구에서 옵니다. 시스템을 표현하는 유일한 방법이 프로젝트 내에서 만드는 것이라면, 그 시스템을 다루는 모든 프로젝트가 자체 복사본을 갖게 됩니다. 복사본은 벌어집니다. 복사본이란 그런 것입니다.

이를 고치기 위해 조직 수준 시스템을 만들었습니다.

프로젝트가 아닌 조직에 속하는 시스템

Archyl은 이제 C4 시스템에 두 가지 범위를 지원합니다. 프로젝트 범위 시스템은 이전과 동일하게 작동합니다 — 단일 프로젝트에 속합니다. 조직 범위 시스템은 조직에 속합니다. 어떤 프로젝트와도 독립적으로 존재하며, 어떤 프로젝트든 연결할 수 있습니다.

구분이 중요한 이유는 실제 아키텍처 작동 방식을 반영하기 때문입니다. 일부 시스템은 프로젝트 내부적입니다. 하지만 많은 시스템은 프로젝트 경계를 넘습니다 — 공유 인프라, 플랫폼 서비스, 서드파티 통합, 여러 팀이 의존하는 핵심 비즈니스 역량. 이것들은 조직에 속합니다.

조직 수준 시스템을 만들 때, 선언하는 것입니다: 이 시스템은 공유된 현실입니다. 이름, 설명, 기술, 태그가 한 번 정의됩니다. 참조하는 모든 프로젝트가 같은 정의를 봅니다.

작동 방식

조직 시스템 만들기

조직 시스템은 플랫폼의 전용 섹션에서 생성됩니다. 프로젝트에서 하듯이 시스템을 정의합니다 — 이름, 설명, 유형, 기술, 태그. 차이점은 어떤 프로젝트에도 연결되지 않는다는 것입니다. 조직 수준에 살며 모든 팀에게 보입니다.

프로젝트에 시스템 연결

프로젝트 다이어그램에서 작업하며 조직 시스템을 참조하려면 연결합니다. 모달이 검색 기능과 함께 사용 가능한 모든 조직 시스템을 보여줍니다. 필요한 것을 토글하면 다이어그램에 즉시 나타납니다.

연결된 시스템은 다이어그램에서 네이티브 시스템처럼 동작합니다. 해당 프로젝트 레이아웃에 맞는 곳에 배치할 수 있습니다. 유일한 차이점은 시스템의 핵심 정체성 — 이름, 설명, 기술 — 이 프로젝트가 아닌 조직 정의에서 온다는 것입니다.

연결 해제

프로젝트가 더 이상 공유 시스템에 의존하지 않으면 연결을 해제합니다. 시스템이 프로젝트 다이어그램에서 사라지지만 조직 수준과 참조하는 다른 모든 프로젝트에서 계속 존재합니다.

왜 이것이 중요한가

조율 없는 일관성

조직 수준 시스템은 일관성을 구조적으로 만듭니다. 하나의 정의가 있습니다. 프로젝트가 참조합니다. 누군가 시스템의 설명이나 기술 스택을 업데이트하면, 연결된 모든 프로젝트가 자동으로 변경을 반영합니다.

정확한 프로젝트 간 의존성

여러 프로젝트가 같은 조직 시스템에 연결되면, 플랫폼이 그 연결을 압니다. 임팩트 레이더가 프로젝트 경계를 넘어 조직 시스템을 통한 의존성을 추적할 수 있습니다.

온보딩과 디스커버리

프로젝트에 합류하는 새 팀원이 다른 모든 프로젝트가 사용하는 것과 같은 시스템 이름, 설명, 기술 레이블을 봅니다.

중복 감소

모든 프로젝트가 독립적으로 같은 인프라를 문서화하는 대신, 각각을 한 번 정의합니다. 프로젝트가 몇 초 만에 연결합니다.

더 큰 그림

이 기능은 더 넓은 방향의 일부입니다: Archyl이 조직이 실제로 작동하는 방식대로 작동하게 만들기. 아키텍처는 독립적인 프로젝트의 모음이 아닙니다. 공유 시스템, 플랫폼 역량, 횡단 관심사의 네트워크입니다.

조직 수준 시스템은 공유 인프라가 한 번 문서화되고 어디서나 참조되는 모델을 향한 첫 단계입니다. 글로벌 아키텍처 뷰와 임팩트 레이더와 결합하면, 아키텍처를 분리된 다이어그램 세트가 아닌 연결된 전체로 이해하는 플랫폼을 갖게 됩니다.

시작하기

조직 수준 시스템은 지금 사용할 수 있습니다. 조직 섹션으로 가서 공유 시스템을 만든 다음, 다이어그램 뷰에서 어떤 프로젝트에든 연결하세요.

아키텍처에는 단일 진실 공급원이 있습니다. 문서도 그래야 합니다.

프로젝트 간 아키텍처에 대해 더 알아보려면 글로벌 아키텍처와 실시간 협업을 참조하세요. 공유 시스템의 변경이 어떻게 전파되는지 이해하려면 임팩트 레이더를 시도해 보세요. 공유 시스템의 거버넌스 변경을 위해 아키텍처 변경 요청을 탐색하세요.