Rename mentor matching to similar players
This commit is contained in:
1 parent
cfbc74d882
commit
ce00bc84b5
14 files changed
+529
-388
No files matched your search
+25
-21
@@ -319,7 +319,7 @@ interface MetricBaseline extends MongooseTimestamps {
|
||||
|
||||
```ts
|
||||
type RecommendationType =
|
||||
| "mentor-match" // MVP 3
|
||||
| "similar-player" // MVP 3
|
||||
| "champion-recommendation" // MVP 4
|
||||
| "llm-feedback"; // MVP 5
|
||||
|
||||
@@ -675,8 +675,8 @@ DB 스키마가 이 단계를 미리 견디도록 상세화한 스펙이다. 구
|
||||
|
||||
지표를 전부 유사도 벡터에 넣으면 희귀 이벤트 기반의 노이즈 축이 코사인 유사도를 오염시킨다. 두 계층으로 나눈다:
|
||||
|
||||
- **vector 지표** (`includeInVector: true`): 게임마다 안정적으로 관측되는 핵심 스타일 축. 벡터·레이더 차트·멘토 매칭에 사용
|
||||
- **insight 지표** (`includeInVector: false`): 희귀 이벤트 기반 비율. 강점/약점 분석, 멘토와의 gap 비교, LLM evidence에 사용. 벡터에는 미포함
|
||||
- **vector 지표** (`includeInVector: true`): 게임마다 안정적으로 관측되는 핵심 스타일 축. 벡터·레이더 차트·유사 유저 탐색에 사용
|
||||
- **insight 지표** (`includeInVector: false`): 희귀 이벤트 기반 비율. 강점/약점 분석, 유사 유저와의 gap 비교, LLM evidence에 사용. 벡터에는 미포함
|
||||
|
||||
**ratio 지표 저장 규칙**: 게임당 발생 횟수가 적은 비율 지표는 매치 단위 rate가 0/1로 튄다. 매치의 `features`에는 `{metricId}Numerator` / `{metricId}Denominator`로 **횟수만** 저장하고, rate는 profile builder가 `Σ분자/Σ분모`로 계산해 `profile`에 저장한다. registry의 `kind: 'scalar' | 'ratio'`가 이를 결정한다 (§5.1).
|
||||
|
||||
@@ -759,7 +759,9 @@ DB 스키마가 이 단계를 미리 견디도록 상세화한 스펙이다. 구
|
||||
|
||||
---
|
||||
|
||||
## 12. MVP 3 상세 — 고티어 pool · percentile 정규화 · 멘토 매칭
|
||||
## 12. MVP 3 상세 — 고티어 pool · percentile 정규화 · 유사 유저 탐색
|
||||
|
||||
> **컨셉 (2026-07-03 재정의)**: 이 기능은 "멘토 매칭"이 아니라 **나와 플레이스타일이 비슷한 유저 찾기**다. 목적은 따라 할 상위 티어 유저를 지정해주는 것이 아니라, "스타일은 비슷한데 왜 저 유저는 점수(티어)가 더 높거나/낮은가"라는 인사이트를 주는 것. 따라서 후보를 티어로 거르지 않고 유사도 중심으로 랭킹하며, 티어 관계(tierComparison)와 지표 우위(양방향)를 함께 제공한다. seed pool(§12.1)은 필터 조건이 아니라 **비교 후보군의 주 공급원**이다.
|
||||
|
||||
### 12.1 고티어 seed pool 수집
|
||||
|
||||
@@ -800,35 +802,37 @@ DB 스키마가 이 단계를 미리 견디도록 상세화한 스펙이다. 구
|
||||
|
||||
filter로 쓰는 필드(tier, isSeed 등)가 `player_profile`에 **비정규화되어 있어야** `$vectorSearch` 단계에서 join 없이 거를 수 있다 — §4.4 스키마가 이를 전제한다.
|
||||
|
||||
### 12.4 멘토 매칭 파이프라인
|
||||
### 12.4 유사 유저 탐색 파이프라인
|
||||
|
||||
```text
|
||||
1. 내 player_profile 조회 (없으면 404)
|
||||
2. $vectorSearch:
|
||||
queryVector = 내 vector, numCandidates = 200, limit = 50
|
||||
filter: { mainRole: eq 내 mainRole, queueId: eq 420,
|
||||
tier: in [MASTER, GRANDMASTER, CHALLENGER], isSeed: eq true,
|
||||
sampleGameCount: gte 20, featureSchemaVersion: eq 현재 버전 }
|
||||
※ tier/isSeed 필터 없음 — "비슷한 유저"가 목적이므로 어느 티어든 후보.
|
||||
(인덱스의 tier/isSeed filter 필드는 유지 — 추후 옵션 필터용)
|
||||
3. 앱 레벨 re-rank (Top 50 → Top K):
|
||||
final = 0.60 * styleSim # $vectorSearch score (cosine)
|
||||
+ 0.20 * championPoolSim # 양쪽 championPool 상위 5개 Jaccard
|
||||
final = 0.70 * styleSim # $vectorSearch score (cosine) — 유사도가 랭킹을 지배
|
||||
+ 0.18 * championPoolSim # 양쪽 championPool 상위 5개 Jaccard
|
||||
+ 0.12 * recencyScore # lastMatchAt 지수 감쇠 (half-life 14일)
|
||||
+ 0.08 * tierScore # CHALLENGER 1.0 / GM 0.8 / MASTER 0.6
|
||||
- lowSamplePenalty # sampleGameCount < 30이면 0.1
|
||||
(mainRole은 filter로 보장되므로 별도 가중치 없음)
|
||||
4. 각 멘토에 대해 지표 비교 계산:
|
||||
- 비슷한 지표 Top 3: |내 profile[m] - 멘토 profile[m]| 최소
|
||||
- 멘토가 앞서는 지표 Top 3: direction 반영 gap 최대 (lowerIsBetter는 반전)
|
||||
5. recommendation 컬렉션에 캐시 (type: 'mentor-match', profileUpdatedAt 기록)
|
||||
(tierScore 없음 — 티어는 랭킹 요소가 아니라 인사이트. mainRole은 filter로 보장)
|
||||
4. 각 유사 유저에 대해 비교 계산:
|
||||
- tierComparison: 내 tier 대비 higher | same | lower | unknown
|
||||
- 비슷한 지표 Top 3: |내 profile[m] - 상대 profile[m]| 최소
|
||||
- 상대가 앞서는 지표 Top 3 (strongerMetrics): direction 반영 gap 최대 (lowerIsBetter는 반전)
|
||||
- 내가 앞서는 지표 Top 3 (weakerMetrics): 위와 대칭 — 상대가 나보다 낮은 티어일 때의 인사이트
|
||||
5. recommendation 컬렉션에 캐시 (type: 'similar-player', profileUpdatedAt 기록)
|
||||
→ 내 프로필이 갱신되면 stale로 보고 재계산
|
||||
```
|
||||
|
||||
### 12.5 API / UI
|
||||
|
||||
- `GET /api/players/:puuid/mentor-matches?limit=10` — 캐시 있으면 캐시, stale이면 재계산
|
||||
- 응답 항목: similarityScore, finalScore, Riot ID(표시용), tier, mainRole, mainChampions(top 3), sampleGameCount, similarMetrics[3], gapMetrics[3]
|
||||
- 대시보드에 멘토 비교 테이블 추가. 화법: "따라 하라"가 아니라 "당신과 비슷한 상위 티어 그룹은 이런 경향" 유지 (§1.3, §14)
|
||||
- seed 유저의 Riot ID 표시는 공개 데이터이지만, 표시 형식은 전적 사이트 관례 수준으로 유지
|
||||
- `GET /api/players/:puuid/similar-players?limit=10` — 캐시 있으면 캐시, stale이면 재계산
|
||||
- 응답 항목: similarityScore, finalScore, Riot ID(표시용), tier, tierComparison, mainRole, mainChampions(top 3), sampleGameCount, similarMetrics[3], strongerMetrics[3], weakerMetrics[3]
|
||||
- 대시보드에 "나와 비슷한 플레이어" 테이블 추가. 화법: "따라 하라"가 아니라 "나와 비슷한 이 유저는 이런 지표에서 차이가 난다" 유지 (§1.3, §14). 상대가 높은 티어면 strongerMetrics가, 낮은 티어면 weakerMetrics가 인사이트의 중심
|
||||
- 유저 Riot ID 표시는 공개 데이터이지만, 표시 형식은 전적 사이트 관례 수준으로 유지
|
||||
|
||||
---
|
||||
|
||||
@@ -837,13 +841,13 @@ filter로 쓰는 필드(tier, isSeed 등)가 `player_profile`에 **비정규화
|
||||
### MVP 4: 챔피언 추천
|
||||
|
||||
- 챔피언 스타일 벡터: 초기엔 수동 taxonomy(주요 챔피언 ~60개), 이후 seed 유저 match data 기반 자동화. **스키마는 `champion_style_profile`(§4.8)로 이미 준비됨**
|
||||
- Fit(현 스타일 유사) / Growth(약점 보완) / Stretch(폭 확장) 3종 추천 + 근거(유사도, 유사 고티어 유저 pool 등장 빈도) 표시. 결과는 `recommendation`(type: 'champion-recommendation')에 캐시
|
||||
- Fit(현 스타일 유사) / Growth(약점 보완) / Stretch(폭 확장) 3종 추천 + 근거(유사도, 유사 유저 pool 등장 빈도) 표시. 결과는 `recommendation`(type: 'champion-recommendation')에 캐시
|
||||
- Data Dragon 연동 (챔피언 이름/이미지, 패치별 static data)
|
||||
|
||||
### MVP 5: LLM 피드백
|
||||
|
||||
- `FeedbackGenerator` 인터페이스로 provider 추상화 (provider는 이 시점에 결정)
|
||||
- 입력: 백엔드가 만든 evidence JSON만 (user profile 지표, 멘토 그룹과의 gap Top-N, `derived`의 데스 위치 요약). raw match JSON 입력 금지
|
||||
- 입력: 백엔드가 만든 evidence JSON만 (user profile 지표, 유사 유저와의 gap Top-N, `derived`의 데스 위치 요약). raw match JSON 입력 금지
|
||||
- 출력: strict JSON schema 검증. 모든 피드백 항목은 metricId 참조 필수, 검증 실패/LLM 장애 시 rule-based fallback 문장 사용. 결과는 `recommendation`(type: 'llm-feedback')에 캐시
|
||||
- 화법 규칙: 비난 금지, "다음 5게임에서 실험할 행동" 형태, 실시간 지시·MMR 추정 표현 금지
|
||||
|
||||
@@ -853,5 +857,5 @@ filter로 쓰는 필드(tier, isSeed 등)가 `player_profile`에 **비정규화
|
||||
|
||||
- **데이터 품질이 AI보다 중요하다.** feature extraction이 틀리면 앱 전체 신뢰가 무너진다. 파이프라인 안정화가 항상 우선.
|
||||
- **비교군 설계가 핵심이다.** 전체 평균이 아니라 같은 포지션·유사 챔피언·비슷한 패치·충분한 sample size 기준으로 비교한다.
|
||||
- **결과는 항상 근거와 함께.** "운영이 약합니다"(X) → "10분 골드 리드 게임에서 첫 전령 관여율이 유사 고티어 그룹보다 낮습니다"(O).
|
||||
- **결과는 항상 근거와 함께.** "운영이 약합니다"(X) → "10분 골드 리드 게임에서 첫 전령 관여율이 유사 유저 그룹보다 낮습니다"(O).
|
||||
- **추천은 단정하지 않는다.** "이 챔피언을 해야 티어가 오릅니다"(X) → "현재 스타일과 잘 맞을 가능성이 높은 후보입니다. 다음 10게임에서 비교해보세요"(O).
|
||||
Reference in new issue
Block a user