ikieEngineeringGet started
All posts

오프라인iOS웹앱 정책

끊겨도 쓰고, 이어지면 알아서 보내요

지하철에서 끝낸 할 일도, 비행기에서 옮긴 일정도 ikie는 바로 보여 주고 이어지면 알아서 서버로 보내요. 무엇을 기다리게 하고 무엇을 거절할지, 두 번 가도 하나만 생기게 하는 법, 모든 쓰기를 한 줄로 세웠다가 다시 나눈 이야기를 적어요.

English

캘린더와 할 일은 연결이 가장 나쁠 때 쓰게 돼요. 지하철에서 할 일을 끝내고, 비행기에서 다음 주 일정을 옮기고, 엘리베이터 안에서 생각난 일을 적어요. 그때 "연결을 확인해 주세요"가 뜨면 사람은 다시 적지 않아요. 그래서 ikie는 끊긴 동안에도 쓰기를 받아요. 화면에는 바로 반영하고, 서버로 보낼 것은 기기에 남겼다가 이어지면 알아서 보내요.

먼저 보이고, 나중에 보내요

쓰기는 두 단계로 나눠요. 먼저 기기에 든 판(날짜별 일정·할 일)을 바꿔 화면에 보이고, 서버로 보낼 쓰기는 대기열에 넣어요. 서버가 받으면 끝이에요. 서버가 거절하면 그 쓰기가 바꾼 날만 되돌려요. 다른 날, 다른 쓰기의 반영은 그대로 둬요.

웹은 따로 된 대기열을 만들지 않았어요. TanStack Query의 변이(mutation) 캐시가 이미 "멈춘 쓰기를 들고 있다가 이어지면 다시 보내기"를 해 주거든요. 그 캐시를 기기에 저장해 다시 열어도 남게 했어요. iOS는 사람마다 파일 하나에 대기열을 둬요. 위젯, Siri, 공유 시트처럼 앱 밖에서 한 쓰기도 앱 그룹(App Group) 공유 폴더에 남겨 두면, 앱이 열릴 때 같은 대기열로 가져가요.

기다려도 되는 쓰기만 기다려요

모든 쓰기가 나중에 보내도 되는 것은 아니에요. 기준은 하나예요. 두 번 가도 결과가 같은가.

쓰기끊겼을 때까닭
끝냄, 상태, 깃발, 옮기기, 저장, 지우기, 되살리기, 태그, 초대 응답기다려요값을 정하는 쓰기라 다시 보내도 같아요
만들기, 한 줄 적기, 안에 넣기기다려요앱이 id를 정해 보내요. 같은 id면 하나만 생겨요
메모·링크 덧붙이기거절해요덧붙이기는 두 번 가면 두 줄이 돼요
지금 하기, 기간 맞추기거절해요서버가 지금 시각과 그 안의 일정을 보고 정해요
설정, 계정, 공유거절해요기다렸다 바꿀 일이 아니에요

거절할 때는 판을 바꾸지 않고 "연결되면 할 수 있어요"라고 말해요. 반쯤 된 것처럼 보이게 두는 것보다 낫다고 봤어요.

두 번 가도 하나만 생겨요

끊긴 채 만든 할 일이 걱정거리예요. 요청이 서버에 닿고 답이 돌아오는 길에 끊기면, 앱은 만들어졌는지 모르고 다시 보내요. 그대로 두면 할 일이 둘이 돼요.

그래서 새 항목의 id는 앱이 정해요(UUID). 서버는 그 id로 한 번만 만들어요.

  • 그 id가 이미 있고 내가 고칠 수 있으면, 다시 만들지 않고 그 id를 돌려줘요.
  • 그 id가 다른 사람의 것이면 409(id_taken)로 거절해요.
  • 두 요청이 동시에 넣다 부딪히면 다시 읽어서 하나를 돌려줘요.

이를 위해 새 표나 Idempotency-Key 머리글을 두지 않았어요. 항목의 id 자체가 "같은 쓰기"를 알아보는 열쇠예요. 끊긴 채 만든 할 일을 바로 끝내거나 그 안에 할 일을 적어도, 그 쓰기들은 같은 id를 가리켜요. 만들기가 먼저 가야 하니 그 뒤에 서요.

답마다 할 일을 정해 뒀어요

보낸 쓰기의 답은 셋 중 하나로 나눠요. 보냈다(sent), 남긴다(keep), 버린다(drop).

답결과까닭
닿지 못함, 408, 429, 5xx남겨요2·5·15·60초 뒤 다시. 이어졌다는 신호가 오면 바로
401남겨요로그인이 풀렸을 뿐이에요. 버리면 끊긴 동안 한 일을 말없이 잃어요
404인데 지우기보냈어요이미 지워졌으니 할 일이 끝났어요
400, 403, 404, 409버려요다시 보내도 같은 답이에요. 다 보낸 뒤 못 보낸 것으로 보여요

쓰기 하나를 버리면 같은 항목을 가리키는 뒤 쓰기도 함께 버려요. 만들기가 거절됐는데 그 항목의 끝냄을 보내 봐야 같은 답이 오니까요.

몇 가지 시간도 정해 뒀어요. 와이파이는 잡혔는데 인터넷이 없을 때처럼 기기는 이어졌다고 믿는데 실제로는 안 되는 때가 있어요. 그래서 기다리는 쓰기가 있으면 30초마다 판을 받아 보며 이어졌는지 확인해요. 하루 넘게 기다린 쓰기는 이어져도 바로 보내지 않고 "보낼까요?"라고 물어요. 그 사이 다른 기기에서 같은 칸을 고쳤다면, 하루 묵은 값으로 덮기 전에 사람이 정하는 게 맞다고 봤어요.

받은 판 위에 다시 얹어요

쓰기가 몇 시간 남아 있을 수도 있어요. 그동안 앱이 판을 새로 받으면 서버는 아직 그 쓰기를 모르니, 받은 판에는 내가 끝낸 할 일이 아직 안 끝난 채로 와요. 받은 판으로 그냥 바꾸면 끝낸 것이 되살아난 것처럼 보여요.

그래서 받은 판을 버리지 않고, 그 위에 아직 안 간 쓰기를 차례대로 다시 얹어 보여요. 얹는 계산은 웹과 iOS 모두 순수 함수라, 앱을 다시 열어도, 다른 달로 넘겨도 같은 판이 나와요.

규칙은 한 번, 해석기는 둘

여기까지의 규칙(기다릴 쓰기, 답마다 할 일, 기다리는 시간, 다시 보내는 횟수)은 웹과 iOS가 똑같이 따라야 해요. 그래서 플랫폼마다 쓰지 않고 앱 정책에 데이터로 한 번 선언해요. 웹은 TypeScript 해석기로, iOS는 그 선언에서 만든 Swift 코드를 Swift 해석기로 읽어요.

export function outboxOutcome(kind: WriteKind, status: number | null, attempt = 0): OutboxOutcome {
  const table = POLICY.outbox.outcome.value;
  if (status === null) return table.network ?? "keep";
  const out = table[`${status}.${kind}`] ?? table[String(status)] ?? table[`${Math.floor(status / 100)}xx`] ?? "drop";
  return out === "keep" && status !== 401 && attempt >= POLICY.outbox.onlineRetries.value ? "drop" : out;
}

두 해석기는 같은 시나리오 파일(대기열만 15가지 사례)로 시험해요. 규칙을 바꾸고 한쪽 해석기만 고치면, 고치지 않은 쪽의 시험이 깨져요.

한 줄로 세웠다가 다시 나눴어요

처음에는 모든 쓰기를 한 줄로 세웠어요. 차례가 확실하면 "만들기보다 끝냄이 먼저 가는" 일이 없으니까요. 끊겨 있을 때는 문제가 없었어요. 문제는 이어져 있을 때였어요.

대기열이 들어온 날 앱이 버벅인다는 말이 나왔고, 원인을 찾으며 쓰기의 차례도 재 봤어요. iOS 시뮬레이터에서 데모 계정으로, 서버 답을 일부러 3.4초로 늦추고 체크를 빠르게 다섯 번 눌러 쓰기가 서버로 나간 시각을 쟀어요.

0초4.5초9초
숫자로 보기
빌드초
대기열 전0.4 · 1.2 · 1.9 · 2.7 · 3.4초
한 줄 대기열0.5 · 4.1 · 7.6초 …
체크를 빠르게 다섯 번 눌렀을 때 쓰기가 서버로 나간 시각이에요. 한 줄 대기열은 쓰기마다 앞 쓰기의 왕복(3.4초)을 기다려요.

한 줄이라 쓰기마다 앞 쓰기의 왕복을 기다렸어요. 화면의 체크는 바로 바뀌었지만, 서버 답 뒤에 오는 것(끝낸 일 접기, 시트 닫힘, 알림)이 쓰기 수만큼 늦어졌어요. 더 나쁜 것도 있었어요. 쓰기 하나가 5xx를 받아 다시 보내기를 기다리면, 상관없는 다른 쓰기까지 모두 멈췄어요.

그래서 차례를 항목마다 세우게 바꿨어요. 같은 항목의 쓰기와, 그 항목이 기대는 항목(안에 넣을 위 항목, 먼저 할 일)의 쓰기만 차례를 지키고, 다른 항목은 서로 기다리지 않아요. 그리고 이어져 있는데도 서버가 계속 받지 못하는 쓰기는 두 번까지만 다시 보내요. 그래도 안 되면 화면을 되돌리고 못 보낸 목록에 보여요. 전에는 몇 분씩 다시 보내는 동안 판이 서버와 다른 채로 남아 있었거든요.

고치면서 버그 둘도 함께 잡았어요. iOS는 다시 보내기를 기다리는 동안 들어온 쓰기가 답을 받지 못해 시트의 저장 단추가 멈춰 있었어요. 웹은 요청 하나가 끊기면 앱 전체를 끊김 상태로 두고 판을 다시 받을 때까지 모든 쓰기를 멈췄어요. 지금은 서버의 답이 하나라도 오면 이어진 것으로 봐요.

같은 방법으로 iOS를 다시 쟀어요. 다른 할 일 둘을 연달아 체크했을 때 둘째 쓰기가 나간 시각이 4.16초에서 1.33초로 당겨졌어요. 다시 받기를 묶는 고침과 함께, 체크 다섯 번 동안의 요청 수는 35건에서 20건으로 줄었어요.

사람이 보는 것

대기열은 조용히 일하지만 숨지는 않아요.

  • 보낼 것이 남아 있으면 "보낼 것 3개" 막대가 떠요. 보내는 중에는 "보내는 중 · 3개"가 돼요.
  • 아직 안 간 쓰기가 닿은 줄 끝에는 작은 구름 표시가 붙어요.
  • 끊긴 채 적은 글은 "연결되면 읽을게요"라고 남았다가, 이어지면 읽혀 제자리를 찾아요.
  • 하루 넘게 기다린 것은 "보낼까요?"에 보내기·버리기를 고르게 해요.
  • 못 보낸 것은 까닭과 함께 보여요. 지워졌거나 볼 수 없어요(404), 고칠 수 없어요(403), 다른 곳에서 바뀌었어요(409), 다른 항목과 겹쳐 만들지 못했어요(id 충돌).
  • 보낼 것이 남은 채 로그아웃하려 하면 몇 개를 잃는지 먼저 알려요.

배운 것

끊긴 동안 쓰기를 받는 일은 결국 쓰기마다 "다시 보내도 안전한가"를 묻는 일이었어요. 안전하지 않아 보이는 쓰기도 모양을 바꾸면 안전해지기도 했어요. 만들기는 새 표나 머리글 없이, 앱이 id를 정하는 것만으로 안전해졌어요.

더 크게 배운 것은 끊겼을 때를 위해 만든 장치가 이어져 있을 때를 느리게 만들 수 있다는 점이에요. 한 줄 대기열은 끊긴 상황만 보면 옳았고, 이어진 상황에서 재 보고 나서야 문제가 보였어요. 고칠 때 바꾼 규칙은 정책 한 곳이었고, 두 앱은 같은 시나리오로 그 변화를 확인했어요.

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.