From 9ff334a6c1a3cfb4f30aff6e2c5adaef753f0957 Mon Sep 17 00:00:00 2001
From: jhan0121 <jhan0121@gmail.com>
Date: Mon, 2 Mar 2026 16:28:56 +0900
Subject: [PATCH 1/2] =?UTF-8?q?feat:=20=EC=95=8C=EB=A6=BC=20=EC=8B=9C?=
 =?UTF-8?q?=EA=B0=84=20=EC=84=A4=EC=A0=95=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 public/popup.html            | 11 ++++++
 src/api.js                   | 28 +++++++++++++++
 src/handlers/device.js       |  1 +
 src/handlers/index.js        |  3 ++
 src/handlers/notification.js | 69 ++++++++++++++++++++++++++++++++++++
 src/popup.js                 |  6 +++-
 src/ui/elements.js           |  8 +++++
 src/ui/views.js              |  1 +
 8 files changed, 126 insertions(+), 1 deletion(-)
 create mode 100644 src/handlers/notification.js

diff --git a/public/popup.html b/public/popup.html
index ad77867..e5b1515 100644
--- a/public/popup.html
+++ b/public/popup.html
@@ -70,6 +70,17 @@ <h3>나의 복습 주기</h3>
         <button id="cycle-add-btn" class="btn btn-secondary btn-small">+ 새 주기 추가</button>
       </div>
 
+      <button id="notification-time-btn" class="btn btn-secondary">알림 시간 설정</button>
+
+      <div id="notification-section" class="hidden">
+        <h3>알림 시간</h3>
+        <div class="form-group">
+          <label for="notification-time-input">매일 알림 받을 시간</label>
+          <input type="time" id="notification-time-input">
+        </div>
+        <button id="notification-time-save-btn" class="btn btn-primary btn-small">저장</button>
+      </div>
+
       <button id="show-devices-btn" class="btn btn-secondary">디바이스 관리</button>
 
       <div id="devices-section" class="hidden">
diff --git a/src/api.js b/src/api.js
index 5660700..ecd7784 100644
--- a/src/api.js
+++ b/src/api.js
@@ -148,3 +148,31 @@ export async function deleteCustomCycle(identifier, id) {
     headers: { 'X-Device-Id': identifier }
   });
 }
+
+/**
+ * 알림 시간 조회
+ * @param {string} identifier - 디바이스 식별자
+ * @returns {Promise<Object>} { notificationTime: "09:00:00" } or { notificationTime: null }
+ */
+export async function getNotificationTime(identifier) {
+  return await sendApiRequest({
+    endpoint: '/api/v1/members/notification-time',
+    method: 'GET',
+    headers: { 'X-Device-Id': identifier }
+  });
+}
+
+/**
+ * 알림 시간 업데이트
+ * @param {string} identifier - 디바이스 식별자
+ * @param {number} hour - 시 (0-23)
+ * @param {number} minute - 분 (0-59)
+ */
+export async function updateNotificationTime(identifier, hour, minute) {
+  return await sendApiRequest({
+    endpoint: '/api/v1/members/notification-time',
+    method: 'PATCH',
+    headers: { 'X-Device-Id': identifier },
+    body: { notificationTime: [hour, minute] }
+  });
+}
diff --git a/src/handlers/device.js b/src/handlers/device.js
index fb8c806..33d6390 100644
--- a/src/handlers/device.js
+++ b/src/handlers/device.js
@@ -139,6 +139,7 @@ export async function handleLogout() {
   elements.saveResult.classList.add('hidden');
   elements.devicesSection.classList.add('hidden');
   elements.cycleSection.classList.add('hidden');
+  elements.notificationSection.classList.add('hidden');
   showView('login');
   showMessage('로그아웃 되었습니다.', 'info');
 }
diff --git a/src/handlers/index.js b/src/handlers/index.js
index db65c28..d673f8b 100644
--- a/src/handlers/index.js
+++ b/src/handlers/index.js
@@ -24,3 +24,6 @@ export {
 
 // URL 저장 관련
 export { handleSaveUrl } from './url.js';
+
+// 알림 시간 관련
+export { handleShowNotificationTime, handleUpdateNotificationTime } from './notification.js';
diff --git a/src/handlers/notification.js b/src/handlers/notification.js
new file mode 100644
index 0000000..2e7df38
--- /dev/null
+++ b/src/handlers/notification.js
@@ -0,0 +1,69 @@
+/**
+ * 알림 시간 관련 핸들러
+ *
+ * 알림 시간 조회 및 업데이트 처리를 담당한다.
+ */
+
+import { getNotificationTime, updateNotificationTime } from '../api.js';
+import { validateStorageForAuth } from '../storage.js';
+import {
+  elements,
+  showLoading,
+  hideLoading,
+  showMessage,
+  handleApiError
+} from '../ui/index.js';
+
+/**
+ * 알림 시간 설정 버튼 클릭 핸들러 (toggle)
+ */
+export async function handleShowNotificationTime() {
+  const isVisible = !elements.notificationSection.classList.contains('hidden');
+
+  if (isVisible) {
+    elements.notificationSection.classList.add('hidden');
+    return;
+  }
+
+  try {
+    showLoading();
+    const storageData = await validateStorageForAuth();
+    const result = await getNotificationTime(storageData.identifier);
+
+    if (result.notificationTime) {
+      elements.notificationTimeInput.value = result.notificationTime.substring(0, 5);
+    } else {
+      elements.notificationTimeInput.value = '';
+    }
+
+    elements.notificationSection.classList.remove('hidden');
+  } catch (error) {
+    await handleApiError(error);
+  } finally {
+    hideLoading();
+  }
+}
+
+/**
+ * 알림 시간 저장 버튼 클릭 핸들러
+ */
+export async function handleUpdateNotificationTime() {
+  const timeValue = elements.notificationTimeInput.value;
+
+  if (!timeValue) {
+    showMessage('알림 시간을 입력해주세요.', 'error');
+    return;
+  }
+
+  try {
+    showLoading();
+    const storageData = await validateStorageForAuth();
+    const [hour, minute] = timeValue.split(':').map(Number);
+    await updateNotificationTime(storageData.identifier, hour, minute);
+    showMessage('알림 시간이 저장되었습니다.', 'success');
+  } catch (error) {
+    await handleApiError(error);
+  } finally {
+    hideLoading();
+  }
+}
diff --git a/src/popup.js b/src/popup.js
index bcf4f1c..12292ff 100644
--- a/src/popup.js
+++ b/src/popup.js
@@ -26,7 +26,9 @@ import {
   handleDeleteCycle,
   handleEditCycle,
   handleAddCycle,
-  handleAddDuration
+  handleAddDuration,
+  handleShowNotificationTime,
+  handleUpdateNotificationTime
 } from './handlers/index.js';
 
 /**
@@ -37,6 +39,8 @@ function setupEventListeners() {
   elements.checkAuthBtn.addEventListener('click', handleCheckAuth);
   elements.resetBtn.addEventListener('click', handleReset);
   elements.saveUrlBtn.addEventListener('click', handleSaveUrl);
+  elements.notificationTimeBtn.addEventListener('click', handleShowNotificationTime);
+  elements.notificationTimeSaveBtn.addEventListener('click', handleUpdateNotificationTime);
   elements.showDevicesBtn.addEventListener('click', handleShowDevices);
   elements.logoutBtn.addEventListener('click', handleLogout);
 
diff --git a/src/ui/elements.js b/src/ui/elements.js
index 8badbfe..0564a44 100644
--- a/src/ui/elements.js
+++ b/src/ui/elements.js
@@ -32,6 +32,10 @@ export const elements = {
   cycleSection: null,
   cycleList: null,
   cycleAddBtn: null,
+  notificationTimeBtn: null,
+  notificationSection: null,
+  notificationTimeInput: null,
+  notificationTimeSaveBtn: null,
   showDevicesBtn: null,
   devicesSection: null,
   devicesList: null,
@@ -76,6 +80,10 @@ export function initializeElements() {
   elements.cycleSection = document.getElementById('cycle-section');
   elements.cycleList = document.getElementById('cycle-list');
   elements.cycleAddBtn = document.getElementById('cycle-add-btn');
+  elements.notificationTimeBtn = document.getElementById('notification-time-btn');
+  elements.notificationSection = document.getElementById('notification-section');
+  elements.notificationTimeInput = document.getElementById('notification-time-input');
+  elements.notificationTimeSaveBtn = document.getElementById('notification-time-save-btn');
   elements.showDevicesBtn = document.getElementById('show-devices-btn');
   elements.devicesSection = document.getElementById('devices-section');
   elements.devicesList = document.getElementById('devices-list');
diff --git a/src/ui/views.js b/src/ui/views.js
index b3e3f09..e10a249 100644
--- a/src/ui/views.js
+++ b/src/ui/views.js
@@ -38,6 +38,7 @@ export async function forceLogout(message) {
   await clearStorage();
   elements.saveResult.classList.add('hidden');
   elements.devicesSection.classList.add('hidden');
+  elements.notificationSection.classList.add('hidden');
   elements.emailInput.value = '';
   showView('login');
 

From 38f6c0148ea59b5b07635c04386e2bc180ebb70c Mon Sep 17 00:00:00 2001
From: jhan0121 <jhan0121@gmail.com>
Date: Mon, 2 Mar 2026 16:40:58 +0900
Subject: [PATCH 2/2] =?UTF-8?q?test:=20=EC=95=8C=EB=A6=BC=20=EC=8B=9C?=
 =?UTF-8?q?=EA=B0=84=20=EC=84=A4=EC=A0=95=20api=20=ED=85=8C=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/__tests__/api.test.js | 53 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/src/__tests__/api.test.js b/src/__tests__/api.test.js
index b9f6e55..6b6a0eb 100644
--- a/src/__tests__/api.test.js
+++ b/src/__tests__/api.test.js
@@ -7,7 +7,9 @@ import {
   getCycleOptions,
   createCustomCycle,
   updateCustomCycle,
-  deleteCustomCycle
+  deleteCustomCycle,
+  getNotificationTime,
+  updateNotificationTime
 } from '../api.js';
 import { ERROR_CODES } from '../constants.js';
 
@@ -222,6 +224,55 @@ describe('api.js', () => {
     });
   });
 
+  describe('getNotificationTime', () => {
+    it('식별자를 헤더에 포함하여 알림 시간을 조회한다', async () => {
+      const identifier = 'my-device-id';
+      const mockResponse = { success: true, data: { notificationTime: '09:00:00' } };
+      sendMessageMock.mockResolvedValue(mockResponse);
+
+      const result = await getNotificationTime(identifier);
+
+      expect(sendMessageMock).toHaveBeenCalledWith({
+        type: 'API_REQUEST',
+        request: {
+          endpoint: '/api/v1/members/notification-time',
+          method: 'GET',
+          headers: { 'X-Device-Id': identifier }
+        }
+      });
+      expect(result).toEqual(mockResponse.data);
+    });
+
+    it('알림 시간이 설정되지 않은 경우 null을 반환한다', async () => {
+      const mockResponse = { success: true, data: { notificationTime: null } };
+      sendMessageMock.mockResolvedValue(mockResponse);
+
+      const result = await getNotificationTime('my-device-id');
+
+      expect(result.notificationTime).toBeNull();
+    });
+  });
+
+  describe('updateNotificationTime', () => {
+    it('[hour, minute] 배열로 알림 시간을 업데이트한다', async () => {
+      const identifier = 'my-device-id';
+      const mockResponse = { success: true, data: null };
+      sendMessageMock.mockResolvedValue(mockResponse);
+
+      await updateNotificationTime(identifier, 9, 0);
+
+      expect(sendMessageMock).toHaveBeenCalledWith({
+        type: 'API_REQUEST',
+        request: {
+          endpoint: '/api/v1/members/notification-time',
+          method: 'PATCH',
+          headers: { 'X-Device-Id': identifier },
+          body: { notificationTime: [9, 0] }
+        }
+      });
+    });
+  });
+
   describe('Error Handling', () => {
     it('API 실패 시 에러를 던진다', async () => {
       sendMessageMock.mockResolvedValue({