Feat/#71 code review

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

@@ -1,4 +1,70 @@
 package com.teamEWSN.gitdeun.codereference.controller;
 
+import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceResponseDtos.*;
+import com.teamEWSN.gitdeun.codereference.dto.*;
+import com.teamEWSN.gitdeun.codereference.service.CodeReferenceService;
+import com.teamEWSN.gitdeun.common.jwt.CustomUserDetails;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/mindmaps/{mapId}")
+@RequiredArgsConstructor
 public class CodeReferenceController {
+
+    private final CodeReferenceService codeReferenceService;
+
+    // 특정 노드에 코드 참조 생성
+    @PostMapping("/nodes/{nodeId}/code-references")
+    public ResponseEntity<ReferenceResponse> createCodeReference(
+        @PathVariable Long mapId,
+        @PathVariable String nodeId,
+        @Valid @RequestBody CodeReferenceRequestDtos.CreateRequest request,
+        @AuthenticationPrincipal CustomUserDetails userDetails) {
+        return ResponseEntity.status(HttpStatus.CREATED).body(codeReferenceService.createReference(mapId, nodeId, userDetails.getId(), request));
+    }
+
+    // 특정 코드 참조 상세 조회
+    @GetMapping("/code-references/{refId}")
+    public ResponseEntity<ReferenceResponse> getCodeReference(
+        @PathVariable Long mapId,
+        @PathVariable Long refId,
+        @AuthenticationPrincipal CustomUserDetails userDetails) {
+        return ResponseEntity.ok(codeReferenceService.getReference(mapId, refId, userDetails.getId()));
+    }
+
+    // 특정 노드에 연결된 모든 코드 참조 목록 조회
+    @GetMapping("/nodes/{nodeId}/code-references")
+    public ResponseEntity<List<ReferenceResponse>> getNodeCodeReferences(
+        @PathVariable Long mapId,
+        @PathVariable String nodeId,
+        @AuthenticationPrincipal CustomUserDetails userDetails) {
+        return ResponseEntity.ok(codeReferenceService.getReferencesForNode(mapId, nodeId, userDetails.getId()));
+    }
+
+    // 코드 참조 정보 수정
+    @PatchMapping("/code-references/{refId}")
+    public ResponseEntity<ReferenceResponse> updateCodeReference(
+        @PathVariable Long mapId,
+        @PathVariable Long refId,
+        @Valid @RequestBody CodeReferenceRequestDtos.CreateRequest request,
+        @AuthenticationPrincipal CustomUserDetails userDetails) {
+        return ResponseEntity.ok(codeReferenceService.updateReference(mapId, refId, userDetails.getId(), request));
+    }
+
+    // 코드 참조 삭제
+    @DeleteMapping("/code-references/{refId}")
+    public ResponseEntity<Void> deleteCodeReference(
+        @PathVariable Long mapId,
+        @PathVariable Long refId,
+        @AuthenticationPrincipal CustomUserDetails userDetails) {
+        codeReferenceService.deleteReference(mapId, refId, userDetails.getId());
+        return ResponseEntity.noContent().build();
+    }
 }

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

@@ -0,0 +1,19 @@
+package com.teamEWSN.gitdeun.codereference.dto;
+
+
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+public class CodeReferenceRequestDtos {
+
+    @Getter
+    @NoArgsConstructor
+    public static class CreateRequest {
+        @NotEmpty(message = "파일 경로는 비워둘 수 없습니다.")
+        private String filePath;
+        private Integer startLine;
+        private Integer endLine;
+    }
+
+}

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

@@ -0,0 +1,19 @@
+package com.teamEWSN.gitdeun.codereference.dto;
+
+import lombok.*;
+
+public class CodeReferenceResponseDtos {
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor(access = AccessLevel.PROTECTED)
+    public static class ReferenceResponse {
+        private Long referenceId;
+        private String nodeId;
+        private String filePath;
+        private Integer startLine;
+        private Integer endLine;
+    }
+
+}

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

@@ -1,16 +1,21 @@
 package com.teamEWSN.gitdeun.codereference.entity;
 
+import com.teamEWSN.gitdeun.codereview.entity.CodeReview;
+import com.teamEWSN.gitdeun.common.util.AuditedEntity;
 import com.teamEWSN.gitdeun.mindmap.entity.Mindmap;
 import jakarta.persistence.*;
-import lombok.AccessLevel;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
+import lombok.*;
+
+import java.util.ArrayList;
+import java.util.List;
 
 @Entity
 @Getter
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
 @Table(name = "code_reference")
-public class CodeReference {
+public class CodeReference extends AuditedEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -20,12 +25,26 @@ public class CodeReference {
     @JoinColumn(name = "mindmap_id", nullable = false)
     private Mindmap mindmap;
 
+    @Column(name = "node_id", nullable = false)
+    private String nodeId;
+
     @Column(name = "file_path", columnDefinition = "TEXT", nullable = false)
     private String filePath;
 
-    @Column(name = "start_line", length = 255)
-    private String startLine;
+    @Column(name = "start_line")
+    private Integer startLine;
+
+    @Column(name = "end_line")
+    private Integer endLine;
+
+    @Builder.Default
+    @OneToMany(mappedBy = "codeReference", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<CodeReview> codeReviews = new ArrayList<>();
+
 
-    @Column(name = "end_line", length = 255)
-    private String endLine;
+    public void update(String filePath, Integer startLine, Integer endLine) {
+        this.filePath = filePath;
+        this.startLine = startLine;
+        this.endLine = endLine;
+    }
 }

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

@@ -0,0 +1,14 @@
+package com.teamEWSN.gitdeun.codereference.mapper;
+
+import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceResponseDtos.*;
+import com.teamEWSN.gitdeun.codereference.entity.CodeReference;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import org.mapstruct.ReportingPolicy;
+
+@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
+public interface CodeReferenceMapper {
+
+    @Mapping(target = "referenceId", source = "id")
+    ReferenceResponse toReferenceResponse(CodeReference codeReference);
+}

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

@@ -1,5 +1,18 @@
 package com.teamEWSN.gitdeun.codereference.repository;
 
-public class CodeReferenceRepository {
-
+import com.teamEWSN.gitdeun.codereference.entity.CodeReference;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface CodeReferenceRepository extends JpaRepository<CodeReference, Long> {
+
+    List<CodeReference> findByMindmapIdAndNodeId(Long mindmapId, String nodeId);
+
+    Optional<CodeReference> findByMindmapIdAndId(Long mindmapId, Long id);
+
+    boolean existsByMindmapIdAndId(Long mindmapId, Long id);
 }

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

@@ -1,5 +1,120 @@
 package com.teamEWSN.gitdeun.codereference.service;
 
+
+import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceRequestDtos.*;
+import com.teamEWSN.gitdeun.codereference.dto.CodeReferenceResponseDtos.*;
+import com.teamEWSN.gitdeun.codereference.entity.CodeReference;
+import com.teamEWSN.gitdeun.codereference.mapper.CodeReferenceMapper;
+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.mindmap.entity.Mindmap;
+import com.teamEWSN.gitdeun.mindmap.repository.MindmapRepository;
+import com.teamEWSN.gitdeun.mindmapmember.service.MindmapAuthService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Service
+@RequiredArgsConstructor
 public class CodeReferenceService {
-
-}
+
+    private final CodeReferenceRepository codeReferenceRepository;
+    private final MindmapRepository mindmapRepository;
+    private final MindmapAuthService mindmapAuthService;
+    private final CodeReferenceMapper codeReferenceMapper;
+
+    @Transactional
+    public ReferenceResponse createReference(Long mapId, String nodeId, Long userId, CreateRequest request) {
+        // 1. 권한 확인
+        if (!mindmapAuthService.hasEdit(mapId, userId)) {
+            throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
+        }
+
+        // 2. 마인드맵 존재 여부 확인
+        Mindmap mindmap = mindmapRepository.findById(mapId)
+            .orElseThrow(() -> new GlobalException(ErrorCode.MINDMAP_NOT_FOUND));
+
+        // 3. CodeReference 엔티티 생성 및 저장
+        CodeReference codeReference = CodeReference.builder()
+            .mindmap(mindmap)
+            .nodeId(nodeId)
+            .filePath(request.getFilePath())
+            .startLine(request.getStartLine())
+            .endLine(request.getEndLine())
+            .build();
+
+        CodeReference savedReference = codeReferenceRepository.save(codeReference);
+
+        // 4. DTO로 변환하여 반환
+        return codeReferenceMapper.toReferenceResponse(savedReference);
+    }
+
+    @Transactional(readOnly = true)
+    public ReferenceResponse getReference(Long mapId, Long refId, Long userId) {
+        // 1. 권한 확인
+        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);
+    }
+
+    @Transactional(readOnly = true)
+    public List<ReferenceResponse> getReferencesForNode(Long mapId, String nodeId, Long userId) {
+        // 1. 권한 확인 (읽기)
+        if (!mindmapAuthService.hasView(mapId, userId)) {
+            throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
+        }
+
+        // 2. 특정 노드에 속한 모든 코드 참조 조회
+        List<CodeReference> references = codeReferenceRepository.findByMindmapIdAndNodeId(mapId, nodeId);
+
+        // 3. DTO 리스트로 변환하여 반환
+        return references.stream()
+            .map(codeReferenceMapper::toReferenceResponse)
+            .collect(Collectors.toList());
+    }
+
+    @Transactional
+    public ReferenceResponse updateReference(Long mapId, Long refId, Long userId, CreateRequest request) {
+        // 1. 권한 확인 (쓰기)
+        if (!mindmapAuthService.hasEdit(mapId, userId)) {
+            throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
+        }
+
+        // 2. 해당 마인드맵에 속한 코드 참조인지 확인 후 조회
+        CodeReference codeReference = codeReferenceRepository.findByMindmapIdAndId(mapId, refId)
+            .orElseThrow(() -> new GlobalException(ErrorCode.CODE_REFERENCE_NOT_FOUND));
+
+        // 3. 엔티티 정보 업데이트
+        codeReference.update(request.getFilePath(), request.getStartLine(), request.getEndLine());
+
+        // 4. DTO로 변환하여 반환 (JPA의 Dirty Checking에 의해 자동 저장됨)
+        return codeReferenceMapper.toReferenceResponse(codeReference);
+    }
+
+    @Transactional
+    public void deleteReference(Long mapId, Long refId, Long userId) {
+        // 1. 권한 확인
+        if (!mindmapAuthService.hasEdit(mapId, userId)) {
+            throw new GlobalException(ErrorCode.FORBIDDEN_ACCESS);
+        }
+
+        // 2. 해당 마인드맵에 코드 참조가 존재하는지 확인
+        if (!codeReferenceRepository.existsByMindmapIdAndId(mapId, refId)) {
+            throw new GlobalException(ErrorCode.CODE_REFERENCE_NOT_FOUND);
+        }
+
+        // 3. 코드 참조 삭제
+        codeReferenceRepository.deleteById(refId);
+    }
+}