@cartanova/qgrid-cli 2.6.8 → 2.6.10

package/bundle/src/utils/quiet-hours.ts

@@ -2,39 +2,78 @@
  * Slack 알림 조용 시간.
  *
  * 토큰 만료는 사람이 재로그인해야 풀리는데, 그 사람이 자거나 쉬는 동안 알려도 할 수 있는
- * 일이 없다. 평일 업무 시간에만 알리고 나머지는 다음 근무 시간으로 미룬다 — 만료 알림은
+ * 일이 없다. 업무 시간에만 알리고 나머지는 다음 근무 시간으로 미룬다 — 만료 알림은
  * 주기적으로 반복되므로 조용 시간에 버려도 아침 첫 주기에 다시 온다.
  *
  * 다만 provider 의 마지막 토큰이 죽는 것은 서비스 정지 신호라 이 규칙에서 제외한다
- * (호출부가 `notifySlack` 을 그냥 호출하면 된다).
+ * (호출부가 `urgent: true` 로 보내면 된다).
  */
+import { type getSetting } from "../application/setting/setting.store";
 
-/** 이 시각부터(포함) 조용해진다. */
-const QUIET_FROM_HOUR = 20;
-/** 이 시각부터(포함) 다시 알린다. */
-const QUIET_UNTIL_HOUR = 8;
+/**
+ * 설정 조회 함수의 형태만 빌린다 — `type` import 라 런타임 의존이 생기지 않는다.
+ *
+ * 값 자체는 항상 호출부(`slack-notify`)가 넘긴다. 여기서 `getSetting` 을 실제로 import 하면
+ * `setting.store → setting.model → token.model` 이 딸려와, `token.model` 을 mock 하는
+ * 테스트들이 실제 모듈을 먼저 로드해 버린다. 조용 시간 판정은 시각 계산이지 설정 조회가
+ * 아니므로, 읽는 책임은 이미 설정을 읽고 있는 호출부에 둔다.
+ */
+type ReadSetting = typeof getSetting;
+
+/** `setting.constant.ts` 의 두 fallback 과 같아야 한다. 일치 여부는 테스트가 지킨다. */
+export const DEFAULT_QUIET_FROM_HOUR = 20;
+export const DEFAULT_QUIET_UNTIL_HOUR = 8;
 
 /**
  * 서버가 UTC 로 돌아도 한국 시간으로 판정한다. dev0 는 UTC 이므로 `getHours()` 를 그대로
  * 쓰면 "저녁 8시"가 한국 시간 새벽 5시가 된다.
  */
+const SEOUL_FORMATTER = new Intl.DateTimeFormat("en-US", {
+  timeZone: "Asia/Seoul",
+  hour: "numeric",
+  hour12: false,
+  weekday: "short",
+});
+
 function seoulParts(at: Date): { hour: number; weekday: string } {
-  const formatter = new Intl.DateTimeFormat("en-US", {
-    timeZone: "Asia/Seoul",
-    hour: "numeric",
-    hour12: false,
-    weekday: "short",
-  });
-  const parts = formatter.formatToParts(at);
+  const parts = SEOUL_FORMATTER.formatToParts(at);
   const hour = Number(parts.find((p) => p.type === "hour")?.value ?? "0");
   const weekday = parts.find((p) => p.type === "weekday")?.value ?? "";
   // Intl 은 자정을 24 로 줄 수 있다. 0..23 으로 맞춘다.
   return { hour: hour % 24, weekday };
 }
 
-/** 주말이거나 20시~익일 8시면 조용 시간. */
-export function isQuietHours(at: Date = new Date()): boolean {
+/** 0..23 범위를 벗어나거나 숫자가 아니면 기본값으로 떨어진다. */
+function boundedHour(raw: string | undefined, fallback: number): number {
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed < 0 || parsed > 23) return fallback;
+  return parsed;
+}
+
+/**
+ * 조용 시간인지 판정한다.
+ *
+ * 시작 > 종료면 자정을 넘는 구간(20시~익일 8시), 시작 < 종료면 같은 날 구간(0시~8시처럼)
+ * 으로 읽는다. 야간 근무처럼 낮에 조용하고 싶은 팀도 있어 뒤집힌 값을 막지 않는다.
+ */
+export function isQuietHours(at: Date, readSetting: ReadSetting): boolean {
   const { hour, weekday } = seoulParts(at);
-  if (weekday === "Sat" || weekday === "Sun") return true;
-  return hour >= QUIET_FROM_HOUR || hour < QUIET_UNTIL_HOUR;
+
+  const isWeekend = weekday === "Sat" || weekday === "Sun";
+  if (isWeekend && readSetting("slack.notifyOnWeekends", "SLACK_NOTIFY_ON_WEEKENDS") !== "true") {
+    return true;
+  }
+
+  const from = boundedHour(
+    readSetting("slack.quietFromHour", "SLACK_QUIET_FROM_HOUR"),
+    DEFAULT_QUIET_FROM_HOUR,
+  );
+  const until = boundedHour(
+    readSetting("slack.quietUntilHour", "SLACK_QUIET_UNTIL_HOUR"),
+    DEFAULT_QUIET_UNTIL_HOUR,
+  );
+
+  // 시작과 종료가 같으면 구간이 비어 있다는 뜻으로 읽어 조용 시간을 두지 않는다.
+  if (from === until) return false;
+  return from > until ? hour >= from || hour < until : hour >= from && hour < until;
 }

package/bundle/src/utils/slack-notify.test.ts

@@ -12,6 +12,9 @@ function seoul(iso: string): Date {
   return new Date(`${iso}+09:00`);
 }
 
+/** 저장값도 env 도 없는 상태 — 조용 시간이 코드 기본값(20~8시, 주말 차단)으로 동작한다. */
+const noSettings = () => undefined;
+
 /** 평일 업무 시간. 조용 시간에 막히지 않도록 전송 케이스의 기준 시각으로 쓴다. */
 const WORKING_HOURS = seoul("2026-08-05T14:00:00");
 
@@ -129,39 +132,119 @@ describe("notifySlack", () => {
 
     expect(fetchMock).toHaveBeenCalledTimes(1);
   });
+
+  it("마스터 스위치를 내리면 보통 알림을 보내지 않는다", async () => {
+    // 연휴처럼 규칙으로 잡을 수 없는 기간에 관리자가 직접 내리는 스위치.
+    settingMock.mockImplementation((key: string) =>
+      key === "slack.botToken"
+        ? "xoxb-test"
+        : key === "slack.channelId"
+          ? "C123"
+          : key === "slack.enabled"
+            ? "false"
+            : undefined,
+    );
+    const fetchMock = vi.spyOn(globalThis, "fetch");
+
+    await notify({ title: "토큰 추가", now: WORKING_HOURS });
+
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+
+  it("마스터 스위치를 내려도 urgent 는 통과한다", async () => {
+    // 끈 채로 provider 가 전부 죽으면 연휴 내내 서비스 정지를 아무도 모른다.
+    settingMock.mockImplementation((key: string) =>
+      key === "slack.botToken"
+        ? "xoxb-test"
+        : key === "slack.channelId"
+          ? "C123"
+          : key === "slack.enabled"
+            ? "false"
+            : undefined,
+    );
+    const fetchMock = vi
+      .spyOn(globalThis, "fetch")
+      .mockResolvedValue(new Response(JSON.stringify({ ok: true })));
+
+    await notify({ title: "마지막 토큰 사망", urgent: true, now: WORKING_HOURS });
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+  });
+});
+
+describe("isQuietHours 설정", () => {
+
+  /** 설정 조회를 고정해 실행 환경의 env 에 기대지 않게 한다. */
+  const withSettings = (values: Record<string, string>) => (key: string) => values[key];
+
+  it("조용 시간 구간을 설정으로 바꾼다", () => {
+    const read = withSettings({ "slack.quietFromHour": "22", "slack.quietUntilHour": "6" });
+    // 21시는 기본값(20시 시작)이면 조용하지만 22시 시작으로 바꾸면 알린다.
+    expect(isQuietHours(seoul("2026-08-05T21:00:00"), read)).toBe(false);
+    expect(isQuietHours(seoul("2026-08-05T22:00:00"), read)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-06T05:59:00"), read)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-06T06:00:00"), read)).toBe(false);
+  });
+
+  it("주말 알림을 켜면 주말에도 시간 규칙만 본다", () => {
+    const read = withSettings({ "slack.notifyOnWeekends": "true" });
+    // 2026-08-08 토요일
+    expect(isQuietHours(seoul("2026-08-08T10:00:00"), read)).toBe(false);
+    expect(isQuietHours(seoul("2026-08-08T22:00:00"), read)).toBe(true);
+  });
+
+  it("시작과 종료가 같으면 조용 시간을 두지 않는다", () => {
+    const read = withSettings({ "slack.quietFromHour": "8", "slack.quietUntilHour": "8" });
+    expect(isQuietHours(seoul("2026-08-05T03:00:00"), read)).toBe(false);
+    expect(isQuietHours(seoul("2026-08-05T23:00:00"), read)).toBe(false);
+  });
+
+  it("시작이 종료보다 빠르면 같은 날 구간으로 읽는다", () => {
+    // 야간 근무처럼 낮에 조용하고 싶은 경우를 막지 않는다.
+    const read = withSettings({ "slack.quietFromHour": "9", "slack.quietUntilHour": "18" });
+    expect(isQuietHours(seoul("2026-08-05T12:00:00"), read)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-05T20:00:00"), read)).toBe(false);
+  });
+
+  it("범위를 벗어난 값은 기본 구간으로 떨어진다", () => {
+    // 저장을 막고 있지만 env 로도 들어올 수 있어 런타임에서 한 번 더 지킨다.
+    const read = withSettings({ "slack.quietFromHour": "99", "slack.quietUntilHour": "-1" });
+    expect(isQuietHours(seoul("2026-08-05T21:00:00"), read)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-05T14:00:00"), read)).toBe(false);
+  });
 });
 
 describe("isQuietHours", () => {
   it("평일 업무 시간에는 알린다", () => {
     // 2026-08-05 는 수요일
-    expect(isQuietHours(seoul("2026-08-05T09:00:00"))).toBe(false);
-    expect(isQuietHours(seoul("2026-08-05T19:59:00"))).toBe(false);
+    expect(isQuietHours(seoul("2026-08-05T09:00:00"), noSettings)).toBe(false);
+    expect(isQuietHours(seoul("2026-08-05T19:59:00"), noSettings)).toBe(false);
   });
 
   it("평일 20시부터 다음날 8시까지 조용하다", () => {
-    expect(isQuietHours(seoul("2026-08-05T20:00:00"))).toBe(true);
-    expect(isQuietHours(seoul("2026-08-06T00:00:00"))).toBe(true);
-    expect(isQuietHours(seoul("2026-08-06T07:59:00"))).toBe(true);
-    expect(isQuietHours(seoul("2026-08-06T08:00:00"))).toBe(false);
+    expect(isQuietHours(seoul("2026-08-05T20:00:00"), noSettings)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-06T00:00:00"), noSettings)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-06T07:59:00"), noSettings)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-06T08:00:00"), noSettings)).toBe(false);
   });
 
   it("주말은 시간과 무관하게 조용하다", () => {
     // 2026-08-08 토요일, 08-09 일요일
-    expect(isQuietHours(seoul("2026-08-08T10:00:00"))).toBe(true);
-    expect(isQuietHours(seoul("2026-08-09T12:00:00"))).toBe(true);
+    expect(isQuietHours(seoul("2026-08-08T10:00:00"), noSettings)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-09T12:00:00"), noSettings)).toBe(true);
   });
 
   it("월요일 8시에 다시 알리기 시작한다", () => {
-    expect(isQuietHours(seoul("2026-08-10T07:59:00"))).toBe(true);
-    expect(isQuietHours(seoul("2026-08-10T08:00:00"))).toBe(false);
+    expect(isQuietHours(seoul("2026-08-10T07:59:00"), noSettings)).toBe(true);
+    expect(isQuietHours(seoul("2026-08-10T08:00:00"), noSettings)).toBe(false);
   });
 
   it("서버가 UTC 여도 한국 시간으로 판정한다", () => {
     // UTC 23시 = 한국 다음날 08시 → 업무 시간
-    expect(isQuietHours(new Date("2026-08-04T23:00:00Z"))).toBe(false);
+    expect(isQuietHours(new Date("2026-08-04T23:00:00Z"), noSettings)).toBe(false);
     // UTC 12시 = 한국 21시 → 조용 시간
-    expect(isQuietHours(new Date("2026-08-05T12:00:00Z"))).toBe(true);
+    expect(isQuietHours(new Date("2026-08-05T12:00:00Z"), noSettings)).toBe(true);
     // UTC 금요일 22시 = 한국 토요일 07시 → 주말
-    expect(isQuietHours(new Date("2026-08-07T22:00:00Z"))).toBe(true);
+    expect(isQuietHours(new Date("2026-08-07T22:00:00Z"), noSettings)).toBe(true);
   });
 });

package/bundle/src/utils/slack-notify.ts

@@ -50,8 +50,15 @@ export async function notifySlack(
     return;
   }
 
+  // 연휴처럼 규칙으로 잡을 수 없는 기간에 관리자가 내리는 스위치. urgent 는 통과시킨다 —
+  // 끈 상태로 provider 가 전부 죽으면 연휴 내내 서비스가 멈춘 줄 아무도 모른다.
+  if (!urgent && readSetting("slack.enabled", "SLACK_ENABLED") === "false") {
+    logger.debug(`slack disabled, skipping notification: ${title} ${subject ?? ""}`);
+    return;
+  }
+
   // 만료 알림은 주기적으로 반복되므로 여기서 버려도 다음 근무 시간 첫 주기에 다시 온다.
-  if (!urgent && isQuietHours(now)) {
+  if (!urgent && isQuietHours(now ?? new Date(), readSetting)) {
     logger.debug(`quiet hours, skipping notification: ${title} ${subject ?? ""}`);
     return;
   }