[✨feat] InternshipWorkingPeriod 구현

[jsoonworld]

📄 Work Description

• 인턴십 공고의 근무 기간을 표현하는 VO InternshipWorkingPeriod를 구현했습니다.
• 유효성 검증을 통해 0 이하의 개월 수 입력 시 InternshipException을 발생시키도록 했습니다.
• 기간 정보를 사용자에게 보여주기 위해 toKoreanPeriod 메서드를 제공하여 "N개월" 형식으로 반환합니다.
• 예외 처리를 위해 InternshipErrorCode.INVALID_WORKING_PERIOD 항목을 새롭게 정의했습니다.

---

💭 Thoughts

• 단순히 개월 수를 Int로 관리하면 유효하지 않은 값이 혼입될 가능성이 있어 VO로 추상화했습니다.
• equals, hashCode, toString을 오버라이드하여 VO 특성을 보장하며, 출력 포맷은 명확히 분리된 메서드로 관리했습니다.
• 앞으로 기간과 관련된 도메인 규칙(예: 최대 개월 수 제한 등)이 생기더라도 이 VO를 중심으로 확장할 수 있는 구조입니다.

---

✅ Testing Result

---

🗂 Related Issue

• closed [✨feat] InternshipWorkingPeriod 구현 #56

[Copilot]

Pull Request Overview

This PR introduces a value object for internship working periods, adds validation and formatting logic, and defines a new error code for invalid inputs.

• Implement InternshipWorkingPeriod VO with positive-month validation and Korean-format output.
• Define InternshipErrorCode.INVALID_WORKING_PERIOD for validation failures.
• Add unit tests for from and toKoreanPeriod.

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
src/main/kotlin/com/terning/server/kotlin/domain/internshipAnnouncement/InternshipWorkingPeriod.kt	Introduce VO, validation, formatting, and override equals/hashCode/toString.
src/main/kotlin/com/terning/server/kotlin/domain/internshipAnnouncement/InternshipErrorCode.kt	Add INVALID_WORKING_PERIOD error code with message.
src/test/kotlin/com/terning/server/kotlin/domain/internshipAnnouncement/InternshipWorkingPeriodTest.kt	Add tests for valid/invalid creation and toKoreanPeriod.

Comments suppressed due to low confidence (1)

src/main/kotlin/com/terning/server/kotlin/domain/internshipAnnouncement/InternshipWorkingPeriod.kt:31

• The overridden toString method isn’t covered by existing tests; consider adding a unit test to verify that it returns the expected "N개월" string.

override fun toString(): String = toKoreanPeriod()

[Copilot]

The validatePositive function is declared private inside the companion object, making it inaccessible from the init block. Consider moving validation logic into a private class-level function or changing its visibility so the init block can call it directly.

Suggested change

	companion object {
	fun from(months: Int): InternshipWorkingPeriod {
	return InternshipWorkingPeriod(months)
	}
	private fun validatePositive(months: Int) {
	if (months <= 0) {
	throw InternshipException(InternshipErrorCode.INVALID_WORKING_PERIOD)
	}
	}
	private fun validatePositive(months: Int) {
	if (months <= 0) {
	throw InternshipException(InternshipErrorCode.INVALID_WORKING_PERIOD)
	}
	}
	companion object {
	fun from(months: Int): InternshipWorkingPeriod {
	validatePositive(months)
	return InternshipWorkingPeriod(months)
	}

[jsoonworld]

해당 제안은 Kotlin 동작 방식에 대한 오해로 보입니다. 🙌
validatePositive 함수는 companion object 내부에 private으로 선언되어 있지만, Kotlin에서는 클래스 본문(예: init 블록)에서 직접 호출할 수 있습니다. 실제로 현재 구조는 잘 동작하고 있으며, 유효성 검증 로직을 생성자 외부로 분리해 책임을 명확히 한 구조입니다.

따라서 해당 함수의 위치를 클래스 레벨로 옮기지 않아도 되고, 변경 없이 유지하는 것이 더 적절하다고 판단했습니다. 😊