DepartmentRepository.java (부서 테이블 레포지토리)

1. 개요

JpaRepository<DepartmentEntity, Long> 상속으로 기본적인 CRUD 기능을 자동으로 제공
DepartmentEntity 엔티티를 대상으로 하며, PK 타입은 Long
JPA가 제공하는 기본 메서드들 외에 부서 코드, 이름으로 조회할 수 있는 메서드 추가 정의

2. 주요 메서드

메서드명	설명	반환 타입
`findByCode(String code)`	부서 코드로 부서 정보 조회 (예: "DEV")	`Optional<DepartmentEntity>` (없으면 빈 Optional)
`findByName(String name)`	부서 이름으로 부서 정보 조회 (예: "Development")	`Optional<DepartmentEntity>` (없으면 빈 Optional)

Optional 반환으로 조회 결과가 없을 경우에 안전하게 처리가능
메서드명 규칙에 따라 JPA가 자동으로 쿼리 생성 (쿼리 메서드)

3. JPA 쿼리 메서드 특징 및 활용

메서드 이름을 보고 내부적으로 쿼리를 자동 생성해 줌
findByXxx 형식으로 조건 컬럼을 지정할 수 있어 편리
중복 조회가 아닌 단건 조회 상황에 적합 (Optional 처리로 NullPointerException 방지)
필요하다면 findByNameContaining (부분검색), findByCodeAndName (복합조건) 같은 다양한 조건도 쉽게 확장 가능

4. 간단 흐름

서비스나 컨트롤러에서
    ↓
DepartmentRepository 호출
    ↓
findByCode("DEV") or findByName("Development")
    ↓
JPA가 메서드명 기반 쿼리 생성 → DB 조회
    ↓
조회된 부서 데이터(Optional)에 담아 반환