@ExtendWith(MockitoExtension.class)
// @ExtendWith: JUnit5 환경에서 Mockito 프레임워크 확장 기능을 활성화합니다.
class PointServiceTest {

    @Mock
    // @Mock: 가짜(Mock) 객체를 생성합니다. DB 연동 없이 단위 테스트를 빠르게 실행하도록 돕습니다.
    private PointRepository pointRepository;

    @InjectMocks
    // @InjectMocks: @Mock으로 생성된 가짜 객체들을 해당 서비스 객체에 자동으로 주입해 줍니다.
    private PointService pointService;

    @Test
    // @Test: 해당 메서드가 독립적으로 실행 가능한 테스트 케이스임을 명시합니다.
    @DisplayName("충전 금액이 0 이하이면 IllegalArgumentException 예외가 발생한다")
    // @DisplayName: 테스트 실행 결과 창에 보여줄 직관적인 설명을 작성합니다.
    void chargePoint_AmountZero_ThrowsException() {
        // given
        Long userId = 1L;
        long invalidAmount = 0L;

        // when & then
        assertThatThrownBy(() -> pointService.charge(userId, invalidAmount))
                .isInstanceOf(IllegalArgumentException.class)
                .hasMessage("충전 금액은 0보다 커야 합니다.");
    }
}

@Service
// @Service: Spring의 Service 레이어 빈(Bean)으로 등록합니다.
@RequiredArgsConstructor
// @RequiredArgsConstructor: final 필드에 대한 생성자를 자동으로 만들어 의존성을 주입(DI)받습니다.
public class PointService {

    private final PointRepository pointRepository;

    @Transactional
    // @Transactional: 메서드 내의 데이터베이스 작업을 하나의 트랜잭션으로 묶어 처리합니다.
    public void charge(Long userId, long amount) {
        if (amount <= 0) {
            throw new IllegalArgumentException("충전 금액은 0보다 커야 합니다.");
        }
    }
}

@Service
@RequiredArgsConstructor
@Transactional(readOnly = true)
// readOnly = true: 기본 조회의 성능을 최적화하고, CUD 메서드에만 별도로 @Transactional을 지정합니다.
public class PointService {

    private final PointRepository pointRepository;

    @Transactional
    public PointResponse charge(Long userId, long amount) {
        validateAmount(amount);

        Point point = pointRepository.findByUserId(userId)
                .orElseGet(() -> new Point(userId, 0L));

        point.addAmount(amount);
        return PointResponse.from(point);
    }

    private void validateAmount(long amount) {
        if (amount <= 0) {
            throw new IllegalArgumentException("충전 금액은 0보다 커야 합니다.");
        }
    }
}