📱 스탬프잇 (Stamp-It)

🏠 가족, 룸메이트, 공동체가 함께하는 미션 완료 앱
미션을 통해 생활습관과 집안밀 분배 문제를 개선하고, 스탬프 수집으로 재미를 더한 소통 플랫폼입니다! 🎯

---

👥 팀 소개

🔹 팀명: 한 지붕 육남매

🎯 팀 목표

꾸준한 업데이트와 사용자 경험 중심 설계! 소프트웨어 역량 증진과 완성도 높은 앱 개발!

👨‍👩‍👧‍👦 팀원 구성

이름	역할	담당 기능
이부용 🔥	팀장, Backend	Firebase DB 설계, 소셜 로그인, 마이페이지 유저 관리, 온보딩 화면
곽다은 💻	부리더, iOS 개발	홈 화면, 미션 대시보드, 미션 완료 처리, 필터 기능
윤주형 🚀	iOS 개발	그룹 초대/가입, 토스트 메시지, 마이페이지 그룹 관리
권순욱 ⚡	iOS 개발	미션 목록, 미션 전달, 마이페이지 프로필 수정, 커스텀 미션
손하경 ✨	iOS 개발	마이페이지 스탬프 관리, 공통 네비게이션, 런치, 스탬프 상세보기

---

📌 프로젝트 개요

• 앱명: 스탬프잇 (Stamp-It)
• 프로젝트 기간: 2025.05.29 ~ 2025.06.20 (3주)
• 핵심 기능: 그룹 미션 관리 / 스티커 수집 / 랭킹 시스템 / 생활습관 개선
• GitHub: https://github.com/nbcamp-final-team3/stamp-it.git
• Figma: https://www.figma.com/board/iSgtQcnyIg4s7C0ZmUVxoF/스탬프잇
• 컬러 코드: #6B73FF #9B59B6 #E74C3C

---

🛠️ 기술 스택 & 개발 환경

• 언어: Swift
• UI 프레임워크: UIKit (Code-Base), SwiftUI
• 아키텍처: MVVM + Clean Architecture
• 데이터베이스: Firebase Firestore
• 인증: Firebase Auth (구글, 애플 소셜 로그인)

📚 외부 라이브러리

• 🧩 SnapKit – UI 오토레이아웃 코드 작성
• 🧠 RxSwift / RxCocoa – 반응형 프로그래밍
• ✨ Then – 인스턴스 초기화 간소화
• 🎞️ Lottie – 애니메이션 효과
• 🔥 Firebase-SDK – 데이터베이스 및 인증
• 🔐 GoogleSignIn – 구글 소셜 로그인

---

🤝 협업 방식

📋 프로젝트 관리

• Jira: 이슈 트래킹 및 스프린트 관리
• GitHub: 코드 리뷰 및 브랜치 전략
• Slack: 실시간 소통

🔄 개발 프로세스

• 스크럼: 오전 10:00, 오후 19:00 정기 미팅
• PR 룰: 2명 이상 승인 시 머지
• 코드 리뷰: Pn 룰 적용으로 효율적 피드백

📝 컨벤션

• 커밋: [타입] #이슈번호 - 작업내용
• 브랜치: feat/#이슈번호-기능명
• 코딩: Swift Style Guide 준수

---

📷 앱스크린

---

🎬 시연 영상

📺 시연 영상: YouTube 링크

---

✨ 주요 기능

🔁 온보딩 + 로그인 기능

• 📊 온보딩: 앱에 대한 소개와 목표를 간단하게 제공 (앱 최초 접속 시 제공)
• 🔑 소셜 로그인(구글, 애플): 애플, 구글 계정으로 편리하게 서비스 이용 가능
• 🗝️ 자동 로그인: 처음 로그인 시 인증 만료 전까지 자동로그인

🏠 홈 화면

• 📊 그룹 랭킹: 이번 달 스탬프 개수로 그룹내 멤버 순위 표시
• 🎯 나의 미션: 할당받은 미션 목록 확인과 진행 완료 체크
• 👥 멤버 미션: 다른 구성원에게 부여한 미션 현황(멤버별, 상태별 필터링 기능)
• ✅ 미션 완료: 3초 취소 가능한 완료 처리(토스트), 준 미션-완료 미션도 모두 취소 가능

🎯 미션 시스템

• 📝 앱 제공 미션: 5가지 카테고리 (즐겨찾기, 집안일, 가족소통, 건강운동, 독서학습)
• 🗒️ 커스텀 미션: 직접 부여하고 싶은 미션을 작성해서 팀원에게 할당
• 🔍 미션 검색: 키워드 및 카테고리별 필터링
• ⭐ 미션 즐겨찾기: 자주 사용하는 미션을 즐겨찾기로 관리(상단고정, 카테고리)
• 🎯 추천 미션: 사용자 행동 패턴 기반 맞춤 미션 추천
• ⏰ 미션 기한: 미션 기한이 지나면 자동 만료 처리
• 🎁 스탬프 보상: 미션 완료 시 스탬프 획득 (마이페이지 확인 가능)

🏆 마이페이지 + 스탬프판

• 🍇 월별 스탬프판: 스탬프 수집
• 📈 진행률 표시: 개인 스탬프 현황(스탬프 총 개수, 완성한 스탬프판 개수)
• 📜 여러개의 스템프판 확인: 총 4개의 스탬프판을 페이징으로 확인 가능
• 🌟 스탬프 상세 정보 확인: 스탬프 획득일, 미션 부여자, 미션내용 등을 확인 능

👤 마이페이지 + 프로필

• 🖼️ 프로필 관리: 닉네임, 프로필 이미지 변경
• 🔐 계정 관리: 로그아웃, 서비스탈퇴

👤 마이페이지 + 프로필(그룹관리)

• 🔗 초대 시스템: 코드 복사로 간편한 그룹 초대 및 가입 가능
• 👑 그룹 리더: 그룹명 변경, 멤버 관리 권한(멤버 내보내기, 리더 위임)
• 🚪 그룹 탈퇴: 기존 그룹 탈퇴 후 1인 그룹 자동 생성

---

📁 폴더 구조 요약

📦 StampIt-Project
├── 📂 Application           # 앱 실행 및 설정
├── 📂 Data                  # 데이터 계층
│   ├── 📂 DataSources       # Firebase 데이터 소스
│   ├── 📂 RepositoriesImpl  # 저장소 구현체
│   └── 📂 Entities          # 데이터 모델
├── 📂 Domain                # 비즈니스 로직
│   ├── 📂 Entities          # 도메인 엔티티
│   ├── 📂 Repositories      # 저장소 인터페이스
│   └── 📂 UseCases          # 유스케이스
├── 📂 Presentation          # UI 계층
│   ├── 📂 Launch            # 런치 관리
│   ├── 📂 Onboarding        # 온보딩 관리
│   ├── 📂 Home              # 홈 화면
│   ├── 📂 Group             # 그룹 관리
│   ├── 📂 Mission           # 미션 관리
│   ├── 📂 Invite            # 초대 관리
│   ├── 📂 Login             # 로그인 관리
│   ├── 📂 MyPage            # 마이페이지
│   └── 📂 Common            # 공통 UI 컴포넌트
└── 📂 Resources             # 리소스 파일
    ├── 🖼️ Assets.xcassets
    ├── 🎞️ Lottie
    └── 📝 Info.plist

---

🚀 주요 구현 사항

✅ MVP 완료 기능

🔐 인증 시스템

• 구글/애플 소셜 로그인
• 자동 로그인 및 세션 관리
• 온보딩 화면 (최초 접속 시)

👥 그룹 시스템

• 회원가입 시 1인 그룹 자동 생성
• 초대 코드를 통한 그룹 가입
• 그룹 탈퇴 및 멤버 관리

🎯 미션 관리

• 4개 카테고리별 미션 제공
• 미션 검색 및 필터링
• 미션 할당 및 기한 설정
• 미션 완료 처리 (3초 취소 가능)

🏆 스티커 & 랭킹

• 미션 완료 시 스티커 자동 부여
• 월별 개인 스티커판
• 그룹 내 랭킹 시스템

👤 프로필 관리

• 닉네임 변경 (월 1회 제한)
• 프로필 이미지 설정
• 계정 관리 기능

---

🔮 향후 개발 계획

▶️ Update Flow

📋 v1.1.1 (이전)

• 🔷 기본 미션 관리 시스템
• 🔷 스탬프 수집 기능
• 🔷 그룹 관리 및 초대 시스템
• 🔷 Google/Apple 소셜 로그인

🎯 v1.1.2 (이전)

• ☑️ 홈화면 멤버 미션 필터 기능 추가
• ☑️ 리더 권한 관리 기능 추가(멤버 내보내기, 리더 권한 위임)
• ☑️ UI 업데이트, 애니메이션 추가

🚀 v1.1.3 (이전)

• 🔄 내 미션, 멤버 미션 화면 상 필터 기능 추가
• 🔄 여러개의 스탬프판 확인 가능
• 🔄 커스텀 미션 추가

📝 v1.1.4 (이전)

• ✅ 오류 수정
• ✅ 미션 즐겨찾기(개인화)

🌟 v1.1.5 (이전)

• 🔖 스탬프 상세 보기
• 🔖 준 미션, 이미 완료된 미션 취소
• 🔖 사용자 행동 기반 미션 추천 시스템 구현

🎶 v1.1.6 (현재)

• 🛎️ 위젯 추가

🎨 v1.2.0 (계획)

• 📊 상세 통계 및 분석 추가
• 🎵 사운드 효과 및 애니메이션 강화
• 🌙 다크 모드 지원
• 🔔 미션 주고 받기 실시간 알림(FCM)

🌟 v2.0.0 (장기 계획)

• 🏅 성취 배지/업적/소원권 시스템
• 🤖 AI 기반 미션 추천
• 🏆 가족 간 경쟁 시스템
• 💰 리워드 시스템 연동
• 🌐 다국어 지원

---

🏁 주요 개발 성과

1. 커스텀 미션 구현, 즐겨찾기, 추천 미션 시스템 구현

• 커스텀 미션추가: 사용자가 직접 커스텀한 미션을 부여할 수 있어 유연성 증가
• 사용자 행동 기반 점수 시스템: 미션 탭(0.1점), 전달하기(0.4점)로 개인화된 추천 제공
• 즐겨찾기: 즐겨찾기 지정 시 해당 미션이 상단에 고정 되어 사용자 경험 증가

2. 버전 호환성 관리 시스템

• 강제 업데이트 메커니즘: Firebase 기반 실시간 버전 체크 및 자동 앱스토어 이동
• 호환성 문제 해결: 새로운 enum 케이스 추가로 인한 크래시 방지
• 유연한 메시지 관리: 서버 설정만으로 업데이트 안내 메시지 실시간 변경

3. 사용자 경험 개선

• 키보드 UI 최적화: 다양한 디바이스에서 입력 시 UI 가림 현상 해결
• 미션 완료 취소 로직: 홈화면에서 즉시 API 호출 및 토스트 피드백 제공
• 필터링 기능 강화: 멤버별, 상태별 미션 현황 필터링으로 관리 편의성 향상

---

📞 문의 및 피드백

• GitHub Issues: 프로젝트 이슈 페이지
• 팀 리더: 이부용 (dqd001@naver.com)
• 팀 부리더: 곽다은 (down022@gmail.com)

---

🌟 "함께 만들어가는 생활습관, 스탬프잇과 함께하세요!" 🌟
한 지붕 육남매 팀, 화이팅! 🚀