Repository navigation
Ledger Removal
결정일 2026-09-20. 가계부(모듈 11)를 orino에서 제거한다. 이 문서가 제거 작업의 정본이다. 만들었던 것의 요약은 Ledger-Archive, 여행 경비의 새 자리는 Travel-Expense-Standalone에 있다.
안 쓴다 — 손으로 적는 부담이 도구의 가치보다 컸다.
설계는 「수동 입력의 통제권은 사람이 갖고, 계산은 서비스가 한다」였다. 계산 쪽은 약속대로 됐다 — 카드 청구 사이클, 정기 항목 자동 기록, 예정·확정 타임라인은 실제로 손으로 셀 필요를 없앴다. 없애지 못한 것은 입력 자체다. 기관 앱과 대조하는 수고를 줄이려고 만든 도구인데, 매 건을 사람이 적어야 한다는 전제가 그대로 남았고 그 비용이 매일 발생했다.
자동 연동(마이데이터·스크래핑·SMS 파싱)은 처음부터 의도적 비목표였고 지금도 그렇다. 그러면 입력 부담은 설계로 줄일 수 있는 것이 아니라 이 모듈의 정의에 붙어 있는 것이다. 정의를 바꿀 생각이 없으므로 모듈을 지운다.
기능이 틀려서 지우는 것이 아니다. 완료 판정(§17)에 적어둔 일곱 항목 중 계산에 관한 것들은 통과했다. 1번 「한 달간 실제로 썼다」가 통과하지 않았고, 그 하나가 나머지를 무의미하게 만든다.
| 자리 | 규모 |
|---|---|
| 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개, 즉 이 앱의 주기 작업 절반 이상이 가계부의 것이다.
가계부는 혼자 서 있지 않다. 여행 경비(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단계다.
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단계만 그렇지 않다.
각 단계는 독립적으로 배포 가능하고, 다음 단계 없이도 앱이 정상이다.
가계부를 건드리기 전에 경비를 떼어 낸다. 이 단계가 끝나면 여행 경비는 가계부 없이 동작한다.
| 내용 | |
|---|---|
| BE |
trip_expense 신설 · trip_id 거래 이관 · 경비 API를 여행 소유로 · ExchangeRateService 직접 사용 |
| FE | 경비 화면의 가계부 훅·유틸 의존 제거 · 지출 행 클릭 목적지 변경 · 빠른 입력이 여행 API로 |
되돌림: 이관은 복사다 — ledger_transaction의 원본을 지우지 않고 trip_expense에 넣는다. 0단계만 되돌리면 두 벌이 잠깐 공존하지만 가계부는 멀쩡하다.
화면과 진입 동선을 걷어낸다. API는 그대로 살아 있다.
-
features/ledger·pages/ledger삭제, 라우트 13개 ·LedgerLayout·N단축키 제거 -
/select4번째 카드 제거 → 3카드로 되돌림, 사이드바 워크스페이스 드롭다운 → 세그먼트로 되돌림 - E2E 스펙 4개 삭제,
workspace-nav.spec.ts갱신
되돌림: revert 한 번. BE가 그대로라 데이터도 그대로다.
드롭다운 → 세그먼트 되돌림은 워크스페이스 공용 화면을 건드린다. 가계부를 붙일 때 D-10이 「한 PR로 묶어 통째로 되돌릴 수 있게」 둔 이유가 그대로 값한다 — 뗄 때도 같은 파일 둘이고, 여행·일상·링크가 전부 지나간다.
API·스케줄러·에러 코드를 지운다. 테이블은 남아 있다.
-
planner/ledger·domain/planner/ledger삭제 - 스케줄러 4개 제거
-
ErrorCode에서LDG-ERR-*41개 제거 - Istio VirtualService의
/api/ledger/import/라우트 제거 - 테스트
DbCleaner에서ledger_*정리 구문 제거
되돌림: revert 한 번. 데이터가 남아 있으므로 복구된다.
여기서부터 되돌릴 수 없다.
- 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를 앞에서부터 태그까지만 적용하는 방식으로 바꿨다(같은 상태를 만드는 다른 길이다).
| 모듈 | 무엇이 바뀌나 |
|---|---|
| 여행 | 경비가 자기 장부를 갖는다. D-27·D-28을 뒤집는다 → Travel-Expense-Standalone |
| 워크스페이스 공용 |
/select 4카드 → 3카드, 사이드바 드롭다운 → 세그먼트 |
| 데이터셋(노트) |
없다. DatasetSheetReader는 LedgerSheetReader를 「같은 규칙이지만 코드를 나눠 쓰지 않는다」고 의도적으로 복제해 두었다. 주석의 참조만 정리한다 |
| 환율 |
없다. ExchangeRateService·EcbRatesClient는 여행/도구 소유다. LedgerFxService는 그 위의 얇은 래퍼일 뿐이라 같이 지운다 |
| 공휴일 |
없다. HolidayQueryService는 플래너 소유다 |
| 이미지 저장소 | 버킷·presigner는 일상기록과 공용이다. 가계부는 prefix만 빌려 썼으므로 prefix만 지운다 |
| 관측성 | 배치 4개가 사라진다. MinIO를 훑는 루프가 하나 줄어든다 |
- 여행 경비 화면이 가계부 코드를 한 줄도 import 하지 않는다
- 이관 전후로 각 여행의 총액이 같다
-
grep -ri ledger가 0건이다 — 단 Liquibase 체인지셋은 뺀다.057~069가ledger_*를 만들고071이 지우는데, 빈 DB는 여전히 그 순서를 재생해야 한다. 앞의 것을 지우면 이관 체인지셋(070)이 없는 테이블을 읽는다. 여기서 0건은 Java·TS·infra 기준이고, 그건 달성했다 -
./gradlew check· FE 게이트 전부 통과, E2E 전체 통과 - 운영 DB에
ledger_로 시작하는 테이블이 없다 - MinIO에
ledger/prefix가 없다 (애초에 0 objects였다) -
/select가 3카드이고 사이드바 스위처가 세그먼트로 돌아왔다
제거 결정으로 진행 중이던 가계부 작업을 중단한다.
| 이슈 | 상태 |
|---|---|
| #1395 에픽 — 청약·대출·마이너스통장 | 중단 |
| #1401 대출 상환 회차 — BE | 중단 |
| #1392 대출 상세 — FE | 중단 |
| #1393 마이너스통장 — BE | 중단 |
| #1394 마이너스통장 — FE | 중단 |
청약(#1389·#1390)과 대출 자산(#1400)은 이미 머지됐고, 이번 제거에 함께 지워진다.
- Ledger-Archive — 만들었던 것과 결정 기록 요약
- Travel-Expense-Standalone — 여행 경비 독립 명세
- Travel-Open-Items D-43 — D-27·D-28을 뒤집는 결정
- Periodic-Loops — 사라지는 배치 4개
- PRD §15 · Home