ikieEngineeringGet started
All posts

데이터 모델캘린더TypeScript

반복 일정은 저장하지 않아요

ikie는 반복 일정의 회차를 하나도 저장하지 않고, 규칙에서 볼 때마다 계산해요. 저장하지 않는 회차에 주소를 붙이고, "모두"나 "이후 모두"로 시리즈를 고쳐도 그 주소를 지키는 방법을 적었어요.

English
끝냄지운 회차옮긴 회차
주간 보고 쓰기
  1. 10월 5일 월9:00끝냄
  2. 10월 12일 월9:00지움
  3. 10월 19일 월9:0020일 화 14:00
  4. 10월 26일 월9:00
  5. 11월 2일 월9:00
매주 월요일 9시에 하는 할 일 하나. 회차는 어디에도 저장되어 있지 않아요. 저장된 것은 규칙 한 줄(FREQ=WEEKLY;BYDAY=MO)과, 바뀐 회차 세 개에 붙은 기록뿐이에요.

캘린더 앱에서 가장 많이 쓰는 기능 중 하나가 반복이에요. 매주 회의, 매달 카드값, 매년 생일. 그리고 캘린더를 만드는 사람이 가장 오래 붙잡게 되는 기능도 반복이에요. "이 회차만", "이후 모두", "모두"라는 세 단추 뒤에 생각보다 많은 경우가 숨어 있거든요.

ikie는 일정과 할 일을 한 모델로 다뤄요. 반복하는 할 일은 회차마다 끝냄이 따로 있고, 반복 일정 안에 넣은 체크리스트는 회차마다 따로 체크돼요. 이 글은 이 모든 것을 회차를 하나도 저장하지 않고 해내는 방법이에요.

펼쳐 저장하면 생기는 일

반복을 저장하는 길은 두 가지예요. 회차를 미리 펼쳐서 한 줄씩 저장하거나, 규칙만 저장하고 볼 때 계산하거나요.

회차를 펼쳐 저장하면

매주 월요일 회의회차마다 행 하나
10월 5일 행10월 12일 행… 끝이 없으면 언제까지?

규칙을 바꾸면 행을 다시 만들고 맞춰야 해요

규칙만 저장하면

규칙 한 줄RRULE · 더한 날 · 뺀 날
바뀐 회차만 기록회차는 볼 때 계산

규칙을 바꾸면 그걸로 끝

펼쳐 저장하면 처음엔 쉬워요. 회차 하나하나가 그냥 행이니까 끝냄도 알림도 그 행에 붙이면 돼요. 문제는 고칠 때예요. 끝이 없는 반복은 어디까지 펼칠지 정해야 하고, 규칙을 "격주"로 바꾸면 이미 만든 행 중 무엇을 지우고 무엇을 남길지 맞춰야 해요. 그 행에 붙은 끝냄과 메모는 어디로 가야 할까요? 그리고 Google 캘린더도 Apple 캘린더도 반복을 규칙으로 주고받아요. 행으로 펼치면 동기화할 때마다 다시 규칙으로 접어야 해요.

ikie는 규칙만 저장해요. 표에는 RRULE, 더한 회차(RDATE), 뺀 회차(EXDATE)가 있고, 회차는 화면에 날들을 그릴 때(ikie는 이것을 판이라고 불러요) 그 구간만큼만 계산해요. 우리 원칙으로 쓰면 이래요.

사실만 저장하고, 사실에서 나오는 것은 저장하지 않아요. 회차는 규칙에서 언제든 다시 만들 수 있으니 저장하지 않아요.

회차의 주소

저장하지 않는 회차에 끝냄이나 옮긴 시각을 붙이려면 회차를 가리킬 방법이 있어야 해요. ikie에서 회차의 주소는 (항목 id, 원래 시작)이에요. Google 캘린더의 recurringEventId와 originalStartTime, iCalendar의 RECURRENCE-ID와 같은 생각이에요.

/** 회차 키: 종일은 날짜, 시각은 UTC 순간(ISO Z), 떠다니는 시각은 현지 값. */
export function occurrenceKey(time: ItemTime): string {
  if (time.kind === "zoned") return iso(Date.parse(time.start));
  return time.start;
}

바뀐 회차는 item_override 표에 이 주소를 열쇠로 한 줄 적어요. 적는 것은 바뀐 칸뿐이에요. 옮긴 시각, 바꾼 제목, 취소, 그리고 할 일의 끝냄 같은 회차의 상태도 여기에 붙어요. 그림의 10월 19일 회차를 화요일 14시로 옮기면 주소는 여전히 "10월 19일 월 9시"이고, 그 줄에 새 시각만 적혀요. 주소는 회차가 원래 있던 자리라서, 회차를 어디로 옮겨도 바뀌지 않아요.

펼치기(expand)는 규칙에서 구간 안의 회차 주소를 만들고, 뺀 회차를 지우고, 바뀐 회차의 기록을 덮어써요. 구간 밖에서 안으로 옮겨 온 회차도 챙겨요. 다음 주 월요일 회차를 이번 주 금요일로 당겨 왔다면, 이번 주 판에 보여야 하니까요.

서머타임에도 9시는 9시예요

규칙은 UTC가 아니라 시리즈가 시작한 시간대의 현지 시각으로 펼쳐요. 뉴욕의 매주 월요일 9시 회의는 11월 1일 서머타임이 끝나도 9시에 있어야 해요. UTC로 펼치면 하루아침에 8시 회의가 돼요.

// 시험: 11월 1일에 EDT(-4) → EST(-5)
expect(starts(ny, "2026-10-25T00:00:00Z", "2026-11-10T00:00:00Z"))
  .toEqual(["2026-10-26T13:00:00Z", "2026-11-02T14:00:00Z", "2026-11-09T14:00:00Z"]);

UTC 순간은 13시에서 14시로 바뀌지만, 현지 벽시계로는 세 번 모두 9시예요. 종일 일정은 날짜로 읽고, 시간대 없이 "어디서든 9시"로 받은 떠다니는 시각(floating time)은 보는 사람의 시간대로 읽어요. RRULE을 읽고 펼치는 일은 직접 만들지 않고 오래 쓰인 rrule 라이브러리에 맡겼어요. 우리가 쓴 것은 현지 시각과 순간 사이의 다리예요.

오래된 반복이 판을 느리게 했어요

규칙을 볼 때마다 계산하면 계산이 비싸지 않을까요? 실제로 한 번 크게 걸렸어요. 캘린더를 많이 연결해 반복 일정이 366개인 계정에서 판 하나를 읽는 데 2.3~2.6초가 걸렸어요. DB는 0.04초였고, 나머지가 모두 반복 펼치기였어요.

원인은 두 가지였어요. 하나는 항목마다 날마다 다시 펼치고 있었던 거예요(21일 판이면 21번). 다른 하나는 rrule이 규칙의 시작부터 회차를 하나씩 세어 간다는 점이에요. 2001년에 시작한 매일 반복이면 오늘까지 9천 개를 넘게 세고 나서야 이번 주 회차가 나와요. 그래서 펼치기를 항목마다 한 번으로 줄이고, 몇 해 전에 시작한 규칙은 시작을 보는 구간 가까이로 당겼어요.

case RRule.DAILY:
case RRule.WEEKLY: {
  const period = (options.freq === RRule.DAILY ? 1 : 7) * n * DAY;
  // 주기의 배수만큼만 옮기면 같은 회차가 나와요
  return start + Math.max(0, Math.floor((lo - start) / period) - 1) * period;
}

주기의 배수만큼만 옮겨야 같은 회차가 나와요. "매달 31일"처럼 규칙이 시작 날짜에서 따오던 칸(며칠인지, 몇 월인지)은 옮기기 전에 규칙에 먼저 적어 두고, 횟수(COUNT)가 있는 규칙은 처음부터 세야 하니 그대로 둬요. 당긴 결과가 처음부터 센 것과 같은지는 윤년 2월 29일, 매달 31일, 3월 마지막 일요일, 4년마다처럼 까다로운 규칙 12가지로 시험해요.

그 뒤 한 달 판을 보니 이번엔 시간대 풀기가 대부분이었어요. 회차 구간을 날마다 다시 세느라 한 달 판에 Intl 시간대 변환이 수만 번 불렸어요. 같은 순간은 한 번만 풀어 기억해 두고 구간도 한 번만 세게 하자, 일정 340개짜리 한 달 판의 계산이 200ms에서 50ms로 줄었어요(로컬 측정).

"모두 옮기기"에는 주소도 함께 옮겨야 해요

여기서부터가 이 글의 본론이에요. 회차의 주소는 원래 시작이라고 했어요. 그럼 시리즈 전체를 하루 뒤로 옮기면 어떻게 될까요?

옮기기 전
  1. 10월 5일 월끝냄
  2. 10월 12일 월지움
  3. 10월 19일 월회차 알림
  4. 10월 26일 월
주소를 그대로 두면
  1. 10월 6일 화끝냄 사라짐
  2. 10월 13일 화다시 나타남
  3. 10월 20일 화알림 안 울림
  4. 10월 27일 화
주소도 옮기면
  1. 10월 6일 화끝냄
  2. 10월 13일 화지움
  3. 10월 20일 화회차 알림
  4. 10월 27일 화
월요일 회차들을 모두 화요일로 옮겼어요. 주소를 그대로 두면 기록이 가리키는 회차가 사라져요. 끝냄은 사라지고, 지운 회차는 다시 나타나요.

시리즈 시작이 하루 밀리면 규칙이 만드는 회차 주소도 모두 하루씩 밀려요. 그런데 끝냄 기록은 여전히 "10월 5일 월"을 가리켜요. 그런 회차는 이제 없으니 기록은 아무 데도 붙지 않고, 사용자 눈에는 끝낸 할 일이 다시 열려요. 지운 회차(EXDATE)도 옛 주소를 가리키니, 지웠던 10월 13일 회차가 다시 나타나요.

그래서 ikie는 시리즈 시간을 옮길 때 그 시리즈를 가리키는 모든 회차 주소를 같은 만큼 옮겨요. 바꾼 회차와 끝냄(item_override), 뺀 회차와 더한 회차, 회차에 건 알림, 이미 보낸 알림 기록, 그리고 다른 할 일이 "먼저 끝나야 할 일"로 건 회차까지요. 반복 일정 안의 체크리스트가 가진 회차별 끝냄도 같이 옮겨요. 얼마만큼 옮길지는 DB를 모르는 순수 함수가 정해요. 사용자가 열어 고친 회차가 현지 벽시계로 얼마나 움직였는지 재고, 데이터 층은 그 결과를 받아 적기만 해요.

export function shiftedKey(shift: OccurrenceShift, key: string): string {
  if (!shift) return key; // 시간을 안 바꾼 편집은 원래 주소 글자를 그대로 둬요
  const wall = msWall(wallMs(keyWall(shift.series, key)) + shift.delta);
  if (shift.allDay) return wall.slice(0, 10);
  const instant = wallToInstant(wall, shift.tz);
  // 옮긴 벽시계가 그 시간대에 없는 시각이면 짐작하지 않아요
  if (instantToWall(instant, shift.tz) !== wall) throw new OccurrenceShiftConflict("Nonexistent shifted wall time");
  return iso(instant);
}

몇 가지 함정이 있었어요.

  1. 옮긴 주소가 다른 회차의 옛 주소와 같을 수 있어요. 매일 반복을 하루 뒤로 옮기면 10월 5일 회차의 새 주소가 10월 6일 회차의 옛 주소예요. 한 줄씩 고치면 아직 옮기지 않은 줄과 부딪혀요. 그래서 옮길 줄을 모두 읽어 지운 뒤 새 주소로 다시 넣어요.
  2. 서머타임 때문에 없는 시각이 있어요. 뉴욕에서 2026년 3월 8일 새벽 2시 30분은 존재하지 않아요. 1시 30분 시리즈를 한 시간 늦추면, 그날 회차에 붙은 기록의 새 주소가 없는 시각이 돼요. 이때 3시로 짐작하지 않고 고치기를 거절해요(series_split_conflict). 원본은 그대로 남아요.
  3. 두 주소가 하나로 합쳐질 수 있어요. 같은 날에 회차가 둘 있는 시리즈를 종일로 바꾸면 두 회차의 새 주소가 같은 날짜가 돼요. 두 기록 중 하나를 버리지 않고 역시 거절해요.
  4. 연 회차에 따로 옮긴 시각이 있었다면 걷어 내요. 19일 회차를 화요일로 옮겨 둔 채 그 회차를 열어 "모두"를 1시간 늦추면, 남겨 둔 옮긴 시각이 방금 고른 시각을 가려요. 그래서 연 회차의 옮긴 시각만 걷어 내고 다른 회차의 예외는 그대로 둬요. Google 캘린더와 Apple 캘린더도 이렇게 해요.

회차의 주소는 정체성이에요. 시리즈를 고치는 쪽이 주소를 함께 옮기고, 옮길 수 없으면 짐작하지 말고 고치지 않아요.

"이 회차와 이후 모두"는 시리즈를 둘로 나눠요

"이후 모두"를 고르면 시리즈를 나눠요. Google과 Apple이 하는 방식과 같아요. 앞 시리즈 규칙에 그 회차 1초 전까지라는 끝(UNTIL)을 걸고, 그 회차부터는 새 시리즈를 만들어 이전 시리즈를 가리키게 해요(split_from). 횟수 규칙이면 앞에서 이미 지난 횟수를 빼서 넘겨요.

끝냄새 시리즈의 첫 회차
앞 시리즈
  1. 10월 5일 월9:00끝냄
  2. 10월 12일 월9:00끝냄
새 시리즈
  1. 10월 19일 월10:00여기서 나눔
  2. 10월 26일 월10:00회차 알림 이어받음
  3. 11월 2일 월10:00
10월 19일 회차에서 '이후 모두'로 시각을 바꿨어요. 지난 회차와 그 기록은 앞 시리즈에 남고, 앞으로의 회차와 기록은 새 시리즈의 새 주소로 넘어가요.

어려운 건 규칙이 아니라 규칙에 붙어 있던 것들이에요. 새 시리즈는 같은 일이니 같은 관계를 이어받아야 해요. 공유와 고치기 권한, 참석자, 태그, 첨부, 안에 넣은 할 일, 그리고 미래 회차의 끝냄, 개별 수정, 회차 알림이요. 지난 회차와 이력은 앞 시리즈에 남겨요. 이 모든 것을 한 트랜잭션 안에서 해요. 중간에 하나라도 실패하면 새 시리즈도, 옮긴 기록도 모두 되돌려요.

/** 나눌 수 없는 까닭(없으면 null) */
export function splitBlock(f: SplitFacts, from: string, expectedRevision: string | undefined, now: number) {
  const root = f.rows.find((r) => r.id === from);
  if (!root || root.deleted) return "series_not_found";
  if (root.calendarMoved || f.rows.some((r) => !r.deleted && r.calendarMoved) || expectedRevision === undefined || root.revision !== expectedRevision) return "series_split_conflict";
  if (f.external) return "series_split_sync_unsupported";
  if (f.pendingAlarmClaims.some((at) => now - at < ALARM_CLAIM_STALE_MS)) return "series_split_conflict";
  // …
  return null;
}

나누기 전에 관련된 행을 잠그고 사실을 읽은 뒤, 나눠도 되는지는 순수 함수 하나가 정해요. 읽은 뒤 다른 곳에서 그 시리즈를 고쳤으면(revision이 다르면) 나누지 않아요. 두 기기가 같은 시리즈에서 거의 동시에 "이후 모두"를 눌러도 새 시리즈가 둘 생기지 않아요. 그 시리즈의 알림을 지금 막 보내는 중이면 나누지 않아요. 다만 5분 넘게 그대로인 것은 보내다 멈춘 것으로 보고 막지 않아요.

시험이 지키는 것

반복은 고치다 보면 다른 곳이 깨지기 쉬운 곳이라, 지켜야 할 것을 시험으로 적어 두었어요.

  • 펼치기(DB 없이): 서머타임에도 현지 9시, 뺀 회차와 취소한 회차는 없고 옮긴 회차는 같은 주소, 구간 밖에서 옮겨 온 회차, 반복이 끝나 규칙에서 빠진 회차의 옮긴 기록은 보이지 않기, 시각 시리즈의 UNTIL.
  • 오래된 반복 당기기: 12가지 규칙에서 처음부터 센 회차와 똑같은지.
  • 주소 옮기기: 시간을 안 바꾸면 주소 글자까지 그대로, 없는 시각이나 겹치는 주소면 거절.
  • 나누기(빈 DB에 마이그레이션을 돌린 PGlite에서): 주소가 겹치면 새 시리즈와 지운 것까지 모두 되돌려 원본 보존, 같은 revision의 두 번째 나누기는 중복 없이 실패, 이미 보낸 알림 기록과 다른 사람의 알림 보존, 나눈 뒤에도 주인만 고칠 수 있는 항목은 그대로 주인만.

배운 것

반복을 규칙으로 저장하면 저장은 단순해지고, 그 대가로 "주소"라는 생각을 끝까지 지켜야 해요. 회차는 없지만 회차를 가리키는 기록은 여기저기 있어요. 끝냄, 알림, 보낸 알림, 먼저 할 일, 안의 체크리스트까지요. 시리즈를 바꾸는 코드가 그 기록을 모두 알고 함께 옮겨야 해요.

그리고 모르면 짐작하지 않아요. 없는 시각을 가장 가까운 시각으로 바꾸거나 겹친 기록 중 하나를 버리면 그 순간은 매끄러워 보여요. 하지만 사용자는 며칠 뒤 사라진 체크를 보게 돼요. 원본을 그대로 두고 "이건 못 해요"라고 말하는 쪽이 캘린더에는 더 맞는 답이에요.

The ikie teamikie is a calendar for your events and to-dos in one place. Here we write about the problems we run into while building it, and how we solve them.