feat: 솜커톤 API GitHub & 포트폴리오 링크 추가

* [hotfix] 조직도 API 코드 수정

* hotfix: 조직도에 setter 추가

* hotfix: setter 임포트문 추가

* fix: 코드 수정

* test: 솜커톤 참가자 생성, 조회, 삭제 기능 테스트
- SomParticipantServiceTest (테스트)

* feat: 솜커톤 참가자 GitHub/포트폴리오 링크 추가
- SomParticipant (엔티티)
- SomParticipantRequestDto (요청 DTO)
- SomParticipantResponseDto (응답 DTO)
- SomParticipantService (서비스)

* refactor: 깃허브 링크 필수 제약 조건 제거
- SomParticipant (엔티티)
- SomParticipantRequestDto (요청 DTO)

* test: 솜커톤 참가자 CRUD 테스트
- SomParticipantServiceTest
- Setter 방식 -> Builder 방식
- Update 테스트 코드 추가

* refactor: 솜커톤 참가자 관련 리팩토링
- SomParticipant : toResponseDto 메서드 추가 및 구조 개선
- SomParticipantRequestDto : 불변 객체 및 빌더 패턴으로 변경
- SomParticipantService : DTO 변환 로직 엔티티로 위임

---------

Co-authored-by: JOO <[email protected]>
Co-authored-by: Youwol <[email protected]>
Co-authored-by: si-zero <[email protected]>

Author: 3 people

src/main/java/dmu/dasom/api/domain/somkathon/dto/SomParticipantRequestDto.java

@@ -5,40 +5,53 @@
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
 import lombok.Getter;
-import lombok.Setter;
+import org.hibernate.validator.constraints.URL;
 
 @Getter
-@Setter
+@Builder
+@AllArgsConstructor
 @Schema(description = "솜커톤 참가자 요청 DTO")
 public class SomParticipantRequestDto {
+
     @NotBlank(message = "참가자 이름은 필수 입력 값입니다.")
     @Size(max = 50, message = "참가자 이름은 최대 50자까지 입력 가능합니다.")
     @Schema(description = "참가자 이름", example = "유승완", required = true)
-    private String participantName; // 참가자 이름
+    private final String participantName; // 참가자 이름
 
     @NotBlank(message = "학번은 필수 입력 값입니다.")
     @Pattern(regexp = "^[0-9]{8}$", message = "학번은 8자리 숫자여야 합니다.")
     @Schema(description = "학번 (8자리 숫자)", example = "20250001", required = true)
-    private String studentId;
+    private final String studentId;
 
     @NotBlank(message = "학과는 필수 입력 값입니다.")
     @Size(max = 100, message = "학과는 최대 100자까지 입력 가능합니다.")
     @Schema(description = "학과", example = "컴퓨터소프트웨어공학과", required = true)
-    private String department; // 학과
+    private final String department; // 학과
 
     @NotBlank(message = "학년은 필수 입력 값입니다.")
     @Pattern(regexp = "^[1-4]$", message = "학년은 1~4 사이의 숫자여야 합니다.")
     @Schema(description = "학년 (1~4)", example = "3", required = true)
-    private String grade; // 학년
+    private final String grade; // 학년
 
     @NotBlank(message = "연락처는 필수 입력 값입니다.")
     @Pattern(regexp = "^010-[0-9]{4}-[0-9]{4}$", message = "연락처는 '010-XXXX-XXXX' 형식이어야 합니다.")
     @Schema(description = "연락처 (010-XXXX-XXXX 형식)", example = "010-1234-5678", required = true)
-    private String contact; // 연락처
+    private final String contact; // 연락처
 
     @NotBlank(message = "이메일은 필수 입력 값입니다.")
     @Email(message = "올바른 이메일 형식이 아닙니다.")
     @Schema(description = "이메일 주소", example = "[email protected]", required = true)
-    private String email; // 이메일
+    private final String email; // 이메일
+
+    @URL(protocol = "https", host = "github.com", message = "GitHub URL이 올바르지 않습니다.")
+    @Schema(description = "GitHub 주소", example = "https://github.com/username")
+    private final String githubLink; // 깃허브 주소
+
+    @NotBlank(message = "포트폴리오 주소는 필수 입력 값입니다.")
+    @URL(protocol = "https", message = "포트폴리오 URL이 올바르지 않습니다.")
+    @Schema(description = "포트폴리오 주소", example = "https://portfolio.com/username", required = true)
+    private final String portfolioLink; // 포트폴리오 주소
 }

src/main/java/dmu/dasom/api/domain/somkathon/dto/SomParticipantResponseDto.java

@@ -31,4 +31,10 @@ public class SomParticipantResponseDto {
 
     @Schema(description = "이메일 주소", example = "[email protected]", required = true)
     private String email;           // 이메일
-}
+
+    @Schema(description = "깃허브 주소", example = "https://github.com/username", required = true)
+    private String githubLink; // 깃허브 주소
+
+    @Schema(description = "포트폴리오 주소", example = "https://portfolio.com/username", required = true)
+    private String portfolioLink; // 포트폴리오 주소
+}

src/main/java/dmu/dasom/api/domain/somkathon/entity/SomParticipant.java

@@ -2,6 +2,7 @@
 
 import dmu.dasom.api.domain.common.BaseEntity;
 import dmu.dasom.api.domain.somkathon.dto.SomParticipantRequestDto;
+import dmu.dasom.api.domain.somkathon.dto.SomParticipantResponseDto;
 import jakarta.persistence.*;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
@@ -39,12 +40,37 @@ public class SomParticipant extends BaseEntity {
     @Column(nullable = false)
     private String email; // 이메일
 
+    @Column
+    private String githubLink; // 깃허브 링크
+
+    @Column(nullable = false)
+    private String portfolioLink; // 포트폴리오 링크
+
     public void update(SomParticipantRequestDto requestDto) {
         this.participantName = requestDto.getParticipantName();
         this.studentId = requestDto.getStudentId();
         this.department = requestDto.getDepartment();
         this.grade = requestDto.getGrade();
         this.contact = requestDto.getContact();
         this.email = requestDto.getEmail();
+        this.githubLink = requestDto.getGithubLink();
+        this.portfolioLink = requestDto.getPortfolioLink();
+    }
+
+    /**
+     * Entity → Response DTO 변환 메서드
+     */
+    public SomParticipantResponseDto toResponseDto(SomParticipant participant) {
+        return SomParticipantResponseDto.builder()
+                .id(participant.getId())
+                .participantName(participant.getParticipantName())
+                .studentId(participant.getStudentId())
+                .department(participant.getDepartment())
+                .grade(participant.getGrade())
+                .contact(participant.getContact())
+                .email(participant.getEmail())
+                .githubLink(participant.getGithubLink())
+                .portfolioLink(participant.getPortfolioLink())
+                .build();
     }
 }

src/main/java/dmu/dasom/api/domain/somkathon/service/SomParticipantService.java

@@ -29,19 +29,21 @@ public SomParticipantResponseDto createParticipant(SomParticipantRequestDto requ
                 .grade(requestDto.getGrade())
                 .contact(requestDto.getContact())
                 .email(requestDto.getEmail())
+                .githubLink(requestDto.getGithubLink())
+                .portfolioLink(requestDto.getPortfolioLink())
                 .build();
 
         SomParticipant saved = somParticipantRepository.save(participant);
 
-        return toResponseDto(saved);
+        return saved.toResponseDto(saved);
     }
 
     /**
      * 모든 참가자 조회 (Read)
      */
     public List<SomParticipantResponseDto> getAllParticipants() {
         return somParticipantRepository.findAll().stream()
-                .map(this::toResponseDto)
+                .map(p -> p.toResponseDto(p))
                 .collect(Collectors.toList());
     }
 
@@ -51,15 +53,18 @@ public List<SomParticipantResponseDto> getAllParticipants() {
     public SomParticipantResponseDto getParticipant(Long id){
         SomParticipant participant = findParticipantById(id);
 
-        return toResponseDto(participant);
+        return participant.toResponseDto(participant);
     }
 
+    /**
+     * 참가자 수정 (Put)
+     */
     public SomParticipantResponseDto updateParticipant(Long id, SomParticipantRequestDto requestDto){
         SomParticipant participant = findParticipantById(id);
 
         participant.update(requestDto);
 
-        return toResponseDto(participant);
+        return participant.toResponseDto(participant);
     }
 
     /**
@@ -70,22 +75,6 @@ public void deleteParticipant(Long id) {
         somParticipantRepository.deleteById(id);
     }
 
-
-    /**
-     * Entity → Response DTO 변환 메서드
-     */
-    private SomParticipantResponseDto toResponseDto(SomParticipant participant) {
-        return SomParticipantResponseDto.builder()
-                .id(participant.getId())
-                .participantName(participant.getParticipantName())
-                .studentId(participant.getStudentId())
-                .department(participant.getDepartment())
-                .grade(participant.getGrade())
-                .contact(participant.getContact())
-                .email(participant.getEmail())
-                .build();
-    }
-
     /**
      * ID로 참가자 조회 (공통 처리)
      */