feat: description gen

kang-heewon · kang-heewon · commit 72922c048762 · 2025-09-13T21:24:14.000+09:00
diff --git a/.github/workflows/Deploy.yaml b/.github/workflows/Deploy.yaml
@@ -43,4 +43,4 @@ jobs:
           CLOUDINARY_API_KEY: ${{ secrets.CLOUDINARY_API_KEY }}
           CLOUDINARY_API_SECRET: ${{ secrets.CLOUDINARY_API_SECRET }}
           SERVERLESS_ACCESS_KEY: ${{ secrets.SERVERLESS_ACCESS_KEY }}
-
+          OPEN_ROUTER_API_KEY: ${{ secrets.OPEN_ROUTER_API_KEY }}
diff --git a/.github/workflows/Production.yaml b/.github/workflows/Production.yaml
@@ -48,3 +48,4 @@ jobs:
           CLOUDINARY_API_KEY: ${{ secrets.CLOUDINARY_API_KEY }}
           CLOUDINARY_API_SECRET: ${{ secrets.CLOUDINARY_API_SECRET }}
           SERVERLESS_ACCESS_KEY: ${{ secrets.SERVERLESS_ACCESS_KEY }}
+          OPEN_ROUTER_API_KEY: ${{ secrets.OPEN_ROUTER_API_KEY }}
diff --git a/.gitignore b/.gitignore
@@ -39,3 +39,4 @@ yarn-error.log*
 *.pem
 
 .idea
+.claude
diff --git a/apps/graphql-api/.env.sample b/apps/graphql-api/.env.sample
@@ -9,3 +9,4 @@ CLOUDINARY_CLOUD_NAME=
 CLOUDINARY_API_KEY=
 CLOUDINARY_API_SECRET=
 SENTRY_AUTH_TOKEN=
+OPEN_ROUTER_API_KEY=
diff --git a/apps/graphql-api/package.json b/apps/graphql-api/package.json
@@ -18,6 +18,7 @@
     "@darun/backend": "workspace:*",
     "@darun/provider-database": "workspace:*",
     "@darun/utils-apollo-server": "workspace:*",
+    "@darun/utils-llm": "workspace:*",
     "@darun/utils-sentry": "workspace:*",
     "@kang-heewon/esbuild-plugin-typescript-decorators": "0.1.0",
     "@sentry/aws-serverless": "10.8.0",
diff --git a/apps/graphql-api/serverless.yaml b/apps/graphql-api/serverless.yaml
@@ -64,4 +64,5 @@ functions:
       CLOUDINARY_CLOUD_NAME: ${env:CLOUDINARY_CLOUD_NAME}
       CLOUDINARY_API_KEY: ${env:CLOUDINARY_API_KEY}
       CLOUDINARY_API_SECRET: ${env:CLOUDINARY_API_SECRET}
+      OPEN_ROUTER_API_KEY: ${env:OPEN_ROUTER_API_KEY}
 
diff --git a/apps/graphql-api/src/app/graphql/product/Product.mutation.resolver.ts b/apps/graphql-api/src/app/graphql/product/Product.mutation.resolver.ts
@@ -13,6 +13,7 @@ import {
   UpvoteProduct,
   GetCompany,
   RegisterProductCompany,
+  GenerateProductDescription,
 } from '@darun/backend';
 import { AuthRole } from '@darun/utils-apollo-server';
 import { Arg, Authorized, Mutation, Resolver } from 'type-graphql';
@@ -21,6 +22,10 @@ import { AddProductLinkInput, AddProductLinkPayload } from './graphs/AddProductL
 import { AddProductScreenshotInput, AddProductScreenshotPayload } from './graphs/AddProductScreenshot';
 import { CreateProductInput, CreateProductPayload } from './graphs/CreateProduct';
 import { EditProductInput, EditProductPayload } from './graphs/EditProduct';
+import {
+  GenerateProductDescriptionInput,
+  GenerateProductDescriptionPayload,
+} from './graphs/GenerateProductDescription';
 import { IndexProductInput, IndexProductPayload } from './graphs/IndexProduct';
 import { Product } from './graphs/Product';
 import { PublishProductInput, PublishProductPayload } from './graphs/PublishProduct';
@@ -47,7 +52,8 @@ export class ProductMutationResolver {
     private readonly updateProductLinkUseCase: UpdateProductLink,
     private readonly updateAlternativeProductUseCase: UpdateAlternativeProduct,
     private readonly upvoteProductUseCase: UpvoteProduct,
-    private readonly registerProductCompanyUseCase: RegisterProductCompany
+    private readonly registerProductCompanyUseCase: RegisterProductCompany,
+    private readonly generateProductDescriptionUseCase: GenerateProductDescription
   ) {}
 
   @Authorized([AuthRole.Admin])
@@ -270,4 +276,24 @@ export class ProductMutationResolver {
       product: await this.getProductUseCase.execute({ slug }),
     };
   }
+
+  @Authorized([AuthRole.Admin])
+  @Mutation(() => GenerateProductDescriptionPayload)
+  async generateProductDescription(
+    @Arg('input') input: GenerateProductDescriptionInput
+  ): Promise<GenerateProductDescriptionPayload> {
+    const product = await this.getProductUseCase.execute({ slug: input.slug });
+
+    if (!product) {
+      throw new Error('Product not found');
+    }
+
+    const updatedProduct = await this.generateProductDescriptionUseCase.execute({
+      productId: product.id,
+    });
+
+    return {
+      product: updatedProduct,
+    };
+  }
 }
diff --git a/apps/graphql-api/src/app/graphql/product/graphs/GenerateProductDescription.ts b/apps/graphql-api/src/app/graphql/product/graphs/GenerateProductDescription.ts
@@ -0,0 +1,14 @@
+import { Field, InputType, ObjectType } from 'type-graphql';
+import { Product } from './Product';
+
+@InputType()
+export class GenerateProductDescriptionInput {
+  @Field(() => String)
+  slug: string;
+}
+
+@ObjectType()
+export class GenerateProductDescriptionPayload {
+  @Field(() => Product)
+  product: Product;
+}
diff --git a/apps/graphql-api/src/config/environment.ts b/apps/graphql-api/src/config/environment.ts
@@ -10,6 +10,7 @@ assert(process.env['MONGODB_URI'], 'MONGODB_URI not provided');
 assert(process.env['CLOUDINARY_CLOUD_NAME'], 'CLOUDINARY_CLOUD_NAME not provided');
 assert(process.env['CLOUDINARY_API_KEY'], 'CLOUDINARY_API_KEY not provided');
 assert(process.env['CLOUDINARY_API_SECRET'], 'CLOUDINARY_API_SECRET not provided');
+assert(process.env['OPENAI_API_KEY'], 'OPENAI_API_KEY not provided');
 
 export const IS_LOCAL = process.env['INFRA_ENV'] === 'local';
 export const RUNNING_ENV = process.env['RUNNING_ENV'] as 'development' | 'production';
@@ -21,3 +22,4 @@ export const MONGODB_URI = process.env['MONGODB_URI'];
 export const CLOUDINARY_CLOUD_NAME = process.env['CLOUDINARY_CLOUD_NAME'];
 export const CLOUDINARY_API_KEY = process.env['CLOUDINARY_API_KEY'];
 export const CLOUDINARY_API_SECRET = process.env['CLOUDINARY_API_SECRET'];
+export const OPENAI_API_KEY = process.env['OPENAI_API_KEY'];
diff --git a/apps/graphql-api/src/config/index.ts b/apps/graphql-api/src/config/index.ts
@@ -5,7 +5,11 @@ import './firebase';
 import './storage';
 import '@darun/backend/graphql-api';
 import { CloudinaryImageRepositoryConfig } from '@darun/backend';
+import { LlmClient } from '@darun/utils-llm/src/libs/LlmClient';
 import { Container } from 'typedi';
 import { RUNNING_ENV } from './environment';
 
 Container.set(CloudinaryImageRepositoryConfig, new CloudinaryImageRepositoryConfig(RUNNING_ENV));
+
+// LLM 서비스 등록
+Container.set(LlmClient, new LlmClient());
diff --git a/libs/backend/package.json b/libs/backend/package.json
@@ -20,6 +20,7 @@
   },
   "peerDependencies": {
     "@darun/provider-database": "workspace:*",
+    "@darun/utils-llm": "workspace:*",
     "@typegoose/typegoose": "12.11.0",
     "cloudinary": "2.4.0",
     "drizzle-orm": "0.32.1",
diff --git a/libs/backend/src/graphql-api.ts b/libs/backend/src/graphql-api.ts
@@ -5,6 +5,7 @@ export {
   PostgresqlProductScreenshotRepository,
   PostgresqlProductFeatureRepository,
   PostgresqlProductFeatureScreenshotRepository,
+  ProductDescriptionGeneratorImpl,
 } from './libs/products/datasource';
 export { FirebaseAccountRepository, PosgresqlProfileRepository } from './libs/accounts/datasource';
 export { PostgresqlCompanyRepository } from './libs/companies/datasource';
diff --git a/libs/backend/src/index.ts b/libs/backend/src/index.ts
@@ -20,6 +20,8 @@ export {
   PublishProduct,
   EditProduct,
   RegisterProductCompany,
+  GenerateProductDescription,
+  ProductDescriptionGeneratorToken,
 } from './libs/products/domain';
 export { GetAccount, GetProfile } from './libs/accounts/domain';
 export { GetCompany, CreateCompany, GetAllCompanies, SearchCompany } from './libs/companies/domain';
diff --git a/libs/backend/src/libs/products/datasource/index.ts b/libs/backend/src/libs/products/datasource/index.ts
@@ -4,3 +4,4 @@ export { PostgresqlProductTagRepository } from './repositories/PostgresqlProduct
 export { PostgresqlProductScreenshotRepository } from './repositories/PostgresqlProductScreenshotRepository';
 export { PostgresqlProductFeatureRepository } from './repositories/PostgresqlProductFeatureRepository';
 export { PostgresqlProductFeatureScreenshotRepository } from './repositories/PostgresqlProductFeatureScreenshotRepository';
+export { ProductDescriptionGeneratorImpl } from './services/ProductDescriptionGeneratorImpl';
diff --git a/libs/backend/src/libs/products/datasource/services/ProductDescriptionGeneratorImpl.ts b/libs/backend/src/libs/products/datasource/services/ProductDescriptionGeneratorImpl.ts
@@ -0,0 +1,63 @@
+import { LlmClient } from '@darun/utils-llm';
+import { Inject, Service } from 'typedi';
+import { Product } from '../../domain/entities/Product';
+import {
+  ProductDescriptionGenerator,
+  ProductDescriptionGeneratorToken,
+} from '../../domain/services/ProductDescriptionGenerator';
+
+@Service({ id: ProductDescriptionGeneratorToken })
+export class ProductDescriptionGeneratorImpl implements ProductDescriptionGenerator {
+  constructor(@Inject() private readonly llmClient: LlmClient) {}
+
+  async generate(product: Product): Promise<string> {
+    const systemPrompt = `당신은 신뢰할 수 있는 리뷰 에디터입니다.
+서비스/앱을 소개할 때, 다음 규칙을 반드시 따르세요.
+
+[문체 규칙]
+1. **객관적·사실 기반**으로 작성하세요. 개인적 감상이나 추측은 최소화하고, 실제 기능·조건·가격·제약·지원 환경 등 사실을 중심으로 씁니다.
+2. 불필요한 수식어나 과장된 표현("최고", "완벽하다")은 쓰지 않습니다.
+3. 문장은 **간결하고 단정적**으로 쓰며, 짧은 문단을 유지합니다.
+4. 문체는 **리뷰 기사형 에세이**처럼, 친근하지만 차분하고 정확하게 설명하는 톤을 유지합니다.
+5. 반드시 HTML 태그(\`<p>\`, \`<h2>\`, \`<ul>\`, \`<li>\`, \`<code>\`, \`<strong>\`)를 활용해 일관된 형식을 지킵니다.
+
+[구조 규칙]
+1. **도입부**:
+   - 일상적 맥락, 간단한 질문, 짧은 격언 등을 활용하여 흥미를 유도합니다.
+   - 소개할 서비스 이름을 \`<code>\` 태그로 표기하여 첫 문단에서 드러냅니다.
+
+2. **본문 섹션**:
+   - \`<h2>\` 제목과 함께 2~3개 이상의 기능 영역을 설명합니다.
+   - 기능 설명은 반드시 실제 제공 기능·작동 방식·조건을 사실적으로 기술합니다.
+   - 강조가 필요한 부분은 \`<strong>\`, 서비스명은 \`<code>\`로 표기합니다.
+
+3. **추천한다면 / 아쉽다면**:
+   - \`<h2>\` 제목은 각각 "추천한다면 -" / "아쉽다면 -"으로 고정합니다.
+   - \`<ul><li>\` 목록으로 장점과 단점을 나눠 작성합니다.
+   - 장점: 어떤 사용자에게 유용한지, 어떤 기능이 강점인지 **사실적으로** 씁니다.
+   - 단점: 결제 조건, 번역 문제, 기능 제약 등 실제 단점을 반드시 포함합니다.
+
+4. **마무리**:
+   - 전체 경험을 객관적으로 정리합니다.
+   - 마지막 문단에는 \`<em>YYYY년 M월 - Editor. DAO</em>\`로 반드시 서명합니다.
+
+5. **주석(선택)**:
+   - 참고 문헌이나 출처가 있을 경우, \`<strong>주.</strong>\` 블록으로 각주 형식으로 추가합니다.
+
+[추가 원칙]
+- 반드시 **사실 기반**으로 작성하세요. 추측, 과장, 모호한 의견은 배제합니다.
+- 기능이 없는 것을 추가하거나 없는 장점을 만들어내지 마세요.
+- 실제 서비스 조건(가격, 기기 연동, 번역 품질 등)을 반드시 반영하세요.`;
+
+    const userPrompt = `서비스명: ${product.name}
+
+위 정보를 바탕으로 서비스 리뷰를 작성해주세요.`;
+
+    const response = await this.llmClient.completion('openai/gpt-5-mini', [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userPrompt },
+    ]);
+
+    return response.content || '';
+  }
+}
diff --git a/libs/backend/src/libs/products/domain/index.ts b/libs/backend/src/libs/products/domain/index.ts
@@ -19,6 +19,9 @@ export { ProductScreenshot } from './entities/ProductScreenshot';
 export { ProductFeatureScreenshot } from './entities/ProductFeatureScreenshot';
 export { ProductFeature } from './entities/ProductFeature';
 
+export type { ProductDescriptionGenerator } from './services/ProductDescriptionGenerator';
+export { ProductDescriptionGeneratorToken } from './services/ProductDescriptionGenerator';
+
 export { GetRecentProducts } from './usecases/GetRecentProducts';
 export { GetProduct } from './usecases/GetProduct';
 export { GetProductLinks } from './usecases/GetProductLinks';
@@ -40,3 +43,4 @@ export { UpdateProductLink } from './usecases/UpdateProductLink';
 export { PublishProduct } from './usecases/PublishProduct';
 export { EditProduct } from './usecases/EditProduct';
 export { RegisterProductCompany } from './usecases/RegisterProductCompany';
+export { GenerateProductDescription } from './usecases/GenerateProductDescription';
diff --git a/libs/backend/src/libs/products/domain/services/ProductDescriptionGenerator.ts b/libs/backend/src/libs/products/domain/services/ProductDescriptionGenerator.ts
@@ -0,0 +1,8 @@
+import { Token } from 'typedi';
+import { Product } from '../entities/Product';
+
+export interface ProductDescriptionGenerator {
+  generate(product: Product): Promise<string>;
+}
+
+export const ProductDescriptionGeneratorToken = new Token<ProductDescriptionGenerator>('ProductDescriptionGenerator');
diff --git a/libs/backend/src/libs/products/domain/usecases/GenerateProductDescription.ts b/libs/backend/src/libs/products/domain/usecases/GenerateProductDescription.ts
@@ -0,0 +1,30 @@
+import { Inject, Service } from 'typedi';
+import { Product } from '../entities/Product';
+import { ProductRepository, ProductRepositoryToken } from '../repositories/ProductRepository';
+import { ProductDescriptionGenerator, ProductDescriptionGeneratorToken } from '../services/ProductDescriptionGenerator';
+
+@Service()
+export class GenerateProductDescription {
+  constructor(
+    @Inject(ProductRepositoryToken) private readonly productRepository: ProductRepository,
+    @Inject(ProductDescriptionGeneratorToken) private readonly productDescriptionGenerator: ProductDescriptionGenerator
+  ) {}
+
+  async execute({ productId }: { productId: string }): Promise<Product> {
+    const product = await this.productRepository.findOneById(productId);
+    if (!product) {
+      throw new Error('Product not found');
+    }
+
+    const generatedDescription = await this.productDescriptionGenerator.generate(product);
+
+    product.update({ description: generatedDescription });
+
+    const updatedProduct = await this.productRepository.updateById(product.id, () => product);
+    if (!updatedProduct) {
+      throw new Error('Failed to update product description');
+    }
+
+    return updatedProduct;
+  }
+}
diff --git a/libs/shared/utils-llm/package.json b/libs/shared/utils-llm/package.json
@@ -0,0 +1,21 @@
+{
+  "name": "@darun/utils-llm",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "lint": "eslint **/*.ts*",
+    "test": "echo 1",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "openai": "5.20.2"
+  },
+  "devDependencies": {
+    "@darun/eslint-config": "workspace:*",
+    "@darun/utils-tsconfig": "workspace:*",
+    "@types/react": "^18",
+    "@types/react-dom": "^18"
+  }
+}
diff --git a/libs/shared/utils-llm/src/constant.ts b/libs/shared/utils-llm/src/constant.ts
@@ -0,0 +1,5 @@
+import assert from 'assert';
+
+assert(process.env['OPEN_ROUTER_API_KEY'], 'OPEN_ROUTER_API_KEY not provided at utils-llm');
+
+export const OPEN_ROUTER_API_KEY = process.env['OPEN_ROUTER_API_KEY'];
diff --git a/libs/shared/utils-llm/src/index.ts b/libs/shared/utils-llm/src/index.ts
@@ -0,0 +1,2 @@
+export { LlmClient } from './libs/LlmClient';
+export type { LlmModel } from './libs/LlmModel';
diff --git a/libs/shared/utils-llm/src/libs/LlmClient.ts b/libs/shared/utils-llm/src/libs/LlmClient.ts
@@ -0,0 +1,19 @@
+import OpenAI from 'openai';
+import { OPEN_ROUTER_API_KEY } from '../constant';
+import { LlmModel } from './LlmModel';
+
+export class LlmClient {
+  private readonly openRouterClient = new OpenAI({
+    baseURL: 'https://openrouter.ai/api/v1',
+    apiKey: OPEN_ROUTER_API_KEY,
+  });
+
+  async completion(model: LlmModel, messages: { role: 'system' | 'user' | 'assistant'; content: string }[]) {
+    const completion = await this.openRouterClient.chat.completions.create({
+      model,
+      messages,
+    });
+
+    return completion.choices[0].message;
+  }
+}
diff --git a/libs/shared/utils-llm/src/libs/LlmModel.ts b/libs/shared/utils-llm/src/libs/LlmModel.ts
@@ -0,0 +1 @@
+export type LlmModel = 'openai/gpt-5-mini';
diff --git a/libs/shared/utils-llm/tsconfig.json b/libs/shared/utils-llm/tsconfig.json
@@ -0,0 +1,9 @@
+{
+  "extends": "@darun/utils-tsconfig/tsconfig.node.json",
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  }
+}
diff --git a/package.json b/package.json
@@ -13,6 +13,7 @@
   },
   "devDependencies": {
     "@darun/eslint-config": "workspace:*",
+    "@darun/utils-llm": "workspace:*",
     "@darun/utils-tsconfig": "workspace:*",
     "@types/node": "^20.14.10",
     "eslint": "8.57.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -39,3 +39,4 @@ yarn-error.log*`
`39`	`39`	`*.pem`
`40`	`40`
`41`	`41`	`.idea`
	`42`	`+.claude`