작은 변경이 시스템 전체를 아프게 할 때
이틀.
티켓의 예상 소요 시간이었습니다. 처음 보기에는 정말 이틀이면 될 것 같았습니다. 사용자에게 모달 대화상자를 보여 주고, 선택한 값을 설정 객체에 저장합니다. 아무것도 선택하지 않으면 30일 뒤에 대화상자를 다시 보여 줍니다.
티켓을 맡은 개발자는 경험이 아주 많고 기술 역량도 뛰어났으며, 기존 시스템을 유난히 잘 이해하고 있었습니다. 이 코드베이스에서 숨은 관계를 일찍 알아볼 사람을 한 명 꼽으라면 저는 그를 꼽았을 것입니다.
약 2주 뒤 그는 휴가를 떠났습니다. 남긴 말은 이랬습니다.
“작업은 끝났습니다. QA 부탁드립니다.”
그 뒤로 QA와 수정, 재검증이 약 3주 더 이어졌습니다. 기능이 안정적으로 작동하기까지 약 40개의 오류나 예상 밖의 동작을 발견했습니다.
개인적인 경험입니다. 40이라는 숫자가 빅 볼 오브 머드(Big Ball of Mud)의 전형적인 지표는 아닙니다. 5주가 어떤 임계값도 아니고, 추정이 틀렸다고 나쁜 아키텍처가 입증되는 것도 아닙니다.
이 티켓에서 흥미로웠던 것은 다른 점입니다. 5주가 지나도 도메인 요구사항은 첫날과 같았습니다. 대화상자가 갑자기 복잡해진 것도, 30일 규칙이 복잡한 알고리즘으로 변한 것도 아닙니다. 늘어난 작업량을 설명할 새로운 도메인 요구도 없었습니다. 커진 것은 우리가 이해해야 하는 시스템의 범위였습니다.
도메인 요구는 작은 변경이었습니다. 하지만 기술적으로는 믿을 만한 경계가 없었습니다.
문제는 대화상자가 아니었습니다
섹션 제목: “문제는 대화상자가 아니었습니다”결정적인 오류는 설정을 다루는 방식에 있었습니다.
같은 도메인 개념인 설정을 서로 다른 두 곳에서 저장했습니다. 두 곳 모두 독립적으로 영속화할 수 있었습니다. 그래서 도메인상으로는 하나의 상태인데 백엔드에는 설정 객체가 두 개 생길 수 있었습니다.
나중에 불러올 때도 도메인 식별자를 기준으로 어느 객체가 기준인지 명확히 정하는 규칙은 없었습니다. 해당 코드는 반환된 컬렉션의 첫 번째 원소를 사용할 뿐이었습니다.
index 0
그런데 그 순서에는 도메인 계약이 없었습니다.
기대한 설정 객체와 다른 설정 객체 중 무엇이 0번 위치에 놓이는지는 업무 프로세스의 속성이 아니었습니다. 도메인 계약이 없는 기술적 세부사항에 달려 있었습니다.
그것만으로 모든 현상을 설명할 수도 없었습니다. 상태를 여러 곳에서 읽고 썼습니다. 어떤 쓰기 작업은 다른 반응을 일으켰습니다. 타이밍도 중요했습니다. 특정 흐름에서는 경쟁 상태가 발생했습니다. 따라서 수정 하나가 오류를 없애면서 동시에, 이전 순서나 다른 타이밍에 가려져 있던 또 다른 상태를 드러낼 수 있었습니다.
경쟁 상태 자체가 핵심 아키텍처 특징은 아니었습니다. 훌륭하게 구조화된 시스템에서도 경쟁 상태는 생길 수 있습니다. 한 상태에 쓰기 주체가 여럿 있다는 사실만으로도 Big Ball of Mud가 입증되지는 않습니다.
중요한 것은 이 티켓에서 당연히 간단해야 할 질문에 점점 더 답하기 어려워졌다는 점입니다.
이 변경은 어디에서 끝납니까?
대화상자에서일까요? 설정 서비스에서일까요? 전역으로 쓰이는 상태에서일까요? 영속성 모델에서일까요? 같은 객체에 쓰는 다른 곳들, 모든 읽기 주체, 수정으로 타이밍이 달라질 수 있는 모든 흐름까지 포함할까요?
문제는 대화상자가 아니었습니다. 소유권, 생명주기, 영속화의 경계가 명확하지 않은 상태였습니다.
도메인 요구는 작게 남습니다. 그래도 기술적 영향 범위는 커질 수 있습니다.
티켓 하나로 Big Ball of Mud가 입증되지는 않습니다
섹션 제목: “티켓 하나로 Big Ball of Mud가 입증되지는 않습니다”이런 사건 하나만으로 진단할 수는 없습니다.
구조가 좋은 시스템에서도 이틀이라는 추정은 틀릴 수 있습니다. 구현하면서 요구사항이 명확해질 수 있습니다. 단순해 보이는 상태에 예상 밖의 제약이 있을 수 있습니다. 동시성 때문에 특정 타이밍에서만 오류가 생길 수 있습니다. 개발자가 잘못 가정할 수도 있고, 구현 뒤에 QA가 추가 사례를 찾을 수도 있습니다.
따라서 아키텍처 관점에서 흥미로운 것은 패턴의 반복입니다. 원래 국소적이어야 할 요구에 멀리 떨어진 시스템 부분에 대한 지식이 정기적으로 필요합니다. 책임을 명확히 정하기 어렵습니다. 변경 전에 영향 범위를 제한하기 어렵습니다. 회귀 검증은 티켓의 도메인 요구만으로 예상한 것보다 훨씬 넓게 생각해야 합니다.
사건 하나는 메커니즘을 보여 줍니다. 반복되면 시스템의 특성이 됩니다.
소프트웨어 유지보수 연구에서도 같은 메커니즘을 찾을 수 있습니다. 변경 영향 분석(Change Impact Analysis)은 변경에 어떤 잠재적 결과가 있고, 따라서 시스템의 어떤 부분을 살펴봐야 하는지 다룹니다. 추상적으로 들리지만 모든 유지보수 티켓 뒤에 있는 실무 질문과 같습니다. 이 변경은 또 어디에 영향을 줄 수 있을까요?
Parnas는 이미 1972년에 모듈화를 단지 소스 코드를 보기 좋게 나누는 방법으로 설명하지 않았습니다. 시스템을 더 이해하기 쉽고 변경에 유연하게 만드는 수단으로 보았습니다. 중요한 것은 어떤 설계 결정을 모듈 경계 뒤에 감추어 시스템 전체에 영향을 퍼뜨리지 않게 하느냐입니다.
Big Ball of Mud는 바로 그 특성을 점점 잃습니다. 반드시 모든 곳에서, 모든 티켓에서 그런 것은 아닙니다. 하지만 도메인 요구의 범위와 기술적 범위가 더는 믿을 만하게 맞지 않을 만큼 자주 나타납니다.
변경의 세 가지 범위
섹션 제목: “변경의 세 가지 범위”일상적인 개발에는 간단한 모델이 도움이 됩니다. 변경의 크기는 하나가 아닙니다.
적어도 서로 다른 세 가지 범위가 있습니다.
도메인 변경 범위
섹션 제목: “도메인 변경 범위”첫 번째는 요구사항이 실제로 요구하는 범위입니다.
예제에서는 단순했습니다.
- 대화상자를 보여 줍니다.
- 선택한 값을 저장합니다.
- 선택한 값이 저장되지 않았다면 30일 뒤 대화상자를 다시 보여 줍니다.
처음부터 그 이상의 도메인 요구가 있지는 않았습니다.
이 범위만으로는 수정할 파일 수를 알 수 없습니다. 도메인에서의 범위를 설명합니다. 사용자 관점에서 어떤 규칙, 상태, 동작이 바뀌어야 할까요?
기술적 변경 범위
섹션 제목: “기술적 변경 범위”두 번째는 시스템에서 실제로 수정해야 하는 부분입니다.
국소적인 요구라도 여러 컴포넌트가 포함될 수 있습니다. UI에 새 상태가 필요하고, API를 확장하고, 영속화 방식을 조정하고, 테스트를 추가할 수 있습니다. 따라서 한 요구가 여러 파일이나 레이어에 걸친다는 사실 자체는 아키텍처 문제가 아닙니다.
하지만 제대로 된 아키텍처에서는 보통 이 기술적 범위를 설명할 수 있습니다.
이 상태는 여기에 속합니다. 이곳이 소유합니다. 이 인터페이스로 변경합니다. 저기에서 영속화합니다. 이 소비자들이 영향을 받습니다. 이 경계 뒤에서 변경은 끝납니다.
기술적 범위가 도메인 범위와 같을 필요는 없습니다. 다만 도메인 요구로부터 이해할 수 있게 도출되어야 합니다.
이해와 회귀 검증의 범위
섹션 제목: “이해와 회귀 검증의 범위”세 번째는 실무에서 가장 비쌀 때가 많습니다.
반드시 수정하지는 않더라도 책임 있게 배포하기 전에 이해하고 확인하거나 테스트해야 하는 모든 영역입니다.
개발자가 최종적으로 커밋하는 파일은 세 개여도, 읽어야 하는 파일은 스무 개 더 있을 수 있습니다.
같은 상태에 또 누가 쓰는지 찾아야 할 수 있습니다. 같은 서비스를 쓰는 두 번째 흐름이 있을 수도 있습니다. 기반 클래스에 중요한 부작용의 연쇄가 숨어 있을 수 있습니다. API 뒤의 암묵적 가정을 다른 팀이 설명해야 할 수도 있습니다. 영향을 받지 않는다고 누구도 확실히 말하지 못해 QA가 여러 사용자 흐름의 회귀 테스트를 요구할 수도 있습니다.
이때 패치는 작게 남아도 변경 비용은 커집니다.
Big Ball of Mud에서는 변경의 가장 비싼 부분이 실제 패치 바깥에 있을 수 있습니다.
실제 패치는 작아도 이해와 회귀 검증은 시스템의 넓은 부분에 걸칠 수 있습니다.
문제는 파일 수가 아닙니다
섹션 제목: “문제는 파일 수가 아닙니다”따라서 diff의 크기가 변경의 아키텍처 품질을 말해 주는 데에는 한계가 있습니다.
API 전환으로 파일 백 개를 수정해도 아주 잘 통제할 수 있습니다. 명확하게 정의된 인터페이스를 기계적으로 이관할 수 있습니다. 영향을 받는 소비자를 모두 압니다. 컴파일러, 테스트, 정적 분석이 수정할 곳을 믿을 만하게 알려 줍니다. diff는 크지만 영향 범위는 명확합니다.
반대로 세 줄을 바꾸는 일이 아주 위험할 수 있습니다.
불리언 값을 설정합니다. 전역 서비스가 반응합니다. 다른 프로세스가 나중에 같은 상태를 읽습니다. 기반 클래스에는 암묵적인 부작용이 있습니다. 다른 곳은 특정 실행 순서를 전제합니다.
diff에는 거의 보이지 않을 수 있습니다.
문제는 diff의 크기가 아닙니다. 그 영향에 대한 불확실성입니다.
이 구분이 없으면 엉뚱한 겉모습으로 아키텍처를 평가하게 됩니다. 수정한 파일이 많으면 큰 변경처럼 보이고, 적으면 국소적인 변경처럼 보입니다.
하지만 눈에 보이는 변경과 실제 영향 범위는 다릅니다.
Gall, Hajek, Jazayeri는 이미 1990년대 말에 대형 통신 시스템의 릴리스 이력을 통해 모듈 사이에 중요한 ‘논리적’ 의존성이 있을 수 있음을 보였습니다. 이는 뚜렷한 정적 관계만으로 완전히 도출할 수 없습니다. 반복해서 함께 바뀌는 패턴은 소스 코드나 문서만으로 명확히 드러나지 않는 관계를 보여 줄 수 있습니다.
실무적으로 두 곳이 같은 폴더에 있거나, 같은 클래스를 임포트하거나, 분명한 인터페이스로 연결되어 있어야만 실제 변경에서 함께 다뤄지는 것은 아닙니다.
리포지터리는 국소적으로 보여도 국소적으로 변경할 수 없을 수 있습니다.
변경의 국소성 — Locality of Change
섹션 제목: “변경의 국소성 — Locality of Change”앞선 진단 글에서는 **변경의 국소성(Locality of Change)**을 도메인 경계가 코드에서 아직 제 역할을 하는지 보여 주는 지표로 사용했습니다.
여기서는 특히 경제적 결과에 주목하겠습니다.
변경의 국소성은 다음을 뜻하지 않습니다.
하나의 도메인 변경은 파일 하나에만 영향을 주어야 합니다.
현실적이지 않을뿐더러 많은 아키텍처에서 잘못된 유인을 만드는 규칙입니다.
뜻하는 것은 다릅니다.
도메인상 국소적인 변경에는 기술적으로 범위를 한정할 수 있는 영향 영역이 있어야 합니다.
설정의 동작을 바꾸기 위해 UI, Application 레이어, 상태, 영속화, 테스트를 수정해야 할 수 있습니다. 전적으로 건전한 구조일 수 있습니다. 중요한 것은 왜 그 영역들이 포함되고 다른 영역들은 포함되지 않는지 아느냐입니다.
이런 의미에서 아키텍처는 구조만이 아니라 믿을 만한 제외 근거도 만듭니다.
다음과 같이 말할 수 있게 해 줍니다.
이 상태는 오직 여기에서만 변경합니다.
영속화는 이 인터페이스를 통해서만 가능합니다.
이 도메인 결정은 이 슬라이스가 소유합니다.
이 소비자들은 이 계약에 의존합니다.
이 경계 뒤에서는 이번 변경을 위해 더 찾지 않아도 됩니다.
특히 마지막 말은 소중합니다. 중요한 관계를 찾을 수 있어야만 시스템이 유지보수하기 좋은 것은 아닙니다. 개발자가 시스템의 넓은 부분을 무관한 영역으로 믿고 제외할 수 있어야 합니다.
그렇게 제외할 수 없을수록 혹시 몰라 살펴봐야 하는 범위는 커집니다.
도메인 요구는 국소적입니다.
시스템이 그것을 전역적인 문제로 만듭니다.
변경 증폭 — Change Amplification
섹션 제목: “변경 증폭 — Change Amplification”John Ousterhout는 비슷한 현상을 **변경 증폭(Change Amplification)**이라고 부릅니다. 단순해 보이는 변경 때문에 여러 곳을 수정해야 하는 경우입니다. 강의 자료에서는 높은 인지 부담과 ‘unknown unknowns’와 나란히 다룹니다. 후자는 개발자가 알아야 한다는 사실조차 아직 모르는 중요한 관계를 뜻합니다.
Big Ball of Mud를 이해하는 데 도움이 되는 관점입니다. 다만 정확한 측정 지표인 것처럼 취급해서는 안 됩니다.
여기서 변경 증폭은 파일 수를 세어 일정 비율을 넘으면 나쁜 아키텍처라고 판정한다는 뜻이 아닙니다.
증폭은 여러 곳에서 일어날 수 있습니다.
작은 도메인 변경이 추가 분석을 만들 수 있습니다. 멀리 떨어진 기술적 변경을 요구할 수 있습니다. 테스트 범위를 넓히거나 추가 리뷰를 필요로 할 수 있습니다. 원래 티켓의 도메인 요구와 무관한 사람들과 조율해야 할 수도 있습니다. 릴리스가 더 위험해 보이고, 그래서 추가적인 안전장치가 필요해질 수 있습니다.
모든 변경마다 이런 일이 다 일어난다는 것이 핵심은 아닙니다. 원래 국소적인 변경에서 규칙적으로 나타나는지가 중요합니다. 그때 우리는 어려운 티켓 몇 개가 아니라 시스템의 특성을 보고 있습니다.
작은 티켓에서 넓은 영향 범위로
섹션 제목: “작은 티켓에서 넓은 영향 범위로”시작은 대개 평범합니다.
요구사항은 국소적입니다. 분석하다 보니 또 다른 상태를 고려해야 한다는 사실이 드러납니다. 그 상태에는 두 번째 쓰기 지점이 있습니다. 그래서 추가 서비스가 관련 범위에 들어옵니다. 다른 흐름도 그 서비스를 사용합니다. 그 동작이 바뀌는지 확인해야 합니다. 회귀 검증이 늘어납니다. 리뷰어가 또 다른 의존성을 찾습니다. QA가 시나리오를 추가합니다.
작은 도메인 변경이 단계적으로 훨씬 큰 위험 검증 작업이 됩니다.
작은 도메인 변경
→ 넓어지는 분석 범위
→ 추가 기술적 접점
→ 커지는 잠재적 영향 범위
→ 더 많은 회귀 검증
→ 더 많은 리뷰와 조율
→ 높아지는 릴리스 불확실성
→ 길어지는 리드 타임
자연법칙은 아닙니다.
의존성 하나가 늘었다고 반드시 버그가 생기지는 않습니다. 회귀 테스트가 커져도 릴리스가 늦어지지 않을 수 있습니다. 공용 서비스가 자동으로 나쁜 아키텍처인 것도 아닙니다.
기술적 경계가 이 연쇄를 일찍 멈추게 하는 능력을 잃으면 메커니즘은 문제가 됩니다.
언제 충분히 분석했는지 알 수 없게 됩니다.
다시 같은 질문입니다.
이 변경은 어디에서 끝납니까?
QA가 계속 새 오류를 찾을 수 있었던 이유
섹션 제목: “QA가 계속 새 오류를 찾을 수 있었던 이유”2주 뒤의 모달 대화상자 구현 결과가 개발자의 잘못 때문에 무가치했던 것은 아닙니다.
정반대였습니다.
그는 이미 숨은 관계의 상당 부분을 발견하고 반영했습니다. 그래도 QA는 그 뒤로 다른 오류 상태를 반복해서 만들어 낼 수 있었습니다.
실패한 패치 하나가 원인은 아니었습니다. 변경 전에 실제 영향 범위를 믿을 만하게 정할 수 없었던 것이 원인이었습니다.
예를 들어 수정 하나로 상태를 올바르게 쓰게 되었습니다. 그런데 그 결과 다음 흐름의 타이밍이 달라졌습니다. 그 흐름에서 경쟁 상태가 드러났습니다. 다음 수정은 또 다른 쓰기 주체나 읽기 주체에 영향을 줬습니다. 이전 오류가 가리고 있던 상태가 나타났습니다.
단순하게 표현하면 이랬습니다.
수정 → 부작용 → 수정 → 또 다른 부작용
수정이 모두 잘못된 것은 아닙니다. 시스템 때문에 그 결과가 어디에서 끝날지 예측하기 어려웠습니다.
그래서 지금 제게는 약 40개라는 숫자보다 그 과정이 더 흥미롭습니다. 버그가 많은 데에는 여러 원인이 있을 수 있습니다. 아키텍처 관점에서 중요한 것은, 이미 이해했다고 생각한 뒤에도 같은 영향 영역의 새로운 부분이 계속 드러났다는 사실이었습니다.
대화상자가 점점 커진 것이 아닙니다. 그 대화상자와 관련된 시스템 맥락이 드러난 것입니다.
추론의 국소성은 업무 시간의 문제이기도 합니다
섹션 제목: “추론의 국소성은 업무 시간의 문제이기도 합니다”변경의 국소성과 밀접한 개념으로 앞서 소개한 **추론의 국소성(Locality of Reasoning)**이 있습니다.
어떤 도메인 영역을 대부분 그 자체로 이해할 수 있다면, 국소적인 변경을 위해 개발자가 머릿속에 구성할 모델도 제한적입니다. 외부 의존성은 물론 있습니다. 다만 계약이 그 의존성을 제한하고, 내부 구현은 이번 변경에 대체로 무관해도 된다는 것이 중요합니다.
이 특성이 없으면 국소적인 변경을 위해 점점 더 많은 비국소적 동작을 이해해야 합니다.
개발자는 티켓을 처리할 뿐 아니라 시스템도 복원합니다.
누가 이 상태를 소유합니까? 또 누가 씁니까? 어떤 순서를 전제합니까? 정말 무상태 서비스입니까? 어떤 기반 클래스가 개입합니까? 다른 어떤 흐름이 같은 객체를 사용합니까? 어떤 테스트가 실제 불변 조건을 나타내고 어떤 테스트는 현재 구현 상태만 그대로 담고 있습니까?
프로그램 이해에 관한 경험적 연구는 유지보수와 변경 작업에서 바로 이런 정보 요구를 다룹니다. 예를 들어 Sillito와 동료들은 개발자가 변경 작업 중 기존 코드베이스에 대해 어떤 질문에 답해야 하는지 분석했습니다. 실제 코드 수정은 유지보수 작업의 일부일 뿐입니다. 그 전에 기존 시스템에 관한 충분한 관련 지식을 쌓아야 합니다.
레거시 시스템에서 이런 이해 작업을 언제나 피할 수 있는 것은 아닙니다.
하지만 작은 변경에도 이 머릿속 모델이 시스템 전체의 상당 부분을 정기적으로 포함해야 한다면 문제가 됩니다.
국소적으로 작은 티켓에 시스템 전반의 이해 범위가 필요할 수 있습니다.
기술 부채는 기능에 없는 일을 만들어 냅니다
섹션 제목: “기술 부채는 기능에 없는 일을 만들어 냅니다”이렇게 앞선 글들의 기술 부채 개념과도 다시 연결됩니다.
우리 티켓의 도메인 과제는 이랬습니다.
모달 대화상자와 설정.
실제 작업에는 상태 소유권 복원, 여러 쓰기 주체 발견, 영속화 동작 이해, 암묵적 순서 가정 발견, 경쟁 상태 재현, 회귀 분석, 추가 테스트가 더해졌습니다.
어느 것도 사용자에게 대화상자의 가치를 더해 주지는 않았습니다.
기존 구조에도 불구하고 원하는 도메인 가치를 안정적으로 제공하려면 필요한 일이었습니다.
바로 이 지점에서 기술 부채는 경제적 개념으로 흥미로워집니다. Martini, Bosch, Chaudron은 여러 대기업의 아키텍처 기술 부채를 연구하며 단기 납품에는 도움이 되지만 장기적으로는 후속 기능 개발을 가로막을 수 있는 아키텍처 결정을 설명합니다.
이후 Besker, Martini, Bosch는 개발자가 기술 부채 때문에 구체적으로 어디에서 시간을 더 잃는지 연구했습니다. 종단 연구와 재현 연구에서 개발자들은 상당한 추가 작업을 보고했습니다. 특히 테스트에 추가 시간이 드는 경우가 많았습니다. 구체적인 비율을 모든 회사에 적용할 수는 없습니다. 하지만 관찰된 메커니즘은 이 논의에 중요합니다. 기술 부채는 눈에 보이는 리팩터링 필요만이 아니라 평범한 개발 중의 추가 작업으로도 나타납니다.
그래서 질문이 달라집니다.
이 질문이 아닙니다.
이 개발자는 왜 대화상자 하나에 5주나 걸립니까?
이 질문입니다.
이 시스템은 왜 대화상자 하나에 개발과 위험 검증 작업을 5주나 필요로 합니까?
단지 더 공손하게 표현한 것이 아닙니다. 살펴보는 단위가 달라집니다.
첫 질문은 사람이나 추정에서 잘못을 찾습니다. 두 번째는 작은 도메인 요구를 거대한 기술적 작업 범위로 만드는 시스템을 묻습니다.
추정의 근거가 사라집니다
섹션 제목: “추정의 근거가 사라집니다”그래서 이런 시스템에서는 작업량을 추정하기 어렵습니다.
추정은 언제나 예상하는 변경 범위에 관한 진술입니다.
모달 티켓에 이틀을 추정했다면, 대화상자 추가, 기존 설정 서비스 사용, 30일 규칙 구현, 테스트 작성 정도를 생각했을 수 있습니다.
그 가정이라면 이틀은 충분히 그럴듯합니다.
하지만 구현 중에 드러납니다.
설정 상태에는 쓰기 주체가 둘입니다.
백엔드에 같은 도메인 목적의 객체가 두 개 생길 수 있습니다.
읽을 때는 index 0이 결정합니다.
순서에는 도메인상의 보장이 없습니다.
다른 읽기 주체도 같은 상태에 반응합니다.
타이밍이 동작을 바꿉니다.
이미 아는 작업량을 잘못 추정한 것만이 아닙니다. 가정한 영향 범위가 틀렸습니다. 눈에 보이는 구조가 국소적인 변경을 암시했지만 기술적으로 그런 변경은 존재하지 않았습니다.
Big Ball of Mud는 변경만 예측하기 어렵게 만드는 것이 아닙니다. 변경의 크기부터 예측하기 어렵게 만듭니다.
중요한 차이입니다. 물론 어떤 개발자도 티켓을 시작하기 전에 모든 문제를 알 수는 없습니다. 좋은 아키텍처에서도 추정은 불확실합니다. 소프트웨어 개발은 결정론적 생산 라인이 아닙니다.
하지만 제대로 된 경계는 적어도 특정 종류의 불확실성을 줄입니다. 변경 전에 관련 범위를 한정하도록 도와줍니다.
그 경계가 없으면 알려진 영역 안의 일이 얼마나 힘든지뿐 아니라, 그 영역 자체가 얼마나 큰지까지 추정해야 합니다.
회귀 검증 범위 — Regression Surface
섹션 제목: “회귀 검증 범위 — Regression Surface”세 번째 범위에는 의도적으로 작업 용어를 하나 사용하겠습니다. **회귀 검증 범위(Regression Surface)**입니다.
변경 뒤에 잠재적으로 영향을 받았다고 합리적으로 보아야 하는 시스템 영역을 뜻합니다.
엄밀한 수학적 면적이 아닙니다. 이 글에서 표준화된 소프트웨어 지표로 사용하는 것도 아닙니다.
실무 질문을 표현하는 데 도움이 되는 말일 뿐입니다.
이번 변경 뒤에, 직접 고치지 않았을지도 모르는 어떤 부분까지 확인해야 합니까?
경계가 좋은 슬라이스에서는 이 범위가 비교적 작을 수 있습니다. 변경은 소유자가 알려진 도메인 상태에 영향을 줍니다. 소비자는 정의된 인터페이스를 거칩니다. 테스트는 관련 불변 조건을 보호합니다. 다른 영역은 충분한 확신을 가지고 제외할 수 있습니다.
경계가 없으면 잠재적인 영향 범위가 커집니다.
QA는 다른 흐름도 테스트해야 할 수 있습니다. 리뷰어는 서비스를 추가로 확인합니다. 개발자는 과거의 예외를 분석합니다. 다른 팀에는 그 영역이 공유 상태에 의존하는지 묻습니다. 영향받지 않는 영역의 목록을 덜 신뢰할 수 있어서 릴리스가 더 조심스러워집니다.
변경 영향 분석도 바로 이 문제에서 출발합니다. 변경의 잠재적 결과를 찾아 관련 영역을 식별하려 합니다. 연구와 실무가 수십 년 동안 이를 위한 별도의 분석법을 발전시켜 왔다는 사실만으로도, 보이는 패치와 가능한 영향은 서로 다른 것임을 알 수 있습니다.
그 분석이 얼마나 어려운지는 아키텍처도 함께 결정합니다.
변경은 어디에서 끝납니까?
섹션 제목: “변경은 어디에서 끝납니까?”어쩌면 이 글에서 가장 단순한 아키텍처 질문입니다.
이 변경은 어디에서 끝납니까?
제대로 된 아키텍처는 완벽하지는 않아도 충분히 믿을 만한 답을 줄 수 있어야 합니다.
이 도메인 상태는 여기에 속합니다.
이곳이 소유합니다.
이 인터페이스를 통해 변경할 수 있습니다.
이 경로로 영속화합니다.
이 소비자들이 의존합니다.
이 테스트들이 관련 불변 조건을 보호합니다.
그 뒤에서 이번 변경에 고려할 맥락은 끝납니다.
완전한 격리를 요구하는 것이 아닙니다. 실제 시스템에는 의존성이 있습니다. 의도적으로 여러 슬라이스, 서비스, 애플리케이션을 바꾸는 변경도 있습니다. 도메인 범위 자체가 크고 기술적 범위도 큰 것이 전적으로 타당할 때도 있습니다.
문제가 되는 경우는 더 구체적입니다.
도메인 요구는 국소적입니다. 시스템이 그것을 전역적인 문제로 만듭니다.
그때 세 범위는 서로 멀어집니다.
도메인 변경 범위는 작게 남습니다.
기술적 변경 범위는 커집니다.
이해와 회귀 검증의 범위는 그보다 더 크게 자랄 수도 있습니다.
아키텍처는 더는 살펴보지 않아도 되는 시스템 부분을 믿을 만하게 알려 줄 때 특히 가치가 있습니다.
코딩 에이전트는 어떻습니까?
섹션 제목: “코딩 에이전트는 어떻습니까?”앞선 글에서는 코딩 에이전트가 오늘날 넓은 분석 범위를 사람이 혼자 경제적으로 감당할 수 있는 것보다 더 잘 다룰 수 있음을 보았습니다.
작업량은 바꾸지만 그 밑의 메커니즘까지 바꾸지는 않습니다.
에이전트는 설정 객체에 대한 모든 쓰기 접근을 더 빨리 찾을 수 있습니다. 읽기 주체를 추적하고 서비스를 열고 호출 연쇄를 복원하며 테스트를 실행할 수 있습니다. 넓은 이해 범위를 더 쉽게 다루게 됩니다.
하지만 왜 국소적인 변경에 애초부터 그렇게 넓은 이해 범위가 필요한지라는 아키텍처 질문에는 답하지 않습니다.
도구가 바뀌어도 변경의 국소성이 여전히 중요한 이유입니다.
대화상자가 5주 동안 복잡했던 것은 아닙니다
섹션 제목: “대화상자가 5주 동안 복잡했던 것은 아닙니다”지금 티켓을 돌아보면 제게 중요한 것은 바로 이 점입니다.
모달 대화상자가 5주 동안 복잡했던 것은 아닙니다.
끝에서도 도메인 요구는 처음만큼 작았습니다. 대화상자를 보여 주고, 선택을 저장하고, 아무것도 저장하지 않았다면 30일 뒤 다시 묻습니다.
비쌌던 것은 시스템을 통과하는 길이었습니다. 같은 도메인 상태에 여러 쓰기 주체가 있고, 영속화는 하나의 명확한 기준을 만들지 못하며, 어느 설정을 기준으로 삼는지조차 보장되지 않은 순서에 달릴 수 있었습니다.
개발자가 5주 내내 대화상자 프로그래밍을 어려워한 것이 아닙니다.
그 대화상자가 시스템의 나머지 부분에서 실제로 어디에 닿는지 알아내고, 그 영향을 충분히 검증하는 데 여러 주가 필요했습니다.
그래서 모든 변경이 크다는 사실로 Big Ball of Mud를 알아보려 해서는 안 됩니다. 작은 변경도 많습니다. 처음부터 잘 되는 변경도 있습니다. 놀랄 만큼 안정적인 영역도 있을 수 있습니다.
문제는 신뢰성의 부재입니다. 제대로 된 아키텍처에서는 국소적인 변경에 보통 한정할 수 있는 기술적 영향 범위가 있습니다. Big Ball of Mud에서는 도메인 변경 범위, 기술적 변경 범위, 필요한 이해 범위가 점점 더 멀어질 수 있습니다.
따라서 이런 티켓 뒤에 더 흥미로운 질문은 이것이 아닙니다.
몇 개의 파일을 수정했습니까?
이 질문입니다.
이 국소적인 변경을 책임 있게 수행하려면 시스템을 어디까지 이해하고 검증해야 했습니까?
더 일반적으로는 이렇습니다.
충분한 확신을 가지고 어디에서 이 변경에 대한 생각을 멈출 수 있습니까?
그 답이 자꾸 “어디에서도 멈출 수 없습니다”가 된다면, 언젠가는 정말 모든 변경이 시스템 곳곳을 아프게 합니다.
출처와 추가 연구
섹션 제목: “출처와 추가 연구”- David L. Parnas: On the Criteria To Be Used in Decomposing Systems into Modules. Communications of the ACM 15(12), 1972, S. 1053–1058. DOI:
10.1145/361598.361623. 이 논문은 모듈화의 근거로 이해 가능성, 변경 용이성, 바뀔 수 있는 설계 결정을 모듈 경계 뒤에 감추는 일을 제시합니다. - Harald Gall, Karin Hajek, Mehdi Jazayeri: Detection of Logical Coupling Based on Product Release History. ICSM 1998, S. 190–198. DOI:
10.1109/ICSM.1998.738508. 대형 통신 시스템의 릴리스 이력에서 함께 바뀌는 패턴을 연구하며, 이를 통해 뚜렷한 정적 결합 너머의 논리적 의존성을 찾는 방법을 보입니다. - Cleidson R. B. de Souza, David F. Redmiles: An Empirical Study of Software Developers’ Management of Dependencies and Changes. ICSE 2008, S. 241–250. DOI:
10.1145/1368088.1368122. 변경 영향 분석을 변경의 잠재적 결과를 식별하는 일로 설명하며, 개발자가 실무에서 의존성을 다루는 방식을 연구합니다. - Jonathan Sillito, Gail C. Murphy, Kris De Volder: Questions Programmers Ask During Software Evolution Tasks. SIGSOFT FSE 2006, S. 23–34. DOI:
10.1145/1181775.1181779. 구체적인 변경 작업 중 개발자가 코드베이스에 대해 어떤 정보를 필요로 하는지 연구합니다. - Antonio Martini, Jan Bosch, Michel Chaudron: Investigating Architectural Technical Debt Accumulation and Refactoring over Time: A Multiple-Case Study. Information and Software Technology 67, 2015, S. 237–253. DOI:
10.1016/j.infsof.2015.07.005. 5개 대기업의 7개 사업장을 대상으로 아키텍처 기술 부채의 형성과 장기적인 영향을 살펴봅니다. - Terese Besker, Antonio Martini, Jan Bosch: Software Developer Productivity Loss Due to Technical Debt – A Replication and Extension Study Examining Developers’ Development Work. Journal of Systems and Software 156, 2019, S. 41–61. DOI:
10.1016/j.jss.2019.06.004. 기술 부채 때문에 생기는 추가 개발 작업을 연구하며, 추가 분석과 테스트를 개발 시간 손실의 중요한 원인으로 확인합니다. - John Ousterhout: The Nature of Complexity. Stanford CS 190, Lecture Notes, 2018. 단순한 변경이 여러 곳의 수정을 요구하는 경우를 ‘Change Amplification’이라고 부르며, 인지 부담과 ‘Unknown Unknowns’와 함께 다룹니다.