2개 주요 서비스 그룹에 대한 통합 전환 계획서 작성:
1. **Phase 3.15: Batch Services** (24개 호출)
- 4개 배치 관련 서비스 통합 계획
- BatchExternalDbService (8개) - 외부 DB 연동
- BatchExecutionLogService (7개) - 실행 로그
- BatchManagementService (5개) - 배치 관리
- BatchSchedulerService (4개) - 스케줄러
주요 기술 요소:
- 외부 DB 연결 및 쿼리
- 트랜잭션 처리
- Cron 표현식 스케줄링
- 대용량 데이터 처리
- 연결 풀 관리
2. **Phase 3.16: Data Management Services** (18개 호출)
- 4개 데이터 관리 서비스 통합 계획
- EnhancedDynamicFormService (6개) - 고급 동적 폼
- DataMappingService (5개) - 데이터 매핑
- DataService (4개) - 동적 데이터 조회
- AdminService (3개) - 관리자 기능
주요 기술 요소:
- 복잡한 JSON 필드 처리
- 동적 테이블 쿼리 (보안)
- 재귀 CTE (계층 구조)
- JSON 집계 쿼리
- SQL 인젝션 방지
각 통합 계획서 포함 내용:
- 서비스별 상세 분석
- 통합 전환 전략 (Phase별)
- 상세 전환 예시 (Before/After)
- 기술적 고려사항
- 서비스별 체크리스트
- 통합 테스트 계획
- 예상 난이도 및 소요 시간
- 보안/성능 주의사항
메인 문서에 통합 계획서 링크 추가
서비스 그룹화로 가독성 향상
4개 주요 서비스에 대한 상세 전환 계획서 작성:
1. **Phase 3.11: DDLAuditLogger** (8개 호출)
- DDL 실행 감사 로그 관리
- 통계 쿼리 (GROUP BY, CASE WHEN, AVG)
- 동적 WHERE 조건
- JSON 필드 처리
- 날짜/시간 함수
2. **Phase 3.12: ExternalCallConfigService** (8개 호출)
- 외부 API 호출 설정 관리
- JSON 필드 (headers, params, auth_config)
- 민감 정보 암호화/복호화
- 동적 CRUD 쿼리
3. **Phase 3.13: EntityJoinService** (5개 호출)
- 엔티티 간 조인 관계 관리
- LEFT JOIN 쿼리
- 조인 유효성 검증
- 순환 참조 방지
4. **Phase 3.14: AuthService** (5개 호출)
- 사용자 인증 및 권한 관리
- 비밀번호 암호화/검증 (bcrypt)
- 세션 토큰 관리
- 보안 크리티컬
- SQL 인젝션 방지
각 계획서 포함 내용:
- 파일 정보 및 복잡도
- Prisma 사용 현황 분석
- 전환 전략 (단계별)
- 상세 전환 예시 (Before/After)
- 기술적 고려사항
- 전환 체크리스트
- 예상 난이도 및 소요 시간
- 보안/성능 주의사항
메인 문서에 계획서 링크 추가
6개 Prisma 호출을 모두 Raw Query로 전환
- JSON 필드 검색 (JSONB 연산자 활용)
- 동적 INSERT 쿼리 (PostgreSQL 플레이스홀더)
- 동적 UPDATE 쿼리 (WHERE 조건 + 플레이스홀더)
- 동적 DELETE 쿼리 (WHERE 조건)
- UPSERT 쿼리 (ON CONFLICT)
- 다이어그램 단건 조회 (findUnique → queryOne)
주요 기술적 해결:
- JSON 필드 검색 ($queryRaw → query)
- category::text = '"data-save"'
- category::jsonb ? 'data-save'
- category::jsonb @> '["data-save"]'
- MySQL 플레이스홀더(?) → PostgreSQL 플레이스홀더($1, $2, ...)
- 동적 테이블 INSERT/UPDATE/DELETE (보안 강화)
- ON CONFLICT를 사용한 UPSERT
- 조건부 실행 로직 유지
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 120/162 (74.1%)
전체 진행률: 371/444 (83.6%)
7개 Prisma 호출을 모두 Raw Query로 전환
- 템플릿 목록 조회 (getTemplates - 복잡한 OR 조건, Promise.all)
- 템플릿 단건 조회 (getTemplate)
- 템플릿 생성 (createTemplate - 중복 검사)
- 템플릿 수정 (updateTemplate - 동적 UPDATE, 11개 필드)
- 템플릿 삭제 (deleteTemplate)
- 정렬 순서 일괄 업데이트 (updateSortOrder - Promise.all)
- 카테고리 목록 조회 (getCategories - DISTINCT)
주요 기술적 해결:
- 복잡한 OR 조건 처리 (is_public OR company_code)
- 동적 WHERE 조건 생성 (ILIKE 다중 검색)
- 동적 UPDATE 쿼리 (11개 필드 조건부 업데이트)
- DISTINCT 쿼리 (카테고리 목록)
- Promise.all 병렬 쿼리 (목록 + 개수 동시 조회)
- Promise.all 병렬 업데이트 (정렬 순서 일괄 업데이트)
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 114/162 (70.4%)
전체 진행률: 365/444 (82.2%)
10개 Prisma 호출을 모두 Raw Query로 전환
- 카테고리 목록 조회 (getAllCategories)
- 카테고리 단건 조회 (getCategoryByTypeCode)
- 카테고리 생성 (createCategory - 중복 검사)
- 카테고리 수정 (updateCategory - 동적 UPDATE)
- 카테고리 삭제 (deleteCategory - 연결 확인 후 비활성화)
- 연결 통계 조회 (getConnectionStatsByType - LEFT JOIN + GROUP BY)
- 기본 카테고리 초기화 (initializeDefaultCategories - UPSERT)
주요 기술적 해결:
- ApiResponse 래퍼 패턴 유지
- 동적 UPDATE 쿼리 (5개 필드 조건부 업데이트)
- ON CONFLICT를 사용한 UPSERT (기본 카테고리 초기화)
- 연결 확인 (external_db_connections COUNT)
- LEFT JOIN + GROUP BY 통계 쿼리 최적화 (타입별 연결 수)
- 중복 검사 (카테고리 생성 시)
- try-catch 에러 처리 및 ApiResponse 반환
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 107/162 (66.0%)
전체 진행률: 358/444 (80.6%)
10개 Prisma 호출을 모두 Raw Query로 전환
- 레이아웃 목록 조회 (getLayouts - 복잡한 OR 조건, Promise.all)
- 레이아웃 단건 조회 (getLayoutById - OR 조건)
- 레이아웃 생성 (createLayout - JSON 필드)
- 레이아웃 수정 (updateLayout - 동적 UPDATE, 10개 필드)
- 레이아웃 삭제 (deleteLayout - Soft Delete)
- 레이아웃 복제 (duplicateLayout - 기존 함수 재사용)
- 카테고리별 통계 (getLayoutCountsByCategory - GROUP BY)
- 코드 자동 생성 (generateLayoutCode - LIKE 검색)
주요 기술적 해결:
- 복잡한 OR 조건 처리 (company_code OR is_public)
- 동적 WHERE 조건 생성 (ILIKE 다중 검색)
- 동적 UPDATE 쿼리 (10개 필드 조건부 업데이트)
- JSON 필드 처리 (default_size, layout_config, zones_config)
- GROUP BY 통계 쿼리 (카테고리별 개수)
- LIKE 검색 (코드 생성 시 패턴 검색)
- Promise.all 병렬 쿼리 (목록 + 개수 동시 조회)
- safeJSONStringify 헬퍼 함수 활용
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 97/162 (59.9%)
전체 진행률: 348/444 (78.4%)
CollectionService 전환 완료:
- 11개 Prisma 호출을 모두 Raw Query로 전환
- 수집 설정 CRUD (getCollectionConfigs, getCollectionConfigById, createCollectionConfig, updateCollectionConfig, deleteCollectionConfig)
- 수집 작업 관리 (executeCollection, getCollectionJobs, getCollectionHistory)
- 동적 WHERE 조건 생성 (ILIKE 검색, OR 조건)
- 동적 UPDATE 쿼리 (변경된 필드만 업데이트)
- JSON 필드 처리 (collection_options)
- LEFT JOIN (작업 목록 조회 시 설정 정보 포함)
- 비동기 작업 처리 (setTimeout 내 query 사용)
- 필드명 수정 (schedule_expression → schedule_cron)
- TypeScript 컴파일 성공
- Prisma import 완전 제거
Phase 3 남은 서비스 계획서 작성:
- PHASE3.7_LAYOUT_SERVICE_MIGRATION.md (10개 호출)
- 레이아웃 표준 관리 (CRUD, 통계, JSON 필드)
- PHASE3.8_DB_TYPE_CATEGORY_SERVICE_MIGRATION.md (10개 호출)
- DB 타입 카테고리 관리 (CRUD, 통계, UPSERT)
- PHASE3.9_TEMPLATE_STANDARD_SERVICE_MIGRATION.md (6개 호출)
- 템플릿 표준 관리 (복합 키, JSON 필드, DISTINCT)
Phase 3 진행률: 87/162 (53.7%)
전체 진행률: 338/444 (76.1%)
12개 Prisma 호출을 모두 Raw Query로 전환
- 관계도 목록 조회 (getDataflowDiagrams - 페이지네이션, ILIKE 검색)
- 관계도 단건 조회 (getDataflowDiagramById - 동적 WHERE)
- 관계도 생성 (createDataflowDiagram - JSON 필드)
- 관계도 수정 (updateDataflowDiagram - 동적 UPDATE, JSON 필드)
- 관계도 삭제 (deleteDataflowDiagram)
- 관계도 복제 (copyDataflowDiagram - LIKE 검색, 번호 증가)
- 버튼 제어용 조회 (getAllRelationshipsForButtonControl)
주요 기술적 해결:
- 동적 WHERE 조건 생성 (company_code 필터링)
- 동적 UPDATE 쿼리 (변경된 필드만 업데이트)
- JSON 필드 처리 (relationships, node_positions, control, category, plan)
- LIKE 검색 (복제 시 이름 패턴 검색)
- 복잡한 복제 로직 (자동 번호 증가)
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 76/162 (46.9%)
전체 진행률: 327/444 (73.6%)
10개 Prisma 호출을 모두 Raw Query로 전환
- 카테고리 관리 (getCategories, createCategory, updateCategory, deleteCategory)
- 코드 관리 (getCodes, createCode, updateCode, deleteCode)
- 코드 옵션 조회 (getCodeOptions)
- 코드 순서 변경 (reorderCodes)
- 중복 검사 (checkCategoryDuplicate, checkCodeDuplicate)
주요 기술적 해결:
- 동적 WHERE 조건 생성 (ILIKE 검색, OR 조건)
- 동적 UPDATE 쿼리 (변경된 필드만 업데이트)
- IN 절 동적 파라미터 바인딩 (reorderCodes)
- 트랜잭션 처리 (순서 변경)
- 동적 SQL 쿼리 생성 (중복 검사)
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 64/162 (39.5%)
전체 진행률: 315/444 (70.9%)
15개 Prisma 호출을 모두 Raw Query로 전환
- 컴포넌트 조회 (getComponents, getComponent)
- 컴포넌트 CRUD (createComponent, updateComponent, deleteComponent)
- 정렬 순서 업데이트 (updateSortOrder)
- 컴포넌트 복제 (duplicateComponent)
- 카테고리 조회 (getCategories)
- 통계 조회 (getStatistics)
- 중복 체크 (checkDuplicate)
주요 기술적 해결:
- 동적 WHERE 조건 생성 (ILIKE 검색, OR 조건)
- 동적 UPDATE 쿼리 (fieldMapping 사용)
- GROUP BY 집계 쿼리 (카테고리별, 상태별)
- DISTINCT 쿼리 (카테고리 목록)
- 트랜잭션 처리 (정렬 순서 업데이트)
- SQL 인젝션 방지 (정렬 컬럼 검증)
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 54/162 (33.3%)
전체 진행률: 305/444 (68.7%)
14개 Prisma 호출을 모두 Raw Query로 전환
- 배치 설정 CRUD
- 커넥션 및 테이블 조회
- 데이터 조회 및 삽입
- 실행 로그 관리
- 매핑 검증
주요 기술적 해결:
- 동적 WHERE 조건 생성
- 동적 UPDATE 쿼리
- 복잡한 트랜잭션 처리
- LEFT JOIN으로 배치 매핑 조회
- transaction 함수 사용
TypeScript 컴파일 성공
Prisma import 완전 제거
Phase 3 진행률: 39/162 (24.1%)
전체 진행률: 290/444 (65.3%)
25개 Prisma 호출을 모두 Raw Query로 전환
- 언어 관리 (getLanguages, createLanguage, updateLanguage, toggleLanguage, deleteLanguage)
- 다국어 키 관리 (getLangKeys, createLangKey, updateLangKey, deleteLangKey, toggleLangKey)
- 다국어 텍스트 관리 (getLangTexts, saveLangTexts, getUserText, getLangText)
- 배치 번역 조회 (getBatchTranslations)
주요 기술적 해결:
- 동적 WHERE 조건 생성 (ILIKE 검색 지원)
- 동적 UPDATE 쿼리 (변경된 필드만 업데이트)
- 트랜잭션 처리 (transaction 함수 사용)
- JOIN 쿼리 (multi_lang_text + multi_lang_key_master)
- IN 절 동적 파라미터 바인딩 (배치 번역)
TypeScript 컴파일 성공 (linter 에러 0개)
Prisma import 완전 제거
Phase 3 진행률: 25/162 (15.4%)
전체 진행률: 276/444 (62.2%)
Phase 2.4: DynamicFormService (13개) - 이미 완료되어 있었음
- ✅ 13개 Prisma 호출이 이미 Raw Query로 전환되어 있었음
- ✅ query() / queryOne() 함수 사용 확인
- ✅ 동적 UPSERT, 부분 UPDATE 구현 완료
- ✅ PostgreSQL 타입 자동 변환 로직 유지
- ✅ Prisma import 완전 제거 확인
전체 성과:
- Phase 2 진행률: 165/162 (101.9%) - **Phase 2 완료!** 🎉
- 전체 진행률: 251/444 (56.5%)
- Phase 2.3 ~ 2.6 모두 완료 확인
Phase 2.5: ExternalDbConnectionService (15개)
- 15개 Prisma 호출을 모두 Raw Query로 전환
- 동적 WHERE 조건 생성 및 동적 UPDATE 쿼리 구현
- 비밀번호 암호화/복호화 로직 유지
- ILIKE 검색 지원
Phase 2.6: DataflowControlService (6개)
- 6개 Prisma 호출을 모두 Raw Query로 전환
- 파라미터 바인딩 수정 (MySQL ? → PostgreSQL $1, $2)
- 복잡한 비즈니스 로직 및 다중 커넥션 지원 유지
- 조건부 실행, 에러 처리 로직 보존
전체 성과:
- TypeScript 컴파일 성공 (linter 에러 0개)
- Prisma import 완전 제거
- Phase 2 진행률: 152/162 (93.8%)
- 전체 진행률: 238/444 (53.6%)
- 15개 Prisma 호출을 모두 Raw Query로 전환
- 동적 WHERE 조건 생성 구현 (ILIKE 검색 지원)
- 동적 UPDATE 쿼리 구현 (변경된 필드만 업데이트)
- 비밀번호 암호화/복호화 로직 유지
- TypeScript 컴파일 성공 (linter 에러 0개)
- Prisma import 완전 제거
전환된 주요 함수:
- getConnections() - 외부 DB 연결 목록 조회
- createConnection() - 새 연결 생성 + 중복 확인
- updateConnection() - 연결 정보 수정
- deleteConnection() - 연결 삭제
- testConnectionById() - 연결 테스트
- getTables() - 테이블 목록 조회
Phase 2 진행률: 131/162 (80.9%)
전체 진행률: 217/444 (48.9%)
- 테이블 헤더 스타일링 개선 (더 진한 배경색, 오렌지 호버 효과)
- 파일첨부 컴포넌트 개선 (뚝뚝 잘리는 문제 해결, 패딩/아이콘 크기 조정)
- 카드 디스플레이 스타일링 개선 (명확한 테두리, 오렌지 호버 효과)
- 라벨 표시 기능 수정 (드롭다운 라벨링 문제, 체크박스 풀리는 문제 해결)
- 패널 및 레이아웃 개선 (카드 간격 통일, 주황색 영역 추가)
- CSS 통일성 작업 (Select 컴포넌트 너비 w-48로 조정)
- 정렬 화살표 표시 조건 수정 (정렬된 컬럼에서만 화살표 표시)
- 테이블 스타일링 통일 (SingleTableWithSticky, TableListComponent, InteractiveDataTable)
추가 전환 완료:
✅ 조회 및 관리 함수들:
- checkScreenDependencies() - 화면 의존성 확인 (JOIN 쿼리)
- cleanupDeletedScreenMenuAssignments() - 메뉴 할당 정리
- permanentDeleteScreen() - 영구 삭제 (트랜잭션)
- getDeletedScreens() - 휴지통 목록 조회 (페이징 + 테이블 레이블)
📊 진행률: 25+/46 (54%+)
🎯 다음: $queryRaw 함수들 전환 (테이블/컬럼 정보 조회)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Stage 4: 트랜잭션 기반 복잡한 기능 Raw Query 전환
✅ 전환 완료 (3개 트랜잭션 함수):
**트랜잭션 함수들:**
1. copyScreen() - 화면 복사 (화면 + 레이아웃 전체 복사)
- 원본 화면 조회 (SELECT)
- 화면 코드 중복 체크 (SELECT)
- 새 화면 생성 (INSERT RETURNING)
- 원본 레이아웃 조회 (SELECT with ORDER BY)
- ID 매핑 후 레이아웃 복사 (반복 INSERT)
- PoolClient 기반 트랜잭션 사용
2. restoreScreen() - 삭제된 화면 복원
- 화면 코드 중복 체크 (SELECT with multiple conditions)
- 화면 복원 (UPDATE with NULL 설정)
- 메뉴 할당 활성화 (UPDATE)
- 트랜잭션으로 원자성 보장
3. bulkDeletePermanently() - 일괄 영구 삭제
- 삭제 대상 조회 (SELECT with dynamic WHERE)
- 레이아웃 삭제 (DELETE)
- 메뉴 할당 삭제 (DELETE)
- 화면 정의 삭제 (DELETE)
- 각 화면마다 개별 트랜잭션으로 롤백 격리
📊 진행률: 20+/46 (43%+)
🎯 다음: 나머지 Prisma 호출 전환 (조회, UPSERT 등)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
추가 기본 조회 함수 Raw Query 전환
✅ 추가 전환 완료 (2개):
7. getScreens() - 전체 화면 목록 조회 (동적 WHERE)
8. getScreen() - 회사 코드 필터링 포함 조회
📊 진행률: 8/46 (17.4%)
🎯 다음: Stage 2 레이아웃 관리 전환
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
1단계 기본 CRUD 전환 시작 (2/6 완료)
✅ 전환 완료 (2개):
1. createScreen() - 화면 생성
- 중복 확인: findFirst → Raw Query SELECT
- 생성: create → Raw Query INSERT RETURNING
- 파라미터 바인딩 적용
2. getScreensByCompany() - 화면 목록 조회 (페이징)
- 동적 WHERE 절 생성
- Promise.all로 병렬 조회 (목록 + 총개수)
- table_labels IN 쿼리 전환
🔧 주요 변경사항:
- Prisma import 제거 → query, transaction import
- 파라미터 바인딩으로 SQL Injection 방지
- COUNT 결과 문자열 → 숫자 변환
📊 진행률:
- 전환 완료: 2/46 (4.3%)
- 남은 작업: 44개 Prisma 호출
🎯 다음 작업:
- getScreenByCode()
- getScreenById()
- updateScreen()
- deleteScreen()
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Phase 2 시작: ScreenManagementService 상세 분석 완료
📊 분석 결과:
- 총 46개 Prisma 호출 (Phase 2 최대)
- 파일: 1,805 라인
- 복잡도: 매우 높음
🔍 Prisma 사용:
- 화면 정의: 18개
- 레이아웃: 4개
- 템플릿: 2개
- 메뉴 할당: 5개
- 트랜잭션: 3개
📋 4단계 전환 계획:
1. 기본 CRUD (6함수)
2. 레이아웃 (3함수)
3. 템플릿&메뉴 (6함수)
4. 복잡한 기능 (4함수)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Phase 1.5 완료: 인증 서비스 Raw Query 전환 및 테스트 완료
✅ AuthService 전환 완료 (5개 Prisma 호출 제거):
- loginPwdCheck(): Raw Query로 사용자 비밀번호 조회
- insertLoginAccessLog(): Raw Query로 로그인 로그 기록
- getUserInfo(): Raw Query로 사용자/권한/회사 정보 조회
- authority_sub_user ↔ authority_master JOIN (master_objid ↔ objid)
- 3개 쿼리로 분리 (사용자, 권한, 회사)
- processLogin(): 전체 로그인 플로우 통합
- processLogout(): 로그아웃 로그 기록
🧪 테스트 완료:
- 단위 테스트: 30개 테스트 모두 통과 ✅
- 로그인 검증 (6개)
- 사용자 정보 조회 (5개)
- 로그인 로그 기록 (4개)
- 전체 로그인 프로세스 (5개)
- 로그아웃 (2개)
- 토큰 검증 (3개)
- Raw Query 전환 검증 (3개)
- 성능 테스트 (2개)
- 통합 테스트: 작성 완료 (auth.integration.test.ts)
- 로그인 → 토큰 발급 → 인증 → 로그아웃 플로우
🔧 주요 변경사항:
- Prisma import 제거 → Raw Query (query from db.ts)
- authority 테이블 JOIN 수정 (auth_code → master_objid/objid)
- 파라미터 바인딩으로 SQL Injection 방지
- 타입 안전성 유지 (TypeScript Generic 사용)
📊 성능:
- 로그인 프로세스: < 1초
- 사용자 정보 조회: < 500ms
- 모든 테스트 실행 시간: 2.016초
🎯 다음 단계:
- Phase 2: 핵심 서비스 전환 (ScreenManagement, TableManagement 등)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Phase 2 진행 전 인증/관리자 시스템 우선 전환 계획 수립
🔐 Phase 1.5 추가:
- AuthService 우선 전환 (5개 Prisma 호출)
- AdminService 확인 (이미 Raw Query 사용)
- AdminController 전환 (28개 Prisma 호출)
📋 변경 사항:
- Phase 1.5를 Phase 2보다 우선 실행하도록 계획 변경
- 인증/관리자 시스템을 먼저 안정화한 후 핵심 서비스 전환
- 로그인 → 인증 → API 호출 전체 플로우 검증
📚 새 문서:
- PHASE1.5_AUTH_MIGRATION_PLAN.md (상세 전환 계획)
- AuthService 전환 방법 및 코드 예시
- 단위 테스트 및 통합 테스트 계획
- 완료 체크리스트
🎯 목표:
- 전체 시스템의 안정적인 인증 기반 구축
- Phase 2 이후 모든 서비스가 안전하게 인증 시스템 사용
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
kjs
leeheejin
hyeonsu
dohyeons