chpark/wace_rps
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Phase 3.13 EntityJoinService Raw Query 전환 완료

Browse Source 
엔티티 조인 관계 관리 서비스의 모든 Prisma 호출을 Raw Query로 전환

전환 완료: 5개 Prisma 호출

1. detectEntityJoins - 엔티티 컬럼 감지
   - column_labels.findMany to query
   - web_type = entity 필터

2-3. validateJoinConfig - 테이블/컬럼 존재 확인
   - queryRaw to query
   - information_schema 조회

4-5. getReferenceTableColumns - 컬럼 정보/라벨 조회
   - queryRaw, findMany to query
   - 문자열 타입 컬럼 필터링

기술적 개선사항:
- information_schema 쿼리 파라미터 바인딩
- IS NOT NULL 조건 변환
- 타입 안전성 강화

문서: PHASE3.13_ENTITY_JOIN_SERVICE_MIGRATION.md
진행률: Phase 3 141/162 (87.0%)
This commit is contained in:
kjs
2025-10-01 12:10:34 +09:00
parent b4b4c774fb
commit 28eff9ecc1
3 changed files with 116 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PHASE3.13_ENTITY_JOIN_SERVICE_MIGRATION.md
+67 -16
View File
@@ -9,12 +9,12 @@ EntityJoinService는 **5개의 Prisma 호출**이 있으며, 엔티티 간 조
| 항목 | 내용 |
| --------------- | ------------------------------------------------ |
| 파일 위치 | `backend-node/src/services/entityJoinService.ts` |
| 파일 크기 | 574 라인 |
| Prisma 호출 | 5개 |
| **현재 진행률** | **0/5 (0%)** 🔄 **진행 예정** |
| 파일 크기 | 575 라인 |
| Prisma 호출 | 0개 (전환 완료) |
| **현재 진행률** | **5/5 (100%)** ✅ **전환 완료** |
| 복잡도 | 중간 (조인 쿼리, 관계 설정) |
| 우선순위 | 🟡 중간 (Phase 3.13) |
| **상태** | ⏳ **대기 중** |
| **상태** | ✅ **완료** |
### 🎯 전환 목표
@@ -32,23 +32,28 @@ EntityJoinService는 **5개의 Prisma 호출**이 있으며, 엔티티 간 조
### 주요 기능 (5개 예상)
#### 1. **엔티티 조인 목록 조회**
- findMany with filters
- 동적 WHERE 조건
- 페이징, 정렬
#### 2. **엔티티 조인 단건 조회**
- findUnique or findFirst
- join_id 기준
#### 3. **엔티티 조인 생성**
- create
- 조인 유효성 검증
#### 4. **엔티티 조인 수정**
- update
- 동적 UPDATE 쿼리
#### 5. **엔티티 조인 삭제**
- delete
---
@@ -56,6 +61,7 @@ EntityJoinService는 **5개의 Prisma 호출**이 있으며, 엔티티 간 조
## 💡 전환 전략
### 1단계: 기본 CRUD 전환 (5개)
- getEntityJoins() - 목록 조회
- getEntityJoin() - 단건 조회
- createEntityJoin() - 생성
@@ -69,6 +75,7 @@ EntityJoinService는 **5개의 Prisma 호출**이 있으며, 엔티티 간 조
### 예시 1: 조인 설정 조회 (LEFT JOIN으로 테이블 정보 포함)
**변경 전**:
```typescript
const joins = await prisma.entity_joins.findMany({
where: {
@@ -84,6 +91,7 @@ const joins = await prisma.entity_joins.findMany({
```
**변경 후**:
```typescript
const joins = await query<any>(
`SELECT
@@ -104,6 +112,7 @@ const joins = await query<any>(
### 예시 2: 조인 생성 (유효성 검증 포함)
**변경 전**:
```typescript
// 조인 유효성 검증
const sourceTable = await prisma.tables.findUnique({
@@ -131,17 +140,12 @@ const join = await prisma.entity_joins.create({
```
**변경 후**:
```typescript
// 조인 유효성 검증 (Promise.all로 병렬 실행)
const [sourceTable, targetTable] = await Promise.all([
queryOne<any>(
`SELECT * FROM tables WHERE table_id = $1`,
[sourceTableId]
),
queryOne<any>(
`SELECT * FROM tables WHERE table_id = $1`,
[targetTableId]
),
queryOne<any>(`SELECT * FROM tables WHERE table_id = $1`, [sourceTableId]),
queryOne<any>(`SELECT * FROM tables WHERE table_id = $1`, [targetTableId]),
]);
if (!sourceTable || !targetTable) {
@@ -162,6 +166,7 @@ const join = await queryOne<any>(
### 예시 3: 조인 수정
**변경 전**:
```typescript
const join = await prisma.entity_joins.update({
where: { join_id: joinId },
@@ -174,6 +179,7 @@ const join = await prisma.entity_joins.update({
```
**변경 후**:
```typescript
const updateFields: string[] = ["updated_at = NOW()"];
const values: any[] = [];
@@ -208,6 +214,7 @@ const join = await queryOne<any>(
## 🔧 기술적 고려사항
### 1. 조인 타입 검증
```typescript
const VALID_JOIN_TYPES = ["INNER", "LEFT", "RIGHT", "FULL"];
if (!VALID_JOIN_TYPES.includes(joinType)) {
@@ -216,6 +223,7 @@ if (!VALID_JOIN_TYPES.includes(joinType)) {
```
### 2. 조인 조건 검증
```typescript
// 조인 조건은 SQL 조건식 형태 (예: "source.id = target.parent_id")
// SQL 인젝션 방지를 위한 검증 필요
@@ -226,6 +234,7 @@ if (!isValidJoinCondition) {
```
### 3. 순환 참조 방지
```typescript
// 조인이 순환 참조를 만들지 않는지 검증
async function checkCircularReference(
@@ -238,13 +247,54 @@ async function checkCircularReference(
```
### 4. LEFT JOIN으로 관련 테이블 정보 조회
조인 설정 조회 시 source/target 테이블 정보를 함께 가져오기 위해 LEFT JOIN 사용
---
## 📝 전환 체크리스트
## ✅ 전환 완료 내역
### 전환된 Prisma 호출 (5개)
1. **`detectEntityJoins()`** - 엔티티 컬럼 감지 (findMany → query)
- column_labels 조회
- web_type = 'entity' 필터
- reference_table/reference_column IS NOT NULL
2. **`validateJoinConfig()`** - 테이블 존재 확인 ($queryRaw → query)
- information_schema.tables 조회
- 참조 테이블 검증
3. **`validateJoinConfig()`** - 컬럼 존재 확인 ($queryRaw → query)
- information_schema.columns 조회
- 표시 컬럼 검증
4. **`getReferenceTableColumns()`** - 컬럼 정보 조회 ($queryRaw → query)
- information_schema.columns 조회
- 문자열 타입 컬럼만 필터
5. **`getReferenceTableColumns()`** - 라벨 정보 조회 (findMany → query)
- column_labels 조회
- 컬럼명과 라벨 매핑
### 주요 기술적 개선사항
- **information_schema 쿼리**: 파라미터 바인딩으로 변경 ($1, $2)
- **타입 안전성**: 명확한 반환 타입 지정
- **IS NOT NULL 조건**: Prisma의 { not: null } → IS NOT NULL
- **IN 조건**: 여러 데이터 타입 필터링
### 코드 정리
- [x] PrismaClient import 제거
- [x] import 문 수정 완료
- [x] TypeScript 컴파일 성공
- [x] Linter 오류 없음
## 📝 원본 전환 체크리스트
### 1단계: Prisma 호출 전환 (✅ 완료)
### 1단계: Prisma 호출 전환
- [ ] `getEntityJoins()` - 목록 조회 (findMany with include)
- [ ] `getEntityJoin()` - 단건 조회 (findUnique)
- [ ] `createEntityJoin()` - 생성 (create with validation)
@@ -252,17 +302,20 @@ async function checkCircularReference(
- [ ] `deleteEntityJoin()` - 삭제 (delete)
### 2단계: 코드 정리
- [ ] import 문 수정 (`prisma` → `query, queryOne`)
- [ ] 조인 유효성 검증 로직 유지
- [ ] Prisma import 완전 제거
### 3단계: 테스트
- [ ] 단위 테스트 작성 (5개)
- [ ] 조인 유효성 검증 테스트
- [ ] 순환 참조 방지 테스트
- [ ] 통합 테스트 작성 (2개)
### 4단계: 문서화
- [ ] 전환 완료 문서 업데이트
---
@@ -273,11 +326,9 @@ async function checkCircularReference(
- LEFT JOIN 쿼리
- 조인 유효성 검증
- 순환 참조 방지
- **예상 소요 시간**: 1시간
---
**상태**: ⏳ **대기 중**
**특이사항**: LEFT JOIN, 조인 유효성 검증, 순환 참조 방지 포함