첫 글에서는 일정과 할 일에 붙이는 문서를 만들었어요. 블록으로 쓰고 Markdown으로 저장하고, 연결한 Claude가 글 일부를 찾아 바꿀 수 있게요. 그런데 문서가 쌓이자 찾기가 어려워졌어요. 노션처럼 페이지를 깔끔하게 정리해 보는 문서 홈이 필요했어요.
그 뒤 이틀 동안 PR 일곱 개로 문서가 페이지가 됐어요. 하위 페이지와 나무, 문서 홈, 아이콘과 표지, 일정을 만들며 문서 붙이기, 지난 판, 그리고 앱으로 열리는 링크예요.
나무는 위 문서 하나로
페이지 나무는 문서마다 위 문서 하나(parent_id)만 둬요(#895). 형제 사이의 순서는 저장하지 않아요. Notion처럼 새 페이지는 끝에 붙고, 순서는 만든 차례예요. 저장하지 않은 순서는 두 기기가 서로 다르게 고칠 일도 없어요.
나무를 짜는 일도 서버가 해요. 서버가 문서를 깊이 우선 차례로 늘어놓고 문서마다 깊이와 바로 안의 수를 붙여 보내면, 웹과 iOS는 받은 차례대로 그리고 접기만 해요.
옮길 때는 두 가지를 봐요. 위로 둘 문서와 그 위로 이어진 것 가운데 자신이 있으면 고리라서 안 되고, 옮긴 뒤 가장 깊은 곳이 정해 둔 깊이를 넘어도 안 돼요.
/** 위 문서로 둘 수 있나: 위로 이어진 것(chain)에 자신이 없어야 하고(고리), 옮긴 뒤 자신 아래 가장 깊은 것(height)이 MAX_DOC_DEPTH를 넘지 않는다 */
export function docParentOk(id: string | null, chain: readonly string[], height: number): void {
if (id && chain.includes(id)) throw new DocError("invalid_parent");
if (chain.length + height > MAX_DOC_DEPTH) throw new DocError("invalid_parent");
}
위로 이어진 것과 아래로 가장 깊은 것은 재귀 SQL 한 번씩으로 읽어요. 깊이 끝은 6(맨 위가 0이라 일곱 겹)이에요. Notion은 끝이 없지만, ikie의 나무는 사이드바에서 읽혀야 해서 그만큼으로 뒀어요. 옮기기와 지우기는 주인만 해요. 문서를 지우면 안의 페이지는 지워지지 않고 맨 위로 올라와요. 위 문서가 보이지 않는 문서(남의 것, 지운 것)도 맨 위에 놓고, 혹시 옛 데이터에 고리가 있어도 문서마다 한 번만 놓아요.
문서 홈: 저장하는 건 둘뿐
문서 홈에는 최근에 본 문서, 즐겨찾기, 다가오는 일정과 거기 붙은 문서, 모든 페이지가 있어요(#897 웹, #899 iOS). 이 가운데 새로 저장하는 사실은 두 가지예요.
| 보이는 것 | 저장하나 | 어떻게 |
|---|---|---|
| 최근에 본 문서 | 연 때(doc_visit) | 문서를 열 때마다 사람마다 한 줄을 고쳐 써요. 최근 8개 |
| 즐겨찾기 | 넣은 때(doc_favorite) | 넣은 차례 |
| 다가오는 일정 | 아니요 | 판과 같은 하루 읽기로 오늘과 내일에서 계산해요. 5개 |
| 페이지 나무 | 아니요 | parent_id에서 계산해요 |
| 미리보기 | 아니요 | 글 앞부분에서 Markdown 표시를 걷은 140자 |
다가오는 일정은 Notion 홈의 "Upcoming events"를 빌렸어요. 아직 끝나지 않은 내 일정만 시작 차례로 보이고, 남의 일정, 거절한 초대, 할 일은 빼고, 여러 날에 걸친 일정은 한 번만 보여요. 붙은 문서가 없으면 그 자리에 "회의록 만들기"가 있어요.
사람이 한 일(열었다, 넣었다)만 저장하고, 나머지는 보일 때 계산해요. 계산한 목록에는 맞출 상태가 없어요.
아이콘과 표지
아이콘은 이모지 한 글자예요. 서버는 Intl.Segmenter로 글자(grapheme) 하나인지, 그림 문자나 국기, 키캡인지, 16 코드 단위를 넘지 않는지 봐요. 피부색이나 가족 이모지처럼 여러 코드 포인트가 한 글자로 보이는 것도 받기 위해서예요. 웹은 편집기(BlockNote)가 이미 쓰는 emoji-mart를 고르기 창으로 쓰고, iOS는 이모지 키보드를 띄우는 글 칸을 써요. iOS 앱들이 보통 그렇게 해요.
표지는 색 여덟 가지(디자인 토큰, Radix 색의 5단계) 가운데 하나이거나, 그 문서에 올린 이미지예요. 이미지는 문서에 넣는 사진과 같은 길(#837)로 다뤄요. 비공개 저장소에 두고, 서버가 바로 세우기와 위치 같은 EXIF 지우기를 한 뒤 WebP로 줄이고, 볼 때마다 잠깐만 쓸 수 있는 주소로 보내요. 아이콘이나 표지만 바꾸는 것도 글 저장과 같은 줄에서 보내서, 다른 저장과 엇갈리면(409) 다시 읽고 다시 보내요.
일정을 만들며 문서 붙이기
문서를 시간표로 끌어 놓으면 그 문서가 붙은 일정이 생겨요(#906). 만들기 요청에 붙일 문서 id를 최대 열 개 함께 보내고, 일정 만들기와 붙이기를 한 트랜잭션에서 해요. 하나라도 붙일 수 없으면(없거나 볼 수 없는 문서) 일정도 만들지 않아요. 일정만 생기고 문서가 안 붙은 반쪽 상태가 남지 않게요. 붙임은 외부 캘린더로 보내지 않아요.
지난 판: 실수로 지운 링크
10월 21일, 문서의 링크를 실수로 지웠는데 되돌릴 길이 없었어요. 노션의 지난 판 같은 것이 필요했어요.
편집기의 ⌘Z는 그 화면이 열려 있는 동안만 돼요. 닫았다 열면 지운 글은 사라져요. 그래서 #924는 고치기 전의 문서를 지난 판으로 남겨 두고, 보고, 고른 판으로 되돌리게 했어요.
어려운 건 "언제 남기나"였어요. 편집기는 손이 멈추면 바로 저장해서, 저장마다 남기면 판이 순식간에 넘쳐요. 그래서 이렇게 정했어요.
/** 고치기 전의 문서를 남기나: 처음 고치거나, 남긴 지 오래됐거나, 고친 사람·앱이 바뀌었다 */
export function revisionDue(facts: DocRevisionFacts, editor: DocEditor): boolean {
if (facts.lastSavedAgoMs === null || facts.lastSavedAgoMs >= DOC_REVISION_GAP_MS) return true;
return facts.editedBy !== editor.userId || facts.editedClient !== (editor.client ?? null);
}
| 때 | 누가 | 지난 판을 남기나 |
|---|---|---|
| 9:00 | 나, 웹 | 남겨요(이 문서를 처음 고쳐요) |
| 9:00~9:08 | 나, 웹, 저장 여러 번 | 안 남겨요(같은 사람·앱이 이어 적어요) |
| 9:12 | 나, 웹 | 남겨요(마지막으로 남긴 지 10분이 지났어요) |
| 9:13 | 연결한 Claude | 남겨요(고치는 앱이 바뀌었어요) |
| 9:14 | 나, iPhone | 남겨요(다시 바뀌었어요) |
마지막 두 줄이 이 규칙의 쓸모예요. Claude가 내 문서를 고치기 직전의 내 글이 늘 남아요. 아이콘이나 표지만 바꾸면 남기지 않아요. 10분은 앱 시계가 아니라 DB 시각으로 재요.
남기는 것은 차이가 아니라 그 판 전체(제목과 글)예요. 문서마다 최근 100개만 두고, 넘으면 같은 트랜잭션에서 오래된 것부터 지워요. 판의 번호는 문서가 이미 가진 revision(첫 글의 409 충돌을 가르는 번호)을 그대로 써서, 같은 판을 두 번 남기지 않아요.
되돌리기도 되돌릴 수 있어요. 되돌릴 때는 문서를 잠그고, 지금 판을 먼저 남긴 뒤 옛 제목과 글을 써요. 그 사이 다른 기기가 고친 것도 지난 판에 들어 있어요. 지난 판은 문서를 고칠 수 있는 사람만 봐요. 읽기만 할 수 있는 사람이 이미 지운 글을 지난 판으로 보면 안 되니까요.
목록에는 판마다 누가, 어디서 고쳤는지 보여요(#925). "나", 그 사람의 이름, 이름은 모르지만 고친 앱은 아는 "다른 사람", 그리고 "웹에서", "iPhone에서", "연결한 도구로"예요. 이 기능 전에 고친 판은 누가 고쳤는지 기록이 없어서 고친 때만 보여요.
자동 저장이 잦을수록, 되돌릴 판은 시간과 손이 바뀌는 곳에 남겨요. 특히 다른 손(사람이든 도구든)이 고치기 직전의 내 글은 늘 남아야 해요.
링크를 누르면 앱에서
같은 날 문서 링크도 앱으로 열리게 하고 싶었어요. Claude나 Slack에 붙인 ikie.app/docs/… 링크를 iPhone에서 누르면 브라우저가 열렸어요.
#922는 유니버설 링크를 붙였어요. 웹이 /.well-known/apple-app-site-association에 "이 앱이 /docs/*를 연다"고 알리고, iOS 앱은 applinks:ikie.app을 가져요. 링크를 누르면 앱이 주소에서 문서 id를 읽어 오늘 탭에서 문서 시트를 열고 그 문서로 들어가요. 주소에서 id를 읽는 규칙은 편집기 안의 문서 칩과 같은 공통 정책을 써서, 웹과 iOS가 같은 주소를 같은 문서로 읽어요.
ikie:// 같은 앱 전용 주소만 쓰지 않은 까닭은 둘이에요. Claude나 Slack 같은 곳에서는 그런 주소가 눌리는 링크가 되지 않고, 앱이 없으면 아무 일도 일어나지 않아요. 유니버설 링크는 앱이 없거나 Mac에서 누르면 그대로 웹 문서가 열려요.
- #895하위 페이지, 아이콘, 표지, 즐겨찾기, 최근 본 문서, 문서 홈 읽기
- #897, #899웹과 iOS 문서 홈, 사이드바 나무, 경로
- #906일정을 만들며 문서 붙이기(한 트랜잭션)
- #922문서 링크를 누르면 앱에서
- #924–925지난 판 남기기, 보기, 되돌리기, 누가 어디서
- 다음연결한 도구(MCP)로 지난 판 읽기
남은 일
지난 판은 지금 웹과 iOS에서만 봐요. 연결한 Claude가 "어제 지운 문단 되살려 줘"를 하려면 지난 판을 읽는 도구가 있어야 하는데, 아직 없어요.
배운 것
Notion처럼 만들면서 Notion의 모양을 다 따라가지는 않았어요. 형제 순서, 홈의 목록, 나무의 깊이처럼 저장하면 맞춰야 하는 것들은 계산으로 돌렸고, 사람이 한 일(열기, 즐겨찾기, 고치기 전의 글)만 남겼어요. 그러고 나니 새 화면이 늘어도 서로 어긋날 데이터는 거의 늘지 않았어요.