[Feature] - 여행기 작성 API 및 여행기 전체 조회 API 구현

backend/src/main/java/woowacourse/touroot/travelogue/controller/TravelogueController.java

@@ -1,14 +1,24 @@
 package woowacourse.touroot.travelogue.controller;
 
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
+import java.net.URI;
 import lombok.RequiredArgsConstructor;
+import org.springdoc.core.converters.models.PageableAsQueryParam;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort.Direction;
+import org.springframework.data.web.PageableDefault;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
+import woowacourse.touroot.travelogue.dto.TravelogueRequest;
 import woowacourse.touroot.travelogue.dto.TravelogueResponse;
 import woowacourse.touroot.travelogue.service.TravelogueFacadeService;
 
@@ -20,9 +30,29 @@ public class TravelogueController {
 
     private final TravelogueFacadeService travelogueFacadeService;
 
+    @Operation(description = "여행기 작성")
+    @PostMapping
+    public ResponseEntity<TravelogueResponse> createTravelogue(@Valid @RequestBody TravelogueRequest request) {
+        TravelogueResponse response = travelogueFacadeService.createTravelogue(request);
+
+        return ResponseEntity.created(URI.create("/api/v1/travelogues/" + response.id()))
+                .body(response);
+    }
+
     @Operation(description = "여행기 상세 조회")
     @GetMapping("/{id}")
     public ResponseEntity<TravelogueResponse> findTravelogue(@Valid @PathVariable Long id) {
         return ResponseEntity.ok(travelogueFacadeService.findTravelogueById(id));
     }
+
+    @Operation(description = "여행기 메인 페이지 조회")
+    @PageableAsQueryParam
+    @GetMapping
+    public ResponseEntity<Page<TravelogueResponse>> findMainPageTravelogues(
+            @Parameter(hidden = true)
+            @PageableDefault(size = 5, sort = "id", direction = Direction.DESC)
+            Pageable pageable
+    ) {
+        return ResponseEntity.ok(travelogueFacadeService.findTravelogues(pageable));
+    }
 }

backend/src/main/java/woowacourse/touroot/travelogue/domain/day/service/TravelogueDayService.java

@@ -1,20 +1,40 @@
 package woowacourse.touroot.travelogue.domain.day.service;
 
+import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Map;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import woowacourse.touroot.global.exception.BadRequestException;
 import woowacourse.touroot.travelogue.domain.Travelogue;
 import woowacourse.touroot.travelogue.domain.day.domain.TravelogueDay;
 import woowacourse.touroot.travelogue.domain.day.repository.TravelogueDayRepository;
+import woowacourse.touroot.travelogue.dto.TravelogueDayRequest;
+import woowacourse.touroot.travelogue.dto.TraveloguePlaceRequest;
 
 @RequiredArgsConstructor
 @Service
 public class TravelogueDayService {
 
     private final TravelogueDayRepository travelogueDayRepository;
 
+    @Transactional
+    public Map<TravelogueDay, List<TraveloguePlaceRequest>> createDays(
+            List<TravelogueDayRequest> requests,
+            Travelogue travelogue
+    ) {
+        Map<TravelogueDay, List<TraveloguePlaceRequest>> daysWithPlaceRequests = new LinkedHashMap<>();
+
+        for (int i = 0; i < requests.size(); i++) {
+            TravelogueDayRequest request = requests.get(i);
+            TravelogueDay travelogueDay = request.toTravelogueDay(i, travelogue);
+            daysWithPlaceRequests.put(travelogueDayRepository.save(travelogueDay), request.places());
+        }
+
+        return daysWithPlaceRequests;
+    }
+
     @Transactional(readOnly = true)
     public List<TravelogueDay> findDaysByTravelogue(Travelogue travelogue) {
         return travelogueDayRepository.findByTravelogue(travelogue);

backend/src/main/java/woowacourse/touroot/travelogue/domain/photo/domain/TraveloguePhoto.java

@@ -35,7 +35,7 @@ public class TraveloguePhoto extends BaseEntity {
     @ManyToOne(fetch = FetchType.LAZY)
     private TraveloguePlace traveloguePlace;
 
-    public TraveloguePhoto(String key, Integer order, TraveloguePlace traveloguePlace) {
+    public TraveloguePhoto(Integer order, String key, TraveloguePlace traveloguePlace) {
         this(null, key, order, traveloguePlace);
     }
 }

backend/src/main/java/woowacourse/touroot/travelogue/domain/photo/service/TraveloguePhotoService.java

@@ -1,19 +1,36 @@
 package woowacourse.touroot.travelogue.domain.photo.service;
 
+import java.util.ArrayList;
 import java.util.Comparator;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
 import woowacourse.touroot.travelogue.domain.photo.domain.TraveloguePhoto;
 import woowacourse.touroot.travelogue.domain.photo.repository.TraveloguePhotoRepository;
 import woowacourse.touroot.travelogue.domain.place.domain.TraveloguePlace;
+import woowacourse.touroot.travelogue.dto.TraveloguePhotoRequest;
 
 @RequiredArgsConstructor
 @Service
 public class TraveloguePhotoService {
 
     private final TraveloguePhotoRepository traveloguePhotoRepository;
 
+    @Transactional
+    public List<TraveloguePhoto> createPhotos(List<TraveloguePhotoRequest> requests, TraveloguePlace place) {
+        List<TraveloguePhoto> photos = new ArrayList<>();
+
+        for (int i = 0; i < requests.size(); i++) {
+            TraveloguePhotoRequest request = requests.get(i);
+            TraveloguePhoto photo = request.toTraveloguePhoto(i, place);
+            photos.add(traveloguePhotoRepository.save(photo));
+        }
+
+        return photos;
+    }
+
+    @Transactional(readOnly = true)
     public List<String> findPhotoUrlsByPlace(TraveloguePlace traveloguePlace) {
         List<TraveloguePhoto> photos = traveloguePhotoRepository.findByTraveloguePlace(traveloguePlace);
 

backend/src/main/java/woowacourse/touroot/travelogue/domain/place/dto/TravelogueLocationResponse.java

@@ -0,0 +1,16 @@
+package woowacourse.touroot.travelogue.domain.place.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Builder;
+
+@Builder
+public record TravelogueLocationResponse(
+        @Schema(description = "여행기 장소 위도", example = "37.5175896")
+        @NotBlank(message = "여행기 장소 위도는 비어있을 수 없습니다.")
+        String lat,
+        @Schema(description = "여행기 장소 설명", example = "127.0867236")
+        @NotBlank(message = "여행기 장소 경도는 비어있을 수 없습니다.")
+        String lng
+) {
+}

backend/src/main/java/woowacourse/touroot/travelogue/domain/place/dto/TraveloguePlaceResponse.java

@@ -17,12 +17,7 @@ public record TraveloguePlaceResponse(
         @Schema(description = "여행기 장소 설명", example = "성담 빌딩에 위치한 선릉 캠퍼스입니다.")
         @NotBlank(message = "여행기 장소 설명은 비어있을 수 없습니다.")
         String description,
-        @Schema(description = "여행기 장소 위도", example = "37.5175896")
-        @NotBlank(message = "여행기 장소 위도는 비어있을 수 없습니다.")
-        String lat,
-        @Schema(description = "여행기 장소 설명", example = "127.0867236")
-        @NotBlank(message = "여행기 장소 경도는 비어있을 수 없습니다.")
-        String lng,
+        @NotNull TravelogueLocationResponse location,
         List<String> photoUrls
 ) {
 }

backend/src/main/java/woowacourse/touroot/travelogue/domain/place/service/TraveloguePlaceService.java

@@ -1,20 +1,53 @@
 package woowacourse.touroot.travelogue.domain.place.service;
 
+import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Map;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import woowacourse.touroot.global.exception.BadRequestException;
+import woowacourse.touroot.place.domain.Place;
+import woowacourse.touroot.place.repository.PlaceRepository;
 import woowacourse.touroot.travelogue.domain.day.domain.TravelogueDay;
 import woowacourse.touroot.travelogue.domain.place.domain.TraveloguePlace;
 import woowacourse.touroot.travelogue.domain.place.repsitory.TraveloguePlaceRepository;
+import woowacourse.touroot.travelogue.dto.TraveloguePhotoRequest;
+import woowacourse.touroot.travelogue.dto.TraveloguePlaceRequest;
 
 @RequiredArgsConstructor
 @Service
 public class TraveloguePlaceService {
 
+    private final PlaceRepository placeRepository;
     private final TraveloguePlaceRepository traveloguePlaceRepository;
 
+    @Transactional
+    public Map<TraveloguePlace, List<TraveloguePhotoRequest>> createPlaces(
+            List<TraveloguePlaceRequest> requests,
+            TravelogueDay day
+    ) {
+        Map<TraveloguePlace, List<TraveloguePhotoRequest>> places = new LinkedHashMap<>();
+
+        for (int i = 0; i < requests.size(); i++) {
+            TraveloguePlaceRequest request = requests.get(i);
+            Place place = getPlace(request);
+
+            TraveloguePlace traveloguePlace = request.toTraveloguePlace(i, place, day);
+            places.put(traveloguePlaceRepository.save(traveloguePlace), request.photos());
+        }
+
+        return places;
+    }
+
+    private Place getPlace(TraveloguePlaceRequest request) {
+        return placeRepository.findByNameAndLatitudeAndLongitude(
+                request.name(),
+                request.location().lat(),
+                request.location().lng()
+        ).orElseGet(() -> placeRepository.save(request.toPlace()));
+    }
+
     @Transactional(readOnly = true)
     public List<TraveloguePlace> findTraveloguePlaceByDay(TravelogueDay travelogueDay) {
         return traveloguePlaceRepository.findByTravelogueDay(travelogueDay);

backend/src/main/java/woowacourse/touroot/travelogue/dto/TravelogueDayRequest.java

@@ -0,0 +1,18 @@
+package woowacourse.touroot.travelogue.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+import woowacourse.touroot.travelogue.domain.Travelogue;
+import woowacourse.touroot.travelogue.domain.day.domain.TravelogueDay;
+
+public record TravelogueDayRequest(
+        @Schema(description = "여행기 장소 목록")
+        @NotNull(message = "여행기 장소 목록은 비어있을 수 없습니다.")
+        List<TraveloguePlaceRequest> places
+) {
+
+    public TravelogueDay toTravelogueDay(int order, Travelogue travelogue) {
+        return new TravelogueDay(order, travelogue);
+    }
+}

backend/src/main/java/woowacourse/touroot/travelogue/dto/TravelogueLocationRequest.java

@@ -0,0 +1,14 @@
+package woowacourse.touroot.travelogue.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+public record TravelogueLocationRequest(
+        @Schema(description = "여행기 장소 위도", example = "37.5175896")
+        @NotNull(message = "여행기 장소 위도는 비어있을 수 없습니다.")
+        String lat,
+        @Schema(description = "여행기 장소 경도", example = "127.0867236")
+        @NotNull(message = "여행기 장소 경도는 비어있을 수 없습니다.")
+        String lng
+) {
+}

backend/src/main/java/woowacourse/touroot/travelogue/dto/TraveloguePhotoRequest.java

@@ -0,0 +1,17 @@
+package woowacourse.touroot.travelogue.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import woowacourse.touroot.travelogue.domain.photo.domain.TraveloguePhoto;
+import woowacourse.touroot.travelogue.domain.place.domain.TraveloguePlace;
+
+public record TraveloguePhotoRequest(
+        @Schema(description = "여행기 장소 사진 Key", example = "photo.png")
+        @NotNull(message = "여행기 장소 사진 Key 값은 비어있을 수 없습니다.")
+        String key
+) {
+
+    public TraveloguePhoto toTraveloguePhoto(int order, TraveloguePlace traveloguePlace) {
+        return new TraveloguePhoto(order, key, traveloguePlace);
+    }
+}

backend/src/main/java/woowacourse/touroot/travelogue/dto/TraveloguePlaceRequest.java

@@ -0,0 +1,31 @@
+package woowacourse.touroot.travelogue.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+import woowacourse.touroot.place.domain.Place;
+import woowacourse.touroot.travelogue.domain.day.domain.TravelogueDay;
+import woowacourse.touroot.travelogue.domain.place.domain.TraveloguePlace;
+
+public record TraveloguePlaceRequest(
+        @Schema(description = "여행기 장소 이름", example = "선릉 캠퍼스")
+        @NotNull(message = "여행기 장소 이름은 비어있을 수 없습니다.")
+        String name,
+        @Schema(description = "여행기 장소 위치 정보")
+        @NotNull(message = "여행기 장소 위치 정보는 비어있을 수 없습니다.")
+        TravelogueLocationRequest location,
+        @Schema(description = "여행기 장소 설명", example = "성담 빌딩에 위치한 선릉 캠퍼스입니다.")
+        String description,
+        @Schema(description = "여행기 장소 사진")
+        @NotNull(message = "여행기 장소 사진은 비어있을 수 없습니다.")
+        List<TraveloguePhotoRequest> photos
+) {
+
+    public TraveloguePlace toTraveloguePlace(int order, Place place, TravelogueDay travelogueDay) {
+        return new TraveloguePlace(order, description, place, travelogueDay);
+    }
+
+    public Place toPlace() {
+        return new Place(name, location.lat(), location.lng());
+    }
+}

backend/src/main/java/woowacourse/touroot/travelogue/dto/TravelogueRequest.java

@@ -0,0 +1,23 @@
+package woowacourse.touroot.travelogue.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+import woowacourse.touroot.travelogue.domain.Travelogue;
+
+public record TravelogueRequest(
+        @Schema(description = "여행기 제목", example = "서울 강남 여행기")
+        @NotNull(message = "여행기 제목은 비어있을 수 없습니다.")
+        String title,
+        @Schema(description = "여행기 섬네일", example = "https://thumbnail.png")
+        @NotNull(message = "여행기 섬네일은 비어있을 수 없습니다.")
+        String thumbnail,
+        @Schema(description = "여행기 일자 목록")
+        @NotNull(message = "여행기 일자 목록은 비어있을 수 없습니다.")
+        List<TravelogueDayRequest> days
+) {
+
+    public Travelogue toTravelogue() {
+        return new Travelogue(title, thumbnail);
+    }
+}