Add(.footprint) : 발자취 생성 기능 및 API 추가

src/main/java/me/ajaja/module/footprint/adapter/in/web/CreateFootprintController.java

@@ -0,0 +1,30 @@
+package me.ajaja.module.footprint.adapter.in.web;
+
+import static org.springframework.http.HttpStatus.*;
+
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+import lombok.RequiredArgsConstructor;
+import me.ajaja.global.common.AjajaResponse;
+import me.ajaja.global.security.annotation.Authorization;
+import me.ajaja.global.util.SecurityUtil;
+import me.ajaja.module.footprint.application.port.in.CreateFootprintUseCase;
+import me.ajaja.module.footprint.dto.FootprintRequest;
+
+@RestController
+@RequiredArgsConstructor
+public class CreateFootprintController {
+	private final CreateFootprintUseCase createFootprintUseCase;
+
+	@Authorization
+	@PostMapping("/footprints")
+	@ResponseStatus(CREATED)
+	public AjajaResponse<Void> createFootprint(@RequestBody FootprintRequest.Create request) {
+		Long userId = SecurityUtil.getUserId();
+		createFootprintUseCase.create(userId, request);
+		return AjajaResponse.ok();
+	}
+}

src/main/java/me/ajaja/module/footprint/application/port/CreateFootprintService.java

@@ -0,0 +1,27 @@
+package me.ajaja.module.footprint.application.port;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import lombok.RequiredArgsConstructor;
+import me.ajaja.module.footprint.application.port.in.CreateFootprintUseCase;
+import me.ajaja.module.footprint.application.port.out.CreateFootprintPort;
+import me.ajaja.module.footprint.domain.Footprint;
+import me.ajaja.module.footprint.domain.FootprintFactory;
+import me.ajaja.module.footprint.dto.FootprintRequest;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class CreateFootprintService implements CreateFootprintUseCase {
+	private final FootprintFactory footprintFactory;
+	private final CreateFootprintPort createFootprintPort;
+
+	@Override
+	public Long create(Long userId, FootprintRequest.Create param) {
+		Footprint footprint = footprintFactory.create(userId, param);
+		Long footprintId = createFootprintPort.create(footprint);
+
+		return footprintId;
+	}
+}

src/main/java/me/ajaja/module/footprint/application/port/in/CreateFootprintUseCase.java

@@ -0,0 +1,7 @@
+package me.ajaja.module.footprint.application.port.in;
+
+import me.ajaja.module.footprint.dto.FootprintRequest;
+
+public interface CreateFootprintUseCase {
+	Long create(Long userId, FootprintRequest.Create param);
+}

src/main/java/me/ajaja/module/footprint/application/port/out/GetFootprintPort.java

@@ -4,5 +4,4 @@
 
 public interface GetFootprintPort {
 	Footprint getFootprint(Long id);
-
 }

src/main/java/me/ajaja/module/footprint/domain/FootprintFactory.java

@@ -2,25 +2,25 @@
 
 import org.springframework.stereotype.Component;
 
-import me.ajaja.module.footprint.dto.FootprintParam;
+import me.ajaja.module.footprint.dto.FootprintRequest;
 
 @Component
 public final class FootprintFactory {
-	public Footprint create(FootprintParam.Create param) {
+	public Footprint create(Long userId, FootprintRequest.Create param) {
 		return switch (param.getType()) {
 			case FREE -> new FreeFootprint(
-				param.getTarget(),
-				param.getWriter(),
+				new Target(param.getTargetId()),
+				new Writer(userId),
 				param.getType(),
-				param.getTitle(),
+				new Title(param.getTitle()),
 				param.isVisible(),
 				param.getContent()
 			);
 			case KPT -> new KptFootprint(
-				param.getTarget(),
-				param.getWriter(),
+				new Target(param.getTargetId()),
+				new Writer(userId),
 				param.getType(),
-				param.getTitle(),
+				new Title(param.getTitle()),
 				param.isVisible(),
 				param.getKeepContent(),
 				param.getProblemContent(),

src/main/java/me/ajaja/module/footprint/domain/Target.java

@@ -2,19 +2,14 @@
 
 import java.beans.ConstructorProperties;
 
-import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Size;
 import lombok.Getter;
 import me.ajaja.global.common.SelfValidating;
 
 @Getter
 public class Target extends SelfValidating<Target> {
 	@NotNull
 	private final Long id;
-
-	@NotBlank
-	@Size(max = 20)
 	private final String title;
 
 	@ConstructorProperties({"id", "title"})
@@ -23,4 +18,8 @@ public Target(Long id, String title) {
 		this.title = title;
 		this.validateSelf();
 	}
+
+	public Target(Long id) {
+		this(id, null);
+	}
 }

src/main/java/me/ajaja/module/footprint/domain/Writer.java

@@ -2,19 +2,14 @@
 
 import java.beans.ConstructorProperties;
 
-import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Size;
 import lombok.Getter;
 import me.ajaja.global.common.SelfValidating;
 
 @Getter
 public class Writer extends SelfValidating<Writer> {
 	@NotNull
 	private final Long id;
-
-	@NotBlank
-	@Size(max = 20)
 	private final String nickname;
 
 	@ConstructorProperties({"id", "nickname"})
@@ -23,4 +18,8 @@ public Writer(Long id, String nickname) {
 		this.nickname = nickname;
 		this.validateSelf();
 	}
+
+	public Writer(Long id) {
+		this(id, null);
+	}
 }

src/main/java/me/ajaja/module/footprint/dto/FootprintRequest.java

@@ -0,0 +1,37 @@
+package me.ajaja.module.footprint.dto;
+
+import java.beans.ConstructorProperties;
+import java.util.List;
+
+import lombok.Data;
+import me.ajaja.module.footprint.domain.Footprint;
+
+public final class FootprintRequest {
+	@Data
+	public static class Create {
+		private final Long targetId;
+		private final Footprint.Type type;
+		private final String title;
+		private final boolean visible;
+		private final String content;
+		private final String keepContent;
+		private final String problemContent;
+		private final String tryContent;
+		private final List<String> tags;
+
+		@ConstructorProperties({"targetId", "type", "title", "visible", "content", "keepContent", "problemContent",
+			"tryContent", "tags"})
+		public Create(Long targetId, Footprint.Type type, String title, boolean visible, String content,
+			String keepContent, String problemContent, String tryContent, List<String> tags) {
+			this.targetId = targetId;
+			this.type = type;
+			this.title = title;
+			this.visible = visible;
+			this.content = content;
+			this.keepContent = keepContent;
+			this.problemContent = problemContent;
+			this.tryContent = tryContent;
+			this.tags = tags;
+		}
+	}
+}

src/main/java/me/ajaja/module/tag/domain/FootprintTag.java

@@ -0,0 +1,35 @@
+package me.ajaja.module.tag.domain;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.validation.constraints.NotNull;
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Table(name = "footprint_tag")
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class FootprintTag {
+	@Id
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	@Column(name = "footprint_tag_id")
+	private Long id;
+
+	@Column(name = "tag_id")
+	@NotNull
+	private Long tagId;
+
+	@Column(name = "footprint_id")
+	@NotNull
+	private Long footprintId;
+
+	public FootprintTag(Long id, Long tagId, Long footprintId) {
+		this.id = id;
+		this.tagId = tagId;
+		this.footprintId = footprintId;
+	}
+}

src/test/java/me/ajaja/common/support/WebMvcTestSupport.java

@@ -34,6 +34,7 @@
 import me.ajaja.module.feedback.application.LoadFeedbackInfoService;
 import me.ajaja.module.feedback.application.LoadTotalAchieveService;
 import me.ajaja.module.feedback.application.UpdateFeedbackService;
+import me.ajaja.module.footprint.application.port.in.CreateFootprintUseCase;
 import me.ajaja.module.plan.application.port.in.CreatePlanUseCase;
 import me.ajaja.module.plan.application.port.in.DeletePlanUseCase;
 import me.ajaja.module.plan.application.port.in.LoadPlanDetailUseCase;
@@ -70,6 +71,7 @@ public abstract class WebMvcTestSupport extends MonkeySupport {
 	protected static final String PLAN_END_POINT = "/plans";
 	protected static final String FEEDBACK_END_POINT = "/feedbacks";
 	protected static final String REMIND_END_POINT = "/reminds";
+	protected static final String FOOTPRINT_END_POINT = "/footprints";
 	protected static final String BEARER_TOKEN = "Bearer eyJhbGxMiJ9.eyJzWpvdyJ9.avFKonhbIIhEg8H1dycQkhQ";
 
 	@Autowired
@@ -171,4 +173,8 @@ protected static Stream<Arguments> authenticationFailResults() {
 	protected FindTargetRemindQuery findTargetRemindQuery;
 	@MockBean
 	protected SendTestRemindUseCase sendTestRemindUseCase;
+
+	// footprint
+	@MockBean
+	protected CreateFootprintUseCase createFootprintUseCase;
 }

src/test/java/me/ajaja/common/util/ApiTag.java

@@ -8,6 +8,7 @@ public enum ApiTag {
 	FEEDBACK("피드백 API"),
 	PLAN("계획 API"),
 	REMIND("리마인드 API"),
+	FOOTPRINT("발자취 API"),
 	USER("사용자 API");
 
 	final String content;