ADR-0002: 세 대상 배포 + 공유 코어 모노레포

이후 변경

  • 2026-10-09: Google Drive 연동을 웹 버전 위에 얹기로 했다 → ADR-0012
  • 2026-10-10: 나중에 검토할 배포 대상으로 Confluence(유료)와 Claude skill이 요구사항에 들어갔다 → 2. 배포 대상
  • 2026-10-10: 개발 순서를 웹 → Obsidian → 데스크톱으로 정했다 → DR-0002
  • 2026-10-13: 텍스트 폭은 셸이 주입하지 않고 core가 번들 글꼴의 메트릭으로 계산하게 되었다 → ADR-0026
  • 2026-10-14: 나중에 만들 배포 대상으로 IDE 플러그인(VSCode 먼저, 그다음 IntelliJ)이 요구사항에 들어갔다. 다른 대상과 달리 .ns 파일이 아니라 소스 코드가 원본이다. 그래서 이 ADR의 “대상별로 다른 부분은 파일 입출력”만으로는 모자랄 수 있다 → 2.7 IDE 플러그인 (나중에)
  • 2026-10-17: 글꼴 패키지 packages/fonts(글꼴 파일, advance 폭 테이블, 서브세팅)가 더해졌다 → ADR-0026
  • 2026-10-18: 플랫폼 의존 부분을 셸이 구현하는 필요 인터페이스 둘로 정했다. DocumentStore(문서 파일 I/O, 다른 문서 읽기를 더함)와 SettingsStore(사용자 설정 영속)다 → ADR-0031
  • 2026-10-18: 반대 방향으로, 편집기가 명령 레지스트리(CommandRegistry)와 설정 스키마(SettingsSchema)를 제공 인터페이스로 노출하고, 셸이 그것을 호스트 플랫폼의 메뉴 · 설정 화면에 등록하기로 했다 → ADR-0033
  • 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). → 01-architecture
  • 2026-10-25: 코드를 저장소의 src/ 아래에 두기로 했다. 아래 표의 packages/… · apps/…는 src/에서 본 경로다. 모노레포 도구는 pnpm 워크스페이스, core는 패키지 하나(안을 모듈 폴더로), Obsidian의 manifest.json 사본은 저장소 맨 위 → ADR-0036
  • 2026-10-25: “결정”의 패키지 목록을 글자 그림에서 표로 바꿨다(글은 그대로, 모양만. 메인테이너가 inbox에서 요청)

배경

NS 차트 편집기를 Obsidian 안에서도, 단독 데스크톱 앱으로도, 설치 없이 웹에서도 쓰고 싶다. (2. 배포 대상)

결정 기준

  • 세 대상에서 편집 동작과 결과 파일이 같아야 한다. (R-NFR-02)
  • 같은 기능을 세 번 구현하지 않아야 한다.
  • 플랫폼 의존 부분(파일 I/O, 창, 테마 연동)만 대상별로 구현해야 한다.

검토한 대안

대상별로 따로 구현

  • 장점: 대상마다 가장 알맞은 기술 사용 가능
  • 단점: 기능을 세 번 구현, 동작 차이로 파일 호환성이 깨지기 쉬움

공유 코어 + 대상별 셸 (모노레포)

  • 장점: 도메인 로직과 편집 UI를 한 번만 구현, 호환성이 구조적으로 보장됨
  • 단점: 세 대상 모두에서 돌아가는 기술로 제한됨, 모노레포 빌드 설정 필요

결정

세 대상 모두 배포하며, 하나의 저장소에서 공유 패키지와 대상별 셸로 나눈다.

패키지담는 것
packages/core모델 · 편집 명령 · 레이아웃 · 렌더러 · 파일 형식 (DOM 의존 없음)
packages/editor편집 UI
apps/obsidianObsidian 플러그인 셸
apps/desktop데스크톱 셸
apps/web웹 셸

플랫폼 의존 기능(파일 I/O, 텍스트 폭 측정)은 인터페이스(포트)로 정의하고, 셸이 어댑터 구현체를 주입한다(의존성 주입).

결과

  • 좋아지는 점: 기능 추가가 세 대상에 동시에 반영된다. core를 DOM 없이 단위 테스트할 수 있다.
  • 감수하는 점: 세 환경 모두에서 돌아가는 웹 기술로 제한된다. → ADR-0003
  • 후속 작업: 모노레포 도구(pnpm workspaces 등) 선택, 개발 순서 결정 → DR-0002