큐브 지갑으로 보상 흐름 만들기
앱 안에서 미션, 소비, 환불, 거래 내역을 다룰 수 있는 큐브 지갑의 첫 구조를 만든 기록입니다.
Code notes
코드에서 확인한 구현 포인트
배포 기준 2026.02.06
관련 파일
apps/web/app/api/cubes/wallet/route.tsapps/web/app/api/cubes/grant/route.tsapps/web/app/api/cubes/spend/route.tsapps/web/app/api/cubes/refund/route.tsapps/web/lib/cubes.ts구현 메모
큐브 기능은 wallet, grant, spend, refund, transactions API로 나뉘어 보상 흐름을 세밀하게 추적한다.
wallet API는 없던 지갑을 보장한 뒤 응답을 만들고, transactions API는 최신 거래를 제한된 개수로 가져온다.
보상 시스템은 악용 방지가 중요하므로 세부 검증 규칙은 공개하지 않고 책임 분리만 기록했다.
보상은 숫자보다 흐름이 중요하다
큐브는 Tangly 안에서 사용자의 행동을 보상하는 단위다. 하지만 보상 기능은 잔액만 보여준다고 끝나지 않는다.
어떤 행동으로 큐브를 받았는지, 어디에 사용했는지, 문제가 생기면 어떻게 되돌릴 수 있는지가 함께 필요하다. 그래서 지갑, 지급, 사용, 환불, 거래 내역을 하나의 흐름으로 만들었다.
신뢰를 위한 거래 내역
보상 시스템에서 가장 중요한 것은 사용자가 자신의 잔액을 믿는 것이다. 잔액이 바뀌었는데 이유를 알 수 없으면 기능 전체가 불안해진다.
거래 내역은 단순 기록이 아니라 신뢰 장치다. 큐브가 늘고 줄어든 이유를 사용자가 확인할 수 있어야 한다.
조심해야 할 부분
보상 시스템은 악용 가능성을 항상 염두에 둬야 한다. 이 글에서는 세부 검증 방식이나 내부 규칙은 공개하지 않지만, 원칙은 분명하다. 지급과 사용은 추적 가능해야 하고, 예외 상황은 되돌릴 수 있어야 한다.
Keep reading
다른 글 이어서 보기
Product
2026.02.03
7 min read
주간 루틴 체크로 관리 습관 만들기
분석 결과를 일회성으로 끝내지 않고 사용자의 주간 관리 습관으로 이어가기 위한 루틴 기능 기록입니다.
Product
2026.01.08
6 min read
미션 기능으로 사용자의 첫 행동 만들기
사용자가 앱에 들어온 뒤 무엇을 하면 좋을지 안내하기 위해 미션 기능을 만들고 관리 화면을 붙인 기록입니다.
Product
2026.01.04
7 min read
홈과 샵을 위한 배너 관리 시스템
홈, 샵, 스트립, 케어 영역에 들어가는 배너를 운영자가 직접 등록하고 순서를 조정할 수 있게 만든 과정입니다.