ERP Spec
인수사 IT팀 인계 요청에 대응해 만든 Oracle ERP 785개 테이블 구조 포털 (v2.9)
인수사 IT팀 요청에 대응해 자사 Oracle ERP 785개 테이블 구조를 웹에서 검색·분석할 수 있게 정리한 포털. 테이블 간 관계를 인터랙티브 그래프(React Flow + dagre)로 시각화하여 인계, 영향 범위 검토, 스키마 탐색을 지원합니다.

Case
이전 → 단계별 개선 → 지금
이전
구두 설명과 원본 DB 접근뿐
인수사 IT팀은 내부 Oracle ERP 구조(785개 테이블·약 4,900만 행)와 테이블 관계, 데이터 출처를 빠르게 파악해야 했지만, 구두 설명과 원본 DB 접근만으로는 공통 기준을 만들기 어려웠습니다.
1단계
정적 다이어그램의 한계 확인
Mermaid 같은 정적 다이어그램으로는 수십 개 군집을 그릴 수 없어 초기에 한계가 분명해졌습니다.
2단계
클릭·탐색되는 관계 그래프로 전환
dagre 자동 배치와 React Flow로 갈아타, 테이블 간 참조 관계를 직접 눌러 따라갈 수 있게 만들었습니다.
3단계
외래키 없는 Oracle에서 관계 추론
Oracle엔 외래키 제약이 거의 없어 관계를 컬럼명·타입으로 추론해야 했습니다. 확실한 관계와 추정 관계를 강·약 선으로 구분 표기해, 785개 테이블 중 648개(82.5%)를 탐색 가능하게 했습니다.
4단계
이관 지원까지 확장
이관 대상 스키마는 Oracle→MariaDB 타입 매핑을 한 곳(SSOT)에 두고 클라이언트에서 DDL을 생성하게 했고, 메타데이터 파이프라인은 ERP 릴레이와 분리했습니다.
지금
팀이 공유하는 구조 기준
개인에게 묶여 있던 ERP 구조 지식이 웹 레퍼런스가 됐습니다. DBA·개발자·현업·인수사 IT팀이 같은 화면을 근거로 인계와 영향 범위 검토, 데이터 출처 추적을 합니다.
추진 배경
대표이사의 지원 아래 인수사 IT팀 요청에 대응했습니다.
Tech Stack
Features
주요 기능
인수사 IT팀 요청에 맞춰 자사 Oracle ERP 785개 테이블 구조를 웹 분석 포털로 제공
컬럼 타입, 제약조건, 인덱스, 설명을 표준화해 ERP 구조 인계와 신규 담당자 온보딩 지원
테이블명·컬럼명 검색으로 ERP 스키마를 빠르게 탐색하고 개발/운영 문의 대응 기준 마련
React Flow와 dagre 자동 레이아웃으로 테이블 간 참조 관계와 의존도를 인터랙티브하게 시각화
개별 테이블 상세와 관계 그래프를 연결해 영향 범위 파악과 데이터 출처 추적 지원
Nextra 기반 웹 레퍼런스로 DBA·개발자·현업·인수사 IT팀이 같은 구조 기준을 공유
하이라이트
인수사 IT팀 인계를 위한 ERP 구조 분석 포털