---
kind: REFERENCE
slug: off-must-be-structural
title: "꺼짐"은 조건의 반복이 아니라 구조여야 한다
topic: assembly-ownership
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: reference:off-must-be-structural
verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
---

# "꺼짐"은 조건의 반복이 아니라 구조여야 한다

능력을 끄는 일을 빈마다 조건을 반복하는 방식으로 처리해서, 다음 달에 추가된 빈이 조건을 잊는 것을 막는다. 루트 하나가 조건을 소유하고 자식을 컴포넌트 스캔 밖에 두면, 제외와 소유가 한 쌍으로 관리되는 한 꺼짐이 구조가 된다.

## 목적

능력을 끄는 일을 빈마다 조건을 반복하는 방식으로 처리해서, 다음 달에 추가된 빈이 조건을 잊는 것을 막는다.

## 규칙

1. 루트 하나가 조건을 소유한다
   그 루트가 자식 설정을 Import 하고 자식은 조건을 갖지 않는다. 자식에 빈이 추가되어도 자동으로 게이트된다.

2. 자식을 컴포넌트 스캔 밖에 둔다
   스캔이 자식 설정을 독립적으로 발견하면 마스터 스위치와 무관하게 조립된다. 스캔 제외가 루트를 유일한 입구로 만든다.

3. 스캔에서 뺐으면 소유자를 반드시 지정한다
   제외와 소유는 한 쌍이다. 한쪽만 하면 컴포넌트가 어디에도 없게 된다.

4. 스위치를 읽는 곳이 여럿이면 그중 하나만 권한을 갖는다
   같은 속성을 읽는 주체가 여럿이면 각자가 다른 것이 켜졌다고 믿는 상태가 생긴다.

5. 프레임워크 자신의 자동설정도 후보에서 빼야 한다
   프로젝트 조건은 그것을 막지 못한다. 후보 집합을 좁히는 필터가 따로 필요하다.

## 적용 조건

선택적 능력을 갖는 모든 모듈

능력이 여러 설정 클래스로 나뉘는 경우

## 예외

능력 안에서 다시 갈리는 하위 선택지는 자기 조건을 가질 수 있다. 그 조건은 마스터 스위치의 반복이 아니라 다른 질문이어야 한다.

## 예시

컴포지션 루트가 13개 패키지 접두사를 스캔에서 빼고 자동설정이 소유하게 한다. 클래스 목록이 아니라 접두사인 이유는 새 설정이 추가됐을 때 아무도 제외를 기억하지 못했다는 이유로 활성화되면 안 되기 때문이다.

mongo 리프에서는 세 주체가 같은 속성을 읽으며 각자 마스터처럼 행동했다. 지금은 루트 하나가 권한을 갖고, 자동설정 임포트 필터는 프레임워크 자신의 자동설정을 후보에서 빼는 일만 한다.

## 관계

- **마스터 스위치는 루트 하나가 소유하고 자식 설정은 조건을 갖지 않는다**
  이 규칙을 채택한 결정이다.
- **넓은 스캔을 좁히자 여덟 컴포넌트에 아무것도 도달하지 않았다**
  제외만 하고 소유를 지정하지 않았을 때의 결과다.
- **프레임워크가 기여하는 자동설정까지 세지 않으면 스위치가 아니다**
  다섯 번째 규칙을 별도로 다룬다.