Feature/#22 주식 차트 데이터 조회 기능 추가

packages/backend/src/stock/decorator/stockData.decorator.ts

@@ -0,0 +1,35 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable max-lines-per-function */
+
+import { applyDecorators } from '@nestjs/common';
+import { ApiOperation, ApiParam, ApiQuery, ApiResponse } from '@nestjs/swagger';
+import { StockDataResponse } from '../dto/stockData.response';
+
+export function ApiGetStockData(summary: string, type: string) {
+  return applyDecorators(
+    ApiOperation({ summary }),
+    ApiParam({
+      name: 'stockId',
+      type: String,
+      description: '주식 ID',
+      example: 'A005930',
+    }),
+    ApiQuery({
+      name: 'lastStartTime',
+      required: false,
+      description: '마지막 시작 시간 (ISO 8601 형식)',
+      example: '2024-04-01T00:00:00.000Z',
+      type: String,
+      format: 'date-time',
+    }),
+    ApiResponse({
+      status: 200,
+      description: `주식의 ${type} 단위 데이터 성공적으로 조회`,
+      type: StockDataResponse,
+    }),
+    ApiResponse({
+      status: 404,
+      description: '주식 데이터가 존재하지 않음',
+    }),
+  );
+}

packages/backend/src/stock/domain/stockData.entity.ts

@@ -0,0 +1,161 @@
+import {
+  Entity,
+  PrimaryGeneratedColumn,
+  Column,
+  CreateDateColumn,
+  OneToOne,
+  JoinColumn,
+} from 'typeorm';
+import { Stock } from './stock.entity';
+
+@Entity('stock_minutely')
+export class StockMinutely {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  close: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  low: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  high: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  open: number;
+
+  @Column({ type: 'bigint' })
+  volume: number;
+
+  @Column({ type: 'timestamp', name: 'start_time' })
+  startTime: Date;
+
+  @OneToOne(() => Stock)
+  @JoinColumn({ name: 'stock_id' })
+  stock: Stock;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+}
+
+@Entity('stock_daily')
+export class StockDaily {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  close: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  low: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  high: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  open: number;
+
+  @Column({ type: 'bigint' })
+  volume: number;
+
+  @Column({ type: 'timestamp', name: 'start_time' })
+  startTime: Date;
+
+  @OneToOne(() => Stock)
+  @JoinColumn({ name: 'stock_id' })
+  stock: Stock;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+}
+@Entity('stock_weekly')
+export class StockWeekly {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  close: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  low: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  high: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  open: number;
+
+  @Column({ type: 'bigint' })
+  volume: number;
+
+  @Column({ type: 'timestamp', name: 'start_time' })
+  startTime: Date;
+
+  @OneToOne(() => Stock)
+  @JoinColumn({ name: 'stock_id' })
+  stock: Stock;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+}
+@Entity('stock_monthly')
+export class StockMonthly {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  close: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  low: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  high: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  open: number;
+
+  @Column({ type: 'bigint' })
+  volume: number;
+
+  @Column({ type: 'timestamp', name: 'start_time' })
+  startTime: Date;
+
+  @OneToOne(() => Stock)
+  @JoinColumn({ name: 'stock_id' })
+  stock: Stock;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+}
+@Entity('stock_yearly')
+export class StockYearly {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  close: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  low: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  high: number;
+
+  @Column({ type: 'decimal', precision: 15, scale: 2 })
+  open: number;
+
+  @Column({ type: 'bigint' })
+  volume: number;
+
+  @Column({ type: 'timestamp', name: 'start_time' })
+  startTime: Date;
+
+  @OneToOne(() => Stock)
+  @JoinColumn({ name: 'stock_id' })
+  stock: Stock;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+}

packages/backend/src/stock/dto/stockData.response.ts

@@ -0,0 +1,74 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+
+export class PriceDto {
+  @ApiProperty({
+    description: '시작 시간',
+    type: String,
+    format: 'date-time',
+    example: '2024-04-01T00:00:00.000Z',
+  })
+  startTime: Date;
+
+  @ApiProperty({
+    description: '시가',
+    example: '121.00',
+  })
+  open: number;
+
+  @ApiProperty({
+    description: '고가',
+    example: '125.00',
+  })
+  high: number;
+
+  @ApiProperty({
+    description: '저가',
+    example: '120.00',
+  })
+  low: number;
+
+  @ApiProperty({
+    description: '종가',
+    example: '123.45',
+  })
+  close: number;
+}
+
+export class VolumeDto {
+  @ApiProperty({
+    description: '시작 시간',
+    type: String,
+    format: 'date-time',
+    example: '2024-04-01T00:00:00.000Z',
+  })
+  startTime: Date;
+
+  @ApiProperty({
+    description: '거래량',
+    example: 1000,
+  })
+  volume: number;
+}
+
+export class StockDataResponse {
+  @ApiProperty({
+    description: '가격 데이터 배열 (날짜 오름차순)',
+    type: [PriceDto],
+  })
+  @Type(() => PriceDto)
+  priceDtoList: PriceDto[];
+
+  @ApiProperty({
+    description: '거래량 데이터 배열 (날짜 오름차순, 색 포함)',
+    type: [VolumeDto],
+  })
+  @Type(() => VolumeDto)
+  volumeDtoList: VolumeDto[];
+
+  @ApiProperty({
+    description: '스크롤해서 불러올 수 있는 데이터가 더 존재하는지',
+    example: true,
+  })
+  hasMore: boolean;
+}

packages/backend/src/stock/stock.controller.ts

@@ -1,6 +1,23 @@
-import { Body, Controller, Delete, HttpCode, Post } from '@nestjs/common';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  HttpCode,
+  Param,
+  Post,
+  Query,
+} from '@nestjs/common';
 import { ApiOkResponse, ApiOperation } from '@nestjs/swagger';
+import { ApiGetStockData } from './decorator/stockData.decorator';
 import { StockService } from './stock.service';
+import {
+  StockDataDailyService,
+  StockDataMinutelyService,
+  StockDataMonthlyService,
+  StockDataWeeklyService,
+  StockDataYearlyService,
+} from './stockData.service';
 import { StockViewsResponse } from '@/stock/dto/stock.Response';
 import { StockViewRequest } from '@/stock/dto/stockView.request';
 import {
@@ -11,7 +28,14 @@ import { UserStockResponse } from '@/stock/dto/userStock.response';
 
 @Controller('stock')
 export class StockController {
-  constructor(private readonly stockService: StockService) {}
+  constructor(
+    private readonly stockService: StockService,
+    private readonly stockDataMinutelyService: StockDataMinutelyService,
+    private readonly stockDataDailyService: StockDataDailyService,
+    private readonly stockDataWeeklyService: StockDataWeeklyService,
+    private readonly stockDataMonthlyService: StockDataMonthlyService,
+    private readonly stockDataYearlyService: StockDataYearlyService,
+  ) {}
 
   @HttpCode(200)
   @Post('/view')
@@ -80,4 +104,61 @@ export class StockController {
       '사용자 소유 주식을 삭제했습니다.',
     );
   }
+
+  @Get(':stockId/minutely')
+  @ApiGetStockData('주식 분 단위 데이터 조회 API', '분')
+  async getStockDataMinutely(
+    @Param('stockId') stockId: string,
+    @Query('lastStartTime') lastStartTime?: string,
+  ) {
+    return this.stockDataMinutelyService.getStockDataMinutely(
+      stockId,
+      lastStartTime,
+    );
+  }
+
+  @Get(':stockId/daily')
+  @ApiGetStockData('주식 일 단위 데이터 조회 API', '일')
+  async getStockDataDaily(
+    @Param('stockId') stockId: string,
+    @Query('lastStartTime') lastStartTime?: string,
+  ) {
+    return this.stockDataDailyService.getStockDataDaily(stockId, lastStartTime);
+  }
+
+  @Get(':stockId/weekly')
+  @ApiGetStockData('주식 주 단위 데이터 조회 API', '주')
+  async getStockDataWeekly(
+    @Param('stockId') stockId: string,
+    @Query('lastStartTime') lastStartTime?: string,
+  ) {
+    return this.stockDataWeeklyService.getStockDataWeekly(
+      stockId,
+      lastStartTime,
+    );
+  }
+
+  @Get(':stockId/mothly')
+  @ApiGetStockData('주식 월 단위 데이터 조회 API', '월')
+  async getStockDataMonthly(
+    @Param('stockId') stockId: string,
+    @Query('lastStartTime') lastStartTime?: string,
+  ) {
+    return this.stockDataMonthlyService.getStockDataMonthly(
+      stockId,
+      lastStartTime,
+    );
+  }
+
+  @Get(':stockId/yearly')
+  @ApiGetStockData('주식 연 단위 데이터 조회 API', '연')
+  async getStockDataYearly(
+    @Param('stockId') stockId: string,
+    @Query('lastStartTime') lastStartTime?: string,
+  ) {
+    return this.stockDataYearlyService.getStockDataYearly(
+      stockId,
+      lastStartTime,
+    );
+  }
 }

packages/backend/src/stock/stock.gateway.ts

@@ -8,7 +8,7 @@ import {
 import { Server, Socket } from 'socket.io';
 
 @WebSocketGateway({
-  path: '/stock',
+  namespace: '/stock/realtime',
 })
 export class StockGateway {
   @WebSocketServer()