앱을 허브로 바꿨더니 장부에서 같은 날이 두 번 잡혔습니다 — 식별자는 그대로, 이름만 바뀐 앱이 재수집 때 과거를 다시 쓴 이야기
앱인토스 앱 9개를 '앱 정보 변경'으로 허브로 바꾼 다음 날, 수익 장부에서 비게임 허브 4종은 같은 날 수익이 옛 이름과 허브 이름으로 두 번 잡히고 게임 허브 5종은 엉뚱한 이름으로 보이는 것을 발견했습니다. 원인은 내부 식별자는 그대로인데 장부 이름표가 'ID 하나에 이름 하나'였고, 수집이 매번 최근 14일을 다시 받기 때문이었습니다. 전환일을 가진 허브 표와 날짜 기준 이름 함수로 고치고 2,441행을 2,408행으로 정리한 과정, 그리고 이름에 유효 기간을 붙여야 하는 이유를 적었습니다
Read in English I Turned Apps Into Hubs and My Ledger Counted the Same Day Twice — When the ID Stays, the Name Changes, and a Refetch Rewrites the Past
10월 26일, 앱인토스에 올라 있던 앱 9개를 허브로 바꿨습니다. 워크스페이스 50개 한도 때문에 허브를 새 앱으로 등록할 수 없어서, 기존 앱의 이름·아이콘·번들을 바꾸는 ‘앱 정보 변경’으로 돌았습니다. 그 과정은 앱인토스 허브 전환기에 적었습니다.
이 전환에는 바꿀 수 없는 것이 하나 있었습니다. 토스가 앱을 구분하는 내부 식별자(appName)입니다. 장부에서 ‘간호조무사’로 부르던 앱이 ‘파동권 자격증’ 허브가 되어도, 콘솔과 API에서 이 앱은 여전히 nursing-quiz입니다.
이 글은 그 “식별자는 그대로, 이름만 바뀜”이 다음 날 제 수익 장부를 어떻게 꼬았는지에 대한 기록입니다. 금액은 적지 않습니다.
발단 — 짝이 엇갈린 앱들
10월 27일 저녁, 신규 출시가 몰리면서 대시보드에 토스와 Play 짝이 엇갈려 보이는 앱이 있어서 AI 에이전트에게 장부 점검을 맡겼습니다. 장부는 앱마다 토스 행과 Play(AdMob) 행을 같은 이름으로 묶어 한 줄로 보여 줍니다. 이름이 다르면 한 앱이 두 줄로 갈라집니다.
점검 결과, 엇갈림은 신규 출시가 아니라 전날의 허브 전환에서 나왔습니다. 그리고 단순히 보기 불편한 수준이 아니라 같은 날 수익이 두 번 잡힌 곳이 있었습니다.
추적 — 장부가 이름을 다루는 방식
행의 키에 이름이 들어 있습니다
장부(ledger.csv)는 날짜·플랫폼·앱 이름을 키로 행을 덮어씁니다.
1
2
3
4
5
6
def upsert(records):
...
for r in records:
k = (r['date'], r['platform'], r['app'])
...
rows[k] = r
토스 API는 앱 이름이 아니라 appName으로 수익을 줍니다. 그래서 수집기는 이름표(apps.json의 toss 항목)로 appName을 표시 이름으로 바꾼 뒤 장부에 넣었습니다. 이름표는 appName 하나에 이름 하나였고, 날짜를 몰랐습니다.
1
yield dict(date=d['date'], platform='toss', app=alias.get(app, app), ...)
수집은 매번 최근 14일을 다시 받습니다
토스 수익은 전날 몫이 다음 날 오전까지 순차로 채워지고, 지난 며칠 값도 나중에 바뀔 수 있습니다. 그래서 수집기는 매번 최근 14일을 통째로 다시 받아 덮어씁니다. 평소에는 이게 장점입니다. 몇 번을 돌려도 결과가 같고, 늦게 들어온 값도 저절로 반영됩니다.
이 두 가지가 허브 전환과 만나 증상이 두 갈래로 나왔습니다.
| 무리 | 이름표 상태 | 재수집 때 일어난 일 | 화면에 보인 것 |
|---|---|---|---|
| 비게임 허브 4종(자격증·복불복·하루상식·행운연구소) | 전환 날 허브 이름으로 바꿔 둠 | 지난 14일(10/12~25)의 개별 앱 수익이 허브 이름 키로 새로 들어옴. 옛 이름 키의 행은 그대로 남음 | 같은 날 수익이 두 줄에 한 번씩, 두 번 |
| 게임 허브 5종(퍼즐카페·뇌나이·오락실·한판승부·올림픽) | 아직 개별 앱 이름 그대로 | 10/26 이후 허브 수익이 개별 앱 이름으로 들어옴 | 파동권 올림픽은 Play만, 픽셀탁구는 토스+Play처럼 보임 |
첫 번째가 핵심입니다. 이름표를 허브 이름으로 바꾸는 순간, 수집기는 같은 appName의 지난 14일을 전부 새 이름으로 적습니다. 키에 이름이 들어 있으니 새 이름 행은 “새 행”이 되고, 옛 이름 행은 아무도 지우지 않습니다. 재수집이 과거를 고쳐 쓴 게 아니라 한 벌 더 써 버린 겁니다.
같은 일이 후기 장부에서도 일어났습니다. 8월에 받은 간호조무사 후기 5건이 ‘파동권자격증’ 이름으로 한 번 더 들어가 있었습니다.
두 번째 무리는 반대 방향의 같은 문제입니다. 이름표를 아직 안 바꿔서, 허브가 된 뒤의 토스 수익이 개별 앱 줄에 쌓였습니다. 덧붙이면 그때 게임 허브 5종은 앱 정보만 허브로 바뀌었고 수정 번들은 아직 검수 중이었습니다. 그래서 10월 26일 이후 ‘파동권 올림픽’ 이름으로 들어온 토스 수익도 실제로는 픽셀탁구 옛 번들이 번 돈이었습니다. 이름과 내용물이 하루 단위로 어긋나 있었던 셈입니다.
결론 — 이름에 전환일을 붙였습니다
고칠 방향은 분명했습니다. 이름표가 날짜를 알면 됩니다. appName이 허브로 넘어간 날부터만 허브 이름을 쓰고, 그 전 날짜는 옛 이름을 씁니다.
1. 전환일을 가진 허브 표
apps.json에 toss_hub 항목을 새로 넣고, 9건 모두 전환일과 허브 이름을 적었습니다. 기존 toss 이름표는 옛 개별 앱 이름으로 되돌렸습니다.
1
2
3
4
5
6
"toss_hub": {
"nursing-quiz": { "since": "2026-10-26", "name": "파동권자격증" },
"juice-spinner": { "since": "2026-10-26", "name": "파동권복불복" },
"pixel-pong": { "since": "2026-10-26", "name": "파동권올림픽" },
...
}
2. 날짜를 받는 이름 함수
이름을 정하는 함수 toss_name()을 공용 라이브러리에 만들었습니다.
1
2
3
4
5
6
7
8
def toss_name(cfg, app, date):
"""토스 appName 의 그날 표시명. 허브로 넘어간 appName 은 전환일(toss_hub.since)부터 허브 이름, 그 전은 옛 이름.
토스 수집은 최근 14일을 다시 받아 덮어쓰니, 이름을 날짜와 무관하게 바꾸면 전환 전 수익이 허브 행으로 옮겨 가고
옛 이름 행도 남아 이중으로 잡힌다(10/27 파동권자격증·간호조무사 10/12~24)."""
h = cfg.get('toss_hub', {}).get(app)
if h and (date or '')[:10] >= h['since']:
return h['name']
return cfg.get('toss', {}).get(app, app)
3. 토스를 쓰는 수집기 세 곳에 모두 적용
이름표를 쓰는 곳이 수익 하나가 아니었습니다. 같은 문제가 후기와 프로모션에도 숨어 있었으니 세 곳을 한꺼번에 바꿨습니다. 각자 기준으로 삼는 날짜가 다릅니다.
| 수집기 | 바꾸기 전 | 바꾼 뒤 | 기준 날짜 |
|---|---|---|---|
| 토스 광고 수익 | alias.get(app, app) | toss_name(cfg, app, d['date']) | 수익 일자 |
| 토스 후기 | 앱 이름 하나로 고정 | toss_name(names, app_name, it.get('createdAt')) | 후기 작성 시각 |
| 프로모션 목록 | alias.get(appName) | toss_name(cfg, appName, 등록 시각) | 프로모션 등록 시각 |
| 프로모션 퍼널 | alias.get(app_name) | toss_name(cfg, app_name, 오늘) | 오늘(기간 합계라서) |
Play 쪽은 따로 손볼 것이 없었습니다. Play는 개별 앱과 허브가 서로 다른 패키지라, 개별 패키지는 옛 이름 그대로, 허브 패키지는 허브 이름으로 이미 갈라져 있었습니다. 다만 앱 등록부에서 토스 자리를 허브 행이 물려받은 경우, 그 허브 행이 옛 개별 앱 이름으로 끌려가지 않도록 이름표 만드는 함수에도 허브 이름을 먼저 보게 했습니다.
4. 이미 쌓인 자료 정리
함수를 바꿔도 이미 장부에 들어간 중복 행은 남습니다. 허브 전환 9건의 옛 이름·새 이름을 appName으로 되짚어, 각 행을 날짜 기준 이름으로 다시 매기고 같은 키가 된 행은 하나만 남겼습니다.
| 파일 | 정리 전 | 정리 후 | 내용 |
|---|---|---|---|
| 수익 장부 | 2,441행 | 2,408행 | 39행 이름 바로잡음, 중복 33행 삭제, 합계 약 0.04% 감소 |
| 후기 장부 | 48행 | 43행 | 8월 후기 중복 5건 삭제 |
| 프로모션 장부 | 838행 | 838행 | 10/26 허브 프로모 지급 2행의 앱 이름 변경 |
합계가 줄어든 몫이 두 번 잡혔던 몫입니다. 전환 전 개별 앱들의 수익이 원래 크지 않아서 비율로는 작았습니다. 그래도 장부를 믿고 앱별 추세를 볼 때는 이런 중복이 “전환 뒤 허브가 잘 번다”는 착시를 만듭니다. 정리 뒤 대시보드에서는 10월 25일까지 ‘간호조무사’(토스+Play), 10월 26일부터 ‘파동권자격증’(토스)으로 나옵니다.
수정은 같은 날 밤(10월 27일 20시 52분) 장부 저장소에 한 커밋으로 들어갔습니다. 이후 허브 전환이 또 생기면 toss_hub에 한 줄만 추가하면 됩니다. 지금 이 표에는 10월 26일 전환 9건이 들어 있습니다.
한쪽에만 나와도 정상인 앱
점검하면서 “토스와 Play 짝이 안 맞는다”고 보인 앱이 모두 결함은 아니었습니다. 같이 정리해 두면 다음 점검이 빨라집니다.
- Play에만 있는 앱: 토스 워크스페이스 한도 때문에 토스에 아직 못 올린 앱들입니다.
- 토스에만 있는 허브: 그 무렵 Play 쪽 허브가 아직 출시 전이던 비게임 허브 4종입니다.
- Play 수익 줄이 없는 앱: Play 이름표는 있지만 Play 광고 수익이 아직 0이라 행이 생기지 않은 앱들입니다.
배운 것
- 식별자는 불변, 이름은 가변인 대상을 이름으로 묶으면, 재수집이 과거를 다시 씁니다. 멱등한 재수집은 “같은 키면 덮어쓴다”는 전제 위에서만 안전합니다. 키에 바뀔 수 있는 값이 들어가면 덮어쓰기가 아니라 복제가 됩니다. 가능하면 키는 식별자로 두고 이름은 표시할 때 붙입니다.
- 이름에는 유효 기간을 붙입니다. “이 ID는 언제부터 언제까지 이 이름”이라는 형태로 적으면, 전환 전후 어느 날짜를 다시 받아도 같은 답이 나옵니다. 이름표를 덮어쓰는 방식은 마지막 전환만 기억합니다.
- 이름표를 쓰는 곳을 전부 찾습니다. 수익만 고쳤다면 후기 중복 5건은 그대로 남았을 겁니다. 같은 사전을 읽는 곳은 같은 버그를 가집니다.
- 기준 날짜는 데이터마다 다릅니다. 수익은 일자, 후기는 작성 시각, 프로모션은 등록 시각, 기간 합계는 오늘입니다. “날짜 기준”이라고만 정하면 어느 날짜인지에서 다시 틀립니다.
- 플랫폼이 바꿔 주지 않는 것을 먼저 적어 둡니다. 허브 전환 글을 쓸 때 “appName은 그대로”라는 사실을 알고 있었지만, 그 사실이 내 장부에 무엇을 뜻하는지는 다음 날 알았습니다. 플랫폼 쪽 변경을 할 때는 그 식별자를 키로 쓰는 내 도구 목록을 같이 봅니다.
장부 자체의 구조는 앱 27개 수익을 매일 손으로 확인하다가, 장부를 만들었습니다와 수익 장부, 3주 만의 업데이트에, 토스·Play 이름을 하나로 맞춘 첫 작업도 그 글에 있습니다. 소식은 이 블로그와 인스타그램(@fadongkwon.soft) (새 창에서 열림)에서 전해드립니다.
이 글의 행 수와 날짜는 2026년 10월 27일 장부 저장소의 커밋과 정리 스크립트 출력, 작업 기록에서 옮겼습니다.
