feat: 가족 걸음 수 저장 및 조회 기능 추가 (#9)

* feat: 가족 걸음 수 저장 및 조회 기능 추가

* feat: 가족 걸음 수 저장 및 조회 기능 추가

* test: 컨트롤러별 단위 테스트 추가 (Cursor) (#13)

* 파일 끝 빈 줄 추가

Author: Neibce

backend/ongi/src/main/java/ongi/step/controller/StepController.java

@@ -0,0 +1,40 @@
+package ongi.step.controller;
+
+import lombok.RequiredArgsConstructor;
+import ongi.security.CustomUserDetails;
+import ongi.step.dto.FamilyStepResponse;
+import ongi.step.dto.StepUpsertRequest;
+import ongi.step.service.StepService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+import jakarta.validation.Valid;
+import java.util.UUID;
+
+@RestController
+@RequestMapping("/steps")
+@RequiredArgsConstructor
+public class StepController {
+    
+    private final StepService stepService;
+
+    @PostMapping
+    public ResponseEntity<Void> upsertStep(
+            @Valid @RequestBody StepUpsertRequest request,
+            @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        UUID userId = userDetails.getUser().getUuid();
+        stepService.upsertStep(userId, request);
+        return ResponseEntity.ok().build();
+    }
+
+    @GetMapping
+    public ResponseEntity<FamilyStepResponse> getFamilySteps(
+            @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        UUID userId = userDetails.getUser().getUuid();
+        FamilyStepResponse response = stepService.getFamilySteps(userId);
+        return ResponseEntity.ok(response);
+    }
+} 

backend/ongi/src/main/java/ongi/step/dto/FamilyStepResponse.java

@@ -0,0 +1,19 @@
+package ongi.step.dto;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.UUID;
+
+public record FamilyStepResponse(
+        Integer totalSteps,
+        LocalDate date,
+        List<MemberStepInfo> memberSteps
+) {
+    
+    public record MemberStepInfo(
+            UUID userId,
+            String userName,
+            Integer steps
+    ) {
+    }
+} 

backend/ongi/src/main/java/ongi/step/dto/StepUpsertRequest.java

@@ -0,0 +1,11 @@
+package ongi.step.dto;
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+
+public record StepUpsertRequest(
+        @NotNull(message = "걸음 수는 필수입니다.")
+        @Min(value = 0, message = "걸음 수는 0 이상이어야 합니다.")
+        Integer steps
+) {
+} 

backend/ongi/src/main/java/ongi/step/entity/Step.java

@@ -0,0 +1,52 @@
+package ongi.step.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+@Entity
+@Table(uniqueConstraints = {
+    @UniqueConstraint(columnNames = {"family_id", "user_id", "date"})
+})
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+@Getter
+@EntityListeners(AuditingEntityListener.class)
+public class Step {
+    
+    @Id
+    @GeneratedValue
+    @Column(nullable = false, updatable = false)
+    private Long id;
+    
+    @Column(nullable = false)
+    private String familyId;
+    
+    @Column(nullable = false)
+    private UUID userId;
+    
+    @Column(nullable = false)
+    private Integer steps;
+    
+    @Column(nullable = false)
+    private LocalDate date;
+    
+    @CreatedDate
+    @Column(updatable = false, nullable = false)
+    private LocalDateTime createdAt;
+    
+    @LastModifiedDate
+    @Column(nullable = false)
+    private LocalDateTime updatedAt;
+
+    public void updateSteps(Integer newSteps) {
+        this.steps = newSteps;
+    }
+} 

backend/ongi/src/main/java/ongi/step/repository/StepRepository.java

@@ -0,0 +1,20 @@
+package ongi.step.repository;
+
+import ongi.step.entity.Step;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+@Repository
+public interface StepRepository extends JpaRepository<Step, Long> {
+
+    List<Step> findByFamilyIdAndDate(String familyId, LocalDate date);
+
+    Optional<Step> findByFamilyIdAndUserIdAndDate(String familyId, UUID userId, LocalDate date);
+
+    Integer getTotalStepsByFamilyIdAndDate(String familyId, LocalDate date);
+} 

backend/ongi/src/main/java/ongi/step/service/StepService.java

@@ -0,0 +1,92 @@
+package ongi.step.service;
+
+import lombok.RequiredArgsConstructor;
+import ongi.exception.EntityNotFoundException;
+import ongi.family.entity.Family;
+import ongi.family.repository.FamilyRepository;
+import ongi.step.dto.FamilyStepResponse;
+import ongi.step.dto.StepUpsertRequest;
+import ongi.step.entity.Step;
+import ongi.step.repository.StepRepository;
+import ongi.user.entity.User;
+import ongi.user.repository.UserRepository;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.stream.Collectors;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class StepService {
+    
+    private final StepRepository stepRepository;
+    private final FamilyRepository familyRepository;
+    private final UserRepository userRepository;
+    
+    @Transactional
+    public void upsertStep(UUID userId, StepUpsertRequest request) {
+        Family family = familyRepository.findByMembersContains(userId)
+                .orElseThrow(() -> new EntityNotFoundException("가족을 찾을 수 없습니다."));
+        
+        String familyId = family.getCode();
+        LocalDate today = LocalDate.now();
+        
+        var existingStep = stepRepository.findByFamilyIdAndUserIdAndDate(familyId, userId, today);
+        
+        if (existingStep.isPresent()) {
+            Step step = existingStep.get();
+            step.updateSteps(request.steps());
+        } else {
+            Step newStep = Step.builder()
+                    .familyId(familyId)
+                    .userId(userId)
+                    .steps(request.steps())
+                    .date(today)
+                    .build();
+            stepRepository.save(newStep);
+        }
+    }
+    
+    public FamilyStepResponse getFamilySteps(UUID userId) {
+        Family family = familyRepository.findByMembersContains(userId)
+                .orElseThrow(() -> new EntityNotFoundException("가족을 찾을 수 없습니다."));
+        
+        String familyId = family.getCode();
+        LocalDate today = LocalDate.now();
+        
+        List<Step> familySteps = stepRepository.findByFamilyIdAndDate(familyId, today);
+        
+        Integer totalSteps = stepRepository.getTotalStepsByFamilyIdAndDate(familyId, today);
+        
+        Map<UUID, Integer> userStepMap = familySteps.stream()
+                .collect(Collectors.toMap(Step::getUserId, Step::getSteps));
+        
+        List<UUID> memberIds = family.getMembers();
+        Map<UUID, User> memberMap = userRepository.findAllById(memberIds).stream()
+                .collect(Collectors.toMap(User::getUuid, user1 -> user1));
+        
+        List<FamilyStepResponse.MemberStepInfo> memberSteps = memberIds.stream()
+                .map(memberId -> {
+                    User member = memberMap.get(memberId);
+                    Integer steps = userStepMap.getOrDefault(memberId, 0);
+                    
+                    return new FamilyStepResponse.MemberStepInfo(
+                            memberId,
+                            member.getName(),
+                            steps
+                    );
+                })
+                .collect(Collectors.toList());
+        
+        return new FamilyStepResponse(
+                totalSteps,
+                today,
+                memberSteps
+        );
+    }
+}