사내 Slack 봇 만들기 - 스냅샷 비교 변동 감지 + 스케줄러 + Slack 알림 (3편)

Tue, 07 Apr 2026 13:00:00 +0900

핵심 아이디어: 스냅샷 비교

변동 감지의 핵심은 단순하다. “방금 가져온 데이터"와 “지난번에 저장해둔 데이터"를 비교한다.

새로 생긴 항목 → 추가 알림
사라진 항목 → 취소 알림

이 상태를 snapshot.json에 저장해두면 서버가 재시작돼도 이전 상태를 그대로 복구할 수 있다.

스냅샷 구조

{
  "vacations": [
    {
      "id": "unique-key",
      "name": "홍길동",
      "date": "2026-04-03",
      "type": "연차"
    }
  ],
  "rooms": [
    {
      "id": "unique-key",
      "title": "주간 회의",
      "room": "중회의실",
      "start": "2026-04-03T10:00:00",
      "end": "2026-04-03T11:00:00"
    }
  ],
  "updatedAt": "2026-04-03T08:50:00.000Z"
}

변동 감지 로직

function detectChanges(prev, curr, keyFn) {
  const prevMap = new Map(prev.map(item => [keyFn(item), item]));
  const currMap = new Map(curr.map(item => [keyFn(item), item]));

  const added   = curr.filter(item => !prevMap.has(keyFn(item)));
  const removed = prev.filter(item => !currMap.has(keyFn(item)));

  return { added, removed };
}

keyFn으로 각 항목의 고유 키를 만든다. 휴가는 사번+날짜, 회의실은 예약ID 같은 식이다.

// 휴가 변동 감지
const vacationChanges = detectChanges(
  snapshot.vacations,
  freshVacations,
  v => `${v.id}_${v.date}`
);

// 회의실 변동 감지
const roomChanges = detectChanges(
  snapshot.rooms,
  freshRooms,
  r => r.id
);

회의실 변동 감지 주의점

회의실은 한 가지 함정이 있다. API가 요청한 날짜 범위보다 더 넓은 데이터를 반환하는 경우가 있어서, 날짜가 바뀌는 시점에 오탐이 발생했다.

예를 들어 오늘 오후 11시에 내일 예약이 새로 잡혔는데, 내일 예약은 아직 어제 스냅샷에 없으니 “추가됨"으로 오탐하는 것이다.

해결: 날짜가 바뀐 경우 회의실 비교를 건너뛴다.

const snapshotDate = snapshot.updatedAt?.slice(0, 10);
const today = new Date().toISOString().slice(0, 10);

// 날짜가 같을 때만 변동 비교 (날짜 변경 시 오탐 방지)
if (snapshotDate === today) {
  const roomChanges = detectChanges(snapshot.rooms, freshRooms, r => r.id);
  if (roomChanges.added.length || roomChanges.removed.length) {
    await notifyRoomChanges(roomChanges);
  }
}

스냅샷 저장

변동 감지 후 현재 상태를 스냅샷으로 저장한다.

async function saveSnapshot(vacations, rooms) {
  const snapshot = {
    vacations,
    rooms,
    updatedAt: new Date().toISOString(),
  };
  await fs.writeFile(SNAPSHOT_PATH, JSON.stringify(snapshot, null, 2));
}

node-cron 스케줄러 구성

const cron = require('node-cron');

// 10분마다: 변동 감지
cron.schedule('*/10 * * * *', () => syncAndCheckChanges());

// 월요일 09시: 이번 주 전체 휴가자
cron.schedule('0 9 * * 1', () => sendVacationWeekly());

// 화~금 09시: 당일 휴가자
cron.schedule('0 9 * * 2-5', () => sendVacationDaily());

// 월~금 09시: 당일 회의실 예약
cron.schedule('0 9 * * 1-5', () => sendRoomDaily());

// 월~금 09시: 출근 미등록자 DM
cron.schedule('0 9 * * 1-5', () => sendCommuteAlert());

// 30분마다: 세션 keepalive
cron.schedule('*/30 * * * *', () => keepSession());

// 월요일 00시: 로그 초기화
cron.schedule('0 0 * * 1', () => resetLog());

타임존 주의: node-cron의 기본 타임존은 시스템 타임존을 따른다. Docker 컨테이너 기본값은 UTC라서 .env에 TZ=Asia/Seoul을 설정하지 않으면 알림이 9시간 늦게 발송된다.

크론 설정을 파일로 관리

크론 스케줄을 코드에 하드코딩하면 수정할 때마다 재배포해야 한다. settings.json에 저장해서 관리자 페이지에서 수정 가능하게 했다.

{
  "crons": {
    "sync":           { "enabled": true,  "schedule": "*/10 * * * *" },
    "vacationWeekly": { "enabled": true,  "schedule": "0 9 * * 1" },
    "vacationDaily":  { "enabled": true,  "schedule": "0 9 * * 2-5" },
    "roomDaily":      { "enabled": true,  "schedule": "0 9 * * 1-5" },
    "commute":        { "enabled": true,  "schedule": "0 9 * * 1-5" },
    "sessionKeep":    { "enabled": true,  "schedule": "*/30 * * * *" },
    "logReset":       { "enabled": true,  "schedule": "0 0 * * 1" }
  }
}

서버 시작 시 이 파일을 읽어서 크론을 동적으로 등록한다.

const settings = JSON.parse(await fs.readFile(SETTINGS_PATH));
const cronJobs = {};

for (const [id, config] of Object.entries(settings.crons)) {
  if (!config.enabled) continue;
  cronJobs[id] = cron.schedule(config.schedule, cronHandlers[id]);
}

Slack Webhook 알림 발송

기본 발송

async function sendWebhook(webhookUrl, message) {
  await axios.post(webhookUrl, { text: message });
}

팀별 알림 타입 필터링

팀마다 받고 싶은 알림 타입이 다를 수 있다. teams.json에서 각 팀의 활성화된 타입만 발송한다.

{
  "teams": [
    {
      "name": "개발팀",
      "webhook": "https://hooks.slack.com/...",
      "enabled": true,
      "alertTypes": {
        "vacationChange": true,
        "vacationDaily": true,
        "roomChange": false,
        "roomDaily": true,
        "commute": false
      },
      "deptIds": ["0001", "0002"]
    }
  ]
}

async function notifyByType(type, message) {
  const teams = settings.teams.filter(
    t => t.enabled && t.alertTypes[type]
  );
  for (const team of teams) {
    await sendWebhook(team.webhook, message);
  }
}

같은 Webhook 중복 발송 방지

여러 팀이 같은 Webhook URL을 쓰는 경우가 있다. 그냥 발송하면 같은 채널에 동일한 알림이 여러 번 온다.

function dedupeByWebhook(teams) {
  const seen = new Set();
  return teams.filter(team => {
    if (seen.has(team.webhook)) return false;
    seen.add(team.webhook);
    return true;
  });
}

async function notifyByType(type, message) {
  const teams = dedupeByWebhook(
    settings.teams.filter(t => t.enabled && t.alertTypes[type])
  );
  for (const team of teams) {
    await sendWebhook(team.webhook, message);
  }
}

Slack 슬래시 커맨드

슬래시 커맨드는 Slack이 POST 요청을 서버로 보내는 방식이다. 3초 안에 응답하지 않으면 타임아웃이 난다.

app.post('/slack/command', async (req, res) => {
  const { command, text, channel_id } = req.body;

  // Slack에 일단 빈 응답 먼저 → 3초 타임아웃 방지
  res.json({ response_type: 'ephemeral', text: '조회 중...' });

  // 실제 처리는 비동기로
  const result = await handleCommand(command, text, channel_id);
  await axios.post(req.body.response_url, {
    response_type: 'in_channel',
    text: result,
  });
});

날짜 파싱

function parseDate(text) {
  if (!text || text === '오늘') return [today(), today()];
  if (text === '내일') return [tomorrow(), tomorrow()];
  if (text === '이번주') return [monday(), friday()];
  if (text.includes('~')) {
    const [start, end] = text.split('~').map(s => s.trim());
    return [start, end];
  }
  // 날짜 직접 입력: '2026-04-03'
  return [text.trim(), text.trim()];
}

채널 기반 팀 매칭

채널 ID로 어느 팀 채널인지 파악해서 해당 팀 휴가자만 보여준다.

function getTeamByChannel(channelId) {
  // 1. 채널 ID로 팀 매칭
  const team = teams.find(t => t.channelId === channelId);
  if (team) return team;

  // 2. 실패 시 → 사용자 Slack 이름에서 팀 추출
  // 3. 그것도 실패 시 → 전체 팀 그룹핑해서 표시
  return null;
}

메시지 포맷 예시

당일 휴가자

회의실 예약 현황

휴가 변동 알림

정리

스냅샷 비교로 변동 감지 → DB 없이 JSON 파일만으로 충분
회의실 변동은 날짜가 바뀌는 시점에 오탐 주의, 날짜 동일할 때만 비교
node-cron 타임존은 반드시 확인, Docker면 TZ=Asia/Seoul 필수
슬래시 커맨드는 3초 타임아웃 때문에 즉시 응답 후 비동기 처리
같은 Webhook URL 중복 발송은 dedup 처리

다음 편에서는 관리자 페이지 구현과 Docker 배포, 실제 겪은 트러블슈팅을 다룬다.

Node-Cron on Chanyeol Dev