---
kind: REFERENCE
slug: a-single-admission-point-must-count-its-bypasses
title: 단일 admission point는 우회 경로를 세어야 성립한다
topic: redis-command-admission
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: reference:a-single-admission-point-must-count-its-bypasses
verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
---

# 단일 admission point는 우회 경로를 세어야 성립한다

## 목적

단일 승인 지점이라는 선언을 그 지점이 실제로 유일하다는 증거로 읽는 것을 막는다.

## 규칙

1. 선언은 두 가지를 함께 주장한다
   지나는 것이 전부 검사된다는 것과 모든 것이 지난다는 것이다. 코드가 보장하는 것은 대개 첫 번째뿐이다.

2. 하위 계층 타입을 직접 참조하는 곳을 센다
   승인 지점이 감싸고 있는 타입을 상위 코드가 직접 부르면 그것이 우회다.

3. 임포트 목록이 빠른 지표다
   어떤 패키지에서 무엇을 가져오는지 집계하면 우회 여부가 드러난다.

4. 우회가 있으면 선언을 좁히거나 경로를 막는다
   둘 중 하나를 하지 않으면 다음 사람이 같은 오해를 한다.

5. 컴파일 시점에 막을 수 있으면 그렇게 한다
   하위 타입을 패키지 밖에서 볼 수 없게 하면 우회 경로가 생기지 않는다.

## 적용 조건

단일 진입점이나 단일 승인 지점을 표방하는 모든 계층

정책과 실행이 분리된 구조

## 예외

성능이나 특수 목적으로 의도적으로 우회를 허용하는 경로가 있을 수 있다. 그 경우 어떤 검사가 생략되는지가 그 자리에 적혀 있어야 한다.

## 예시

명령 정책 가드가 자기를 모든 명령이 지나는 단일 승인 지점이라고 적는다. 의미 어댑터 다섯이 가드도 실행기도 타입 API 도 참조하지 않고 게이트웨이를 30 회 직접 부른다.

허가 출처 확인이 그 우회로 함께 건너뛰어진다. 가드는 애플리케이션이 허가 인터페이스를 직접 구현하는 경우까지 막도록 설계되어 있다.

## 관계

- **의미 어댑터 다섯이 gateway를 직접 불러 admission 아홉 단계를 건너뛴다**
  이 규칙을 만든 사례다.
- **명령 카탈로그와 admission 아홉 단계**
  우회되는 대상이다.
- **중복 장치를 찾으면 어느 쪽이 조립됐는지 먼저 확인한다**
  같은 계열의 확인 규칙이다.