Family Budget — 함께 기록하고 월말을 닫는 부부 가계부
개인 제품 · 기획·백엔드·데이터 모델·운영 자동화·반응형 UX 전 범위 담당
2026-08-14 — present
매일의 수입·지출을 빠르게 기록하고, 공동·개인 부담과 목적통장, 예상 수입·고정지출·저축을 한 달의 판단으로 연결하는 부부 공용 가계부입니다.
실제 제품 화면으로 보는 사용자 여정
Family Budget
대시보드에서 한 달을 판단하고, 모바일에서 빠르게 기록하며, 예상 항목을 실제 원장에 반영하기 전 확인합니다. 모든 화면은 운영 UI와 같은 canonical UI package에 합성 데이터를 연결해 캡처했습니다.
핵심 시스템 설계
운영 정본 전환
애플리케이션 정본
과거 시트는 읽기 전용 가져오기 경계로 분리
이전: 스프레드시트 중심 입력과 해석
계획 ≠ 실제
규칙 · occurrence · actual 분리
예상·실제·차이를 각각 추적
이전: 예상 규칙과 실제 입금·지출 혼동
중복·불확실성 차단
연결 우선 · 승인 · read-back
부분 성공과 reopen까지 명시적으로 처리
이전: 후보가 있어도 새 실제 내역을 만들 위험
운영 제품 경계와 공개 증거
가족 구성원과 승인형 도우미는 인증 API를 통해 운영 원장을 사용합니다. 과거 스프레드시트는 읽기 전용 가져오기 경계이며, 공개 데모는 합성 데이터로 화면 계약만 보여주는 보조 증거입니다.
대표 조정 흐름
월별 occurrence는 기존 실제 후보를 먼저 찾습니다. 사용자 확인 뒤 연결하거나 새로 만들고, 트랜잭션 쓰기와 read-back을 거쳐 예상·실제·차이를 갱신합니다.
문제 해결 과정
계획 항목을 실제 거래처럼 다루면 수입·지출이 중복 집계되고 월별 차이를 설명할 수 없었습니다.
반복 규칙을 계획 정본, 월별 occurrence를 조정 단위, 거래·목적통장 입금을 실제 사실 정본으로 분리했습니다.
대시보드는 예상·실제·차이를 독립 계산하며 “계획은 실제 거래가 아니다”라는 계약을 유지합니다.
실제 입금을 반영할 때 이미 원장에 있는 후보를 놓치면 같은 사건이 새 거래로 중복될 수 있었습니다.
이름·소유자·월로 occurrence와 후보를 찾고, 후보가 있으면 자동 생성 대신 연결을 먼저 제안하며 새 생성은 명시적 선택으로 제한했습니다.
연결·새 생성·건너뜀·reopen 경로가 같은 조정 흐름 안에서 중복 없이 추적됩니다.
자동화가 쓰기 성공과 후속 조회 실패를 하나의 실패로 뭉개면 성공한 기록을 재시도해 중복을 만들 수 있었습니다.
변경 전 요청 본문을 보여 승인받고, 쓰기 후 원장과 대시보드를 read-back하며 부분 성공·검증 실패를 별도 상태로 보고합니다.
확인되지 않은 재시도 대신 현재 사실을 다시 조회하고, 필요한 경우 occurrence를 reopen해 안전하게 복구합니다.
도메인 모델과 사용자 흐름
계획·occurrence·actual의 관계와 모바일 입력·데스크톱 검토 흐름을 공개 안전한 다이어그램으로 설명합니다.
운영 한계
Claim → 공개 근거
저장소 홈이 아니라 각 주장과 직접 연결되는 코드·테스트·CI를 제공합니다.
프로젝트 설명
Family Budget은 “거래를 적는 도구”에서 끝나지 않습니다. 비개발 가족 구성원은 모바일에서 일상 지출을 빠르게 입력하고, 함께 쓰는 데스크톱 화면에서는 거래 원장·목적통장·자산·예상 항목을 한 달 단위로 검토합니다. 대시보드는 예상 수입·지출·저축과 실제 기록, 누락된 확인 항목을 모아 이번 달을 마감할 수 있는지 보여줍니다. 이를 위해 반복 규칙(계획), 월별 확인 항목(occurrence), 실제 거래를 분리하고 기존 실제 내역 연결을 새 생성보다 우선했습니다. 아래 화면은 운영 UI와 동일한 canonical UI package를 합성 데이터 어댑터에 연결한 공개 제품 증거이며, 실제 가족 금융값과 운영 백엔드는 공개하지 않습니다.
주요 내용
- 모바일 빠른 입력 → 거래 원장 → 목적통장·자산 → 월말 판단으로 이어지는 Family Budget 사용자 여정
- 공동·개인 부담과 계획·실제를 분리해 부부가 같은 한 달을 서로 다른 관점에서 검토
- 기존 실제 내역 우선 연결, 사용자 승인, read-back, 부분 성공 공개, reopen으로 금융 쓰기 안전성 확보
기술 선택 근거
- ▶반복 규칙·월별 occurrence·실제 원장을 분리해 모델은 늘었지만 계획 변경과 실제 사실을 서로 덮어쓰지 않게 했습니다.
- ▶후보 자동 연결보다 사용자 확인을 선택해 한 단계가 늘었지만 금융 원장에서 잘못된 결합을 방지했습니다.
- ▶공개 UI package와 합성 데모를 보조 증거로 분리해 운영 구현을 공개하지 않으면서 화면 계약과 공개 경계를 재현했습니다.