ShooT
가족·부부·커플·룸메이트 등 원하는 단위로 그룹을 만들어 지출을 함께 관리하는 공유 가계부 — 영수증을 사진 한 장으로 기록하고, 아낀 만큼 저금통 펫이 자라는 앱.
1. 프로젝트 소개
문제 정의
- 타깃 사용자: 대학생, 부부, 커플
- 겪는 문제
- 지출 출처를 알 수 없는 지출이 나온다 (예: 토스로 결제하면 "토스페이 지출"로만 뜸)
- 카카오톡·메시지로 오는 전자 영수증을 캡쳐해서 등록하는 것이 번거롭다
- 내 돈이 어느 순간 사라진 것처럼 느낀다
- 그룹원끼리 쓴 내역을 직접 다 더해서 정산해야 한다
- 그룹원끼리 각자 다른 방식(수기·단톡방·개별 앱)으로 기록해 한곳에서 보기 어렵다
- 그룹 성격이 "가족"으로 고정돼 있어 커플·룸메이트 등 다른 관계에는 맞지 않는다
- 우리의 해결: 그룹의 성격을 앱이 정해주지 않고 사용자가 만들 때 직접 고르게 하고(가족/부부/커플/친구/모임·동아리/기타), 영수증은 촬영 한 번으로 OCR 자동 입력, 기록은 그룹 피드 한곳에 모은다. 목적은 세 가지 — 투명성 · 신뢰성 · 정산 편의.
팀이 직접 확인한 유사 서비스: 카카오페이·토스·뱅크샐러드 — 셋 다 자동 기록은 되지만 실물 영수증 촬영 등록과 "가족 외 그룹" 단위 공유가 없다는 점을 차별점으로 잡았다.
MVP 기능
| 우선순위 | 기능 | 상태 |
|---|
| 최상 | F1~F3 그룹 생성·초대코드 발급·참여 | 완료 |
| 최상 | F5·F6 지출 기록·목록 조회 | 완료 |
| 최상 | F8·F10·F11 영수증 촬영 OCR 자동 입력 + 인식 실패 항목 후수정 | 완료 |
| 최상 | F12·F13 그룹 공유 토글 · 그룹 피드 | 완료 |
| 최상 | F14 본인 지출만 수정·삭제(권한 제약) | 완료 |
| 상 | F7 메모 · F19·F20 저금 등록 · F21 캘린더 | 완료 |
| 중 | F18 그룹장 위임 | 완료 (v2 범위였으나 구현) |
| — | F22 그룹 반려 캐릭터 · F23 피드 이모지 반응 (v2 통합) | 완료 |
| — | 저금통 펫(P1·P2·P3·P5·P8), 월별 목표(P7'·P4), 출석체크, 개인 랭킹, 카카오 로그인, 회원 탈퇴 | 완료 |
| 하 | F17 월별 리포트 | 일부 (월별 목표 리포트로 대체) |
MVP를 끝낸 뒤 더 붙인 것 (9/199/22, PR #17#23과 main 직접 커밋)
| 기능 | 무엇인가 |
|---|
| 정기 지출 | 매달 같은 날 자동으로 기록되는 템플릿(월세·구독료 등). 화면을 열 때 이번 달 것을 만든다 — 별도 배치 서버 없음 |
| 그룹 예산 | 그룹장이 카테고리별 이번 달 예산을 정하고, 그룹 상세에서 쓴 만큼 비교해 보여준다 |
| 그룹원 지출 비교표 | 정산 자동계산 대신 "누가 이번 달 얼마나 썼는지"만 나란히 보여준다 |
| 지출 페이스 경고 · 저녁 리마인더 · 메모 검색 | 이 속도면 목표를 넘는다는 경고, 오후 8시까지 기록이 없으면 알림, 메모로 지출 찾기 |
| 온보딩 투어 · 카테고리 도넛 차트 · 지출 정렬 | 첫 실행 안내, 홈의 카테고리 비중 시각화, 목록 정렬 옵션 |
| 펫 경제 개편 | 단계별 필요 XP 증가, 밥값 5코인, 지출 기록 코인(하루 한 번), 그룹원이 각자 하루 한 번 그룹 펫 먹이기(XP는 인원수로 나눠 형평성 유지) |
| 그룹 펫 꾸미기 | 그룹 펫도 색을 바꿀 수 있다. 그룹원 누구나 바꾸고 모두에게 같이 보인다 |
| 실시간 동기화 | 그룹원이 무엇을 하든(참여·탈퇴·지출·저금·이모지·펫 꾸미기·예산 변경·닉네임 변경) 새로고침 없이 내 화면에 반영된다 |
| 보안 강화 | REST/RPC를 직접 호출해 코인·XP를 무한정 채우거나 아무 그룹의 그룹장을 자가 임명할 수 있던 구멍을 막았다. 보상 계산을 클라이언트에서 서버 RPC로 옮기고, pets의 경제 컬럼은 컬럼 단위 권한으로 잠갔다 |
| 회원가입 비밀번호 검증 | 입력칸에 "8자 이상"이라고 써 있는데 실제로 검사하는 코드가 없어 7자로도 가입됐다 — 이메일 형식과 같은 인라인 오류로 막았다 |
범위에서 제외한 것
- F9 간편결제 캡쳐 OCR — 무료 OCR(커스텀 템플릿) 방식은 캡쳐 화면 레이아웃이 조금만 달라도 매칭이 실패했고, 안정적으로 하려면 유료 특화 모델이 필요해 이번 범위에서 뺐다.
- F15 정산/더치페이 자동계산, F16 그룹 유형별 카테고리 프리셋, F4 연락처 초대 — 우선순위 "중·하"(v2)로 두고 코어 데모(촬영→기록→공유→피드)를 먼저 끝냈다.
- 은행 자동연동 · 다국어 · 다중 그룹 동시 대시보드 — 정책 SP4에서 이번 범위 밖으로 명시.
- P6 그룹 저금통 랭킹 — 그룹 펫의 XP 산정 방식을 팀이 정하지 못해 만들지 않았다. (개인 펫끼리 비교하는 개인 랭킹만 구현)
- P7 예산 설정(BudgetSetting) — v2에서 폐기하고 월별 목표(퀘스트형 고정 보상) 로 대체.
정상 흐름
- 0 스플래시 → "시작하기" → 1 회원가입 → 1b 성공(토스트 1.3초) → 2 로그인(또는 카카오로 계속하기) → 2a 성공 → 2b 홈
- 2b 홈 "그룹 만들기" → 3a 모임 유형 선택 → 3b 이름 입력 → 3c 완료(초대 코드 발급) → 홈 복귀
- 하단 탭 중앙 카메라 → 8a 영수증 촬영 → 8b 인식 중(OCR) → 7 지출 목록 맨 위에 새 항목
- 5a 그룹 목록 → 5b 그룹 상세(피드) 에서 그룹원 지출·저금을 시간순으로 확인, 이모지 반응
- 10 마이페이지 → 저금통 펫 · 나의 배지 · 개인 랭킹 · 월별 목표 확인
예외 흐름
| 상황 | 사용자에게 보이는 것 | 다음 행동 | 구현 여부 |
|---|
| 필수 입력이 비어 있음 (P1) | "이메일과 비밀번호를 입력해주세요" / "그룹 이름을 입력해주세요" | 입력 후 재시도 | ✅ |
| 데이터가 하나도 없음(빈 상태) | "아직 지출 내역이 없어요" · "아직 속한 그룹이 없어요" · "이번 달 설정한 목표가 아직 없어요" + 첫 행동 유도 버튼 | 추가하기 | ✅ |
| OCR 인식 실패 (P7·F11) | 저장은 항상 성공하고 category="확인 필요" 배지로 표시 | 항목을 눌러 수정(F10) | ✅ |
| 본인 지출이 아닌 것을 수정 시도 (P6) | "본인 지출만 수정할 수 있어요" (RLS가 서버에서도 차단) | 조회만 가능 | ✅ |
| 그룹 멤버가 아닌 그룹 피드 조회 (P5) | "그룹 멤버만 볼 수 있어요" | 초대 코드로 참여 | ✅ |
| 이미 참여한 그룹에 다시 참여 (P3) | "이미 참여한 그룹입니다" | 그룹 목록으로 | ✅ |
| 그룹장이 위임 없이 나가기 (P10) | "새 그룹장을 먼저 지정해주세요" (혼자면 그룹·지출 함께 삭제) | 10a-1에서 위임 | ✅ |
| 그룹에 속하지 않아 공유 대상이 없음 (P8) | 공유 select가 아예 표시되지 않음 (오류 아님) | 개인 지출로 저장 | ✅ |
| 저장·불러오기 실패(네트워크·권한) | "지출을 저장하지 못했어요" 등 원인별 한국어 문구 | 다시 시도 | ✅ |
| 카메라를 쓸 수 없음 | "카메라를 사용할 수 없어요. 갤러리에서 사진을 선택해주세요" | 갤러리 선택 | ✅ |
기획 문서
문서는 문제에서 화면까지 한 줄로 이어지도록 번호 순으로 썼다. 앞 문서의 결론이 뒷 문서의 입력이 되고, 각 항목에 ID(R·F·P·E)를 붙여 서로를 참조한다 — 예를 들어 "본인 지출만 수정" 규칙은 요구 R14 → 기능 F14 → 정책 P6 → 데이터 E4 → 화면 7로 추적된다.
01 문제 정의 → 02 업무 분석 → 03 요구사항(R) → 04 기능(F) → 05 정책(P) → 06 데이터(E) → 07 화면
↘ PRD (전부 요약한 종합본)
This is the beginning of the README. Read the rest at the original. Read the full README ↗
