Skip to content

Ledger Removal

wcorn edited this page Sep 20, 2026 · 2 revisions

가계부 제거 (Ledger Removal)

결정일 2026-09-20. 가계부(모듈 11)를 orino에서 제거한다. 이 문서가 제거 작업의 정본이다. 만들었던 것의 요약은 Ledger-Archive, 여행 경비의 새 자리는 Travel-Expense-Standalone에 있다.

1. 왜 지우나

안 쓴다 — 손으로 적는 부담이 도구의 가치보다 컸다.

설계는 「수동 입력의 통제권은 사람이 갖고, 계산은 서비스가 한다」였다. 계산 쪽은 약속대로 됐다 — 카드 청구 사이클, 정기 항목 자동 기록, 예정·확정 타임라인은 실제로 손으로 셀 필요를 없앴다. 없애지 못한 것은 입력 자체다. 기관 앱과 대조하는 수고를 줄이려고 만든 도구인데, 매 건을 사람이 적어야 한다는 전제가 그대로 남았고 그 비용이 매일 발생했다.

자동 연동(마이데이터·스크래핑·SMS 파싱)은 처음부터 의도적 비목표였고 지금도 그렇다. 그러면 입력 부담은 설계로 줄일 수 있는 것이 아니라 이 모듈의 정의에 붙어 있는 것이다. 정의를 바꿀 생각이 없으므로 모듈을 지운다.

기능이 틀려서 지우는 것이 아니다. 완료 판정(§17)에 적어둔 일곱 항목 중 계산에 관한 것들은 통과했다. 1번 「한 달간 실제로 썼다」가 통과하지 않았고, 그 하나가 나머지를 무의미하게 만든다.

2. 무엇을 지우나 — 전수 (2026-09-20 기준)

자리 규모
BE 코드 planner/ledger + domain/planner/ledger · 204파일 / 25,789줄
FE 코드 features/ledger + pages/ledger · 56파일 / 17,268줄 · 화면 13
DB ledger_* 테이블 24개
스케줄러 4개 — RecurringPostingScheduler · ScheduledPromotionScheduler · StatementCycleScheduler · LedgerReceiptRetentionScheduler
에러 코드 ErrorCode의 LDG-ERR-* 41개
오브젝트 MinIO ledger/receipts/**
E2E ledger-import · ledger-input · ledger-statement-pay · ledger-upcoming
인프라 Istio VirtualService의 /api/ledger/import/ 라우트(타임아웃 120s)
진입 동선 /select 4번째 카드 · 사이드바 워크스페이스 드롭다운의 가계부
Wiki Ledger-* 8문서 → Ledger-Archive 하나로 압축

저장소에서 가장 큰 단일 모듈이다. 스케줄러는 전체 7개 중 4개, 즉 이 앱의 주기 작업 절반 이상이 가계부의 것이다.

3. 먼저 풀어야 하는 매듭 — 여행 경비

가계부는 혼자 서 있지 않다. 여행 경비(TRV-014)가 가계부 원장 위에 얹혀 있다.

  • ledger_transaction.trip_id가 연결 고리고, FK는 ON DELETE SET NULL이다
  • BE TravelExpenseService·TripExpenseQueryService가 LedgerTransactionRepository를 직접 주입받아 쓴다
  • FE 경비 화면이 가계부 훅(useCreateTransaction·useLedgerAssets·useLedgerCategories)과 lib/money·lib/balance를 그대로 쓴다
  • 지출 입력은 여행 BE를 거치지 않고 FE가 POST /api/ledger/transactions로 직접 보낸다

D-27이 「여행 안에 장부를 만들지 않는다」로 정한 결과다. 그 결정의 전제(원장은 가계부 하나뿐이다)가 사라지므로 결정도 뒤집는다 → D-43.

여행 경비는 살린다. 여행 전용 장부로 독립시키고, 기존 trip_id 거래를 이관한 뒤에 가계부를 지운다. 명세는 Travel-Expense-Standalone.

순서가 안전의 전부다. 이관이 끝나기 전에 ledger_transaction을 지우면 여행 지출 기록이 같이 사라진다. 그래서 경비 독립이 0단계다.

4. 데이터 — 전부 지운다

ledger_* 테이블 24개와 MinIO ledger/receipts/**를 삭제한다. 덤프를 떠서 보관하지 않는다.

  • 남길 것은 여행 경비로 이관된 행뿐이다(0단계). 그 밖의 원장은 「안 쓰기로 한 도구에 적다 만 기록」이고, 보관하면 백업·용량·복원 절차에 계속 실린다
  • 테이블은 Liquibase drop 체인지셋으로 지운다. kubectl exec로 손으로 DROP 하지 않는다 — 로컬·테스트·운영이 갈라진다
  • ledger_transaction.trip_id의 FK(fk_ledger_tx_trip)를 테이블보다 먼저 떨어뜨린다. trip을 참조하는 제약이 남은 채로는 drop 순서가 꼬인다
  • 오브젝트는 prefix 통째로 지운다. 지우고 나면 LedgerReceiptRetentionScheduler가 훑던 유일한 이유도 함께 사라진다(Periodic-Loops)

되돌릴 수 없는 단계다. 그래서 3단계에 혼자 둔다 — 0~2단계는 되돌릴 수 있고, 3단계만 그렇지 않다.

5. 단계

각 단계는 독립적으로 배포 가능하고, 다음 단계 없이도 앱이 정상이다.

0단계 — 여행 경비 독립

가계부를 건드리기 전에 경비를 떼어 낸다. 이 단계가 끝나면 여행 경비는 가계부 없이 동작한다.

내용
BE trip_expense 신설 · trip_id 거래 이관 · 경비 API를 여행 소유로 · ExchangeRateService 직접 사용
FE 경비 화면의 가계부 훅·유틸 의존 제거 · 지출 행 클릭 목적지 변경 · 빠른 입력이 여행 API로

되돌림: 이관은 복사다 — ledger_transaction의 원본을 지우지 않고 trip_expense에 넣는다. 0단계만 되돌리면 두 벌이 잠깐 공존하지만 가계부는 멀쩡하다.

1단계 — FE 가계부 제거

화면과 진입 동선을 걷어낸다. API는 그대로 살아 있다.

  • features/ledger · pages/ledger 삭제, 라우트 13개 · LedgerLayout · N 단축키 제거
  • /select 4번째 카드 제거 → 3카드로 되돌림, 사이드바 워크스페이스 드롭다운 → 세그먼트로 되돌림
  • E2E 스펙 4개 삭제, workspace-nav.spec.ts 갱신

되돌림: revert 한 번. BE가 그대로라 데이터도 그대로다.

드롭다운 → 세그먼트 되돌림은 워크스페이스 공용 화면을 건드린다. 가계부를 붙일 때 D-10이 「한 PR로 묶어 통째로 되돌릴 수 있게」 둔 이유가 그대로 값한다 — 뗄 때도 같은 파일 둘이고, 여행·일상·링크가 전부 지나간다.

2단계 — BE 가계부 제거

API·스케줄러·에러 코드를 지운다. 테이블은 남아 있다.

  • planner/ledger · domain/planner/ledger 삭제
  • 스케줄러 4개 제거
  • ErrorCode에서 LDG-ERR-* 41개 제거
  • Istio VirtualService의 /api/ledger/import/ 라우트 제거
  • 테스트 DbCleaner에서 ledger_* 정리 구문 제거

되돌림: revert 한 번. 데이터가 남아 있으므로 복구된다.

3단계 — 데이터·스토리지

여기서부터 되돌릴 수 없다.

  • Liquibase drop 체인지셋(071) — FK 먼저, 테이블 24개
  • MinIO ledger/receipts/** 삭제
  • Periodic-Loops 배치 표에서 4줄 제거

해 보고 알게 된 것 둘.

  • MinIO에는 지울 것이 없었다. orino/ledger/ prefix가 0 objects였고 ledger_transaction_receipt도 0행이었다 — 영수증을 한 장도 안 붙였다.
  • changelog를 그 앞으로 되감는 길이 막힌다. 057~069의 롤백문이 지우려는 테이블을 071이 이미 떨어뜨렸기 때문이다. MySQL에는 ALTER TABLE IF EXISTS가 없어 그 롤백문들을 멱등하게 고치려면 9개 파일에 절차적 SQL을 넣어야 한다 — 되돌릴 수 없게 설계한 단계이므로 우회하지 않는다. 대신 태그 지점까지 되감아 쓰던 TravelMultiCityMigrationTest를 앞에서부터 태그까지만 적용하는 방식으로 바꿨다(같은 상태를 만드는 다른 길이다).

6. 영향받는 다른 모듈

모듈 무엇이 바뀌나
여행 경비가 자기 장부를 갖는다. D-27·D-28을 뒤집는다 → Travel-Expense-Standalone
워크스페이스 공용 /select 4카드 → 3카드, 사이드바 드롭다운 → 세그먼트
데이터셋(노트) 없다. DatasetSheetReader는 LedgerSheetReader를 「같은 규칙이지만 코드를 나눠 쓰지 않는다」고 의도적으로 복제해 두었다. 주석의 참조만 정리한다
환율 없다. ExchangeRateService·EcbRatesClient는 여행/도구 소유다. LedgerFxService는 그 위의 얇은 래퍼일 뿐이라 같이 지운다
공휴일 없다. HolidayQueryService는 플래너 소유다
이미지 저장소 버킷·presigner는 일상기록과 공용이다. 가계부는 prefix만 빌려 썼으므로 prefix만 지운다
관측성 배치 4개가 사라진다. MinIO를 훑는 루프가 하나 줄어든다

7. 완료 판정

  1. 여행 경비 화면이 가계부 코드를 한 줄도 import 하지 않는다
  2. 이관 전후로 각 여행의 총액이 같다
  3. grep -ri ledger가 0건이다 — 단 Liquibase 체인지셋은 뺀다. 057~069가 ledger_*를 만들고 071이 지우는데, 빈 DB는 여전히 그 순서를 재생해야 한다. 앞의 것을 지우면 이관 체인지셋(070)이 없는 테이블을 읽는다. 여기서 0건은 Java·TS·infra 기준이고, 그건 달성했다
  4. ./gradlew check · FE 게이트 전부 통과, E2E 전체 통과
  5. 운영 DB에 ledger_로 시작하는 테이블이 없다
  6. MinIO에 ledger/ prefix가 없다 (애초에 0 objects였다)
  7. /select가 3카드이고 사이드바 스위처가 세그먼트로 돌아왔다

8. 닫는 이슈

제거 결정으로 진행 중이던 가계부 작업을 중단한다.

이슈 상태
#1395 에픽 — 청약·대출·마이너스통장 중단
#1401 대출 상환 회차 — BE 중단
#1392 대출 상세 — FE 중단
#1393 마이너스통장 — BE 중단
#1394 마이너스통장 — FE 중단

청약(#1389·#1390)과 대출 자산(#1400)은 이미 머지됐고, 이번 제거에 함께 지워진다.

9. 관련

Clone this wiki locally