Merge pull request #68 from CodeVac513/feature/register-admin

✨ feat: 관리자 회원 가입 API 구현

Author: CodeVac513

server/package-lock.json

@@ -27,6 +27,9 @@
     "@nestjs/platform-express": "^10.0.0",
     "@nestjs/swagger": "^8.0.1",
     "@nestjs/typeorm": "^10.0.2",
+    "bcrypt": "^5.1.1",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
     "cross-env": "^7.0.3",
     "ioredis": "^5.4.1",
     "mysql2": "^3.11.3",

server/package.json

@@ -0,0 +1,39 @@
+import {
+  ApiBadRequestResponse,
+  ApiConflictResponse,
+  ApiCreatedResponse,
+  ApiOperation,
+} from '@nestjs/swagger';
+import { applyDecorators } from '@nestjs/common';
+
+export function ApiPostRegisterAdmin() {
+  return applyDecorators(
+    ApiOperation({
+      summary: `관리자 회원 가입 API`,
+    }),
+    ApiCreatedResponse({
+      description: 'Created',
+      schema: {
+        example: {
+          message: '성공적으로 관리자 계정이 생성되었습니다.',
+        },
+      },
+    }),
+    ApiBadRequestResponse({
+      description: 'Bad Request',
+      schema: {
+        example: {
+          message: '오류 메세지 출력',
+        },
+      },
+    }),
+    ApiConflictResponse({
+      description: 'Conflict',
+      schema: {
+        example: {
+          message: '이미 존재하는 계정입니다.',
+        },
+      },
+    }),
+  );
+}

server/src/account/account.api-docs.ts

@@ -0,0 +1,35 @@
+import {
+  Body,
+  Controller,
+  Inject,
+  Post,
+  UsePipes,
+  ValidationPipe,
+} from '@nestjs/common';
+import { AccountService } from './account.service';
+import { WINSTON_MODULE_PROVIDER } from 'nest-winston';
+import { Logger } from 'winston';
+import { RegisterAdminDto } from './dto/register-admin.dto';
+import { ApiTags } from '@nestjs/swagger';
+import { ApiPostRegisterAdmin } from './account.api-docs';
+import { ApiResponse } from '../common/response/common.response';
+
+@ApiTags('Account')
+@Controller()
+export class AccountController {
+  constructor(
+    private readonly loginService: AccountService,
+    @Inject(WINSTON_MODULE_PROVIDER) private readonly logger: Logger,
+  ) {}
+
+  @ApiPostRegisterAdmin()
+  @Post('/register/admin')
+  @UsePipes(ValidationPipe)
+  async registerAdmin(@Body() registerAdminDto: RegisterAdminDto) {
+    const result = await this.loginService.registerAdmin(registerAdminDto);
+    this.logger.info(`admin 등록: ${result.loginId}`);
+    return ApiResponse.responseWithNoContent(
+      '성공적으로 관리자 계정이 생성되었습니다.',
+    );
+  }
+}

server/src/account/account.controller.ts

@@ -0,0 +1,14 @@
+import { Module } from '@nestjs/common';
+import { AccountController } from './account.controller';
+import { AccountService } from './account.service';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { Admin } from './account.entity';
+import { AccountRepository } from './account.repository';
+import { winstonModule } from '../common/logger/logger.module';
+
+@Module({
+  imports: [winstonModule, TypeOrmModule.forFeature([Admin])],
+  controllers: [AccountController],
+  providers: [AccountService, AccountRepository],
+})
+export class AccountModule {}

server/src/login/login.entity.ts server/src/account/account.entity.ts

@@ -0,0 +1,21 @@
+import { Injectable } from '@nestjs/common';
+import { DataSource, Repository } from 'typeorm';
+import { Admin } from './account.entity';
+import { RegisterAdminDto } from './dto/register-admin.dto';
+
+@Injectable()
+export class AccountRepository extends Repository<Admin> {
+  constructor(private dataSource: DataSource) {
+    super(Admin, dataSource.createEntityManager());
+  }
+
+  async registerAdmin(registerAdminDto: RegisterAdminDto) {
+    const { loginId, password } = registerAdminDto;
+    const admin = this.create({
+      loginId,
+      password,
+    });
+    await this.save(admin);
+    return admin;
+  }
+}

server/src/account/account.module.ts

@@ -0,0 +1,26 @@
+import { ConflictException, Injectable } from '@nestjs/common';
+import type { RegisterAdminDto } from './dto/register-admin.dto';
+import { AccountRepository } from './account.repository';
+import * as bcrypt from 'bcrypt';
+
+@Injectable()
+export class AccountService {
+  constructor(private loginRepository: AccountRepository) {}
+
+  async registerAdmin(registerAdminDto: RegisterAdminDto) {
+    let { loginId, password } = registerAdminDto;
+
+    const existingAdmin = await this.loginRepository.findOne({
+      where: { loginId },
+    });
+
+    if (existingAdmin) {
+      throw new ConflictException('이미 존재하는 아이디입니다.');
+    }
+
+    const saltRounds = 10;
+    password = await bcrypt.hash(password, saltRounds);
+
+    return this.loginRepository.registerAdmin({ loginId, password });
+  }
+}

server/src/account/account.repository.ts

@@ -0,0 +1,35 @@
+import { IsString, Length, Matches } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+const PASSWORD_REG = /^(?=.*[!@#$%^&*()_+])[A-Za-z0-9!@#$%^&*()_+]+$/;
+
+export class RegisterAdminDto {
+  @ApiProperty({
+    example: 'minseokjo',
+    description: '관리자 로그인 아이디를 입력해주세요.',
+  })
+  @IsString({
+    message: '문자열을 입력해주세요',
+  })
+  @Length(6, 255, {
+    message: '아이디의 길이는 6자 이상, 255자 이하로 작성해주세요.',
+  })
+  loginId: string;
+
+  @ApiProperty({
+    example: 'heisgoat123!',
+    description:
+      '패스워드를 입력해주세요. (최소 6자, 영문/숫자/특수문자로 이루어질 수 있으며 특수문자 1개 이상 포함)',
+  })
+  @IsString({
+    message: '문자열을 입력해주세요',
+  })
+  @Matches(PASSWORD_REG, {
+    message:
+      '영문, 숫자, 특수문자로 이루어질 수 있으며 특수문자는 1개 이상 포함해주세요.',
+  })
+  @Length(6, 60, {
+    message: '패스워드의 길이는 6자 이상, 60자 이하로 작성해주세요.',
+  })
+  password: string;
+}

server/src/account/account.service.ts

@@ -3,6 +3,7 @@ import { winstonModule } from './common/logger/logger.module';
 import { TypeOrmModule } from '@nestjs/typeorm';
 import { ConfigModule, ConfigService } from '@nestjs/config';
 import { loadDBSetting } from './common/database/load.config';
+import { AccountModule } from './account/account.module';
 import { RedisModule } from './redis/redis.module';
 
 @Module({
@@ -20,6 +21,7 @@ import { RedisModule } from './redis/redis.module';
       useFactory: (configService: ConfigService) =>
         loadDBSetting(configService),
     }),
+    AccountModule,
     RedisModule,
   ],
   controllers: [],

server/src/account/dto/register-admin.dto.ts

@@ -6,6 +6,7 @@ import { GlobalExceptionsFilter } from './common/filters/global-exceptions.filte
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
   setupSwagger(app);
+  app.setGlobalPrefix('api');
   app.useGlobalFilters(new GlobalExceptionsFilter());
   await app.listen(process.env.PORT ?? 3000);
 }