feat: 통계용 콜백 API추가

package.json

@@ -1,6 +1,6 @@
 {
   "name": "shinnyang",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "",
   "author": {
     "name": "Medici",

src/app.module.ts

@@ -11,6 +11,7 @@ import { LetterModule } from './letters/letter.module';
 import { AppController } from './app.controller';
 import { PrometheusModule } from '@willsoto/nestjs-prometheus';
 import { MailsModule } from './mails/mails.module';
+import { StatisticsModule } from './statistics/statistics.module';
 @Module({
   imports: [
     PrometheusModule.register(),
@@ -39,6 +40,7 @@ import { MailsModule } from './mails/mails.module';
     CommonModule,
     LetterModule,
     MailsModule,
+    StatisticsModule,
   ],
   controllers: [AppController],
   providers: [],

src/statistics/dto/create-statistic.dto.ts

@@ -0,0 +1,39 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  IsEnum,
+  IsNumber,
+  IsOptional,
+  IsString,
+  IsUUID,
+} from 'class-validator';
+import { LETTER_TYPE } from 'src/letters/entities/letter.entity';
+
+export class CreateKakaoShareStatisticRequestDto {
+  @ApiProperty({
+    description: `    
+  카카오톡 공유 메세지가 전달된 채딩방의 타입
+  MemoChat: 나와의 채팅방
+  DirectChat: 다른 사용자와의 1:1 채팅방
+  MultiChat: 다른 사용자들과의 그룹 채팅방
+  OpenDirectChat: 1:1 오픈채팅방
+  OpenMultiChat: 그룹 오픈채팅방`,
+  })
+  @IsString()
+  CHAT_TYPE: string;
+  @ApiProperty()
+  @IsString()
+  HASH_CHAT_ID: string;
+  @ApiProperty()
+  @IsNumber()
+  TEMPLATE_ID: number;
+
+  @ApiProperty()
+  @IsOptional()
+  @IsUUID('all')
+  letterId?: string;
+
+  @ApiProperty({ description: '답장하기 일 경우, 답장하는 메일의 아이디' })
+  @IsOptional()
+  @IsEnum(LETTER_TYPE)
+  letterType?: LETTER_TYPE;
+}

src/statistics/entities/statistic.entity.ts

@@ -0,0 +1,33 @@
+import { BaseEntity } from 'src/common/entities/base.entity';
+import { LETTER_TYPE } from 'src/letters/entities/letter.entity';
+import { Column, Entity } from 'typeorm';
+
+@Entity({ name: 'KA_SHARE_ST' })
+export class KakaoShareCallbackStatistic extends BaseEntity {
+  @Column({
+    name: 'chat_type',
+    comment: `카카오톡 공유 메시지가 전달된 채팅방의 타입`,
+  })
+  chatType: string;
+
+  @Column({
+    name: 'hash_chat_id',
+    comment: '카카오톡 공유 메세지를 수신한 채팅방의 참고용 ID',
+  })
+  hashChatId: string;
+
+  @Column({ name: 'template_id', comment: '메세지 템플릿 ID' })
+  templateId: number;
+
+  @Column({ name: 'letter_id', type: 'uuid' })
+  letterId: string;
+
+  @Column({
+    name: 'letter_type',
+    comment: '편지 타입',
+    type: 'enum',
+    enum: LETTER_TYPE,
+    nullable: true,
+  })
+  letterType: LETTER_TYPE;
+}

src/statistics/statistics.controller.ts

@@ -0,0 +1,15 @@
+import { Controller, Post, Body } from '@nestjs/common';
+import { StatisticsService } from './statistics.service';
+import { CreateKakaoShareStatisticRequestDto } from './dto/create-statistic.dto';
+import { ApiTags } from '@nestjs/swagger';
+
+@Controller('statistics')
+@ApiTags('Statistics API')
+export class StatisticsController {
+  constructor(private readonly statisticsService: StatisticsService) {}
+
+  @Post('share/kakao')
+  create(@Body() createStatisticDto: CreateKakaoShareStatisticRequestDto) {
+    return this.statisticsService.create(createStatisticDto);
+  }
+}

src/statistics/statistics.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { StatisticsService } from './statistics.service';
+import { StatisticsController } from './statistics.controller';
+
+@Module({
+  controllers: [StatisticsController],
+  providers: [StatisticsService],
+})
+export class StatisticsModule {}

src/statistics/statistics.service.ts

@@ -0,0 +1,22 @@
+import { Injectable } from '@nestjs/common';
+import { InjectDataSource } from '@nestjs/typeorm';
+import { DataSource } from 'typeorm';
+import { CreateKakaoShareStatisticRequestDto } from './dto/create-statistic.dto';
+import { KakaoShareCallbackStatistic } from './entities/statistic.entity';
+
+@Injectable()
+export class StatisticsService {
+  constructor(@InjectDataSource() private readonly dataSource: DataSource) {}
+  async create(
+    createKakaoShareStatisticRequestDto: CreateKakaoShareStatisticRequestDto,
+  ) {
+    const repository = this.dataSource.getRepository(
+      KakaoShareCallbackStatistic,
+    );
+
+    await repository.save(
+      repository.create(createKakaoShareStatisticRequestDto),
+    );
+    return null;
+  }
+}