- 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%)
dohyeons
leeheejin
kjs
hjjeong