# 📝 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()` 함수로 교체만 하면 됨

```typescript
// 기존
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개)

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

#### 2. screen_layouts 조회 (1개)

```typescript
// 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 코드:**

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

**새로운 Raw Query 코드:**

```typescript
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 코드:**

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

**새로운 Raw Query 코드:**

```typescript
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개)

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

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

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

```typescript
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()` 단순 교체 작업이 주요 작업