대표 사례로

ERP 데이터 구조 문서

문서가 없던 ERP 테이블의 관계를 정리하고, 이관과 원천 대조에 필요한 구조를 검색·조회하도록 만들었습니다.

내가 맡은 일

ERP 테이블 관계 정리(785개 중 648개) · 구조 검색 포털 · 이관용 정의서 생성

문서 프로젝트

2026-03 ~ 2026-04

주요 결과

  • 문서·제약이 없던 ERP 테이블 관계 정리785개 중 648개(82.5%)
  • ERP 이관·원천 대조용 구조 검색 포털과 정의서 생성
UNION_ERP 개요

기존 ERP의 테이블·컬럼 통계와 마이그레이션 우선순위 기준을 함께 보여 줍니다. 화면 탐색은 제외하고 통계와 우선순위 표를 끝까지 담았습니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

문제와 시작

구 ERP는 외부 업체가 회사 전용으로 만든 시스템이었는데, 그 업체는 약 10년 전에 없어졌습니다. 전산팀에는 담당자 한 명만 남았고, 테이블 구조와 변경 이력을 아는 사람이 없었습니다. DB에는 테이블 사이 관계 제약이 하나도 없었고, 수금할인 요율 같은 계산 일부는 DB가 아니라 프로그램 안에 있었습니다.

직접 한 일

외래키가 하나도 없는 785개 테이블 중 648개(82.5%)의 관계를 칼럼 이름(PK 이름·별칭)으로 추정해 정리했습니다. 구조 포털과 이관용 정의서를 만들었습니다.

결과와 현재 상태

2026-08 ERP 폐기 후 구조 참고 자료로 보존했습니다. 화면의 테이블별 행 수는 실제와 다른 값으로 바꿔 찍었습니다.

만든 화면

현재 배포 빌드 원본을 읽기 전용으로 렌더링해 개요·차트·관계도·명세·검색·매핑 확인 본문을 촬영했습니다. 공개 구조 메타데이터를 사용하고 행 수는 예시 값으로 바꿨습니다.

데이터 볼륨

카테고리별 행 수를 막대로 비교하는 화면입니다. 모든 막대와 범례를 함께 보여 주며, 행 수는 공개용 합성값입니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

카테고리 관계도

수주·발주 카테고리의 역할·구성·요약과 PK 컬럼명으로 추정한 테이블 관계를 함께 보여 줍니다. 관계도는 실제 앱의 확대·이동 기능을 갖춘 원본 화면입니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

테이블 상세 명세

ORDER_MASTER 테이블의 전체 컬럼 30개와 타입·NULL 허용, 인덱스를 한 화면에 담았습니다. DDL 복사 조작부도 같은 본문에서 제공합니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

컬럼 검색

ORDER_DATETIME을 검색해 해당 컬럼을 쓰는 테이블과 타입·NULL 허용 여부를 확인하는 화면입니다. 검색 조건과 결과 표를 함께 담았습니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

매핑 체크리스트

수주·발주 카테고리로 좁힌 뒤 테이블별 매핑 상태와 메모 입력란을 확인하는 화면입니다. 촬영용 상태·메모는 비어 있으며 저장은 실행하지 않았습니다.

공개용 화면 안내

현재 배포 빌드 원본을 읽기 전용으로 렌더링했습니다. 업무 데이터 조회·저장은 실행하지 않았고 테이블 행 수는 공개용 합성값입니다.

사용한 기술

  • Next.js 15
  • Nextra
  • React Flow
  • dagre
  • TypeScript
맨 위로