---
name: Cohesion
description: 응집도 원칙. 도메인 단위 파일 배치, 폼 응집도 전략 선택. toss/frontend-fundamentals 기반.
type: coding-standard
category: cohesion
---

> 출처: 팀 공통 원칙 문서 `principles/` 2026-07-03 발췌. 원칙 개정은 원본(팀 공통 문서) 먼저, 이 사본은 따라간다.

# 응집도 (Cohesion)

> 함께 수정되어야 할 코드가 항상 함께 있는 코드.
> 주의: 응집도와 가독성은 충돌할 수 있다. 함께 수정하지 않으면 오류 위험이 높을 때 응집도 우선.

## P-034 도메인 단위로 파일 배치하기

파일을 종류(components/, hooks/, utils/)로 묶지 않고 도메인(기능)별로 묶는다.
함께 수정되는 파일이 한 폴더에 있어야 수정 범위를 즉시 파악할 수 있다.

```
// ❌ 종류별 — 기능 하나 수정에 여러 폴더를 돌아다녀야 함
src/
  components/UserCard.tsx
  hooks/useUser.ts
  utils/userFormat.ts

// ✅ 도메인별 — 관련 파일이 한 곳에, 도메인 간 import 시 즉시 감지 가능
src/
  domains/
    user/
      UserCard.tsx
      useUser.ts
      userFormat.ts
```

부수 효과: 도메인 간 import(`../../OtherDomain/hooks/useFoo`)가 생기면 경로만 봐도 즉시 인지 가능.
기능 삭제 시 도메인 폴더 하나만 지우면 된다.

## P-035 폼 응집도 전략 선택

폼의 특성에 따라 필드 단위 응집 vs 폼 전체 단위 응집을 의식적으로 선택한다.

| 상황                                                    | 전략                                      |
| ------------------------------------------------------- | ----------------------------------------- |
| 필드가 독립적으로 검증 / 재사용 필요 / 비동기 검증 필요 | 필드 단위 (react-hook-form `validate`)    |
| Wizard Form / 필드 간 의존성 있음 (예: 시작일·종료일)   | 폼 전체 단위 (Zod schema + `zodResolver`) |

```tsx
// 필드 단위 응집
<input
  {...register('email', {
    validate: (value) => {
      if (!value) return '이메일을 입력해주세요.';
      if (!/^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$/i.test(value))
        return '유효한 이메일 주소를 입력해주세요.';
    },
  })}
/>;

// 폼 전체 단위 응집 (필드 간 의존 시)
const schema = z
  .object({
    startDate: z.date(),
    endDate: z.date(),
  })
  .refine(({ startDate, endDate }) => endDate > startDate, {
    message: '종료일은 시작일 이후여야 합니다',
    path: ['endDate'],
  });
useForm({ resolver: zodResolver(schema) });
```
