오프라인 사용

drawtonomy는 차선 스케치, OpenDRIVE / OpenSCENARIO 파일 편집, esmini를 통한 시나리오 재생 등 핵심 작업을 외부 네트워크 전송 없이 수행할 수 있도록 설계되어 있습니다. 이 페이지에서는 현재 버전에서 완전한 외부 트래픽 제로(zero-egress) 환경을 구성하는 방법과, 이를 하나의 토글로 제어할 수 있도록 개발 중인 기능을 소개합니다.

”외부 트래픽 제로”의 의미

에디터 초기 로딩이 완료된 이후, 외부 데이터를 명시적으로 가져오는 기능을 사용하지 않는 한 아웃바운드 요청은 발생하지 않습니다. 어떤 기능이 외부 요청을 유발하는지는 데이터 흐름과 개인정보 보호에 정리되어 있습니다. 해당 기능들을 사용하지 않으면 완전한 오프라인 세션이 유지되며, 브라우저의 Network 탭에서 직접 확인할 수 있습니다.

외부 트래픽 제로 세션을 위한 체크리스트

지도 배경을 “Off”로 설정합니다. 도로 및 위성 지도 타일 제공자 연결이 차단됩니다.
“Generate Lanes from OSM” 기능을 사용하지 않습니다. 이 기능만이 Overpass API에 쿼리를 보내는 내장 기능입니다. 대신 차선을 직접 그리거나 기존 .xodr 파일을 가져옵니다.
지도 검색창을 사용하지 않습니다. 입력한 텍스트가 장소명 검색 서비스로 전송됩니다.
AI Scene Generator 확장을 활성화하지 않습니다. 기본적으로 비활성화 상태이므로, Extensions 패널에서 직접 열지 않는 한 LLM으로 데이터가 전송되지 않습니다.
내보내기 시 번들 폰트를 사용합니다. drawtonomy에는 Excalifont가 기본 포함되어 있습니다. 이 폰트를 사용해서 내보낼 경우 Google Fonts에 접속하지 않습니다.

위 단계를 모두 따르면 세션 내내 아웃바운드 요청이 발생하지 않습니다. 브라우저 개발자 도구에서 Network 탭을 열고 “Fetch / XHR”로 필터링한 뒤, 차선 그리기, 파일 가져오기, 시나리오 재생, 내보내기 등의 작업을 수행하는 동안 목록이 비어 있는지 확인할 수 있습니다.

완전히 오프라인에서 작동하는 워크플로

도로 네트워크 직접 그리기 — 차선 속성을 설정하고 OpenDRIVE로 내보냅니다.
기존 .xodr 파일 가져오기 — 차선 형상 및 연결을 편집한 뒤 다시 내보냅니다.
.xosc 파일 가져오기 (카탈로그 참조 포함) — 편집하고 Play를 눌러 에디터 내 esmini-WASM으로 즉시 실행합니다.
esmini 호환 .zip 내보내기 — .xodr + .xosc를 포함하는 패키지를 생성해 다운스트림 시뮬레이션에 활용합니다.

위 워크플로는 모두 브라우저 안에서 완결됩니다. Overpass 접속이 필요한 기능은 “Generate Lanes from OSM”뿐입니다.

네트워크가 필요한 워크플로

OSM 차선 가져오기 — Overpass API가 필요합니다.
장소명 검색 — 공개 Nominatim 인스턴스가 필요합니다.
AI Scene Generator 확장 — 기본 비활성화 상태이며, Extensions 패널에서 선택 시에만 활성화됩니다. 프롬프트는 브라우저에서 직접 설정한 LLM 공급자(Anthropic Claude, OpenAI GPT, 또는 Google Gemini)로 전송됩니다. 현재 캔버스 내용은 요청에 포함되지 않습니다. 자세한 내용은 보안 FAQ를 참고하시기 바랍니다.

로드맵: 단일 “오프라인 모드” 토글

햄버거 메뉴에 최상위 Offline mode (network 0) 토글을 추가할 예정입니다. 활성화 시 다음과 같은 동작이 적용됩니다.

지도 타일 제공자, Overpass, 장소명 검색, Google Fonts, Google Analytics를 포함한 모든 아웃바운드 요청이 차단됩니다.
UI에 소형 배지가 표시되어 운영자가 외부 트래픽 차단 여부를 한눈에 확인할 수 있습니다.
향후 변경 사항이 네트워크 트래픽을 자동으로 재도입하지 않도록 자동화 테스트로 검증됩니다.

이 기능을 더 빨리 원하신다면 이슈를 등록해 주세요 — OEM 사용 사례가 이 작업의 최우선 순위입니다.