6.2 KiB

Raw Blame History

📝 Phase 2.4: DynamicFormService Raw Query 전환 계획

📋 개요

DynamicFormService는 13개의 Prisma 호출이 있습니다. 대부분(약 11개)은 $queryRaw를 사용하고 있어 SQL은 이미 작성되어 있지만, Prisma 클라이언트를 완전히 제거하려면 13개 모두를 db.ts의 query 함수로 교체해야 합니다.

📊 기본 정보

항목	내용
파일 위치	`backend-node/src/services/dynamicFormService.ts`
파일 크기	1,200+ 라인
Prisma 호출	13개 ($queryRaw: 11개, ORM: 2개)
현재 진행률	0/13 (0%) ⏳ 전환 필요
전환 필요	13개 모두 전환 필요 (SQL은 이미 작성되어 있음)
복잡도	낮음 (SQL 작성은 완료, `query()` 함수로 교체만 필요)
우선순위	🟢 낮음 (Phase 2.4)

🎯 전환 목표

✅ 13개 모든 Prisma 호출을 db.ts의 query() 함수로 교체
- 11개 $queryRaw → query() 함수로 교체
- 2개 ORM 메서드 → query() (SQL 새로 작성)
✅ 모든 단위 테스트 통과
✅ Prisma import 완전 제거

🔍 Prisma 사용 현황 분석

1. `$queryRaw` / `$queryRawUnsafe` 사용 (11개)

현재 상태: SQL은 이미 작성되어 있음 ✅
전환 작업: prisma.$queryRaw → query() 함수로 교체만 하면 됨

// 기존
await prisma.$queryRaw<Array<{ column_name; data_type }>>`...`;
await prisma.$queryRawUnsafe(upsertQuery, ...values);

// 전환 후
import { query } from "../database/db";
await query<Array<{ column_name: string; data_type: string }>>(`...`);
await query(upsertQuery, values);

2. ORM 메서드 사용 (2개)

현재 상태: Prisma ORM 메서드 사용
전환 작업: SQL 작성 필요

1. dynamic_form_data 조회 (1개)

// Line 867: 폼 데이터 조회
const result = await prisma.dynamic_form_data.findUnique({
  where: { id },
  select: { data: true },
});

2. screen_layouts 조회 (1개)

// Line 1101: 화면 레이아웃 조회
const screenLayouts = await prisma.screen_layouts.findMany({
  where: {
    screen_id: screenId,
    component_type: "widget",
  },
  select: {
    component_id: true,
    properties: true,
  },
});

📝 전환 예시

예시 1: dynamic_form_data 조회 전환

기존 Prisma 코드:

const result = await prisma.dynamic_form_data.findUnique({
  where: { id },
  select: { data: true },
});

새로운 Raw Query 코드:

import { queryOne } from "../database/db";

const result = await queryOne<{ data: any }>(
  `SELECT data FROM dynamic_form_data WHERE id = $1`,
  [id]
);

예시 2: screen_layouts 조회 전환

기존 Prisma 코드:

const screenLayouts = await prisma.screen_layouts.findMany({
  where: {
    screen_id: screenId,
    component_type: "widget",
  },
  select: {
    component_id: true,
    properties: true,
  },
});

새로운 Raw Query 코드:

import { query } from "../database/db";

const screenLayouts = await query<{
  component_id: string;
  properties: any;
}>(
  `SELECT component_id, properties 
   FROM screen_layouts 
   WHERE screen_id = $1 AND component_type = $2`,
  [screenId, "widget"]
);

🧪 테스트 계획

단위 테스트 (5개)

describe("DynamicFormService Raw Query 전환 테스트", () => {
  describe("getFormDataById", () => {
    test("폼 데이터 조회 성공", async () => { ... });
    test("존재하지 않는 데이터", async () => { ... });
  });

  describe("getScreenLayoutsForControl", () => {
    test("화면 레이아웃 조회 성공", async () => { ... });
    test("widget 타입만 필터링", async () => { ... });
    test("빈 결과 처리", async () => { ... });
  });
});

통합 테스트 (3개 시나리오)

describe("동적 폼 통합 테스트", () => {
  test("폼 데이터 UPSERT → 조회", async () => { ... });
  test("폼 데이터 업데이트 → 조회", async () => { ... });
  test("화면 레이아웃 조회 → 제어 설정 확인", async () => { ... });
});

📋 체크리스트

1단계: ORM 호출 전환 (2개 함수) ⏳ 진행 예정

getFormDataById() - dynamic_form_data.findUnique
getScreenLayoutsForControl() - screen_layouts.findMany

2단계: 테스트 & 검증 ⏳ 진행 예정

단위 테스트 작성 (5개)
통합 테스트 작성 (3개 시나리오)
Prisma import 완전 제거 확인
성능 테스트

🎯 완료 기준

13개 모든 Prisma 호출을 Raw Query로 전환 완료
- 11개 $queryRaw → query() 함수로 교체
- 2개 ORM 메서드 → query() 함수로 전환 (SQL 작성)
모든 TypeScript 컴파일 오류 해결
모든 단위 테스트 통과 (5개)
모든 통합 테스트 작성 완료 (3개 시나리오)
import prisma 완전 제거 및 import { query } from "../database/db" 사용
성능 저하 없음

💡 특이사항

SQL은 이미 거의 작성되어 있음

이 서비스는 이미 85%가 $queryRaw를 사용하고 있어, SQL 작성은 거의 완료되었습니다:

✅ UPSERT 로직: SQL 작성 완료 ($queryRawUnsafe 사용 중)
✅ 컬럼 정보 조회: SQL 작성 완료 ($queryRaw 사용 중)
✅ Primary Key 조회: SQL 작성 완료 (Raw Query 사용 중)
⏳ 전환 작업: prisma.$queryRaw → query() 함수로 단순 교체만 필요
⏳ 단순 조회: 2개만 SQL 새로 작성 필요 (매우 간단한 SELECT 쿼리)

작성일: 2025-09-30 예상 소요 시간: 0.5일 (SQL은 85% 작성 완료, 함수 교체 작업 필요) 담당자: 백엔드 개발팀 우선순위: 🟢 낮음 (Phase 2.4) 상태: ⏳ 진행 예정 특이사항: SQL은 거의 작성되어 있어 prisma.$queryRaw → query() 단순 교체 작업이 주요 작업

6.2 KiB Raw Blame History