앱인토스 미니앱 5 – 경조사 봉투장부
앱인토스 미니앱 제작기 다섯 번째는 경조사 봉투장부입니다. 축의금이나 부의금을 누구에게 얼마 보냈고 얼마 받았는지 적어 두는 앱이에요.
“저번에 그 친구 결혼식 때 얼마 했더라” 하는 순간이 누구에게나 있잖아요. 이 앱은 그때 꺼내 보는 장부입니다. 매일 쓰는 앱이 아니라는 점을 기준으로 삼았고, 이 글은 거기서 나온 결정들을 적은 기록입니다.
경조사 봉투장부는 어떤 앱인토스 미니앱인가



화면은 하단 탭 기준으로 홈, 장부, 내 기록 참고 세 개입니다. 홈에서는 보낸 금액과 받은 금액 합계를 나눠서 보여주고, 장부에서는 이름이나 관계, 행사로 기록을 찾습니다. 내 기록 참고는 사람과 행사를 고르면 그 사람에게 내가 보냈던 기록만 추려 주는 화면이에요.
위 화면의 이름과 금액은 시연용으로 넣은 예시입니다.
다시 찾는 때는 ‘다음 경조사’
앞에서 다룬 물 마시기나 카드값 페이스는 매일 열 이유를 만드는 게 과제였습니다. 이 앱은 사정이 달라요. 경조사는 한 달에 한 번 있을 수도 있고 반년 동안 없을 수도 있으니까요.
매일 쓰는 앱
- 연속 기록, 매일 알림이 어울린다
- 어제와 오늘을 이어 주는 게 중요
행사 때 쓰는 앱
- 다시 찾는 단위가 하루가 아니라 다음 경조사
- 그때 필요한 걸 바로 찾게 해 주는 게 중요
그래서 이 앱에는 매일 출석을 세는 기능을 넣지 않았고, 알림도 앱을 열자마자 묻지 않습니다. 기록을 한 건 이상 남기면 홈에 ‘매주 금요일 오전 10시 알림 받기’ 버튼이 생기고, 직접 누른 사람에게만 장부를 확인하라는 알림이 갑니다. 정해진 주기가 없는 일이라 알림은 원하는 사람만 받게 했어요. 대신 기록이 쌓이는 만큼 올라가는 장부 등급을 두고, 오랜만에 열었을 때 첫 화면에서 바로 검색하고 바로 기록할 수 있게 하는 데 힘을 썼습니다.
앱인토스 미니앱 2 – 카드값 페이스사적인 기록이라서 넣지 않은 것
누구에게 얼마를 보냈는지는 꽤 민감한 정보입니다. 그래서 몇 가지는 넣지 않았어요.
공유 기능이 없습니다. 다른 앱에서는 결과를 카드로 만들어 공유하게 하는 경우가 많지만, 관계와 금액이 담긴 기록을 공유할 거리로 만들고 싶지 않았습니다.
이름을 꼭 실명으로 적지 않아도 됩니다. 입력란에 “김민수 대리, 사촌형” 같은 예시를 넣어서 별칭으로 써도 된다는 걸 알려 주고, 검색도 별칭으로 되게 했어요.
기록은 기기 안에만 저장하고 서버로 보내지 않습니다.
개선 기획에서 정한 약속
경조사 봉투장부는 처음 만든 뒤 개선 기획을 따로 세워 한 번 더 손봤습니다. 앱이 하는 약속을 좁히는 기획이었고, 첫머리에 적은 문장은 이렇습니다.
기록이 실제로 저장됐는지 확인하고, 다음 행사 때 내 과거 기록을 빠르게 찾는다.
약속하지 않기로 한 것도 적어 뒀어요. 기기를 바꾸거나 앱 데이터를 지운 뒤에도 기록이 남는다는 말은 하지 않습니다. 홈 맨 아래에 “현재 장부는 이 기기의 앱 저장공간에 보관돼요. 앱 데이터 삭제나 기기 변경 시 옮겨지지 않을 수 있어요.”라는 문구를 그대로 둔 것도 그래서입니다.
하단 탭은 홈, 장부, 내 기록 참고 순서로 세 개를 유지하고 개수는 늘리지 않았습니다. 세 번째 탭은 원래 봉투 금액을 추천하던 자리였는데, 같은 자리를 내 기록 참고로 바꿨어요. 사람 한 명과 행사 하나를 고르면 그 사람에게 내가 보냈던 기록만 나오고, 줄마다 “과거 기록”이라는 이름표가 붙습니다. 지난 금액이 다음에 보낼 적정 금액처럼 읽히지 않게 하자는 게 기획안의 기준이었거든요.

같은 행사에 보낸 기록이 없으면 다른 행사 기록을 합쳐 비슷한 값을 만들어 내지 않습니다. “이 행사에서 내가 보낸 기록은 아직 없어요”라는 안내와 장부 검색 버튼만 보여줘요. 처음 연 사람에게 예시 기록을 미리 채워 두지도 않았습니다. 빈 장부에는 “아직 기록이 없어요”와 “첫 기록 남기기” 버튼, 짧은 안내 한 줄만 있어요.
앱인토스 미니앱 11 – 체중 다이어리새 기록을 남기는 순서
경조사 봉투장부에서 기록 입력은 홈의 “새 기록 남기기”에서 시작합니다.
- “내가 보낸 돈”과 “내가 받은 돈” 중 하나를 고른다
- 이름 또는 별칭과 금액을 적는다. 금액은 직접 치거나 금액 버튼을 눌러 더한다
- 경조사 종류(결혼식, 장례식, 돌잔치, 생일, 개업, 기타)와 관계를 고른다
- 날짜는 오늘로 채워져 있고, 메모는 적고 싶을 때만 쓴다
- “기록 저장”을 누르면 기록을 저장했어요 확인 창이 뜬다
시트를 처음 열면 보낸 돈인지 받은 돈인지, 행사와 관계는 아무것도 골라져 있지 않고 금액 칸도 비어 있습니다. 기획안에서 행사 칩을 미리 골라 두지 않고 모두 같은 강조로 보여주기로 정했어요. 하나라도 비운 채 저장을 누르면 “구분, 이름, 금액, 행사, 관계를 모두 입력해 주세요.”라는 안내가 나옵니다.

쓰다가 닫으려고 하면 바로 닫히지 않고 “기록을 버리고 닫을까요?”라고 한 번 묻습니다. “계속 작성”을 누르면 적던 내용이 그대로 남아 있고, 아무것도 입력하지 않았을 때는 묻지 않고 바로 닫혀요. 토스 앱의 뒤로 가기를 눌러도 같은 확인을 거칩니다. 홈 화면에서는 뒤로 가기를 가로채지 않아서, 그때는 미니앱이 평소처럼 닫히고요.
지울 때도 장부에서 기록 옆의 삭제 버튼을 누르면 “‘이름’ 기록을 장부에서 삭제할까요?”가 뜨고, “유지”와 “삭제” 중 하나를 골라야 지워져요.
읽기에 실패한 것과 기록이 없는 것은 다르다
돈 기록을 다루는 앱에서 제일 피하고 싶은 장면은, 기록이 멀쩡히 있는데 앱이 빈 장부를 보여주는 겁니다. 그래서 저장된 기록을 읽은 결과를 세 가지로 나눴습니다.
export function readLedgerEntries(storage: StorageLike, key: string): LedgerReadResult {
let raw: string | null;
try {
raw = storage.getItem(key);
} catch {
return { status: 'unavailable' };
}
if (raw === null) return { status: 'ready', entries: [] };
try {
const parsed: unknown = JSON.parse(raw);
if (!Array.isArray(parsed) || !parsed.every(isLedgerEntry)) return { status: 'corrupt' };
return { status: 'ready', entries: parsed };
} catch {
return { status: 'corrupt' };
}
}세 가지 상태를 따로 다룬다
저장된 게 아예 없으면 빈 장부가 맞습니다. 하지만 저장소를 못 읽었거나 내용이 깨져 있을 때는 빈 장부로 바꿔 보여주지 않아요. 빈 장부로 보이면 사용자가 새로 기록을 시작하고, 그 순간 원래 기록을 덮어쓸 수 있기 때문입니다. 항목 하나하나의 모양까지 확인하는 것도 같은 이유예요.
저장이 됐을 때만 ‘저장했어요’
저장 쪽도 같은 생각으로 짰습니다. 저장 함수는 성공했는지를 참과 거짓으로 돌려줍니다.
export function writeLedgerEntries(storage: StorageLike, key: string, entries: LedgerEntry[]): boolean {
try {
storage.setItem(key, JSON.stringify(entries));
return true;
} catch {
return false;
}
}화면에서는 이 값이 참일 때만 “기록을 저장했어요”를 띄웁니다. 저장하지 못했을 때는 입력한 내용을 그대로 둔 채 다시 시도하라고 알려줘요. 기기 저장 공간이 꽉 찼을 때 저장된 줄 알고 넘어가는 일이 없게 하려는 겁니다.
전면 광고도 이 순서를 따릅니다. 앱을 열고 처음 저장할 때는 나오지 않고, 그다음 저장부터 저장 완료를 먼저 보여준 뒤에 안내를 거쳐서만 나올 수 있어요. 기록이 남았는지 확인하는 순간을 광고가 가리면 안 된다고 봤습니다.
기록을 못 읽었을 때 보이는 화면
앞에서 나눈 세 가지 상태 가운데 ‘손상’이나 ‘사용 불가’가 나오면 장부 대신 아래 화면이 뜹니다. 내용이 깨져 있을 때는 “저장된 기록을 읽을 수 없어요”, 저장소에 아예 접근하지 못할 때는 “앱 저장공간에 접근할 수 없어요”가 제목으로 나오고, 어느 쪽이든 “다시 불러오기”로 다시 읽어 볼 수 있어요.

위 화면은 로컬에서 저장된 값을 일부러 깨뜨려 놓고 찍었습니다. 이 상태에서는 새 기록 입력 시트가 열리지 않고, 저장 함수도 쓰기 전에 바로 실패를 돌려줘요. 원래 내용 위에 새 기록이 덮어써지지 않게 쓰기를 잠시 막아 두는 거예요.
경조사 봉투장부의 읽기·쓰기 함수는 저장소를 흉내 낸 작은 테스트로 확인합니다. 그중 이런 경우를 봐요.
- 저장된 값이 없으면 빈 장부로 읽는다
- JSON이 깨져 있으면 ‘손상’으로 알리고, 저장돼 있던 원래 문자열은 그대로 남는다
- 저장소를 읽다가 오류가 나면 ‘사용 불가’로 알린다
- 쓰기에 실패하면 거짓을 돌려주고, 그 전에 저장된 값은 바뀌지 않는다
예전 주소에 남은 기록 옮겨 오기
앱인토스 미니앱이 열리는 주소(Origin)는 예전 web.tossmini.com에서 지금 apps.tossmini.com으로 바뀌었습니다. 브라우저 저장소는 주소마다 따로 있어서, 예전 주소에 남은 장부를 지금 주소로 옮겨 오는 코드를 앱을 열 때 한 번 돌려요. 토스가 제공하는 Migration.getOriginStorage()가 두 주소의 저장소를 함께 읽어 줍니다.
export async function migrateOriginLocalStorageOnce({ keys, markerKey = '__ait_origin_migrated_v1__' }: Options) {
try {
if (localStorage.getItem(markerKey)) return true;
if (!('ReactNativeWebView' in window)) return false;
const { Migration } = await import('@apps-in-toss/web-framework');
const { previous, current } = await Migration.getOriginStorage();
if (previous.errors.length || current.errors.length) return false;
for (const key of keys) {
const previousValue = previous.localStorage[key];
const currentValue = current.localStorage[key];
if (currentValue == null && localStorage.getItem(key) == null && previousValue != null) localStorage.setItem(key, previousValue);
}
localStorage.setItem(markerKey, new Date().toISOString());
return true;
} catch {
return false;
}
}지금 값이 없을 때만 옮긴다
예전 주소에 값이 있고 지금 주소에는 값이 없을 때만 옮깁니다. 그래서 지금 주소에 쌓인 기록은 덮어쓰지 않아요. 옮기기가 끝나면 표시를 남겨 다음부터는 건너뛰고, 읽다가 오류가 나면 표시를 남기지 않아 다음에 앱을 열 때 다시 시도합니다. 장부를 읽는 일은 이 과정이 끝난 뒤에 시작해요.
내가 보낸 기록만 추려 보기
“그 사람한테 얼마 했더라”에 답하는 화면이 내 기록 참고입니다. 사람과 행사를 고르면 이 한 줄이 기록을 추려요.
const records = entries.filter(e => e.type === 'given' && e.name === name && e.event === event).sort((a,b) => b.date.localeCompare(a.date));내가 보낸 기록 가운데 그 사람, 그 행사에 해당하는 것만 골라 최근 날짜부터 보여줍니다. 받은 금액은 여기에 섞지 않고, 내가 보냈던 기록만 깔끔하게 보이게 했어요.
다음에 할 일
이 앱은 기능을 늘리기보다 지금 있는 흐름을 매끄럽게 하는 쪽으로 다듬으려고 합니다. 오랜만에 연 사람이 첫 화면에서 망설이지 않는지, 사람들이 실제로 어떤 말로 검색하는지를 보고 문구를 맞춰 가는 일이에요.
그 흐름 안에서 11월 3일 개선 때 장부를 보는 방법을 두 가지 더했습니다. 아래쪽 탭의 ‘사람별’은 같은 이름(띄어쓰기는 무시)으로 적은 기록을 모아 상대마다 주고받은 금액을 보여 주고, 받기만 하고 아직 보낸 기록이 없는 분을 따로 모아 줘요. 올해 리포트는 1월 1일부터 오늘까지 보낸 돈과 받은 돈을 월별로 나눠 보여 주며, 날짜가 아직 오지 않은 기록은 빼고 셉니다. 두 화면 모두 기기 안에 저장된 기록만으로 계산해요.


프로젝트를 어떤 식으로 진행하는지는 프로젝트 진행 방식에, 매일 열 이유를 만든 앱 이야기는 카드값 페이스 글에 있습니다.
경조사 봉투장부 자주 묻는 질문
경조사 봉투장부는 어떤 앱인가요?
결혼식, 장례식, 돌잔치 같은 경조사 때 주고받은 금액을 이름이나 별칭으로 기록해 두고, 다음 경조사 때 예전에 얼마를 보냈는지 찾아보는 앱입니다.
기록은 어디에 저장되나요?
기기 안에만 저장합니다. 기록을 서버로 보내지 않습니다.
알림이나 공유 기능이 있나요?
알림은 기록을 한 건 이상 남긴 뒤 홈의 ‘알림 받기’를 직접 눌렀을 때만 켜지고, 매주 금요일 오전 10시에 장부 확인 알림이 와요. 사적인 관계와 금액이 담긴 기록이라 공유 기능은 넣지 않았습니다.
업무에 맞춘 AI 설계 상담은 AI특별시에서 받습니다.
이 글은 앱인토스 미니앱 「경조사 봉투장부」의 기록입니다. 앱인토스는 토스 앱 안에서 미니앱을 서비스하는 플랫폼이고, 공식 안내는 앱인토스 개발자센터에 있습니다.
이 글은 공식 자료와 실제 화면을 기준으로 정리했습니다. 정책·가격은 기준일 이후 바뀔 수 있습니다.

One Comment