✅ 구현 내용:
1. 백엔드 API 추가
- GET /api/table-management/menu/:menuObjid/category-columns
- 형제 메뉴들의 테이블에서 카테고리 타입 컬럼 조회
- menuService.getSiblingMenuObjids() 재사용
2. 프론트엔드 CategoryWidget 수정
- menuObjid를 props로 받아 CategoryColumnList에 전달
- effectiveMenuObjid로 props.menuObjid도 처리
- 선택된 컬럼에 tableName 포함하여 상태 관리
3. CategoryColumnList 수정
- menuObjid 기반으로 형제 메뉴의 모든 카테고리 컬럼 조회
- 테이블명+컬럼명 함께 표시
- onColumnSelect에 tableName 전달
4. 메뉴 네비게이션 수정
- AppLayout.tsx: 화면 이동 시 menuObjid를 URL 쿼리 파라미터로 전달
- useMenu.ts: 동일하게 menuObjid 전달
- page.tsx: 자식 컴포넌트에도 menuObjid 전달
🎯 효과:
- 이제 형제 메뉴들이 서로 다른 테이블을 사용해도 카테고리 공유 가능
- 메뉴 클릭 → 화면 이동 시 자동으로 menuObjid 전달
- 카테고리 위젯이 형제 메뉴의 모든 카테고리 컬럼 표시
✅ 주요 변경사항:
- 백엔드: menuService.ts 추가 (형제 메뉴 조회 유틸리티)
- 백엔드: numberingRuleService.getAvailableRulesForMenu() 메뉴 스코프 적용
- 백엔드: tableCategoryValueService 메뉴 스코프 준비 (menuObjid 파라미터 추가)
- 프론트엔드: TextInputConfigPanel에 부모 메뉴 선택 UI 추가
- 프론트엔드: 메뉴별 채번규칙 필터링 (형제 메뉴 공유)
🔧 기술 세부사항:
- getSiblingMenuObjids(): 같은 부모를 가진 형제 메뉴 OBJID 조회
- 채번규칙 우선순위: menu (형제) > table > global
- 사용자 메뉴(menu_type='1') 레벨 2만 부모 메뉴로 선택 가능
📝 다음 단계:
- 카테고리 컴포넌트도 메뉴 스코프로 전환 예정
- 메뉴 클릭 시 localStorage에 메뉴 이름 저장 (useMenu, AppLayout)
- 엑셀 다운로드 시 localStorage의 메뉴 이름을 파일명으로 사용
- 백엔드 카테고리 컬럼 조회 쿼리 파라미터 버그 수정
- API 호출 시 불필요한 autoFilter 파라미터 제거
파일명 형식: {메뉴이름}_{날짜}.xlsx
예시: 품목등록테스트_2025-11-11.xlsx
- writer 컬럼이 있는 테이블에서 자동으로 user_name 표시
- 백엔드: entityJoinService에서 writer 컬럼 감지 및 user_info 조인
- 프론트엔드: entityJoinApi 항상 사용 및 writer_name 자동 표시
- 디버깅 로그 제거
- 문제: 테이블 리스트에서 writer 컬럼이 user_id로 표시됨
- 해결:
1. 백엔드: entityJoinService에서 writer 컬럼 자동 감지
2. writer 컬럼 발견 시 user_info 테이블과 자동 조인
3. writer_name 별칭으로 user_name 반환
4. 프론트엔드: writer 컬럼일 때 writer_name 우선 표시
- 영향:
- writer 컬럼이 있는 모든 테이블에서 자동으로 작성자명 표시
- 기존 entity 조인 설정과 충돌 없이 작동
- column_labels 설정 불필요
- 채번 규칙 scope_type을 table로 단순화
- 화면의 테이블명을 자동으로 감지하여 채번 규칙 필터링
- TextInputConfigPanel에 screenTableName prop 추가
- getAvailableNumberingRulesForScreen API로 테이블 기반 조회
- NumberingRuleDesigner에서 자동으로 테이블명 설정
- webTypeConfigConverter 유틸리티 추가 (기존 화면 호환성)
- AutoGenerationConfig 타입 개선 (enabled, options.numberingRuleId)
- 채번 규칙 선택 UI에서 ID 제거, 설명 추가
- 불필요한 console.log 제거
Backend:
- numberingRuleService: 테이블 기반 필터링 로직 구현
- numberingRuleController: available-for-screen 엔드포인트 수정
Frontend:
- TextInputConfigPanel: 테이블명 기반 채번 규칙 로드
- NumberingRuleDesigner: 적용 범위 UI 제거, 테이블명 자동 설정
- ScreenDesigner: webTypeConfig → autoGeneration 변환 로직 통합
- DetailSettingsPanel: autoGeneration 속성 매핑 개선
주요 변경사항:
- 격자 설정을 편집 탭에서 항상 표시 (해상도 설정 하단)
- 그리드 컬럼 수 동적 조정 가능 (1-24)
- 컴포넌트 생성 시 현재 그리드 컬럼 수 기반 자동 계산
- 컴포넌트 너비가 설정한 컬럼 수대로 정확히 표시되도록 수정
수정된 파일:
- ScreenDesigner: 컴포넌트 드롭 시 gridColumns와 style.width 동적 계산
- UnifiedPropertiesPanel: 격자 설정 UI 통합, 차지 컬럼 수 설정 시 width 자동 계산
- RealtimePreviewDynamic: getWidth 우선순위 수정, DOM 크기 디버깅 로그 추가
- 8개 컴포넌트: componentStyle.width를 항상 100%로 고정
* ButtonPrimaryComponent
* TextInputComponent
* NumberInputComponent
* TextareaBasicComponent
* DateInputComponent
* TableListComponent
* CardDisplayComponent
문제 해결:
- 컴포넌트 내부에서 component.style.width를 재사용하여 이중 축소 발생
- 해결: 부모 컨테이너(RealtimePreviewDynamic)가 width 제어, 컴포넌트는 항상 100%
- 결과: 파란 테두리와 내부 콘텐츠가 동일한 크기로 정확히 표시
🐛 버그 수정
- dynamicFormService.ts에서 ExecutionResult 타입 오류 해결
- executedNodes → nodes로 속성명 변경
- errors 속성을 nodes에서 추출하도록 수정
🔧 변경 내용
- executionResult.nodes를 사용하여 executedActions 생성
- 실패한 노드를 필터링하여 errors 배열 생성
- TypeScript 컴파일 오류 해결
📝 관련 이슈
- TS2339: Property 'executedNodes' does not exist on type 'ExecutionResult'
- TS2339: Property 'errors' does not exist on type 'ExecutionResult'
- frontend: screen.ts에 saveScreenLayout 함수 추가 (ScreenDesigner_new.tsx가 호출하던 누락된 함수)
- frontend: ScreenDesigner_new.tsx 저장 시 디버깅 로그 추가
- backend: screenManagementService.ts에 dataflowConfig 저장 확인 로그 추가
문제 원인:
- ScreenDesigner_new.tsx가 호출하던 screenApi.saveScreenLayout 함수가 정의되지 않음
- 이로 인해 레이아웃 저장이 실패했을 가능성
해결:
- saveScreenLayout 함수를 추가하여 정상적인 레이아웃 저장 가능
- 디버깅 로그를 통해 실제로 selectedDiagramId가 저장되는지 확인 가능
프론트엔드:
- ImprovedButtonControlConfigPanel에서 selectedDiagramId 저장 추가
- 플로우 선택 시 flowConfig와 함께 selectedDiagramId도 저장
- selectedRelationshipId는 null로 설정 (노드 플로우는 관계 불필요)
백엔드:
- dynamicFormService에서 relationshipId 유무에 따라 실행 방식 분기
- relationshipId가 없으면 NodeFlowExecutionService.executeFlow() 실행
- relationshipId가 있으면 기존 dataflowControlService.executeDataflowControl() 실행
- 노드 플로우 실행 시 formData를 contextData로 전달
원인:
- 기존에는 flowConfig만 저장하고 selectedDiagramId를 저장하지 않음
- 백엔드에서 selectedDiagramId가 없어서 제어관리 실행 조건 불만족
- 관계 기반 제어와 노드 플로우를 구분하지 못함
- 외부 커넥션 관리 테이블 표준화 (DB 연결, REST API 연결)
- 모든 관리자 테이블의 그림자 제거 (테이블 타입 관리 왼쪽 카드 제외)
- 테이블 타입 관리 왼쪽 카드 호버 효과 강화 (shadow-lg, bg-muted/20)
- 탭 컴포넌트 배경색 밝게 조정 (bg-muted/30)
- 탭 트리거 테두리 제거
; Please enter a commit message to explain why this merge is necessary,
; especially if it merges an updated upstream into a topic branch.
;
; Lines starting with ';' will be ignored, and an empty message aborts
; the commit.
; Please enter a commit message to explain why this merge is necessary,
; especially if it merges an updated upstream into a topic branch.
;
; Lines starting with ';' will be ignored, and an empty message aborts
; the commit.
; Please enter a commit message to explain why this merge is necessary,
; especially if it merges an updated upstream into a topic branch.
;
; Lines starting with ';' will be ignored, and an empty message aborts
; the commit.
충돌 해결:
- CanvasElement.tsx: CustomMetricWidget(main) + 통합 TaskWidget(lhj) 모두 유지
- DashboardTopMenu.tsx: lhj의 '일정관리 위젯' 유지
- DashboardSidebar.tsx: main의 삭제 수락
; Please enter a commit message to explain why this merge is necessary,
; especially if it merges an updated upstream into a topic branch.
;
; Lines starting with ';' will be ignored, and an empty message aborts
; the commit.
- DashboardViewer에 ListSummaryWidget 연결
- list 위젯이 실제 DB 데이터 표시하도록 수정
- ITS_API_KEY (국토교통부 교통사고 API) 추가
- KMA_API_KEY (기상청 특보 API) 재적용
- dashboard.ts API URL 수정 (/api로 통일)
- 노드 에디터 UI 구현 (React Flow 기반)
- TableSource, DataTransform, INSERT, UPDATE, DELETE, UPSERT 노드
- 드래그앤드롭 노드 추가 및 연결
- 속성 패널을 통한 노드 설정
- 실시간 필드 라벨 표시 (column_labels 테이블 연동)
- 데이터 변환 노드 (DataTransform) 기능
- EXPLODE: 구분자로 1개 행 → 여러 행 확장
- UPPERCASE, LOWERCASE, TRIM, CONCAT, SPLIT, REPLACE 등 12가지 변환 타입
- In-place 변환 지원 (타겟 필드 생략 시 소스 필드 덮어쓰기)
- 변환된 필드가 하위 액션 노드에 자동 전달
- 노드 플로우 실행 엔진
- 위상 정렬을 통한 노드 실행 순서 결정
- 레벨별 병렬 실행 (Promise.allSettled)
- 부분 실패 허용 (한 노드 실패 시 연결된 하위 노드만 스킵)
- 트랜잭션 기반 안전한 데이터 처리
- UPSERT 액션 로직 구현
- DB 제약 조건 없이 SELECT → UPDATE or INSERT 방식
- 복합 충돌 키 지원 (예: sales_no + product_name)
- 파라미터 인덱스 정확한 매핑
- 데이터 소스 자동 감지
- 테이블 선택 데이터 (selectedRowsData) 자동 주입
- 폼 입력 데이터 (formData) 자동 주입
- TableSource 노드가 외부 데이터 우선 사용
- 버튼 컴포넌트 통합
- 기존 관계 실행 + 새 노드 플로우 실행 하이브리드 지원
- 노드 플로우 선택 UI 추가
- API 클라이언트 통합 (Axios)
- 개발 문서 작성
- 노드 기반 제어 시스템 개선 계획
- 노드 연결 규칙 설계
- 노드 실행 엔진 설계
- 노드 구조 개선안
- 버튼 통합 분석
- menu, company, screenMng, i18n, tableMng 모듈 console 주석 처리
- 총 55개 파일 수정
- 빌드 에러 수정 완료
- 백엔드 서버 정상 작동 확인
관련 파일:
- frontend/components/admin/MenuManagement.tsx
- frontend/components/admin/MenuFormModal.tsx
- frontend/components/admin/ScreenAssignmentTab.tsx
- frontend/components/admin/CompanyTable.tsx
- frontend/components/admin/MultiLang.tsx
- frontend/app/(main)/admin/tableMng/page.tsx
- 기타 screen 관련 컴포넌트 49개 파일
문제:
- Oracle DB에 INSERT 해도 데이터가 실제로 저장되지 않음
- executeQuery에서 autoCommit 옵션이 없었음
수정:
1. 쿼리 타입 확인 (INSERT/UPDATE/DELETE/MERGE)
2. DML 쿼리는 autoCommit: true 설정 ✅
3. SELECT 쿼리는 autoCommit: false (기본값)
로깅 추가:
- isDML 확인
- autoCommit 상태
- rowsAffected 추가
결과:
- ✅ INSERT 실행 후 자동 COMMIT
- ✅ UPDATE/DELETE도 자동 COMMIT
- ✅ SELECT는 영향 없음
- ✅ 오라클 데이터 정상 저장
문제:
- UPDATE 액션 실행 시 ID 필요 에러
- executeUpdate가 하드코딩된 id 필드만 찾음
- 실제 테이블 기본키는 다를 수 있음
해결:
1. 테이블 기본키 동적 조회
2. 기본키 값 동적 추출
3. 동적 UPDATE 쿼리 생성
4. 상세 로깅 추가
결과:
- 모든 테이블의 UPDATE 동작
- 동적 기본키 처리
문제:
- query() 함수에 스프레드 연산자로 파라미터 전달
- pg 라이브러리는 배열을 요구함
- 'Query values must be an array' 에러 발생
수정:
tableManagementService.ts (2곳):
- line 1501: query(...searchValues) → query(searchValues)
- line 1512: query(...searchValues, size, offset)
→ query([...searchValues, size, offset])
결과:
- ✅ 쿼리 파라미터 배열로 정확히 전달
- ✅ 테이블 데이터 조회 정상 동작
변경된 파일:
1. DOCKER.md:
- 기술 스택: Prisma → PostgreSQL (Raw Query)
- Prisma 관련 섹션 제거
- 데이터베이스 관련 섹션으로 교체
- 프로젝트 구조: prisma/ → database/
2. backend-node/Dockerfile.win:
- npx prisma generate 명령 제거
- Prisma 클라이언트 생성 단계 삭제
3. backend-node/README.md:
- ORM: Prisma → Database: PostgreSQL (Raw Query with pg)
- 프로젝트 구조: prisma/ → database/
- Prisma 클라이언트 생성 단계 제거
- npx prisma studio 스크립트 제거
- 데이터베이스 스키마 변경 가이드 업데이트
- Phase 1 체크리스트: Prisma → Raw Query
문서 정리 완료:
- ✅ Docker 가이드 업데이트
- ✅ Dockerfile Prisma 명령 제거
- ✅ README 기술 스택 업데이트
- ✅ 개발 가이드 Raw Query로 변경
최종 작업:
1. config/database.ts 삭제:
- Prisma 기반 database.ts 완전 제거
- 더 이상 사용되지 않는 파일
2. referenceCacheService.ts 전환 (3개):
- ✅ getTableRowCount: $queryRawUnsafe → query
- ✅ cacheReferenceTable: $queryRawUnsafe → query
- ✅ batchLookup: $queryRaw → query (ANY 연산자)
전체 완료:
- ✅ 모든 Prisma 호출 전환 완료
- ✅ PrismaClient import 완전 제거 (에러핸들러 제외)
- ✅ database.ts 삭제
- ✅ Raw Query 기반 시스템으로 완전 전환
최종 진행률: 54/54 (100%) 🎉
문제:
- 로컬 변수 'query'와 import한 함수 'query'가 충돌
- TypeScript 에러: 'query' is used before being assigned
해결:
- 로컬 변수 'query'를 'sql'로 변경
- SELECT 쿼리 문자열 변수명 통일 (query → sql)
영향:
- executeMainDbOperation의 select case만 수정
- insert, update, delete는 이미 고유한 변수명 사용
문제:
- pool이 null일 수 있다는 TypeScript 에러 발생
- pool.connect()를 직접 사용하는 것은 안전하지 않음
해결:
- pool import를 transaction으로 변경
- 수동 트랜잭션 관리 코드를 transaction 함수로 교체
- BEGIN/COMMIT/ROLLBACK 자동 처리
- 파라미터 개수 최적화 (updated_date를 NOW()로 변경)
장점:
- 타입 안전성 향상
- 에러 처리 자동화
- 코드 간소화
문제:
- buttonActionStandardController에서 pool을 import하려 했으나
- db.ts에서 pool이 export되지 않아 컴파일 에러 발생
해결:
- db.ts에 'export { pool }' 추가
- pool 직접 접근이 필요한 경우를 위해 명시적 export
영향받는 파일:
- backend-node/src/database/db.ts
- backend-node/src/controllers/buttonActionStandardController.ts (사용)
현재 상황 분석 및 문서화:
컨트롤러 레이어:
- ✅ adminController.ts (28개) 완료
- ✅ screenFileController.ts (2개) 완료
- 🔄 남은 파일 (12개 호출):
* webTypeStandardController.ts (11개)
* fileController.ts (1개)
Routes & Services:
- ddlRoutes.ts (2개)
- companyManagementRoutes.ts (2개)
- multiConnectionQueryService.ts (4개)
Config:
- database.ts (4개 - 제거 예정)
새로운 계획서:
- PHASE4_REMAINING_PRISMA_CALLS.md (상세 전환 계획)
- 파일별 Prisma 호출 상세 분석
- 전환 패턴 및 우선순위 정리
전체 진행률: 445/444 (100.2%)
남은 작업: 12개 (추가 조사 필요한 파일 제외)
batch_mappings 테이블의 실제 컬럼명으로 수정:
- field_name → from_column_name, to_column_name
- source_field → from_table_name, to_table_name
- 전체 컬럼 구조를 실제 DB 스키마에 맞게 수정
수정된 함수:
- loadActiveBatchConfigs()
- updateBatchSchedule()
에러 해결: column bm.field_name does not exist
4개 서비스 18개 Prisma 호출 전환 완료:
1. **EnhancedDynamicFormService** (6개)
- validateTableExists - information_schema 조회
- getTableColumns - 테이블 컬럼 정보 조회 with 캐싱
- getColumnWebTypes - 웹타입 정보 조회
- getPrimaryKeys - Primary Key 조회
- performInsert - 동적 INSERT with RETURNING
- performUpdate - 동적 UPDATE with RETURNING
2. **DataMappingService** (5개)
- getSourceData - 소스 테이블 데이터 조회
- executeInsert - 동적 INSERT
- executeUpsert - ON CONFLICT DO UPDATE
- executeUpdate - 동적 UPDATE
- disconnect - 제거 (Raw Query 불필요)
3. **DataService** (4개)
- getTableData - 동적 SELECT with 동적 WHERE/ORDER BY
- checkTableExists - information_schema 테이블 존재 확인
- getTableColumnsSimple - 컬럼 정보 조회
- getColumnLabel - 컬럼 라벨 조회
4. **AdminService** (3개)
- getAdminMenuList - WITH RECURSIVE 쿼리
- getUserMenuList - WITH RECURSIVE 쿼리
- getMenuInfo - LEFT JOIN으로 회사 정보 포함
기술적 성과:
- 변수명 충돌 해결 (query vs sql)
- WITH RECURSIVE 쿼리 전환
- Prisma include → LEFT JOIN 전환
- 동적 쿼리 생성 (WHERE, ORDER BY)
- SQL 인젝션 방지 (컬럼명 검증)
진행률: Phase 3 173/186 (93.0%)
문서: PHASE3.16_DATA_MANAGEMENT_SERVICES_MIGRATION.md
엔티티 조인 관계 관리 서비스의 모든 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%)
외부 호출 설정 관리 서비스의 모든 Prisma 호출을 Raw Query로 전환:
## 전환 완료 (8개 Prisma 호출)
1. **getConfigs()** - 목록 조회
- prisma.findMany → query<ExternalCallConfig>()
- 동적 WHERE 조건 (5개 필터)
- ILIKE 검색 (config_name, description)
2. **getConfigById()** - 단건 조회
- prisma.findUnique → queryOne<ExternalCallConfig>()
3-4. **createConfig()** - 생성
- 중복 검사: prisma.findFirst → queryOne()
- 생성: prisma.create → queryOne() with INSERT RETURNING
- JSON 필드 처리: config_data
5-6. **updateConfig()** - 수정
- 중복 검사: prisma.findFirst → queryOne() with id != $4
- 수정: prisma.update → queryOne() with 동적 UPDATE
- 9개 필드에 대한 조건부 SET 절 생성
7. **deleteConfig()** - 논리 삭제
- prisma.update → query() with is_active = 'N'
8. **getExternalCallConfigsForButtonControl()** - 버튼 제어용
- prisma.findMany with select → query() with SELECT
## 기술적 개선사항
- **동적 WHERE 조건**: 5개 필터 조건 조합 및 파라미터 인덱싱
- **동적 UPDATE 쿼리**: 변경된 필드만 포함하는 SET 절 생성
- **JSON 필드**: config_data를 JSON.stringify()로 처리
- **ILIKE 검색**: 대소문자 구분 없는 검색 구현
- **중복 검사**: id 제외 조건으로 자신 제외 로직 유지
## 코드 정리
- prisma import 완전 제거
- query, queryOne 함수 사용
- 컴파일 및 린터 오류 없음
문서: PHASE3.12_EXTERNAL_CALL_CONFIG_SERVICE_MIGRATION.md
진행률: Phase 3 136/162 (84.0%)
## 백엔드
- DashboardController: 대시보드 CRUD 및 쿼리 실행 API
- DashboardService: 비즈니스 로직 처리
- PostgreSQL 연동 및 데이터 관리
## 프론트엔드
- DashboardDesigner: 캔버스 기반 대시보드 디자이너
- QueryEditor: SQL 쿼리 편집 및 미리보기
- ChartRenderer: 다양한 차트 타입 지원 (Bar, Line, Area, Donut, Stacked, Combo)
- DashboardViewer: 실시간 데이터 반영 뷰어
## 개선사항
- 콘솔 로그 프로덕션 준비 (주석 처리)
- 차트 컴포넌트 확장 (6가지 타입)
- 실시간 쿼리 실행 및 데이터 바인딩
DDL 감사 로깅 서비스의 모든 Prisma 호출을 Raw Query로 전환:
## 전환 완료 (8개 Prisma 호출)
1. **logDDLExecution()** - DDL 실행 로그 INSERT
- prisma.$executeRaw → query()
- 7개 파라미터로 로그 기록
2. **getAuditLogs()** - 감사 로그 목록 조회
- prisma.$queryRawUnsafe → query<any>()
- 동적 WHERE 조건 생성
- 페이징 (LIMIT)
3. **getDDLStatistics()** - 통계 조회 (4개 쿼리)
- totalStats: CASE WHEN 집계로 성공/실패 통계
- ddlTypeStats: GROUP BY로 DDL 타입별 통계
- userStats: GROUP BY로 사용자별 통계
- recentFailures: 최근 실패 로그 조회
4. **getTableDDLHistory()** - 테이블 히스토리
- prisma.$queryRawUnsafe → query<any>()
- table_name 필터링
5. **cleanupOldLogs()** - 오래된 로그 삭제
- prisma.$executeRaw → query()
- 날짜 기반 DELETE
## 기술적 개선사항
- PostgreSQL $1, $2 파라미터 바인딩으로 통일
- 동적 WHERE 조건 생성 로직 유지
- 복잡한 집계 쿼리 (CASE WHEN, GROUP BY, SUM) 완벽 전환
- 기존 에러 처리 및 로깅 구조 유지
- TypeScript 타입 안전성 확보
## 코드 정리
- PrismaClient import 제거
- query, queryOne 함수 사용
- 컴파일 및 린터 오류 없음
문서: PHASE3.11_DDL_AUDIT_LOGGER_MIGRATION.md
진행률: Phase 3 128/162 (79.0%)
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.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%)
추가 전환 완료:
✅ 조회 및 관리 함수들:
- 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>
kjs
dohyeons
leeheejin
hjlee
hjjeong