Files
clean-architecture-frontend…/docs/manual/reference
DongHyeonka 5aac37e676 fix(architecture): 구조 규칙의 넓은 예외를 좁히고 kernel 규칙에 fixture를 둔다
문제: 꼭 지킬 것 2의 kernel 규칙을 고정하는 fixture가 없어, pathNot을
넓히거나 규칙을 지워도 아무것도 실패하지 않는다(02-01). routing 예외가
금지 대상 일곱을 다 풀고, contribution 파일 예외가 adapter 값까지 푼다.
그래서 presentation이 HTTP adapter에 닿는 길이 규칙 밖에 있다(02-02).
generic-presentation 예외 목록에 registry를 더는 읽지 않는 home-page가
남았다(02-03). 기능의 계층 밖 폴더가 자기 adapters/를 거쳐 src/adapters에
닿는 두 단계 길이 열려 있다(0929/12-03). application TelemetryPort가
플랫폼 TelemetryPort와 이름이 같고, 폐기 표시된 src/application/result.ts를
ports 셋이 상대 경로로 계속 읽는다(1101/16-05).

고른 방법(R9-D3 좁히기):
- 그래프가 type-only import를 가르고, 규칙 to에 dependencyTypesNot
  ["type-only"]를 쓸 수 있다(산출물 모양은 그대로).
- platform 규칙을 둘로 나눈다. routing도 features·adapters·bootstrap·
  presentation·application은 못 읽고, apps·contexts만 routing이 읽는다.
- feature-adapter-contribution-reads-adapter-types-only: contribution
  파일은 src/adapters를 타입으로만 읽는다.
- feature-support-folders-do-not-reach-feature-adapters: 다섯 계층이 아닌
  폴더는 자기 기능의 adapters/를 import하지 않는다.
- home-page를 예외 목록에서 뺀다. 이름으로 적은 파일 예외가 더 쓰이지
  않으면 check:architecture가 실패한다.
- kernel·routing·type-only·두 단계 길 fixture와 assertion을 더한다.
- ApplicationTelemetryPort로 이름을 나누고 옛 이름은 한 릴리스 동안
  @deprecated 별칭으로 둔다. ports 셋이 Result를 src/contracts/result.ts에서
  읽게 하고 src/application/result.ts를 지운다.
버린 대안: page-templates.tsx가 LinkButton을 design-system index에서
가져오기 — index가 page-templates를 다시 내보내 순환이 된다. 예외
이유에 그것을 적었다. 기능 경계 둘을 하나로 합치기 — 안쪽은 라우트 내용,
바깥은 라우트 틀(RouteLifecycle, 입력 해석)을 맡아 역할이 다르다. 두
자리에 역할을 적었다.

위험·한계: 이름 예외 검사는 pathNot 문자열에 파일 base name이 있는
경우만 이름 예외로 본다. 폴더·이름 패턴 예외는 보지 않는다.

검증: desktop 결과는 PR 본문.

Refs: 1112/02-01, 1112/02-02, 1112/02-03, 0929/12-03, 1101/16-05
2026-11-13 20:18:07 +09:00
..