feat: Apple Watch 건강 데이터 연동 API 추가

- RecordHealthData, HeartRateSample 엔티티 및 리포지토리 추가
- POST /api/record/{recordId}/health (건강 데이터 저장)
- GET /api/record/{recordId}/health (건강 데이터 상세 조회)
- GET /api/health/summary (기간별 건강 통계)
- DELETE /api/record/{recordId}/health (건강 데이터 삭제)
- GET /api/record/user 응답에 healthData 필드 추가 (하위 호환)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: thingineeer

src/main/java/org/runnect/server/common/constant/ErrorStatus.java

@@ -31,6 +31,9 @@ public enum ErrorStatus {
     NOT_FOUND_SCRAP_EXCEPTION(HttpStatus.BAD_REQUEST, "스크랩한 코스가 없습니다."),
     NOT_FOUND_IMAGE_EXCEPTION(HttpStatus.BAD_REQUEST, "잘못된 이미지 파일입니다"),
     NOT_FOUND_PUBLICCOURSE_EXCEPTION(HttpStatus.BAD_REQUEST, "존재하지 않는 public course id입니다."),
+    INVALID_HEALTH_DATA_EXCEPTION(HttpStatus.BAD_REQUEST, "유효하지 않은 건강 데이터입니다"),
+    INVALID_DATE_RANGE_EXCEPTION(HttpStatus.BAD_REQUEST, "유효하지 않은 날짜 범위입니다"),
+    EXCEED_HEART_RATE_SAMPLES_EXCEPTION(HttpStatus.BAD_REQUEST, "심박수 샘플은 최대 5000건까지 허용됩니다"),
 
     /**
      * 401 UNAUTHORIZED
@@ -51,6 +54,7 @@ public enum ErrorStatus {
      */
     PERMISSION_DENIED_PUBLIC_COURSE_DELETE_EXCEPTION(HttpStatus.FORBIDDEN, "퍼블릭 코스를 삭제할 권한이 존재하지 않습니다."),
     PERMISSION_DENIED_RECORD_DELETE_EXCEPTION(HttpStatus.FORBIDDEN, "기록을 삭제할 권한이 존재하지 않습니다."),
+    PERMISSION_DENIED_HEALTH_DATA_EXCEPTION(HttpStatus.FORBIDDEN, "건강 데이터에 대한 접근 권한이 없습니다"),
 
     /**
      * 404 NOT FOUND
@@ -63,6 +67,7 @@ public enum ErrorStatus {
     ALREADY_EXIST_USER_EXCEPTION(HttpStatus.CONFLICT, "이미 존재하는 유저입니다"),
     ALREADY_EXIST_NICKNAME_EXCEPTION(HttpStatus.CONFLICT, "중복된 닉네임입니다."),
     ALREADY_UPLOAD_COURSE_EXCEPTION(HttpStatus.CONFLICT, "이미 업로드된 코스입니다."),
+    ALREADY_EXIST_HEALTH_DATA_EXCEPTION(HttpStatus.CONFLICT, "이미 건강 데이터가 등록된 기록입니다"),
 
     /**
      * 500 INTERNAL SERVER ERROR

src/main/java/org/runnect/server/common/constant/SuccessStatus.java

@@ -29,6 +29,9 @@ public enum SuccessStatus {
 
     SEARCH_PUBLIC_COURSE_SUCCESS(HttpStatus.OK,"업로드된 코스 검색 성공"),
 
+    GET_HEALTH_DATA_SUCCESS(HttpStatus.OK, "건강 데이터 조회 성공"),
+    GET_HEALTH_SUMMARY_SUCCESS(HttpStatus.OK, "건강 통계 조회 성공"),
+
 
     UPDATE_RECORD_SUCCESS(HttpStatus.OK, "활동 기록 수정 성공"),
     UPDATE_USER_NICKNAME_SUCCESS(HttpStatus.OK, "닉네임 변경에 성공했습니다."),
@@ -41,6 +44,7 @@ public enum SuccessStatus {
     DELETE_PUBLIC_COURSE_SUCCESS(HttpStatus.OK, "퍼블릭 코스 삭제에 성공했습니다."),
     DELETE_RECORD_SUCCESS(HttpStatus.OK, "기록 삭제에 성공했습니다."),
     DELETE_COURSES_SUCCESS(HttpStatus.OK, "코스 삭제 성공"),
+    DELETE_HEALTH_DATA_SUCCESS(HttpStatus.OK, "건강 데이터 삭제 성공"),
 
 
     /**
@@ -52,6 +56,7 @@ public enum SuccessStatus {
     CREATE_PUBLIC_COURSE_SUCCESS(HttpStatus.CREATED, "코드 업로드에 성공했습니다."),
     CREATE_SCRAP_SUCCESS(HttpStatus.CREATED, "코스 스크랩 성공"),
     NEW_TOKEN_SUCCESS(HttpStatus.CREATED, "토큰 재발급에 성공했습니다."),
+    CREATE_HEALTH_DATA_SUCCESS(HttpStatus.CREATED, "건강 데이터 저장 성공"),
     ;
 
     private final HttpStatus httpStatus;

src/main/java/org/runnect/server/health/controller/HealthController.java

@@ -0,0 +1,68 @@
+package org.runnect.server.health.controller;
+
+import javax.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.runnect.server.common.constant.SuccessStatus;
+import org.runnect.server.common.dto.ApiResponseDto;
+import org.runnect.server.common.resolver.userId.UserId;
+import org.runnect.server.health.dto.request.HealthDataRequestDto;
+import org.runnect.server.health.dto.response.CreateHealthDataResponseDto;
+import org.runnect.server.health.dto.response.GetHealthDataResponseDto;
+import org.runnect.server.health.dto.response.GetHealthSummaryResponseDto;
+import org.runnect.server.health.service.HealthService;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api")
+public class HealthController {
+
+    private final HealthService healthService;
+
+    @PostMapping("record/{recordId}/health")
+    @ResponseStatus(HttpStatus.CREATED)
+    public ApiResponseDto<CreateHealthDataResponseDto> createHealthData(
+            @UserId Long userId,
+            @PathVariable(name = "recordId") Long recordId,
+            @RequestBody @Valid final HealthDataRequestDto request) {
+        return ApiResponseDto.success(SuccessStatus.CREATE_HEALTH_DATA_SUCCESS,
+                healthService.createHealthData(userId, recordId, request));
+    }
+
+    @GetMapping("record/{recordId}/health")
+    @ResponseStatus(HttpStatus.OK)
+    public ApiResponseDto<GetHealthDataResponseDto> getHealthData(
+            @UserId Long userId,
+            @PathVariable(name = "recordId") Long recordId) {
+        return ApiResponseDto.success(SuccessStatus.GET_HEALTH_DATA_SUCCESS,
+                healthService.getHealthData(userId, recordId));
+    }
+
+    @GetMapping("health/summary")
+    @ResponseStatus(HttpStatus.OK)
+    public ApiResponseDto<GetHealthSummaryResponseDto> getHealthSummary(
+            @UserId Long userId,
+            @RequestParam(name = "startDate") String startDate,
+            @RequestParam(name = "endDate") String endDate) {
+        return ApiResponseDto.success(SuccessStatus.GET_HEALTH_SUMMARY_SUCCESS,
+                healthService.getHealthSummary(userId, startDate, endDate));
+    }
+
+    @DeleteMapping("record/{recordId}/health")
+    @ResponseStatus(HttpStatus.OK)
+    public ApiResponseDto deleteHealthData(
+            @UserId Long userId,
+            @PathVariable(name = "recordId") Long recordId) {
+        healthService.deleteHealthData(userId, recordId);
+        return ApiResponseDto.success(SuccessStatus.DELETE_HEALTH_DATA_SUCCESS);
+    }
+}

src/main/java/org/runnect/server/health/dto/request/HealthDataRequestDto.java

@@ -0,0 +1,44 @@
+package org.runnect.server.health.dto.request;
+
+import java.util.List;
+import javax.validation.Valid;
+import javax.validation.constraints.NotNull;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor
+public class HealthDataRequestDto {
+    @NotNull
+    private Double avgHeartRate;
+
+    private Double maxHeartRate;
+
+    private Double minHeartRate;
+
+    @NotNull
+    private Double calories;
+
+    @NotNull
+    private Integer zone1Seconds;
+
+    @NotNull
+    private Integer zone2Seconds;
+
+    @NotNull
+    private Integer zone3Seconds;
+
+    @NotNull
+    private Integer zone4Seconds;
+
+    @NotNull
+    private Integer zone5Seconds;
+
+    private Double maxHeartRateConfig;
+
+    @Valid
+    private List<HeartRateSampleRequestDto> heartRateSamples;
+}

src/main/java/org/runnect/server/health/dto/request/HeartRateSampleRequestDto.java

@@ -0,0 +1,24 @@
+package org.runnect.server.health.dto.request;
+
+import javax.validation.constraints.Max;
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotNull;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor
+public class HeartRateSampleRequestDto {
+    @NotNull
+    private Double heartRate;
+
+    @NotNull
+    private Integer elapsedSeconds;
+
+    @NotNull
+    @Min(1) @Max(5)
+    private Integer zone;
+}

src/main/java/org/runnect/server/health/dto/response/CreateHealthDataResponseDto.java

@@ -0,0 +1,17 @@
+package org.runnect.server.health.dto.response;
+
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+public class CreateHealthDataResponseDto {
+    private Long healthDataId;
+
+    public static CreateHealthDataResponseDto of(Long healthDataId) {
+        return new CreateHealthDataResponseDto(healthDataId);
+    }
+}

src/main/java/org/runnect/server/health/dto/response/GetHealthDataResponseDto.java

@@ -0,0 +1,70 @@
+package org.runnect.server.health.dto.response;
+
+import java.util.List;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+public class GetHealthDataResponseDto {
+    private HealthDataDetailResponse healthData;
+
+    public static GetHealthDataResponseDto of(HealthDataDetailResponse healthData) {
+        return new GetHealthDataResponseDto(healthData);
+    }
+
+    @Getter
+    @NoArgsConstructor(access = AccessLevel.PRIVATE)
+    @AllArgsConstructor(access = AccessLevel.PRIVATE)
+    public static class HealthDataDetailResponse {
+        private Long id;
+        private Long recordId;
+        private Double avgHeartRate;
+        private Double maxHeartRate;
+        private Double minHeartRate;
+        private Double calories;
+        private ZoneResponse zones;
+        private Double maxHeartRateConfig;
+        private List<HeartRateSampleResponse> heartRateSamples;
+
+        public static HealthDataDetailResponse of(Long id, Long recordId, Double avgHeartRate,
+                Double maxHeartRate, Double minHeartRate, Double calories,
+                ZoneResponse zones, Double maxHeartRateConfig,
+                List<HeartRateSampleResponse> heartRateSamples) {
+            return new HealthDataDetailResponse(id, recordId, avgHeartRate, maxHeartRate,
+                    minHeartRate, calories, zones, maxHeartRateConfig, heartRateSamples);
+        }
+    }
+
+    @Getter
+    @NoArgsConstructor(access = AccessLevel.PRIVATE)
+    @AllArgsConstructor(access = AccessLevel.PRIVATE)
+    public static class ZoneResponse {
+        private Integer zone1Seconds;
+        private Integer zone2Seconds;
+        private Integer zone3Seconds;
+        private Integer zone4Seconds;
+        private Integer zone5Seconds;
+
+        public static ZoneResponse of(Integer zone1Seconds, Integer zone2Seconds,
+                Integer zone3Seconds, Integer zone4Seconds, Integer zone5Seconds) {
+            return new ZoneResponse(zone1Seconds, zone2Seconds, zone3Seconds, zone4Seconds, zone5Seconds);
+        }
+    }
+
+    @Getter
+    @NoArgsConstructor(access = AccessLevel.PRIVATE)
+    @AllArgsConstructor(access = AccessLevel.PRIVATE)
+    public static class HeartRateSampleResponse {
+        private Double heartRate;
+        private Integer elapsedSeconds;
+        private Integer zone;
+
+        public static HeartRateSampleResponse of(Double heartRate, Integer elapsedSeconds, Integer zone) {
+            return new HeartRateSampleResponse(heartRate, elapsedSeconds, zone);
+        }
+    }
+}

src/main/java/org/runnect/server/health/dto/response/GetHealthSummaryResponseDto.java

@@ -0,0 +1,36 @@
+package org.runnect.server.health.dto.response;
+
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+public class GetHealthSummaryResponseDto {
+    private HealthSummaryResponse summary;
+
+    public static GetHealthSummaryResponseDto of(HealthSummaryResponse summary) {
+        return new GetHealthSummaryResponseDto(summary);
+    }
+
+    @Getter
+    @NoArgsConstructor(access = AccessLevel.PRIVATE)
+    @AllArgsConstructor(access = AccessLevel.PRIVATE)
+    public static class HealthSummaryResponse {
+        private Long totalRecords;
+        private Long recordsWithHealth;
+        private Double avgHeartRate;
+        private Double avgCalories;
+        private Double totalCalories;
+        private GetHealthDataResponseDto.ZoneResponse zoneDistribution;
+
+        public static HealthSummaryResponse of(Long totalRecords, Long recordsWithHealth,
+                Double avgHeartRate, Double avgCalories, Double totalCalories,
+                GetHealthDataResponseDto.ZoneResponse zoneDistribution) {
+            return new HealthSummaryResponse(totalRecords, recordsWithHealth, avgHeartRate,
+                    avgCalories, totalCalories, zoneDistribution);
+        }
+    }
+}

src/main/java/org/runnect/server/health/entity/HeartRateSample.java

@@ -0,0 +1,55 @@
+package org.runnect.server.health.entity;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.FetchType;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.runnect.server.common.entity.AuditingTimeEntity;
+
+@Getter
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class HeartRateSample extends AuditingTimeEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "record_health_data_id", nullable = false)
+    private RecordHealthData recordHealthData;
+
+    @Column(nullable = false)
+    private Double heartRate;
+
+    @Column(nullable = false)
+    private Integer elapsedSeconds;
+
+    @Column(nullable = false)
+    private Integer zone;
+
+    @Builder
+    public HeartRateSample(RecordHealthData recordHealthData, Double heartRate, Integer elapsedSeconds, Integer zone) {
+        this.recordHealthData = recordHealthData;
+        this.heartRate = heartRate;
+        this.elapsedSeconds = elapsedSeconds;
+        this.zone = zone;
+    }
+
+    public void setRecordHealthData(RecordHealthData recordHealthData) {
+        this.recordHealthData = recordHealthData;
+    }
+
+    @Override
+    public void updateDeletedAt() {
+        throw new RuntimeException("Course를 제외한 테이블은 정상적으로 삭제됩니다.");
+    }
+}