ikie에는 유료 플랜 Hyper ikie가 있어요. 외부 캘린더 계정을 여럿 잇기, 고치기 규칙 두기, 다른 사람의 캘린더가 낀 남는 시간 찾기, 연결한 도구(MCP) 부르기, 깃발 단 일 반짝이기 같은 것이에요. 출시는 무료라 지금은 막기를 꺼 뒀지만, 구조는 미리 만들었어요.
결제를 붙일 때 가장 쉬운 방법은 사용자 표에 plan = 'plus' 칸을 두는 거예요. 우리는 그 칸을 두지 않았어요.
플랜이 아니라 사실을 적어요
ikie가 적는 것은 권리(entitlement)라는 사실이에요. 한 줄이 "이 사람에게 이 상품이 언제까지 있다"예요.
| 칸 | 뜻 |
|---|---|
| source | 어디서 왔나: App Store 구독, 또는 직접 준 것(grant) |
| product_id | 어떤 상품인가 |
| original_transaction_id | App Store 구독의 정체. 구독 하나는 한 사람에게만 붙어요 |
| expires_at | 낸 기간이 끝나는 때 |
| grace_until | App Store 결제 유예가 끝나는 때 |
| revoked_at | 환불 등으로 거둔 때 |
플랜은 이 줄들에서 계산해요.
export const entitlementEnd = (e) => (e.expiresAt === null ? null : Math.max(e.expiresAt, e.graceUntil ?? e.expiresAt));
export const entitlementLive = (e, now) => { const end = entitlementEnd(e); return e.revokedAt === null && (end === null || end > now); };
export function activeEntitlement(rows, now) {
const on = rows.filter((e) => entitlementLive(e, now) && planOfProduct(e) === "plus");
return on.sort((a, b) => (entitlementEnd(b) ?? Infinity) - (entitlementEnd(a) ?? Infinity))[0] ?? null;
}
export const planOf = (rows, now) => (activeEntitlement(rows, now) ? "plus" : "free");
해지해도 낸 기간이 끝날 때까지는 Hyper예요. App Store가 결제를 다시 시도하는 유예 기간에도 Hyper고요. 환불하면 거둔 때부터 무료예요. 이 모든 것이 "지금 이 순간 살아 있는 권리가 있나" 하나로 정해져요. 지금 시각은 인자로 받는 순수 함수라 시험도 데이터베이스 없이 해요.
플랜 칸을 저장했다면 어땠을까요? 만료되는 순간에 누군가 그 칸을 바꿔야 해요. 크론이 늦거나 App Store 알림이 늦으면 그 사이는 틀린 값이에요. 관리 화면에서 직접 줄 때도, 환불될 때도 칸을 맞춰야 하고요. 계산하면 그런 순간이 없어요. 관리 화면의 "Hyper 주기·거두기"도 권리 줄을 더하거나 거두는 것일 뿐이에요.
기능마다 무엇을 셀지도 한 곳에
유료 후보 기능과 무료 한도는 한 파일에 적어요.
| 기능 | 무료 | 셈 |
|---|---|---|
| 캘린더 계정 | 1개 | 개수. iPhone 캘린더와 .ics 구독은 세지 않아요 |
| 고치기 규칙 | Hyper만 | 켜고 끔 |
| 연결한 도구 | Hyper만 | 켜고 끔 |
| 남는 시간 | 나와 내 캘린더만 무료 | 켜고 끔 |
| 반짝임 | Hyper만 | 켜고 끔 |
막기를 켤지, 기능마다 한도를 얼마로 할지, 무엇을 팔지는 서버 설정이에요. 관리 화면에서 바꾸고, 계산은 검사를 거친 규칙으로 받아요.
기능을 쓰는 서버 코드(쓰임새, use case)는 쓰기 전에 플랜 문(gate)을 지나요. 막기가 꺼져 있으면 문은 권리를 읽지도 않고 열려요. 막히면 402 plus_required와 어떤 기능의 어떤 한도인지를 돌려줘요. 웹은 모든 API 답에서 이것을 받아 한 곳에서 Hyper 안내를 띄워요. 연결한 Claude에게는 도구 결과로 같은 plus_required를 돌려줘요. 화면이 "이 사람은 유료인가"를 다시 정하지 않아요.
끝나도 아무것도 지우지 않아요
플랜이 끝났을 때가 더 어려운 문제였어요. 캘린더 계정을 셋 이은 사람이 무료가 되면, 둘은 어떻게 해야 할까요? 끊어 버리면 다시 구독할 때 처음부터 다시 이어야 하고, 그 사이 일정이 엉켜요. 설정을 바꾸면 사용자가 둔 것을 앱이 몰래 고친 셈이에요.
원칙은 한 줄로 정했어요. 데이터는 사용자가 둔 그대로 두고, 읽기와 쓰기가 같은 함수로 지금 플랜을 본다. 다시 Hyper가 되면 그대로 이어진다. 기능마다 끝날 때의 방식을 셋 중 하나로 선언했어요.
- 넘는 것은 멈춰요(holdOver). 무료 한도를 넘는 캘린더 계정은 받기·보내기를 모두 멈추고, 마지막 모습 그대로 판에 읽기 전용으로 보여요. 무엇을 남길지는 사용자가 "이 계정 남기기"로 골라요.
- 둔 것은 지켜요(keepExisting). 이미 둔 고치기 규칙은 그대로 쓰이고, 새로 두거나 바꾸는 것만 막아요. 빼기는 늘 돼요.
- 쓸 때 막아요(blockUse). 연결한 도구, 남는 시간, 반짝임은 쓸 때마다 문을 지나니 끝나면 그때부터 못 써요.
여기서도 "멈춤"은 저장하지 않아요. 요청마다 계정 주인의 플랜과 계정 목록으로 계산해요. 남길 계정은 사용자가 고른 때(kept_at)가 최근인 것부터, 그다음 먼저 이은 것부터예요.
export const PLAN_LAPSE = { calendarAccounts: "holdOver", editPolicies: "keepExisting", connectedTools: "blockUse", freeTime: "blockUse", glow: "blockUse" };
멈춤을 저장하지 않으니, 다시 구독하는 순간 되돌릴 것이 없어요. 다음 요청부터 계산이 "멈춘 게 없다"고 답하고, 맞추기는 마지막으로 맞춘 기준에서 그대로 이어져요.
하나의 판단을 셋이 같이 봐요
멈춘 계정은 읽기, 쓰기, 외부 캘린더 맞추기가 모두 똑같이 다뤄야 해요. 읽기는 읽기 전용으로 보이는데 쓰기가 받아 주면 안 되고, 맞추기가 몰래 보내도 안 되니까요. 그래서 셋이 한 곳을 봐요. 요청마다 주인별로 멈춘 계정을 한 번 계산해 두고, 그 사실이 고치기 판단(canEdit)의 입력으로 들어가요. 공유받은 캘린더라면 내 플랜이 아니라 그 계정 주인의 플랜을 봐요. 동기화 엔진은 플랜을 몰라요. 멈춘 계정 목록만 받아요.
시험도 이 원칙을 봐요. 잇는 길을 거치지 않고 데이터베이스에 바로 넣은 둘째 계정도 무료가 되면 멈추는지, 다시 Hyper가 되면 그대로 이어지는지, 끝난 뒤에도 둔 고치기 규칙이 남는지를 확인해요.
반짝임도 계산해요
깃발 단 일의 반짝임도 저장하지 않아요. 서버가 판을 읽을 때 "깃발이 있나 × 반짝이기 설정이 켜져 있나 × 플랜이 허락하나"로 정해 줘요. 화면은 받은 대로 그려요. 플랜이 끝나면 반짝임은 멈추지만 깃발은 남아요. 깃발은 사용자가 둔 사실이고, 반짝임은 그 위에 계산한 것이니까요.
App Store는 어댑터 뒤에
App Store 거래와 서버 알림은 Apple의 공식 라이브러리와 Apple 루트 인증서로 서명을 확인해요. 이 확인은 포트 뒤의 어댑터라 쓰임새는 "확인된 거래"만 받아요. 모르는 상품이거나, 거래에 적힌 계정이 다른 사람이거나, 그 구독이 이미 다른 사람에게 붙어 있으면 받지 않아요. iOS 앱은 거래를 서버에 넘기고, 서버가 받을지 말지 답한 뒤에야 거래를 끝내요(finish). 서버에 닿지 못했으면 끝내지 않아서, 다음에 앱을 열 때 다시 넘겨요.
배운 것
플랜은 시간이 지나면 저절로 바뀌는 값이에요. 그런 값을 저장하면 언젠가 누군가 제때 바꿔야 하고, 그 "제때"가 늘 버그가 돼요. 사실(권리)만 적고 지금 시각으로 계산하자, 해지·유예·환불·직접 주기가 모두 같은 함수 하나로 풀렸어요. 끝날 때도 같았어요. 지우거나 바꾸지 않고 계산으로 멈추니, 다시 돌아오는 사람에게 되돌릴 것이 없어요.