Fix/ref detail mapping

build.gradle

@@ -138,3 +138,7 @@ tasks.withType(JavaCompile).configureEach {
 tasks.named('test') {
 	useJUnitPlatform()
 }
+
+tasks.withType(JavaCompile).configureEach {
+	options.compilerArgs += ['-Xlint:deprecation', '-Xlint:unchecked']
+}

src/main/java/com/teamEWSN/gitdeun/codereference/controller/CodeReferenceController.java

@@ -1,7 +1,7 @@
 package com.teamEWSN.gitdeun.codereference.controller;
 
 import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceResponseDtos.*;
-import com.teamEWSN.gitdeun.codereference.dto.*;
+import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceRequestDtos.*;
 import com.teamEWSN.gitdeun.codereference.service.CodeReferenceService;
 import com.teamEWSN.gitdeun.common.jwt.CustomUserDetails;
 import jakarta.validation.Valid;
@@ -21,39 +21,40 @@ public class CodeReferenceController {
     private final CodeReferenceService codeReferenceService;
 
     // 특정 노드에 코드 참조 생성
-    @PostMapping("/nodes/{nodeId}/code-references")
+    @PostMapping("/nodes/{nodeKey}/code-references")
     public ResponseEntity<ReferenceResponse> createCodeReference(
         @PathVariable Long mapId,
-        @PathVariable String nodeId,
-        @Valid @RequestBody CodeReferenceRequestDtos.CreateRequest request,
+        @PathVariable String nodeKey,
+        @Valid @RequestBody CreateRequest request,
         @AuthenticationPrincipal CustomUserDetails userDetails) {
-        return ResponseEntity.status(HttpStatus.CREATED).body(codeReferenceService.createReference(mapId, nodeId, userDetails.getId(), request));
+        return ResponseEntity.status(HttpStatus.CREATED).body(codeReferenceService.createReference(mapId, nodeKey, userDetails.getId(), request));
     }
 
     // 특정 코드 참조 상세 조회
-    @GetMapping("/code-references/{refId}")
-    public ResponseEntity<ReferenceResponse> getCodeReference(
+    @GetMapping("/code-references/{refId}/detail")
+    public ResponseEntity<ReferenceDetailResponse> getCodeReferenceDetail(
         @PathVariable Long mapId,
         @PathVariable Long refId,
-        @AuthenticationPrincipal CustomUserDetails userDetails) {
-        return ResponseEntity.ok(codeReferenceService.getReference(mapId, refId, userDetails.getId()));
+        @AuthenticationPrincipal CustomUserDetails userDetails,
+        @RequestHeader("Authorization") String authorizationHeader) {
+        return ResponseEntity.ok(codeReferenceService.getReferenceDetail(mapId, refId, userDetails.getId(), authorizationHeader));
     }
 
     // 특정 노드에 연결된 모든 코드 참조 목록 조회
-    @GetMapping("/nodes/{nodeId}/code-references")
+    @GetMapping("/nodes/{nodeKey}/code-references")
     public ResponseEntity<List<ReferenceResponse>> getNodeCodeReferences(
         @PathVariable Long mapId,
-        @PathVariable String nodeId,
+        @PathVariable String nodeKey,
         @AuthenticationPrincipal CustomUserDetails userDetails) {
-        return ResponseEntity.ok(codeReferenceService.getReferencesForNode(mapId, nodeId, userDetails.getId()));
+        return ResponseEntity.ok(codeReferenceService.getReferencesForNode(mapId, nodeKey, userDetails.getId()));
     }
 
     // 코드 참조 정보 수정
     @PatchMapping("/code-references/{refId}")
     public ResponseEntity<ReferenceResponse> updateCodeReference(
         @PathVariable Long mapId,
         @PathVariable Long refId,
-        @Valid @RequestBody CodeReferenceRequestDtos.CreateRequest request,
+        @Valid @RequestBody CreateRequest request,
         @AuthenticationPrincipal CustomUserDetails userDetails) {
         return ResponseEntity.ok(codeReferenceService.updateReference(mapId, refId, userDetails.getId(), request));
     }

src/main/java/com/teamEWSN/gitdeun/codereference/dto/CodeReferenceResponseDtos.java

@@ -10,10 +10,20 @@ public class CodeReferenceResponseDtos {
     @AllArgsConstructor(access = AccessLevel.PROTECTED)
     public static class ReferenceResponse {
         private Long referenceId;
-        private String nodeId;
+        private String nodeKey;
         private String filePath;
         private Integer startLine;
         private Integer endLine;
     }
 
+    @Getter
+    @Builder
+    public static class ReferenceDetailResponse {
+        private Long referenceId;
+        private String nodeKey;
+        private String filePath;
+        private Integer startLine;
+        private Integer endLine;
+        private String codeContent; // 실제 코드 내용을 담을 필드
+    }
 }

src/main/java/com/teamEWSN/gitdeun/codereference/entity/CodeReference.java

@@ -25,8 +25,8 @@ public class CodeReference extends AuditedEntity {
     @JoinColumn(name = "mindmap_id", nullable = false)
     private Mindmap mindmap;
 
-    @Column(name = "node_id", nullable = false)
-    private String nodeId;
+    @Column(name = "node_key", nullable = false)
+    private String nodeKey;
 
     @Column(name = "file_path", columnDefinition = "TEXT", nullable = false)
     private String filePath;

src/main/java/com/teamEWSN/gitdeun/codereference/mapper/CodeReferenceMapper.java

@@ -4,11 +4,32 @@
 import com.teamEWSN.gitdeun.codereference.entity.CodeReference;
 import org.mapstruct.Mapper;
 import org.mapstruct.Mapping;
+import org.mapstruct.Named;
 import org.mapstruct.ReportingPolicy;
 
 @Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
 public interface CodeReferenceMapper {
 
+    /**
+     * 기본 CodeReference 응답 매핑
+     */
     @Mapping(target = "referenceId", source = "id")
     ReferenceResponse toReferenceResponse(CodeReference codeReference);
+
+    @Mapping(target = "referenceId", source = "codeReference.id")
+    @Mapping(target = "nodeKey", source = "codeReference.nodeKey")
+    @Mapping(target = "filePath", source = "codeReference.filePath")
+    @Mapping(target = "startLine", source = "codeReference.startLine")
+    @Mapping(target = "endLine", source = "codeReference.endLine")
+    @Mapping(target = "codeContent", expression = "java(codeContent)")
+    ReferenceDetailResponse toReferenceDetailResponse(CodeReference codeReference, String codeContent);
+
+    /**
+     * 파일명 추출 헬퍼 메서드
+     */
+    @Named("extractFileName")
+    default String extractFileName(String filePath) {
+        if (filePath == null) return null;
+        return filePath.substring(filePath.lastIndexOf('/') + 1);
+    }
 }

src/main/java/com/teamEWSN/gitdeun/codereference/repository/CodeReferenceRepository.java

@@ -10,7 +10,7 @@
 @Repository
 public interface CodeReferenceRepository extends JpaRepository<CodeReference, Long> {
 
-    List<CodeReference> findByMindmapIdAndNodeId(Long mindmapId, String nodeId);
+    List<CodeReference> findByMindmapIdAndNodeKey(Long mindmapId, String nodeKey);
 
     Optional<CodeReference> findByMindmapIdAndId(Long mindmapId, Long id);
 

src/main/java/com/teamEWSN/gitdeun/codereference/service/CodeReferenceService.java

@@ -8,6 +8,7 @@
 import com.teamEWSN.gitdeun.codereference.repository.CodeReferenceRepository;
 import com.teamEWSN.gitdeun.common.exception.ErrorCode;
 import com.teamEWSN.gitdeun.common.exception.GlobalException;
+import com.teamEWSN.gitdeun.common.fastapi.FastApiClient;
 import com.teamEWSN.gitdeun.mindmap.entity.Mindmap;
 import com.teamEWSN.gitdeun.mindmap.repository.MindmapRepository;
 import com.teamEWSN.gitdeun.mindmapmember.service.MindmapAuthService;
@@ -26,9 +27,10 @@ public class CodeReferenceService {
     private final MindmapRepository mindmapRepository;
     private final MindmapAuthService mindmapAuthService;
     private final CodeReferenceMapper codeReferenceMapper;
+    private final FastApiClient fastApiClient;
 
     @Transactional
-    public ReferenceResponse createReference(Long mapId, String nodeId, Long userId, CreateRequest request) {
+    public ReferenceResponse createReference(Long mapId, String nodeKey, Long userId, CreateRequest request) {
         // 1. 권한 확인
         if (!mindmapAuthService.hasEdit(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
@@ -41,7 +43,7 @@ public ReferenceResponse createReference(Long mapId, String nodeId, Long userId,
         // 3. CodeReference 엔티티 생성 및 저장
         CodeReference codeReference = CodeReference.builder()
             .mindmap(mindmap)
-            .nodeId(nodeId)
+            .nodeKey(nodeKey)
             .filePath(request.getFilePath())
             .startLine(request.getStartLine())
             .endLine(request.getEndLine())
@@ -54,29 +56,34 @@ public ReferenceResponse createReference(Long mapId, String nodeId, Long userId,
     }
 
     @Transactional(readOnly = true)
-    public ReferenceResponse getReference(Long mapId, Long refId, Long userId) {
-        // 1. 권한 확인
+    public ReferenceDetailResponse getReferenceDetail(Long mapId, Long refId, Long userId, String authorizationHeader) {
         if (!mindmapAuthService.hasView(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
         }
 
-        // 2. 해당 마인드맵에 속한 코드 참조인지 확인
         CodeReference codeReference = codeReferenceRepository.findByMindmapIdAndId(mapId, refId)
             .orElseThrow(() -> new GlobalException(ErrorCode.CODE_REFERENCE_NOT_FOUND));
 
-        // 3. DTO로 변환하여 반환
-        return codeReferenceMapper.toReferenceResponse(codeReference);
+        Mindmap mindmap = codeReference.getMindmap();
+
+        // FastAPI를 통해 전체 파일 내용 가져오기
+        String fullContent = fastApiClient.getFileRaw(mindmap.getRepo().getGithubRepoUrl(), codeReference.getFilePath(), authorizationHeader);
+
+        // 특정 라인만 추출 (snippet)
+        String snippet = extractLines(fullContent, codeReference.getStartLine(), codeReference.getEndLine());
+
+        return codeReferenceMapper.toReferenceDetailResponse(codeReference, snippet);
     }
 
     @Transactional(readOnly = true)
-    public List<ReferenceResponse> getReferencesForNode(Long mapId, String nodeId, Long userId) {
+    public List<ReferenceResponse> getReferencesForNode(Long mapId, String nodeKey, Long userId) {
         // 1. 권한 확인 (읽기)
         if (!mindmapAuthService.hasView(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
         }
 
         // 2. 특정 노드에 속한 모든 코드 참조 조회
-        List<CodeReference> references = codeReferenceRepository.findByMindmapIdAndNodeId(mapId, nodeId);
+        List<CodeReference> references = codeReferenceRepository.findByMindmapIdAndNodeKey(mapId, nodeKey);
 
         // 3. DTO 리스트로 변환하여 반환
         return references.stream()
@@ -86,7 +93,7 @@ public List<ReferenceResponse> getReferencesForNode(Long mapId, String nodeId, L
 
     @Transactional
     public ReferenceResponse updateReference(Long mapId, Long refId, Long userId, CreateRequest request) {
-        // 1. 권한 확인 (쓰기)
+        // 1. 권한 확인
         if (!mindmapAuthService.hasEdit(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
         }
@@ -117,4 +124,16 @@ public void deleteReference(Long mapId, Long refId, Long userId) {
         // 3. 코드 참조 삭제
         codeReferenceRepository.deleteById(refId);
     }
+
+    private String extractLines(String fullContent, Integer startLine, Integer endLine) {
+        if (fullContent == null) return "";
+        if (startLine == null || endLine == null || startLine <= 0 || endLine < startLine) return fullContent;
+
+        String[] lines = fullContent.split("\\r?\\n");
+        StringBuilder sb = new StringBuilder();
+        for (int i = startLine - 1; i < endLine && i < lines.length; i++) {
+            sb.append(lines[i]).append("\n");
+        }
+        return sb.toString();
+    }
 }

src/main/java/com/teamEWSN/gitdeun/codereview/controller/CodeReviewController.java

@@ -27,14 +27,14 @@ public class CodeReviewController {
     private final CodeReviewService codeReviewService;
 
     // 노드에 대한 코드 리뷰 생성
-    @PostMapping(value = "/mindmaps/{mapId}/nodes/{nodeId}/code-reviews", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    @PostMapping(value = "/mindmaps/{mapId}/nodes/{nodeKey}/code-reviews", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
     public ResponseEntity<ReviewResponse> createNodeCodeReview(
         @PathVariable Long mapId,
-        @PathVariable String nodeId,
+        @PathVariable String nodeKey,
         @Valid @RequestPart("request") CreateRequest request,
         @RequestPart(value = "files", required = false) List<MultipartFile> files,
         @AuthenticationPrincipal CustomUserDetails userDetails) {
-        return ResponseEntity.status(HttpStatus.CREATED).body(codeReviewService.createNodeReview(mapId, nodeId, userDetails.getId(), request, files));
+        return ResponseEntity.status(HttpStatus.CREATED).body(codeReviewService.createNodeReview(mapId, nodeKey, userDetails.getId(), request, files));
     }
 
     // 코드 참조에 대한 코드 리뷰 생성
@@ -66,12 +66,12 @@ public ResponseEntity<Void> updateCodeReviewStatus(
     }
 
     // 특정 노드에 달린 코드 리뷰 목록 조회
-    @GetMapping("/mindmaps/{mapId}/nodes/{nodeId}/code-reviews")
+    @GetMapping("/mindmaps/{mapId}/nodes/{nodeKey}/code-reviews")
     public ResponseEntity<Page<ReviewListResponse>> getNodeCodeReviews(
             @PathVariable Long mapId,
-            @PathVariable String nodeId,
+            @PathVariable String nodeKey,
             @AuthenticationPrincipal CustomUserDetails userDetails,
             @PageableDefault(size = 10) Pageable pageable) {
-        return ResponseEntity.ok(codeReviewService.getReviewsForNode(mapId, nodeId, userDetails.getId(), pageable));
+        return ResponseEntity.ok(codeReviewService.getReviewsForNode(mapId, nodeKey, userDetails.getId(), pageable));
     }
 }

src/main/java/com/teamEWSN/gitdeun/codereview/entity/CodeReview.java

@@ -32,8 +32,8 @@ public class CodeReview extends AuditedEntity {
     private Mindmap mindmap;
 
     // 리뷰 대상: 노드 ID 또는 코드 참조
-    @Column(name = "node_id")
-    private String nodeId; // 마인드맵 그래프의 노드 ID
+    @Column(name = "node_key")
+    private String nodeKey; // 마인드맵 그래프의 노드 key
 
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "code_reference_id")

src/main/java/com/teamEWSN/gitdeun/codereview/repository/CodeReviewRepository.java

@@ -8,5 +8,5 @@
 
 @Repository
 public interface CodeReviewRepository extends JpaRepository<CodeReview, Long> {
-    Page<CodeReview> findByMindmapIdAndNodeId(Long mindmapId, String nodeId, Pageable pageable);
+    Page<CodeReview> findByMindmapIdAndNodeKey(Long mindmapId, String nodeKey, Pageable pageable);
 }

src/main/java/com/teamEWSN/gitdeun/codereview/service/CodeReviewService.java

@@ -38,7 +38,7 @@ public class CodeReviewService {
     private final CodeReviewMapper codeReviewMapper;
 
     @Transactional
-    public ReviewResponse createNodeReview(Long mapId, String nodeId, Long userId, CreateRequest request, List<MultipartFile> files) {
+    public ReviewResponse createNodeReview(Long mapId, String nodeKey, Long userId, CreateRequest request, List<MultipartFile> files) {
         // 리뷰 작성 권한 확인
         if (!mindmapAuthService.hasEdit(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
@@ -53,7 +53,7 @@ public ReviewResponse createNodeReview(Long mapId, String nodeId, Long userId, C
         CodeReview codeReview = CodeReview.builder()
             .mindmap(mindmap)
             .author(author)
-            .nodeId(nodeId)
+            .nodeKey(nodeKey)
             .status(CodeReviewStatus.PENDING)
             .build();
         CodeReview savedReview = codeReviewRepository.save(codeReview);
@@ -125,12 +125,12 @@ public void updateReviewStatus(Long reviewId, Long userId, CodeReviewStatus stat
     }
 
     @Transactional(readOnly = true)
-    public Page<ReviewListResponse> getReviewsForNode(Long mapId, String nodeId, Long userId, Pageable pageable) {
+    public Page<ReviewListResponse> getReviewsForNode(Long mapId, String nodeKey, Long userId, Pageable pageable) {
         if (!mindmapAuthService.hasView(mapId, userId)) {
             throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
         }
 
-        Page<CodeReview> reviews = codeReviewRepository.findByMindmapIdAndNodeId(mapId, nodeId, pageable);
+        Page<CodeReview> reviews = codeReviewRepository.findByMindmapIdAndNodeKey(mapId, nodeKey, pageable);
         return reviews.map(codeReviewMapper::toReviewListResponse);
     }
 }

src/main/java/com/teamEWSN/gitdeun/comment/entity/Comment.java

@@ -6,6 +6,7 @@
 import jakarta.persistence.*;
 import lombok.*;
 import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
 import org.hibernate.annotations.Where;
 
 import java.time.LocalDateTime;
@@ -16,7 +17,7 @@
 @Getter
 @Builder
 @SQLDelete(sql = "UPDATE comment SET deleted_at = CURRENT_TIMESTAMP WHERE id = ?")
-@Where(clause = "deleted_at IS NULL")
+@SQLRestriction("deleted_at IS NULL")
 @NoArgsConstructor
 @AllArgsConstructor
 @Table(name = "comment")

src/main/java/com/teamEWSN/gitdeun/common/exception/ErrorCode.java

@@ -45,6 +45,7 @@ public enum ErrorCode {
     // 마인드맵 관련
     MINDMAP_NOT_FOUND(HttpStatus.NOT_FOUND, "MINDMAP-001", "요청한 마인드맵을 찾을 수 없습니다."),
     MINDMAP_CREATION_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "MINDMAP-002", "마인드맵 생성 중 오류가 발생했습니다."),
+    NODE_NOT_FOUND(HttpStatus.NOT_FOUND, "MINDMAP-003", "요청한 마인드맵 노드 정보를 찾을 수 없습니다."),
 
     // 마인드맵 요청 검증 관련
     INVALID_USER_ID(HttpStatus.BAD_REQUEST, "VALIDATE-001", "유효하지 않은 사용자 ID입니다."),