Aiddoo
diff --git a/‎apps/api/src/modules/admin/admin.service.spec.ts‎
Lines changed: 123 additions & 1 deletion b/‎apps/api/src/modules/admin/admin.service.spec.ts‎
Lines changed: 123 additions & 1 deletion
diff --git a/‎apps/api/src/modules/admin/admin.service.ts‎
Lines changed: 8 additions & 2 deletions b/‎apps/api/src/modules/admin/admin.service.ts‎
Lines changed: 8 additions & 2 deletions
diff --git a/‎apps/api/src/modules/scheduler/reminder/adapters/bullmq-reminder-scheduler.adapter.spec.ts‎
Lines changed: 6 additions & 8 deletions b/‎apps/api/src/modules/scheduler/reminder/adapters/bullmq-reminder-scheduler.adapter.spec.ts‎
Lines changed: 6 additions & 8 deletions
diff --git a/‎apps/api/src/modules/scheduler/reminder/adapters/bullmq-reminder-scheduler.adapter.ts‎
Lines changed: 8 additions & 18 deletions b/‎apps/api/src/modules/scheduler/reminder/adapters/bullmq-reminder-scheduler.adapter.ts‎
Lines changed: 8 additions & 18 deletions
diff --git a/‎apps/api/src/modules/scheduler/reminder/interfaces/reminder-scheduler.interface.ts‎
Lines changed: 1 addition & 7 deletions b/‎apps/api/src/modules/scheduler/reminder/interfaces/reminder-scheduler.interface.ts‎
Lines changed: 1 addition & 7 deletions
@@ -8,7 +8,10 @@
  *
  * @see https://docs.nestjs.com/recipes/suites
  */
-import { BROADCAST_TARGET_FILTER } from "@aido/validators";
+import {
+	BROADCAST_TARGET_FILTER,
+	NOTIFICATION_ACTION_TYPE,
+} from "@aido/validators";
 import type { Mocked } from "@suites/doubles.jest";
 import { TestBed } from "@suites/unit";
 import { UserBuilder } from "@test/builders";
@@ -199,6 +202,88 @@ describe("AdminService", () => {
 			);
 		});
 
+		it("action에 URL이 있으면 metadata.externalUrl을 포함해야 한다", async () => {
+			// Given
+			const dto = {
+				title: "v1.0.4 업데이트",
+				body: "새로운 기능이 추가되었어요!",
+				targetFilter: BROADCAST_TARGET_FILTER.ALL,
+				action: {
+					type: NOTIFICATION_ACTION_TYPE.BROWSER,
+					url: "https://www.aido.kr/ko/patch-notes",
+				},
+			};
+
+			const userIds: UserIdOnly[] = [{ id: "user-1" }, { id: "user-2" }];
+			database.user.findMany.mockResolvedValue(userIds as never);
+			notificationService.createAndSendBatch.mockResolvedValue({
+				count: 2,
+			});
+
+			// When
+			await service.broadcastNotification(dto);
+
+			// Then
+			expect(notificationService.createAndSendBatch).toHaveBeenCalledWith([
+				{
+					userId: "user-1",
+					type: "ADMIN_BROADCAST",
+					title: "v1.0.4 업데이트",
+					body: "새로운 기능이 추가되었어요!",
+					action: {
+						type: NOTIFICATION_ACTION_TYPE.BROWSER,
+						url: "https://www.aido.kr/ko/patch-notes",
+					},
+					metadata: { externalUrl: "https://www.aido.kr/ko/patch-notes" },
+				},
+				{
+					userId: "user-2",
+					type: "ADMIN_BROADCAST",
+					title: "v1.0.4 업데이트",
+					body: "새로운 기능이 추가되었어요!",
+					action: {
+						type: NOTIFICATION_ACTION_TYPE.BROWSER,
+						url: "https://www.aido.kr/ko/patch-notes",
+					},
+					metadata: { externalUrl: "https://www.aido.kr/ko/patch-notes" },
+				},
+			]);
+		});
+
+		it("action에 URL이 없으면 metadata를 포함하지 않아야 한다", async () => {
+			// Given
+			const dto = {
+				title: "공지사항",
+				body: "안내 메시지",
+				targetFilter: BROADCAST_TARGET_FILTER.ALL,
+				action: {
+					type: NOTIFICATION_ACTION_TYPE.NONE,
+				},
+			};
+
+			const userIds: UserIdOnly[] = [{ id: "user-1" }];
+			database.user.findMany.mockResolvedValue(userIds as never);
+			notificationService.createAndSendBatch.mockResolvedValue({
+				count: 1,
+			});
+
+			// When
+			await service.broadcastNotification(dto);
+
+			// Then
+			expect(notificationService.createAndSendBatch).toHaveBeenCalledWith([
+				{
+					userId: "user-1",
+					type: "ADMIN_BROADCAST",
+					title: "공지사항",
+					body: "안내 메시지",
+					action: {
+						type: NOTIFICATION_ACTION_TYPE.NONE,
+					},
+				},
+			]);
+		});
+
 		it("구독자에게만 알림을 발송해야 한다", async () => {
 			// Given
 			const dto = {
@@ -329,6 +414,43 @@ describe("AdminService", () => {
 			]);
 		});
 
+		it("action에 URL이 있으면 metadata.externalUrl을 포함해야 한다", async () => {
+			// Given
+			const dto = {
+				title: "개인 알림",
+				body: "확인해주세요",
+				userIds: ["user-1"],
+				action: {
+					type: NOTIFICATION_ACTION_TYPE.BROWSER,
+					url: "https://www.aido.kr/ko/patch-notes",
+				},
+			};
+
+			const userIds: UserIdOnly[] = [{ id: "user-1" }];
+			database.user.findMany.mockResolvedValue(userIds as never);
+			notificationService.createAndSendBatch.mockResolvedValue({
+				count: 1,
+			});
+
+			// When
+			await service.sendTargetedNotification(dto);
+
+			// Then
+			expect(notificationService.createAndSendBatch).toHaveBeenCalledWith([
+				{
+					userId: "user-1",
+					type: "ADMIN_TARGETED",
+					title: "개인 알림",
+					body: "확인해주세요",
+					action: {
+						type: NOTIFICATION_ACTION_TYPE.BROWSER,
+						url: "https://www.aido.kr/ko/patch-notes",
+					},
+					metadata: { externalUrl: "https://www.aido.kr/ko/patch-notes" },
+				},
+			]);
+		});
+
 		it("모든 사용자가 존재하지 않으면 에러를 던져야 한다", async () => {
 			// Given
 			const dto = {
 
@@ -33,8 +33,9 @@ export class AdminService {
 	async broadcastNotification(
 		dto: BroadcastNotificationDto,
 	): Promise<BroadcastResult> {
-		const { title, body, targetFilter } = dto;
+		const { title, body, targetFilter, action } = dto;
 		const whereClause = this.#buildTargetWhere(targetFilter);
+		const metadata = action?.url ? { externalUrl: action.url } : undefined;
 
 		let totalTargets = 0;
 		let successCount = 0;
@@ -59,6 +60,8 @@ export class AdminService {
 					type: "ADMIN_BROADCAST" as const,
 					title,
 					body,
+					action,
+					metadata,
 				}));
 
 				const result =
@@ -88,7 +91,8 @@ export class AdminService {
 	async sendTargetedNotification(
 		dto: TargetedNotificationDto,
 	): Promise<BroadcastResult> {
-		const { title, body, userIds } = dto;
+		const { title, body, userIds, action } = dto;
+		const metadata = action?.url ? { externalUrl: action.url } : undefined;
 
 		// 존재하는 사용자만 필터링
 		const existingUsers = await this.database.user.findMany({
@@ -115,6 +119,8 @@ export class AdminService {
 			type: "ADMIN_TARGETED" as const,
 			title,
 			body,
+			action,
+			metadata,
 		}));
 
 		// 배치로 알림 생성 및 발송
 
@@ -17,7 +17,6 @@ import {
 // =============================================================================
 
 const USER_ID = "user-1";
-const TODO_TITLE = "Test Todo";
 const SIXTY_MIN_MS = 60 * 60 * 1000;
 
 // =============================================================================
@@ -55,7 +54,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(Date.now() + 2 * SIXTY_MIN_MS);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 각 단계별 잡 등록
@@ -67,7 +66,6 @@ describe("BullMQReminderSchedulerAdapter", () => {
 				expect.objectContaining({
 					todoId: 1,
 					userId: USER_ID,
-					todoTitle: TODO_TITLE,
 					stageLabel: "60min",
 				}),
 				expect.objectContaining({
@@ -89,7 +87,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(Date.now() + 30 * 60 * 1000);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 10분 단계만 등록 (getJob 호출 제외)
@@ -106,7 +104,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(Date.now() + 5 * 60 * 1000);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 즉시 발송 잡
@@ -129,7 +127,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(Date.now() - 60 * 1000);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 잡 등록 없음 (getJob은 기존 잡 제거 시도로 호출될 수 있음)
@@ -144,7 +142,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(Date.now() + 2 * SIXTY_MIN_MS);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 기존 잡 제거 호출됨
@@ -159,7 +157,7 @@ describe("BullMQReminderSchedulerAdapter", () => {
 			const scheduledTime = new Date(now + 2 * SIXTY_MIN_MS);
 
 			// When
-			adapter.scheduleReminder(1, scheduledTime, USER_ID, TODO_TITLE);
+			adapter.scheduleReminder(1, scheduledTime, USER_ID);
 			await flushPromises();
 
 			// Then — 60분 단계의 delay 확인
 
@@ -13,7 +13,6 @@ export const TODO_REMINDER_QUEUE = "todo-reminder";
 export interface ReminderJobData {
 	todoId: number;
 	userId: string;
-	todoTitle: string;
 	stageLabel: string;
 }
 
@@ -41,21 +40,14 @@ export class BullMQReminderSchedulerAdapter implements IReminderScheduler {
 	 * 모든 단계가 이미 지났지만 scheduledTime이 미래인 경우 즉시 발송 잡을 등록합니다.
 	 * 같은 todoId로 재호출 시 기존 잡을 제거하고 새로 등록합니다.
 	 */
-	scheduleReminder(
-		todoId: number,
-		scheduledTime: Date,
-		userId: string,
-		todoTitle: string,
-	): void {
+	scheduleReminder(todoId: number, scheduledTime: Date, userId: string): void {
 		// 비동기 작업을 fire-and-forget으로 실행
-		this.#scheduleAsync(todoId, scheduledTime, userId, todoTitle).catch(
-			(error) => {
-				this.#logger.error(
-					`Failed to schedule reminder: todoId=${todoId}, ${error}`,
-					error instanceof Error ? error.stack : undefined,
-				);
-			},
-		);
+		this.#scheduleAsync(todoId, scheduledTime, userId).catch((error) => {
+			this.#logger.error(
+				`Failed to schedule reminder: todoId=${todoId}, ${error}`,
+				error instanceof Error ? error.stack : undefined,
+			);
+		});
 	}
 
 	/**
@@ -74,7 +66,6 @@ export class BullMQReminderSchedulerAdapter implements IReminderScheduler {
 		todoId: number,
 		scheduledTime: Date,
 		userId: string,
-		todoTitle: string,
 	): Promise<void> {
 		// 기존 잡 제거 (재스케줄링 지원)
 		await this.#cancelAsync(todoId);
@@ -100,7 +91,7 @@ export class BullMQReminderSchedulerAdapter implements IReminderScheduler {
 				hasScheduledJob = true;
 				await this.queue.add(
 					"send-reminder",
-					{ todoId, userId, todoTitle, stageLabel: stage.label },
+					{ todoId, userId, stageLabel: stage.label },
 					{
 						jobId: `reminder_${todoId}_${stage.label}`,
 						delay,
@@ -122,7 +113,6 @@ export class BullMQReminderSchedulerAdapter implements IReminderScheduler {
 				{
 					todoId,
 					userId,
-					todoTitle,
 					stageLabel: REMINDER_IMMEDIATE_LABEL,
 				},
 				{
 
@@ -16,14 +16,8 @@ export interface IReminderScheduler {
 	 * @param todoId 대상 투두 ID
 	 * @param scheduledTime 투두 마감 시각
 	 * @param userId 사용자 ID
-	 * @param todoTitle 투두 제목 (알림 메시지용)
 	 */
-	scheduleReminder(
-		todoId: number,
-		scheduledTime: Date,
-		userId: string,
-		todoTitle: string,
-	): void;
+	scheduleReminder(todoId: number, scheduledTime: Date, userId: string): void;
 
 	/**
 	 * 리마인더 타이머 취소