260826_01_ENH: 휴대전화 번호 인증 기능 추가

This commit is contained in:
2026-08-26 12:54:07 +09:00
parent 151af75e9c
commit b0dc957691
28 changed files with 643 additions and 19 deletions

View File

@@ -0,0 +1,33 @@
package com.kri.notihub.server.dto.send;
import io.swagger.v3.oas.annotations.media.Schema;
import java.util.Map;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "단건 발송 접수 결과")
public class SendSingleResponseDto {
public static final String VERIFICATION_ID_KEY = "verificationId";
public static final String EXPIRE_DT_KEY = "expireDt";
@Schema(description = "발송 고유 키")
private String cmid;
@Builder.Default
@Schema(description = "템플릿 목적별 추가 응답 정보")
private Map<String, Object> data = Map.of();
public static SendSingleResponseDto of(String cmid, Map<String, Object> data) {
return SendSingleResponseDto.builder()
.cmid(cmid)
.data(data == null ? Map.of() : Map.copyOf(data))
.build();
}
}

View File

@@ -2,6 +2,7 @@ package com.kri.notihub.server.dto.template;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.kri.notihub.server.common.enums.SendType;
import com.kri.notihub.server.common.enums.TemplatePurpose;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.persistence.Column;
import jakarta.validation.constraints.Email;
@@ -30,6 +31,9 @@ public class TemplateBasicDto {
@Schema(description = "템플릿 타입")
private SendType tmplatTy;
@Schema(description = "템플릿 목적 (0: 일반, 1: 휴대전화번호 인증)")
private TemplatePurpose tmplatPurpose;
@Size(max = 32)
@NotBlank
@Schema(description = "템플릿 명")

View File

@@ -2,6 +2,7 @@ package com.kri.notihub.server.dto.template;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.kri.notihub.server.common.enums.SendType;
import com.kri.notihub.server.common.enums.TemplatePurpose;
import com.kri.notihub.server.persistence.entity.TTmplatEntity;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotNull;
@@ -48,6 +49,7 @@ public class TemplateDto extends TemplateBasicDto {
.tmplatIdx(entity.getTmplatIdx())
.itrntPrjctCd(entity.getItrntPrjctCd())
.tmplatTy(SendType.fromCode(entity.getTmplatTy()))
.tmplatPurpose(TemplatePurpose.fromCode(entity.getTmplatPurpose()))
.tmplatNm(entity.getTmplatNm())
.tmplatTitle(entity.getTmplatTitle())
.tmplatBody(entity.getTmplatBody())

View File

@@ -1,5 +1,6 @@
package com.kri.notihub.server.dto.template;
import com.kri.notihub.server.common.enums.TemplatePurpose;
import com.kri.notihub.server.persistence.entity.TTmplatEntity;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
@@ -22,10 +23,14 @@ public class TemplateSummaryDto {
@Schema(description = "템플릿 명")
private String tmplatNm;
@Schema(description = "템플릿 목적")
private TemplatePurpose tmplatPurpose;
public static TemplateSummaryDto from(TTmplatEntity entity) {
return TemplateSummaryDto.builder()
.tmplatIdx(entity.getTmplatIdx())
.tmplatNm(entity.getTmplatNm())
.tmplatPurpose(TemplatePurpose.fromCode(entity.getTmplatPurpose()))
.build();
}
}

View File

@@ -0,0 +1,32 @@
package com.kri.notihub.server.dto.verification;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
import lombok.Getter;
import lombok.Setter;
@Getter
@Setter
@Schema(description = "휴대전화번호 인증 요청")
public class PhoneVerificationRequestDto {
@NotBlank
@Pattern(
regexp = "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
message = "verificationId는 UUID 형식이어야 합니다."
)
@Schema(description = "인증 발급 UUID")
private String verificationId;
@NotBlank
@Size(max = 16)
@Schema(description = "인증 대상 휴대전화번호")
private String sendTel;
@NotBlank
@Pattern(regexp = "^[0-9]{6}$", message = "verificationCode는 숫자 6자리여야 합니다.")
@Schema(description = "6자리 인증번호")
private String verificationCode;
}

View File

@@ -0,0 +1,40 @@
package com.kri.notihub.server.dto.verification;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import java.time.LocalDateTime;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "휴대전화번호 인증 결과")
public class PhoneVerificationResponseDto {
private String verificationId;
private String sendTel;
private boolean verified;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime verifiedDt;
public static PhoneVerificationResponseDto of(
String verificationId,
String sendTel,
boolean verified,
LocalDateTime verifiedDt
) {
return PhoneVerificationResponseDto.builder()
.verificationId(verificationId)
.sendTel(sendTel)
.verified(verified)
.verifiedDt(verifiedDt)
.build();
}
}