[Feat] 계약서 0,1,2 단계

src/main/java/org/scoula/domain/chat/service/ChatServiceImpl.java

@@ -446,11 +446,12 @@ public boolean existsChatRoom(Long ownerId, Long buyerId, Long propertyId) {
           return existing != null;
       }
 
-    @Override
-    public Long findExistingChatRoom(Long ownerId, Long buyerId, Long propertyId) {
-        ChatRoom existingRoom = chatRoomMapper.findByUserAndHome(ownerId, buyerId, propertyId);
-        return existingRoom.getChatRoomId();
-    }
+      @Override
+      public Long findExistingChatRoom(Long ownerId, Long buyerId, Long propertyId) {
+          ChatRoom existingRoom = chatRoomMapper.findByUserAndHome(ownerId, buyerId, propertyId);
+          return existingRoom.getChatRoomId();
+      }
+
       /** {@inheritDoc} */
       @Override
       public List<Map<String, Object>> getChatMediaFiles(

src/main/java/org/scoula/domain/chat/service/ChatServiceInterface.java

@@ -196,6 +196,6 @@ List<Map<String, Object>> getChatMediaFiles(
        * @param userId 거절하는 사용자 ID (소유자여야 함)
        */
       void rejectContractRequest(Long chatRoomId, Long userId);
-      Long findExistingChatRoom(Long ownerId, Long buyerId, Long propertyId);
 
+      Long findExistingChatRoom(Long ownerId, Long buyerId, Long propertyId);
 }

src/main/java/org/scoula/domain/chat/service/ContractChatServiceImpl.java

@@ -133,22 +133,23 @@ public void AiMessage(Long contractChatId, String content) {
           contractChatMapper.updateLastMessage(contractChatId, content);
           messagingTemplate.convertAndSend("/topic/contract-chat/" + contractChatId, aiMessage);
       }
-    public void AiMessageNext(Long contractChatId, String content) {
-        final Long ai = 9997L;
-
-        ContractChatDocument aiMessage =
-                ContractChatDocument.builder()
-                        .contractChatId(contractChatId.toString())
-                        .senderId(ai)
-                        .receiverId(null)
-                        .content(content)
-                        .sendTime(LocalDateTime.now().toString())
-                        .build();
-
-        contractChatMessageRepository.saveMessage(aiMessage);
-        contractChatMapper.updateLastMessage(contractChatId, content);
-        messagingTemplate.convertAndSend("/topic/contract-chat/" + contractChatId, aiMessage);
-    }
+
+      public void AiMessageNext(Long contractChatId, String content) {
+          final Long ai = 9997L;
+
+          ContractChatDocument aiMessage =
+                  ContractChatDocument.builder()
+                          .contractChatId(contractChatId.toString())
+                          .senderId(ai)
+                          .receiverId(null)
+                          .content(content)
+                          .sendTime(LocalDateTime.now().toString())
+                          .build();
+
+          contractChatMessageRepository.saveMessage(aiMessage);
+          contractChatMapper.updateLastMessage(contractChatId, content);
+          messagingTemplate.convertAndSend("/topic/contract-chat/" + contractChatId, aiMessage);
+      }
 
       public void AiMessageBtn(Long contractChatId, String content) {
           final Long ai = 9998L;
@@ -280,14 +281,11 @@ public boolean setEndPointAndExport(Long contractChatId, Long userId, Long order
 
           String result = sb.toString();
 
+          SpecialContractFixDocument improveClauseRequest =
+                  updateRecentData(contractChatId, order, result);
+          ClauseImproveResponseDto improveClauseResponse = getAiClauseImprove(improveClauseRequest);
 
-
-              SpecialContractFixDocument improveClauseRequest =
-                      updateRecentData(contractChatId, order, result);
-              ClauseImproveResponseDto improveClauseResponse =
-                      getAiClauseImprove(improveClauseRequest);
-
-              updateSpecialClause(contractChatId, improveClauseResponse);
+          updateSpecialClause(contractChatId, improveClauseResponse);
 
           checkAndIncrementRoundIfComplete(contractChatId);
           return true;
@@ -632,7 +630,6 @@ public void createNextRoundSpecialContractDocument(
                           .orElseThrow(
                                   () -> new IllegalArgumentException("현재 라운드의 특약 문서를 찾을 수 없습니다"));
 
-
           Long newRound = currentRound + 1;
           log.info("새 라운드: {} → {}", currentRound, newRound);
 
@@ -1581,107 +1578,113 @@ private List<Long> findRejectedOrders(
           return rejectedOrders;
       }
 
+      @Override
+      @Transactional
+      public FinalSpecialContractDocument saveFinalSpecialContract(Long contractChatId) {
+          ContractChat contractChat = contractChatMapper.findByContractChatId(contractChatId);
+          ContractChat.ContractStatus currentStatus = contractChat.getStatus();
+
+          boolean isThirdRoundComplete = (currentStatus == ContractChat.ContractStatus.ROUND3);
+
+          List<FinalSpecialContractDocument.FinalClause> finalClauses = new ArrayList<>();
+
+          if (isThirdRoundComplete) {
+              log.info("=== 3회차 수정 완료 - 4라운드 데이터에서 최종 특약 생성 ===");
+
+              Optional<SpecialContractDocument> round4DocOpt =
+                      specialContractMongoRepository
+                              .findSpecialContractDocumentByContractChatIdAndRound(
+                                      contractChatId, 4L);
+
+              if (round4DocOpt.isPresent()) {
+                  SpecialContractDocument round4Doc = round4DocOpt.get();
+
+                  for (SpecialContractDocument.Clause clause : round4Doc.getClauses()) {
+                      if (clause.getTitle() != null
+                              && !clause.getTitle().trim().isEmpty()
+                              && clause.getContent() != null
+                              && !clause.getContent().trim().isEmpty()) {
+
+                          FinalSpecialContractDocument.FinalClause finalClause =
+                                  FinalSpecialContractDocument.FinalClause.builder()
+                                          .order(clause.getOrder())
+                                          .title(clause.getTitle())
+                                          .content(clause.getContent())
+                                          .build();
+
+                          finalClauses.add(finalClause);
+                          log.info("4라운드에서 특약 {}번 최종 저장: {}", clause.getOrder(), clause.getTitle());
+                      }
+                  }
+              }
+          } else {
+              log.info("=== 모든 특약 완료 - 완료된 특약들만 최종 저장 ===");
+
+              List<SpecialContractFixDocument> incompleteContracts =
+                      specialContractMongoRepository.findByContractChatIdAndIsPassed(
+                              contractChatId, false);
+
+              if (!incompleteContracts.isEmpty()) {
+                  throw new IllegalStateException(
+                          "아직 완료되지 않은 특약이 " + incompleteContracts.size() + "개 있습니다.");
+              }
+
+              List<SpecialContractFixDocument> completedContracts =
+                      specialContractMongoRepository.findByContractChatIdAndIsPassed(
+                              contractChatId, true);
+
+              if (completedContracts.isEmpty()) {
+                  throw new IllegalStateException("완료된 특약이 없습니다.");
+              }
 
-    @Override
-    @Transactional
-    public FinalSpecialContractDocument saveFinalSpecialContract(Long contractChatId) {
-        ContractChat contractChat = contractChatMapper.findByContractChatId(contractChatId);
-        ContractChat.ContractStatus currentStatus = contractChat.getStatus();
-
-        boolean isThirdRoundComplete = (currentStatus == ContractChat.ContractStatus.ROUND3);
-
-        List<FinalSpecialContractDocument.FinalClause> finalClauses = new ArrayList<>();
-
-        if (isThirdRoundComplete) {
-            log.info("=== 3회차 수정 완료 - 4라운드 데이터에서 최종 특약 생성 ===");
-
-            Optional<SpecialContractDocument> round4DocOpt =
-                    specialContractMongoRepository.findSpecialContractDocumentByContractChatIdAndRound(contractChatId, 4L);
-
-            if (round4DocOpt.isPresent()) {
-                SpecialContractDocument round4Doc = round4DocOpt.get();
-
-                for (SpecialContractDocument.Clause clause : round4Doc.getClauses()) {
-                    if (clause.getTitle() != null && !clause.getTitle().trim().isEmpty() &&
-                            clause.getContent() != null && !clause.getContent().trim().isEmpty()) {
-
-                        FinalSpecialContractDocument.FinalClause finalClause =
-                                FinalSpecialContractDocument.FinalClause.builder()
-                                        .order(clause.getOrder())
-                                        .title(clause.getTitle())
-                                        .content(clause.getContent())
-                                        .build();
-
-                        finalClauses.add(finalClause);
-                        log.info("4라운드에서 특약 {}번 최종 저장: {}", clause.getOrder(), clause.getTitle());
-                    }
-                }
-            }
-        } else {
-            log.info("=== 모든 특약 완료 - 완료된 특약들만 최종 저장 ===");
-
-            List<SpecialContractFixDocument> incompleteContracts =
-                    specialContractMongoRepository.findByContractChatIdAndIsPassed(contractChatId, false);
-
-            if (!incompleteContracts.isEmpty()) {
-                throw new IllegalStateException(
-                        "아직 완료되지 않은 특약이 " + incompleteContracts.size() + "개 있습니다.");
-            }
-
-            List<SpecialContractFixDocument> completedContracts =
-                    specialContractMongoRepository.findByContractChatIdAndIsPassed(contractChatId, true);
-
-            if (completedContracts.isEmpty()) {
-                throw new IllegalStateException("완료된 특약이 없습니다.");
-            }
-
-            for (SpecialContractFixDocument completedContract : completedContracts) {
-                Long order = completedContract.getOrder();
-
-                Optional<SpecialContractDocument> latestRoundDoc =
-                        findLatestRoundForOrder(contractChatId, order);
-
-                if (latestRoundDoc.isPresent()) {
-                    SpecialContractDocument doc = latestRoundDoc.get();
-
-                    doc.getClauses().stream()
-                            .filter(clause -> clause.getOrder().equals(order.intValue()))
-                            .findFirst()
-                            .ifPresent(
-                                    clause -> {
-                                        FinalSpecialContractDocument.FinalClause finalClause =
-                                                FinalSpecialContractDocument.FinalClause.builder()
-                                                        .order(clause.getOrder())
-                                                        .title(clause.getTitle())
-                                                        .content(clause.getContent())
-                                                        .build();
-
-                                        finalClauses.add(finalClause);
-                                        log.info(
-                                                "특약 {}번 최종 저장 완료 - sourceRound: {}",
-                                                order,
-                                                doc.getRound());
-                                    });
-                }
-            }
-        }
-
-        FinalSpecialContractDocument finalDocument =
-                FinalSpecialContractDocument.builder()
-                        .contractChatId(contractChatId)
-                        .totalFinalClauses(finalClauses.size())
-                        .finalClauses(finalClauses)
-                        .build();
-
-        FinalSpecialContractDocument savedDocument =
-                specialContractMongoRepository.saveFinalSpecialContract(finalDocument);
-
-        log.info("최종 특약 저장 완료 - 총 {}개 조항 (방식: {})",
-                finalClauses.size(),
-                isThirdRoundComplete ? "3회차 완료" : "모든 특약 완료");
-
-        return savedDocument;
-    }
+              for (SpecialContractFixDocument completedContract : completedContracts) {
+                  Long order = completedContract.getOrder();
+
+                  Optional<SpecialContractDocument> latestRoundDoc =
+                          findLatestRoundForOrder(contractChatId, order);
+
+                  if (latestRoundDoc.isPresent()) {
+                      SpecialContractDocument doc = latestRoundDoc.get();
+
+                      doc.getClauses().stream()
+                              .filter(clause -> clause.getOrder().equals(order.intValue()))
+                              .findFirst()
+                              .ifPresent(
+                                      clause -> {
+                                          FinalSpecialContractDocument.FinalClause finalClause =
+                                                  FinalSpecialContractDocument.FinalClause.builder()
+                                                          .order(clause.getOrder())
+                                                          .title(clause.getTitle())
+                                                          .content(clause.getContent())
+                                                          .build();
+
+                                          finalClauses.add(finalClause);
+                                          log.info(
+                                                  "특약 {}번 최종 저장 완료 - sourceRound: {}",
+                                                  order,
+                                                  doc.getRound());
+                                      });
+                  }
+              }
+          }
+
+          FinalSpecialContractDocument finalDocument =
+                  FinalSpecialContractDocument.builder()
+                          .contractChatId(contractChatId)
+                          .totalFinalClauses(finalClauses.size())
+                          .finalClauses(finalClauses)
+                          .build();
+
+          FinalSpecialContractDocument savedDocument =
+                  specialContractMongoRepository.saveFinalSpecialContract(finalDocument);
+
+          log.info(
+                  "최종 특약 저장 완료 - 총 {}개 조항 (방식: {})",
+                  finalClauses.size(),
+                  isThirdRoundComplete ? "3회차 완료" : "모든 특약 완료");
+
+          return savedDocument;
+      }
 
       private Optional<SpecialContractDocument> findLatestRoundForOrder(
               Long contractChatId, Long order) {

src/main/java/org/scoula/domain/contract/controller/ContractController.java

@@ -0,0 +1,88 @@
+package org.scoula.domain.contract.controller;
+
+import org.scoula.domain.contract.dto.*;
+import org.scoula.global.auth.dto.CustomUserDetails;
+import org.scoula.global.common.dto.ApiResponse;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
+
+@Api(tags = "계약서 API", description = "계약서 : 정보확인 / 금액 조율 / 적법성 확인")
+public interface ContractController {
+
+      // step 0
+      @ApiOperation(value = "임차인 대기 메세지", notes = "step0의 AI 메세지")
+      ResponseEntity<ApiResponse<Void>> standByContract(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      // step 1 (init)
+      @ApiOperation(value = "계약서 몽고DB에 저장", notes = "계약서에 필요한 항목들을 가져와서 몽고 DB에 계약서 만들기")
+      ResponseEntity<ApiResponse<Void>> saveContractMongo(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      // step 1 : start
+      @ApiOperation(value = "계약서 전체 조회", notes = "계약서 가져오기")
+      ResponseEntity<ApiResponse<ContractDTO>> getContract(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "정보조회 다음 단계로 넘어가기 Message", notes = "정보조회 마지막 단계에서 다음 단계로 넘어가기 Message")
+      ResponseEntity<ApiResponse<Void>> getContractNext(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      // step 1 : finish
+      @ApiOperation(value = "다음 단계로 넘어가기", notes = "다음 단계 여부(true/false)를 받아서 다음 단계로 넘어가기")
+      ResponseEntity<ApiResponse<Boolean>> nextStep(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails,
+              @RequestBody NextStepDTO dto);
+
+      @ApiOperation(value = "금액 조회", notes = "금액을 조율하기 위해 금액을 조회")
+      ResponseEntity<ApiResponse<PaymentDTO>> getDepositPrice(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "금액 요청", notes = "임대인이 금액을 요청")
+      ResponseEntity<ApiResponse<Void>> saveDepositPrice(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails,
+              @RequestBody PaymentDTO dto);
+
+      @ApiOperation(value = "금액 거절 ", notes = "임차인이 금액을 거절")
+      ResponseEntity<ApiResponse<Void>> deleteDepositPrice(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "금액 수락", notes = "임대인과 임차인 모두 동의")
+      ResponseEntity<ApiResponse<Void>> updateDepositPrice(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "AI 적법성 확인 from 몽고DB", notes = "몽고DB에 있는 계약서를 AI로 보내고, 적법성 받기")
+      ResponseEntity<ApiResponse<LegalityDTO>> getLegality(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "특약을 계약서 DB에 저장 FROM 몽고DB", notes = "특약 테이블에 있는걸 계약서로 가져오기")
+      ResponseEntity<ApiResponse<Void>> saveSpecialContract(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+
+      @ApiOperation(value = "바뀐 특약 수정 from 몽고DB", notes = "적법성 검사 후 수정된 특약으로 변경")
+      ResponseEntity<ApiResponse<Void>> updateSpecialContract(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails,
+              @RequestBody SpecialContractUpdateDTO dto);
+
+      @ApiOperation(value = "적법성 검사 후 다음단계로 넘어가기", notes = "적법성 검사 후 AI 메세지를 보낸다")
+      ResponseEntity<ApiResponse<Void>> sendStep4(
+              @PathVariable Long contractChatId,
+              @AuthenticationPrincipal CustomUserDetails userDetails);
+}