CASE
GAON
문화유산 관광 플랫폼 — 관광동선 지도와 3D 복원 공간
- 기간
- 2026.06.22 – 06.26 (5일)
- 규모
- 팀 프로젝트 · 4명
- 담당
- 관광동선 지도 · 문화재 3D
2026 충청북도 공공데이터·AI 활용 창업경진대회
충청북도 주최 · 충북과학기술혁신원 주관
접수 4.13–6.28 · 서류평가 7.7 · 시상식 7.28
출품

실측
측정한 값만 적었습니다. 측정하지 않은 칸은 비워 둡니다.
- 담당 커밋
- 11
- 지도 화면
- 568줄
- 전체 기여
- 2,392줄
- 저장소 밖으로
- 433MB
- 외곽선 압축
- 205배
- VR 공간
- 2곳
사람 커밋 35건 중 · 머지 제외 · 2026-10-07 실측
MapPage.tsx 770줄 중 74% · git blame
소스 12,796줄 중 19% · tsx·ts·css·py·html
3D 모델 8개 · Supabase Storage 로
시도 17개 7.19MB → 외곽 7개 35.8KB
종묘 · 문묘/성균관 — 건물 모델 8채
왜 만들었나
짧은 팀 프로젝트였습니다. 닷새 동안 넷이 붙어 문화유산 관광 플랫폼의 첫 형태를 만들었고, 저는 관광지를 지도 위에서 고르는 「관광동선」 화면과 문화재를 걸어 다니며 보는 3D 공간을 맡았습니다.
지도에서 먼저 정한 것은 보여 주지 않을 범위였습니다. 전국 관광 서비스인데 지도가 세계 지도면 사용자는 매번 한국을 찾아 끌어와야 합니다. 그래서 줌과 이동 범위를 한반도로 묶고, 그래도 가장자리에 보이는 바깥을 덮었습니다.
3D 쪽에서 실제로 부딪힌 문제는 모델 품질이 아니라 파일 크기였습니다. 복원 모델 여덟 개가 433MB였고, 처음에는 그게 저장소 안에 있었습니다. 팀원 세 명이 매번 그걸 받아야 하는 구조는 닷새짜리 일정에서 그대로 비용이 됩니다.
제 몫은 전체의 19%입니다. 이 페이지는 그 19%에 대해서만 적었습니다 — 챗봇·스토어·티켓은 팀원이 만든 것이라 여기 없습니다.
업무 분담
팀 작업이라 적어 둡니다. 아래 도면에서 제 몫이 아닌 칸은 「팀원 담당」으로 표시했습니다.
- 박민호
- 팀장 · AI 관광 챗봇 · 관광정보·티켓·예약 화면 · 배포
- 백성검
- 프론트 — 앱 셸, 스토어·관광정보 화면
- 정어진
- 백엔드 — 문화유산 퀴즈·포인트, 시드 데이터
- 정상호
- 관광동선 지도 · 문화재 3D 공간 · 문화유산 라우터
기술 흐름
도면 2장입니다. 왼쪽 세로선을 따라 위에서 아래로 흐르고, 나란한 칸은 동시에 일어나는 일입니다. 빨간 줄이 붙은 칸은 그 자리에서 빠져나가는 길 — 반려·보류·폴백입니다.
- 코드
- 결정론 코드 — 같은 입력이면 같은 출력
- 모델
- 언어·비전 모델
- 저장
- 저장소
- 외부
- 외부 서비스·공개 소스
- 관문
- 관문 — 통과 못 하면 빠진다
- 산출
- 사람이 보는 산출물
도 01
관광동선 지도
지도는 전국을 띄우되 한국 바깥을 덮어 시선을 가둔다. 관광지는 지역으로 추리고, 고른 한 곳만 지도에 세운다.
관문지역 선택
- 시도 17개 드롭다운
- 안 고르면 등록된 곳 전부를 그대로 보여 준다
province 로
코드관광지 추리기
- 화면 밖 호출 없이 코드 안 상수를 거른다
관광지 6곳 · 그중 VR 있는 곳 2곳 · 축제 18건 (2026-10-07 실측)
고른 지역에 등록된 곳이 없으면
빈 목록을 그대로 두지 않고 「추후 추가 예정입니다」를 적는다. 고장과 미등록은 다른 상태다.
지도를 그린다
외부배경 타일
- OpenStreetMap 래스터 타일
- 줌 7–13 · 한반도 바깥으로 못 나가게 묶었다
코드바깥 덮기
- 세계 전체 폴리곤 하나에 한국 외곽선을 구멍으로 뚫는다
- evenodd 채움 규칙 — 타일을 자르지 않는다
외곽 MultiPolygon 7개 · 35.8KB (시도 17개 7.19MB 를 미리 합친 결과)
카드나 핀을 고르면
코드그 한 곳으로 날아간다
- flyTo · 줌 14 · 1.2초
- 핀은 고른 한 곳만 세운다 — 전국 핀을 뿌리지 않는다
자세히 보기
산출관광지 상세
- 사진 3장 · 개요 · 축제 일정
- VR 이 있는 곳은 슬라이드 한 칸이 더 붙는다
- 현재 위치 버튼은 브라우저 geolocation 을 쓴다. 거부당하면 알림 한 줄로 끝나고 지도는 그대로 돈다.
- 지도 화면 전체가 하나의 파일이다 — `MapPage.tsx` 770줄 중 568줄이 제 몫이고 나머지는 팀원이 붙인 레이아웃·스타일이다 (git blame · 2026-10-07).
도 02
문화재 3D 공간
복원 모델을 걸어 다니며 보는 화면. 모델 파일은 저장소에 두지 않고 바깥 저장소에서 받아 온다.
관문VR 슬라이드
- 관광지 상세의 마지막 칸
- VR 이 없는 곳에는 이 칸이 생기지 않는다
iframe 으로
코드A-Frame 장면
- WebXR 씬 한 장 — 종묘 · 문묘/성균관
- 키보드로 걷고 마우스로 둘러본다 (wasd + look)
씬 2개 · 590줄 (jongmyo 330 · munmyo 260)
모델을 받아 온다
외부3D 모델 저장소
- Supabase Storage 공개 버킷
- 저장소에는 URL 만 남는다
glb 8개 · 합 433MB (2026-06-24 에 옮겼다)
저장소 안에 두면
clone 할 때마다 433MB 를 받고, 지워도 git 이력에는 영원히 남는다. 실제로 이 저장소의 `.git` 은 아직 293MB 다 — 옮긴 뒤에도 이미 쌓인 이력은 줄지 않는다.
적재 끝
산출걸어 다니는 복원 공간
- 건물 단위로 모델을 나눠 붙였다 — 문묘/성균관은 7채
정한 것과 거부한 것
만든 것보다 안 만든 것이 설계입니다. 왜 그렇게 정했는지를 함께 적었습니다.
- 01
지도 바깥을 자르지 않고 덮었다
한국만 보이게 하는 흔한 방법은 타일을 잘라 쓰는 것입니다. 그러면 타일 서버를 따로 두거나 미리 받아 둬야 합니다. 대신 세계 전체를 덮는 폴리곤 하나에 한국 외곽선을 구멍으로 뚫었습니다 — evenodd 채움 규칙이면 구멍 안쪽만 비칩니다. 타일은 공개 OpenStreetMap 을 그대로 쓰고, 덮개는 벡터 한 장이라 줌을 바꿔도 다시 받지 않습니다.
- 02
외곽선은 브라우저가 아니라 미리 합쳤다
시도 17개 폴리곤을 그대로 들고 덮개를 만들면 7.19MB 를 받아서 브라우저가 매번 합쳐야 합니다. 경계선은 변하지 않는 값이라 그 계산을 화면에서 할 이유가 없습니다. shapely 로 한 번 합쳐 외곽 MultiPolygon 7개만 내보냈고 35.8KB 가 됐습니다.
- 03
3D 모델을 저장소에서 들어냈다
glb 8개가 433MB였습니다. 저장소에 두면 clone 마다 그만큼을 받고, 나중에 지워도 이력에는 영원히 남습니다. Supabase Storage 로 옮기고 A-Frame 의 모델 주소만 URL 로 바꿨습니다. 다만 이건 늦은 조치였습니다 — 이미 들어간 이력 때문에 `.git` 은 아직 293MB 입니다.
- 04
핀을 전부 뿌리지 않는다
관광지 전부를 지도에 찍어 두면 어느 것이 지금 보고 있는 것인지 알 수 없습니다. 고른 한 곳만 핀으로 세우고 그쪽으로 날아갑니다. 목록은 오른쪽 카드가 맡고, 지도는 「지금 이 한 곳」만 말합니다.
- 05
VR 은 별도 화면이 아니라 사진 슬라이드의 마지막 칸이다
3D 를 따로 메뉴에 두면 들어가 볼 사람만 봅니다. 관광지 상세에서 사진을 넘기다 보면 마지막에 나오게 두면, VR 이 있다는 사실 자체를 따로 설명할 필요가 없습니다. VR 이 없는 곳에는 그 칸이 생기지 않습니다.
이 프로젝트에서 쓴 것
실제로 돌아가는 것만 적었습니다. 각 기술이 어디에 쓰이는지는 위 도면이 말합니다.
- 언어
- TypeScriptPython
- 프론트
- React 19ViteLeafletreact-leaflet
- 3D · VR
- A-Frame 1.4.2WebXRglTF/glb
- 지리 데이터
- GeoJSONshapelyOpenStreetMap 타일
- 백엔드
- FastAPISQLite
- 인프라
- DockerSupabase StorageRailway
아직 못 한 것
- 화면 위쪽 숫자(이번 주 방문객 2,840 · 진행 중인 행사 8 · 등록 관광지 156)는 데모 데이터입니다. 코드에 박힌 고정값이고 어디서도 세지 않습니다. 위 실측 칸에 그 숫자들이 없는 이유가 그것입니다.
- 관광지 6곳과 축제 18건도 코드 안 상수입니다. 백엔드에 문화유산 API 가 있지만 이 화면은 아직 거기에 붙어 있지 않습니다 — 닷새 안에 화면을 세우는 쪽을 먼저 골랐습니다.
- 검색창과 「필터」 버튼은 자리만 있고 동작하지 않습니다. 실제로 거르는 것은 오른쪽 지역 드롭다운 하나입니다.
- 테스트가 없습니다. 이 저장소의 테스트 파일은 프로젝트와 무관한 샘플 1개뿐입니다.
- 저장소에 쓰지 않는 파일이 남아 있습니다 — 시도 폴리곤 원본 7.19MB 와 미리 받아 둔 타일 이미지 25장은 현재 어디서도 불러오지 않습니다.
- 이 프로젝트의 코드는 팀 저장소에 있고 이 포트폴리오 저장소에는 없습니다. 위 수치는 그 저장소를 2026-10-07 에 직접 재서 옮긴 값입니다.