save-mate

💰 SaveMate

20대를 위한 미션형 절약 가계부

소비 습관을 바꾸는 작은 도전, 지속 가능한 절약을 함께 만드는 서비스

---

📌 목차

1. 프로젝트 소개
2. 주요 기능 소개
3. 기능 명세서
4. 디자인 시안
5. 기술 스택
6. 폴더 구조
7. 팀원 소개
8. 링크 모음
9. 진행 현황 및 논의 중인 이슈
10. 트러블슈팅

---

🪧 프로젝트 소개

20대는 금전적 독립이 시작되는 시기이자, 소비 습관이 형성되는 중요한 시기다.

하지만 대부분의 20대는 계획 없는 소비에 익숙하고, '아껴 써야 한다'는 생각은 해도 지속적으로 실천하기 어렵다.

이 프로젝트는 이러한 문제의식에서 출발했다.

“혼자 쓰는 가계부는 금방 포기하게 된다면?”

“같이 기록하고, 도전하고, 비교하면서 재미있게 절약할 수는 없을까?”

우리는 미션 기반의 절약 시스템, 친구 간 소비 비교기능을 중심으로 사용자가 지출을 기록하고, 절약을 도전처럼 실천하며, 서로 자극받고 응원할 수 있는 환경을 만들고자 한다.

이 앱은 단순한 지출 기록을 넘어서, 소비 습관 형성과 절약 실천을 재미있게 지속할 수 있는 경험을 제공한다.

궁극적으로는 20대가 자신의 소비를 통제하고, 경제적 자율성과 자신감을 가질 수 있도록 돕는 것이 목표다.

---

🧩 주요 기능 소개

📱 메인 페이지

• 주간/월간 지출 캘린더 및 리스트 뷰
• 절약 현황 및 미션 달성률 시각화
• 하단 탭 네비게이션 구성

💵 가계부

• 지출 항목 등록 및 수정
• 카테고리 지정 및 금액 입력
• 사용 일자 기반 자동 정렬

🤝 친구 기능

• 친구 추가 / 삭제 기능
• 친구의 소비/절약 현황 알림
• 나와 친구의 소비 비교

🎯 절약 미션

• 운영자 제공 또는 사용자 생성 미션 선택
• 목표 금액 설정 및 미션 시작
• 주간 미션 결과 히스토리 저장

👤 마이페이지

• 내 총 소비 요약
• 절약률, 미션 달성률 등 통계 시각화
• 개인정보 및 설정 관리

🔐 회원 기능

• 이메일 기반 로그인 / 회원가입
• 인증 및 사용자 데이터 연동

---

📄 기능 명세서

번호	대상	페이지 정의	Depth 01	Depth 02	기능 설명	비고
1-1	시작	로그인	소셜 로그인	— 1	POST	SNS SDK 연동 필요
1-2	시작	로그인	소셜 로그인	— 2	api	SNS SDK 연동 필요
1-3	시작	로그인	소셜 로그인	— 3	auth	SNS SDK 연동 필요
1-4	시작	로그인	소셜 로그인	— 4	social-login카카오	SNS SDK 연동 필요
2-1	시작	회원가입	회원가입 폼	프로필 설정 1	POST	소셜 계정 연동 가능
2-2	시작	회원가입	회원가입 폼	프로필 설정 2	api	소셜 계정 연동 가능
2-3	시작	회원가입	회원가입 폼	프로필 설정 3	auth	소셜 계정 연동 가능
2-4	시작	회원가입	회원가입 폼	프로필 설정 4	register이메일	소셜 계정 연동 가능
2-5	시작	회원가입	회원가입 폼	프로필 설정 5	비밀번호 기반 회원가입 및 프로필 정보 등록	소셜 계정 연동 가능
3-1	메인	홈	지출리스트	월/주/일 전환 1	GET	기간 필터 파라미터 사용
3-2	메인	홈	지출리스트	월/주/일 전환 2	api	기간 필터 파라미터 사용
3-3	메인	홈	지출리스트	월/주/일 전환 3	expenses?period=month달력 기반 지출 내역 불러오기	기간 필터 파라미터 사용
4-1	메인	홈	절약 현황	월별 그래프 1	GET	차트 라이브러리 연동 필요
4-2	메인	홈	절약 현황	월별 그래프 2	api	차트 라이브러리 연동 필요
4-3	메인	홈	절약 현황	월별 그래프 3	savings	차트 라이브러리 연동 필요
4-4	메인	홈	절약 현황	월별 그래프 4	summary?month=YYYY-MM목표 대비 절감액	차트 라이브러리 연동 필요
4-5	메인	홈	절약 현황	월별 그래프 5	비교 수치 포함 응답	차트 라이브러리 연동 필요
5-1	메인	홈	미션 달성률	게이지 뷰 1	GET	실시간 상태 반영 필요
5-2	메인	홈	미션 달성률	게이지 뷰 2	api	실시간 상태 반영 필요
5-3	메인	홈	미션 달성률	게이지 뷰 3	missions	실시간 상태 반영 필요
5-4	메인	홈	미션 달성률	게이지 뷰 4	progress진행 중인 미션별 달성률(%) 반환	실시간 상태 반영 필요
6-1	메인	홈	네브 바	좌측 탭바 1	홈	UI 구성(아이콘/버지 뱃지)
6-2	메인	홈	네브 바	좌측 탭바 2	가계부	UI 구성(아이콘/버지 뱃지)
6-3	메인	홈	네브 바	좌측 탭바 3	미션	UI 구성(아이콘/버지 뱃지)
6-4	메인	홈	네브 바	좌측 탭바 4	친구	UI 구성(아이콘/버지 뱃지)
6-5	메인	홈	네브 바	좌측 탭바 5	내정보 아이콘	UI 구성(아이콘/버지 뱃지)
6-6	메인	홈	네브 바	좌측 탭바 6	버지 배지	UI 구성(아이콘/버지 뱃지)
7-1	가계부	항목 관리	지출 항목 입력	직접 입력 1	POST	상품 카테고리, 제목, 금액 포함
7-2	가계부	항목 관리	지출 항목 입력	직접 입력 2	api	상품 카테고리, 제목, 금액 포함
7-3	가계부	항목 관리	지출 항목 입력	직접 입력 3	expenses지출 항목 등록	상품 카테고리, 제목, 금액 포함
8-1	가계부	항목 관리	지출 항목 수정·삭제	— 1	PUT	이력 로그 필요
8-2	가계부	항목 관리	지출 항목 수정·삭제	— 2	api	이력 로그 필요
8-3	가계부	항목 관리	지출 항목 수정·삭제	— 3	expenses	이력 로그 필요
8-4	가계부	항목 관리	지출 항목 수정·삭제	— 4	{id}DELETE	이력 로그 필요
8-5	가계부	항목 관리	지출 항목 수정·삭제	— 5	api	이력 로그 필요
8-6	가계부	항목 관리	지출 항목 수정·삭제	— 6	expenses	이력 로그 필요
8-7	가계부	항목 관리	지출 항목 수정·삭제	— 7	{id}기존 지출 항목 수정	이력 로그 필요
8-8	가계부	항목 관리	지출 항목 수정·삭제	— 8	삭제	이력 로그 필요
9-1	가계부	카테고리	카테고리 관리	추가/변경 1	GET	초기 카테고리 3~4개 제공
9-2	가계부	카테고리	카테고리 관리	추가/변경 2	POST	초기 카테고리 3~4개 제공
9-3	가계부	카테고리	카테고리 관리	추가/변경 3	api	초기 카테고리 3~4개 제공
9-4	가계부	카테고리	카테고리 관리	추가/변경 4	categories기본 + 사용자 정의 카테고리 관리	초기 카테고리 3~4개 제공
10-1	친구	친구목록	친구 목록·추가	팔로우/언팔 1	GET	차단 기능 포함
10-2	친구	친구목록	친구 목록·추가	팔로우/언팔 2	api	차단 기능 포함
10-3	친구	친구목록	친구 목록·추가	팔로우/언팔 3	friendsPOST	차단 기능 포함
10-4	친구	친구목록	친구 목록·추가	팔로우/언팔 4	api	차단 기능 포함
10-5	친구	친구목록	친구 목록·추가	팔로우/언팔 5	friends닉네임	차단 기능 포함
10-6	친구	친구목록	친구 목록·추가	팔로우/언팔 6	썸네일 표시	차단 기능 포함
10-7	친구	친구목록	친구 목록·추가	팔로우/언팔 7	친구 추가	차단 기능 포함
11-1	친구	친구소비	소비 알림	푸시 설정 1	PATCH	FCM 연동 필요
11-2	친구	친구소비	소비 알림	푸시 설정 2	api	FCM 연동 필요
11-3	친구	친구소비	소비 알림	푸시 설정 3	friends	FCM 연동 필요
11-4	친구	친구소비	소비 알림	푸시 설정 4	{id}	FCM 연동 필요
11-5	친구	친구소비	소비 알림	푸시 설정 5	notification알림 ON	FCM 연동 필요
11-6	친구	친구소비	소비 알림	푸시 설정 6	OFF 토글	FCM 연동 필요
12-1	친구	비교	소비 비교	그래프 등 1	GET	월/주 단위 선택 가능
12-2	친구	비교	소비 비교	그래프 등 2	api	월/주 단위 선택 가능
12-3	친구	비교	소비 비교	그래프 등 3	friends	월/주 단위 선택 가능
12-4	친구	비교	소비 비교	그래프 등 4	{id}	월/주 단위 선택 가능
12-5	친구	비교	소비 비교	그래프 등 5	compare?period=month카테고리별	월/주 단위 선택 가능
12-6	친구	비교	소비 비교	그래프 등 6	총지출 비교	월/주 단위 선택 가능
13-1	절약미션	미션	미션 선택/등록	미션 리스트 1	GET	사용자/운영자 생성 혼합
13-2	절약미션	미션	미션 선택/등록	미션 리스트 2	api	사용자/운영자 생성 혼합
13-3	절약미션	미션	미션 선택/등록	미션 리스트 3	missions	사용자/운영자 생성 혼합
13-4	절약미션	미션	미션 선택/등록	미션 리스트 4	suggestionsPOST	사용자/운영자 생성 혼합
13-5	절약미션	미션	미션 선택/등록	미션 리스트 5	api	사용자/운영자 생성 혼합
13-6	절약미션	미션	미션 선택/등록	미션 리스트 6	missions추천 미션 탐색 및 등록	사용자/운영자 생성 혼합
14	절약미션	미션	목표금액 설정	운영 제공	등록 시 목표 입력 방식 선택:① user 타입 → 직접 입력② system → 제안형 선택	선택형 라디오 UI 구성
15-1	절약미션	진행	미션 진행 현황	공지·알림 1	GET	푸시·토스트 알림 포함
15-2	절약미션	진행	미션 진행 현황	공지·알림 2	api	푸시·토스트 알림 포함
15-3	절약미션	진행	미션 진행 현황	공지·알림 3	missions	푸시·토스트 알림 포함
15-4	절약미션	진행	미션 진행 현황	공지·알림 4	progress + 알림미션 성공	푸시·토스트 알림 포함
15-5	절약미션	진행	미션 진행 현황	공지·알림 5	실패 여부	푸시·토스트 알림 포함
15-6	절약미션	진행	미션 진행 현황	공지·알림 6	D-day	푸시·토스트 알림 포함
15-7	절약미션	진행	미션 진행 현황	공지·알림 7	주차별 리포트	푸시·토스트 알림 포함
16-1	내정보	프로필	내 프로필 조회·수정	닉네임·사진·알림 설정 1	GET	GDPR 삭제 요청 UI 포함
16-2	내정보	프로필	내 프로필 조회·수정	닉네임·사진·알림 설정 2	PUT	GDPR 삭제 요청 UI 포함
16-3	내정보	프로필	내 프로필 조회·수정	닉네임·사진·알림 설정 3	api	GDPR 삭제 요청 UI 포함
16-4	내정보	프로필	내 프로필 조회·수정	닉네임·사진·알림 설정 4	users	GDPR 삭제 요청 UI 포함
16-5	내정보	프로필	내 프로필 조회·수정	닉네임·사진·알림 설정 5	me기본 프로필 수정 및 알림 설정 변경	GDPR 삭제 요청 UI 포함
17-1	내정보	통계	개인 소비 통계	월/연간 리포트 1	GET	소비 패턴 인사이트 포함
17-2	내정보	통계	개인 소비 통계	월/연간 리포트 2	api	소비 패턴 인사이트 포함
17-3	내정보	통계	개인 소비 통계	월/연간 리포트 3	stats?range=monthly고정	소비 패턴 인사이트 포함
17-4	내정보	통계	개인 소비 통계	월/연간 리포트 4	유동비 비율	소비 패턴 인사이트 포함
17-5	내정보	통계	개인 소비 통계	월/연간 리포트 5	카테고리 분포	소비 패턴 인사이트 포함
17-6	내정보	통계	개인 소비 통계	월/연간 리포트 6	CSV 내보내기	소비 패턴 인사이트 포함

📎 기능 명세서 문서 보기 링크 (예정)

---

🎨 디자인 시안 (예정)

Figma를 통해 앱 UI 시안이 제작 중입니다.

📎 피그마 링크 (예정)

---

🛠 기술 스택

영역	사용 기술
Frontend	React
Backend	Spring
Database	MySQL,H2
협업 도구	Figma, Notion, Discord

---

📁 폴더 구조

Front-end

📦project-root
 ┣ 📂public
 ┣ 📂src
 ┃ ┣ 📂components
 ┃ ┣ 📂pages
 ┃ ┣ 📂hooks
 ┃ ┣ 📂api
 ┃ ┣ 📂assets
 ┃ ┗ 📂utils
 ┣ 📄README.md
 ┗ 📄package.json

Back-end

📦project-root
 ┣ 📂src
 ┃ ┗ 📂main
 ┃   ┣ 📂java
 ┃   ┃ ┗ 📂com
 ┃   ┃   ┗ 📂hicc
 ┃   ┃     ┗ 📂budget
 ┃   ┃       ┣ 📂domain       # Entity 및 도메인 로직
 ┃   ┃       ┣ 📂controller   # API 컨트롤러
 ┃   ┃       ┣ 📂service      # 비즈니스 로직 처리
 ┃   ┃       ┣ 📂repository   # JPA 인터페이스
 ┃   ┃       ┣ 📂dto          # 요청/응답 DTO 클래스
 ┃   ┃       ┗ 📂config       # 설정 관련 클래스
 ┃   ┗ 📂resources
 ┃     ┗ 📄application.properties (또는 .yml)
 ┣ 📄README.md
 ┗ 📄build.gradle

---

👥 팀원 소개

이름	역할	GitHub	Portfolio
조소현	디자이너/기획
김민서	백엔드/기획	https://github.com/kimminseo3
박서영	백엔드/기획	https://github.com/Mymyseoyoung
김범수	프론트엔드/기획	@nonoididnt
박유빈	프론트엔드/기획	@daydreamplace

---

🔗 링크 모음 (예정)

• 기획 (FigJam): (작성 예정)
• 디자인 시안 (Figma): (작성 예정)
• API 문서: (작성 예정)

---

🚧 진행 현황 및 논의 중인 이슈

• ✅ 프로젝트 기획 진행 중
• 🛠 MVP 기능 구성 확정 및 페이지 설계 중
• 🎨 디자인 시안 → 제작 예정
• 🔄 미션 생성 방식: 운영자 제공 vs 사용자 작성 → 논의 중
• 🔐 로그인 방식 (소셜 연동 여부) → 검토 중
• 🧱 백엔드 기술 스택 선정 중: Java + Spring Boot 기반 REST API 설계 예정 → 인증 방식(Spring Security + JWT), DB 구조 설계 논의 중
• 💻 프론트엔드 기술 스택 선정 중 ****→ React 기반 확정, 상태 관리 방식 및 API 연동 전략 검토 중

---

🐛 트러블슈팅 (예정)

개발 과정에서 발생한 문제 상황과 해결 과정을 기록하는 섹션입니다.

협업 중 같은 문제의 반복을 줄이고, 유지보수 시 참고 자료로 활용됩니다.

날짜	문제 상황	원인 분석	해결 방법

⚠️ 트러블슈팅 항목은 개발 중 문제가 생겼을 때마다 순차적으로 업데이트해 주세요.