feat(api): add community matches

This commit is contained in:
dahyeon committed 2026-04-16 23:22:00 +09:00
1 parent 49035f3501
commit 065df2051d
15 files changed
+3374

No files matched your search

@@ -0,0 +1,107 @@
import {
Body,
Controller,
BadRequestException,
ForbiddenException,
Get,
Param,
Patch,
Post,
Req,
UseGuards,
} from '@nestjs/common';
import type { Request } from 'express';
import mongoose from 'mongoose';
import { AllowPublicAccess } from '../auth/allow-public-access.decorator';
import { CurrentUser } from '../auth/current-user.decorator';
import { Roles } from '../auth/roles.decorator';
import { RolesGuard } from '../auth/roles.guard';
import { ParseObjectIdPipe } from '../common/parse-object-id.pipe';
import type { UserDocument } from '../global/database/schema';
import '../auth/auth-request';
import { CommunityService } from './community.service';
import { CreateCommunityDto } from './dto/create-community.dto';
import { TransferOwnershipDto } from './dto/transfer-ownership.dto';
@Controller('communities')
export class CommunityController {
constructor(private readonly communityService: CommunityService) {}
@Post()
@AllowPublicAccess()
public async createCommunity(
@Body() body: CreateCommunityDto,
@Req() req: Request,
) {
if (!req.identity && !body.owner) {
throw new BadRequestException(
'owner is required when not authenticated.',
);
}
return this.communityService.createCommunityWithOwner({
...body,
identityId: req.identity?._id,
});
}
@Get(':communityId')
@AllowPublicAccess()
public async getCommunity(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
) {
return this.communityService.getById(communityId);
}
@Patch(':communityId/members/:userId/promote')
@Roles('owner')
@UseGuards(RolesGuard)
public async promoteToAdmin(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) targetUserId: mongoose.Types.ObjectId,
) {
this.assertOwnerOfCommunity(currentUser, communityId);
return this.communityService.promoteToAdmin({ communityId, targetUserId });
}
@Patch(':communityId/members/:userId/demote')
@Roles('owner')
@UseGuards(RolesGuard)
public async demoteToMember(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) targetUserId: mongoose.Types.ObjectId,
) {
this.assertOwnerOfCommunity(currentUser, communityId);
return this.communityService.demoteToMember({ communityId, targetUserId });
}
@Patch(':communityId/transfer-ownership')
@Roles('owner')
@UseGuards(RolesGuard)
public async transferOwnership(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Body() body: TransferOwnershipDto,
) {
this.assertOwnerOfCommunity(currentUser, communityId);
return this.communityService.transferOwnership({
communityId,
currentOwnerUserId: currentUser._id,
newOwnerUserId: new mongoose.Types.ObjectId(body.newOwnerUserId),
});
}
private assertOwnerOfCommunity(
user: UserDocument,
communityId: mongoose.Types.ObjectId,
): void {
if (!user.communityId.equals(communityId)) {
throw new ForbiddenException('You do not belong to this community.');
}
}
}
@@ -0,0 +1,10 @@
import { Module } from '@nestjs/common';
import { CommunityController } from './community.controller';
import { CommunityService } from './community.service';
@Module({
controllers: [CommunityController],
providers: [CommunityService],
exports: [CommunityService],
})
export class CommunityModule {}
@@ -0,0 +1,196 @@
import {
BadRequestException,
Injectable,
InternalServerErrorException,
NotFoundException,
} from '@nestjs/common';
import mongoose from 'mongoose';
import { ConnectionService } from '../global/database/connection.service';
import {
CommunityDocument,
UserDocument,
} from '../global/database/schema';
export interface CreateCommunityInput {
name: string;
description?: string;
identityId?: mongoose.Types.ObjectId;
owner?: {
kakaoTalkId?: string;
kakaoTalkNickname?: string;
discordId?: string;
discordNickname?: string;
};
}
@Injectable()
export class CommunityService {
constructor(private readonly connectionService: ConnectionService) {}
public async getById(
communityId: mongoose.Types.ObjectId,
): Promise<CommunityDocument> {
const CommunityModel = await this.connectionService.getModel('community');
const community = await CommunityModel.findById(communityId).exec();
if (!community) throw new NotFoundException('Community not found.');
return community;
}
public async createCommunityWithOwner(input: CreateCommunityInput): Promise<{
community: CommunityDocument;
owner: UserDocument;
}> {
const CommunityModel = await this.connectionService.getModel('community');
const UserModel = await this.connectionService.getModel('user');
const communityId = new mongoose.Types.ObjectId();
const ownerUserId = new mongoose.Types.ObjectId();
const session = await this.connectionService.createSession();
if (!session) {
throw new InternalServerErrorException('Failed to start DB session.');
}
try {
session.startTransaction();
const [community] = await CommunityModel.create(
[
{
_id: communityId,
name: input.name,
description: input.description ?? '',
ownerUserId,
},
],
{ session },
);
const [owner] = await UserModel.create(
[
{
_id: ownerUserId,
communityId,
identityId: input.identityId,
role: 'owner',
kakaoTalkId: input.owner?.kakaoTalkId,
kakaoTalkNickname: input.owner?.kakaoTalkNickname,
discordId: input.owner?.discordId,
discordNickname: input.owner?.discordNickname,
},
],
{ session },
);
await session.commitTransaction();
return { community, owner };
} catch (err) {
await session.abortTransaction();
throw err;
} finally {
await session.endSession();
}
}
public async promoteToAdmin(params: {
communityId: mongoose.Types.ObjectId;
targetUserId: mongoose.Types.ObjectId;
}): Promise<UserDocument> {
return this.changeNonOwnerRole({ ...params, nextRole: 'admin' });
}
public async demoteToMember(params: {
communityId: mongoose.Types.ObjectId;
targetUserId: mongoose.Types.ObjectId;
}): Promise<UserDocument> {
return this.changeNonOwnerRole({ ...params, nextRole: 'member' });
}
public async transferOwnership(params: {
communityId: mongoose.Types.ObjectId;
currentOwnerUserId: mongoose.Types.ObjectId;
newOwnerUserId: mongoose.Types.ObjectId;
}): Promise<{
community: CommunityDocument;
previousOwner: UserDocument;
newOwner: UserDocument;
}> {
if (params.currentOwnerUserId.equals(params.newOwnerUserId)) {
throw new BadRequestException('New owner is already the current owner.');
}
const CommunityModel = await this.connectionService.getModel('community');
const UserModel = await this.connectionService.getModel('user');
const session = await this.connectionService.createSession();
if (!session) {
throw new InternalServerErrorException('Failed to start DB session.');
}
try {
session.startTransaction();
const community = await CommunityModel.findById(
params.communityId,
).session(session);
if (!community) throw new NotFoundException('Community not found.');
if (!community.ownerUserId.equals(params.currentOwnerUserId)) {
throw new BadRequestException('Acting user is not the current owner.');
}
const [previousOwner, newOwner] = await Promise.all([
UserModel.findById(params.currentOwnerUserId).session(session),
UserModel.findById(params.newOwnerUserId).session(session),
]);
if (!previousOwner)
throw new NotFoundException('Previous owner user not found.');
if (!newOwner) throw new NotFoundException('New owner user not found.');
if (!newOwner.communityId.equals(params.communityId)) {
throw new BadRequestException(
'New owner does not belong to this community.',
);
}
community.ownerUserId = newOwner._id;
previousOwner.role = 'admin';
newOwner.role = 'owner';
await Promise.all([
community.save({ session }),
previousOwner.save({ session }),
newOwner.save({ session }),
]);
await session.commitTransaction();
return { community, previousOwner, newOwner };
} catch (err) {
await session.abortTransaction();
throw err;
} finally {
await session.endSession();
}
}
private async changeNonOwnerRole(params: {
communityId: mongoose.Types.ObjectId;
targetUserId: mongoose.Types.ObjectId;
nextRole: 'admin' | 'member';
}): Promise<UserDocument> {
const UserModel = await this.connectionService.getModel('user');
const user = await UserModel.findById(params.targetUserId);
if (!user) throw new NotFoundException('Target user not found.');
if (!user.communityId.equals(params.communityId)) {
throw new BadRequestException(
'Target user does not belong to this community.',
);
}
if (user.role === 'owner') {
throw new BadRequestException(
'Owner role must be changed via transferOwnership.',
);
}
user.role = params.nextRole;
await user.save();
return user;
}
}
@@ -0,0 +1,47 @@
import { Type } from 'class-transformer';
import {
IsOptional,
IsString,
MaxLength,
MinLength,
ValidateNested,
} from 'class-validator';
class CreateCommunityOwnerDto {
@IsOptional()
@IsString()
@MaxLength(64)
kakaoTalkId?: string;
@IsOptional()
@IsString()
@MaxLength(64)
kakaoTalkNickname?: string;
@IsOptional()
@IsString()
@MaxLength(64)
discordId?: string;
@IsOptional()
@IsString()
@MaxLength(64)
discordNickname?: string;
}
export class CreateCommunityDto {
@IsString()
@MinLength(1)
@MaxLength(64)
name!: string;
@IsOptional()
@IsString()
@MaxLength(1024)
description?: string;
@IsOptional()
@ValidateNested()
@Type(() => CreateCommunityOwnerDto)
owner?: CreateCommunityOwnerDto;
}
@@ -0,0 +1,6 @@
import { IsMongoId } from 'class-validator';
export class TransferOwnershipDto {
@IsMongoId()
newOwnerUserId!: string;
}
@@ -0,0 +1,123 @@
import { Body, Controller, Get, Param, Post, Query } from '@nestjs/common';
import mongoose from 'mongoose';
import { AllowPublicAccess } from '../auth/allow-public-access.decorator';
import { ParseObjectIdPipe } from '../common/parse-object-id.pipe';
import { RiotJobQueueService } from '../riot-job-queue/riot-job-queue.service';
import type {
RiotJobPriority,
} from '../riot-job-queue/riot-job-queue.types';
import { MatchHistoryService } from './match-history.service';
interface RefreshBody {
queueGroups?: string[];
priority?: RiotJobPriority;
}
@Controller('communities/:communityId/users/:userId')
export class MatchHistoryController {
constructor(
private readonly matchHistoryService: MatchHistoryService,
private readonly riotJobQueueService: RiotJobQueueService,
) {}
@Get('history-profile')
@AllowPublicAccess()
public getProfile(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
) {
return this.matchHistoryService.getProfile({ communityId, userId });
}
@Get('champion-stats')
@AllowPublicAccess()
public getChampionStats(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
@Query('queueGroup') queueGroup?: string,
@Query('rank') rank?: string,
@Query('seasonId') seasonId?: string,
) {
return this.matchHistoryService.getChampionStats({
communityId,
userId,
filters: { queueGroup, rank, seasonId },
});
}
@Get('recent-summary')
@AllowPublicAccess()
public getRecentSummary(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
@Query('queueGroup') queueGroup?: string,
@Query('rank') rank?: string,
@Query('seasonId') seasonId?: string,
@Query('championId') championId?: string,
@Query('limit') limit?: string,
) {
return this.matchHistoryService.getRecentSummary({
communityId,
userId,
filters: {
queueGroup,
rank,
seasonId,
championId: this.toNumber(championId),
limit: this.toNumber(limit),
},
});
}
@Get('recent-matches')
@AllowPublicAccess()
public getRecentMatches(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
@Query('queueGroup') queueGroup?: string,
@Query('rank') rank?: string,
@Query('seasonId') seasonId?: string,
@Query('championId') championId?: string,
@Query('limit') limit?: string,
@Query('cursor') cursor?: string,
) {
return this.matchHistoryService.getRecentMatches({
communityId,
userId,
filters: {
queueGroup,
rank,
seasonId,
championId: this.toNumber(championId),
limit: this.toNumber(limit),
cursor: this.toNumber(cursor),
},
});
}
@Post('refresh')
@AllowPublicAccess()
public refresh(
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
@Body() body: RefreshBody,
) {
return this.riotJobQueueService.enqueueRefresh({
communityId,
userId,
queueGroups: body.queueGroups ?? ['summoners-rift'],
priority: body.priority ?? 'high',
});
}
private toNumber(value: string | undefined): number | undefined {
if (!value) return undefined;
const parsed = Number(value);
return Number.isFinite(parsed) ? parsed : undefined;
}
}
@@ -0,0 +1,12 @@
import { Module } from '@nestjs/common';
import { RiotJobQueueModule } from '../riot-job-queue/riot-job-queue.module';
import { MatchHistoryController } from './match-history.controller';
import { MatchHistoryService } from './match-history.service';
@Module({
imports: [RiotJobQueueModule],
controllers: [MatchHistoryController],
providers: [MatchHistoryService],
exports: [MatchHistoryService],
})
export class MatchHistoryModule {}
@@ -0,0 +1,782 @@
import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
import mongoose from 'mongoose';
import { ConnectionService } from '../global/database/connection.service';
import type {
CommunityDocument,
RiotAccount,
RiotLane,
RiotMatchDocument,
UserDocument,
} from '../global/database/schema';
import {
isRiotQueueGroup,
isRiotRankFilter,
RIOT_QUEUE_LABELS,
resolveRiotQueueIds,
type RiotQueueGroup,
type RiotRankFilter,
} from '../riot/riot-queue.constants';
import type {
RiotMatchDto,
RiotMatchParticipantDto,
} from '../riot/riot.types';
import type {
ChampionStatsResponse,
ChampionStatsRow,
HistorySeasonDto,
RecentMatchesResponse,
RecentMatchView,
RecentSummaryResponse,
UserHistoryProfileResponse,
} from './match-history.types';
const DEFAULT_QUEUE_GROUP: RiotQueueGroup = 'summoners-rift';
const DEFAULT_RANK: RiotRankFilter = 'all';
const DEFAULT_RECENT_LIMIT = 10;
const DEFAULT_SUMMARY_LIMIT = 20;
const MAX_AGGREGATE_MATCHES = 500;
const MAX_RECENT_SCAN = 120;
interface HistoryContext {
community: CommunityDocument;
user: UserDocument;
account: RiotAccount;
season: HistorySeasonDto;
seasonStartedAt: Date | null;
}
interface MatchFilters {
queueGroup?: string;
rank?: string;
seasonId?: string;
championId?: number;
limit?: number;
cursor?: number;
}
interface AggregatedChampion {
championId: number;
games: number;
wins: number;
totalKills: number;
totalDeaths: number;
totalAssists: number;
totalCs: number;
totalGameMinutes: number;
doubleKills: number;
tripleKills: number;
quadraKills: number;
pentaKills: number;
}
@Injectable()
export class MatchHistoryService {
constructor(private readonly connectionService: ConnectionService) {}
public async getProfile(params: {
communityId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
}): Promise<UserHistoryProfileResponse> {
const context = await this.resolveContext(params);
const lastFetchedAt =
context.account.recentStatsFetchedAt ??
context.account.matchIdsFetchedAt ??
null;
return {
userId: context.user._id.toString(),
puuid: context.account.puuid,
gameName: context.account.gameName,
tagLine: context.account.tagLine,
profileIconId: context.account.profileIconId,
summonerLevel: context.account.summonerLevel,
tiers: context.account.tiers.map((tier) => ({
queueType: tier.queueType,
tier: tier.tier,
rank: tier.rank,
leaguePoints: tier.leaguePoints,
wins: tier.wins,
losses: tier.losses,
fetchedAt: tier.fetchedAt.toISOString(),
})),
season: context.season,
seasons: this.resolveSeasons(context.community),
lastFetchedAt: lastFetchedAt?.toISOString() ?? null,
};
}
public async getChampionStats(params: {
communityId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
filters: MatchFilters;
}): Promise<ChampionStatsResponse> {
const context = await this.resolveContext({
...params,
seasonId: params.filters.seasonId,
});
const { queueGroup, rank, queueIds } = this.resolveQueueFilters(
params.filters,
);
const docs = await this.findStoredMatches({
context,
queueIds,
limit: MAX_AGGREGATE_MATCHES,
});
const aggregates = new Map<number, AggregatedChampion>();
for (const doc of docs) {
const dto = doc.raw as unknown as RiotMatchDto;
const participant = this.findParticipant(dto, context.account.puuid);
if (!participant) continue;
const aggregate =
aggregates.get(participant.championId) ??
this.createChampionAggregate(participant.championId);
this.addParticipantToChampionAggregate(aggregate, participant, dto);
aggregates.set(participant.championId, aggregate);
}
const champions = [...aggregates.values()]
.map((aggregate) => this.toChampionStatsRow(aggregate))
.sort((a, b) => b.games - a.games || b.winRate - a.winRate);
const totals = this.toChampionStatsRow(
[...aggregates.values()].reduce(
(acc, aggregate) => this.mergeChampionAggregate(acc, aggregate),
this.createChampionAggregate(0),
),
);
return {
queueGroup,
rank,
queueIds,
season: context.season,
lastFetchedAt: this.resolveLastFetchedAt(docs, context),
champions,
totals,
};
}
public async getRecentSummary(params: {
communityId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
filters: MatchFilters;
}): Promise<RecentSummaryResponse> {
const context = await this.resolveContext({
...params,
seasonId: params.filters.seasonId,
});
const { queueIds } = this.resolveQueueFilters(params.filters);
const limit = this.clampLimit(params.filters.limit, DEFAULT_SUMMARY_LIMIT, 50);
const docs = await this.findStoredMatches({
context,
queueIds,
championId: params.filters.championId,
limit,
scanLimit: params.filters.championId ? MAX_RECENT_SCAN : undefined,
});
const views = docs
.map((doc) => this.toRecentMatchView(doc, context.account.puuid))
.filter((view): view is RecentMatchView => Boolean(view))
.slice(0, limit);
return this.createRecentSummary(views, docs, context, limit);
}
public async getRecentMatches(params: {
communityId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
filters: MatchFilters;
}): Promise<RecentMatchesResponse> {
const context = await this.resolveContext({
...params,
seasonId: params.filters.seasonId,
});
const { queueIds } = this.resolveQueueFilters(params.filters);
const limit = this.clampLimit(params.filters.limit, DEFAULT_RECENT_LIMIT, 30);
const docs = await this.findStoredMatches({
context,
queueIds,
championId: params.filters.championId,
limit: limit + 1,
cursor: params.filters.cursor,
scanLimit: params.filters.championId ? MAX_RECENT_SCAN : undefined,
});
const views = docs
.map((doc) => this.toRecentMatchView(doc, context.account.puuid))
.filter((view): view is RecentMatchView => Boolean(view));
const page = views.slice(0, limit);
return {
matches: page,
nextCursor: views.length > limit ? page[page.length - 1]?.gameCreation ?? null : null,
lastFetchedAt: this.resolveLastFetchedAt(docs, context),
season: context.season,
};
}
private async resolveContext(params: {
communityId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
seasonId?: string;
}): Promise<HistoryContext> {
const UserModel = await this.connectionService.getModel('user');
const CommunityModel = await this.connectionService.getModel('community');
const [user, community] = await Promise.all([
UserModel.findById(params.userId).exec(),
CommunityModel.findById(params.communityId).exec(),
]);
if (!community) throw new NotFoundException('Community not found.');
if (!user || !user.communityId.equals(params.communityId)) {
throw new NotFoundException('User not found.');
}
const account =
user.riotAccounts.find((riotAccount) => riotAccount.isPrimary) ??
user.riotAccounts[0];
if (!account) {
throw new NotFoundException('Riot account not found.');
}
const season = this.resolveSeason(community, params.seasonId);
const seasonStartedAt = season.startedAt
? new Date(season.startedAt)
: (community.seasonStartedAt ?? null);
return { community, user, account, season, seasonStartedAt };
}
private resolveSeason(
community: CommunityDocument,
seasonId?: string,
): HistorySeasonDto {
const seasons = this.resolveSeasons(community);
if (seasonId && seasonId !== 'current') {
const selected = seasons.find((season) => season.id === seasonId);
if (!selected) throw new BadRequestException('Invalid seasonId.');
return selected;
}
const configured =
seasons.find((season) => !season.endedAt) ??
[...seasons].sort((left, right) =>
(right.startedAt ?? '').localeCompare(left.startedAt ?? ''),
)[0];
if (configured) return configured;
return {
id: 'current',
label: '현재 시즌',
startedAt: community.seasonStartedAt?.toISOString() ?? null,
endedAt: null,
};
}
private resolveSeasons(community: CommunityDocument): HistorySeasonDto[] {
const configured = community.seasons?.map((season) => ({
id: season.id,
label: season.label,
startedAt: season.startedAt.toISOString(),
endedAt: season.endedAt?.toISOString() ?? null,
}));
if (configured?.length) return configured;
return [
{
id: 'current',
label: '현재 시즌',
startedAt: community.seasonStartedAt?.toISOString() ?? null,
endedAt: null,
},
];
}
private resolveQueueFilters(filters: MatchFilters): {
queueGroup: RiotQueueGroup;
rank: RiotRankFilter;
queueIds: number[];
} {
const queueGroup = filters.queueGroup ?? DEFAULT_QUEUE_GROUP;
const rank = filters.rank ?? DEFAULT_RANK;
if (!isRiotQueueGroup(queueGroup)) {
throw new BadRequestException('Invalid queueGroup.');
}
if (!isRiotRankFilter(rank)) {
throw new BadRequestException('Invalid rank filter.');
}
return {
queueGroup,
rank,
queueIds: resolveRiotQueueIds(queueGroup, rank),
};
}
private async findStoredMatches(params: {
context: HistoryContext;
queueIds: number[];
limit: number;
cursor?: number;
championId?: number;
scanLimit?: number;
}): Promise<RiotMatchDocument[]> {
if (params.queueIds.length === 0) return [];
const RiotMatchModel = await this.connectionService.getModel('riotMatch');
const gameCreation: Record<string, number> = {};
if (params.context.seasonStartedAt) {
gameCreation.$gte = params.context.seasonStartedAt.getTime();
}
if (params.cursor) gameCreation.$lt = params.cursor;
const query: Record<string, unknown> = {
participantPuuids: params.context.account.puuid,
queueId: { $in: params.queueIds },
};
if (Object.keys(gameCreation).length > 0) query.gameCreation = gameCreation;
const docs = await RiotMatchModel.find(query)
.sort({ gameCreation: -1 })
.limit(params.scanLimit ?? params.limit)
.exec();
if (!params.championId) return docs.slice(0, params.limit);
return docs
.filter((doc) => {
const participant = this.findParticipant(
doc.raw as unknown as RiotMatchDto,
params.context.account.puuid,
);
return participant?.championId === params.championId;
})
.slice(0, params.limit);
}
private findParticipant(
match: RiotMatchDto,
puuid: string,
): RiotMatchParticipantDto | null {
return (
match.info.participants.find((participant) => participant.puuid === puuid) ??
null
);
}
private createChampionAggregate(championId: number): AggregatedChampion {
return {
championId,
games: 0,
wins: 0,
totalKills: 0,
totalDeaths: 0,
totalAssists: 0,
totalCs: 0,
totalGameMinutes: 0,
doubleKills: 0,
tripleKills: 0,
quadraKills: 0,
pentaKills: 0,
};
}
private addParticipantToChampionAggregate(
aggregate: AggregatedChampion,
participant: RiotMatchParticipantDto,
match: RiotMatchDto,
): void {
const minutes = this.resolveGameMinutes(match, participant);
aggregate.games += 1;
aggregate.wins += participant.win ? 1 : 0;
aggregate.totalKills += participant.kills;
aggregate.totalDeaths += participant.deaths;
aggregate.totalAssists += participant.assists;
aggregate.totalCs += this.resolveTotalCs(participant);
aggregate.totalGameMinutes += minutes;
aggregate.doubleKills += this.numberField(participant, 'doubleKills');
aggregate.tripleKills += this.numberField(participant, 'tripleKills');
aggregate.quadraKills += this.numberField(participant, 'quadraKills');
aggregate.pentaKills += this.numberField(participant, 'pentaKills');
}
private mergeChampionAggregate(
acc: AggregatedChampion,
aggregate: AggregatedChampion,
): AggregatedChampion {
acc.games += aggregate.games;
acc.wins += aggregate.wins;
acc.totalKills += aggregate.totalKills;
acc.totalDeaths += aggregate.totalDeaths;
acc.totalAssists += aggregate.totalAssists;
acc.totalCs += aggregate.totalCs;
acc.totalGameMinutes += aggregate.totalGameMinutes;
acc.doubleKills += aggregate.doubleKills;
acc.tripleKills += aggregate.tripleKills;
acc.quadraKills += aggregate.quadraKills;
acc.pentaKills += aggregate.pentaKills;
return acc;
}
private toChampionStatsRow(aggregate: AggregatedChampion): ChampionStatsRow {
const losses = aggregate.games - aggregate.wins;
return {
championId: aggregate.championId,
games: aggregate.games,
wins: aggregate.wins,
losses,
winRate: this.percent(aggregate.wins, aggregate.games),
avgKills: this.average(aggregate.totalKills, aggregate.games),
avgDeaths: this.average(aggregate.totalDeaths, aggregate.games),
avgAssists: this.average(aggregate.totalAssists, aggregate.games),
kda: this.resolveKda(
aggregate.totalKills,
aggregate.totalDeaths,
aggregate.totalAssists,
),
totalKills: aggregate.totalKills,
totalDeaths: aggregate.totalDeaths,
totalAssists: aggregate.totalAssists,
doubleKills: aggregate.doubleKills,
tripleKills: aggregate.tripleKills,
quadraKills: aggregate.quadraKills,
pentaKills: aggregate.pentaKills,
avgCs: this.average(aggregate.totalCs, aggregate.games),
avgCsPerMin: this.average(aggregate.totalCs, aggregate.totalGameMinutes),
};
}
private toRecentMatchView(
doc: RiotMatchDocument,
puuid: string,
): RecentMatchView | null {
const dto = doc.raw as unknown as RiotMatchDto;
const participant = this.findParticipant(dto, puuid);
if (!participant) return null;
const teamParticipants = dto.info.participants.filter(
(candidate) => candidate.teamId === participant.teamId,
);
const teamKills = teamParticipants.reduce(
(sum, candidate) => sum + candidate.kills,
0,
);
const minutes = this.resolveGameMinutes(dto, participant);
const totalCs = this.resolveTotalCs(participant);
const damageShare = this.resolveDamageShare(dto, participant);
const rating = this.resolveRating({
participant,
teamKills,
minutes,
damageShare,
});
return {
matchId: dto.metadata.matchId,
queueId: dto.info.queueId,
queueLabel: RIOT_QUEUE_LABELS[dto.info.queueId] ?? `큐 ${dto.info.queueId}`,
gameCreation: dto.info.gameCreation,
gameDuration: dto.info.gameDuration,
win: participant.win,
remake:
this.booleanField(participant, 'gameEndedInEarlySurrender') ||
dto.info.gameDuration < 240,
championId: participant.championId,
championLevel: participant.champLevel,
teamPosition: participant.teamPosition || participant.individualPosition,
kills: participant.kills,
deaths: participant.deaths,
assists: participant.assists,
kda: this.resolveKda(
participant.kills,
participant.deaths,
participant.assists,
),
rating,
totalCs,
csPerMin: this.average(totalCs, minutes),
killParticipation: this.percent(
participant.kills + participant.assists,
teamKills,
),
visionScore: participant.visionScore,
controlWardsBought: this.numberField(
participant,
'visionWardsBoughtInGame',
),
wardsPlaced: participant.wardsPlaced,
wardsKilled: participant.wardsKilled,
damageDealtToChampions: participant.totalDamageDealtToChampions,
damageTaken: participant.totalDamageTaken,
goldEarned: participant.goldEarned,
items: [
participant.item0,
participant.item1,
participant.item2,
participant.item3,
participant.item4,
participant.item5,
],
trinket: participant.item6,
summonerSpells: [participant.summoner1Id, participant.summoner2Id],
perks: this.resolvePerks(participant),
teams: this.resolveTeams(dto),
};
}
private createRecentSummary(
views: RecentMatchView[],
docs: RiotMatchDocument[],
context: HistoryContext,
requestedLimit: number,
): RecentSummaryResponse {
const totals = views.reduce(
(acc, view) => {
acc.wins += view.win ? 1 : 0;
acc.kills += view.kills;
acc.deaths += view.deaths;
acc.assists += view.assists;
return acc;
},
{ wins: 0, kills: 0, deaths: 0, assists: 0 },
);
const losses = views.length - totals.wins;
const best = views.reduce<RecentMatchView | null>((acc, view) => {
if (!acc) return view;
return view.deaths === 0 || view.rating > acc.rating ? view : acc;
}, null);
return {
windowSize: Math.min(views.length, requestedLimit),
winRate: this.percent(totals.wins, views.length),
wins: totals.wins,
losses,
streak: this.resolveStreak(views),
kda: this.resolveKda(totals.kills, totals.deaths, totals.assists),
avgKills: this.average(totals.kills, views.length),
avgDeaths: this.average(totals.deaths, views.length),
avgAssists: this.average(totals.assists, views.length),
bestRating: best
? {
rating: best.deaths === 0 ? 'Perfect' : best.rating,
kills: best.kills,
deaths: best.deaths,
assists: best.assists,
matchId: best.matchId,
}
: null,
positionRates: this.resolvePositionRates(views),
topChampions: this.resolveTopChampions(views),
lastFetchedAt: this.resolveLastFetchedAt(docs, context),
};
}
private resolveTeams(match: RiotMatchDto): RecentMatchView['teams'] {
return match.info.teams.map((team) => ({
side: team.teamId as 100 | 200,
win: team.win,
objectives: {
baron: team.objectives?.baron?.kills,
dragon: team.objectives?.dragon?.kills,
tower: team.objectives?.tower?.kills,
},
participants: match.info.participants
.filter((participant) => participant.teamId === team.teamId)
.map((participant) => {
const totalCs = this.resolveTotalCs(participant);
const minutes = this.resolveGameMinutes(match, participant);
return {
puuid: participant.puuid,
gameName: participant.riotIdGameName || participant.summonerName || 'Unknown',
tagLine: participant.riotIdTagLine || '',
championId: participant.championId,
championLevel: participant.champLevel,
teamPosition: participant.teamPosition || participant.individualPosition,
kills: participant.kills,
deaths: participant.deaths,
assists: participant.assists,
items: [
participant.item0,
participant.item1,
participant.item2,
participant.item3,
participant.item4,
participant.item5,
],
trinket: participant.item6,
summonerSpells: [participant.summoner1Id, participant.summoner2Id],
perks: this.resolvePerks(participant),
totalCs,
csPerMin: this.average(totalCs, minutes),
goldEarned: participant.goldEarned,
damageDealtToChampions: participant.totalDamageDealtToChampions,
damageTaken: participant.totalDamageTaken,
visionScore: participant.visionScore,
wardsPlaced: participant.wardsPlaced,
wardsKilled: participant.wardsKilled,
controlWardsBought: this.numberField(
participant,
'visionWardsBoughtInGame',
),
};
}),
}));
}
private resolvePerks(participant: RiotMatchParticipantDto): RecentMatchView['perks'] {
const primary = participant.perks.styles.find(
(style) => style.description === 'primaryStyle',
);
const sub = participant.perks.styles.find(
(style) => style.description === 'subStyle',
);
return {
primaryStyle: primary?.style,
subStyle: sub?.style,
keystone: primary?.selections[0]?.perk,
};
}
private resolvePositionRates(
views: RecentMatchView[],
): Partial<Record<RiotLane, number>> {
const counts = new Map<string, number>();
for (const view of views) {
if (!view.teamPosition) continue;
counts.set(view.teamPosition, (counts.get(view.teamPosition) ?? 0) + 1);
}
return Object.fromEntries(
[...counts.entries()].map(([lane, count]) => [
lane,
this.percent(count, views.length),
]),
) as Partial<Record<RiotLane, number>>;
}
private resolveTopChampions(views: RecentMatchView[]): RecentSummaryResponse['topChampions'] {
const byChampion = new Map<number, { games: number; wins: number; rating: number }>();
for (const view of views) {
const stat =
byChampion.get(view.championId) ?? { games: 0, wins: 0, rating: 0 };
stat.games += 1;
stat.wins += view.win ? 1 : 0;
stat.rating += view.rating;
byChampion.set(view.championId, stat);
}
return [...byChampion.entries()]
.map(([championId, stat]) => ({
championId,
games: stat.games,
winRate: this.percent(stat.wins, stat.games),
pickRate: this.percent(stat.games, views.length),
avgRating: this.average(stat.rating, stat.games),
}))
.sort((a, b) => b.games - a.games || b.winRate - a.winRate)
.slice(0, 3);
}
private resolveStreak(
views: RecentMatchView[],
): RecentSummaryResponse['streak'] {
if (views.length === 0) return null;
const firstWin = views[0].win;
let count = 0;
for (const view of views) {
if (view.win !== firstWin) break;
count += 1;
}
return { type: firstWin ? 'win' : 'loss', count };
}
private resolveRating(params: {
participant: RiotMatchParticipantDto;
teamKills: number;
minutes: number;
damageShare: number;
}): number {
const { participant, teamKills, minutes, damageShare } = params;
const kda = this.resolveKda(
participant.kills,
participant.deaths,
participant.assists,
);
const kp = teamKills > 0 ? (participant.kills + participant.assists) / teamKills : 0;
const csPerMin = this.resolveTotalCs(participant) / Math.max(minutes, 1);
const visionPerMin = participant.visionScore / Math.max(minutes, 1);
const score =
Math.min(kda / 6, 1) * 4 +
Math.min(kp, 1) * 2 +
Math.min(csPerMin / 9, 1) * 2 +
Math.min(damageShare / 0.35, 1) +
Math.min(visionPerMin / 2, 1);
return this.round(score);
}
private resolveDamageShare(
match: RiotMatchDto,
participant: RiotMatchParticipantDto,
): number {
const teamDamage = match.info.participants
.filter((candidate) => candidate.teamId === participant.teamId)
.reduce((sum, candidate) => sum + candidate.totalDamageDealtToChampions, 0);
return teamDamage > 0 ? participant.totalDamageDealtToChampions / teamDamage : 0;
}
private resolveTotalCs(participant: RiotMatchParticipantDto): number {
return participant.totalMinionsKilled + participant.neutralMinionsKilled;
}
private resolveGameMinutes(
match: RiotMatchDto,
participant: RiotMatchParticipantDto,
): number {
return Math.max((participant.timePlayed || match.info.gameDuration) / 60, 1);
}
private resolveKda(kills: number, deaths: number, assists: number): number {
return deaths === 0 ? kills + assists : this.round((kills + assists) / deaths);
}
private resolveLastFetchedAt(
docs: RiotMatchDocument[],
context: HistoryContext,
): string | null {
if (docs.length === 0) {
return context.account.recentStatsFetchedAt?.toISOString() ?? null;
}
const oldest = docs.reduce((acc, doc) =>
doc.fetchedAt.getTime() < acc.getTime() ? doc.fetchedAt : acc,
docs[0].fetchedAt);
return oldest.toISOString();
}
private clampLimit(value: number | undefined, fallback: number, max: number): number {
if (!value || !Number.isFinite(value)) return fallback;
return Math.max(1, Math.min(Math.floor(value), max));
}
private percent(value: number, total: number): number {
return total > 0 ? Math.round((value / total) * 100) : 0;
}
private average(value: number, total: number): number {
return total > 0 ? this.round(value / total) : 0;
}
private round(value: number): number {
return Math.round(value * 10) / 10;
}
private numberField(
value: RiotMatchParticipantDto,
key: string,
): number {
const field = value[key];
return typeof field === 'number' && Number.isFinite(field) ? field : 0;
}
private booleanField(
value: RiotMatchParticipantDto,
key: string,
): boolean {
return value[key] === true;
}
}
@@ -0,0 +1,162 @@
import type { RiotLane } from '../global/database/schema';
import type {
RiotQueueGroup,
RiotRankFilter,
} from '../riot/riot-queue.constants';
export interface HistorySeasonDto {
id: string;
label: string;
startedAt: string | null;
endedAt: string | null;
}
export interface UserHistoryProfileResponse {
userId: string;
puuid: string;
gameName: string;
tagLine: string;
profileIconId: number;
summonerLevel: number;
tiers: Array<{
queueType: string;
tier: string;
rank: string;
leaguePoints: number;
wins: number;
losses: number;
fetchedAt: string;
}>;
season: HistorySeasonDto;
seasons: HistorySeasonDto[];
lastFetchedAt: string | null;
}
export interface ChampionStatsRow {
championId: number;
games: number;
wins: number;
losses: number;
winRate: number;
avgKills: number;
avgDeaths: number;
avgAssists: number;
kda: number;
totalKills: number;
totalDeaths: number;
totalAssists: number;
doubleKills: number;
tripleKills: number;
quadraKills: number;
pentaKills: number;
avgCs: number;
avgCsPerMin: number;
}
export interface ChampionStatsResponse {
queueGroup: RiotQueueGroup;
rank: RiotRankFilter;
queueIds: number[];
season: HistorySeasonDto;
lastFetchedAt: string | null;
champions: ChampionStatsRow[];
totals: ChampionStatsRow;
}
export interface RecentSummaryResponse {
windowSize: number;
winRate: number;
wins: number;
losses: number;
streak: { type: 'win' | 'loss'; count: number } | null;
kda: number;
avgKills: number;
avgDeaths: number;
avgAssists: number;
bestRating: {
rating: number | 'Perfect';
kills: number;
deaths: number;
assists: number;
matchId: string;
} | null;
positionRates: Partial<Record<RiotLane, number>>;
topChampions: Array<{
championId: number;
games: number;
winRate: number;
pickRate: number;
avgRating: number;
}>;
lastFetchedAt: string | null;
}
export interface RecentMatchesResponse {
matches: RecentMatchView[];
nextCursor: number | null;
lastFetchedAt: string | null;
season: HistorySeasonDto;
}
export interface RecentMatchTeamParticipantView {
puuid: string;
gameName: string;
tagLine: string;
championId: number;
championLevel: number;
teamPosition: string;
kills: number;
deaths: number;
assists: number;
items: number[];
trinket: number;
summonerSpells: [number, number];
perks: { primaryStyle?: number; subStyle?: number; keystone?: number };
totalCs: number;
csPerMin: number;
goldEarned: number;
damageDealtToChampions: number;
damageTaken: number;
visionScore: number;
wardsPlaced: number;
wardsKilled: number;
controlWardsBought: number;
}
export interface RecentMatchView {
matchId: string;
queueId: number;
queueLabel: string;
gameCreation: number;
gameDuration: number;
win: boolean;
remake: boolean;
championId: number;
championLevel: number;
teamPosition: string;
kills: number;
deaths: number;
assists: number;
kda: number;
rating: number;
totalCs: number;
csPerMin: number;
killParticipation: number;
visionScore: number;
controlWardsBought: number;
wardsPlaced: number;
wardsKilled: number;
damageDealtToChampions: number;
damageTaken: number;
goldEarned: number;
items: number[];
trinket: number;
summonerSpells: [number, number];
perks: { primaryStyle?: number; subStyle?: number; keystone?: number };
teams: Array<{
side: 100 | 200;
win: boolean;
objectives?: { baron?: number; dragon?: number; tower?: number };
participants: RecentMatchTeamParticipantView[];
}>;
}
@@ -0,0 +1,187 @@
import { Type } from 'class-transformer';
import {
ArrayMaxSize,
ArrayMinSize,
registerDecorator,
IsArray,
IsDate,
IsEnum,
IsInt,
IsOptional,
IsString,
MaxLength,
Min,
MinLength,
ValidateNested,
ValidationArguments,
ValidationOptions,
} from 'class-validator';
import { MATCH_GAME_MODES, POSITIONS } from '../../global/database/schema';
import type { MatchGameMode, Position } from '../../global/database/schema';
function IsMultipleOf(
multiple: number,
validationOptions?: ValidationOptions,
): PropertyDecorator {
return (object, propertyName) => {
registerDecorator({
name: 'isMultipleOf',
target: object.constructor,
propertyName: String(propertyName),
constraints: [multiple],
options: validationOptions,
validator: {
validate(value: unknown, args: ValidationArguments) {
const [divisor] = args.constraints as [number];
return (
typeof value === 'number' &&
Number.isInteger(value) &&
value % divisor === 0
);
},
defaultMessage(args: ValidationArguments) {
const [divisor] = args.constraints as [number];
return `${args.property} must be a multiple of ${divisor}.`;
},
},
});
};
}
export class PositionPreferenceDto {
@IsEnum(POSITIONS)
position!: Position;
@IsInt()
@Min(1)
priority!: number;
}
class MatchScheduleItemDto {
@IsString()
@MaxLength(32)
time!: string;
@IsString()
@MaxLength(128)
label!: string;
}
export class CreateMatchDto {
@IsString()
@MinLength(1)
@MaxLength(128)
title!: string;
@IsOptional()
@IsString()
@MaxLength(2048)
description?: string;
@IsOptional()
@IsInt()
mapId?: number;
@IsDate()
@Type(() => Date)
scheduledAt!: Date;
@IsOptional()
@IsInt()
@Min(10)
@IsMultipleOf(10)
maxParticipants?: number;
@IsOptional()
@IsInt()
@Min(1)
gameCount?: number;
@IsOptional()
@IsEnum(MATCH_GAME_MODES)
gameMode?: MatchGameMode;
@IsOptional()
@IsArray()
@IsString({ each: true })
@ArrayMaxSize(32)
prizes?: string[];
@IsOptional()
@IsArray()
@IsString({ each: true })
@ArrayMaxSize(32)
notices?: string[];
@IsOptional()
@IsArray()
@ValidateNested({ each: true })
@Type(() => MatchScheduleItemDto)
@ArrayMaxSize(32)
schedule?: MatchScheduleItemDto[];
}
export class UpdateMatchDto {
@IsOptional()
@IsString()
@MaxLength(128)
title?: string;
@IsOptional()
@IsString()
@MaxLength(2048)
description?: string;
@IsOptional()
@IsInt()
mapId?: number;
@IsOptional()
@IsDate()
@Type(() => Date)
scheduledAt?: Date;
@IsOptional()
@IsInt()
@Min(10)
@IsMultipleOf(10)
maxParticipants?: number;
@IsOptional()
@IsInt()
@Min(1)
gameCount?: number;
@IsOptional()
@IsEnum(MATCH_GAME_MODES)
gameMode?: MatchGameMode;
@IsOptional()
@IsArray()
@IsString({ each: true })
prizes?: string[];
@IsOptional()
@IsArray()
@IsString({ each: true })
notices?: string[];
@IsOptional()
@IsArray()
@ValidateNested({ each: true })
@Type(() => MatchScheduleItemDto)
schedule?: MatchScheduleItemDto[];
}
export class JoinMatchDto {
@IsArray()
@ArrayMinSize(1)
@ArrayMaxSize(5)
@ValidateNested({ each: true })
@Type(() => PositionPreferenceDto)
preferredPositions!: PositionPreferenceDto[];
@IsOptional()
@IsString()
userId?: string;
}
@@ -0,0 +1,170 @@
import {
BadRequestException,
Body,
Controller,
Delete,
Get,
HttpCode,
HttpStatus,
Param,
Patch,
Post,
Query,
UseGuards,
} from '@nestjs/common';
import mongoose from 'mongoose';
import { AllowPublicAccess } from '../auth/allow-public-access.decorator';
import { CurrentUser } from '../auth/current-user.decorator';
import { Roles } from '../auth/roles.decorator';
import { RolesGuard } from '../auth/roles.guard';
import { ParseObjectIdPipe } from '../common/parse-object-id.pipe';
import type {
MatchDocument,
MatchStatus,
UserDocument,
} from '../global/database/schema';
import {
CreateMatchDto,
JoinMatchDto,
UpdateMatchDto,
} from './dto/create-match.dto';
import { MatchService } from './match.service';
@Controller('communities/:communityId/matches')
export class MatchController {
constructor(private readonly matchService: MatchService) {}
@Post()
@Roles('admin', 'owner')
@UseGuards(RolesGuard)
public async createMatch(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Body() body: CreateMatchDto,
) {
this.assertSameCommunity(currentUser, communityId);
return this.matchService.create({
communityId,
hostUserId: currentUser._id,
data: {
title: body.title,
description: body.description ?? '',
mapId: body.mapId ?? 11,
scheduledAt: body.scheduledAt,
maxParticipants: body.maxParticipants ?? 10,
gameCount: body.gameCount,
gameMode: body.gameMode ?? 'pair',
prizes: body.prizes ?? [],
notices: body.notices ?? [],
schedule: body.schedule ?? [],
},
});
}
// 공개 — 커뮤니티 내 매치 리스트. 로그인 시 본인 참여 여부를 함께 반환.
@Get()
@AllowPublicAccess()
public async listMatches(
@CurrentUser() currentUser: UserDocument | undefined,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Query('status') status?: MatchStatus,
@Query('limit') limit?: string,
) {
const matches = await this.matchService.list({
communityId,
status,
limit: limit ? Number(limit) : undefined,
});
if (!currentUser) return { matches };
const myId = currentUser._id;
return {
matches: matches.map((m) => this.annotateJoined(m, myId)),
};
}
@Get(':matchId')
@AllowPublicAccess()
public async getMatch(
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
) {
const match = await this.matchService.getById(matchId);
return this.matchService.serialize(match);
}
@Patch(':matchId')
@Roles('admin', 'owner')
@UseGuards(RolesGuard)
public async updateMatch(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
@Body() body: UpdateMatchDto,
) {
this.assertSameCommunity(currentUser, communityId);
return this.matchService.update({ matchId, communityId, patch: body });
}
@Delete(':matchId')
@Roles('admin', 'owner')
@UseGuards(RolesGuard)
@HttpCode(HttpStatus.NO_CONTENT)
public async deleteMatch(
@CurrentUser() currentUser: UserDocument,
@Param('communityId', ParseObjectIdPipe)
communityId: mongoose.Types.ObjectId,
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
) {
this.assertSameCommunity(currentUser, communityId);
await this.matchService.remove({ matchId, communityId });
}
// 공개 — 참여 (로그인된 유저는 자기 자신, 비로그인은 body.userId 사용).
@Post(':matchId/participants')
@AllowPublicAccess()
public async joinMatch(
@CurrentUser() currentUser: UserDocument | undefined,
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
@Body() body: JoinMatchDto,
) {
const userId = this.resolveJoinerUserId(currentUser, body.userId);
return this.matchService.join({
matchId,
userId,
preferredPositions: body.preferredPositions,
});
}
private resolveJoinerUserId(
currentUser: UserDocument | undefined,
bodyUserId?: string,
): mongoose.Types.ObjectId {
if (currentUser) return currentUser._id;
if (!bodyUserId || !mongoose.isValidObjectId(bodyUserId)) {
throw new BadRequestException(
'userId is required when not authenticated.',
);
}
return new mongoose.Types.ObjectId(bodyUserId);
}
private annotateJoined(
match: MatchDocument,
userId: mongoose.Types.ObjectId,
) {
const obj = match.toObject();
const joined = match.participants.some((p) => p.userId.equals(userId));
return { ...obj, joined };
}
private assertSameCommunity(
user: UserDocument,
communityId: mongoose.Types.ObjectId,
): void {
if (!user.communityId.equals(communityId)) {
throw new BadRequestException('Different community.');
}
}
}
@@ -0,0 +1,13 @@
import { Module } from '@nestjs/common';
import { CommunityStatsModule } from '../community-stats/community-stats.module';
import { TournamentCodeModule } from '../tournament-code/tournament-code.module';
import { MatchController } from './match.controller';
import { MatchService } from './match.service';
@Module({
imports: [TournamentCodeModule, CommunityStatsModule],
controllers: [MatchController],
providers: [MatchService],
exports: [MatchService],
})
export class MatchModule {}
@@ -0,0 +1,105 @@
import mongoose from 'mongoose';
import { MatchService } from './match.service';
describe('MatchService', () => {
function createService(match: Record<string, unknown>) {
const MatchModel = {
findById: jest.fn().mockResolvedValue(match),
};
const connectionService = {
getModel: jest.fn().mockImplementation(async (name: string) => {
if (name === 'match') return MatchModel;
return {};
}),
};
const tournamentCodeService = {
buildSlots: jest.fn().mockResolvedValue([]),
releaseFromMatch: jest.fn().mockResolvedValue(undefined),
};
const communityStatsService = {
invalidateCommunity: jest.fn().mockResolvedValue(undefined),
};
const matchStatsService = {
buildAndUpsert: jest.fn().mockResolvedValue(undefined),
removeByMatch: jest.fn().mockResolvedValue(undefined),
};
return {
service: new MatchService(
connectionService as never,
tournamentCodeService as never,
communityStatsService as never,
matchStatsService as never,
),
tournamentCodeService,
matchStatsService,
};
}
it('clears game schedule when a built match returns to recruiting', async () => {
const communityId = new mongoose.Types.ObjectId();
const match = {
communityId,
status: 'team-built',
tournamentCodeIds: [],
gameSchedule: [{ gameNumber: 1, teamAIndex: 2, teamBIndex: 4 }],
teams: [{ teamIndex: 1 }],
teamBuiltAt: new Date(),
result: { games: [] },
resultPollState: { state: 'polling' },
set: jest.fn(function (
this: Record<string, unknown>,
patch: Record<string, unknown>,
) {
Object.assign(this, patch);
}),
save: jest.fn().mockResolvedValue(undefined),
};
const { service, tournamentCodeService, matchStatsService } =
createService(match);
await service.update({
matchId: new mongoose.Types.ObjectId(),
communityId,
patch: { status: 'recruiting' },
});
expect(tournamentCodeService.releaseFromMatch).not.toHaveBeenCalled();
expect(match.tournamentCodeIds).toEqual([]);
expect(match.gameSchedule).toEqual([]);
expect(match.teamBuiltAt).toBeUndefined();
expect(match.result).toBeUndefined();
expect(match.resultPollState).toBeUndefined();
expect(match.save).toHaveBeenCalledTimes(1);
expect(matchStatsService.removeByMatch).toHaveBeenCalledWith(match._id);
});
it('releases reserved codes when returning a built match to recruiting', async () => {
const communityId = new mongoose.Types.ObjectId();
const codeId = new mongoose.Types.ObjectId();
const match = {
communityId,
status: 'in-progress',
tournamentCodeIds: [codeId],
gameSchedule: [{ gameNumber: 1, teamAIndex: 1, teamBIndex: 3 }],
set: jest.fn(function (
this: Record<string, unknown>,
patch: Record<string, unknown>,
) {
Object.assign(this, patch);
}),
save: jest.fn().mockResolvedValue(undefined),
};
const { service, tournamentCodeService } = createService(match);
await service.update({
matchId: new mongoose.Types.ObjectId(),
communityId,
patch: { status: 'recruiting' },
});
expect(tournamentCodeService.releaseFromMatch).toHaveBeenCalledWith(match);
expect(match.tournamentCodeIds).toEqual([]);
expect(match.gameSchedule).toEqual([]);
});
});
+360
View File
@@ -0,0 +1,360 @@
import {
BadRequestException,
Injectable,
InternalServerErrorException,
NotFoundException,
} from '@nestjs/common';
import mongoose from 'mongoose';
import { MatchStatsService } from '../community-stats/match-stats.service';
import { CommunityStatsService } from '../community-stats/community-stats.service';
import { ConnectionService } from '../global/database/connection.service';
import {
Match,
MatchDocument,
MatchSeriesResult,
MatchStatus,
PositionPreference,
TierInfo,
} from '../global/database/schema';
import { DEFAULT_TOURNAMENT_GAME_COUNT } from '../tournament-code/tournament-code.constants';
import { TournamentCodeService } from '../tournament-code/tournament-code.service';
const MATCH_SHORT_CODE_ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
const MATCH_SHORT_CODE_LENGTH = 4;
const MATCH_SHORT_CODE_GENERATION_ATTEMPTS = 20;
interface CreateMatchParams {
communityId: mongoose.Types.ObjectId;
hostUserId?: mongoose.Types.ObjectId;
data: Partial<Match> & Pick<Match, 'title' | 'scheduledAt'>;
}
interface UpdateMatchParams {
matchId: mongoose.Types.ObjectId;
communityId: mongoose.Types.ObjectId;
patch: Partial<Match>;
}
interface ListMatchesQuery {
communityId: mongoose.Types.ObjectId;
status?: MatchStatus;
limit?: number;
}
interface JoinMatchParams {
matchId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
preferredPositions: PositionPreference[];
// 특정 RiotAccount(puuid)로 참가하고 싶을 때 지정. 없으면 primary 사용.
riotPuuid?: string;
}
interface CancelMatchJoinParams {
matchId: mongoose.Types.ObjectId;
userId: mongoose.Types.ObjectId;
}
@Injectable()
export class MatchService {
constructor(
private readonly connectionService: ConnectionService,
private readonly tournamentCodeService: TournamentCodeService,
private readonly communityStatsService: CommunityStatsService,
private readonly matchStatsService: MatchStatsService,
) {}
public async create(params: CreateMatchParams): Promise<MatchDocument> {
const MatchModel = await this.connectionService.getModel('match');
const CommunityModel = await this.connectionService.getModel('community');
const community = await CommunityModel.findById(params.communityId)
.select({ matchGameCount: 1 })
.lean()
.exec();
return MatchModel.create({
...params.data,
shortCode:
params.data.shortCode ??
(await this.generateUniqueShortCode(MatchModel, params.communityId)),
gameCount:
params.data.gameCount ??
community?.matchGameCount ??
DEFAULT_TOURNAMENT_GAME_COUNT,
communityId: params.communityId,
hostUserId: params.hostUserId,
});
}
public async list(query: ListMatchesQuery): Promise<MatchDocument[]> {
const MatchModel = await this.connectionService.getModel('match');
const filter: {
communityId: mongoose.Types.ObjectId;
status?: MatchStatus;
} = {
communityId: query.communityId,
};
if (query.status) filter.status = query.status;
return MatchModel.find(filter)
.sort({ scheduledAt: -1 })
.limit(Math.min(query.limit ?? 50, 200))
.exec();
}
public async ensureShortCode(match: MatchDocument): Promise<MatchDocument> {
if (match.shortCode) return match;
const MatchModel = await this.connectionService.getModel('match');
match.shortCode = await this.generateUniqueShortCode(
MatchModel,
match.communityId,
);
await match.save();
return match;
}
public async getById(
matchId: mongoose.Types.ObjectId,
): Promise<MatchDocument> {
const MatchModel = await this.connectionService.getModel('match');
const match = await MatchModel.findById(matchId);
if (!match) throw new NotFoundException('Match not found.');
return match;
}
public async serialize(match: MatchDocument) {
const obj = match.toObject();
if (obj.result?.games) {
obj.result.games = [...obj.result.games].sort(
(left, right) => left.gameNumber - right.gameNumber,
);
if (!obj.result.seriesResults?.length) {
obj.result.seriesResults = this.buildSeriesResults(obj.result.games);
}
}
return {
...obj,
gameCount: match.gameCount || DEFAULT_TOURNAMENT_GAME_COUNT,
gameMode: match.gameMode ?? 'pair',
participants: (obj.participants ?? []).map((participant) => ({
...participant,
excluded: participant.excluded ?? false,
})),
teams: (obj.teams ?? []).map((team) => ({
...team,
})),
gameSchedule: obj.gameSchedule ?? [],
tournamentCodes: await this.tournamentCodeService.buildSlots(match),
};
}
public async update(params: UpdateMatchParams): Promise<MatchDocument> {
const MatchModel = await this.connectionService.getModel('match');
const match = await MatchModel.findById(params.matchId);
if (!match) throw new NotFoundException('Match not found.');
if (!match.communityId.equals(params.communityId)) {
throw new BadRequestException('Match does not belong to this community.');
}
const previousStatus = match.status;
if (
previousStatus !== 'recruiting' &&
('maxParticipants' in params.patch || 'gameMode' in params.patch)
) {
throw new BadRequestException(
'maxParticipants and gameMode can only be changed while recruiting.',
);
}
match.set(params.patch);
if (previousStatus !== 'recruiting' && match.status === 'recruiting') {
if (match.tournamentCodeIds.length > 0) {
await this.tournamentCodeService.releaseFromMatch(match);
}
match.tournamentCodeIds = [];
match.gameSchedule = [];
match.teamBuiltAt = undefined;
match.result = undefined;
match.resultPollState = undefined;
}
await match.save();
if (previousStatus !== 'recruiting' && match.status === 'recruiting') {
await this.matchStatsService.removeByMatch(match._id);
await this.communityStatsService.invalidateCommunity(params.communityId);
} else if (match.result?.games?.length) {
await this.matchStatsService.buildAndUpsert(match._id);
await this.communityStatsService.invalidateCommunity(params.communityId);
}
return match;
}
public async remove(params: {
matchId: mongoose.Types.ObjectId;
communityId: mongoose.Types.ObjectId;
}): Promise<void> {
const MatchModel = await this.connectionService.getModel('match');
const match = await MatchModel.findById(params.matchId);
if (!match) throw new NotFoundException('Match not found.');
if (!match.communityId.equals(params.communityId)) {
throw new BadRequestException('Match does not belong to this community.');
}
await this.tournamentCodeService.releaseFromMatch(match);
await this.matchStatsService.removeByMatch(match._id);
await match.deleteOne();
await this.communityStatsService.invalidateCommunity(params.communityId);
}
public async join(params: JoinMatchParams): Promise<MatchDocument> {
const MatchModel = await this.connectionService.getModel('match');
const UserModel = await this.connectionService.getModel('user');
const user = await UserModel.findById(params.userId);
if (!user) throw new NotFoundException('User not found.');
const match = await MatchModel.findById(params.matchId);
if (!match) throw new NotFoundException('Match not found.');
if (!match.communityId.equals(user.communityId)) {
throw new BadRequestException(
'User and match belong to different communities.',
);
}
if (match.status !== 'recruiting') {
throw new BadRequestException('Match is not recruiting.');
}
if (match.participants.length >= match.maxParticipants) {
throw new BadRequestException('Match is full.');
}
const alreadyIn = match.participants.some((p) => p.userId.equals(user._id));
if (alreadyIn) {
throw new BadRequestException('User already joined this match.');
}
const selectedRiot = params.riotPuuid
? user.riotAccounts.find((a) => a.puuid === params.riotPuuid)
: user.riotAccounts.find((a) => a.isPrimary);
const selectedTier = this.selectParticipantTier(selectedRiot?.tiers ?? []);
match.participants.push({
userId: user._id,
puuid: selectedRiot?.puuid,
gameName: selectedRiot?.gameName,
tagLine: selectedRiot?.tagLine,
profileIconId: selectedRiot?.profileIconId,
tier: selectedTier,
preferredPositions: params.preferredPositions,
joinedAt: new Date(),
excluded: false,
});
await match.save();
return match;
}
public async cancelJoin(
params: CancelMatchJoinParams,
): Promise<MatchDocument> {
const MatchModel = await this.connectionService.getModel('match');
const UserModel = await this.connectionService.getModel('user');
const user = await UserModel.findById(params.userId);
if (!user) throw new NotFoundException('User not found.');
const match = await MatchModel.findById(params.matchId);
if (!match) throw new NotFoundException('Match not found.');
if (!match.communityId.equals(user.communityId)) {
throw new BadRequestException(
'User and match belong to different communities.',
);
}
if (match.status !== 'recruiting') {
throw new BadRequestException('Match is not recruiting.');
}
const participantIndex = match.participants.findIndex((participant) =>
participant.userId.equals(user._id),
);
if (participantIndex === -1) {
throw new BadRequestException('User has not joined this match.');
}
match.participants.splice(participantIndex, 1);
await match.save();
return match;
}
private selectParticipantTier(tiers: TierInfo[]): TierInfo | undefined {
const tier =
tiers.find((entry) => entry.queueType === 'RANKED_SOLO_5x5') ?? tiers[0];
if (!tier) return undefined;
return {
leagueId: tier.leagueId,
queueType: tier.queueType,
tier: tier.tier,
rank: tier.rank,
puuid: tier.puuid,
leaguePoints: tier.leaguePoints,
wins: tier.wins,
losses: tier.losses,
veteran: tier.veteran,
inactive: tier.inactive,
freshBlood: tier.freshBlood,
hotStreak: tier.hotStreak,
miniSeries: tier.miniSeries,
fetchedAt: tier.fetchedAt,
};
}
private async generateUniqueShortCode(
MatchModel: mongoose.Model<Match>,
communityId: mongoose.Types.ObjectId,
): Promise<string> {
for (
let attempt = 0;
attempt < MATCH_SHORT_CODE_GENERATION_ATTEMPTS;
attempt += 1
) {
const shortCode = this.generateShortCode();
const exists = await MatchModel.exists({ communityId, shortCode });
if (!exists) return shortCode;
}
throw new InternalServerErrorException(
'Failed to generate unique match short code.',
);
}
private generateShortCode(): string {
let code = '';
for (let index = 0; index < MATCH_SHORT_CODE_LENGTH; index += 1) {
const alphabetIndex = Math.floor(
Math.random() * MATCH_SHORT_CODE_ALPHABET.length,
);
code += MATCH_SHORT_CODE_ALPHABET[alphabetIndex];
}
return code;
}
private buildSeriesResults(
games: NonNullable<Match['result']>['games'],
): MatchSeriesResult[] {
const bySeries = new Map<string, MatchSeriesResult>();
for (const game of games) {
const teamAIndex = Math.min(game.blueTeamIndex, game.redTeamIndex);
const teamBIndex = Math.max(game.blueTeamIndex, game.redTeamIndex);
const key = `${teamAIndex}:${teamBIndex}`;
const current =
bySeries.get(key) ??
({
teamAIndex,
teamBIndex,
teamAWins: 0,
teamBWins: 0,
} satisfies MatchSeriesResult);
if (game.winnerTeamIndex === teamAIndex) current.teamAWins += 1;
if (game.winnerTeamIndex === teamBIndex) current.teamBWins += 1;
current.winnerTeamIndex =
current.teamAWins > current.teamBWins
? teamAIndex
: current.teamBWins > current.teamAWins
? teamBIndex
: undefined;
bySeries.set(key, current);
}
return [...bySeries.values()];
}
}
+1094
View File
File diff suppressed because it is too large. Load diff