"잠깐만요, 원래 되는 건데..."

정부사업 최종 발표회. 심사위원 5명이 앞에 앉아있다. 9주간 만든 제조 AI 시스템을 보여줄 차례.

"그럼 데모를 시작하겠습니다."

화면을 띄웠다. Streamlit이 로딩 중이다.

...

...로딩 중...

"네트워크가 좀 느린 것 같은데... 잠깐만요."

30초가 지났다. 심사위원들이 시계를 본다.

드디어 화면이 떴다. 에러코드를 입력했다.

Error: OpenAI API key is invalid or expired.
Please check your OPENAI_API_KEY environment variable.

"아... 원래 되는 건데... API 키가..."

9주간의 노력이 3분 만에 증발했다.

---

왜 데모가 실패하는가?

원인	빈도	해결책
네트워크 불안정	40%	오프라인 백업 영상
API 키 만료/한도 초과	25%	사전 확인 + Mock 모드
데모 데이터 미준비	20%	시나리오별 데이터 세팅
환경 세팅 차이	10%	발표 직전 리허설
진짜 버그	5%	충분한 테스트

머피의 법칙: 데모에서 실패할 수 있는 건 반드시 실패한다.

---

프로 개발자의 데모 원칙

데모의 3가지 불변 법칙
━━━━━━━━━━━━━━━━━━━━━
1. 라이브로 보여준다 (녹화 영상이 아님을 증명)
2. 백업 영상을 반드시 준비한다 (실패 시 대비)
3. 데이터를 미리 세팅한다 (실시간 생성 X)

가장 완벽한 데모:

"지금 라이브로 보여드리겠습니다. 혹시 네트워크 문제가 발생하면 미리 녹화한 영상으로 동일한 시연을 보여드리겠습니다."

이 한마디가 프로와 아마추어를 가른다.

---

오늘 만들 것

산출물	목적
데모 시나리오	뭘 어떤 순서로 보여줄 것인가
데모 스크립트	뭘 말하면서 보여줄 것인가
데모 데이터	어떤 데이터로 보여줄 것인가
백업 영상	실패 시 대비 녹화 영상

데모는 즉흥이 아니다. 철저한 대본이다.