init: 클린 기반 auth 서버 설계

docs/examples/language/duplication.md

@@ -0,0 +1,137 @@
+# duplication 예시
+
+## 좋은 예시 1: 같은 정책 중복은 private method로 추출
+
+```java
+private String normalizeEmail(String rawEmail) {
+    return rawEmail.trim().toLowerCase(Locale.ROOT);
+}
+
+public User register(String rawEmail) {
+    String email = normalizeEmail(rawEmail);
+    ...
+}
+
+public User login(String rawEmail) {
+    String email = normalizeEmail(rawEmail);
+    ...
+}
+```
+
+왜 좋은가:
+
+- 같은 정책이다
+- 같은 이유로 바뀐다
+- 한 곳에서 수정 가능하다
+
+## 좋은 예시 2: 외부 API 예외 번역 중복 추출
+
+```java
+private InfrastructureException vaultFailure(String message, Exception cause) {
+    return new InfrastructureException(
+            InfrastructureErrorCode.VAULT_TRANSIT_FAILED,
+            message,
+            cause
+    );
+}
+```
+
+왜 좋은가:
+
+- 기술 실패 번역 정책이 한 곳에 모인다
+- 누락/불일치 위험이 줄어든다
+
+## 좋은 예시 3: 테스트는 중복을 일부 허용
+
+```java
+@Test
+void registers_two_users() {
+    User user1 = new User("alice");
+    User user2 = new User("bob");
+
+    forum.register(user1);
+    forum.register(user2);
+
+    assertTrue(forum.hasRegisteredUser(user1));
+    assertTrue(forum.hasRegisteredUser(user2));
+}
+```
+
+왜 좋은가:
+
+- helper/loop보다 읽기 쉽다
+- 테스트 의도가 바로 드러난다
+
+## 좋은 예시 4: 3회 이상 반복되는 mapper 규칙 추출
+
+```java
+private ApiResult<Void> failureOf(ApplicationException exception) {
+    return ApiResult.failure(exception.getCode(), exception.getMessage());
+}
+```
+
+왜 좋은가:
+
+- 응답 실패 조립 규칙이 공통 정책이다
+- presentation 전반에서 같은 이유로 바뀔 가능성이 높다
+
+## 나쁜 예시 1: 우연한 유사성을 억지로 공통화
+
+```java
+public Object process(Object input, String mode, Map<String, Object> options) {
+    ...
+}
+```
+
+문제:
+
+- 맥락이 다른 두세 개 흐름을 한 메서드로 억지로 합친다
+- 이름이 모호해지고 분기만 늘어난다
+- 이후 독립 진화가 어렵다
+
+## 나쁜 예시 2: 레이어를 넘는 공통화
+
+```java
+public final class CommonValidationUtil {
+    public static void validateUser(User user, CreateUserRequest request, UserJpaEntity entity) {
+        ...
+    }
+}
+```
+
+문제:
+
+- domain/presentation/infrastructure 경계를 한 곳에 섞는다
+- 중복 제거보다 아키텍처 손상이 더 크다
+
+## 나쁜 예시 3: 테스트를 너무 DRY하게 만들어 의미 숨김
+
+```java
+private void registerAll(List<User> users) { ... }
+
+@Test
+void registers_users() {
+    registerAll(defaultUsers());
+    assertAllRegistered(defaultUsers());
+}
+```
+
+문제:
+
+- 테스트 본문만 보면 실제 행위가 잘 드러나지 않는다
+- helper를 따라가야 해서 검증이 어려워진다
+
+## 나쁜 예시 4: common 모듈로 너무 빨리 이동
+
+```text
+common/
+  StringUtils.java
+  DateUtils.java
+  ErrorUtils.java
+  ValidationUtils.java
+```
+
+문제:
+
+- “중복 제거” 명분으로 소유권 없는 잡동사니 모듈이 된다
+- 진짜 공통인지, 그냥 아직 설계가 안 된 것인지 구분이 사라진다