feat: 예약 조기종료 기능 구현

backend/src/main/java/com/woowacourse/zzimkkong/controller/GuestReservationController.java

@@ -4,7 +4,20 @@
 import com.woowacourse.zzimkkong.domain.LoginEmail;
 import com.woowacourse.zzimkkong.domain.ReservationType;
 import com.woowacourse.zzimkkong.dto.member.LoginUserEmail;
-import com.woowacourse.zzimkkong.dto.reservation.*;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationAuthenticationDto;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationCreateDto;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationCreateResponse;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationCreateUpdateWithPasswordRequest;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationEarlyStopDto;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationEarlyStopRequest;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationFindAllDto;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationFindAllResponse;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationFindDto;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationFindResponse;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationInfiniteScrollResponse;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationPasswordAuthenticationRequest;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationResponse;
+import com.woowacourse.zzimkkong.dto.reservation.ReservationUpdateDto;
 import com.woowacourse.zzimkkong.dto.slack.SlackResponse;
 import com.woowacourse.zzimkkong.infrastructure.datetime.TimeZoneUtils;
 import com.woowacourse.zzimkkong.service.ReservationService;
@@ -14,7 +27,16 @@
 import org.springframework.data.web.PageableDefault;
 import org.springframework.format.annotation.DateTimeFormat;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
 
 import javax.validation.Valid;
 import java.net.URI;
@@ -23,7 +45,6 @@
 
 import static com.woowacourse.zzimkkong.dto.ValidatorMessage.DATETIME_FORMAT;
 import static com.woowacourse.zzimkkong.dto.ValidatorMessage.DATE_FORMAT;
-import static com.woowacourse.zzimkkong.infrastructure.datetime.TimeZoneUtils.UTC;
 
 @LogMethodExecutionTime(group = "controller")
 @RestController
@@ -153,6 +174,25 @@ public ResponseEntity<Void> update(
         return ResponseEntity.ok().build();
     }
 
+    @PatchMapping("/maps/{mapId}/spaces/{spaceId}/reservations/{reservationId}")
+    public ResponseEntity<Void> earlyStop(
+            @PathVariable final Long mapId,
+            @PathVariable final Long spaceId,
+            @PathVariable final Long reservationId,
+            @RequestBody @Valid final ReservationEarlyStopRequest reservationEarlyStopRequest,
+            @LoginEmail(isOptional = true) final LoginUserEmail loginUserEmail) {
+        ReservationEarlyStopDto reservationUpdateDto = ReservationEarlyStopDto.of(
+                mapId,
+                spaceId,
+                reservationId,
+                reservationEarlyStopRequest,
+                loginUserEmail,
+                ReservationType.Constants.GUEST);
+        SlackResponse slackResponse = reservationService.earlyStop(reservationUpdateDto);
+        slackService.sendEarlyStopMessage(slackResponse);
+        return ResponseEntity.ok().build();
+    }
+
     @DeleteMapping("/maps/{mapId}/spaces/{spaceId}/reservations/{reservationId}")
     public ResponseEntity<Void> delete(
             @PathVariable final Long mapId,

backend/src/main/java/com/woowacourse/zzimkkong/domain/Reservation.java

@@ -1,14 +1,28 @@
 package com.woowacourse.zzimkkong.domain;
 
+import com.woowacourse.zzimkkong.exception.reservation.InvalidMinimumDurationTimeInEarlyStopException;
+import com.woowacourse.zzimkkong.exception.reservation.NotCurrentReservationException;
+import com.woowacourse.zzimkkong.exception.setting.NoMatchingSettingException;
 import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import net.logstash.logback.encoder.org.apache.commons.lang3.StringUtils;
 
-import javax.persistence.*;
+import javax.persistence.Column;
+import javax.persistence.Embedded;
+import javax.persistence.Entity;
+import javax.persistence.FetchType;
+import javax.persistence.ForeignKey;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Index;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
 import java.time.DayOfWeek;
 import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.time.temporal.ChronoUnit;
 
 @Getter
 @Builder
@@ -82,6 +96,10 @@ public void update(final Reservation updateReservation) {
         this.space = updateReservation.space;
     }
 
+    public void updateReservationTime(final ReservationTime updateReservationTime) {
+        this.reservationTime = updateReservationTime;
+    }
+
     public LocalDateTime getStartTime() {
         return reservationTime.getStartTime();
     }
@@ -142,4 +160,36 @@ public String getUserName() {
         }
         return this.userName;
     }
+
+    public TimeUnit getReservationTimeUnit() {
+        Setting setting = space.getSpaceSettings().getSettings()
+                .stream()
+                .filter(it -> it.supports(getTimeSlot(), getDayOfWeek()))
+                .findFirst()
+                .orElseThrow(NoMatchingSettingException::new);
+
+        return setting.getReservationTimeUnit();
+    }
+
+    public void doEarlyClose(final LocalDateTime now, final Map map) {
+        validateEarlyCloseable(now);
+
+        int endTimeFloor = this.getReservationTimeUnit().floor(now);
+
+        this.reservationTime = ReservationTime.of(
+                reservationTime.getStartTime(),
+                now.withMinute(endTimeFloor),
+                map.getServiceZone(),
+                false);
+    }
+
+    private void validateEarlyCloseable(final LocalDateTime now) {
+        if (!this.isInUse(now)) {
+            throw new NotCurrentReservationException();
+        }
+
+        if (ChronoUnit.MINUTES.between(this.getStartTime(), now) < this.getReservationTimeUnit().getMinutes()) {
+            throw new InvalidMinimumDurationTimeInEarlyStopException();
+        }
+    }
 }

backend/src/main/java/com/woowacourse/zzimkkong/domain/TimeSlot.java

@@ -98,4 +98,3 @@ public String toString() {
         return startTime + " ~ " + endTimeAsString;
     }
 }
-

backend/src/main/java/com/woowacourse/zzimkkong/domain/TimeUnit.java

@@ -7,6 +7,7 @@
 
 import javax.persistence.Column;
 import javax.persistence.Embeddable;
+import java.time.LocalDateTime;
 import java.time.LocalTime;
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
@@ -62,6 +63,10 @@ public boolean isShorterThan(final TimeUnit that) {
         return this.minutes < that.minutes;
     }
 
+    public int floor(final LocalDateTime time) {
+        return time.getMinute() / this.minutes * this.minutes;
+    }
+
     @Override
     public String toString() {
         int hours = this.minutes / 60;

backend/src/main/java/com/woowacourse/zzimkkong/dto/reservation/ReservationEarlyStopDto.java

@@ -0,0 +1,73 @@
+package com.woowacourse.zzimkkong.dto.reservation;
+
+import com.woowacourse.zzimkkong.domain.ReservationType;
+import com.woowacourse.zzimkkong.dto.member.LoginUserEmail;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class ReservationEarlyStopDto {
+
+    private Long mapId;
+    private Long spaceId;
+    private Long reservationId;
+    private String email;
+    private String password;
+    private LoginUserEmail loginUserEmail;
+    private ReservationType reservationType;
+
+    private ReservationEarlyStopDto(
+            final Long mapId,
+            final Long spaceId,
+            final Long reservationId,
+            final ReservationEarlyStopRequest request,
+            final LoginUserEmail loginUserEmail,
+            final String apiType) {
+        this.reservationId = reservationId;
+        this.spaceId = spaceId;
+        this.mapId = mapId;
+        this.password = request.getPassword();
+        this.email = request.getEmail();
+        this.loginUserEmail = loginUserEmail;
+        this.reservationType = ReservationType.of(apiType, getReservationEmail(apiType));
+    }
+
+    public static ReservationEarlyStopDto of(
+            final Long mapId,
+            final Long spaceId,
+            final Long reservationId,
+            final ReservationEarlyStopRequest request,
+            final LoginUserEmail loginUserEmail,
+            final String apiType) {
+        return new ReservationEarlyStopDto(
+                mapId,
+                spaceId,
+                reservationId,
+                request,
+                loginUserEmail,
+                apiType);
+    }
+
+    public static ReservationEarlyStopDto of(
+            final Long mapId,
+            final Long spaceId,
+            final Long reservationId,
+            final ReservationEarlyStopRequest request,
+            final String apiType) {
+        return new ReservationEarlyStopDto(
+                mapId,
+                spaceId,
+                reservationId,
+                request,
+                new LoginUserEmail(),
+                apiType);
+    }
+
+    private LoginUserEmail getReservationEmail(String apiType) {
+        if (ReservationType.Constants.GUEST.equals(apiType)) {
+            return this.loginUserEmail;
+        }
+        return LoginUserEmail.from(this.email);
+    }
+}

backend/src/main/java/com/woowacourse/zzimkkong/dto/reservation/ReservationEarlyStopRequest.java

@@ -0,0 +1,37 @@
+package com.woowacourse.zzimkkong.dto.reservation;
+
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.Pattern;
+import javax.validation.constraints.Size;
+
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.DESCRIPTION_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.EMPTY_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.NAME_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.NAMING_FORMAT;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.RESERVATION_PW_FORMAT;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.RESERVATION_PW_MESSAGE;
+
+@Getter
+@NoArgsConstructor
+public class ReservationEarlyStopRequest {
+    @Pattern(regexp = RESERVATION_PW_FORMAT, message = RESERVATION_PW_MESSAGE)
+    private String password;
+
+    @Pattern(regexp = NAMING_FORMAT, message = NAME_MESSAGE)
+    protected String name;
+
+    @NotBlank(message = EMPTY_MESSAGE)
+    @Size(max = 100, message = DESCRIPTION_MESSAGE)
+    protected String description;
+
+    public String getPassword() {
+        return null;
+    }
+
+    public String getEmail() {
+        return null;
+    }
+}

backend/src/main/java/com/woowacourse/zzimkkong/dto/reservation/ReservationManagerEarlyStopRequest.java

@@ -0,0 +1,29 @@
+package com.woowacourse.zzimkkong.dto.reservation;
+
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.Pattern;
+import javax.validation.constraints.Size;
+
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.DESCRIPTION_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.EMPTY_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.NAME_MESSAGE;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.NAMING_FORMAT;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.RESERVATION_PW_FORMAT;
+import static com.woowacourse.zzimkkong.dto.ValidatorMessage.RESERVATION_PW_MESSAGE;
+
+@Getter
+@NoArgsConstructor
+public class ReservationManagerEarlyStopRequest {
+    @Pattern(regexp = RESERVATION_PW_FORMAT, message = RESERVATION_PW_MESSAGE)
+    private String password;
+
+    @Pattern(regexp = NAMING_FORMAT, message = NAME_MESSAGE)
+    protected String name;
+
+    @NotBlank(message = EMPTY_MESSAGE)
+    @Size(max = 100, message = DESCRIPTION_MESSAGE)
+    protected String description;
+}

backend/src/main/java/com/woowacourse/zzimkkong/dto/slack/Attachments.java

@@ -43,6 +43,18 @@ public static Attachments updateMessageOf(final SlackResponse slackResponse,
         return Attachments.from(attachment);
     }
 
+    public static Attachments earlyStopMessageOf(final SlackResponse slackResponse,
+                                                 final String titleLink) {
+        Attachment attachment = Attachment.of(
+                "🙏 예약 종료 알림 🙏",
+                COLOR,
+                "🙏 예약이 종료되었습니다.",
+                TITLE_LINK_MESSAGE,
+                titleLink + GUEST_URI + slackResponse.getSharingMapId(),
+                slackResponse);
+        return Attachments.from(attachment);
+    }
+
     public static Attachments deleteMessageOf(final SlackResponse slackResponse,
                                               final String titleLink) {
         Attachment attachment = Attachment.of(

backend/src/main/java/com/woowacourse/zzimkkong/exception/reservation/InvalidMinimumDurationTimeInEarlyStopException.java

@@ -0,0 +1,13 @@
+package com.woowacourse.zzimkkong.exception.reservation;
+
+import com.woowacourse.zzimkkong.exception.ZzimkkongException;
+import org.springframework.http.HttpStatus;
+
+public class InvalidMinimumDurationTimeInEarlyStopException extends ZzimkkongException {
+
+    private static final String MESSAGE = "조기 종료는 최소 5분 이후부터 가능합니다.";
+
+    public InvalidMinimumDurationTimeInEarlyStopException() {
+        super(MESSAGE, HttpStatus.BAD_REQUEST);
+    }
+}

backend/src/main/java/com/woowacourse/zzimkkong/exception/reservation/NotCurrentReservationException.java

@@ -0,0 +1,12 @@
+package com.woowacourse.zzimkkong.exception.reservation;
+
+import com.woowacourse.zzimkkong.exception.ZzimkkongException;
+import org.springframework.http.HttpStatus;
+
+public class NotCurrentReservationException extends ZzimkkongException {
+    private static final String MESSAGE = "사용중인 예약에 대해서만 조기종료가 가능합니다.";
+
+    public NotCurrentReservationException() {
+        super(MESSAGE, HttpStatus.BAD_REQUEST);
+    }
+}

backend/src/main/java/com/woowacourse/zzimkkong/exception/setting/NoMatchingSettingException.java

@@ -0,0 +1,12 @@
+package com.woowacourse.zzimkkong.exception.setting;
+
+import com.woowacourse.zzimkkong.exception.ZzimkkongException;
+import org.springframework.http.HttpStatus;
+
+public class NoMatchingSettingException extends ZzimkkongException {
+    private static final String MESSAGE = "일치하는 설정이 존재하지 않습니다.";
+
+    public NoMatchingSettingException() {
+        super(MESSAGE, HttpStatus.NOT_FOUND);
+    }
+}