상동호수공원 디지털트윈 · NHI PhotoNano K-테스트베드 2026
한국어 · English · 日本語
부천 상동호수공원을 OpenStreetMap 실측 지형과 현장 사진을 바탕으로 재현한 3D 디지털트윈입니다.
NHI PhotoNano(UFB–TiO₂ 광촉매 융합 수질개선) 테스트베드의 측정 3지점과 Side-stream 모듈 배치안을 표시합니다.
실행
주요 기능
-
실시간 반사 수면, 갈대·억새, 파란 난간 목재 데크, 분수 2기, 첨탑 광장, 수종별 수목
-
사진 누끼 원경 스카이라인, 절차적 하늘·구름, 시간대(해 위치·가로등) 변화, 차량 흐름
-
현장 사진 8장과 3D 시점 겹쳐보기
-
PhotoNano 2기(서측·동측 호안, 호기 간 약 170 m) · 측정 5지점(S-01~05) 수질 패널(시뮬레이션) · DO 분포 레이어
-
UFB 정화 연출: 두 환수부에서 마이크로·나노버블이 분사되어 정화 전선이 호수 전역으로 서서히 확산(48초 반복). 수면 녹조·혐기성 슬러지 막이 걷히고, 수중의 세균·바이러스·곰팡이·조류 입자가 소멸, 나노버블 헤이즈가 채워짐. 정화 전경·수중 시점 버튼, 정화 진행률 표시. 개념 시각화이며 실측 결과가 아님
-
수질 패널 연동: 정화 전선이 측정 지점을 지나면 S-01~S-05의 DO 상승·탁도 저감·ORP 상승이 실시간 반영(운전 전 대비 %, 표 5 기준 달성 시 초록 표시)
-
광촉매 ROS 연출: 수중에 ·OH(청백)·O₂⁻(보라) 빛 입자가 환수부와 정화 전선 뒤에 집중, 미생물이 ROS를 받아 흔들리며 분해·소멸
-
표시 모드 토글: 상단 일반 상태 | 정화 연출 버튼(또는 키보드 P). 일반 상태는 PhotoNano 미가동·운전 전 기준값, 정화 연출은 처음부터 다시 재생
-
보트 운행(녹조제거 쌍동선): 상단 보트 운행 버튼(또는 키보드 B). STL 실측 모델(1.6 m)이 ① 수계 인식(위성영상+LiDAR 경계 스캔, 수면적·운항 금지구역 등록) → ② 경로 최적화(동서/남북 교차 왕복 커버리지 경로, 예상 커버리지 표시) → ③ 자율 운항(GNSS RTK 위성 좌표 수신·LiDAR 360° 스캔, 부유 장애물 감지 시 회피 기동 후 경로 복귀) 순서로 미션을 수행하며 나노버블·광촉매 ROS로 녹조를 제거. 배속 ×1/×10/×30, 보트 추적 카메라, 미션 재시작, 고착 시 후진·탈출 경로 재계산, 리모콘 수동 조종(원형 조이스틱 드래그·방향키/WASD, 5초 무입력 시 자율운항 복귀)
-
데크 기둥 사이 통과: 데크 밑은 기둥 사이 게이트로만 수직 통과, 게이트 서행(50%)·마스트 여유고 검사·게이트별 3회 왕복 세정, 3컷 시네마틱 카메라(진입→데크 밑→빠져나오기)
-
시간대·그림자·UVA: 시간대는 한국 표준시와 실시간 동기화(● LIVE, 슬라이더로 수동 조절 가능). 태양 위치로 데크 그림자를 투영하고 실제 그늘 또는 야간에서만 UVA 365 nm 출력 100%(평시 60%), 야간 UVA 빛 강화
-
효과음: 물소리·모터음·버블(WebAudio 합성, 🔊 토글) — 브라우저 정책상 첫 클릭 후 재생
-
실시간 날씨(OpenWeather): 공원 위치(부천 상동) 현재 날씨·체감온도, 오늘(최고/최저·강수확률·습도·풍속·일출/일몰), 주간 8일 예보(One Call 3.0, 미구독 시 5일 예보로 자동 폴백), 10분마다 갱신. 비가 오면 빗줄기·수면 빗방울 파문·빗소리, 뇌우는 번개·천둥, 눈은 눈송이, 흐림·안개는 하늘·햇빛·시정 감쇠. 패널의 선택 상자로 맑음/흐림/비/뇌우/눈/안개 수동 연출(발표용)
-
게이트 운항 보고서(📊): 게이트별 통과 횟수·UVA 가동시간·ROS 발생 지수(시뮬레이션 입자 수)·마지막 통과, 서버 저장(회원)·PDF 출력
회원 · 접속자 관리
- 첫 화면은 스플래시 → 로그인. 회원가입(이름·이메일·연락처·소속·이용 목적, 개인정보 동의) → 이메일 인증(메일 설정 시) → 최고관리자 승인 후 이용
- 비밀번호 찾기(메일 재설정 링크, 1시간·1회용), 로그인 후 비밀번호 변경, 연속 실패 시 10분 잠금
- 접속자 관리(최고관리자 전용): 회원 승인·차단·차단 해지·메일 인증 처리·임시 비밀번호·삭제, 접속자(IP·지역·브라우저·회원·접속 중 여부) 조회, IP 차단·해제. 일반 회원에게는 버튼이 보이지 않고 서버 API도 최고관리자 토큰만 허용
- 회원 화면 일괄 업데이트: 새 버전 배포 후 관리자창 ‘업데이트’ 탭에서 버튼을 누르면 접속 중인 모든 화면이 안내 후 10초 뒤 자동 새로고침(최대 45초 내 반영)
- 로컬
index.html(file://) 실행은 오프라인 열람용이라 로그인 없이 열립니다
서버 설정 (Vercel 환경변수 — 값은 저장소에 커밋하지 않음)
| 변수 | 내용 |
|---|
DATABASE_URL / DATABASE_POSTGRES_URL | Neon Postgres (Vercel Storage 연결 시 자동 주입) |
ADMIN_PASSWORD | 최고관리자(ADMIN_EMAIL, 기본 [email protected]) 최초 비밀번호 — 첫 요청 시 해시로만 저장 |
MAIL_USER, MAIL_APP_PASSWORD | Gmail 주소 + 앱 비밀번호 → 가입 인증·비밀번호 재설정·승인 알림 메일. 미설정 시 메일 없이 ‘관리자 승인’만으로 운영 |
OPENWEATHER_API_KEY | OpenWeather API 키 — 서버 프록시 /api/weather에서만 사용(브라우저에 노출되지 않음). 미설정 시 날씨 패널은 수동 연출만 동작 |
AUTH_SECRET (선택) | 토큰 서명 키. 미설정 시 DB에 자동 생성·보관 |
빌드
python3 src/tools/make_assets.py # photos/ → 누끼 스카이라인·비교용 사진
python3 build_v2.py # sangdong_dt_v2(.html/_offline.html)
python3 build.py # v1
cp sangdong_dt_v2_offline.html index.html
구조
| 경로 | 내용 |
|---|
index.html | 배포용 (v2 오프라인판과 동일) |
src/template_v2.html, src/template.html | 화면·3D 소스 |
src/assets/ | 스카이라인 누끼, 비교용 사진 |
src/vendor/ | three.js r128, OrbitControls, Water |
data/sd_osm.json | OSM 지형 (원점 37.5038N 126.7450E, m, x=동 z=남) |
photos/ | 현장 참고 사진 원본 |
api/, lib/ | Vercel 서버리스 API (회원 인증·관리자·접속 기록) |
data/ssangdong_ship.stl, src/assets/boat_mesh.json | 녹조제거 쌍동선 STL 원본·변환 메시 |
저작권 · 라이선스
© 2026 주식회사 나노하이드로인 (NanoHydroIn Co., Ltd.). All rights reserved.
본 저장소의 소스코드·3D 장면·연출·문서는 주식회사 나노하이드로인의 저작물이며, 사전 서면 동의 없는 복제·수정·배포·상업적 이용을 금지합니다(열람 및 K-테스트베드 심사 목적 시연은 허용). 자세한 내용은 LICENSE를 참조하십시오.
제3자 구성요소(three.js — MIT, OpenStreetMap — ODbL, 웹 폰트 — OFL, 현장 참고 사진 — 각 원저작자)는 각 원 라이선스를 따릅니다: NOTICE.md
English
Photoreal 3D digital twin of Sangdong Lake Park (Bucheon, Korea), built from surveyed OpenStreetMap terrain and site photos, for the NHI PhotoNano (UFB–TiO₂ photocatalytic water-treatment) K-water K-Testbed 2026.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
