훈련 코스(Training Course)

개요

본 기능은 여러 개의 곡과 그 곡에 대한 조건들로 이루어진, 훈련 코스를 생성하고 사용할 수 있도록 한다.

타입

훈련 코스

• 훈련 코스는 곡의 이름과 여러 개의 곡과 그 곡에 대한 조건들로 이루어져 있다.
• 조건은 개별 곡에 대해 적용되며, 훈련 코스에 대해 적용되지 않는다.
• 하나의 훈련 코스에서 곡은 중복될 수 없다.

interface TrainingCourse{
	name: string;
	songs: TraningCourseSong[]
}

곡

• 곡은 곡 번호(songNo)와 조건들로 이루어져 있다.
• 각 곡에는 여러 개의 조건이 적용될 수 있다.

interface TrainingCourseSong{
	songNo: number;
	conditions: TrainingCourseCondition[]
}

조건

• 조건은 다음 세가지 요소로 이루어져 있다.
  • 종류: 량, 가, 불가, 콤보, 연타, 두드린 횟수
  • 범위: 이상/이하
  • 기준치
• 조건의 종류는 중복될 수 없다.

interface TrainingCourseCondition{
	type: 'good' | 'ok' | 'bad' | 'combo' | 'roll' | 'hit';
	range: 'more' | 'less'
	criterion: number
}

유저 데이터

• 유저 데이터는 코스와 각 곡에 대한 조건 충족 여부, 달성률로 이루어져 있다.
• 조건 충족 여부는 동더히로바에서는 최근 플레이 기록을 알 수 없기 때문에 베스트 스코어 기록을 기준으로 한다.
• $달성률 = \frac{조건,충족한,곡의,개수}{전체,곡의,개수}$

interface TrainingCourseUserData{
	course: TrainingCourse,
	achievements: Array<{
		songNo: number;
		met: boolean;
	}>,
	achievementRate: {
		numerator: number;
		denominator: number;
	}
}

작동

훈련 코스 표시

• 각 유저들이 추가한 훈련 코스들을 표시한다.
• 접힌 상태에서는 각 훈련 코스들의 이름과 달성률을 표시한다.
• 펼친 상태에서는 각 훈련 코스들의 곡과 각 곡의 조건 충족 여부, 수정 및 삭제, 내보내기 버튼을 표시한다.
• 내보내기 버튼을 누르면 해당 코스를 JSON화 하여 복사할 수 있도록 한다.

수정

• 각 곡의 순서의 수정, 조건 수정, 곡 삭제, 곡 추가가 가능하다.
• 수정 완료하면 유저 데이터에 자동 반영된다.

생성

• 훈련 코스를 생성하고 저장한다.
• 저장 완료하면 유저 데이터에 자동 반영된다.

새로 고침

• 베스트 스코어를 가져와 유저 데이터에 반영한다.
• 새로 고침을 하는 방법은 다음과 같다.
  • 새로 고침 버튼 클릭
  • 훈련 코스 생성/수정

곡 추가가 없는 것 같습니다.