[Documentation] 능력 평가 요구 사항

[this-is-spear]

능력 평가 요구사항

1. 사용자는 참여자를 평가할 수 있다.
2. 사용자는 자신의 평가를 확인할 수 있다.
3. 사용자는 상대방의 평가를 확인할 수 있다.
4. 능력 평가는 평가한 상대방의 레벨에 비례해서 계산된다.

능력 평가 프로그래밍 요구사항

1. 능력을 조회할 때, 사용자 정보에서 저장된 능력을 조회한다.
2. 능력은 평가받을 때마다 갱신된다.

[this-is-spear]

용어 사전

한국어	영어	타입	설명
참여자의 식별자	ParticipantId	Long	게임에 참여하는 참여자의 식별자
모집 식별자	RequritmentId	Long	모집의 고유 식별자
평가 점수	RatingScore	Long	사용자의 점수
평가 항목	EvaluationList	Enum	평가하기 위해 작성된 항목
사용자 정보	UserId	Long	사용자의 정보를 확인할 수 있는 식별자

[this-is-spear]

모델링

RatingController

• 모집의 식별자, 참여자의 식별자와 평가 정보를 입력해 사용자의 능력을 평가한다.
• 사용자 식별자를 입력해 사용자의 평가 점수를 조회한다.

RatingService

• 사용자가 참여자의 능력을 평가한다.
  • 참여자와 사용자는 해당 모집의 일원이어야 한다.
  • 자신의 Ratring Score와 상대방의 Rating Score, 그리고 평가 항목을 이용해 점수를 평가한다.
    • Elo Rating Algorithm를 이용해 계산한다.
• 상대방의 평가 점수를 조회한다.

Rating

• 상태
  • Rating은 사용자의 정보와 Rating Score가 포함된다.
• 행위
  • 점수를 수정한다.
  • 점수를 조회한다.

[this-is-spear]

능력 평가 이벤트 흐름

1. 사용자가 참여자의 능력을 평가했다.
2. 사용자가 상대방의 능력을 조회했다.

[this-is-spear]

능력 평가 사용자 시나리오

1. 매칭이 끝난 사용자는 참여자들 중 한 명을 평가할 수 있다.
2. 사용자는 자신의 Rating을 조회할 수 있다.

[wjdxor]

용어 사전

한국어	영어	타입	설명
참여자의 식별자	ParticipantId	Long	게임에 참여하는 참여자의 식별자
모집 식별자	RecruitmentId	Long	모집의 고유 식별자
평가 점수	RatingScore	double	사용자의 점수
매너 평가	mannerTemperature	Enum	사용자의 매너 점수
사용자 정보	UserId	Long	사용자의 정보를 확인할 수 있는 식별자
상세 후기	detail	String	후기 내용

*Enum type을 쓰는 이유