아키텍처 결정 기록

(← 아뜰리에)

코드의 구조, 모델, 파일 형식, 기술 선택에 관한 결정입니다. 아키텍처가 아닌 결정은 결정 기록(DR)에 같은 형식으로 둡니다(2026-10-17 → DR-0001). 그때 옮긴 열 개의 번호(0011, 0013, 0015, 0019, 0020, 0023, 0024, 0025, 0027, 0028)는 비워 두고 다시 쓰지 않습니다. 다루는 것에 따라 묶었고, 묶음 안에서는 번호 순서입니다.

기록하는 법

번호제목상태
0001ADR로 아키텍처 결정을 기록한다승인

배포 대상과 기술

번호제목상태
0002세 대상 배포 + 공유 코어 모노레포승인
0003구현 언어 TypeScript승인
0009데스크톱 프레임워크 (Electron / Tauri)제안됨
0010UI 프레임워크: 둘레의 화면 부품은 React로승인
0012Google Drive 연동은 웹 버전 위에 얹는다승인
0036코드는 src/ 아래의 pnpm 모노레포로 두고, core는 패키지 하나, Obsidian의 manifest.json 사본은 저장소 맨 위에 둔다승인
0038빌드는 Vite(웹) · esbuild(Obsidian), 시험은 Vitest · fast-check · Playwright, 코드 검사는 ESLint + Prettier, 시험 파일은 소스 옆승인
0050Claude skill은 앱의 코드를 Node 스크립트 하나로 번들해 커밋하고, Release의 zip과 플러그인 마켓플레이스로 배포한다승인

편집 모델

번호제목상태
0004구조 편집기: 트리 모델 + 자동 레이아웃승인
0008선택은 같은 부모 아래 연속 범위승인
0021Event와 Method를 구분한다 (낮은 아치 머리, 호출 블록은 Method만)승인
0022호출 블록의 이름은 Method의 머리를 따른다 (인자와 결과만 적음)승인
0049Method가 없는 호출 블록은 이름 호출 하나로 (external · lost를 named로 합침)승인

파일 형식과 저장

번호제목상태
0005모델 내장 SVG를 저장 형식으로 사용승인
0006확장자 .ns / .ns.svg승인
0007모델 직렬화 형식 JSON승인
0014Google Drive에서 만드는 파일은 .ns.svg로 저장한다승인
0016접힘 상태는 파일에 저장하지 않는다대체됨 (→ 0018)
0017접는 범위의 이름은 모델에 저장한다승인
0018저장되는 그림은 지금 화면 그대로이고, 접힘 상태도 파일에 저장한다 (0016을 대체)승인
0026글꼴을 번들해 텍스트 폭을 글꼴 메트릭으로 계산하고, 저장되는 SVG에는 서브셋 글꼴을 임베드한다승인
0034기본 블록 글꼴은 D2Coding 보통 굵기 하나, 한자를 뺀 나머지 문자를 싣는다승인
0035모델 네임스페이스 URI는 저장소 주소, 프로토타입의 v0 파일은 열지 않는다승인
0039저장 파일의 서브셋 글꼴은 WOFF로 넣고, 압축은 판을 고정한 JS zlib 라이브러리로 한다승인
0040웹의 화면 글꼴은 문자 범위의 조각으로 나눠, 화면에 나온 글자의 조각만 받는다승인
0041그림의 고정 문구(“참” · “거짓” 등)는 저장할 때의 화면 언어가 아니라 문서 설정의 언어를 따른다승인
0043공유 링크는 문서 전체를 압축해 URL의 fragment에 담는다승인
0044문서에는 테마의 이름만 적고, 테마는 종이의 종류(밝음 · 어두움)를 가진다. 편집 레이어는 그 종류로 색을 고른다승인
0045내보내기는 한 장면에서: PDF는 장면에서 직접 쓰는 작은 작성기, 텍스트 외곽선은 번들 TTF의 글리프, 그림이 고쳐졌는지는 모델 요소의 그림 지문(SHA-256)으로 안다승인
0046펴 보인 호출 블록의 접힘은 경로마다 view.folded에 경로를 앞에 붙여 저장한다승인
0047호출 블록을 처음 펼 때 Method의 접기 영역을 그 자리의 접기 영역으로 복사한다승인
0048접고 펴기도 실행 취소의 단계로 하고, undo 스택에는 내용과 접힘을 함께 저장한다승인

편집 엔진과 화면

번호제목상태
0029문서는 불변 객체로 다루고, undo는 이전 스냅숏으로 돌아가는 것으로 한다승인
0030화면도 저장되는 SVG와 같은 렌더러로 그리고, 렌더링 백엔드는 교체할 수 있게 둔다승인
0031editor의 필요 인터페이스 DocumentStore · SettingsStore를 셸이 구현한다승인
0032구문 강조는 블록 글자의 종류마다 토크나이저 하나로 한다승인
0033editor가 제공 인터페이스 CommandRegistry · SettingsSchema를 노출하고, 셸은 그것을 호스트의 확장 지점에 등록한다승인
0037레이아웃은 두 단계의 순수 함수로 하고, 고칠 때마다 문서 전체를 다시 센다. 폭 테이블은 구간 목록, 없는 글자는 전각승인
0042블록 텍스트의 언어는 글꼴을 바꾸지 않는다(모든 언어를 기본 블록 글꼴로). 언어마다의 렉서는 core에 둔다승인

새 결정은 ADR 템플릿을 복사해서 다음 번호(0051부터)로 만들고, 위 목록의 맞는 묶음에 한 줄을 더합니다.

상태(ADR · DR 같음): 제안됨(검토 중) → 승인 → (필요하면) 대체됨 / 폐기

2026-10-12까지 ADR은 docs/03-adr/에 있었습니다. docs/에는 최종 모습만 두기로 하면서 이곳으로 옮겼습니다.

41건의 항목