ADR-0029: 문서는 불변 객체로 다루고, undo는 이전 스냅숏으로 돌아가는 것으로 한다

이후 변경

  • 2026-11-21: undo 스택의 스냅숏은 Content가 아니라 Doc(내용과 뷰 상태)이다. 접고 펴기와 펴 보기도 한 단계이고, 되돌릴 때 이름 띠 · 결과 기호는 지금 값을 둔다 → ADR-0048
  • 2026-11-01: undo 스택은 core가 아니라 editor에 두고 500단계까지 쌓는다. 바꿀 것이 없는 명령은 받은 내용과 같은 객체를 돌려주고, editor는 그것을 쌓지 않는다 → 4. 편집 명령, 2. 상태와 선택
  • 2026-10-25: 레이아웃은 두 단계의 순수 함수이고 고칠 때마다 문서 전체를 다시 센다(증분 없음) → ADR-0037
  • 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). → 01-architecture

배경

내용을 바꾸는 일은 모두 실행 취소(undo)의 대상이다(6. 실행 취소). 편집 명령은 감싸기 · 풀기 · 지우기 · 옮기기 · 접기 영역 만들기 · 갈래 순서 바꾸기 · 호출 블록 풀기 등 이미 서른 가지를 넘는다. undo의 구현 방식은 01-architecture의 초안(2026-10-13)에 Claude가 정해 적었고, 2026-10-17에 시안 M20의 A4로 확인받았다.

결정 기준

  • undo한 문서가 이전 문서와 늘 똑같다
  • 명령을 더할 때 undo 때문에 더 구현할 것이 없다
  • 블록 500개쯤의 문서에서 메모리 사용량이 감당할 만하다

검토한 대안

그림은 시안 M20의 A4에 있다: https://claude.ai/artifact/R8RJxg8V1qweiMfusMKk87 (저장소의 사본 journal/assets/2026-10-17-architecture-proposals-study.html)

대안 A: 문서를 불변으로, 실행 취소는 앞의 판으로 돌아가기

  • 장점: undo의 코드가 하나다. undo한 결과가 어긋날 수 없다. 명령은 “문서를 받아 새 문서를 돌려주는 순수 함수”라 테스트하기 쉽다
  • 단점: 스냅숏을 여럿 보관한다. 바뀌지 않은 하위 트리를 스냅숏끼리 공유하면(구조적 공유) 크게 늘지 않는다

대안 B: 명령마다 되돌리는 명령을 짝으로 짠다

  • 장점: 메모리 사용량이 가장 적다
  • 단점: 역연산이 조금만 어긋나도 undo한 문서가 이전과 달라진다. 명령마다 역연산을 구현하고 테스트해야 한다

결정

대안 A. 메인테이너: “A4 · 1번” (2026-10-17).

  • 명령은 문서를 변경하지 않고 새 문서를 만든다. 바뀌지 않은 블록과 다이어그램은 이전 문서와 공유한다(구조적 공유).
  • undo는 이전 스냅숏을, redo는 다음 스냅숏을 현재 문서로 되돌린다.
  • 뷰 상태(접힘, 펴 보기)를 바꾸는 명령은 같은 경로를 지나지만 undo 스택에는 남기지 않는다(4.5 내용과 뷰 상태).

결과

  • 좋아지는 점: undo의 버그가 명령의 수만큼 늘지 않는다. 불변식 검사를 “새 문서가 만들어질 때” 한 곳에서 한다.
  • 감수하는 점: 스냅숏을 몇 개까지 보관할지(undo 스택의 깊이) 정해야 한다.
  • 후속 작업: 보관할 스냅숏의 수, 불변 자료 구조를 직접 구현할지 라이브러리를 쓸지 → 01-model