Skip to content

Ledger Archive

wcorn edited this page Sep 20, 2026 · 1 revision

가계부 (Ledger) — 보관 요약

폐기된 모듈이다. 2026-08-28 기획 → 2026-09-13 청약·대출 확장 → 2026-09-20 제거 결정. 제거 작업은 Ledger-Removal에 있다. 이 문서는 없어진 8개 설계 문서(확정 명세 · 청약대출 명세 · 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록)를 하나로 압축한 것이다.

왜 지웠나 — 안 쓴다. 손으로 적는 부담이 도구의 가치보다 컸다. 자세한 이유는 Ledger-Removal §1.


1. 무엇을 만들려 했나

이미 쓴 돈과 앞으로 나갈 돈을 한 화면에 놓아, "이번 달 얼마 쓰게 되고 월말에 얼마 남나"에 답한다.

자동 연동형(토스·뱅크샐러드)은 마이데이터 인증이 전제고 연동이 끊기면 원장이 통째로 흔들린다. 수동 입력형(편한가계부)은 통제권은 확실하지만 카드 청구 사이클·정기 결제를 여전히 사람이 머리로 계산한다. 수동 입력의 통제권을 유지한 채, 계산만 서비스가 한다가 이 모듈의 자리였다.

네 번째 워크스페이스였다 — /select 4카드, 사이드바 스위처는 224px에 4칸이 안 들어가 드롭다운으로 바뀌었다.

2. 실제로 만든 것

슬라이스 범위 상태
v1 — 원장 자산·자산그룹·카테고리·수동 입력·내역·미분류 정리·월간 대시보드·카테고리 통계·외화 완료
v1.5 — 카드와 반복 카드 사이클·청구서·할부·순자산·정기 항목·직접 예약·예산·자산별 통계 완료
v2 — 분석과 이관 엑셀 가져오기/내보내기·카드 실적·자동 분류·연간 결산·예상 잔액 곡선·구독 점검·포인트 완료
청약·대출 청약 인정 추정(#1389·#1390) · 대출 자산·잔여 원금(#1400) 일부
〃 대출 상환 회차(#1401) · 대출 FE(#1392) · 마이너스통장(#1393·#1394) 미착수 — 중단

최종 규모: BE 204파일 / 25,789줄 · FE 56파일 / 17,268줄 · 테이블 24 · 스케줄러 4 · 화면 13 · 에러 코드 41 · E2E 4. 저장소에서 가장 큰 단일 모듈이었다.

에픽 #1257(완료) · #1395(중단). 관련 이슈 33건.

3. 절대 틀리면 안 된다고 적어둔 열 가지

이 목록이 이 모듈의 뼈대였다. 대부분은 지금 봐도 맞다 — 다시 만든다면 여기서 시작한다.

  1. 모든 거래는 자산에 붙는다. 이 제약 하나가 카드별·은행별 뷰와 잔액 정합성을 전부 만든다
  2. 카드 사용과 카드 대금은 다른 사건이다. 사용은 지출, 대금 납부는 이체 — 대금 납부는 절대 지출 합계에 들어가지 않는다. 수동 가계부에서 지출이 부풀려지는 가장 흔한 원인이 이것이었다
  3. 카드 대금은 자동으로 기록하지 않는다. 잔고 부족·리볼빙·선결제·연회비 때문에 실제 출금액을 앱이 알 수 없다. 모르는 걸 아는 척 적으면 원장이 조용히 틀어진다
  4. 정기 항목은 확인 절차 없이 즉시 적는다. 승인 버튼을 만들면 정기 항목을 만든 이유가 없어진다
  5. 미납은 삭제가 아니다. 예정에 남고 예상 잔액에 계속 반영된다. 「무시」 액션을 두지 않는다 — 눈에 거슬리는 게 목적이다
  6. 이월 잔액은 지출이 아니다. 이미 쓸 때 잡혔다. 수수료만 새 지출이고, 갚는 행위는 지출이 아니다
  7. 예정은 잔액을 바꾸지 않지만 숨기지도 않는다. 확정과 시각적으로 구분되되 같은 타임라인 위에 놓인다
  8. 원장은 지우지 않고 상쇄한다. 환불·취소는 원 거래를 삭제하지 않는다
  9. 자동 병합하지 않는다. 가져오기의 중복 후보는 보여주기만 한다
  10. 원장은 하나뿐이다. 여행 모듈은 별도 경비 장부를 갖지 않는다 — 이 항목만은 제거와 함께 폐기됐다 (Travel-Expense-Standalone)

4. 설계 결정 D-1 ~ D-20

# 결정 왜
D-1 네 번째 워크스페이스 — 일상 하위가 아니다 데이터도 흐름도 공유하지 않고 화면이 13개다. 링크가 같은 이유로 독립한 선례
D-2 자동 기록 중복은 DB가 막는다 — UNIQUE(recurring_id, occurrence_date) 「replica 1 전제」에 기대지 않는다. 알림 중복은 사람이 알아채지만 원장 중복은 월말 대사에서야 발견된다
D-3 공휴일·환율은 있는 것을 쓴다 HolidayQueryService(플래너) · EcbRatesClient(ECB 무료). 비용 하드캡에 새 항목을 붙이지 않는다
D-4 체크카드는 잔액을 갖지 않되 거래는 체크카드에 붙는다 잔액은 연결 계좌의 것이지만 「어디로 긁었나」는 카드가 안다
D-5 예정은 손댄 회차만 저장한다(하이브리드) 전개해 저장하면 규칙이 바뀔 때 과거 회차까지 흔들린다
D-6 엑셀 가져오기는 BE Apache POI FE 파싱은 브라우저 메모리와 파일 포맷 차이에 걸린다
D-7 v1 대시보드가 껍데기가 되는 것을 받아들인다 2축 요약·미납 경고가 전부 v1.5다. 미리 알고 만든다
D-8 잔액을 컬럼으로 저장하지 않는다 저장하면 정정·삭제마다 재계산 연쇄가 생긴다. 합계 질의로 매번 센다
D-9 외화는 v1, 여행 연계만 차기 여행 모듈 화면을 건드리므로
D-10 /select·사이드바 변경은 한 PR로 묶는다 워크스페이스 공용 화면이라 통째로 되돌릴 수 있어야 한다
D-11 /ledger/cards 경로를 신설한다 청구서는 자산 상세의 한 탭으로 들어가기에 너무 크다
D-12 알림은 인프라가 있는데도 미룬다 웹푸시는 여행에 이미 있다. 그래도 v2 이후 재판단
D-13 도메인 계산은 BE가 정본 FE는 표시용 재계산만. 두 곳에서 계산하면 반드시 갈린다
D-14 카테고리 프리셋은 가계부 최초 진입 시 심는다 회원 생성 시점에 심으면 안 쓰는 사람에게도 남는다
D-15 청약은 새 유형이 아니라 예·적금의 종류다 유형을 늘리면 모든 분기가 하나씩 늘어난다
D-16 청약 인정은 추정이고 선납·연체 산식을 흉내 내지 않는다 기관 규칙을 반쯤 구현하면 틀린 값을 자신 있게 보여준다
D-17 대출 상환·마통 이자는 자동으로 적지 않는다 추정을 예정에 띄우고 사람이 확정한다. D-3(카드 대금)과 같은 이유
D-18 대출 원금·청약 인정은 「기준값 + 이후 원장」 이미 받은 대출에 조정 거래를 만들지 않는다
D-19 마이너스통장은 대출이 아니라 한도가 있는 입출금 음수분만 부채로 옮기고 총자산에서 빼지 않는다
D-20 유형별 속성은 컬럼이 아니라 1:1 표로 가른다 ledger_asset에 유형별 컬럼을 붙이면 대부분이 NULL인 표가 된다

5. 데이터 모델 — 테이블 24개

금액은 전부 **원 단위 BIGINT**였다(부동소수점 금지, 외화만 DECIMAL).

ledger_asset_group ─< ledger_asset ─< ledger_transaction >─ ledger_category
                                   │         │
                                   │         ├─< ledger_transaction_tag >─ ledger_tag
                                   │         ├─< ledger_transaction_receipt
                                   │         └── trip_id ─> trip        (ON DELETE SET NULL)
                                   ├─< ledger_statement ─< ledger_installment_round
                                   ├─< ledger_housing_subscription      (1:1)
                                   ├─< ledger_loan ─< ledger_rate_history (1:1)
                                   └─< ledger_point
ledger_recurring ─< ledger_recurring_override · ledger_recurring_amount_history
ledger_budget ─< ledger_budget_category
ledger_import_batch · ledger_import_preset · ledger_auto_rule
ledger_installment · ledger_settings · ledger_transaction_template

핵심 설계 셋: 잔액 비저장(D-8) · 소프트 삭제(deleted_at, 원장은 지우지 않고 상쇄) · UNIQUE(recurring_id, occurrence_date)(D-2).

6. 카드 청구서 — 이 모듈의 심장이었다

가장 공들인 부분이고, 다시 만든다면 여기서부터 베낀다.

  • 사이클은 결제일·사용기간 시작일에서 파생한다. 청구서는 사이클이 닫히는 날 StatementCycleScheduler가 확정하고 다음 회차를 개설한다
  • 청구액 = 그 사이클의 카드 사용 합 + 할부 회차 + 연회비 − 선결제. 대금 납부(이체)는 이 합에 들어가지 않는다
  • 실제 출금액이 청구액과 다를 수 있다(잔고 부족·리볼빙). 그래서 자동으로 적지 않고 사람이 확정한다
  • 이월은 지출이 아니다. 수수료만 새 지출이다

7. 무엇이 안 됐나

계산 약속대로 됐다. 카드 사이클·정기 항목·예정 타임라인은 손으로 셀 필요를 없앴다
입력 없애지 못했다. 매 건을 사람이 적는다는 전제가 그대로 남았고, 그 비용이 매일 발생했다
완료 판정 계산에 관한 항목은 통과. 1번 「한 달간 실제로 썼다」가 통과하지 않았고, 그 하나가 나머지를 무의미하게 만들었다

교훈 — 「계산 부담」과 「입력 부담」은 다른 문제다. 이 모듈은 전자를 정확히 풀었고 후자를 손대지 않기로 처음부터 정했다(자동 연동은 의도적 비목표였다). 그 선택이 옳았는지는 슬라이스를 다 만든 뒤에야 알 수 있는 종류가 아니었다 — v1 한 달 실사용으로 먼저 답이 났어야 했다. 완료 판정 1번을 1번으로 적어두고도 v1.5·v2·청약대출을 계속 쌓은 것이 이 모듈에서 가장 값비싼 판단이다.

8. 무엇을 남기나

남는 것 어디로
여행 경비 Travel-Expense-Standalone — 여행 전용 장부로 독립
엑셀 읽기 규칙 DatasetSheetReader(노트 데이터셋)가 같은 규칙을 이미 복제해 갖고 있다
환율 ExchangeRateService·EcbRatesClient — 원래 여행/도구 소유다
가져오기 타임아웃 교훈 ELOG-035 — 게이트웨이가 10초에 끊는데 서버 로그엔 아무것도 없었다

9. 관련

Clone this wiki locally