Refactor/#66 chatbot api

src/main/java/com/catchtable/chatbot/dto/create/ChatMessageRequest.java

@@ -9,6 +9,12 @@ public record ChatMessageRequest(
         @Schema(example = "모수 용산점 3월 22일 18시 3명 예약해줘")
         @NotBlank(message = "메시지는 필수입니다.")
         @Size(max = 500, message = "메시지는 500자 이하여야 합니다.")
-        String message
+        String message,
+
+        @Schema(description = "사용자 현재 위도 (선택)", example = "37.5665")
+        Double latitude,
+
+        @Schema(description = "사용자 현재 경도 (선택)", example = "126.9780")
+        Double longitude
 ) {
 }

src/main/java/com/catchtable/chatbot/dto/create/ChatMessageResponse.java

@@ -2,6 +2,7 @@
 
 public record ChatMessageResponse(
         Long messageId,
-        String reply
+        String reply,
+        PendingPaymentInfo pendingPayment
 ) {
 }

src/main/java/com/catchtable/chatbot/dto/create/PendingPaymentHolder.java

@@ -0,0 +1,17 @@
+package com.catchtable.chatbot.dto.create;
+
+public class PendingPaymentHolder {
+    private static final ThreadLocal<PendingPaymentInfo> holder = new ThreadLocal<>();
+
+    public static void set(PendingPaymentInfo info) {
+        holder.set(info);
+    }
+
+    public static PendingPaymentInfo get() {
+        return holder.get();
+    }
+
+    public static void clear() {
+        holder.remove();
+    }
+}

src/main/java/com/catchtable/chatbot/dto/create/PendingPaymentInfo.java

@@ -0,0 +1,8 @@
+package com.catchtable.chatbot.dto.create;
+
+public record PendingPaymentInfo(
+        Long reservationId,
+        String orderId,
+        int amount
+) {
+}

src/main/java/com/catchtable/chatbot/service/ChatbotDbService.java

@@ -81,20 +81,19 @@ public List<ChatMessage> getRecentHistory(Long sessionId, int limit) {
         return recent.reversed();
     }
 
-    // 대화 내역 조회 (API 응답용)
+    // 대화 내역 조회 (API 응답용) — 세션 없으면 빈 목록 반환
     @Transactional(readOnly = true)
     public List<ChatMessageListResponse> getMessages(Long userId) {
         User user = userRepository.getById(userId);
 
-        ChatSession session = chatSessionRepository.findByUserAndIsDeletedFalse(user)
-                .orElseThrow(() -> new CustomException(ErrorCode.CHAT_SESSION_NOT_FOUND));
-
-        return chatMessageRepository.findByChatSessionOrderByCreatedAtAsc(session).stream()
-                .map(message -> new ChatMessageListResponse(
-                        message.getId(),
-                        message.getRole(),
-                        message.getContent(),
-                        message.getCreatedAt()))
-                .toList();
+        return chatSessionRepository.findByUserAndIsDeletedFalse(user)
+                .map(session -> chatMessageRepository.findByChatSessionOrderByCreatedAtAsc(session).stream()
+                        .map(message -> new ChatMessageListResponse(
+                                message.getId(),
+                                message.getRole(),
+                                message.getContent(),
+                                message.getCreatedAt()))
+                        .toList())
+                .orElse(List.of());
     }
 }

src/main/java/com/catchtable/chatbot/service/ChatbotService.java

@@ -2,13 +2,17 @@
 
 import com.catchtable.chatbot.dto.create.ChatMessageRequest;
 import com.catchtable.chatbot.dto.create.ChatMessageResponse;
+import com.catchtable.chatbot.dto.create.PendingPaymentHolder;
+import com.catchtable.chatbot.dto.create.PendingPaymentInfo;
 import com.catchtable.chatbot.dto.read.ChatMessageListResponse;
 import com.catchtable.chatbot.entity.ChatMessage;
 import com.catchtable.chatbot.entity.MessageRole;
 import com.catchtable.coupon.service.CouponService;
 import com.catchtable.global.exception.CustomException;
 import com.catchtable.global.exception.ErrorCode;
+import com.catchtable.remain.service.StoreRemainService;
 import com.catchtable.reservation.service.ReservationService;
+import com.catchtable.store.service.StoreService;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.ai.chat.client.ChatClient;
@@ -28,46 +32,64 @@
 public class ChatbotService {
 
     private static final int MAX_HISTORY_SIZE = 20;
-
-    private String buildSystemPrompt() {
-            return "너는 'CatchEat(캐치잇)'이라는 레스토랑 예약 플랫폼의 AI 비서야. "
-                    + "오늘 날짜는 " + java.time.LocalDate.now() + "이야. "
-                    + "사용자가 '5월 12일'처럼 연도 없이 날짜를 말하면 오늘 날짜 기준으로 가장 가까운 미래 날짜로 해석해. "
-                    + "너의 역할은 사용자의 질문을 이해하고, 주어진 도구(함수)를 사용하여 레스토랑 예약 요청을 처리하는 것이야. "
-                    + "사용자가 예약을 요청하면, 'createReservationFromAi' 함수를 호출하기 전에 반드시 'getAvailableCouponsForAi' 함수를 먼저 호출해서 사용자에게 사용 가능한 쿠폰이 있는지 확인하고, 있다면 어떤 쿠폰을 사용할지 물어봐야 해."
-                    + "만약 사용 가능한 쿠폰이 없다면, 바로 'createReservationFromAi' 함수를 호출해서 예약을 진행해. "
-                    + "사용자가 쿠폰을 사용하겠다고 하면, 답변에서 쿠폰 ID(숫자)를 정확히 추출하여 'createReservationFromAi' 함수의 'couponId' 파라미터에 반드시 포함시켜서 호출해야 해. "
-                    + "함수를 호출하기 전에 '매장 이름', '날짜', '시간', '인원수' 4가지 정보가 모두 있는지 확인해. "
-                    + "정보가 부족하면 사용자에게 추가 정보를 요청해. "
-                    + "모든 답변은 한국어로, 친절하고 명확하게 제공해야 해.";
-    }
+    private static final int SUMMARY_KEEP_RECENT = 10;
 
     private final ChatClient chatClient;
     private final ChatbotDbService dbService;
     private final ReservationService reservationService;
     private final CouponService couponService;
+    private final StoreService storeService;
+    private final StoreRemainService storeRemainService;
 
     public ChatMessageResponse sendMessage(Long userId, ChatMessageRequest request) {
         Long sessionId = dbService.saveUserMessage(userId, request.message());
         List<ChatMessage> history = dbService.getRecentHistory(sessionId, MAX_HISTORY_SIZE);
 
-        String reply = callAi(history, userId);
+        String summarySuffix = buildSummarySuffix(history);
+        List<ChatMessage> trimmedHistory = trimHistory(history);
+
+        String reply = callAi(trimmedHistory, userId, request.latitude(), request.longitude(), summarySuffix);
+        PendingPaymentInfo paymentInfo = PendingPaymentHolder.get();
+        PendingPaymentHolder.clear();
 
         if (reply == null || reply.isBlank()) {
             throw new CustomException(ErrorCode.CHAT_AI_ERROR);
         }
 
         ChatMessage saved = dbService.saveAssistantMessage(sessionId, reply);
-        return new ChatMessageResponse(saved.getId(), reply);
+        return new ChatMessageResponse(saved.getId(), reply, paymentInfo);
     }
 
     public List<ChatMessageListResponse> getMessages(Long userId) {
         return dbService.getMessages(userId);
     }
 
-    private String callAi(List<ChatMessage> history, Long userId) {
+    // ============================================================
+    // 내부 유틸
+    // ============================================================
+
+    private String callAi(List<ChatMessage> history, Long userId, Double latitude, Double longitude, String summarySuffix) {
+        List<Message> messages = buildMessages(history, userId, summarySuffix);
+        try {
+            Map<String, Object> context = new java.util.HashMap<>();
+            context.put("userId", userId);
+            if (latitude != null) context.put("latitude", latitude);
+            if (longitude != null) context.put("longitude", longitude);
+            return chatClient.prompt()
+                    .messages(messages)
+                    .tools(reservationService, couponService, storeService, storeRemainService)
+                    .toolContext(context)
+                    .call()
+                    .content();
+        } catch (Exception e) {
+            handleAiException(e);
+            return null;
+        }
+    }
+
+    private List<Message> buildMessages(List<ChatMessage> history, Long userId, String summarySuffix) {
         List<Message> messages = new ArrayList<>();
-        messages.add(new SystemMessage(buildSystemPrompt()));
+        messages.add(new SystemMessage(buildSystemPrompt(summarySuffix)));
 
         for (ChatMessage msg : history) {
             if (msg.getRole() == MessageRole.USER) {
@@ -76,24 +98,75 @@ private String callAi(List<ChatMessage> history, Long userId) {
                 messages.add(new AssistantMessage(msg.getContent()));
             }
         }
+        return messages;
+    }
+
+    private String buildSystemPrompt(String summarySuffix) {
+        return "너는 'CatchEat(캐치잇)'이라는 레스토랑 예약 플랫폼의 AI 비서야. "
+                + "오늘 날짜는 " + java.time.LocalDate.now() + "이야. "
+                + "사용자가 '5월 12일'처럼 연도 없이 날짜를 말하면 오늘 날짜 기준으로 가장 가까운 미래 날짜로 해석해. "
+                + "너의 역할은 사용자의 질문을 이해하고, 주어진 도구(함수)를 사용하여 레스토랑 예약 요청을 처리하는 것이야. "
+
+                // 매장명 확인 로직
+                + "사용자가 매장 이름을 말하면, 예약 전에 반드시 'searchStoresByName' 함수로 해당 매장이 존재하는지 확인해. "
+                + "검색 결과가 없거나 사용자가 말한 이름과 다른 경우, 사용자에게 올바른 매장명을 다시 확인해줘. "
+                + "매장명이 확인된 경우에만 'createReservationFromAi'를 호출해. "
+
+                // 쿠폰 확인 로직
+                + "사용자가 예약을 요청하면, 'createReservationFromAi' 호출 전에 반드시 'getAvailableCouponsForAi' 함수를 먼저 호출해서 "
+                + "사용 가능한 쿠폰이 있는지 확인하고, 있다면 어떤 쿠폰을 사용할지 물어봐야 해. "
+                + "만약 사용 가능한 쿠폰이 없다면, 바로 'createReservationFromAi' 함수를 호출해서 예약을 진행해. "
+                + "사용자가 쿠폰을 사용하겠다고 하면, 쿠폰 ID(숫자)를 추출하여 'createReservationFromAi'의 'couponId' 파라미터에 포함시켜. "
+
+                // 예약 전 필수 정보 확인
+                + "함수를 호출하기 전에 '매장 이름', '날짜', '시간', '인원수' 4가지 정보가 모두 있는지 확인해. "
+                + "정보가 부족하면 사용자에게 추가 정보를 요청해. "
+
+                // 예약 조회/취소
+                + "사용자가 '내 예약 보여줘' 또는 '예약 취소해줘'라고 하면 'getMyReservationsForAi' 또는 'cancelReservationFromAi'를 사용해. "
+                + "사용자가 '취소된 예약', '노쇼 내역', '취소 내역' 등을 요청하면 'getCanceledReservationsForAi'를 사용해. "
+                + "사용자가 '내 주변 맛집', '근처 맛집', '주변 인기 매장' 등을 요청하면 'getNearbyPopularStoresForAi'를 사용해. "
+                + "사용자가 특정 매장의 예약 가능한 시간을 물어보면 'getAvailableTimeSlotsForAi'를 사용해. "
+                + "매장 목록 응답 시 각 매장 이름은 반드시 [매장이름](/stores/{storeId}) 형식의 링크로 작성해. "
+
+                // 결제 안내 금지
+                + "예약 완료 후 응답에 결제 안내 섹션, 결제 버튼, 마크다운 표 등을 절대 작성하지 마. "
+                + "결제 버튼은 UI에서 자동으로 표시되므로, 예약 완료 메시지만 간결하게 전달해. "
+                + "예시: '경복궁 레스토랑 5월 20일 오전 10시 2명 예약이 완료되었습니다. 보증금 10,000원 결제 후 최종 확정됩니다.' "
+
+                + "모든 답변은 한국어로, 친절하고 명확하게 제공해야 해."
+                + summarySuffix;
+    }
+
+    /** 히스토리가 임계치를 넘으면 오래된 부분을 요약 문자열로 반환 */
+    private String buildSummarySuffix(List<ChatMessage> history) {
+        if (history.size() <= MAX_HISTORY_SIZE) {
+            return "";
+        }
+        List<ChatMessage> older = history.subList(0, history.size() - SUMMARY_KEEP_RECENT);
+        String historyText = older.stream()
+                .map(m -> (m.getRole() == MessageRole.USER ? "사용자" : "AI") + ": " + m.getContent())
+                .reduce("", (a, b) -> a + "\n" + b);
 
         try {
-            return chatClient.prompt()
-                    .messages(messages)
-                    .tools(reservationService, couponService)
-                    .toolContext(Map.of("userId", userId))
+            String summary = chatClient.prompt()
+                    .user("다음 대화를 핵심 정보(예약 정보, 사용자 선호 등)만 3문장 이내로 요약해줘:\n" + historyText)
                     .call()
                     .content();
-
+            return "\n\n[이전 대화 요약]: " + summary;
         } catch (Exception e) {
-            handleAiException(e);
-            return null;
+            log.warn("대화 요약 실패, 요약 없이 진행", e);
+            return "";
         }
     }
 
+    private List<ChatMessage> trimHistory(List<ChatMessage> history) {
+        if (history.size() <= MAX_HISTORY_SIZE) return history;
+        return history.subList(history.size() - SUMMARY_KEEP_RECENT, history.size());
+    }
+
     private void handleAiException(Exception e) {
         log.error("AI API 호출 중 예외 발생", e);
-
         String message = getFullErrorMessage(e).toLowerCase();
         if (message.contains("api key") || message.contains("auth") || message.contains("401")) {
             throw new CustomException(ErrorCode.CHAT_AI_AUTH_ERROR);
@@ -111,9 +184,7 @@ private String getFullErrorMessage(Exception e) {
         StringBuilder sb = new StringBuilder();
         Throwable current = e;
         while (current != null) {
-            if (current.getMessage() != null) {
-                sb.append(current.getMessage()).append(" ");
-            }
+            if (current.getMessage() != null) sb.append(current.getMessage()).append(" ");
             current = current.getCause();
         }
         return sb.toString();

src/main/java/com/catchtable/coupon/controller/CouponController.java

@@ -11,6 +11,7 @@
 import com.catchtable.global.security.CustomUserDetails;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.http.CacheControl;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
@@ -47,8 +48,9 @@ public ResponseEntity<ApiResponse<CouponIssueResponse>> issueCoupon(
     @GetMapping("/templates/active")
     public ResponseEntity<ApiResponse<List<CouponTemplateActiveResponse>>> getActiveTemplates() {
         List<CouponTemplateActiveResponse> response = couponService.getActiveTemplates();
-        return ResponseEntity
-                .ok(ApiResponse.success(SuccessCode.COUPON_LIST_OK, response));
+        return ResponseEntity.ok()
+                .cacheControl(CacheControl.noStore())
+                .body(ApiResponse.success(SuccessCode.COUPON_LIST_OK, response));
     }
 
     @GetMapping("/me")

src/main/java/com/catchtable/remain/service/StoreRemainService.java

@@ -10,6 +10,9 @@
 import com.catchtable.store.repository.StoreRepository;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.ai.chat.model.ToolContext;
+import org.springframework.ai.tool.annotation.Tool;
+import org.springframework.ai.tool.annotation.ToolParam;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -76,6 +79,37 @@ public void generateMonthlyRemain(StoreRemainCreateRequestDto request) {
         storeRemainRepository.saveAll(remainsToSave);
     }
 
+    @Tool(description = "특정 매장의 특정 날짜에 예약 가능한 시간대를 조회합니다. '로코페페 5월 20일 예약 가능한 시간', '○○ 매장 언제 예약돼' 등의 요청에 사용하세요.")
+    @Transactional(readOnly = true)
+    public String getAvailableTimeSlotsForAi(
+            @ToolParam(description = "매장 이름 (정확한 이름)") String storeName,
+            @ToolParam(description = "조회할 날짜, ISO 형식 (예: 2025-05-20)") LocalDate date
+    ) {
+        Store store = storeRepository.findAllByIsDeletedFalse().stream()
+                .filter(s -> s.getStoreName().equalsIgnoreCase(storeName))
+                .findFirst()
+                .orElse(null);
+
+        if (store == null) {
+            return "'" + storeName + "' 매장을 찾을 수 없습니다. 매장 이름을 다시 확인해주세요.";
+        }
+
+        List<StoreRemain> remains = storeRemainRepository.findAllByStoreIdAndDate(store.getId(), date)
+                .stream()
+                .filter(r -> r.getRemainTeam() > 0)
+                .toList();
+
+        if (remains.isEmpty()) {
+            return date + "에 " + storeName + " 예약 가능한 시간대가 없습니다.";
+        }
+
+        String times = remains.stream()
+                .map(r -> r.getRemainTime().format(DateTimeFormatter.ofPattern("HH:mm")))
+                .collect(java.util.stream.Collectors.joining(", "));
+
+        return date + " " + storeName + " 예약 가능한 시간: " + times;
+    }
+
     @Transactional(readOnly = true)
     public List<StoreRemainResponseDto> getStoreRemains(Long storeId, LocalDate date) {
 

src/main/java/com/catchtable/reservation/dto/read/ReservationListResponseDto.java

@@ -15,6 +15,7 @@ public record ReservationListResponseDto(
         LocalDate remainDate,
         LocalTime remainTime,
         Integer member,
-        LocalDateTime createdAt
+        LocalDateTime createdAt,
+        String orderId
 ) {
 }