README.md

Project - miniVIBE

NAVER VIBE를 클론하고,
프로덕트의 UI/UX 향상, 이용자 행동 패턴 분석을 위한 사용자 이벤트를 수집하는 프로젝트
부스트캠프 2020의 마지막 프로젝트로, WEB과 iOS가 협업하여 만들어낸 결과물

WE ARE...

김민지 🕸	임지영 🕸	조정혜 🕸	조수정 🍎	홍동현 🍎
@mingd1023	@YimJiYoung	@Jeonghae10	@Sueaty	@TTOzzi
열심히 살자!!	집이 좋아 집순이	열냥이집사	스위리	또치

Collecting EVENTS

VIBE는 사용자의 음악 선호도 파악, 사용성 개선, 마케팅 등 다양한 목적으로 이벤트를 수집합니다. miniVIBE 는 재생관련 이벤트와 비재생관련 이벤트를 구분하고 이벤트 발생 시점을 정의한 후 서버에게 보내질 parameter를 정합니다.

예시 --- 더 많은 목록 보러 가기🚀

Event Name	Automatically Triggered When...	Parameters
Search	검색 탭에서 특정 검색어를 검색하였을 때	event_id / user_id / timestamp / component_id / text

miniVIBE In-Depth

iOS 🍎	IN-DEPTH	WEB 🕸	IN-DEPTH
기능	바로가기	기능	바로가기
기술 스택	바로가기	기술 스택	바로가기
설계 & 구현	바로가기	기술 특장점	바로가기
기술 공유	바로가기	배포주소	바로가기

miniVIBE - WEB 기능 In-Depth

전체 동작

DB에 저장되어 있는 콘텐츠를 각 페이지에서 조회

예시: 각 페이지 조회

각 콘텐츠(매거진, 앨범, 트랙, 아티스트)를 클릭하여 각 상세 페이지로 이동

예시: 각 페이지 조회

나만의 플레이리스트 생성

예시: 새 플레이리스트 생성
새 플레이리스트 생성
생성된 플레이리스트에 추가된 것 확인

각 콘텐츠를 내 플레이리스트에 추가

예시: 플레이리스트를 내 플레이리스트(특정)에 추가

관리자 메뉴

예시: 쌓여진 이벤트 로그들을 관리자 메뉴에서 확인할 수 있다.

보관함

보관함에 내가 좋아한 트랙 / 플레이리스트 / 아티스트 / 앨범 저장

1. 대상의 드롭다운 메뉴에서 보관함에 추가 클릭
2. 보관함에 추가하는 대상 저장

예시: 플레이리스트 추가

내 보관함에서 내가 좋아한 트랙 / 플레이리스트 / 아티스트 / 앨범 조회

1. 보관함 데이터 조회
2. 데이터 있을 경우 데이터의 리스트 조회 , 없을 경우 안내멘트

   예시: 보관함 데이터 조회

뮤직 플레이어

트랙 / 앨범 / 플레이리스트 / 믹스테잎을 뮤직 플레이어 재생 목록에 추가

예시: 특정 곡(전체 트랙) 재생

예시: 리스트 카드의 재생버튼으로 재생목록에 추가

음원 재생을 제외한 뮤직 플레이어 기능

예시: 재생목록에서 삭제 및 이전/다음곡 재생

miniVIBE - iOS 기능 In-Depth

화면 별 표시할 정보 서버로부터 가져오기

예시 : TODAY 화면	설명
	1. 주어진 API의 JSON 구조에 맞게 JSONDecoder를 사용하여 원하는 타입으로 변환 후 뷰에 적용 2. 화면마다 또는 섹션마다 알맞은 스크롤 방향 설정 (Vertical / Horizontal)

현재 재생목록에 track 추가	설명
	1. 재생을 원하는 곡을 선택하면 현재 재생목록 상단에 추가되고 재생 순서가 변경 됨 2. 현재 재생목록은 플레이어를 열어 확인 가능 3. CoreData를 활용해 앱을 종료하고 재실행하더라도 추가했던 Track의 정보가 유지

플레이어

플레이어	설명
	1. 재생/일시정지 가능 및 재생 상태에 따른 UI 변경 (자켓 사진의 변화, 가사 미리보기) 2. 재생 시 가사보기 가능 3. 특정 트랙에 좋아요/좋아요 취소 (트랙에 대한 평가는 '보관함'에 적용 됨.) 4. 현재 재생목록에 있는 트랙의 재생 순서 변경 및 목록에서 제거 가능

발생한 이벤트 전송

사전에 정의 된 이벤트가 발생할 경우 필요한 정보를 담아 서버에 전송
인터넷 연결성을 확인하여 인터넷이 연결된 상태일 경우에는 바로 서버에 전송되고
연결 상태가 아닐 경우 Core Data에 임시 저장되어 있다 연결이 회복되었을 경우 네트워크에 전송

서버로 보내진 이벤트 로그 웹 Admin에서 확인하기

네트워크 연결 O	설명
	1. 이벤트가 발생할 때 마다 실시간으로 서버에 이벤트 로그를 전송 2. 서버에 저장된 이벤트 로그를 불러와 출력하는 화면

네트워크 연결 X	설명
	1. 이벤트가 발생할 때 네트워크에 연결되어 있다면 기기에 로그를 저장하지 않고 서버에 바로 전송하지만, 연결되어 있지 않다면 CoreData를 활용해 기기에 로그를 저장 2. 기기에 저장된 이벤트 로그를 불러와 출력하는 화면 3. 기기가 wifi를 통해 네트워크에 연결될 때 기기에 저장된 로그를 서버에 전송 4. 서버 로그 확인 화면을 통해 기기에 저장되었던 로그가 잘 전송된 것을 확인할 수 있음