.
This commit is contained in:
1 parent
4475a2d86b
commit
a076bca587
10 files changed
+2725
-61
No files matched your search
@@ -0,0 +1,90 @@
|
|||||||
|
import mongoose from 'mongoose';
|
||||||
|
import { ConnectionService } from '../global/database/connection.service';
|
||||||
|
import { RiotAccount, UserDocument } from '../global/database/schema';
|
||||||
|
import { RiotAccountEnrichmentService } from '../riot/riot-account-enrichment.service';
|
||||||
|
import { RiotAccountService } from '../riot/riot-account.service';
|
||||||
|
import { DakaoUserError, DakaoUserService } from './dakao-user.service';
|
||||||
|
|
||||||
|
const objectId = (hex: string) => new mongoose.Types.ObjectId(hex);
|
||||||
|
|
||||||
|
function makeQuery<T>(value: T) {
|
||||||
|
return {
|
||||||
|
exec: jest.fn().mockResolvedValue(value),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeService(params: {
|
||||||
|
user: Partial<UserDocument>;
|
||||||
|
riotAccountService?: Partial<RiotAccountService>;
|
||||||
|
enrichmentService?: Partial<RiotAccountEnrichmentService>;
|
||||||
|
}) {
|
||||||
|
const findOneAndUpdate = jest
|
||||||
|
.fn()
|
||||||
|
.mockReturnValue(makeQuery(params.user as UserDocument));
|
||||||
|
const connectionService = {
|
||||||
|
getModel: jest.fn().mockResolvedValue({ findOneAndUpdate }),
|
||||||
|
} as unknown as ConnectionService;
|
||||||
|
const riotAccountService = {
|
||||||
|
getByRiotId: jest.fn(),
|
||||||
|
...params.riotAccountService,
|
||||||
|
} as unknown as RiotAccountService;
|
||||||
|
const enrichmentService = {
|
||||||
|
enrichRiotAccount: jest.fn(),
|
||||||
|
...params.enrichmentService,
|
||||||
|
} as unknown as RiotAccountEnrichmentService;
|
||||||
|
|
||||||
|
return {
|
||||||
|
service: new DakaoUserService(
|
||||||
|
connectionService,
|
||||||
|
riotAccountService,
|
||||||
|
enrichmentService,
|
||||||
|
),
|
||||||
|
connectionService,
|
||||||
|
findOneAndUpdate,
|
||||||
|
riotAccountService,
|
||||||
|
enrichmentService,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('DakaoUserService', () => {
|
||||||
|
it('rejects account registration when the user already has a Riot account', async () => {
|
||||||
|
const save = jest.fn().mockResolvedValue(undefined);
|
||||||
|
const existingAccount = {
|
||||||
|
puuid: 'puuid-1',
|
||||||
|
gameName: '기존소환사',
|
||||||
|
tagLine: 'KR1',
|
||||||
|
isPrimary: true,
|
||||||
|
} as RiotAccount;
|
||||||
|
const {
|
||||||
|
service,
|
||||||
|
connectionService,
|
||||||
|
riotAccountService,
|
||||||
|
enrichmentService,
|
||||||
|
} = makeService({
|
||||||
|
user: {
|
||||||
|
_id: objectId('222222222222222222222222'),
|
||||||
|
riotAccounts: [existingAccount],
|
||||||
|
save,
|
||||||
|
} as Partial<UserDocument>,
|
||||||
|
});
|
||||||
|
|
||||||
|
await expect(
|
||||||
|
service.registerPrimaryRiotAccount({
|
||||||
|
communityId: objectId('111111111111111111111111'),
|
||||||
|
kakaoTalkId: 'kakao-user-1',
|
||||||
|
kakaoTalkNickname: '프리리',
|
||||||
|
gameName: '새소환사',
|
||||||
|
tagLine: 'KR2',
|
||||||
|
}),
|
||||||
|
).rejects.toMatchObject({
|
||||||
|
code: 'riot_account_already_registered',
|
||||||
|
detail: '기존소환사#KR1',
|
||||||
|
} satisfies Partial<DakaoUserError>);
|
||||||
|
|
||||||
|
expect(connectionService.getModel).toHaveBeenCalledTimes(1);
|
||||||
|
expect(connectionService.getModel).toHaveBeenCalledWith('user');
|
||||||
|
expect(riotAccountService.getByRiotId).not.toHaveBeenCalled();
|
||||||
|
expect(enrichmentService.enrichRiotAccount).not.toHaveBeenCalled();
|
||||||
|
expect(save).not.toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -19,6 +19,7 @@ export class DakaoUserError extends Error {
|
|||||||
| 'invalid_project_id'
|
| 'invalid_project_id'
|
||||||
| 'community_not_found'
|
| 'community_not_found'
|
||||||
| 'riot_account_not_found'
|
| 'riot_account_not_found'
|
||||||
|
| 'riot_account_already_registered'
|
||||||
| 'riot_account_conflict'
|
| 'riot_account_conflict'
|
||||||
| 'riot_account_lookup_failed',
|
| 'riot_account_lookup_failed',
|
||||||
public readonly detail?: string,
|
public readonly detail?: string,
|
||||||
@@ -174,70 +175,28 @@ export class DakaoUserService {
|
|||||||
context: ResolveContext,
|
context: ResolveContext,
|
||||||
): Promise<ResolveResult> {
|
): Promise<ResolveResult> {
|
||||||
const user = await this.upsertUser(context);
|
const user = await this.upsertUser(context);
|
||||||
|
const existingPrimary = user.riotAccounts.find(
|
||||||
|
(account) => account.isPrimary,
|
||||||
|
);
|
||||||
|
const existingAccount = existingPrimary ?? user.riotAccounts[0];
|
||||||
|
if (existingAccount) {
|
||||||
|
throw new DakaoUserError(
|
||||||
|
'riot_account_already_registered',
|
||||||
|
`${existingAccount.gameName}#${existingAccount.tagLine}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
const routing = await this.resolveRiotRouting(context.communityId);
|
const routing = await this.resolveRiotRouting(context.communityId);
|
||||||
const { requestedGameName, requestedTagLine, dto } =
|
const { requestedGameName, requestedTagLine, dto } =
|
||||||
await this.lookupRiotIdentity(context, routing);
|
await this.lookupRiotIdentity(context, routing);
|
||||||
const nextGameName = dto.gameName ?? requestedGameName;
|
const nextGameName = dto.gameName ?? requestedGameName;
|
||||||
const nextTagLine = dto.tagLine ?? requestedTagLine;
|
const nextTagLine = dto.tagLine ?? requestedTagLine;
|
||||||
|
|
||||||
let targetIndex = user.riotAccounts.findIndex(
|
return this.attachRiotAccount({
|
||||||
(account) => account.puuid === dto.puuid,
|
|
||||||
);
|
|
||||||
if (targetIndex === -1) {
|
|
||||||
targetIndex = user.riotAccounts.findIndex(
|
|
||||||
(account) =>
|
|
||||||
account.gameName.toLowerCase() === requestedGameName.toLowerCase() &&
|
|
||||||
account.tagLine.toLowerCase() === requestedTagLine.toLowerCase(),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (targetIndex >= 0) {
|
|
||||||
const target = user.riotAccounts[targetIndex];
|
|
||||||
const puuidChanged = target.puuid !== dto.puuid;
|
|
||||||
target.puuid = dto.puuid;
|
|
||||||
target.gameName = nextGameName;
|
|
||||||
target.tagLine = nextTagLine;
|
|
||||||
if (puuidChanged) this.clearRiotCache(target);
|
|
||||||
user.riotAccounts.forEach((account, index) => {
|
|
||||||
account.isPrimary = index === targetIndex;
|
|
||||||
});
|
|
||||||
await this.saveUserHandlingDuplicate(user, nextGameName, nextTagLine);
|
|
||||||
return this.enrichAttachedAccount({
|
|
||||||
user,
|
user,
|
||||||
riotAccount: target,
|
|
||||||
platform: routing.platform,
|
|
||||||
region: routing.region,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
user.riotAccounts.forEach((account) => {
|
|
||||||
account.isPrimary = false;
|
|
||||||
});
|
|
||||||
user.riotAccounts.push({
|
|
||||||
puuid: dto.puuid,
|
puuid: dto.puuid,
|
||||||
gameName: nextGameName,
|
gameName: nextGameName,
|
||||||
tagLine: nextTagLine,
|
tagLine: nextTagLine,
|
||||||
profileIconId: 0,
|
|
||||||
revisionDate: 0,
|
|
||||||
summonerLevel: 0,
|
|
||||||
isPrimary: true,
|
|
||||||
tiers: [],
|
|
||||||
tierHistory: [],
|
|
||||||
matchIds: [],
|
|
||||||
championMasteries: [],
|
|
||||||
championRecords: {},
|
|
||||||
} as unknown as RiotAccount);
|
|
||||||
|
|
||||||
await this.saveUserHandlingDuplicate(user, nextGameName, nextTagLine);
|
|
||||||
const attached = user.riotAccounts.find(
|
|
||||||
(account) => account.puuid === dto.puuid,
|
|
||||||
);
|
|
||||||
if (!attached) {
|
|
||||||
throw new DakaoUserError('riot_account_lookup_failed', 'attach failed');
|
|
||||||
}
|
|
||||||
return this.enrichAttachedAccount({
|
|
||||||
user,
|
|
||||||
riotAccount: attached,
|
|
||||||
platform: routing.platform,
|
platform: routing.platform,
|
||||||
region: routing.region,
|
region: routing.region,
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -0,0 +1,49 @@
|
|||||||
|
import mongoose from 'mongoose';
|
||||||
|
import { DakaoUserError, DakaoUserService } from '../dakao-user.service';
|
||||||
|
import { AccountRegisterHandler } from './account-register.handler';
|
||||||
|
|
||||||
|
const objectId = (hex: string) => new mongoose.Types.ObjectId(hex);
|
||||||
|
|
||||||
|
function makeHandler(dakaoUserService?: Partial<DakaoUserService>) {
|
||||||
|
return new AccountRegisterHandler({
|
||||||
|
registerPrimaryRiotAccount: jest.fn(),
|
||||||
|
...dakaoUserService,
|
||||||
|
} as unknown as DakaoUserService);
|
||||||
|
}
|
||||||
|
|
||||||
|
const baseParams = {
|
||||||
|
communityId: objectId('111111111111111111111111'),
|
||||||
|
senderUserId: 'kakao-user-1',
|
||||||
|
senderNickname: '프리리',
|
||||||
|
gameName: '프리리',
|
||||||
|
tagLine: 'KR1',
|
||||||
|
};
|
||||||
|
|
||||||
|
describe('AccountRegisterHandler', () => {
|
||||||
|
it('translates already-registered Riot account errors', async () => {
|
||||||
|
const handler = makeHandler({
|
||||||
|
registerPrimaryRiotAccount: jest
|
||||||
|
.fn()
|
||||||
|
.mockRejectedValue(
|
||||||
|
new DakaoUserError(
|
||||||
|
'riot_account_already_registered',
|
||||||
|
'기존소환사#KR1',
|
||||||
|
),
|
||||||
|
),
|
||||||
|
});
|
||||||
|
|
||||||
|
const segments = await handler.handle(baseParams);
|
||||||
|
|
||||||
|
expect(segments).toEqual([
|
||||||
|
expect.objectContaining({ kind: 'mention', userId: 'kakao-user-1' }),
|
||||||
|
expect.objectContaining({
|
||||||
|
kind: 'text',
|
||||||
|
text: expect.stringContaining('이미 등록된 라이엇 계정'),
|
||||||
|
}),
|
||||||
|
]);
|
||||||
|
expect(segments[1]).toMatchObject({
|
||||||
|
kind: 'text',
|
||||||
|
text: expect.stringContaining('기존소환사#KR1'),
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -70,6 +70,8 @@ export class AccountRegisterHandler {
|
|||||||
return '연결된 커뮤니티를 찾을 수 없습니다.';
|
return '연결된 커뮤니티를 찾을 수 없습니다.';
|
||||||
case 'riot_account_not_found':
|
case 'riot_account_not_found':
|
||||||
return `라이엇 계정을 찾을 수 없습니다 (${err.detail ?? ''}).`;
|
return `라이엇 계정을 찾을 수 없습니다 (${err.detail ?? ''}).`;
|
||||||
|
case 'riot_account_already_registered':
|
||||||
|
return `이미 등록된 라이엇 계정이 있습니다 (${err.detail ?? ''}). 변경이 필요하면 운영자에게 문의해주세요.`;
|
||||||
case 'riot_account_conflict':
|
case 'riot_account_conflict':
|
||||||
return `이미 다른 사용자가 등록한 라이엇 계정입니다 (${err.detail ?? ''}).`;
|
return `이미 다른 사용자가 등록한 라이엇 계정입니다 (${err.detail ?? ''}).`;
|
||||||
case 'riot_account_lookup_failed':
|
case 'riot_account_lookup_failed':
|
||||||
|
|||||||
@@ -108,6 +108,8 @@ export class MatchJoinHandler {
|
|||||||
return '연결된 커뮤니티를 찾을 수 없습니다.';
|
return '연결된 커뮤니티를 찾을 수 없습니다.';
|
||||||
case 'riot_account_not_found':
|
case 'riot_account_not_found':
|
||||||
return `라이엇 계정을 찾을 수 없습니다 (${err.detail ?? ''}).`;
|
return `라이엇 계정을 찾을 수 없습니다 (${err.detail ?? ''}).`;
|
||||||
|
case 'riot_account_already_registered':
|
||||||
|
return `이미 등록된 라이엇 계정이 있습니다 (${err.detail ?? ''}).`;
|
||||||
case 'riot_account_conflict':
|
case 'riot_account_conflict':
|
||||||
return `이미 다른 사용자가 등록한 라이엇 계정입니다 (${err.detail ?? ''}).`;
|
return `이미 다른 사용자가 등록한 라이엇 계정입니다 (${err.detail ?? ''}).`;
|
||||||
case 'riot_account_lookup_failed':
|
case 'riot_account_lookup_failed':
|
||||||
|
|||||||
@@ -550,7 +550,9 @@ export default function UserHistoryPage() {
|
|||||||
profile?.tiers[0];
|
profile?.tiers[0];
|
||||||
const internalPages = internalHistoryQuery.data?.pages ?? [];
|
const internalPages = internalHistoryQuery.data?.pages ?? [];
|
||||||
const internalFirstPage = internalPages[0];
|
const internalFirstPage = internalPages[0];
|
||||||
const summary = isInternalQueue ? internalFirstPage?.summary : summaryQuery.data;
|
const summary = isInternalQueue
|
||||||
|
? internalFirstPage?.summary
|
||||||
|
: summaryQuery.data;
|
||||||
const matches = isInternalQueue
|
const matches = isInternalQueue
|
||||||
? internalPages.flatMap((page) => page.matches)
|
? internalPages.flatMap((page) => page.matches)
|
||||||
: (recentMatchesQuery.data?.pages.flatMap((page) => page.matches) ?? []);
|
: (recentMatchesQuery.data?.pages.flatMap((page) => page.matches) ?? []);
|
||||||
@@ -643,7 +645,11 @@ export default function UserHistoryPage() {
|
|||||||
queryKey: ["user-recent-matches", DEFAULT_COMMUNITY_ID, userId ?? null],
|
queryKey: ["user-recent-matches", DEFAULT_COMMUNITY_ID, userId ?? null],
|
||||||
}),
|
}),
|
||||||
queryClient.invalidateQueries({
|
queryClient.invalidateQueries({
|
||||||
queryKey: ["user-internal-history", DEFAULT_COMMUNITY_ID, userId ?? null],
|
queryKey: [
|
||||||
|
"user-internal-history",
|
||||||
|
DEFAULT_COMMUNITY_ID,
|
||||||
|
userId ?? null,
|
||||||
|
],
|
||||||
}),
|
}),
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
@@ -652,11 +658,13 @@ export default function UserHistoryPage() {
|
|||||||
if (!userId) return;
|
if (!userId) return;
|
||||||
if (isInternalQueue) {
|
if (isInternalQueue) {
|
||||||
setRefreshResult(null);
|
setRefreshResult(null);
|
||||||
setRefreshNotice(
|
setRefreshNotice("과거의 토너먼트 결과 수집 데이터를 다시 조회합니다.");
|
||||||
"내전 기록은 토너먼트 결과 수집 데이터를 다시 조회합니다. Riot API 갱신 큐는 사용하지 않습니다.",
|
|
||||||
);
|
|
||||||
void queryClient.invalidateQueries({
|
void queryClient.invalidateQueries({
|
||||||
queryKey: ["user-internal-history", DEFAULT_COMMUNITY_ID, userId ?? null],
|
queryKey: [
|
||||||
|
"user-internal-history",
|
||||||
|
DEFAULT_COMMUNITY_ID,
|
||||||
|
userId ?? null,
|
||||||
|
],
|
||||||
});
|
});
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
@@ -757,7 +765,8 @@ export default function UserHistoryPage() {
|
|||||||
{isInternalQueue ? (
|
{isInternalQueue ? (
|
||||||
<>
|
<>
|
||||||
{/* 내전 탭은 토너먼트 결과 DB를 조회합니다. */}
|
{/* 내전 탭은 토너먼트 결과 DB를 조회합니다. */}
|
||||||
Riot API 갱신 없이 수집된 내전 결과를 다시 불러옵니다.
|
{/* Riot API 갱신 없이 수집된 내전 결과를 다시 불러옵니다. */}
|
||||||
|
내전 기록이 확인되지 않을 경우 버튼을 눌러 갱신 (테스트)
|
||||||
</>
|
</>
|
||||||
) : (
|
) : (
|
||||||
<>
|
<>
|
||||||
|
|||||||
@@ -0,0 +1,406 @@
|
|||||||
|
/**
|
||||||
|
* Add or update one lolympus user manually from Kakao + Riot identity.
|
||||||
|
*
|
||||||
|
* This is for the last few users that need manual handling.
|
||||||
|
*
|
||||||
|
* Install:
|
||||||
|
* npm install mongodb
|
||||||
|
*
|
||||||
|
* Dry-run with Riot API enrichment:
|
||||||
|
* MONGODB_URI="mongodb://..." \
|
||||||
|
* RIOT_API_KEY="RGAPI-..." \
|
||||||
|
* KAKAO_TALK_ID="7448687768283723562" \
|
||||||
|
* KAKAO_TALK_NICKNAME="탑은죄악이다/95/남/G" \
|
||||||
|
* RIOT_ID="탑은죄악이다#망나니" \
|
||||||
|
* PREFERRED_POSITIONS="TOP,JGL" \
|
||||||
|
* node add-manual-dakao-riot-user.js
|
||||||
|
*
|
||||||
|
* Write:
|
||||||
|
* DRY_RUN=false MONGODB_URI="..." RIOT_API_KEY="..." ... node add-manual-dakao-riot-user.js
|
||||||
|
*
|
||||||
|
* Fallback without Riot API:
|
||||||
|
* PUUID="..." RIOT_ID="..." node add-manual-dakao-riot-user.js
|
||||||
|
*/
|
||||||
|
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
const { MongoClient, ObjectId } = require("mongodb");
|
||||||
|
|
||||||
|
const CONFIG = {
|
||||||
|
MONGODB_URI: process.env.MONGODB_URI ?? "mongodb://127.0.0.1:27017",
|
||||||
|
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-test",
|
||||||
|
COMMUNITY_ID: new ObjectId(
|
||||||
|
process.env.COMMUNITY_ID ?? "69ebe0adf627c11be2f020a1",
|
||||||
|
),
|
||||||
|
RIOT_API_KEY: process.env.RIOT_API_KEY ?? "",
|
||||||
|
RIOT_REGION: process.env.RIOT_REGION ?? "asia",
|
||||||
|
RIOT_PLATFORM: process.env.RIOT_PLATFORM ?? "kr",
|
||||||
|
MASTERY_COUNT: Number(process.env.MASTERY_COUNT ?? 10),
|
||||||
|
RECENT_MATCH_COUNT: Number(process.env.RECENT_MATCH_COUNT ?? 20),
|
||||||
|
FETCH_RECENT_MATCH_IDS: process.env.FETCH_RECENT_MATCH_IDS !== "false",
|
||||||
|
DRY_RUN: process.env.DRY_RUN !== "false",
|
||||||
|
FAIL_ON_CONFLICT: process.env.FAIL_ON_CONFLICT !== "false",
|
||||||
|
};
|
||||||
|
|
||||||
|
const INPUT = {
|
||||||
|
kakaoTalkId: process.env.KAKAO_TALK_ID ?? "",
|
||||||
|
kakaoTalkNickname: process.env.KAKAO_TALK_NICKNAME ?? "",
|
||||||
|
riotId: process.env.RIOT_ID ?? "",
|
||||||
|
puuid: process.env.PUUID ?? "",
|
||||||
|
preferredPositions: process.env.PREFERRED_POSITIONS ?? "",
|
||||||
|
role: process.env.ROLE ?? "member",
|
||||||
|
isActivated: process.env.IS_ACTIVATED !== "false",
|
||||||
|
};
|
||||||
|
|
||||||
|
function normalizeString(value) {
|
||||||
|
return typeof value === "string" ? value.trim() : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
function splitRiotId(riotId) {
|
||||||
|
const value = normalizeString(riotId);
|
||||||
|
const hashIndex = value.lastIndexOf("#");
|
||||||
|
if (hashIndex <= 0 || hashIndex === value.length - 1) {
|
||||||
|
throw new Error(`Invalid RIOT_ID. Expected "gameName#tagLine": ${riotId}`);
|
||||||
|
}
|
||||||
|
return {
|
||||||
|
gameName: value.slice(0, hashIndex).trim(),
|
||||||
|
tagLine: value.slice(hashIndex + 1).trim(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizePositions(value) {
|
||||||
|
const allowed = new Set(["TOP", "JGL", "MID", "ADC", "SUP"]);
|
||||||
|
return normalizeString(value)
|
||||||
|
.split(",")
|
||||||
|
.map((position) => normalizeString(position).toUpperCase())
|
||||||
|
.filter((position) => allowed.has(position))
|
||||||
|
.map((position, index) => ({ position, priority: index + 1 }));
|
||||||
|
}
|
||||||
|
|
||||||
|
function removeUndefined(value) {
|
||||||
|
if (Array.isArray(value)) return value.map(removeUndefined);
|
||||||
|
if (
|
||||||
|
value &&
|
||||||
|
typeof value === "object" &&
|
||||||
|
!(value instanceof Date) &&
|
||||||
|
!(value instanceof ObjectId)
|
||||||
|
) {
|
||||||
|
return Object.fromEntries(
|
||||||
|
Object.entries(value)
|
||||||
|
.filter(([, entryValue]) => entryValue !== undefined)
|
||||||
|
.map(([key, entryValue]) => [key, removeUndefined(entryValue)]),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
function sleep(ms) {
|
||||||
|
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||||
|
}
|
||||||
|
|
||||||
|
function maskConfig() {
|
||||||
|
return {
|
||||||
|
...CONFIG,
|
||||||
|
MONGODB_URI: CONFIG.MONGODB_URI.replace(/\/\/.*@/u, "//***@"),
|
||||||
|
RIOT_API_KEY: CONFIG.RIOT_API_KEY ? "***" : "",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function requireInput() {
|
||||||
|
const missing = [];
|
||||||
|
if (!normalizeString(INPUT.kakaoTalkId)) missing.push("KAKAO_TALK_ID");
|
||||||
|
if (!normalizeString(INPUT.kakaoTalkNickname)) {
|
||||||
|
missing.push("KAKAO_TALK_NICKNAME");
|
||||||
|
}
|
||||||
|
if (!normalizeString(INPUT.riotId)) missing.push("RIOT_ID");
|
||||||
|
if (!CONFIG.RIOT_API_KEY && !normalizeString(INPUT.puuid)) {
|
||||||
|
missing.push("RIOT_API_KEY or PUUID");
|
||||||
|
}
|
||||||
|
if (missing.length > 0) {
|
||||||
|
throw new Error(`Missing required env: ${missing.join(", ")}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchRiotJson({ host, path, query }) {
|
||||||
|
if (!CONFIG.RIOT_API_KEY) return null;
|
||||||
|
|
||||||
|
const url = new URL(`https://${host}${path}`);
|
||||||
|
for (const [key, value] of Object.entries(query ?? {})) {
|
||||||
|
if (value !== undefined && value !== null) {
|
||||||
|
url.searchParams.set(key, String(value));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (;;) {
|
||||||
|
const response = await fetch(url, {
|
||||||
|
headers: { "X-Riot-Token": CONFIG.RIOT_API_KEY },
|
||||||
|
});
|
||||||
|
|
||||||
|
if (response.status === 429) {
|
||||||
|
const retryAfterSeconds = Number(response.headers.get("retry-after") ?? 1);
|
||||||
|
await sleep(Math.max(1, retryAfterSeconds) * 1000);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (response.status === 404) return null;
|
||||||
|
if (!response.ok) {
|
||||||
|
const body = await response.text().catch(() => "");
|
||||||
|
throw new Error(`Riot API failed ${response.status} ${url.pathname}: ${body}`);
|
||||||
|
}
|
||||||
|
return response.json();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchAccountByRiotId({ gameName, tagLine }) {
|
||||||
|
return fetchRiotJson({
|
||||||
|
host: `${CONFIG.RIOT_REGION}.api.riotgames.com`,
|
||||||
|
path: `/riot/account/v1/accounts/by-riot-id/${encodeURIComponent(gameName)}/${encodeURIComponent(tagLine)}`,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchSummonerByPuuid(puuid) {
|
||||||
|
return fetchRiotJson({
|
||||||
|
host: `${CONFIG.RIOT_PLATFORM}.api.riotgames.com`,
|
||||||
|
path: `/lol/summoner/v4/summoners/by-puuid/${encodeURIComponent(puuid)}`,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchLeagueEntriesByPuuid(puuid) {
|
||||||
|
return fetchRiotJson({
|
||||||
|
host: `${CONFIG.RIOT_PLATFORM}.api.riotgames.com`,
|
||||||
|
path: `/lol/league/v4/entries/by-puuid/${encodeURIComponent(puuid)}`,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchChampionMasteriesByPuuid(puuid) {
|
||||||
|
return fetchRiotJson({
|
||||||
|
host: `${CONFIG.RIOT_PLATFORM}.api.riotgames.com`,
|
||||||
|
path: `/lol/champion-mastery/v4/champion-masteries/by-puuid/${encodeURIComponent(puuid)}/top`,
|
||||||
|
query: { count: CONFIG.MASTERY_COUNT },
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchRecentMatchIdsByPuuid(puuid) {
|
||||||
|
if (!CONFIG.FETCH_RECENT_MATCH_IDS) return [];
|
||||||
|
return fetchRiotJson({
|
||||||
|
host: `${CONFIG.RIOT_REGION}.api.riotgames.com`,
|
||||||
|
path: `/lol/match/v5/matches/by-puuid/${encodeURIComponent(puuid)}/ids`,
|
||||||
|
query: { start: 0, count: CONFIG.RECENT_MATCH_COUNT },
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function fetchRiotData({ riotId }) {
|
||||||
|
const fallback = splitRiotId(riotId);
|
||||||
|
const account =
|
||||||
|
(await fetchAccountByRiotId(fallback)) ?? {
|
||||||
|
...fallback,
|
||||||
|
puuid: normalizeString(INPUT.puuid),
|
||||||
|
};
|
||||||
|
if (!account?.puuid) {
|
||||||
|
throw new Error(`Riot account not found and PUUID was not provided: ${riotId}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const [summoner, leagueEntries, championMasteries, matchIds] =
|
||||||
|
await Promise.all([
|
||||||
|
fetchSummonerByPuuid(account.puuid).catch(() => null),
|
||||||
|
fetchLeagueEntriesByPuuid(account.puuid).catch(() => []),
|
||||||
|
fetchChampionMasteriesByPuuid(account.puuid).catch(() => []),
|
||||||
|
fetchRecentMatchIdsByPuuid(account.puuid).catch(() => []),
|
||||||
|
]);
|
||||||
|
|
||||||
|
return {
|
||||||
|
account: {
|
||||||
|
puuid: account.puuid,
|
||||||
|
gameName: normalizeString(account.gameName) || fallback.gameName,
|
||||||
|
tagLine: normalizeString(account.tagLine) || fallback.tagLine,
|
||||||
|
},
|
||||||
|
summoner,
|
||||||
|
leagueEntries: Array.isArray(leagueEntries) ? leagueEntries : [],
|
||||||
|
championMasteries: Array.isArray(championMasteries)
|
||||||
|
? championMasteries
|
||||||
|
: [],
|
||||||
|
matchIds: Array.isArray(matchIds) ? matchIds : [],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function toTierInfo(entry, fetchedAt) {
|
||||||
|
return {
|
||||||
|
leagueId: entry.leagueId,
|
||||||
|
queueType: entry.queueType,
|
||||||
|
tier: entry.tier,
|
||||||
|
rank: entry.rank,
|
||||||
|
puuid: entry.puuid,
|
||||||
|
leaguePoints: entry.leaguePoints ?? 0,
|
||||||
|
wins: entry.wins ?? 0,
|
||||||
|
losses: entry.losses ?? 0,
|
||||||
|
veteran: entry.veteran,
|
||||||
|
inactive: entry.inactive,
|
||||||
|
freshBlood: entry.freshBlood,
|
||||||
|
hotStreak: entry.hotStreak,
|
||||||
|
miniSeries: entry.miniSeries,
|
||||||
|
fetchedAt,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function toTierHistory(entry, recordedAt) {
|
||||||
|
return {
|
||||||
|
queueType: entry.queueType,
|
||||||
|
tier: entry.tier,
|
||||||
|
rank: entry.rank,
|
||||||
|
leaguePoints: entry.leaguePoints ?? 0,
|
||||||
|
wins: entry.wins ?? 0,
|
||||||
|
losses: entry.losses ?? 0,
|
||||||
|
recordedAt,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function toChampionMastery(entry) {
|
||||||
|
return {
|
||||||
|
puuid: entry.puuid,
|
||||||
|
championId: entry.championId,
|
||||||
|
championLevel: entry.championLevel,
|
||||||
|
championPoints: entry.championPoints,
|
||||||
|
lastPlayTime: entry.lastPlayTime,
|
||||||
|
championPointsSinceLastLevel: entry.championPointsSinceLastLevel,
|
||||||
|
championPointsUntilNextLevel: entry.championPointsUntilNextLevel,
|
||||||
|
markRequiredForNextLevel: entry.markRequiredForNextLevel,
|
||||||
|
tokensEarned: entry.tokensEarned,
|
||||||
|
championSeasonMilestone: entry.championSeasonMilestone,
|
||||||
|
milestoneGrades: entry.milestoneGrades,
|
||||||
|
nextSeasonMilestone: entry.nextSeasonMilestone,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildRiotAccount(riotData, now) {
|
||||||
|
return removeUndefined({
|
||||||
|
puuid: riotData.account.puuid,
|
||||||
|
gameName: riotData.account.gameName,
|
||||||
|
tagLine: riotData.account.tagLine,
|
||||||
|
profileIconId: riotData.summoner?.profileIconId ?? 0,
|
||||||
|
revisionDate: riotData.summoner?.revisionDate ?? 0,
|
||||||
|
summonerLevel: riotData.summoner?.summonerLevel ?? 0,
|
||||||
|
isPrimary: true,
|
||||||
|
tiers: riotData.leagueEntries.map((entry) => toTierInfo(entry, now)),
|
||||||
|
tierHistory: riotData.leagueEntries.map((entry) => toTierHistory(entry, now)),
|
||||||
|
matchIds: riotData.matchIds,
|
||||||
|
matchIdsFetchedAt: riotData.matchIds.length > 0 ? now : undefined,
|
||||||
|
championMasteries: riotData.championMasteries
|
||||||
|
.slice(0, CONFIG.MASTERY_COUNT)
|
||||||
|
.map(toChampionMastery),
|
||||||
|
championMasteriesFetchedAt:
|
||||||
|
riotData.championMasteries.length > 0 ? now : undefined,
|
||||||
|
championRecords: {},
|
||||||
|
createdAt: now,
|
||||||
|
updatedAt: now,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function mergeRiotAccount(existingAccounts, nextAccount) {
|
||||||
|
const merged = (existingAccounts ?? [])
|
||||||
|
.filter(
|
||||||
|
(account) =>
|
||||||
|
account.puuid !== nextAccount.puuid &&
|
||||||
|
!(
|
||||||
|
normalizeString(account.gameName).toLowerCase() ===
|
||||||
|
normalizeString(nextAccount.gameName).toLowerCase() &&
|
||||||
|
normalizeString(account.tagLine).toLowerCase() ===
|
||||||
|
normalizeString(nextAccount.tagLine).toLowerCase()
|
||||||
|
),
|
||||||
|
)
|
||||||
|
.map((account) => ({ ...account, isPrimary: false }));
|
||||||
|
return [nextAccount, ...merged];
|
||||||
|
}
|
||||||
|
|
||||||
|
async function buildPlan(User) {
|
||||||
|
const now = new Date();
|
||||||
|
const riotData = await fetchRiotData({ riotId: INPUT.riotId });
|
||||||
|
const account = buildRiotAccount(riotData, now);
|
||||||
|
|
||||||
|
const conflict = await User.findOne({
|
||||||
|
communityId: CONFIG.COMMUNITY_ID,
|
||||||
|
kakaoTalkId: { $ne: INPUT.kakaoTalkId },
|
||||||
|
"riotAccounts.puuid": account.puuid,
|
||||||
|
});
|
||||||
|
if (conflict && CONFIG.FAIL_ON_CONFLICT) {
|
||||||
|
throw new Error(
|
||||||
|
`Riot puuid conflict. existingUserId=${conflict._id.toString()} existingKakaoTalkId=${conflict.kakaoTalkId}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const filter = {
|
||||||
|
communityId: CONFIG.COMMUNITY_ID,
|
||||||
|
kakaoTalkId: INPUT.kakaoTalkId,
|
||||||
|
};
|
||||||
|
const existing = await User.findOne(filter);
|
||||||
|
const doc = removeUndefined({
|
||||||
|
_id: existing?._id ?? new ObjectId(),
|
||||||
|
communityId: CONFIG.COMMUNITY_ID,
|
||||||
|
role: INPUT.role,
|
||||||
|
kakaoTalkId: INPUT.kakaoTalkId,
|
||||||
|
kakaoTalkNickname: INPUT.kakaoTalkNickname,
|
||||||
|
riotAccounts: mergeRiotAccount(existing?.riotAccounts, account),
|
||||||
|
preferredPositions: normalizePositions(INPUT.preferredPositions),
|
||||||
|
isActivated: INPUT.isActivated,
|
||||||
|
createdAt: existing?.createdAt ?? now,
|
||||||
|
updatedAt: now,
|
||||||
|
});
|
||||||
|
|
||||||
|
return {
|
||||||
|
mode: existing ? "update" : "insert",
|
||||||
|
filter,
|
||||||
|
doc,
|
||||||
|
conflict: conflict
|
||||||
|
? {
|
||||||
|
existingUserId: conflict._id,
|
||||||
|
existingKakaoTalkId: conflict.kakaoTalkId,
|
||||||
|
}
|
||||||
|
: null,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
async function applyPlan(User, plan) {
|
||||||
|
if (CONFIG.DRY_RUN) return { dryRun: true, plan };
|
||||||
|
|
||||||
|
if (plan.mode === "update") {
|
||||||
|
const { _id, createdAt, ...setDoc } = plan.doc;
|
||||||
|
await User.updateOne({ _id: plan.doc._id }, { $set: setDoc });
|
||||||
|
return { updated: 1, inserted: 0, userId: plan.doc._id };
|
||||||
|
}
|
||||||
|
|
||||||
|
await User.insertOne(plan.doc);
|
||||||
|
return { updated: 0, inserted: 1, userId: plan.doc._id };
|
||||||
|
}
|
||||||
|
|
||||||
|
async function run() {
|
||||||
|
requireInput();
|
||||||
|
const client = new MongoClient(CONFIG.MONGODB_URI);
|
||||||
|
await client.connect();
|
||||||
|
|
||||||
|
try {
|
||||||
|
const db = client.db(CONFIG.LOLYMPUS_DB_NAME);
|
||||||
|
const User = db.collection("user");
|
||||||
|
const plan = await buildPlan(User);
|
||||||
|
const result = await applyPlan(User, plan);
|
||||||
|
|
||||||
|
return {
|
||||||
|
config: maskConfig(),
|
||||||
|
input: {
|
||||||
|
...INPUT,
|
||||||
|
puuid: INPUT.puuid ? "***provided***" : "",
|
||||||
|
},
|
||||||
|
result,
|
||||||
|
};
|
||||||
|
} finally {
|
||||||
|
await client.close();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (require.main === module) {
|
||||||
|
run()
|
||||||
|
.then((result) => {
|
||||||
|
console.log(JSON.stringify(result, null, 2));
|
||||||
|
})
|
||||||
|
.catch((error) => {
|
||||||
|
console.error(error);
|
||||||
|
process.exitCode = 1;
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -0,0 +1,424 @@
|
|||||||
|
/**
|
||||||
|
* Apply already-saved Dakao user bootstrap data into lolympus-test.user.
|
||||||
|
*
|
||||||
|
* This script does NOT call Riot API.
|
||||||
|
*
|
||||||
|
* It reads saved documents from one of:
|
||||||
|
* 1. lolympus-test.DakaoUserBootstrapRun
|
||||||
|
* 2. lolympus-test.DakaoUserBootstrapCandidate
|
||||||
|
*
|
||||||
|
* It only applies users that already have a valid Riot identity:
|
||||||
|
* - dryRunUsers[].doc.riotAccounts[0].puuid, or
|
||||||
|
* - candidate.riotApiResult.puuid, or
|
||||||
|
* - candidate.matchedRiotAccount.puuid
|
||||||
|
*
|
||||||
|
* Install:
|
||||||
|
* npm install mongodb
|
||||||
|
*
|
||||||
|
* Dry-run latest saved run:
|
||||||
|
* MONGODB_URI="mongodb://..." node apply-saved-dakao-riot-users.js
|
||||||
|
*
|
||||||
|
* Dry-run specific saved run:
|
||||||
|
* MONGODB_URI="mongodb://..." SOURCE=run RUN_ID="..." node apply-saved-dakao-riot-users.js
|
||||||
|
*
|
||||||
|
* Dry-run from candidate collection:
|
||||||
|
* MONGODB_URI="mongodb://..." SOURCE=candidate node apply-saved-dakao-riot-users.js
|
||||||
|
*
|
||||||
|
* Write:
|
||||||
|
* DRY_RUN=false MONGODB_URI="mongodb://..." node apply-saved-dakao-riot-users.js
|
||||||
|
*/
|
||||||
|
|
||||||
|
"use strict";
|
||||||
|
|
||||||
|
const { MongoClient, ObjectId } = require("mongodb");
|
||||||
|
|
||||||
|
const CONFIG = {
|
||||||
|
MONGODB_URI: process.env.MONGODB_URI ?? "mongodb://127.0.0.1:27017",
|
||||||
|
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-test",
|
||||||
|
COMMUNITY_ID: new ObjectId(
|
||||||
|
process.env.COMMUNITY_ID ?? "69ebe0adf627c11be2f020a1",
|
||||||
|
),
|
||||||
|
RUNS_COLLECTION_NAME:
|
||||||
|
process.env.RUNS_COLLECTION_NAME ?? "DakaoUserBootstrapRun",
|
||||||
|
CANDIDATES_COLLECTION_NAME:
|
||||||
|
process.env.CANDIDATES_COLLECTION_NAME ?? "DakaoUserBootstrapCandidate",
|
||||||
|
SOURCE: process.env.SOURCE ?? "run", // run | candidate
|
||||||
|
RUN_ID: process.env.RUN_ID ?? "",
|
||||||
|
DRY_RUN: process.env.DRY_RUN !== "false",
|
||||||
|
FORCE_REAPPLY_RUN: process.env.FORCE_REAPPLY_RUN === "true",
|
||||||
|
};
|
||||||
|
|
||||||
|
function normalizeString(value) {
|
||||||
|
return typeof value === "string" ? value.trim() : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
function toObjectId(value, fieldName) {
|
||||||
|
if (value instanceof ObjectId) return value;
|
||||||
|
if (typeof value === "string" && ObjectId.isValid(value)) {
|
||||||
|
return new ObjectId(value);
|
||||||
|
}
|
||||||
|
throw new Error(`Invalid ObjectId for ${fieldName}: ${value}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
function removeUndefined(value) {
|
||||||
|
if (Array.isArray(value)) {
|
||||||
|
return value.map(removeUndefined);
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
value &&
|
||||||
|
typeof value === "object" &&
|
||||||
|
!(value instanceof Date) &&
|
||||||
|
!(value instanceof ObjectId)
|
||||||
|
) {
|
||||||
|
return Object.fromEntries(
|
||||||
|
Object.entries(value)
|
||||||
|
.filter(([, entryValue]) => entryValue !== undefined)
|
||||||
|
.map(([key, entryValue]) => [key, removeUndefined(entryValue)]),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
function maskConfig() {
|
||||||
|
return {
|
||||||
|
...CONFIG,
|
||||||
|
MONGODB_URI: CONFIG.MONGODB_URI.replace(/\/\/.*@/u, "//***@"),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function hasValidRiotAccount(account) {
|
||||||
|
return Boolean(
|
||||||
|
normalizeString(account?.puuid) &&
|
||||||
|
normalizeString(account?.gameName) &&
|
||||||
|
normalizeString(account?.tagLine),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
function ensureRiotAccountShape(account, now) {
|
||||||
|
return removeUndefined({
|
||||||
|
puuid: normalizeString(account.puuid),
|
||||||
|
gameName: normalizeString(account.gameName),
|
||||||
|
tagLine: normalizeString(account.tagLine),
|
||||||
|
profileIconId: account.profileIconId ?? 0,
|
||||||
|
revisionDate: account.revisionDate ?? 0,
|
||||||
|
summonerLevel: account.summonerLevel ?? 0,
|
||||||
|
isPrimary: true,
|
||||||
|
tiers: Array.isArray(account.tiers) ? account.tiers : [],
|
||||||
|
tierHistory: Array.isArray(account.tierHistory) ? account.tierHistory : [],
|
||||||
|
matchIds: Array.isArray(account.matchIds) ? account.matchIds : [],
|
||||||
|
matchIdsFetchedAt: account.matchIdsFetchedAt,
|
||||||
|
lastRefreshRequestedAt: account.lastRefreshRequestedAt,
|
||||||
|
recentStatsSummary: account.recentStatsSummary,
|
||||||
|
recentStatsFetchedAt: account.recentStatsFetchedAt,
|
||||||
|
championMasteries: Array.isArray(account.championMasteries)
|
||||||
|
? account.championMasteries
|
||||||
|
: [],
|
||||||
|
championMasteriesFetchedAt: account.championMasteriesFetchedAt,
|
||||||
|
championRecords: account.championRecords ?? {},
|
||||||
|
championRecordsFetchedAt: account.championRecordsFetchedAt,
|
||||||
|
createdAt: account.createdAt ?? now,
|
||||||
|
updatedAt: now,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function mergeRiotAccount(existingAccounts, nextAccount) {
|
||||||
|
const merged = (existingAccounts ?? [])
|
||||||
|
.filter(
|
||||||
|
(account) =>
|
||||||
|
account.puuid !== nextAccount.puuid &&
|
||||||
|
!(
|
||||||
|
normalizeString(account.gameName).toLowerCase() ===
|
||||||
|
normalizeString(nextAccount.gameName).toLowerCase() &&
|
||||||
|
normalizeString(account.tagLine).toLowerCase() ===
|
||||||
|
normalizeString(nextAccount.tagLine).toLowerCase()
|
||||||
|
),
|
||||||
|
)
|
||||||
|
.map((account) => ({ ...account, isPrimary: false }));
|
||||||
|
|
||||||
|
return [nextAccount, ...merged];
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildPlanFromDryRunUser(planned, now) {
|
||||||
|
const doc = planned.doc ?? {};
|
||||||
|
const primary = doc.riotAccounts?.[0];
|
||||||
|
if (!hasValidRiotAccount(primary)) return null;
|
||||||
|
|
||||||
|
return {
|
||||||
|
source: "dryRunUsers",
|
||||||
|
originalMode: planned.mode,
|
||||||
|
filter: {
|
||||||
|
communityId: toObjectId(
|
||||||
|
planned.filter?.communityId ?? doc.communityId ?? CONFIG.COMMUNITY_ID,
|
||||||
|
"planned.communityId",
|
||||||
|
),
|
||||||
|
kakaoTalkId: normalizeString(planned.filter?.kakaoTalkId ?? doc.kakaoTalkId),
|
||||||
|
},
|
||||||
|
doc: removeUndefined({
|
||||||
|
_id:
|
||||||
|
doc._id && ObjectId.isValid(String(doc._id))
|
||||||
|
? toObjectId(doc._id, "planned.doc._id")
|
||||||
|
: new ObjectId(),
|
||||||
|
communityId: toObjectId(doc.communityId ?? CONFIG.COMMUNITY_ID, "doc.communityId"),
|
||||||
|
role: doc.role ?? "member",
|
||||||
|
kakaoTalkId: normalizeString(doc.kakaoTalkId),
|
||||||
|
kakaoTalkNickname: normalizeString(doc.kakaoTalkNickname),
|
||||||
|
riotAccounts: [ensureRiotAccountShape(primary, now)],
|
||||||
|
preferredPositions: Array.isArray(doc.preferredPositions)
|
||||||
|
? doc.preferredPositions
|
||||||
|
: [],
|
||||||
|
isActivated: doc.isActivated ?? true,
|
||||||
|
createdAt: doc.createdAt ?? now,
|
||||||
|
updatedAt: now,
|
||||||
|
}),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildPlanFromCandidate(candidate, now) {
|
||||||
|
const api = candidate.riotApiResult;
|
||||||
|
const matched = candidate.matchedRiotAccount;
|
||||||
|
const accountSource = hasValidRiotAccount(api) ? api : matched;
|
||||||
|
if (!hasValidRiotAccount(accountSource)) return null;
|
||||||
|
|
||||||
|
const account = ensureRiotAccountShape(
|
||||||
|
{
|
||||||
|
...matched,
|
||||||
|
...api,
|
||||||
|
profileIconId: candidate.riotEnrichment?.summoner?.profileIconId ?? 0,
|
||||||
|
revisionDate: candidate.riotEnrichment?.summoner?.revisionDate ?? 0,
|
||||||
|
summonerLevel: candidate.riotEnrichment?.summoner?.summonerLevel ?? 0,
|
||||||
|
tiers: (candidate.riotEnrichment?.leagueEntries ?? []).map((entry) => ({
|
||||||
|
leagueId: entry.leagueId,
|
||||||
|
queueType: entry.queueType,
|
||||||
|
tier: entry.tier,
|
||||||
|
rank: entry.rank,
|
||||||
|
puuid: entry.puuid,
|
||||||
|
leaguePoints: entry.leaguePoints ?? 0,
|
||||||
|
wins: entry.wins ?? 0,
|
||||||
|
losses: entry.losses ?? 0,
|
||||||
|
veteran: entry.veteran,
|
||||||
|
inactive: entry.inactive,
|
||||||
|
freshBlood: entry.freshBlood,
|
||||||
|
hotStreak: entry.hotStreak,
|
||||||
|
miniSeries: entry.miniSeries,
|
||||||
|
fetchedAt: now,
|
||||||
|
})),
|
||||||
|
tierHistory: (candidate.riotEnrichment?.leagueEntries ?? []).map(
|
||||||
|
(entry) => ({
|
||||||
|
queueType: entry.queueType,
|
||||||
|
tier: entry.tier,
|
||||||
|
rank: entry.rank,
|
||||||
|
leaguePoints: entry.leaguePoints ?? 0,
|
||||||
|
wins: entry.wins ?? 0,
|
||||||
|
losses: entry.losses ?? 0,
|
||||||
|
recordedAt: now,
|
||||||
|
}),
|
||||||
|
),
|
||||||
|
matchIds: candidate.riotEnrichment?.matchIds ?? [],
|
||||||
|
matchIdsFetchedAt:
|
||||||
|
candidate.riotEnrichment?.matchIds?.length > 0 ? now : undefined,
|
||||||
|
championMasteries: candidate.riotEnrichment?.championMasteries ?? [],
|
||||||
|
championMasteriesFetchedAt:
|
||||||
|
candidate.riotEnrichment?.championMasteries?.length > 0
|
||||||
|
? now
|
||||||
|
: undefined,
|
||||||
|
},
|
||||||
|
now,
|
||||||
|
);
|
||||||
|
|
||||||
|
return {
|
||||||
|
source: "candidate",
|
||||||
|
filter: {
|
||||||
|
communityId: toObjectId(candidate.communityId ?? CONFIG.COMMUNITY_ID, "candidate.communityId"),
|
||||||
|
kakaoTalkId: normalizeString(candidate.kakaoTalkId),
|
||||||
|
},
|
||||||
|
doc: removeUndefined({
|
||||||
|
_id: new ObjectId(),
|
||||||
|
communityId: toObjectId(candidate.communityId ?? CONFIG.COMMUNITY_ID, "candidate.communityId"),
|
||||||
|
role: candidate.role ?? "member",
|
||||||
|
kakaoTalkId: normalizeString(candidate.kakaoTalkId),
|
||||||
|
kakaoTalkNickname: normalizeString(
|
||||||
|
candidate.targetKakaoTalkNickname || candidate.kakaoTalkNickname,
|
||||||
|
),
|
||||||
|
riotAccounts: [account],
|
||||||
|
preferredPositions: Array.isArray(candidate.preferredPositions)
|
||||||
|
? candidate.preferredPositions
|
||||||
|
: [],
|
||||||
|
isActivated: candidate.isActivated ?? true,
|
||||||
|
createdAt: now,
|
||||||
|
updatedAt: now,
|
||||||
|
}),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function dedupePlans(plans) {
|
||||||
|
const byKakaoTalkId = new Map();
|
||||||
|
for (const plan of plans) {
|
||||||
|
if (!plan?.filter?.kakaoTalkId) continue;
|
||||||
|
byKakaoTalkId.set(plan.filter.kakaoTalkId, plan);
|
||||||
|
}
|
||||||
|
return [...byKakaoTalkId.values()];
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadLatestRun(Runs) {
|
||||||
|
if (CONFIG.RUN_ID) {
|
||||||
|
return Runs.findOne({ _id: toObjectId(CONFIG.RUN_ID, "RUN_ID") });
|
||||||
|
}
|
||||||
|
return Runs.findOne(
|
||||||
|
{ communityId: CONFIG.COMMUNITY_ID },
|
||||||
|
{ sort: { createdAt: -1 } },
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadPlansFromRun(lolympusDb, now) {
|
||||||
|
const Runs = lolympusDb.collection(CONFIG.RUNS_COLLECTION_NAME);
|
||||||
|
const run = await loadLatestRun(Runs);
|
||||||
|
if (!run) {
|
||||||
|
throw new Error("No saved DakaoUserBootstrapRun found.");
|
||||||
|
}
|
||||||
|
if (run.state === "applied" && !CONFIG.FORCE_REAPPLY_RUN) {
|
||||||
|
throw new Error(
|
||||||
|
`Run ${run._id.toString()} is already applied. Set FORCE_REAPPLY_RUN=true to re-apply.`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const fromDryRunUsers = (run.upsertResult?.dryRunUsers ?? [])
|
||||||
|
.map((planned) => buildPlanFromDryRunUser(planned, now))
|
||||||
|
.filter(Boolean);
|
||||||
|
const fromCandidates = (run.candidates ?? [])
|
||||||
|
.map((candidate) => buildPlanFromCandidate(candidate, now))
|
||||||
|
.filter(Boolean);
|
||||||
|
const plans = dedupePlans(
|
||||||
|
fromDryRunUsers.length > 0 ? fromDryRunUsers : fromCandidates,
|
||||||
|
);
|
||||||
|
|
||||||
|
return { sourceRun: run, plans };
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadPlansFromCandidates(lolympusDb, now) {
|
||||||
|
const Candidate = lolympusDb.collection(CONFIG.CANDIDATES_COLLECTION_NAME);
|
||||||
|
const candidates = await Candidate.find({
|
||||||
|
communityId: CONFIG.COMMUNITY_ID,
|
||||||
|
}).toArray();
|
||||||
|
const plans = dedupePlans(
|
||||||
|
candidates.map((candidate) => buildPlanFromCandidate(candidate, now)).filter(Boolean),
|
||||||
|
);
|
||||||
|
return { sourceRun: null, plans };
|
||||||
|
}
|
||||||
|
|
||||||
|
async function applyPlans(lolympusDb, plans) {
|
||||||
|
const User = lolympusDb.collection("user");
|
||||||
|
const result = {
|
||||||
|
inserted: 0,
|
||||||
|
updated: 0,
|
||||||
|
skippedConflict: [],
|
||||||
|
errors: [],
|
||||||
|
dryRunUsers: [],
|
||||||
|
};
|
||||||
|
|
||||||
|
for (const plan of plans) {
|
||||||
|
try {
|
||||||
|
const primary = plan.doc.riotAccounts?.[0];
|
||||||
|
const conflict = await User.findOne({
|
||||||
|
communityId: plan.doc.communityId,
|
||||||
|
kakaoTalkId: { $ne: plan.doc.kakaoTalkId },
|
||||||
|
"riotAccounts.puuid": primary.puuid,
|
||||||
|
});
|
||||||
|
if (conflict) {
|
||||||
|
result.skippedConflict.push({
|
||||||
|
kakaoTalkId: plan.doc.kakaoTalkId,
|
||||||
|
riotId: `${primary.gameName}#${primary.tagLine}`,
|
||||||
|
puuid: primary.puuid,
|
||||||
|
existingUserId: conflict._id,
|
||||||
|
existingKakaoTalkId: conflict.kakaoTalkId,
|
||||||
|
});
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
const existing = await User.findOne(plan.filter);
|
||||||
|
const nextDoc = removeUndefined({
|
||||||
|
...plan.doc,
|
||||||
|
_id: existing?._id ?? plan.doc._id,
|
||||||
|
createdAt: existing?.createdAt ?? plan.doc.createdAt,
|
||||||
|
riotAccounts: mergeRiotAccount(existing?.riotAccounts, primary),
|
||||||
|
});
|
||||||
|
|
||||||
|
if (CONFIG.DRY_RUN) {
|
||||||
|
result.dryRunUsers.push({
|
||||||
|
mode: existing ? "update" : "insert",
|
||||||
|
filter: plan.filter,
|
||||||
|
doc: nextDoc,
|
||||||
|
});
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (existing) {
|
||||||
|
const { _id, createdAt, ...setDoc } = nextDoc;
|
||||||
|
await User.updateOne({ _id: existing._id }, { $set: setDoc });
|
||||||
|
result.updated += 1;
|
||||||
|
} else {
|
||||||
|
await User.insertOne(nextDoc);
|
||||||
|
result.inserted += 1;
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
result.errors.push({
|
||||||
|
kakaoTalkId: plan?.doc?.kakaoTalkId,
|
||||||
|
message: error instanceof Error ? error.message : String(error),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function markRunApplied(lolympusDb, sourceRun, applyResult) {
|
||||||
|
if (!sourceRun || CONFIG.DRY_RUN) return;
|
||||||
|
const Runs = lolympusDb.collection(CONFIG.RUNS_COLLECTION_NAME);
|
||||||
|
await Runs.updateOne(
|
||||||
|
{ _id: sourceRun._id },
|
||||||
|
{
|
||||||
|
$set: {
|
||||||
|
state: applyResult.errors.length > 0 ? "apply-partial" : "applied",
|
||||||
|
appliedAt: new Date(),
|
||||||
|
updatedAt: new Date(),
|
||||||
|
applyResult,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
async function run() {
|
||||||
|
const client = new MongoClient(CONFIG.MONGODB_URI);
|
||||||
|
await client.connect();
|
||||||
|
|
||||||
|
try {
|
||||||
|
const lolympusDb = client.db(CONFIG.LOLYMPUS_DB_NAME);
|
||||||
|
const now = new Date();
|
||||||
|
const { sourceRun, plans } =
|
||||||
|
CONFIG.SOURCE === "candidate"
|
||||||
|
? await loadPlansFromCandidates(lolympusDb, now)
|
||||||
|
: await loadPlansFromRun(lolympusDb, now);
|
||||||
|
const applyResult = await applyPlans(lolympusDb, plans);
|
||||||
|
await markRunApplied(lolympusDb, sourceRun, applyResult);
|
||||||
|
|
||||||
|
return {
|
||||||
|
config: maskConfig(),
|
||||||
|
source: CONFIG.SOURCE,
|
||||||
|
sourceRunId: sourceRun?._id ?? null,
|
||||||
|
planCount: plans.length,
|
||||||
|
applyResult,
|
||||||
|
};
|
||||||
|
} finally {
|
||||||
|
await client.close();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (require.main === module) {
|
||||||
|
run()
|
||||||
|
.then((result) => {
|
||||||
|
console.log(JSON.stringify(result, null, 2));
|
||||||
|
})
|
||||||
|
.catch((error) => {
|
||||||
|
console.error(error);
|
||||||
|
process.exitCode = 1;
|
||||||
|
});
|
||||||
|
}
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,660 @@
|
|||||||
|
# LOLYMPUS Tournament Support 포트폴리오 정리
|
||||||
|
|
||||||
|
> Confluence에 옮기기 좋은 형태로 작성한 프로젝트 소개 문서입니다.
|
||||||
|
> Mermaid 블록은 Confluence의 Mermaid/Diagram 매크로나 코드 블록으로 붙여 넣을 수 있습니다.
|
||||||
|
|
||||||
|
## 1. 프로젝트 한 줄 소개
|
||||||
|
|
||||||
|
**LOLYMPUS Tournament Support**는 리그 오브 레전드 커뮤니티 내전을 모집, 팀 경매, 토너먼트 코드 운영, Riot API 기반 결과 수집, 개인/커뮤니티 전적 조회까지 하나의 흐름으로 연결한 커뮤니티 토너먼트 운영 도구입니다.
|
||||||
|
|
||||||
|
단순히 매치를 생성하는 CRUD 서비스가 아니라, 실제 커뮤니티 운영자가 반복적으로 겪는 문제를 해결하는 데 초점을 맞췄습니다.
|
||||||
|
|
||||||
|
- 카카오톡 채팅방에서 내전 신청을 받고 참가자를 관리한다.
|
||||||
|
- 팀장 경매 방식으로 팀을 구성한다.
|
||||||
|
- 외부에서 미리 생성한 토너먼트 코드를 매치에 자동 할당한다.
|
||||||
|
- Riot Match-V5 데이터를 비동기로 수집해 매치 결과와 선수 통계를 자동화한다.
|
||||||
|
- 개인 전적 페이지와 커뮤니티 내전 통계 페이지를 제공한다.
|
||||||
|
|
||||||
|
## 2. 문제 정의
|
||||||
|
|
||||||
|
커뮤니티 내전 운영은 겉으로 보기에는 단순해 보이지만 실제 운영에서는 여러 수작업이 반복됩니다.
|
||||||
|
|
||||||
|
| 문제 | 기존 방식의 어려움 | 이 프로젝트의 해결 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 참가 신청 | 채팅방 메시지에서 수동 확인, 닉네임/포지션 정리 필요 | Dakao/NATS 기반 채팅 명령 처리로 계정 등록과 참가 신청 자동화 |
|
||||||
|
| 팀 구성 | 팀장이 직접 스프레드시트로 경매 기록 | 실시간 Socket.IO 경매 페이지로 입찰, 낙찰, 팀 구성 동기화 |
|
||||||
|
| 토너먼트 코드 | 운영자가 매번 코드를 골라 전달 | 토너먼트 코드 풀을 운영자 UI에 업로드하고 매치 상태 전환 시 자동 예약 |
|
||||||
|
| 결과 기록 | 게임 종료 후 전적 사이트를 보며 수동 입력 | Riot Match-V5 `tourney` 매치 조회와 `tournamentCode` 매칭으로 결과 자동 수집 |
|
||||||
|
| 전적/통계 | 과거 내전 기록이 흩어짐 | Riot raw match 아카이브와 집계 API로 개인/커뮤니티 통계 제공 |
|
||||||
|
| Riot API 제한 | 페이지 방문마다 API를 호출하면 rate limit 위험 | Redis Stream 기반 작업 큐와 rate limiter로 백그라운드 수집 |
|
||||||
|
|
||||||
|
## 3. 담당 범위 요약
|
||||||
|
|
||||||
|
포트폴리오에 넣을 때는 아래처럼 정리하면 좋습니다.
|
||||||
|
|
||||||
|
| 영역 | 구현 내용 |
|
||||||
|
| --- | --- |
|
||||||
|
| Backend | NestJS 모듈 설계, Mongoose 스키마, REST API, Socket.IO Gateway, Riot API 연동, Redis/Garnet 큐와 캐시 |
|
||||||
|
| Frontend | React/Vite 기반 매치 상세, 실시간 경매, 개인 전적, 커뮤니티 내전 통계, Admin 토너먼트 코드 관리 화면 |
|
||||||
|
| Integration | Dakao/NATS 채팅 명령 연동, Microsoft Entra ID 인증, Riot Match-V5/Data Dragon 연동 |
|
||||||
|
| 운영 자동화 | 토너먼트 코드 풀, 결과 polling job, 캐시 무효화, Cloudflare Pages 배포 스크립트 |
|
||||||
|
| 품질 관리 | 주요 서비스 단위 테스트, parser 테스트, util 테스트, 타입 기반 API 모델링 |
|
||||||
|
|
||||||
|
## 4. 기술 스택
|
||||||
|
|
||||||
|
| 구분 | 기술 |
|
||||||
|
| --- | --- |
|
||||||
|
| Monorepo | pnpm workspace |
|
||||||
|
| Frontend | React 19, Vite, TypeScript, React Router, TanStack Query, Tailwind CSS, DaisyUI |
|
||||||
|
| Backend | NestJS 11, TypeScript, Mongoose |
|
||||||
|
| Realtime | Socket.IO, NestJS WebSocket Gateway |
|
||||||
|
| Database | MongoDB, Mongoose schema |
|
||||||
|
| Queue/Cache | Garnet/Redis-compatible storage, Redis Stream, Sorted Set, TTL cache |
|
||||||
|
| External API | Riot API, Riot Data Dragon, Dakao NATS command API |
|
||||||
|
| Auth | Microsoft Entra ID, JWT, 개발용 `X-Auth-User-Id` fallback |
|
||||||
|
| Deploy | Cloudflare Pages for web, API는 Node/Nest runtime |
|
||||||
|
|
||||||
|
## 5. 전체 아키텍처
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
flowchart LR
|
||||||
|
subgraph Chat["카카오톡 / Dakao"]
|
||||||
|
Kakao["채팅방 명령어"]
|
||||||
|
NATS["NATS subject"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Web["apps/web - React + Vite"]
|
||||||
|
Home["매치 목록"]
|
||||||
|
AuctionPage["실시간 경매"]
|
||||||
|
UserHistory["개인 전적"]
|
||||||
|
InternalStats["커뮤니티 내전 통계"]
|
||||||
|
AdminCodes["토너먼트 코드 Admin"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph API["apps/api - NestJS"]
|
||||||
|
DakaoModule["DakaoModule"]
|
||||||
|
MatchModule["MatchModule"]
|
||||||
|
AuctionModule["AuctionModule"]
|
||||||
|
TournamentCodeModule["TournamentCodeModule"]
|
||||||
|
TournamentResultModule["TournamentResultModule"]
|
||||||
|
RiotModule["RiotModule"]
|
||||||
|
JobQueue["RiotJobQueueModule"]
|
||||||
|
StatsModule["CommunityStatsModule"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Storage["Storage"]
|
||||||
|
Mongo["MongoDB"]
|
||||||
|
Garnet["Garnet / Redis Streams / Cache"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Riot["Riot Platform"]
|
||||||
|
AccountAPI["Account / Summoner / League"]
|
||||||
|
MatchAPI["Match-V5"]
|
||||||
|
DataDragon["Data Dragon"]
|
||||||
|
end
|
||||||
|
|
||||||
|
Kakao --> NATS --> DakaoModule
|
||||||
|
Web -->|REST API| API
|
||||||
|
AuctionPage <-->|Socket.IO /auction| AuctionModule
|
||||||
|
UserHistory <-->|Socket.IO /riot-refresh| JobQueue
|
||||||
|
API --> Mongo
|
||||||
|
API --> Garnet
|
||||||
|
RiotModule --> AccountAPI
|
||||||
|
RiotModule --> MatchAPI
|
||||||
|
Web --> DataDragon
|
||||||
|
```
|
||||||
|
|
||||||
|
### 아키텍처 핵심
|
||||||
|
|
||||||
|
- 프론트엔드는 화면 상태와 서버 캐시를 TanStack Query로 관리합니다.
|
||||||
|
- 경매와 Riot 갱신 완료 알림은 Socket.IO로 실시간 전달합니다.
|
||||||
|
- Riot API 호출은 페이지 요청 경로에서 직접 수행하지 않고, Redis Stream 기반 작업 큐로 분리했습니다.
|
||||||
|
- Riot Match-V5 raw response를 `RiotMatch` 컬렉션에 영구 저장해 이후 통계 기능을 확장할 수 있게 했습니다.
|
||||||
|
- 토너먼트 코드 발급 권한이 없는 제약을 코드 풀과 결과 polling 구조로 우회했습니다.
|
||||||
|
|
||||||
|
## 6. 주요 사용자 흐름
|
||||||
|
|
||||||
|
### 6.1 카카오톡 명령 기반 참가 흐름
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor Member as 커뮤니티 멤버
|
||||||
|
participant Kakao as 카카오톡 채팅방
|
||||||
|
participant NATS as NATS
|
||||||
|
participant Subscriber as DakaoSubscriber
|
||||||
|
participant Parser as CommandParser
|
||||||
|
participant Handler as MatchJoinHandler
|
||||||
|
participant UserSvc as DakaoUserService
|
||||||
|
participant Riot as Riot API
|
||||||
|
participant DB as MongoDB
|
||||||
|
participant Publisher as DakaoPublisher
|
||||||
|
|
||||||
|
Member->>Kakao: !내전 신청 <매치ID> <게임명>#<태그> <포지션>
|
||||||
|
Kakao->>NATS: inbound event publish
|
||||||
|
NATS->>Subscriber: command event 전달
|
||||||
|
Subscriber->>Parser: 메시지 파싱
|
||||||
|
Parser-->>Subscriber: match-join command
|
||||||
|
Subscriber->>Handler: 참가 신청 처리
|
||||||
|
Handler->>UserSvc: 카카오 사용자와 Riot 계정 resolve
|
||||||
|
UserSvc->>Riot: Riot ID 조회 및 계정 enrichment
|
||||||
|
UserSvc->>DB: User / RiotAccount upsert
|
||||||
|
Handler->>DB: Match.participants에 참가자 추가
|
||||||
|
Handler-->>Subscriber: 응답 segments 생성
|
||||||
|
Subscriber->>Publisher: 채팅방 응답 요청
|
||||||
|
Publisher->>NATS: chat.send-message command publish
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 채팅 이벤트는 `DakaoSubscriber`에서 수신하고, 명령어 파싱 실패와 일반 메시지를 분리합니다.
|
||||||
|
- 같은 채팅 로그가 중복 전달될 수 있으므로 idempotency cache로 중복 처리를 방지합니다.
|
||||||
|
- Riot ID는 대소문자, 공백, 태그 입력 차이를 normalize한 뒤 조회합니다.
|
||||||
|
- 응답은 단순 문자열이 아니라 `text`, `mention`, `emoticon` segment 기반으로 구성할 수 있습니다.
|
||||||
|
|
||||||
|
### 6.2 실시간 경매와 팀 구성 흐름
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor Host as 운영자
|
||||||
|
actor Captain as 팀장
|
||||||
|
participant Web as AuctionPage
|
||||||
|
participant WS as AuctionGateway
|
||||||
|
participant AuctionSvc as AuctionService
|
||||||
|
participant Enrich as RiotAccountEnrichmentService
|
||||||
|
participant CodeSvc as TournamentCodeService
|
||||||
|
participant ResultSvc as TournamentResultService
|
||||||
|
participant DB as MongoDB
|
||||||
|
|
||||||
|
Host->>Web: 경매 시작
|
||||||
|
Web->>AuctionSvc: POST start auction
|
||||||
|
AuctionSvc->>DB: Match 참가자와 팀장 검증
|
||||||
|
AuctionSvc->>Enrich: 경매 대상 선수 최근 정보 보강
|
||||||
|
Enrich->>DB: 티어, 숙련도, 최근 통계 저장
|
||||||
|
AuctionSvc->>DB: Auction 생성
|
||||||
|
Web->>WS: join match room
|
||||||
|
WS-->>Web: state broadcast
|
||||||
|
|
||||||
|
Captain->>Web: 입찰
|
||||||
|
Web->>WS: bid event
|
||||||
|
WS->>AuctionSvc: placeBid
|
||||||
|
AuctionSvc->>DB: currentBid, bidder, deadline 저장
|
||||||
|
WS-->>Web: state broadcast
|
||||||
|
|
||||||
|
Host->>Web: 낙찰 및 다음 선수 진행
|
||||||
|
Web->>WS: sold / next event
|
||||||
|
WS->>AuctionSvc: markSold / next
|
||||||
|
AuctionSvc->>DB: 팀원, 포지션, 비용 저장
|
||||||
|
|
||||||
|
AuctionSvc->>DB: 경매 완료 시 Match.teams 동기화
|
||||||
|
AuctionSvc->>CodeSvc: 토너먼트 코드 예약
|
||||||
|
CodeSvc->>DB: available code를 reserved로 atomic update
|
||||||
|
AuctionSvc->>ResultSvc: 결과 polling 예약
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 경매 상태는 서버의 `Auction` document를 source of truth로 둡니다.
|
||||||
|
- 클라이언트 타이머는 서버가 내려주는 `currentDeadline` 기준으로 계산합니다.
|
||||||
|
- Socket.IO room을 matchId 단위로 나누어 한 매치의 관전자와 팀장에게만 상태를 broadcast합니다.
|
||||||
|
- 경매 완료 후 `Match.teams`에 팀 구성 결과를 동기화하고, 이후 토너먼트 코드와 결과 수집 흐름으로 자연스럽게 이어집니다.
|
||||||
|
|
||||||
|
### 6.3 토너먼트 코드 풀과 자동 예약
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor Admin as 운영자
|
||||||
|
participant AdminPage as TournamentCodesPage
|
||||||
|
participant API as TournamentCodeController
|
||||||
|
participant CodeSvc as TournamentCodeService
|
||||||
|
participant DB as MongoDB
|
||||||
|
participant Match as Match
|
||||||
|
|
||||||
|
Admin->>AdminPage: CSV 또는 JSON 코드 업로드
|
||||||
|
AdminPage->>API: POST bulk upload
|
||||||
|
API->>CodeSvc: bulkUpload
|
||||||
|
CodeSvc->>CodeSvc: 코드 형식, 만료 시각, 중복 검증
|
||||||
|
CodeSvc->>DB: TournamentCode insertMany
|
||||||
|
CodeSvc->>DB: pending match 조회
|
||||||
|
loop 코드가 필요한 team-built/in-progress 매치
|
||||||
|
CodeSvc->>DB: findOneAndUpdate available code
|
||||||
|
DB-->>CodeSvc: reserved code
|
||||||
|
CodeSvc->>Match: tournamentCodeIds 추가
|
||||||
|
end
|
||||||
|
API-->>AdminPage: inserted / duplicate / invalid 결과
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 토너먼트 코드 생성 API 권한이 없다는 제약을 별도 코드 풀로 해결했습니다.
|
||||||
|
- `findOneAndUpdate`로 코드 하나를 atomic하게 `available -> reserved`로 전환해 같은 코드가 두 매치에 배정되는 문제를 방지했습니다.
|
||||||
|
- 코드가 부족한 경우에도 match slot은 `pending`으로 표시하고, 운영자가 나중에 코드를 업로드하면 `attachPendingMatches`가 부족분을 자동 보충합니다.
|
||||||
|
- 코드 상태는 `available`, `reserved`, `used`, `expired`, `released`로 관리해 운영 감사와 복구가 가능하게 했습니다.
|
||||||
|
|
||||||
|
### 6.4 Riot 결과 자동 수집 흐름
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
participant MatchFlow as Match/Auction Flow
|
||||||
|
participant ResultSvc as TournamentResultService
|
||||||
|
participant Queue as RiotJobQueueService
|
||||||
|
participant Stream as Garnet Scheduled ZSET / Stream
|
||||||
|
participant Worker as RiotJobWorkerService
|
||||||
|
participant Riot as Riot Match-V5
|
||||||
|
participant DB as MongoDB
|
||||||
|
participant Stats as CommunityStatsService
|
||||||
|
|
||||||
|
MatchFlow->>ResultSvc: scheduleInitialPoll(match)
|
||||||
|
ResultSvc->>DB: resultPollState = polling 저장
|
||||||
|
ResultSvc->>Queue: poll-tournament-result job enqueue
|
||||||
|
Queue->>Stream: high 또는 low stream append
|
||||||
|
|
||||||
|
Worker->>Stream: job read
|
||||||
|
Worker->>ResultSvc: processPollJob
|
||||||
|
ResultSvc->>DB: reserved tournament codes 조회
|
||||||
|
ResultSvc->>Riot: captain/member puuid로 type=tourney matchId 조회
|
||||||
|
Riot-->>ResultSvc: matchId 목록
|
||||||
|
ResultSvc->>Riot: match detail 조회
|
||||||
|
Riot-->>ResultSvc: Match-V5 detail
|
||||||
|
ResultSvc->>ResultSvc: info.tournamentCode와 예약 코드 매칭
|
||||||
|
ResultSvc->>DB: RiotMatch raw upsert
|
||||||
|
ResultSvc->>DB: TournamentCode used, Match.result.games upsert
|
||||||
|
|
||||||
|
alt 모든 gameCount 결과 수집 완료
|
||||||
|
ResultSvc->>DB: Match.status = finished
|
||||||
|
ResultSvc->>Stats: community stats cache invalidate
|
||||||
|
else 아직 일부 게임 미수집
|
||||||
|
ResultSvc->>Queue: 다음 poll job 예약
|
||||||
|
Queue->>Stream: deferUntilMs 기준 scheduled zset 저장
|
||||||
|
end
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 결과 수집은 "게임이 끝나는 시점"을 서버가 직접 알 수 없기 때문에 polling 방식으로 설계했습니다.
|
||||||
|
- 초기에는 captain puuid로 조회하고, 일정 시간이 지나도 못 찾으면 모든 참가자의 puuid로 확장해 탐색합니다.
|
||||||
|
- Match-V5 detail의 `info.tournamentCode`를 기준으로 우리 DB의 `TournamentCode.code`와 매칭합니다.
|
||||||
|
- 수집된 raw match는 `RiotMatch` 컬렉션에 저장하여 이후 통계, 재집계, 디버깅에 활용합니다.
|
||||||
|
- 결과 반영 시 커뮤니티 통계 캐시를 무효화해 다음 조회에서 최신 집계가 생성되게 했습니다.
|
||||||
|
|
||||||
|
### 6.5 개인 전적 갱신 흐름
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor User as 사용자
|
||||||
|
participant Page as UserHistoryPage
|
||||||
|
participant API as MatchHistoryController
|
||||||
|
participant Queue as RiotJobQueueService
|
||||||
|
participant Stream as Garnet Redis Stream
|
||||||
|
participant Worker as RiotJobWorkerService
|
||||||
|
participant Riot as Riot API
|
||||||
|
participant DB as MongoDB
|
||||||
|
participant Socket as RiotRefreshGateway
|
||||||
|
participant Query as TanStack Query
|
||||||
|
|
||||||
|
User->>Page: 정보 갱신 클릭
|
||||||
|
Page->>API: POST /communities/:cid/users/:uid/refresh
|
||||||
|
API->>Queue: enqueueRefresh
|
||||||
|
Queue->>Queue: queueGroup 검증, cooldown, dedup 검사
|
||||||
|
Queue->>Stream: high stream append
|
||||||
|
Queue-->>Page: parentJobId, subJobs, ETA 반환
|
||||||
|
Page->>Socket: puuid / parentJobId subscribe
|
||||||
|
|
||||||
|
Worker->>Stream: high 우선 readGroup
|
||||||
|
Worker->>Queue: markProcessing
|
||||||
|
Worker->>Riot: queueId별 match list/detail 조회
|
||||||
|
Riot-->>Worker: 최근 경기 데이터
|
||||||
|
Worker->>DB: RiotMatch raw와 User fetchedAt 저장
|
||||||
|
Worker->>Queue: markCompleted
|
||||||
|
Worker->>Socket: riot-refresh event broadcast
|
||||||
|
Socket-->>Page: completed event
|
||||||
|
Page->>Query: 관련 query invalidate
|
||||||
|
Query->>API: 저장된 DB 데이터 재조회
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 개인 전적 페이지는 최초 진입 시 Riot API를 직접 호출하지 않습니다. 저장된 DB 데이터만 보여주고, 사용자가 명시적으로 누를 때만 갱신 job을 요청합니다.
|
||||||
|
- 같은 puuid와 queueGroup에 대한 중복 요청은 `riot:job:dedup:<puuid>:<queueGroup>` 키로 합쳐집니다.
|
||||||
|
- high/low stream을 분리해 사용자가 요청한 갱신이 야간 prefetch보다 먼저 처리되게 했습니다.
|
||||||
|
- 작업 완료 이벤트는 Socket.IO로 전달하고, 프론트는 React Query invalidate로 최신 DB 데이터를 다시 가져옵니다.
|
||||||
|
- 이 구조 덕분에 Riot API rate limit과 사용자 UX를 동시에 관리할 수 있습니다.
|
||||||
|
|
||||||
|
### 6.6 커뮤니티 내전 통계 조회 흐름
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor Visitor as 방문자
|
||||||
|
participant Page as CommunityInternalStatsPage
|
||||||
|
participant API as CommunityStatsController
|
||||||
|
participant Service as CommunityStatsService
|
||||||
|
participant Cache as CommunityStatsCacheService
|
||||||
|
participant DB as MongoDB
|
||||||
|
|
||||||
|
Visitor->>Page: /communities/:cid/internal-stats 접속
|
||||||
|
Page->>API: matches / leaderboard / team-insights 요청
|
||||||
|
API->>Service: filter 전달
|
||||||
|
Service->>Cache: cache key 조회
|
||||||
|
|
||||||
|
alt cache hit
|
||||||
|
Cache-->>Service: cached response
|
||||||
|
else cache miss
|
||||||
|
Service->>DB: Match finished/in-progress 조회
|
||||||
|
Service->>DB: RiotMatch raw lookup
|
||||||
|
Service->>Service: 경기, 선수, 팀 단위 지표 계산
|
||||||
|
Service->>Cache: TTL cache 저장
|
||||||
|
end
|
||||||
|
|
||||||
|
Service-->>API: 통계 응답
|
||||||
|
API-->>Page: 카드, 리더보드, 인사이트 렌더링
|
||||||
|
```
|
||||||
|
|
||||||
|
**기술 포인트**
|
||||||
|
|
||||||
|
- 통계 조회는 외부 공유 가능하도록 public endpoint로 열려 있습니다.
|
||||||
|
- `Match.result.games[]`와 `RiotMatch.raw.info.participants[]`를 조합해 KDA, GPM, CS/min, kill participation, damage share, vision score 등을 계산합니다.
|
||||||
|
- 집계 비용을 줄이기 위해 Garnet TTL cache를 사용합니다.
|
||||||
|
- 매치 결과가 새로 수집되면 관련 캐시를 invalidate합니다.
|
||||||
|
|
||||||
|
## 7. 핵심 데이터 모델
|
||||||
|
|
||||||
|
### 7.1 주요 컬렉션
|
||||||
|
|
||||||
|
| 컬렉션 | 역할 |
|
||||||
|
| --- | --- |
|
||||||
|
| `Community` | 커뮤니티 설정, Riot region/platform, 시즌 정보, 기본 매치 gameCount |
|
||||||
|
| `User` | 커뮤니티 멤버, 카카오/디스코드/Entra identity, Riot 계정, 선호 포지션 |
|
||||||
|
| `Match` | 내전 모집, 참가자, 팀, 경기 수, 토너먼트 코드, 결과 |
|
||||||
|
| `Auction` | 경매 진행 상태, 팀장, 입찰 기록, 현재 선수, deadline |
|
||||||
|
| `RiotMatch` | Riot Match-V5 raw response 영구 저장 |
|
||||||
|
| `TournamentCode` | 외부에서 생성한 토너먼트 코드 풀과 상태 추적 |
|
||||||
|
| `LegacyImportJob` | 과거 내전 데이터 백필 작업 상태 |
|
||||||
|
|
||||||
|
### 7.2 데이터 모델 설계 특징
|
||||||
|
|
||||||
|
- `User.riotAccounts[]`는 embedded document로 관리합니다. 커뮤니티 멤버의 대표 Riot 계정, 티어, 숙련도, 최근 통계가 사용자와 함께 조회됩니다.
|
||||||
|
- `Match.participants[]`에는 참가 당시의 표시용 스냅샷을 저장합니다. 이후 계정명이 바뀌어도 당시 매치 맥락을 유지할 수 있습니다.
|
||||||
|
- `Match.result.games[]`는 우리 서비스 기준의 userId, team side, championId, KDA를 담고, 상세 Riot 지표는 `RiotMatch.raw`에서 보강합니다.
|
||||||
|
- `TournamentCode`는 상태 기반 lifecycle을 갖습니다. 운영자가 회수하거나 복구할 수 있도록 단순 삭제 대신 상태 전이를 사용합니다.
|
||||||
|
- `RiotMatch.raw`를 저장해 통계 요구사항이 늘어나도 Riot API를 다시 호출하지 않고 재집계할 수 있습니다.
|
||||||
|
|
||||||
|
## 8. 주요 기능 상세
|
||||||
|
|
||||||
|
### 8.1 매치 모집과 참가
|
||||||
|
|
||||||
|
- 커뮤니티별 매치 생성, 참가자 모집, 포지션 선호도 저장을 지원합니다.
|
||||||
|
- 카카오톡 명령어를 통해 사용자가 채팅방에서 계정 등록과 내전 신청을 할 수 있습니다.
|
||||||
|
- Riot 계정 등록 시 Riot API를 통해 puuid를 확인하고, 기존 계정과 충돌하는지 검사합니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> 채팅방에서 운영되는 커뮤니티의 실제 사용 패턴을 반영해, 웹 페이지 방문 없이도 카카오톡 명령어로 Riot 계정 등록과 내전 참가 신청이 가능하도록 NATS 기반 command subscriber를 구현했습니다.
|
||||||
|
|
||||||
|
### 8.2 실시간 경매
|
||||||
|
|
||||||
|
- 팀장 2명이 제한된 포인트로 참가자를 입찰하는 경매 화면입니다.
|
||||||
|
- 모든 입찰, 낙찰, 다음 선수 전환이 Socket.IO room으로 동기화됩니다.
|
||||||
|
- 선수 카드에는 Riot 계정 정보, 티어, 숙련도, 최근 라인별 통계가 함께 표시됩니다.
|
||||||
|
- 경매 완료 시 `Match.teams`가 자동 생성되고, 팀 구성 이후 토너먼트 코드 예약과 결과 polling이 시작됩니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> 경매 상태를 클라이언트 시뮬레이션이 아니라 서버 document 중심으로 관리하고, Socket.IO를 통해 관전자와 팀장 화면을 동기화했습니다. 이를 통해 여러 사용자가 동시에 접속해도 동일한 경매 상태를 볼 수 있게 했습니다.
|
||||||
|
|
||||||
|
### 8.3 토너먼트 코드 풀
|
||||||
|
|
||||||
|
- 외부 서비스에서 생성한 토너먼트 코드를 운영자가 CSV/JSON으로 업로드합니다.
|
||||||
|
- 업로드 시 형식, 중복, 만료 시각을 검증합니다.
|
||||||
|
- 매치가 `team-built` 또는 `in-progress` 상태인데 필요한 코드가 부족하면 자동으로 보충합니다.
|
||||||
|
- 만료된 코드는 `expired`, 회수된 코드는 `released`로 추적합니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> Riot Tournament API 권한이 없는 제약을 코드 풀 방식으로 우회했습니다. 운영자는 미리 생성된 코드를 업로드하고, 서비스는 매치 상태 전환 시 atomic pop 방식으로 코드를 예약해 중복 배정 문제를 방지합니다.
|
||||||
|
|
||||||
|
### 8.4 Riot 결과 수집
|
||||||
|
|
||||||
|
- 토너먼트 코드가 연결된 매치의 결과를 Match-V5로 polling합니다.
|
||||||
|
- `type=tourney` matchId 검색과 `info.tournamentCode` 매칭으로 우리 매치의 경기 결과를 식별합니다.
|
||||||
|
- 결과가 수집되면 `Match.result.games[]`, `TournamentCode.riotMatchId`, `RiotMatch.raw`가 함께 갱신됩니다.
|
||||||
|
- 모든 게임이 수집되면 match status를 `finished`로 변경합니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> 게임 종료 이벤트를 직접 받을 수 없는 환경에서, Match-V5의 tournamentCode 필드를 활용한 polling workflow를 설계했습니다. polling 간격, 만료 시간, 탐색 대상 확장을 두어 API 호출량과 수집 성공률의 균형을 맞췄습니다.
|
||||||
|
|
||||||
|
### 8.5 개인 전적 페이지
|
||||||
|
|
||||||
|
- Riot API를 실시간 호출하지 않고, 서버에 저장된 `RiotMatch` 데이터를 기반으로 전적을 보여줍니다.
|
||||||
|
- 소환사의 협곡, 칼바람, 우르프, 아레나, 내전 탭을 제공합니다.
|
||||||
|
- 챔피언별 승률/KDA/CS/multi kill, 최근 경기 카드, 아이템, 양 팀 미니 정보를 표시합니다.
|
||||||
|
- 갱신 버튼을 누르면 Riot refresh job이 큐에 들어가고, 완료 시 Socket.IO 이벤트로 자동 반영됩니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> 전적 페이지는 사용자 요청마다 외부 API를 호출하지 않도록 설계했습니다. 저장된 데이터를 우선 보여주고, 명시적 갱신만 queue로 처리해 Riot API rate limit을 보호했습니다.
|
||||||
|
|
||||||
|
### 8.6 커뮤니티 내전 통계
|
||||||
|
|
||||||
|
- 커뮤니티의 모든 내전 기록을 카드 리스트와 리더보드로 보여줍니다.
|
||||||
|
- 선수별 게임 수, 승률, KDA, GPM, kill participation, CS/min, 주 챔피언을 집계합니다.
|
||||||
|
- 블루/레드 진영 승률과 최고 KDA, 누적 킬, 단일 경기 GPM, 킬 관여율, CS 지표를 제공합니다.
|
||||||
|
- 공개 공유 가능한 페이지로 설계했습니다.
|
||||||
|
|
||||||
|
포트폴리오 표현 예시:
|
||||||
|
|
||||||
|
> 단순 매치 결과 저장을 넘어, 커뮤니티 안에서 의미 있는 경쟁 기록을 볼 수 있도록 Riot raw match와 서비스 내부 user mapping을 조합한 통계 집계 레이어를 구현했습니다.
|
||||||
|
|
||||||
|
## 9. 기술적 의사결정
|
||||||
|
|
||||||
|
### 9.1 페이지 진입 시 Riot API를 호출하지 않은 이유
|
||||||
|
|
||||||
|
Riot API는 rate limit이 있고, 개인 전적 페이지는 공유 링크로 여러 사용자가 동시에 접근할 수 있습니다. 페이지 로드마다 API를 호출하면 다음 문제가 생깁니다.
|
||||||
|
|
||||||
|
- 사용자가 많아질수록 Riot API limit에 쉽게 도달합니다.
|
||||||
|
- 같은 사용자 전적을 여러 명이 동시에 보면 중복 호출이 발생합니다.
|
||||||
|
- 외부 API 응답 속도가 페이지 UX에 직접 영향을 줍니다.
|
||||||
|
|
||||||
|
그래서 이 프로젝트는 **server-only stored data + explicit refresh queue** 방식을 사용합니다.
|
||||||
|
|
||||||
|
- 화면은 DB에 저장된 데이터를 즉시 렌더링합니다.
|
||||||
|
- 최신화가 필요하면 사용자가 버튼을 눌러 job을 enqueue합니다.
|
||||||
|
- job은 Riot rate limiter를 통과하며 순차 처리됩니다.
|
||||||
|
- 완료 이벤트를 Socket.IO로 받아 React Query cache를 invalidate합니다.
|
||||||
|
|
||||||
|
### 9.2 Redis Stream을 작업 큐로 사용한 이유
|
||||||
|
|
||||||
|
프로젝트에는 이미 Garnet/Redis-compatible storage가 캐시와 상태 저장에 사용되고 있었습니다. Riot refresh job은 다음 특성을 가집니다.
|
||||||
|
|
||||||
|
- 작업량이 크지 않지만 rate limit 때문에 직렬화가 중요합니다.
|
||||||
|
- high/low priority가 필요합니다.
|
||||||
|
- 중복 요청 dedup이 필요합니다.
|
||||||
|
- 작업 상태와 ETA를 사용자에게 보여줘야 합니다.
|
||||||
|
|
||||||
|
Redis Stream은 consumer group, ack, pending entry list를 제공하므로 이 요구사항에 적합합니다. 별도 message broker를 추가하는 대신 기존 Garnet 인프라를 확장해 운영 복잡도를 낮췄습니다.
|
||||||
|
|
||||||
|
### 9.3 Leader election을 둔 이유
|
||||||
|
|
||||||
|
Riot API rate limit은 애플리케이션 전체에 적용됩니다. API 서버 인스턴스가 여러 개 떠 있을 경우 각 인스턴스가 동시에 worker loop를 돌면 global throttle을 깨뜨릴 수 있습니다.
|
||||||
|
|
||||||
|
이를 막기 위해 worker는 `riot:worker:leader` 키를 SET NX + TTL 방식으로 획득한 인스턴스만 실행합니다.
|
||||||
|
|
||||||
|
- leader가 살아 있으면 TTL을 갱신합니다.
|
||||||
|
- leader가 죽으면 TTL 만료 후 다른 인스턴스가 leader가 됩니다.
|
||||||
|
- high stream을 먼저 읽고, 없을 때 low stream을 읽습니다.
|
||||||
|
|
||||||
|
### 9.4 Riot raw match를 저장한 이유
|
||||||
|
|
||||||
|
초기에는 승패와 KDA만 필요해 보여도, 통계 페이지가 발전하면 GPM, damage share, vision score, objective, item build, rune 등 추가 지표가 필요해집니다.
|
||||||
|
|
||||||
|
raw response를 저장하지 않았다면 새로운 통계를 만들 때마다 과거 경기에 대해 Riot API를 다시 호출해야 합니다. 이 프로젝트는 `RiotMatch.raw`를 영구 저장해 재집계와 디버깅 비용을 줄였습니다.
|
||||||
|
|
||||||
|
### 9.5 토너먼트 코드 풀을 도입한 이유
|
||||||
|
|
||||||
|
Riot Tournament API 권한이 없으면 서비스가 직접 토너먼트 코드를 생성할 수 없습니다. 하지만 커뮤니티 운영에는 코드가 필요합니다.
|
||||||
|
|
||||||
|
그래서 외부에서 생성한 코드를 미리 업로드하고, 서비스는 그 코드를 안전하게 할당하는 방식으로 문제를 해결했습니다.
|
||||||
|
|
||||||
|
- `available -> reserved -> used` lifecycle
|
||||||
|
- `released`, `expired` 상태로 운영 예외 처리
|
||||||
|
- `findOneAndUpdate` 기반 atomic pop
|
||||||
|
- 부족한 slot은 `pending`으로 표시하고 후속 업로드 시 자동 보충
|
||||||
|
|
||||||
|
## 10. 캐시와 무효화 전략
|
||||||
|
|
||||||
|
| 데이터 | 캐시 전략 | 무효화 시점 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 개인 전적 조회 | RiotMatch/User에 저장된 데이터 직접 조회, React Query cache 사용 | Riot refresh completed 이벤트 |
|
||||||
|
| Riot refresh job status | Garnet TTL key | job completed/failed 후 TTL 만료 |
|
||||||
|
| 커뮤니티 통계 | Garnet TTL cache | 매치 결과 수집 완료, 내전 데이터 변경 |
|
||||||
|
| Match detail 통계 | 상대적으로 긴 TTL | 결과 데이터가 바뀔 때 invalidate |
|
||||||
|
| 토너먼트 코드 목록 | React Query cache | 업로드, 삭제, 환원 이후 invalidate |
|
||||||
|
|
||||||
|
핵심은 캐시를 단순히 붙이는 것이 아니라, **결과 수집 workflow의 마지막 단계에서 통계 캐시를 무효화**하도록 연결한 점입니다. 덕분에 집계 API는 비용을 줄이면서도 새 결과가 반영될 수 있습니다.
|
||||||
|
|
||||||
|
## 11. 보안과 권한
|
||||||
|
|
||||||
|
| 영역 | 정책 |
|
||||||
|
| --- | --- |
|
||||||
|
| 공개 페이지 | 매치 목록, 개인 전적, 커뮤니티 내전 통계는 공유 가능 |
|
||||||
|
| Admin 기능 | 토너먼트 코드 풀 등 운영 기능은 owner/admin 권한 필요 |
|
||||||
|
| 인증 | Microsoft Entra ID JWT 기반 인증 |
|
||||||
|
| 개발 편의 | 개발 환경에서는 `X-Auth-User-Id`로 사용자 전환 가능 |
|
||||||
|
| Socket 인증 | auction socket에서 access token 또는 dev user id를 handshake로 처리 |
|
||||||
|
|
||||||
|
포트폴리오에서는 다음처럼 설명할 수 있습니다.
|
||||||
|
|
||||||
|
> 실제 커뮤니티 운영에서는 전적 페이지가 외부 공유되어야 하므로 모든 페이지를 로그인 뒤에 숨기지 않았습니다. 대신 토너먼트 코드 관리처럼 운영 권한이 필요한 기능은 owner/admin role로 보호했습니다.
|
||||||
|
|
||||||
|
## 12. 예외 상황과 대응
|
||||||
|
|
||||||
|
| 예외 상황 | 대응 |
|
||||||
|
| --- | --- |
|
||||||
|
| 같은 Riot 계정을 여러 번 갱신 요청 | puuid + queueGroup dedup key로 기존 job 재사용 |
|
||||||
|
| Riot API rate limit 도달 | Lua script 기반 sliding window rate limiter가 대기 |
|
||||||
|
| 토너먼트 코드 부족 | match slot을 pending으로 표시하고 후속 업로드 시 자동 attach |
|
||||||
|
| 결과 polling에서 매치 미발견 | 다음 poll job 예약, 일정 시간 후 탐색 puuid 확장 |
|
||||||
|
| polling 장기 실패 | 24시간 후 expired/failed 상태로 마킹 |
|
||||||
|
| 경매 중 여러 클라이언트 접속 | matchId room 단위 state broadcast |
|
||||||
|
| 카카오 이벤트 중복 수신 | logId 기반 idempotency cache |
|
||||||
|
| Riot ID 표기 차이 | gameName/tagLine normalize 후 조회 |
|
||||||
|
|
||||||
|
## 13. 코드 구조 참고
|
||||||
|
|
||||||
|
| 관심사 | 주요 파일 |
|
||||||
|
| --- | --- |
|
||||||
|
| App module 구성 | `apps/api/src/app.module.ts` |
|
||||||
|
| Mongo schema | `apps/api/src/modules/global/database/schema.ts` |
|
||||||
|
| Riot refresh queue | `apps/api/src/modules/riot-job-queue/*` |
|
||||||
|
| Riot API rate limiter | `apps/api/src/modules/riot/riot-rate-limiter.service.ts` |
|
||||||
|
| 개인 전적 API | `apps/api/src/modules/match-history/*` |
|
||||||
|
| 커뮤니티 통계 API | `apps/api/src/modules/community-stats/*` |
|
||||||
|
| 토너먼트 코드 | `apps/api/src/modules/tournament-code/*` |
|
||||||
|
| 결과 수집 | `apps/api/src/modules/tournament-result/*` |
|
||||||
|
| 실시간 경매 | `apps/api/src/modules/auction/*` |
|
||||||
|
| Dakao 연동 | `apps/api/src/modules/dakao/*` |
|
||||||
|
| 개인 전적 페이지 | `apps/web/src/pages/UserHistoryPage.tsx` |
|
||||||
|
| 커뮤니티 내전 통계 페이지 | `apps/web/src/pages/CommunityInternalStatsPage.tsx` |
|
||||||
|
| 토너먼트 코드 Admin | `apps/web/src/pages/admin/TournamentCodesPage.tsx` |
|
||||||
|
| 경매 페이지 | `apps/web/src/pages/AuctionPage.tsx` |
|
||||||
|
|
||||||
|
## 14. 포트폴리오에 넣기 좋은 강조 문장
|
||||||
|
|
||||||
|
아래 문장들은 프로젝트 소개 페이지나 면접 답변에서 바로 쓰기 좋습니다.
|
||||||
|
|
||||||
|
### 짧은 버전
|
||||||
|
|
||||||
|
> 리그 오브 레전드 커뮤니티 내전 운영을 위해 참가 신청, 실시간 팀 경매, 토너먼트 코드 관리, Riot API 기반 결과 수집, 개인/커뮤니티 전적 통계를 통합한 풀스택 서비스입니다.
|
||||||
|
|
||||||
|
### 기술 중심 버전
|
||||||
|
|
||||||
|
> NestJS와 React 기반으로 내전 운영 플랫폼을 구현했고, Riot API rate limit을 고려해 Redis Stream 작업 큐, leader election, Socket.IO 완료 알림, MongoDB raw match archive 구조를 설계했습니다.
|
||||||
|
|
||||||
|
### 문제 해결 중심 버전
|
||||||
|
|
||||||
|
> Riot Tournament API 권한이 없는 제약, 외부 API rate limit, 채팅방 중심의 참가 신청, 실시간 경매 동기화라는 운영 문제를 각각 코드 풀, 비동기 작업 큐, Dakao/NATS 명령 처리, Socket.IO Gateway로 해결했습니다.
|
||||||
|
|
||||||
|
### 데이터/통계 중심 버전
|
||||||
|
|
||||||
|
> Match-V5 raw 데이터를 저장하고 서비스 내부 user mapping과 결합해 개인 전적, 챔피언별 통계, 커뮤니티 리더보드, 팀 인사이트를 계산하는 집계 레이어를 구현했습니다.
|
||||||
|
|
||||||
|
## 15. 면접 질문 대비
|
||||||
|
|
||||||
|
### Q. 왜 Riot API를 프론트에서 직접 호출하지 않았나요?
|
||||||
|
|
||||||
|
Riot API key를 브라우저에 노출할 수 없고, rate limit을 통제하기 어렵기 때문입니다. 또한 같은 전적 페이지를 여러 사용자가 동시에 열면 중복 호출이 발생합니다. 그래서 API 서버가 Riot API 호출을 전담하고, 명시적 갱신 요청은 작업 큐로 넘겨 rate limit과 dedup을 관리했습니다.
|
||||||
|
|
||||||
|
### Q. Redis Stream을 쓴 이유는 무엇인가요?
|
||||||
|
|
||||||
|
이 프로젝트의 Riot 갱신 작업은 고성능 분산 큐보다 rate limit 보호, 우선순위, dedup, 상태 조회가 중요했습니다. 이미 Garnet을 사용하고 있었기 때문에 Redis Stream의 consumer group과 ack 모델을 활용하면 추가 인프라 없이 충분히 안정적인 queue를 만들 수 있었습니다.
|
||||||
|
|
||||||
|
### Q. 실시간 경매에서 가장 중요한 설계 포인트는 무엇인가요?
|
||||||
|
|
||||||
|
클라이언트가 각자 상태를 계산하지 않게 한 것입니다. 경매 상태는 서버의 `Auction` document를 기준으로 저장하고, 모든 클라이언트는 Socket.IO broadcast를 통해 같은 상태를 받습니다. 타이머도 서버 deadline을 기준으로 계산해 화면 간 불일치를 줄였습니다.
|
||||||
|
|
||||||
|
### Q. 토너먼트 결과를 어떻게 우리 매치와 연결했나요?
|
||||||
|
|
||||||
|
매치에 예약된 토너먼트 코드와 Riot Match-V5 detail의 `info.tournamentCode`를 비교했습니다. 일치하는 detail을 찾으면 해당 코드를 `used`로 바꾸고, `Match.result.games[]`에 경기 결과를 upsert합니다.
|
||||||
|
|
||||||
|
### Q. 통계 집계에서 raw match를 저장한 장점은 무엇인가요?
|
||||||
|
|
||||||
|
처음에는 KDA만 쓰더라도 이후 GPM, damage share, vision score, objective, item, rune 등 요구사항이 늘어날 수 있습니다. raw를 저장하면 Riot API를 다시 호출하지 않고 과거 데이터를 재집계할 수 있어 확장성이 좋아집니다.
|
||||||
|
|
||||||
|
### Q. 이 프로젝트에서 개선하고 싶은 점은 무엇인가요?
|
||||||
|
|
||||||
|
포트폴리오에서는 아래 개선 계획을 넣으면 좋습니다.
|
||||||
|
|
||||||
|
- Riot refresh worker의 pending entry claim과 dead-letter queue 강화
|
||||||
|
- 커뮤니티 통계 aggregation을 Mongo pipeline 중심으로 재구성해 대규모 데이터에서 성능 개선
|
||||||
|
- 경매 권한을 현재 dev-friendly 모드에서 captain identity 기반으로 더 엄격히 검증
|
||||||
|
- 관측성 추가: job duration, Riot API wait time, cache hit rate, polling success rate dashboard
|
||||||
|
- E2E 테스트 추가: 경매 완료부터 토너먼트 코드 예약, 결과 수집, 통계 반영까지
|
||||||
|
|
||||||
|
## 16. 성과를 수치화할 때 넣을 지표
|
||||||
|
|
||||||
|
현재 문서에는 실제 운영 지표가 들어가 있지 않습니다. 포트폴리오 완성도를 높이려면 아래 수치를 실제 데이터로 채워 넣으면 좋습니다.
|
||||||
|
|
||||||
|
| 지표 | 예시 문장 |
|
||||||
|
| --- | --- |
|
||||||
|
| 운영 시간 절감 | "운영자가 수동으로 기록하던 참가 신청과 결과 입력 과정을 자동화해 내전 1회당 수작업 시간을 약 N분 줄였습니다." |
|
||||||
|
| API 호출 절감 | "동일 puuid/queueGroup 갱신 요청 dedup으로 중복 Riot API 호출을 N% 감소시켰습니다." |
|
||||||
|
| 통계 조회 성능 | "커뮤니티 통계에 TTL 캐시를 적용해 반복 조회 응답 시간을 N ms에서 N ms로 줄였습니다." |
|
||||||
|
| 안정성 | "토너먼트 결과 polling 실패 시 재시도와 만료 상태를 기록해 운영자가 누락 케이스를 추적할 수 있게 했습니다." |
|
||||||
|
| 사용 규모 | "N명의 커뮤니티 멤버, N회의 내전, N개의 Riot match raw 데이터를 관리했습니다." |
|
||||||
|
|
||||||
|
## 17. Confluence 페이지 구성 추천
|
||||||
|
|
||||||
|
Confluence에는 아래 순서로 넣으면 읽는 사람이 따라오기 쉽습니다.
|
||||||
|
|
||||||
|
1. 프로젝트 한 줄 소개
|
||||||
|
2. 문제 정의 표
|
||||||
|
3. 전체 아키텍처 다이어그램
|
||||||
|
4. 핵심 기능 4개
|
||||||
|
- 카카오톡 참가 신청
|
||||||
|
- 실시간 경매
|
||||||
|
- 토너먼트 코드와 결과 수집
|
||||||
|
- 개인/커뮤니티 전적
|
||||||
|
5. 기술적 의사결정
|
||||||
|
6. 시퀀스 다이어그램
|
||||||
|
7. 코드 구조와 담당 범위
|
||||||
|
8. 개선 계획
|
||||||
|
|
||||||
|
## 18. README/포트폴리오 카드용 축약본
|
||||||
|
|
||||||
|
```text
|
||||||
|
LOLYMPUS Tournament Support
|
||||||
|
|
||||||
|
리그 오브 레전드 커뮤니티 내전 운영을 위한 풀스택 서비스입니다.
|
||||||
|
카카오톡 명령어 기반 참가 신청, 실시간 팀 경매, 토너먼트 코드 풀 관리,
|
||||||
|
Riot Match-V5 결과 자동 수집, 개인 전적 및 커뮤니티 통계 페이지를 구현했습니다.
|
||||||
|
|
||||||
|
기술적으로는 NestJS, React, MongoDB, Socket.IO, Redis Stream 기반 작업 큐를 사용했고,
|
||||||
|
Riot API rate limit을 보호하기 위해 저장된 데이터 우선 조회와 명시적 refresh queue 구조를 설계했습니다.
|
||||||
|
토너먼트 코드 생성 API 권한이 없는 제약은 코드 풀과 polling workflow로 해결했습니다.
|
||||||
|
```
|
||||||
|
|
||||||
Reference in new issue
Block a user