ADR-0018: 저장되는 그림은 지금 화면 그대로이고, 접힘 상태도 파일에 저장한다
이후 변경
- 2026-11-21: 뷰 상태 가운데 접힘과 펴 보기도 실행 취소의 대상이 되었다(이름 띠 · 결과 기호는 그대로 대상이 아님). undo 스택은 내용과 뷰 상태를 함께 저장한다 → ADR-0048, UN1
- 2026-11-21: 펴 보인 호출 블록을 처음 펴면 Method의 접기 영역이 그 자리의 접기 영역(내용)으로 복사된다. 접힘은 지금처럼 뷰 상태지만, 이 복사는 내용이라 실행 취소 단계 하나가 된다 → ADR-0047
- 2026-11-19: 펴 보인 호출 블록 안의 접힘이 Method와 따로 저장된다. 파일의
view.folded에 호출 경로를 앞에 붙인 항목(b4/r3)이 든다 → ADR-0046- 2026-11-18: 펴 보인 호출 블록의 모습이 바뀌었다. 가는 점선 대신 펴진 접기 영역과 같은 3px 실선과 띠이고, 색(보라)으로 가른다. 저장되는 그림에도 화면 그대로 들어간다 → Q15-a
- 2026-11-03: 문서 설정 “텍스트를 외곽선으로 저장”을 켜면 저장되는 그림의 텍스트가 번들 글꼴의 외곽선(path)이 된다. 모습은 화면 그대로이고 적는 방식만 다르다. 저장 파일의 모델 요소에는 그림 부분의 지문(
drawing-sha256)이 들어, 다른 도구가 그림을 고쳤으면 열 때 알린다 → ADR-0045- 2026-11-01: 파일에 저장되는 뷰 상태에는 펴 보인 호출 블록과 결과 기호도 든다 → 2. 뷰 상태. 접고 펴는 펼침 삼각형(
▸▾)은 편집 중에만 보이는 표시라 저장되는 그림에 넣지 않는다 → Q2- 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). “보기 상태”는 뷰 상태다. → 01-architecture
- 2026-10-17: 펴진 접기 영역의 테두리가 파랑에서 무채색 2px가 되었다. 저장되는 그림에 들어가는 표시(문서 레이어)와 편집 중에만 뜨는 선택 표시(오버레이 레이어)를 색으로도 가르려는 것이다. 저장되는 그림은 여전히 지금 화면 그대로다 → 시각 디자인 원칙 3
- 2026-10-13: 펴진 접기 영역의 모습이 다시 바뀌었다. 왼쪽 세로 막대가 둘레의 굵은 테두리가 되었고(이름 띠는 그대로), 펴 보인 호출 블록은 가는 점선 테두리가 되었다. 접기 영역이 겹치거나 이어질 때 막대로는 알아보기 어려웠기 때문이다. 저장되는 그림에는 테두리와 점선도 화면 그대로 들어간다. 그리고 펴 보인 곳에만 있는 접기 영역이 생겨, 파일에 함께 저장하는 것이 하나 늘었다 → 접기 · 펼치기, 펴 보인 곳의 접기 영역, ux-decisions Q15
- 2026-10-11: 펴진 접기 영역의 모습이 바뀌었다. 이 문서를 쓸 때는 맨 위의 이름 띠뿐이었고, 지금은 왼쪽 세로 막대 + 맨 위의 이름 띠다(EasyCODE의 방식). 띠만으로는 접기 영역이 어디서 끝나는지 보이지 않았기 때문이다. 저장되는 그림에는 막대도 화면 그대로 들어간다 → R-EDIT-13, 2026-10-11-03-ux-review
- 2026-10-11: 내보내기 요구사항
^exp-png-folded(“모두 펼쳐서” 내보내기. 처음에는 “접힌 모양 그대로 PNG 내보내기”)를 없앴다. 이 문서의 그 링크는 이제 가리키는 곳이 없다. 모두 펼친 그림이 필요하면 화면에서 모두 펼친 뒤 내보낸다(파일의 접힘 상태가 바뀐다) → 2026-10-11-02-confirmations- 2026-10-11: 이 문서가 후속 작업으로 남긴 “접고 펴기를 실행 취소에 넣을지”를 정했다. 넣지 않는다. 접힘 상태는 파일에 저장되지만 접고 펴기는 되돌리기의 대상이 아니다. 접기 영역을 만들고 푸는 것은 대상이다 → R-EDIT-13
배경
ADR-0016은 접힘 상태를 파일 밖에 두고, 저장되는 그림은 항상 모두 펼친 모양으로 그리기로 했다.
그 뒤 프로토타입을 써 보며 접기가 달라졌다. (R-EDIT-13)
- 선택 영역을 접던 것이 접기 영역이 되었다. 접기 영역과 그 이름은 모델에 저장된다. (ADR-0017)
- 펴진 접기 영역은 맨 위의 이름 띠로 보인다. 띠만큼 그림이 길어진다.
이렇게 되니 화면에서 보는 그림과 저장되는 그림이 눈에 띄게 달라졌다. 메인테이너는 접어서 정리한 모양, 이름 띠가 붙은 모양 그대로를 문서에 넣고 싶어 한다. “저장되는 그림은 현재 보이는 상태대로 저장하면 좋겠어요.” (2026-10-10)
지켜야 할 요구사항은 그대로다.
결정 기준
- 화면에서 본 모양과 문서에 들어간 그림이 같아야 한다.
- 그림은 파일 안의 모델만으로 다시 렌더링할 수 있어야 한다. 그림이 접힌 모양이면 접힘 상태도 파일 안에 있어야 한다.
- 다시 열었을 때, 그리고 다른 기기에서 열었을 때도 같은 모양이어야 한다.
검토한 대안
A. 지금대로: 접힘은 파일 밖, 그림은 펼친 모양 (ADR-0016)
- 장점: 접고 펴기만 해서는 파일이 바뀌지 않는다. 그림만 보는 사람도 전체 로직을 본다.
- 단점: 화면과 그림이 다르다. 접어서 정리한 그림을 문서에 넣으려면 PNG로 따로 내보내야 하고, 그 PNG는 편집할 수 없다.
B. 그림은 화면 그대로, 접힘 상태는 파일 밖
- 장점: 모델이 그대로다.
- 단점: 그림을 모델만으로 다시 만들 수 없다. 다른 기기에서 열어 저장하면 그림이 펼친 모양으로 바뀐다. 요구사항 두 가지(R-FMT-03, R-FMT-05)와 어긋난다.
C. 그림은 화면 그대로, 접힘 상태도 파일에 저장
- 장점: 화면과 그림이 같다. 그림을 파일만으로 다시 만들 수 있다. 어느 기기에서 열어도 저장할 때의 모양이다. 접힌 그림도 편집 가능한 원본이다.
- 단점: 접고 펴기만 해도 파일과 노트의 그림이 바뀐다(git diff가 생긴다). 그림만 보는 사람은 접힌 칸 안을 볼 방법이 없다.
결정
C. 저장되는 그림은 지금 화면 그대로 렌더링하고, 그 화면을 만든 뷰 상태를 파일에 함께 저장한다.
- 그림에 들어가는 것: 접힌 접기 영역은 접힌 칸으로, 접힌 제어 블록은 ”⋯ 블록 n개” 줄로, 펴진 접기 영역의 이름 띠는 보이는 대로. 선택 테두리처럼 편집 중에만 뜨는 표시는 넣지 않는다.
- 파일에 함께 저장하는 뷰 상태: 어느 접기 영역과 어느 제어 블록(갈래)이 접혀 있는지, 이름 띠를 보이는지.
- 파일을 열면 저장할 때의 모양으로 연다.
- 뷰 상태는 다이어그램의 내용(블록과 구조)과 별도 구조로 둔다. 내용만 비교(diff)하거나 모두 펼친 그림을 만들 때 떼어 낼 수 있어야 한다.
결과
- 좋아지는 점: 화면에서 정리한 모양이 그대로 문서에 들어간다. 접힘이 기기와 배포 대상을 넘어 옮겨진다. 접힌 그림을 PNG로 따로 내보낼 필요가 줄어든다.
- 감수하는 점: 접고 펴기만 해도 파일이 바뀐다. 저장된 그림만 보는 사람은 접힌 칸 안의 로직을 볼 수 없다.
- 후속 작업
- 접고 펴는 것이 파일을 바꾸므로, 접고 펴기를 실행 취소(R-EDIT-02) 대상에 넣을지 정한다.
- “모두 펼친 그림”이 필요한 때를 위한 길을 정한다 (예: 모두 펼쳐서 내보내기). exp-png-folded는 뜻이 뒤집히므로 고친다.
- 파일 형식 01-file-format에 뷰 상태의 자리를 넣는다.