Sinhu Jung Software Engineer
Section

PHP → Next.js AI Migration System

2025.05 — 2026.03·Fullstack Engineer · 전환 파이프라인 개발Private서울·중구·중림동
Next.js 14TypeScriptClaude Code / APIMySQLOracle

실서비스 전환 전 중단

내부 결정으로 2026년 3월 프로젝트가 중단됐습니다. 아래 내용은 개발한 파이프라인과 검증 범위이며, 실제 서비스 전환·운영 배포 성과를 뜻하지 않습니다.

프로젝트 핵심 요약

문제에서 결과까지
서비스별 전환 규칙
4개 유형
단일·복수 DB 환경 지원
연결 풀
2026.03 내부 결정
전환 전 중단
문제
PHP 서비스마다 SQL·NAS 파일·jQuery·세션 인증 흐름이 달라, 화면 코드만 바꾸어서는 기존 동작을 유지하기 어려웠습니다.
판단
4개 서비스 유형별 전환 규칙을 정하고 기존 SQL·DOM·CSS를 유지하도록 했습니다. 코드 분석·환경 설정·생성·검증을 이어지는 작업 흐름으로 구성했습니다.
내 기여
분석·변환·검증 에이전트와 명령을 구현했습니다. MySQL2·OracleDB 연결 풀, NAS 파일 제공 API Route, jQuery 실행 순서와 useAuth·미들웨어 기반 인증 처리를 전환 코드에 반영했습니다.
결과
코드 스캔부터 빌드·린트·라우팅 검사까지 연결한 전환 파이프라인을 개발했습니다. 2026년 3월 내부 결정으로 실제 서비스 전환 전에 중단됐습니다.

범위와 측정 기준 · 입사지원서 v9의 개발 범위와 진행 상태 기준입니다. 파이프라인 구현 경험이며 운영 서비스 전환 완료나 운영 성능 향상을 의미하지 않습니다.

구현과 검증 과정

화면 코드 밖의 의존성까지 전환

업무 맥락
PHP의 SQL·NAS 파일·세션 인증과 jQuery 실행 순서를 함께 고려해야 했습니다.
직접 구현
mysql2·oracledb 연결 풀로 기존 SQL을 재사용하고, NAS 접근·캐싱과 파일 제공 API Route를 구현했습니다. DOM·CSS를 보존하며 전체 페이지 이동과 beforeInteractive 로딩으로 jQuery 실행 순서를 다뤘습니다.
검증과 범위
서비스 유형별 생성 뒤 빌드·린트·라우팅 검사를 연결했습니다. 이 검사는 기존 업무 기능과의 완전한 동등성이나 운영 전환 완료를 의미하지 않습니다.

Architecture

PHP 전환 파이프라인과 전환 코드의 DB·파일·인증 경계를 나누어 표시했습니다. 실제 서비스 전환 전에 중단된 개발 범위입니다.

검증 근거 · 입사지원서 v9의 구현 범위·2026.03 중단 기록과 앞서 확인한 마이그레이션 저장소의 명령 정의를 대조했습니다. 운영 배포 완료를 나타내는 도식은 아닙니다.

→ 요청 · 전달⇢ 코드 의존성 (점선)→ 빌드 · 배포

분석 · 검토 · 변환 · 검증

검토 승인과 환경 구성을 거쳐 서비스 타입에 맞는 변환을 실행합니다.

노드 선택 · Ctrl/⌘ + 휠로 확대 · 드래그로 이동
100%
분석 · 검토 · 변환 · 검증. 검토 승인과 환경 구성을 거쳐 서비스 타입에 맞는 변환을 실행합니다. 아래에 동일한 연결 관계를 텍스트로 제공합니다.분석 입력분석 보고서승인 후설정 입력준비 완료변환 결과검증 보고레거시 PHP — 소스 · 웹서버 설정레거시 PHP소스 · 웹서버 설정/analyze — PHP Analyzer/analyzePHP Analyzer/review — 개발자 검토 · 승인/review개발자 검토 · 승인/setup-env — DB · NAS · 환경 설정/setup-envDB · NAS · 환경 설정/migrate — Page · API · Style/migratePage · API · Style/validate — QA · 빌드 · 매핑 검증/validateQA · 빌드 · 매핑 검증서비스 Config — Type 1~4 · 서비스 차이서비스 ConfigType 1~4 · 서비스 차이검증 결과 — 수정 항목 · 전환 산출물검증 결과수정 항목 · 전환 산출물
  • • Type 1·3은 Page/Style 병렬 변환, Type 2·4는 API → Page → Style 단계로 정의되어 있습니다. 모든 변환기를 항상 병렬로 실행하는 구조가 아닙니다.
  • • Next.js 프로젝트 뼈대는 개발자가 먼저 생성합니다. Config·AI 변환은 준비된 프로젝트에 적용됩니다.
연결 관계를 텍스트로 보기
  • 레거시 PHP → /analyze · 분석 입력
  • /analyze → /review · 분석 보고서
  • /review → /setup-env · 승인 후
  • 서비스 Config → /setup-env · 설정 입력
  • /setup-env → /migrate · 준비 완료
  • /migrate → /validate · 변환 결과
  • /validate → 검증 결과 · 검증 보고

전환 코드의 DB · 파일 · 인증 경계

기존 SQL·DOM·CSS와 파일·인증 흐름을 보존하기 위해 구현한 개발 범위입니다.

노드 선택 · Ctrl/⌘ + 휠로 확대 · 드래그로 이동
100%
전환 코드의 DB · 파일 · 인증 경계. 기존 SQL·DOM·CSS와 파일·인증 흐름을 보존하기 위해 구현한 개발 범위입니다. 아래에 동일한 연결 관계를 텍스트로 제공합니다.전체 페이지 이동로딩 순서 지정데이터 조회기존 SQL 재사용파일 요청 처리파일 읽기인증 처리브라우저 — 기존 DOM · CSS 유지브라우저기존 DOM · CSS 유지Next.js 14 — App Router · API RouteNext.js 14App Router · API RoutejQuery 플러그인 — beforeInteractivejQuery 플러그인beforeInteractiveMySQL · Oracle — 단일 · 복수 DBMySQL · Oracle단일 · 복수 DBDB 연결 풀 — mysql2 · oracledbDB 연결 풀mysql2 · oracledb파일 API Route — 파일 접근 · 캐싱파일 API Route파일 접근 · 캐싱세션 · 쿠키 인증 — useAuth · Middleware세션 · 쿠키 인증useAuth · MiddlewareNAS — 마운트된 기존 파일NAS마운트된 기존 파일
  • • DB 연결·NAS 파일 접근은 서버 경계 안의 처리입니다. 인증 노드는 클라이언트 useAuth와 서버 미들웨어의 연계를 묶어 표현한 것이며, 세부 보안 설정을 뜻하지 않습니다.
  • • 2026년 3월 내부 결정으로 실제 서비스 전환 전에 중단됐습니다. Nginx·Apache 운영 배포나 전환 서비스의 운영 성과를 주장하지 않습니다.
연결 관계를 텍스트로 보기
  • 브라우저 → Next.js 14 · 전체 페이지 이동
  • Next.js 14 → jQuery 플러그인 · 로딩 순서 지정
  • Next.js 14 → DB 연결 풀 · 데이터 조회
  • DB 연결 풀 → MySQL · Oracle · 기존 SQL 재사용
  • Next.js 14 → 파일 API Route · 파일 요청 처리
  • 파일 API Route → NAS · 파일 읽기
  • Next.js 14 → 세션 · 쿠키 인증 · 인증 처리 (코드 의존성)

Key Decisions

결정이유결과
4개 서비스 유형별 전환 규칙서비스 구조에 따라 분석·생성 순서와 환경 구성이 다름코드 스캔부터 빌드·린트·라우팅 검사까지 연결
mysql2·oracledb 연결 풀과 기존 SQL 재사용단일 DB와 여러 DB를 사용하는 환경을 함께 지원DB별 연결·조회 구성을 공통화
전체 페이지 이동과 beforeInteractive 로딩jQuery 플러그인의 실행 순서와 DOM·CSS 호환성 유지기존 화면 동작을 고려한 변환 규칙 구성
NAS 접근·캐싱 및 파일 API Route전환 코드에서도 기존 파일을 제공해야 함파일 제공 경로와 서버의 데이터 접근 구현

Impact

  • ▸4개 서비스 유형에 맞는 코드 분석·생성·검증 절차를 구현했습니다.
  • ▸DB·NAS·인증 등 화면 밖의 의존성까지 전환 범위에 포함했습니다.
  • ▸실서비스 전환 전 중단된 개발 프로젝트로, 운영 성과 수치를 제시하지 않습니다.

Tech Stack

Application
TypeScriptNext.js 14 (App Router)useAuthMiddleware
AI / Validation
Claude CodeClaude API빌드·린트·라우팅 검사
DB / Legacy
mysql2oracledbPHPjQueryNAS세션·쿠키 인증