[FIX] 반복 투두를 오늘이 아닌 날짜에서 재생해도 해당 날짜에 귀속되도록 수정

apps/timo-web/api/generated/endpoints/timer/timer.ts

@@ -17,6 +17,7 @@ import type {
   BaseResponseTimerStartResponse,
   BaseResponseTimerStatusResponse,
   ErrorDto,
+  StartTimerParams,
   TimerActionRequest,
   TimerExtendRequest,
 } from "../../models";
@@ -59,17 +60,23 @@ const withQueryKey = <T extends object, K>(
  * 투두의 타이머를 시작합니다.
  * 한 번에 한 개의 타이머만 실행 가능하며, 이미 실행/일시정지 중인 타이머가 있으면 409를 반환합니다.
  *
- * 응답의 date는 타이머가 귀속되는 날짜(사용자 시간대 기준 시작일)입니다.
  * 반복 투두는 여러 날짜에 같은 todoId로 노출되므로, 실행중 표시는 todoId가 아닌 (todoId, date) 조합으로 구분해야 합니다.
+ * 쿼리 파라미터 date로 타이머가 상태를 반영할 대상 날짜를 지정할 수 있으며(미래/과거 포함), 미지정 시 사용자 타임존 기준 오늘로 처리됩니다. 이후 일시정지/재개/완료/중지는 이 날짜를 그대로 사용합니다.
  * @summary 타이머 시작
  */
 export const startTimer = (
   todoId: number,
+  params?: StartTimerParams,
   options?: SecondParameter<typeof customInstance>,
   signal?: AbortSignal,
 ) => {
   return customInstance<BaseResponseTimerStartResponse>(
-    { url: `/api/v1/todos/${todoId}/timers/start`, method: "POST", signal },
+    {
+      url: `/api/v1/todos/${todoId}/timers/start`,
+      method: "POST",
+      params,
+      signal,
+    },
     options,
   );
 };
@@ -81,14 +88,14 @@ export const getStartTimerMutationOptions = <
   mutation?: UseMutationOptions<
     Awaited<ReturnType<typeof startTimer>>,
     TError,
-    { todoId: number },
+    { todoId: number; params?: StartTimerParams },
     TContext
   >;
   request?: SecondParameter<typeof customInstance>;
 }): UseMutationOptions<
   Awaited<ReturnType<typeof startTimer>>,
   TError,
-  { todoId: number },
+  { todoId: number; params?: StartTimerParams },
   TContext
 > => {
   const mutationKey = ["startTimer"];
@@ -102,11 +109,11 @@ export const getStartTimerMutationOptions = <
 
   const mutationFn: MutationFunction<
     Awaited<ReturnType<typeof startTimer>>,
-    { todoId: number }
+    { todoId: number; params?: StartTimerParams }
   > = (props) => {
-    const { todoId } = props ?? {};
+    const { todoId, params } = props ?? {};
 
-    return startTimer(todoId, requestOptions);
+    return startTimer(todoId, params, requestOptions);
   };
 
   return { mutationFn, ...mutationOptions };
@@ -126,7 +133,7 @@ export const useStartTimer = <TError = ErrorType<ErrorDto>, TContext = unknown>(
     mutation?: UseMutationOptions<
       Awaited<ReturnType<typeof startTimer>>,
       TError,
-      { todoId: number },
+      { todoId: number; params?: StartTimerParams },
       TContext
     >;
     request?: SecondParameter<typeof customInstance>;
@@ -135,7 +142,7 @@ export const useStartTimer = <TError = ErrorType<ErrorDto>, TContext = unknown>(
 ): UseMutationResult<
   Awaited<ReturnType<typeof startTimer>>,
   TError,
-  { todoId: number },
+  { todoId: number; params?: StartTimerParams },
   TContext
 > => {
   return useMutation(getStartTimerMutationOptions(options), queryClient);

apps/timo-web/api/generated/endpoints/timer/timer.zod.ts

@@ -11,14 +11,21 @@ import * as zod from "zod";
  * 투두의 타이머를 시작합니다.
  * 한 번에 한 개의 타이머만 실행 가능하며, 이미 실행/일시정지 중인 타이머가 있으면 409를 반환합니다.
  *
- * 응답의 date는 타이머가 귀속되는 날짜(사용자 시간대 기준 시작일)입니다.
  * 반복 투두는 여러 날짜에 같은 todoId로 노출되므로, 실행중 표시는 todoId가 아닌 (todoId, date) 조합으로 구분해야 합니다.
+ * 쿼리 파라미터 date로 타이머가 상태를 반영할 대상 날짜를 지정할 수 있으며(미래/과거 포함), 미지정 시 사용자 타임존 기준 오늘로 처리됩니다. 이후 일시정지/재개/완료/중지는 이 날짜를 그대로 사용합니다.
  * @summary 타이머 시작
  */
 export const StartTimerParams = zod.object({
   todoId: zod.number().describe("타이머를 시작할 투두 ID"),
 });
 
+export const StartTimerQueryParams = zod.object({
+  date: zod.iso
+    .date()
+    .optional()
+    .describe("타이머가 상태를 반영할 대상 날짜(미지정 시 오늘). ISO 형식"),
+});
+
 export const StartTimerResponse = zod.object({
   status: zod.number().optional(),
   message: zod.string().optional(),

apps/timo-web/api/generated/models/index.ts

@@ -61,6 +61,7 @@ export * from "./recommendDurationRequest";
 export * from "./recommendDurationResponse";
 export * from "./repeatResponse";
 export * from "./repeatResponseWeekdaysItem";
+export * from "./startTimerParams";
 export * from "./statisticsCalendarResponse";
 export * from "./statisticsDailyResponse";
 export * from "./statisticsSummaryResponse";

apps/timo-web/api/generated/models/startTimerParams.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.20.0 🍺
+ * Do not edit manually.
+ * Timo API
+ * Timo 서버 API 명세서
+ * OpenAPI spec version: v1
+ */
+
+export interface StartTimerParams {
+  /**
+   * 타이머가 상태를 반영할 대상 날짜(미지정 시 오늘). ISO 형식
+   */
+  date?: string;
+}

apps/timo-web/app/[locale]/(main)/(with-time-sidebar)/home/_hooks/use-home-todos-by-date.ts

@@ -209,7 +209,7 @@ export const useHomeTodosByDate = (
     }
 
     startTimer(
-      { todoId },
+      { todoId, params: { date: dateKey } },
       {
         onSuccess: () => invalidateTodoDetail(dateKey, todoId),
         onError: (error: ApiError) => {

apps/timo-web/app/[locale]/(main)/(with-time-sidebar)/today/_hooks/useTodayTodoList.ts

@@ -194,7 +194,7 @@ export const useTodayTodoList = (
     }
 
     startTimer(
-      { todoId },
+      { todoId, params: { date: dateKey } },
       {
         onSuccess: () => invalidateTodoDetail(todoId, dateKey),
         onError: (error: ErrorType<ErrorDto>) => {

apps/timo-web/app/[locale]/(main)/focus/_hooks/use-focus-session.ts

@@ -178,7 +178,9 @@ export const useFocusSession = ({
     stopTimer,
     changeTodoStatus,
     onNoTimer: () => {
-      if (todo) startTimer({ todoId: todo.todoId });
+      if (todo) {
+        startTimer({ todoId: todo.todoId, params: { date: focusView.date } });
+      }
     },
   });