feat: 순공 시간 랭킹 조회 API 구현

[dh2906]

🔍 개요

• 이슈

---

🚀 주요 변경 내용

• GET /studytimes/rankings 엔드포인트를 추가했습니다.

• 페이지네이션으로 동아리, 학번, 개인별 랭킹을 조회합니다.

• 랭킹 기준은 일, 월 별로 나뉘며, 시간이 동일한 경우 다른 기준으로 조회하고 이마저도 동일하다면 id를 기준으로 순위를 구합니다.

• 개인별 랭킹의 경우 이름을 마스킹 처리 합니다. ex) 김 -> 김 / 김철 -> 김* / 김철수 -> 김*수 / 김철철수 -> 김**수

• 각 랭킹별 테이블을 분리해야 하나 고민했는데, 그렇게 되면 테이블 구조가 더러워질 것 같아 하나의 테이블에 복합키로 구분지을 수 있도록 했습니다.

---

💬 참고 사항

• 다음 작업은 내 랭킹 조회, 랭킹 집계 스케줄링 처리를 진행할 예정입니다.

• 아래는 테스트를 위한 더미 데이터 생성 프로시저입니다. 개인별 랭킹만 추가하므로 참고바랍니다.

DELIMITER $$

CREATE PROCEDURE seed_study_time_ranking_1000()
BEGIN
    DECLARE i INT DEFAULT 1;

    WHILE i <= 1000 DO
        INSERT INTO study_time_ranking (
            ranking_type,
            target_id,
            target_name,
            daily_seconds,
            monthly_seconds
        ) VALUES
        (
            'PERSONAL',
            CONCAT('user_', i),
            CONCAT('사용자', i),
            FLOOR(RAND() * 10000),
            FLOOR(RAND() * 300000)
        );
        SET i = i + 1;
    END WHILE;
END$$

DELIMITER ;

CALL seed_study_time_ranking_1000();

---

✅ Checklist (완료 조건)

• 코드 스타일 가이드 준수
• 테스트 코드 포함됨
• Reviewers / Assignees / Labels 지정 완료
• 보안 및 민감 정보 검증 (API 키, 환경 변수, 개인정보 등)

[Soundbar91]

고생하셨습니다

[Soundbar91]

R

해당 로직은 논의가 필요해 보입니다. 일간 랭킹인데 월간 랭킹이 영향을 미치는 건 조금 적절하지 않다고 생각합니다.
동일 등수로 하거나, 정렬 기준을 독립적으로 가져가는 게 좋아보여요

[dh2906]

공동 등수를 적용 한다면 페이지네이션으로 조회할 때 등수를 매기기 까다로워서 위와 같은 방식을 채택했습니다.

일간 랭킹에서 두 유저간의 일간 공부 시간이 동일하다면 등수를 동일하게 두기보다 다음 기준인 월간 공부 시간으로 구해야하지 않나? 라는 생각입니다.

이건 오늘 회의에 안건으로 꺼내봐야 할 것 같습니다!

[Soundbar91]

C

랭킹 테이블을 분리하신 이유가 있으실까요 👀 일간, 월간 데이터를 가지고 쿼리로 집계해서 가져오는 게 깔끔하지 않나 라는 생각을 했습니다.

실시간성이 필요한지는 논의를 해봐야할 거 같은데, 만약 실시간성이 중요하다면 스케쥴링 주기를 타이트하게 가져가야하고 그렇지 않다면 스케쥴링 주기를 얼마로 가져갈지 정해야할 거 같아요. 앱에다가 X분 주기로 업데이트가 된다라는 메시지도 보여줘야할 거 같구요.

[dh2906]

랭킹 테이블을 분리하지 않는다면 매 요청에 따라 매번 시간 데이터에서 순위를 집계해야 하는데, 너무 비효율적이라 판단했습니다.

사실 실시간이라고 하기도 애매한게 타이머를 종료시켜야 시간이 누적되기에 굳이 실시간으로 할 필요가 없다면 자정마다 스케줄링을 돌려 전 날의 랭킹을 보여주도록 하는 것도 나쁘지 않다고 생각합니다.

이것도 오늘 회의에 얘기를 해봐야 할 것 같아요

[dh2906]

변경사항

• 랭킹 타입을 enum에서 테이블로 분리했습니다.

• 그에 따라 랭킹 조회 시 Type을 문자열로 받도록 수정했습니다. (CLUB, STUDENT_NUMBER, PERSONAL)

• 랭킹은 유저가 속한 대학 범위에서만 조회할 수 있도록 랭킹 테이블에 university_id 컬럼을 추가했습니다.