전체 프로젝트

ONTOLOGY · KNOWLEDGE GRAPH · VISUALIZATION

흩어진 문서를, 눈으로 따라가는 연결로.

제주도청 온톨로지 구축

행정문서에서 개체와 관계를 뽑아 지식그래프로 쌓고, 그 연결을 2D·3D 그래프로 탐색하고 검수하는 화면을 만들었습니다.

PERIOD
2026.08 — 2026.11
ROLE
프론트엔드 선임
PROJECT
팀 프로젝트
RDFSPARQLSTORM SORJavaScriptCytoscape.js3D Force GraphDocker
JEJU / KNOWLEDGE GRAPHUI CONCEPT
TRIPLES1.75M

행정문서 5,403건에서

EXTRACT. CONNECT. REVIEW.↗

01 / CONTEXT & ROLE

어떤 문제를 풀었나요?

제주의 행정문서는 hwp·hwpx·xlsx 파일로 흩어져 있어, 같은 기관이나 사업이 어느 문서에 어떻게 등장하는지 한눈에 보기 어려웠습니다. 문서 속 개체와 관계를 하나의 그래프로 잇고, 사람이 그 연결을 직접 확인하고 바로잡을 수 있는 화면이 필요했습니다. 외부 인터넷이 막힌 폐쇄망에서 동작해야 한다는 조건도 있었습니다.

제가 맡은 일

행정문서에서 개체·관계를 추출해 트리플로 만들고 SPARQL 저장소에 적재하는 작업, 그래프 탐색 화면과 검수·관리자 화면의 프론트엔드 개발을 맡았습니다.

02 / DEEP DIVE

개체를 연달아 열 때, 이전 응답이 화면을 덮어쓰지 않게 하려면?

문제
그래프에서 개체를 누르면 저장소에 이웃 관계를 묻는 요청이 나갑니다. 사용자가 다른 개체를 곧바로 누르거나 다른 화면으로 옮기면, 먼저 보낸 요청의 응답이 늦게 도착해 지금 보고 있는 그래프를 이전 개체의 관계로 덮어쓸 수 있었습니다.
접근
개체를 열 때마다 요청 번호를 하나씩 올리고, 응답이 도착하면 그 번호가 아직 최신인지 확인한 뒤에만 화면에 반영했습니다. 화면을 떠나면 진행 중인 요청을 취소하고, 오류 표시도 최신 요청일 때만 띄웠습니다. 국가기록원 프로젝트에서 스트리밍 응답이 새 대화에 섞이지 않도록 처리한 경험을 그래프 탐색에 그대로 적용했습니다.
결과
개체를 빠르게 바꿔 눌러도 화면에는 마지막으로 연 개체의 관계만 남습니다. 늦게 도착한 응답은 조용히 버려지고, 이전 요청의 오류가 새 화면에 뜨지 않습니다.

03 / ENGINEERING DECISIONS

구현을 이끈 기술적 결정.

01

같은 개체를 한곳으로 모으기

행정문서에서 개체·관계를 추출해 트리플로 만들고 SPARQL 저장소에 적재했습니다. 개체 사전(가제티어)을 구축해 같은 기관이나 사업이 여러 표기로 흩어지지 않도록 정리했습니다.

RDFSPARQLGazetteer
02

연결을 2D와 3D로 보여주기

Cytoscape.js(fcose 레이아웃)로 2D 그래프를, 3D Force Graph로 3D 모드를 구현했습니다. 그래프만 띄우는 단독 페이지를 따로 두어 다른 화면에 iframe으로 넣을 수 있게 하고, 넣을 수 있는 출처는 CSP로 제한했습니다.

Cytoscape.js3D Force GraphCSP
03

폐쇄망에서 번들러 없이 만들기

npm·CDN을 쓸 수 없는 환경이라 번들러 없이 브라우저 기본 모듈과 직접 포함한 라이브러리로 화면을 구성했습니다. 목업 데이터와 실제 API를 갈아끼울 수 있는 구조로 만들어 백엔드보다 먼저 화면을 개발했습니다.

ES ModulesVanilla JSMock API
04

화면에서는 읽기만 하게

SPARQL 요청은 읽기 질의만 통과시키는 중계를 거치게 하고, IRI 형식 검사와 XSS 이스케이프를 적용해 화면에서 저장소의 데이터를 바꾸는 경로를 막았습니다.

Read-only proxyIRI validationXSS
05

키보드로 빠르게 검수하기

J/K로 이동하고 A로 승인, R로 반려하는 검수 흐름을 만들었습니다. 검수 규칙을 한곳에 모아 일괄 처리도 규칙을 우회하지 못하게 하고, 잠긴 버튼 옆에는 그 이유를 표시했습니다.

Keyboard UXReview rulesAudit log

04 / HOW IT CONNECTS

기능을 연결하는 흐름.

  1. 01행정문서hwp · hwpx · xlsx
  2. 02개체·관계 추출개체 사전으로 정리
  3. 03트리플 적재RDF · SPARQL 저장소
  4. 04그래프 탐색Cytoscape.js · 3D
  5. 05검수·반영승인 · 반려 · 이력

문서에서 뽑은 개체와 관계가 그래프로 보이고, 검수를 거쳐 다시 반영되는 흐름입니다.

05 / OUTCOME

서비스에 남긴 변화.

  • 행정문서 5,403건에서 트리플 약 175만 개 구축
  • 2D·3D 그래프 탐색과 다른 화면에 넣을 수 있는 그래프 단독 페이지 제공
  • 늦게 도착한 응답을 버려 화면 전환 시 데이터 꼬임 방지
  • 읽기 전용 중계로 화면에서 저장소 데이터를 바꾸는 경로 차단

자료 안내

공공기관 폐쇄망 시스템이라 실제 화면 대신 지식그래프 개념도로 대체했습니다.

NEXT CASE STUDY

GenWave

06 / LET’S CONNECT

함께 풀어갈 문제를
기다립니다.

새로운 기회나 기술에 관한 대화, 편하게 연락 주세요.