> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Draft

> 안전하게 편집하는 곳 — 배포할 때까지 프로덕션에 절대 영향 없음.

모든 Flow 는 하나의 **Draft** — 작업하는 변경 가능 상태. 만들면서 편집이 자동 저장. Draft 에 관한 어떤 것도 프로덕션에 절대 영향 안 함.

## Draft vs. Published

* **Draft** — 변경 가능. 편집 접근 있는 누구나 편집 가능. 자동 저장. 프로덕션 트래픽에 보이지 않음.
* **Published** — 불변. 현재 Draft 배포로 설정. 프로덕션이 실행하는 것.

Draft 를 Published 에서 자유롭게 분기 가능. Draft 가 언퍼블리시 변경 있으면 Flow 가 "unpublished" 배지 표시.

## Draft 에서 테스트

배포 없이 Draft 실행 두 방법:

* **Test 패널** — 캔버스 우측 상단. 입력 타이핑, Draft 에 실행. 프로덕션이었을 것처럼 전체 트레이스. 부수 효과 없음 (도구가 테스트 자격증명 사용; "테스트에서 실행하면 안 됨" 표시된 액션 스텁).
* **Draft URL** — Draft 실행하는 프라이빗 URL. 내부 테스트용 팀원과 공유. 워크스페이스 인증 없이 접근 불가.

프로덕션 URL (채팅, 웹훅) 은 항상 배포 버전 실행. Owner 도 프로덕션 트래픽 실수로 Draft 로 못 보냄.

## 동시 편집

여러 사람이 같은 Draft 편집 가능:

* 커서 프레즌스 — 누가 어느 블록에 있는지 봄.
* 필드 레벨 잠금 — 누군가 프롬프트에 타이핑 중이면 다른 사람은 보되 덮어쓰기 못함.
* 저장 시 병합 — 충돌 없는 필드 편집 자동 병합.
* 충돌 해결 — 진짜 충돌 편집은 Nora 가 두 번째 저장자에게 선택/병합 프롬프트.

실시간 협업이 최대 \~10 동시 편집자까지 안정적 동작.

## 버전에서 Draft 복원

Draft 를 옛 상태로 롤:

**Flow → Versions → 버전 선택 → Restore to Draft**.

Draft 가 선택된 버전 콘텐츠로 덮어씀. 확인 필요 (Draft 덮어쓰기는 파괴적). 프로덕션 안 만짐.

유용:

* 나쁜 Draft 상태에서 복구.
* 옛 버전에서 새 수정 시작.
* 현재 Draft 를 옛 베이스라인과 비교 (복원 후 인플레이스 편집).

## Draft 전용 설정

일부 설정이 Draft 테스트에 적용:

* **Draft 데이터 소스** — Draft 에만 소스 붙임 (예: 테스트 문서 컬렉션). 프로모트하지 않으면 Published 로 안 옮겨감.
* **Draft 변수** — Draft 의 변수가 Published 와 다른 값 가질 수 있음. dev 값으로 테스트, prod 값으로 배포.

프로덕션 동작 오염 없이 테스트에 둘 다 유용.

## Draft 잠금

미묘한 변경 중 동시 편집 방지를 위해 Draft 얼림:

**Flow → Draft → Lock**. 잠긴 사람 (또는 Owner) 만 잠금 해제까지 편집 가능.

드물지만 복잡한 재구조화하고 팀원이 충돌 변경 안 하기 원할 때 유용.

## Draft 변경 폐기

Draft 가 버리고 Published 에서 새로 시작하고 싶은 변경 있으면:

**Flow → Draft → Reset to Published**. 확인 필요. 모든 Draft 전용 편집 잃음.

체크포인트 유지 원하면 특정 버전에서 Draft 복원 선호. 변경이 틀렸다 알 때 리셋.

## CLI 의 Draft

```bash theme={null}
nora flows snapshot > draft.json    # 현재 Draft 익스포트
nora flows apply --file draft.json  # JSON 을 새 Draft 로 씀
```

흔한 워크플로우: Draft 스냅샷, JSON 로컬 편집 (벌크 find-replace, 구조 변경), 재적용. 큰 리팩터에 UI 클릭보다 빠름.