📝 docs: 파일 응답 dto 적용 및 문서 수정

Author: asn6878

server/src/file/api-docs/uploadProfileFile.api-docs.ts

@@ -40,34 +40,41 @@ export function ApiUploadProfileFile() {
           data: {
             type: 'object',
             properties: {
-              resultFile: {
-                type: 'object',
-                properties: {
-                  id: {
-                    type: 'string',
-                    example: 'uuid-string',
-                  },
-                  filename: {
-                    type: 'string',
-                    example: 'profile-image.jpg',
-                  },
-                  originalName: {
-                    type: 'string',
-                    example: 'my-photo.jpg',
-                  },
-                  mimeType: {
-                    type: 'string',
-                    example: 'image/jpeg',
-                  },
-                  size: {
-                    type: 'number',
-                    example: 1024000,
-                  },
-                  path: {
-                    type: 'string',
-                    example: '/uploads/profile/uuid-string.jpg',
-                  },
-                },
+              id: {
+                type: 'number',
+                example: 1,
+                description: '파일 ID',
+              },
+              originalName: {
+                type: 'string',
+                example: 'my-photo.jpg',
+                description: '원본 파일명',
+              },
+              mimetype: {
+                type: 'string',
+                example: 'image/jpeg',
+                description: '파일 MIME Type',
+              },
+              size: {
+                type: 'number',
+                example: 1024000,
+                description: '파일 크기 (bytes)',
+              },
+              url: {
+                type: 'string',
+                example: '/objects/profile/2024/01/profile-image.jpg',
+                description: '파일 접근 URL',
+              },
+              userId: {
+                type: 'number',
+                example: 123,
+                description: '업로드한 사용자 ID',
+              },
+              createdAt: {
+                type: 'string',
+                format: 'date-time',
+                example: '2024-01-01T12:00:00.000Z',
+                description: '업로드 날짜',
               },
             },
           },

server/src/file/controller/file.controller.ts

@@ -18,6 +18,7 @@ import { createDynamicStorage } from '../../common/disk/diskStorage';
 import { ApiResponse } from '../../common/response/common.response';
 import { ApiUploadProfileFile } from '../api-docs/uploadProfileFile.api-docs';
 import { ApiDeleteFile } from '../api-docs/deleteFile.api-docs';
+import { FileUploadResponseDto } from '../dto/createFile.dto';
 
 @ApiTags('File')
 @Controller('file')
@@ -33,14 +34,15 @@ export class FileController {
       throw new BadRequestException('파일이 선택되지 않았습니다.');
     }
 
-    const resultFile = await this.fileService.create(
+    const responseDto = await this.fileService.create(
       file,
       Number.parseInt(req.user.id),
     );
 
-    return ApiResponse.responseWithData('파일 업로드에 성공했습니다.', {
-      resultFile,
-    });
+    return ApiResponse.responseWithData(
+      '파일 업로드에 성공했습니다.',
+      responseDto,
+    );
   }
 
   // TODO: 권한검사 추가

server/src/file/dto/createFile.dto.ts

@@ -1,19 +1,24 @@
 import { ApiProperty } from '@nestjs/swagger';
-import { IsOptional, IsString, MaxLength } from 'class-validator';
 
 export class FileUploadResponseDto {
   @ApiProperty({ description: '파일 ID' })
   id: number;
 
-  @ApiProperty({ description: '저장된 파일명' })
-  filename: string;
+  @ApiProperty({ description: '원본 파일명' })
+  originalName: string;
 
   @ApiProperty({ description: '파일 MIME Type' })
-  mimeType: string;
+  mimetype: string;
 
   @ApiProperty({ description: '파일 크기 (bytes)' })
   size: number;
 
+  @ApiProperty({ description: '파일 접근 URL' })
+  url: string;
+
+  @ApiProperty({ description: '업로드한 사용자 ID' })
+  userId: number;
+
   @ApiProperty({ description: '업로드 날짜' })
   createdAt: Date;
 }

server/src/file/service/file.service.ts

@@ -3,12 +3,13 @@ import { File } from '../entity/file.entity';
 import { unlinkSync, existsSync } from 'fs';
 import { FileRepository } from '../repository/file.repository';
 import { User } from '../../user/entity/user.entity';
+import { FileUploadResponseDto } from '../dto/createFile.dto';
 
 @Injectable()
 export class FileService {
   constructor(private readonly fileRepository: FileRepository) {}
 
-  async create(file: any, userId: number) {
+  async create(file: any, userId: number): Promise<FileUploadResponseDto> {
     const { originalName, mimetype, size, path } = file;
 
     const savedFile = await this.fileRepository.save({
@@ -21,8 +22,13 @@ export class FileService {
     const accessUrl = this.generateAccessUrl(path);
 
     return {
-      ...savedFile,
+      id: savedFile.id,
+      originalName: savedFile.originalName,
+      mimetype: savedFile.mimetype,
+      size: savedFile.size,
       url: accessUrl,
+      userId: userId,
+      createdAt: savedFile.createdAt,
     };
   }