ADR-0004: 구조 편집기 (트리 모델 + 자동 레이아웃)

이후 변경

  • 2026-10-10: 한 문서에 다이어그램을 여러 개 두기로 했고(#P1), 다른 다이어그램을 부르는 호출 블록이 생겼다. 문서는 트리 하나가 아니라 트리 여러 개(포레스트)이고, 호출 블록이 다른 트리를 참조한다 → R-EDIT-18, R-BLK-07
  • 2026-10-11: 머리가 있는 다이어그램을 Event와 Method로 구분했다. 호출 블록은 Method만 부르고, 호출 블록의 글자는 부르는 Method의 머리 글자와 따로 적는다. → ADR-0021
  • 2026-10-11: 호출 블록은 이름을 글자로 갖지 않는다. 이름은 부르는 Method의 머리를 따르고, 호출 블록에는 인자와 결과만 적는다. → ADR-0022
  • 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). → 01-architecture

배경

NS 차트는 블록 안에 블록이 중첩되는 트리 구조이고, 화살표 없이 위에서 아래로 진행한다. 편집기의 데이터 모델을 “도형과 좌표”(자유 배치 그래픽 모델)로 둘지 “구조”(트리)로 둘지 정해야 한다.

결정 기준

  • 구조적으로 잘못된 차트를 만들 수 없어야 한다. (R-NFR-01)
  • 텍스트를 고치면 크기와 배치가 자동으로 맞춰져야 한다. (R-LAY-01, R-LAY-02)
  • 감싸기, 풀기 같은 구조 편집을 지원해야 한다. (R-EDIT-06)
  • 코드 변환으로 확장할 수 있어야 한다. (3.6 코드 연동)

검토한 대안

자유 배치 그림판 (도형 + 좌표)

  • 장점: 일반 다이어그램 도구와 같은 조작감
  • 단점: 잘못된 구조를 막을 수 없음, 텍스트를 고칠 때마다 손으로 크기 조정, 코드 변환이 어려움

구조 편집기 (트리 모델 + 자동 레이아웃)

  • 장점: 항상 올바른 구조, 크기·배치 자동, 구조 편집과 코드 변환이 자연스러움
  • 단점: 사용자가 위치를 마음대로 조정할 수 없음, 레이아웃 알고리즘을 직접 만들어야 함

결정

모델은 트리로 두고, 레이아웃(위치와 크기)은 트리에서 자동 계산한다. 사용자는 좌표를 다루지 않는다. 모든 모델 변경은 불변식을 지키는 편집 명령으로만 한다(커맨드 패턴).

결과

  • 좋아지는 점: 구조 오류가 원천적으로 차단된다. 레이아웃이 순수 함수라 테스트하기 쉽다.
  • 감수하는 점: 블록별 수동 위치·크기 조정은 지원하지 않는다.
  • 후속 작업: 노드 타입과 불변식 → 01-model, 레이아웃 알고리즘 → 02-layout