Canvas에서 재료 조립하기

Canvas는 문서와 에셋을 카드로 펼쳐 관계와 흐름을 공간적으로 구상하는 Binder 단위 작업면이다. 카드 위치와 연결은 Canvas board에 저장되며 Markdown 원문의 문장이나 heading 순서는 바뀌지 않는다.

기능 ID	기능	이 장의 실증 범위
VW-21	Assembly Canvas	Cart의 세 문서를 카드로 분산하고 전체 보기에 맞춤
VW-22	Canvas 저장·복원	자동저장 Saved, 닫기·재열기 뒤 카드 내용과 위치 복원

준비

1. 조립 실험실을 Binder로 연다.
2. 01_product-story.md, 02_release-metrics.md, 03_release-roadmap.md를 Cart에 담는다.
3. 상단의 캔버스를 연다.

처음 연 board에 카드가 없으면 Drag from Cart or start with Scatter Cart. 안내가 보인다.

Cart 항목을 한 번에 펼치기

1. toolbar의 Scatter Cart를 누른다.
2. 상태줄이 3 cards인지 확인한다.
3. Fit canvas to view를 눌러 모든 카드를 화면 안에 맞춘다.

Scatter는 Cart의 현재 항목을 다음 빈 위치에 카드로 만든다. 같은 원문 참조를 중복해서 별도 문서로 만들지 않으며, 카드는 제목과 Binder 기준 경로를 보여 준다.

화면 이동과 선택

• 빈 배경을 drag하면 board를 이동한다.
• 확대·축소 버튼으로 세부 배치를 확인한다.
• Fit canvas to view는 현재 카드 전체가 보이도록 viewport를 다시 맞춘다.
• 카드를 선택해 이동하면 위치 변경이 board의 dirty state가 된다.
• 여러 항목을 선택할 때는 Shift를 사용한다.

Canvas 배치는 아이디어의 공간적 표현이다. 이 위치를 Markdown 문서의 목차 순서나 게시 페이지의 CSS 배치로 간주하지 않는다.

자동저장 확인

변경 직후 상태는 Saving을 거쳐 Saved가 된다. Saved를 보기 전에 앱을 닫지 말고, 오류가 보이면 원인을 해결한 다음 다시 확인한다.

닫았다가 다시 열어 복원 확인

1. Saved를 확인한다.
2. Canvas 탭을 닫는다.
3. 같은 Binder에서 Canvas를 다시 연다.
4. 카드 수, 제목, 경로와 위치가 같은지 확인한다.

실증 시나리오는 세 카드의 표시 문자열과 transform snapshot을 닫기 전후 비교했고, 네 원본 파일의 SHA-256도 전후 동일함을 확인했다.

실패와 복구

상태	의미	조치
Idle	아직 저장할 변경이 없음	정상 상태
Saving	board 파일 기록 중	완료될 때까지 기다린다
Saved	현재 board 변경 저장 완료	닫기·재열기로 복원 확인 가능
Save failed	board 저장 실패	오류 문구와 Binder 쓰기 권한을 확인하고 다시 시도
Scope fallback	선택 범위 대신 Binder 범위를 사용	의도한 Binder와 현재 scope를 대조

원본이 이동·삭제된 카드는 경로가 끊길 수 있다. 카드가 남아 있다는 이유로 원문이 존재한다고 가정하지 말고, 카드를 열어 source를 확인한다.

실증 경계

이 예제는 Cart 분산, fit-to-view, 자동저장, 재열기 복원과 원본 보존을 검증한다. Canvas 카드의 위치가 게시 페이지 배치가 된다고 주장하지 않으며, Canvas를 자유형 데이터베이스로 설명하지 않는다.