feat: 카카오 챗봇 API 구현

src/main/java/in/koreatech/koin/domain/bus/dto/BusRemainTimeResponse.java

@@ -23,14 +23,14 @@ public record BusRemainTimeResponse(
 
     public static BusRemainTimeResponse of(BusType busType, List<? extends BusRemainTime> remainTimes, Clock clock) {
         return new BusRemainTimeResponse(
-            busType.name().toLowerCase(),
+            busType.getName(),
             InnerBusResponse.of(remainTimes, 0, clock),
             InnerBusResponse.of(remainTimes, 1, clock)
         );
     }
 
     @JsonNaming(SnakeCaseStrategy.class)
-    private record InnerBusResponse(
+    public record InnerBusResponse(
         @Schema(description = "버스 번호", example = "400", requiredMode = NOT_REQUIRED)
         Long busNumber,
 

src/main/java/in/koreatech/koin/domain/bus/exception/ApiTypeNotFoundException.java

@@ -5,24 +5,16 @@
 public class ApiTypeNotFoundException extends DataNotFoundException {
 
     public static final String DEFAULT_MESSAGE = "존재하지 않는 API 타입입니다.";
-    private final String detail;
 
     public ApiTypeNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public ApiTypeNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static ApiTypeNotFoundException withDetail(String detail) {
         return new ApiTypeNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return DEFAULT_MESSAGE;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusArrivalNodeNotFoundException.java

@@ -5,24 +5,16 @@
 public class BusArrivalNodeNotFoundException extends DataNotFoundException {
 
     private static final String DEFAULT_MESSAGE = "버스 경로 상에 해당 노드가 존재하지 않습니다.";
-    private final String detail;
 
     public BusArrivalNodeNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusArrivalNodeNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusArrivalNodeNotFoundException withDetail(String detail) {
         return new BusArrivalNodeNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusCacheNotFoundException.java

@@ -5,24 +5,16 @@
 public class BusCacheNotFoundException extends DataNotFoundException {
 
     private static final String DEFAULT_MESSAGE = "버스 캐시가 존재하지 않습니다.";
-    private final String detail;
 
     public BusCacheNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusCacheNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusCacheNotFoundException withDetail(String detail) {
         return new BusCacheNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusDirectionNotFoundException.java

@@ -1,15 +1,20 @@
 package in.koreatech.koin.domain.bus.exception;
 
-public class BusDirectionNotFoundException extends IllegalArgumentException {
+import in.koreatech.koin.global.exception.KoinIllegalArgumentException;
+
+public class BusDirectionNotFoundException extends KoinIllegalArgumentException {
 
     private static final String DEFAULT_MESSAGE = "정상적인 버스 방향이 아닙니다.";
 
     public BusDirectionNotFoundException(String message) {
         super(message);
     }
 
+    public BusDirectionNotFoundException(String message, String detail) {
+        super(message, detail);
+    }
+
     public static BusDirectionNotFoundException withDetail(String detail) {
-        String message = String.format("%s %s", DEFAULT_MESSAGE, detail);
-        return new BusDirectionNotFoundException(message);
+        return new BusDirectionNotFoundException(DEFAULT_MESSAGE, detail);
     }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusIllegalArrivalTime.java

@@ -1,15 +1,20 @@
 package in.koreatech.koin.domain.bus.exception;
 
-public class BusIllegalArrivalTime extends IllegalArgumentException {
+import in.koreatech.koin.global.exception.KoinIllegalArgumentException;
+
+public class BusIllegalArrivalTime extends KoinIllegalArgumentException {
 
     private static final String DEFAULT_MESSAGE = "버스 도착 시각이 잘못되었습니다.";
 
     public BusIllegalArrivalTime(String message) {
         super(message);
     }
 
+    public BusIllegalArrivalTime(String message, String detail) {
+        super(message, detail);
+    }
+
     public static BusIllegalArrivalTime withDetail(String detail) {
-        String message = String.format("%s %s", DEFAULT_MESSAGE, detail);
-        return new BusIllegalArrivalTime(message);
+        return new BusIllegalArrivalTime(DEFAULT_MESSAGE, detail);
     }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusIllegalStationException.java

@@ -1,15 +1,20 @@
 package in.koreatech.koin.domain.bus.exception;
 
-public class BusIllegalStationException extends IllegalArgumentException {
+import in.koreatech.koin.global.exception.KoinIllegalArgumentException;
+
+public class BusIllegalStationException extends KoinIllegalArgumentException {
 
     private static final String DEFAULT_MESSAGE = "버스 정류장이 잘못되었습니다.";
 
     public BusIllegalStationException(String message) {
         super(message);
     }
 
+    public BusIllegalStationException(String message, String detail) {
+        super(message, detail);
+    }
+
     public static BusIllegalStationException withDetail(String detail) {
-        String message = String.format("%s %s", DEFAULT_MESSAGE, detail);
-        return new BusIllegalStationException(message);
+        return new BusIllegalStationException(DEFAULT_MESSAGE, detail);
     }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusNotFoundException.java

@@ -5,24 +5,16 @@
 public class BusNotFoundException extends DataNotFoundException {
 
     private static final String DEFAULT_MESSAGE = "버스가 존재하지 않습니다.";
-    private final String detail;
 
     public BusNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusNotFoundException withDetail(String detail) {
         return new BusNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusOpenApiException.java

@@ -5,24 +5,16 @@
 public class BusOpenApiException extends ExternalServiceException {
 
     private static final String DEFAULT_MESSAGE = "버스 Open API 응답이 정상적이지 않습니다.";
-    private final String detail;
 
     public BusOpenApiException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusOpenApiException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusOpenApiException withDetail(String detail) {
         return new BusOpenApiException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusStationNotFoundException.java

@@ -5,24 +5,16 @@
 public class BusStationNotFoundException extends DataNotFoundException {
 
     private static final String DEFAULT_MESSAGE = "버스 정류장이 존재하지 않습니다.";
-    private final String detail;
 
     public BusStationNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusStationNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusStationNotFoundException withDetail(String detail) {
         return new BusStationNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusTypeNotFoundException.java

@@ -5,24 +5,16 @@
 public class BusTypeNotFoundException extends DataNotFoundException {
 
     private static final String DEFAULT_MESSAGE = "버스 타입이 존재하지 않습니다.";
-    private final String detail;
 
     public BusTypeNotFoundException(String message) {
         super(message);
-        this.detail = null;
     }
 
     public BusTypeNotFoundException(String message, String detail) {
-        super(message);
-        this.detail = detail;
+        super(message, detail);
     }
 
     public static BusTypeNotFoundException withDetail(String detail) {
         return new BusTypeNotFoundException(DEFAULT_MESSAGE, detail);
     }
-
-    @Override
-    public String getDetail() {
-        return detail;
-    }
 }

src/main/java/in/koreatech/koin/domain/bus/exception/BusTypeNotSupportException.java

@@ -1,14 +1,20 @@
 package in.koreatech.koin.domain.bus.exception;
 
-public class BusTypeNotSupportException extends IllegalArgumentException {
+import in.koreatech.koin.global.exception.KoinIllegalArgumentException;
+
+public class BusTypeNotSupportException extends KoinIllegalArgumentException {
+
     private static final String DEFAULT_MESSAGE = "해당 버스타입에는 지원하지 않는 기능입니다.";
 
     public BusTypeNotSupportException(String message) {
         super(message);
     }
 
+    public BusTypeNotSupportException(String message, String detail) {
+        super(message, detail);
+    }
+
     public static BusTypeNotSupportException withDetail(String detail) {
-        String message = String.format("%s %s", DEFAULT_MESSAGE, detail);
-        return new BusTypeNotSupportException(message);
+        return new BusTypeNotSupportException(DEFAULT_MESSAGE, detail);
     }
 }

src/main/java/in/koreatech/koin/domain/bus/model/enums/BusStation.java

@@ -10,9 +10,9 @@
 
 @Getter
 public enum BusStation {
-    KOREATECH(List.of("학교", "한기대"), BusStationNode.KOREATECH),
+    KOREATECH(List.of("학교", "한기대", "코리아텍"), BusStationNode.KOREATECH),
     STATION(List.of("천안역", "천안역(학화호두과자)"), BusStationNode.STATION),
-    TERMINAL(List.of("터미널", "터미널(신세계 앞 횡단보도)"), BusStationNode.TERMINAL),
+    TERMINAL(List.of("터미널", "터미널(신세계 앞 횡단보도)", "야우리"), BusStationNode.TERMINAL),
     ;
 
     private final List<String> displayNames;
@@ -26,7 +26,10 @@ public enum BusStation {
     @JsonCreator
     public static BusStation from(String busStationName) {
         return Arrays.stream(values())
-            .filter(busStation -> busStation.name().equalsIgnoreCase(busStationName))
+            .filter(
+                busStation -> busStation.name().equalsIgnoreCase(busStationName) ||
+                    busStation.displayNames.contains(busStationName)
+            )
             .findAny()
             .orElseThrow(() -> BusStationNotFoundException.withDetail("busStation: " + busStationName));
     }
@@ -41,4 +44,8 @@ public static BusDirection getDirection(BusStation depart, BusStation arrival) {
     public String getNodeId(BusDirection direction) {
         return node.getId(direction);
     }
+
+    public String getName() {
+        return this.name().toLowerCase();
+    }
 }

src/main/java/in/koreatech/koin/domain/bus/model/enums/BusType.java

@@ -9,17 +9,27 @@
 
 @Getter
 public enum BusType {
-    CITY,
-    EXPRESS,
-    SHUTTLE,
-    COMMUTING,
+    CITY("시내버스"),
+    EXPRESS("대성고속"),
+    SHUTTLE("셔틀버스"),
+    COMMUTING("통학버스"),
     ;
 
+    private final String label;
+
+    BusType(String label) {
+        this.label = label;
+    }
+
     @JsonCreator
     public static BusType from(String busTypeName) {
         return Arrays.stream(values())
             .filter(busType -> busType.name().equalsIgnoreCase(busTypeName))
             .findAny()
             .orElseThrow(() -> BusTypeNotFoundException.withDetail("busType: " + busTypeName));
     }
+
+    public String getName() {
+        return this.name().toLowerCase();
+    }
 }

src/main/java/in/koreatech/koin/domain/bus/model/express/ExpressBusStationNode.java

@@ -3,6 +3,7 @@
 import java.util.Arrays;
 
 import in.koreatech.koin.domain.bus.exception.BusStationNotFoundException;
+import in.koreatech.koin.domain.bus.model.enums.BusStation;
 import lombok.Getter;
 
 /**
@@ -11,20 +12,22 @@
  */
 @Getter
 public enum ExpressBusStationNode {
-    KOREATECH("NAI3125301"), // 코리아텍
-    TERMINAL("NAI3112001"), // 종합터미널
+    KOREATECH(BusStation.KOREATECH, "NAI3125301"), // 코리아텍
+    TERMINAL(BusStation.TERMINAL, "NAI3112001"), // 종합터미널
     ;
 
+    private final BusStation busStation;
     private final String stationId;
 
-    ExpressBusStationNode(String stationId) {
+    ExpressBusStationNode(BusStation busStation, String stationId) {
+        this.busStation = busStation;
         this.stationId = stationId;
     }
 
-    public static ExpressBusStationNode from(String stationName) {
-        return Arrays.stream(values()).
-            filter(it -> it.name().equalsIgnoreCase(stationName))
+    public static ExpressBusStationNode from(BusStation busStation) {
+        return Arrays.stream(values())
+            .filter(it -> it.busStation.equals(busStation))
             .findAny()
-            .orElseThrow(() -> BusStationNotFoundException.withDetail("stationName: " + stationName));
+            .orElseThrow(() -> BusStationNotFoundException.withDetail("busStation: " + busStation));
     }
 }