feat: 신규 가입자 추이 응답에 기간 전체 합계(totalCount) 추가

Author: si-zero

docs/api-specs/dashboard-api.md

@@ -110,12 +110,15 @@
 
 `granularity=week`일 때 각 항목의 `date`는 그 주의 시작일(월요일)입니다.
 
+`totalCount`는 `from`~`to` 구간 전체의 정확한 합계입니다. `granularity=week`로 조회하면 주 경계가 `from`/`to`를 벗어나는 날짜까지 포함할 수 있어(예: `to`가 주 중간이면 그 주 전체가 한 항목으로 잡힘) `items`의 `count`를 그냥 더한 값과 `totalCount`가 다를 수 있습니다 — **임의 기간의 정확한 합계가 필요하면 `granularity` 값과 무관하게 `totalCount`를 사용하세요.**
+
 성공 응답 `200 OK` (`granularity=day`):
 
 ```json
 {
   "statusCode": 200,
   "data": {
+    "totalCount": 20,
     "items": [
       { "date": "2026-08-01", "count": 12 },
       { "date": "2026-08-02", "count": 8 }
@@ -131,6 +134,7 @@
 {
   "statusCode": 200,
   "data": {
+    "totalCount": 130,
     "items": [
       { "date": "2026-07-27", "count": 65 },
       { "date": "2026-08-03", "count": 71 }

src/main/java/com/swyp/picke/domain/admin/dto/dashboard/response/AdminDashboardNewUsersResponse.java

@@ -3,5 +3,6 @@
 import java.util.List;
 
 public record AdminDashboardNewUsersResponse(
+        long totalCount,
         List<AdminDashboardTrendItemResponse> items
 ) {}

src/main/java/com/swyp/picke/domain/admin/service/AdminDashboardService.java

@@ -67,6 +67,10 @@ public AdminDashboardNewUsersResponse getNewUsersTrend(LocalDate from, LocalDate
                 .map(row -> new AdminDashboardTrendItemResponse(row.getActivityDate(), row.getCount()))
                 .toList();
 
-        return new AdminDashboardNewUsersResponse(items);
+        // week 단위 items는 주 경계가 from~to 범위를 벗어날 수 있어(예: to가 주 중간이면 그 주 전체를 포함),
+        // 요청한 기간 전체의 정확한 합계는 items 합산이 아니라 별도 카운트로 계산한다.
+        long totalCount = userRepository.countByCreatedAtBetween(from.atStartOfDay(), to.plusDays(1).atStartOfDay());
+
+        return new AdminDashboardNewUsersResponse(totalCount, items);
     }
 }

src/test/java/com/swyp/picke/domain/admin/service/AdminDashboardServiceTest.java

@@ -103,11 +103,13 @@ void getNewUsersTrend_day_returnsDailyCounts() {
                 dailyUserCount(LocalDate.of(2026, 8, 2), 5L)
         );
         when(userRepository.findDailyNewUserCounts(from, to)).thenReturn(rows);
+        when(userRepository.countByCreatedAtBetween(any(), any())).thenReturn(8L);
 
         var response = adminDashboardService.getNewUsersTrend(from, to, "day");
 
         assertThat(response.items()).hasSize(2);
         assertThat(response.items().get(1).count()).isEqualTo(5L);
+        assertThat(response.totalCount()).isEqualTo(8L);
     }
 
     @Test
@@ -117,11 +119,13 @@ void getNewUsersTrend_week_returnsWeeklyCounts() {
         LocalDate to = LocalDate.of(2026, 8, 14);
         List<DailyUserCount> rows = List.of(dailyUserCount(LocalDate.of(2026, 7, 27), 20L));
         when(userRepository.findWeeklyNewUserCounts(from, to)).thenReturn(rows);
+        when(userRepository.countByCreatedAtBetween(any(), any())).thenReturn(18L);
 
         var response = adminDashboardService.getNewUsersTrend(from, to, "week");
 
         assertThat(response.items()).hasSize(1);
         assertThat(response.items().get(0).count()).isEqualTo(20L);
+        assertThat(response.totalCount()).isEqualTo(18L);
     }
 
     @Test