Skip to content

Commit 8b2e2cd

Browse files
committed
Merge branch 'improve/test-mode' into dev
2 parents e95f69e + 7ed2594 commit 8b2e2cd

2 files changed

Lines changed: 282 additions & 5 deletions

File tree

Lines changed: 261 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,261 @@
1+
import { test, expect } from "../fixtures/auth";
2+
import { mockApi } from "../helpers/mock-api";
3+
import { mockCards } from "../fixtures/mock-data";
4+
5+
/**
6+
* 시험 모드 타이머 지속성 & 이탈 세션 복원 회귀 테스트.
7+
*
8+
* 대상: src/pages/learn/test-mode.tsx, src/shared/hooks/use-timer.ts
9+
*
10+
* 기대 동작 (버그 픽스 후 GREEN, 현재는 RED):
11+
* - 시험 도중 브라우저 새로고침/탭 닫기 시 답변과 남은 시간이 보존된다.
12+
* - 재진입(새로고침 / SPA 이동 후 재진입) 시 "이전에 풀던 내역" 복원
13+
* 다이얼로그가 뜬다.
14+
* - "이어서 풀기" → 답변이 복원되고 타이머가 이어서 진행된다(전체 시간으로
15+
* 리셋되지 않음).
16+
* - "처음부터" → 답변이 초기화되고 타이머가 전체 시간으로 리셋된다.
17+
*
18+
* 알려진 근본 원인 (이 테스트가 검증하는 대상):
19+
* 1) 답변/세션 저장이 effect cleanup에만 의존 → 새로고침·탭 닫기 시
20+
* cleanup이 실행되지 않아 저장 자체가 누락됨. (pagehide/visibilitychange
21+
* 핸들러 부재)
22+
* 2) 새로고침 시 useTimer가 복원한 타이머를 mount effect의
23+
* timer.start(full)가 덮어써 초기화함.
24+
*
25+
* DEV_MOCK 제거 후 실 API 연결 상태 기준.
26+
*/
27+
28+
const GROUP_ID = 1;
29+
const CARDSET_ID = 42;
30+
const CARDSET_URL = `/groups/${GROUP_ID}/cardsets/${CARDSET_ID}`;
31+
32+
const STUDY_DEFAULTS_KEY = `flipnote-study-defaults-${CARDSET_ID}`;
33+
const SESSION_KEY = `flipnote-exam-session-${CARDSET_ID}`;
34+
const TIMER_KEY = `flipnote-timer-${CARDSET_ID}`;
35+
36+
const FULL_MINUTES = 30;
37+
const FULL_SECONDS = FULL_MINUTES * 60;
38+
39+
const MOCK_CARDS = mockCards.slice(0, 3);
40+
41+
// localStorage에 시험 모드 설정을 주입해두면 설정 화면이 시험 모드로 로드된다.
42+
const TEST_SETTINGS = {
43+
mode: "test",
44+
isUnlimitedTime: false,
45+
testTimeMinutes: FULL_MINUTES,
46+
orderType: "sequential",
47+
testMode: "all",
48+
totalCardCount: MOCK_CARDS.length,
49+
};
50+
51+
async function mockAllApis(page: Parameters<typeof mockApi>[0]) {
52+
const m = mockApi(page);
53+
54+
await m.succeed("**/api/auth/token/refresh", { success: true, data: {} });
55+
await m.succeed("**/api/users/me", {
56+
success: true,
57+
data: {
58+
userId: 1,
59+
nickname: "테스터",
60+
email: "test@test.com",
61+
phone: "",
62+
smsAgree: false,
63+
profileImageUrl: "",
64+
},
65+
});
66+
await m.succeed(`**/api/card-sets/${CARDSET_ID}`, {
67+
success: true,
68+
data: {
69+
id: CARDSET_ID,
70+
name: "테스트 카드셋",
71+
groupId: GROUP_ID,
72+
visibility: "PUBLIC",
73+
category: "IT",
74+
hashtag: "",
75+
imageRefId: 0,
76+
imageUrl: "",
77+
cardCount: MOCK_CARDS.length,
78+
likeCount: 0,
79+
bookmarkCount: 0,
80+
createdAt: "2024-01-01T00:00:00",
81+
updatedAt: "2024-01-01T00:00:00",
82+
liked: false,
83+
bookmarked: false,
84+
managers: [],
85+
},
86+
});
87+
await m.succeed(`**/api/card-sets/${CARDSET_ID}/cards`, {
88+
success: true,
89+
data: MOCK_CARDS,
90+
});
91+
await m.succeed(`**/api/groups/${GROUP_ID}`, {
92+
success: true,
93+
data: {
94+
groupId: GROUP_ID,
95+
name: "테스트 그룹",
96+
category: "IT",
97+
description: "",
98+
joinPolicy: "OPEN",
99+
visibility: "PUBLIC",
100+
maxMember: 10,
101+
imageUrl: "",
102+
createdAt: "2024-01-01T00:00:00",
103+
modifiedAt: "2024-01-01T00:00:00",
104+
},
105+
});
106+
await m.succeed(`**/api/groups/${GROUP_ID}/members`, {
107+
success: true,
108+
data: { memberInfoList: [] },
109+
});
110+
await m.succeed(`**/api/groups/${GROUP_ID}/permissions`, {
111+
success: true,
112+
data: { role: "MEMBER", permissions: [] },
113+
});
114+
}
115+
116+
/** 설정 화면(시험 모드) → "학습 시작" → 시험 화면 진입까지 이동 */
117+
async function navigateToTestMode(page: Parameters<typeof mockApi>[0]) {
118+
await page.addInitScript(
119+
({ key, value, sessionKey, timerKey }) => {
120+
localStorage.setItem(key, JSON.stringify(value));
121+
// 이전 테스트/세션 잔여 상태 제거
122+
sessionStorage.removeItem(sessionKey);
123+
sessionStorage.removeItem(timerKey);
124+
},
125+
{
126+
key: STUDY_DEFAULTS_KEY,
127+
value: TEST_SETTINGS,
128+
sessionKey: SESSION_KEY,
129+
timerKey: TIMER_KEY,
130+
},
131+
);
132+
await mockAllApis(page);
133+
134+
await page.goto(CARDSET_URL);
135+
await page.waitForSelector("text=학습 모드 선택");
136+
137+
await Promise.all([
138+
page.waitForURL(/cardsets\/learning/, { timeout: 5000 }),
139+
page.getByRole("button", { name: "학습 시작" }).click(),
140+
]);
141+
142+
// 카드 로드 완료 = 답변 입력란 노출
143+
await expect(page.getByPlaceholder("답변을 입력하세요").first()).toBeVisible();
144+
}
145+
146+
/** sessionStorage의 타이머 키에서 남은 시간(초)을 계산해 읽는다. */
147+
const readTimerRemaining = (page: Parameters<typeof mockApi>[0]) =>
148+
page.evaluate((key) => {
149+
const raw = sessionStorage.getItem(key);
150+
if (!raw) return null;
151+
try {
152+
const s = JSON.parse(raw) as
153+
| { status: "running"; endTime: number }
154+
| { status: "paused"; remainingMs: number };
155+
if (s.status === "running") return (s.endTime - Date.now()) / 1000;
156+
if (s.status === "paused") return s.remainingMs / 1000;
157+
} catch {
158+
return null;
159+
}
160+
return null;
161+
}, TIMER_KEY);
162+
163+
const restoreDialog = (page: Parameters<typeof mockApi>[0]) =>
164+
page.getByRole("dialog", { name: "이전 시험 내역" });
165+
166+
const firstAnswer = (page: Parameters<typeof mockApi>[0]) =>
167+
page.getByPlaceholder("답변을 입력하세요").first();
168+
169+
const ANSWER_TEXT = "내가 작성한 답변입니다";
170+
171+
test.describe("시험 모드 — 타이머 지속성 & 이탈 세션 복원", () => {
172+
test("새로고침 시 복원 다이얼로그가 나타난다", async ({
173+
authenticatedPage: page,
174+
}) => {
175+
await navigateToTestMode(page);
176+
177+
await firstAnswer(page).fill(ANSWER_TEXT);
178+
// 타이머가 최소 1초 이상 진행되도록 대기 (남은 시간 보존 확인용)
179+
await page.waitForTimeout(2000);
180+
181+
await page.reload();
182+
183+
await expect(restoreDialog(page)).toBeVisible();
184+
});
185+
186+
test("'이어서 풀기' 시 답변이 복원되고 타이머가 초기화되지 않는다", async ({
187+
authenticatedPage: page,
188+
}) => {
189+
await navigateToTestMode(page);
190+
191+
await firstAnswer(page).fill(ANSWER_TEXT);
192+
await page.waitForTimeout(2000);
193+
194+
// 새로고침 직전 남은 시간(이미 일부 소요되어 전체 시간보다 작아야 함)
195+
const before = await readTimerRemaining(page);
196+
expect(before).not.toBeNull();
197+
expect(before!).toBeLessThan(FULL_SECONDS);
198+
199+
await page.reload();
200+
201+
await expect(restoreDialog(page)).toBeVisible();
202+
await page.getByRole("button", { name: "이어서 풀기" }).click();
203+
await expect(restoreDialog(page)).toBeHidden();
204+
205+
// 답변 복원
206+
await expect(firstAnswer(page)).toHaveValue(ANSWER_TEXT);
207+
208+
// 타이머가 전체 시간으로 리셋되지 않고 이어짐 (복원값 근처, +tolerance 이내)
209+
const after = await readTimerRemaining(page);
210+
expect(after).not.toBeNull();
211+
expect(after!).toBeLessThanOrEqual(before! + 2);
212+
});
213+
214+
test("'처음부터' 시 답변이 초기화되고 타이머가 리셋된다", async ({
215+
authenticatedPage: page,
216+
}) => {
217+
await navigateToTestMode(page);
218+
219+
await firstAnswer(page).fill(ANSWER_TEXT);
220+
await page.waitForTimeout(2000);
221+
222+
await page.reload();
223+
224+
await expect(restoreDialog(page)).toBeVisible();
225+
await page.getByRole("button", { name: "처음부터" }).click();
226+
await expect(restoreDialog(page)).toBeHidden();
227+
228+
// 답변 초기화
229+
await expect(firstAnswer(page)).toHaveValue("");
230+
231+
// 타이머 전체 시간으로 재시작
232+
const remaining = await readTimerRemaining(page);
233+
expect(remaining).not.toBeNull();
234+
expect(remaining!).toBeGreaterThan(FULL_SECONDS - 5);
235+
});
236+
237+
test("SPA 이동 후 재진입 시 복원 다이얼로그가 나타나고 답변이 복원된다", async ({
238+
authenticatedPage: page,
239+
}) => {
240+
await navigateToTestMode(page);
241+
242+
await firstAnswer(page).fill(ANSWER_TEXT);
243+
await page.waitForTimeout(1000);
244+
245+
// 앱 내 뒤로가기(SPA) → 설정 화면으로 이탈
246+
await page.goBack();
247+
await page.waitForSelector("text=학습 모드 선택");
248+
249+
// 다시 학습 시작 → 시험 화면 재진입
250+
await Promise.all([
251+
page.waitForURL(/cardsets\/learning/, { timeout: 5000 }),
252+
page.getByRole("button", { name: "학습 시작" }).click(),
253+
]);
254+
255+
await expect(restoreDialog(page)).toBeVisible();
256+
await page.getByRole("button", { name: "이어서 풀기" }).click();
257+
await expect(restoreDialog(page)).toBeHidden();
258+
259+
await expect(firstAnswer(page)).toHaveValue(ANSWER_TEXT);
260+
});
261+
});

‎src/pages/learn/test-mode.tsx‎

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,7 @@ type ExamSession = {
3939
answers: Answer[];
4040
};
4141

42+
/** move to utils. */
4243
const formatTime = (seconds: number) => {
4344
const total = Math.floor(seconds);
4445
const hours = Math.floor(total / 3600);
@@ -161,21 +162,28 @@ const TestMode = () => {
161162
},
162163
});
163164

164-
// 타이머 시작 — 복원 다이얼로그가 없을 때만 바로 시작
165+
// 타이머 시작 및 이탈 시 상태 저장
166+
// - 최초 진입에서만 새 타이머 시작. 복원 다이얼로그가 열려 있거나 이미
167+
// 진행 중인 타이머(timerKey)가 있으면 useTimer의 복원값을 덮어쓰지 않음.
168+
// - SPA 이동은 effect cleanup, 새로고침·탭 닫기는 pagehide로 동일하게 저장.
165169
useEffect(() => {
166-
if (!isUnlimitedTime && !restoreDialogOpen) {
170+
const hasPersistedTimer = !!sessionStorage.getItem(timerKey);
171+
if (!isUnlimitedTime && !restoreDialogOpen && !hasPersistedTimer) {
167172
timer.start(testDurationMinutes * 60);
168173
}
169174

170-
return () => {
175+
const finalizeOnLeave = () => {
171176
// 제출 완료 시에만 세션 삭제
172177
if (submittedRef.current || phaseRef.current === "grading") {
173178
timer.stop();
174179
sessionStorage.removeItem(savedSessionKey);
175180
return;
176181
}
177182

178-
// 이탈: 답변이 있으면 세션 업데이트, 없으면 기존 세션 유지 (삭제하지 않음)
183+
// 이탈: 답변이 있을 때만 세션과 타이머 상태를 함께 보존한다.
184+
// pauseAndKeep을 무조건 호출하면 StrictMode 이중 마운트나 답변 없는
185+
// 이탈에서 timerKey가 paused로 덮여, hasPersistedTimer 가드가 start()를
186+
// 막은 채 멈춘 타이머로 복원되는 문제가 생긴다.
179187
const hasProgress = answersRef.current.some(
180188
(a) => a.userAnswer.trim().length > 0,
181189
);
@@ -184,8 +192,16 @@ const TestMode = () => {
184192
savedSessionKey,
185193
JSON.stringify({ answers: answersRef.current } satisfies ExamSession),
186194
);
195+
timer.pauseAndKeep();
187196
}
188-
timer.pauseAndKeep();
197+
};
198+
199+
// 새로고침·탭 닫기 시엔 React cleanup이 실행되지 않으므로 pagehide로 저장
200+
window.addEventListener("pagehide", finalizeOnLeave);
201+
202+
return () => {
203+
window.removeEventListener("pagehide", finalizeOnLeave);
204+
finalizeOnLeave();
189205
};
190206
// eslint-disable-next-line react-hooks/exhaustive-deps
191207
}, []);

0 commit comments

Comments
 (0)