ADR-0006: 확장자 .ns / .ns.svg
이후 변경
- 2026-10-10: Google Drive에서 만드는 파일의 확장자를
.ns.svg로 정했다 → ADR-0014- 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). → 01-architecture
배경
ADR-0005에 따라 저장 파일은 모델 내장 SVG다. Obsidian에서는 노트에 그림으로 넣어야 하므로 .svg로 끝나야 하고, 데스크톱·웹에서는 일반 SVG와 구분되는 고유 확장자가 있으면 좋다.
결정 기준
- Obsidian에서 노트에 넣으면 그림으로 보여야 한다. (R-OBS-07)
- Obsidian에서 일반
.svg와 NS 다이어그램을 구분할 수 있어야 한다. (R-OBS-06) - 데스크톱에서 파일 연결이 다른 프로그램과 겹치지 않아야 한다. (R-DSK-03)
- 세 대상 사이에서 파일을 쉽게 옮길 수 있어야 한다.
검토한 대안
Obsidian .svg, 데스크톱·웹 .nsd
- 장점: 단순
- 단점:
.nsd는 Structorizer가 이미 쓰는 확장자(내용은 SVG가 아닌 자체 XML)라 파일 연결이 겹침. Obsidian에서 일반 SVG와 이름으로 구분할 수 없어 매번 내용을 읽어야 함
Obsidian .ns.svg, 데스크톱·웹 .ns
- 장점: Structorizer와 충돌 없음. 이름만으로 구분 가능.
.svg를 붙이거나 떼기만 하면 대상 간 이동 가능. Excalidraw 플러그인의.excalidraw.md와 같은 검증된 방식 - 단점: Obsidian은 마지막 점 뒤(
svg)만 확장자로 보므로 확장자 등록이 아닌 이름 접미사로 판별해야 함. 사용자가 이름을 바꾸다.ns를 지울 수 있음
결정
- Obsidian 플러그인:
이름.ns.svg - 데스크톱 · 웹:
이름.ns(.ns.svg도 열 수 있음) - 확장자는 1차 판별에만 쓰고, 실제로 열 때는 파일 내용에 모델이 있는지 검사한다(콘텐츠 기반 판별).
.ns가 빠진.svg라도 모델이 있으면 “NS 편집기로 열기” 메뉴를 제공한다. (R-OBS-09)
결과
- 좋아지는 점: 확장자 충돌 없음, 대상 간 이동이 쉬움
- 감수하는 점: Obsidian에서
.svg파일 열기를 가로채는(후킹) 방법을 검증해야 함 → 8. 위험과 검증이 필요한 사항