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/obsidian | Obsidian 플러그인 셸 |
apps/desktop | 데스크톱 셸 |
apps/web | 웹 셸 |
플랫폼 의존 기능(파일 I/O, 텍스트 폭 측정)은 인터페이스(포트)로 정의하고, 셸이 어댑터 구현체를 주입한다(의존성 주입).