계정 속성에 nickname 추가 (#48)

* feat: 계정 속성에 nickname 추가

계정 생성 시 닉네임이 존재하지 않는다면 tsid로 폴백처리

* feat: 계정 입장 이벤트 속성에 nickname 추가

Author: rrgks6221

prisma/migrations/20250824073350_account_nickname/migration.sql

@@ -0,0 +1,19 @@
+/*
+  마이그레이션 절차:
+  1) 닉네임 컬럼 추가 (nullable)
+  2) 기존 row의 nickname = id::text 로 백필
+  3) NOT NULL + UNIQUE 제약 추가
+*/
+
+-- Step 1
+ALTER TABLE "account" ADD COLUMN "nickname" VARCHAR(20);
+
+-- Step 2
+UPDATE "account"
+SET "nickname" = "id"::text
+WHERE "nickname" IS NULL;
+
+-- Step 3
+ALTER TABLE "account" ALTER COLUMN "nickname" SET NOT NULL;
+
+CREATE UNIQUE INDEX "account_nickname_key" ON "account"("nickname");

prisma/schema.prisma

@@ -30,6 +30,7 @@ model Account {
 
   username       String?   @unique @db.VarChar(20)
   password       String?
+  nickname       String    @unique @db.VarChar(20)
   lastEnteredAt  DateTime? @db.Timestamp(3)
   lastSignedInAt DateTime? @db.Timestamp(3)
 

src/modules/account/assemblers/account-dto.assembler.ts

@@ -11,6 +11,7 @@ export class AccountDtoAssembler {
 
     dto.role = account.role;
     dto.signInType = account.signInType;
+    dto.nickname = account.nickname;
     dto.enteredAt = account.enteredAt;
 
     return dto;

src/modules/account/dto/account.dto.ts

@@ -20,6 +20,9 @@ export class AccountDto extends BaseResponseDto {
   })
   signInType: SignInType;
 
+  @ApiProperty()
+  nickname: string;
+
   @ApiProperty({
     description: '진입 시점',
   })

src/modules/account/entities/__spec__/account.factory.ts

@@ -19,6 +19,7 @@ export const AccountFactory = Factory.define<Account & AccountProps>(
     signInType: () => faker.helpers.arrayElement(Object.values(SignInType)),
     username: () => faker.internet.username(),
     password: () => faker.internet.password(),
+    nickname: () => generateEntityId(),
     enteredAt: () => faker.date.past(),
     createdAt: () => new Date(),
     updatedAt: () => new Date(),

src/modules/account/entities/account.entity.ts

@@ -22,13 +22,15 @@ export interface AccountProps {
   signInType: SignInType;
   username?: string;
   password?: string;
+  nickname: string;
   enteredAt?: Date;
   lastSignedInAt?: Date;
 }
 
 interface CreateAccountProps {
   role: AccountRole;
   signInType: SignInType;
+  nickname?: string;
   username?: string;
   password?: string;
 }
@@ -49,6 +51,7 @@ export class Account extends AggregateRoot<AccountProps> {
         signInType: props.signInType,
         username: props.username,
         password: props.password,
+        nickname: props.nickname ?? generateEntityId(),
       },
       createdAt: date,
       updatedAt: date,
@@ -60,6 +63,7 @@ export class Account extends AggregateRoot<AccountProps> {
         signInType: props.signInType,
         username: props.username,
         password: props.password,
+        nickname: account.props.nickname,
       }),
     );
 
@@ -84,6 +88,10 @@ export class Account extends AggregateRoot<AccountProps> {
     return this.props.password;
   }
 
+  get nickname(): string {
+    return this.props.nickname;
+  }
+
   get enteredAt(): Date | undefined {
     return this.props.enteredAt;
   }
@@ -95,7 +103,12 @@ export class Account extends AggregateRoot<AccountProps> {
 
     this.updatedAt = now;
 
-    this.apply(new AccountEnteredEvent(this.id, { enteredAt: now }));
+    this.apply(
+      new AccountEnteredEvent(this.id, {
+        nickname: this.props.nickname,
+        enteredAt: now,
+      }),
+    );
   }
 
   signIn() {

src/modules/account/errors/account-nickname-already-occupied.error.ts

@@ -0,0 +1,12 @@
+import { BaseError } from '@common/base/base.error';
+
+export class AccountNicknameAlreadyOccupiedError extends BaseError {
+  static CODE: string = 'ACCOUNT.NICKNAME_ALREADY_OCCUPIED';
+
+  constructor(message?: string) {
+    super(
+      message ?? 'Account nickname is already occupied',
+      AccountNicknameAlreadyOccupiedError.CODE,
+    );
+  }
+}

src/modules/account/events/account-created-event/account-created.event.ts

@@ -10,6 +10,7 @@ interface AccountCreatedEventPayload {
   signInType: SignInType;
   username?: string;
   password?: string;
+  nickname: string;
 }
 
 export class AccountCreatedEvent extends DomainEvent<AccountCreatedEventPayload> {

src/modules/account/events/account-entered-event/__spec__/account-entered.handler.spec.ts

@@ -54,6 +54,7 @@ describe(AccountEnteredHandler, () => {
 
   beforeEach(() => {
     event = new AccountEnteredEvent(generateEntityId(), {
+      nickname: generateEntityId(),
       enteredAt: new Date(),
     });
   });

src/modules/account/events/account-entered-event/account-entered.event.ts

@@ -1,6 +1,7 @@
 import { DomainEvent } from '@common/base/base.domain-event';
 
 interface AccountEnteredEventPayload {
+  nickname: string;
   enteredAt: Date;
 }