'
+ + media_block(sl.get("clip"), sl["poster"], sl.get("title", ""))
+ + (f'{esc(sl["caption"])}' if sl.get("caption") else "")
+ + f'
{right}
')
+
+ elif kind == "compare":
+ # 09 번 스틸은 그 자체가 이미 좌우 비교 그림이다. 클립이 없는 상태에서 좌우 패널로
+ # 쪼개 각 칸에 넣으면 같은 비교가 두 겹으로 들어가 오히려 읽히지 않는다.
+ if sl.get("fallback") and not (has_clip(sl["left"].get("clip"))
+ or has_clip(sl["right"].get("clip"))):
+ body.append('
'
+ '재현 이미지'
+ f'
')
+ else:
+ panes = []
+ for side in ("left", "right"):
+ pane = sl[side]
+ panes.append(
+ f'
{esc(pane["label"])}'
+ + media_block(pane.get("clip"), pane["poster"], pane["label"])
+ + f'
")
+
+ else:
+ raise SystemExit(f"ERROR: 알 수 없는 슬라이드 종류: {kind}")
+
+ body.append(note(sl))
+ return (f'{idx:02d}'
+ + "".join(body) + "")
+
+
+def render(doc: dict, version: str) -> str:
+ slides = doc["slides"]
+ dots = "".join(f'' for i in range(len(slides)))
+ body = "".join(render_slide(sl, i) for i, sl in enumerate(slides))
+ today = datetime.date.today().isoformat()
+ return (
+ ''
+ ''
+ f"{esc(doc['title'])} — {esc(doc['audience'])}"
+ f""
+ f''
+ f'{body}'
+ '
'
+ ''
+ ''
+ '
'
+ '
← → 또는 버튼으로 이동 · F11 전체화면
'
+ f"")
+
+
+def main() -> None:
+ ap = argparse.ArgumentParser()
+ ap.add_argument("--out", default=str(HERE / "경영진-보고.html"))
+ args = ap.parse_args()
+
+ vf = REPO / "VERSION"
+ if not vf.is_file():
+ raise SystemExit("ERROR: VERSION 파일이 없습니다. 버전 없는 보고 자료는 만들지 않습니다.")
+ version = vf.read_text(encoding="utf-8").strip()
+
+ doc = json.loads((HERE / "deck.json").read_text(encoding="utf-8"))
+ out = pathlib.Path(args.out)
+ out.write_text(render(doc, version), encoding="utf-8")
+
+ wanted, have = [], []
+ for sl in doc["slides"]:
+ for c in ([sl.get("clip")] if sl.get("clip") else []) + \
+ [sl[s].get("clip") for s in ("left", "right") if isinstance(sl.get(s), dict)]:
+ if c and c not in wanted:
+ wanted.append(c)
+ (have if (CLIPS / c).is_file() else []).append(c)
+ missing = [c for c in wanted if c not in have]
+
+ print(f"{out} ({out.stat().st_size/1024:.0f} KB, 슬라이드 {len(doc['slides'])}장)", file=sys.stderr)
+ if missing:
+ print(f"클립 대기 {len(missing)}/{len(wanted)} — 해당 자리는 스틸로 대체됨: "
+ + ", ".join(missing), file=sys.stderr)
+ else:
+ print("클립 전량 배치됨. HTML 과 clips/ 폴더를 같이 옮기십시오.", file=sys.stderr)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/docs/deck/clips/.gitkeep b/docs/deck/clips/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/deck/deck.json b/docs/deck/deck.json
new file mode 100644
index 0000000..02d3c90
--- /dev/null
+++ b/docs/deck/deck.json
@@ -0,0 +1,203 @@
+{
+ "title": "작업장 안전 AI CCTV",
+ "subtitle": "쓰러진 사람을 3초 안에 알아채고, 경광등을 울리고, 증거를 남깁니다",
+ "audience": "경영진 보고",
+ "slides": [
+ {
+ "kind": "cover",
+ "image": "01-현장-설치.jpg",
+ "eyebrow": "제품 보고",
+ "title": "작업장 안전 AI CCTV",
+ "lead": "쓰러진 사람을 3초 안에 알아채고, 경광등을 울리고, 증거를 남깁니다.",
+ "foot": "감지 · 대응 · 증거 — 셋이 한 사슬로 묶인 시스템"
+ },
+ {
+ "kind": "statement",
+ "eyebrow": "문제",
+ "title": "CCTV는 이미 있습니다. 그런데 왜 사고를 못 막습니까.",
+ "columns": [
+ {
+ "head": "아무도 안 보고 있다",
+ "body": "카메라 수십 대를 사람이 실시간으로 볼 수는 없습니다. 화면은 사고가 난 뒤에 되감기 위한 것이 됩니다."
+ },
+ {
+ "head": "알아도 알릴 방법이 없다",
+ "body": "설령 감지해도 화면에만 뜨면 그것은 기록 장치입니다. 새벽 3시에 넘어진 사람은 아침까지 그대로입니다."
+ },
+ {
+ "head": "나중에 설명할 수 없다",
+ "body": "사고 조사에서 필요한 것은 영상이 아니라 시각·조치·통보의 기록인데, 그 기록이 남지 않습니다."
+ }
+ ]
+ },
+ {
+ "kind": "figure",
+ "eyebrow": "해결 구조",
+ "title": "하나의 사슬입니다",
+ "image": "05-사슬.png",
+ "note": "어느 한 칸이 비면 나머지가 무의미해집니다. 감지만 있으면 아무도 모르고, 대응만 있으면 나중에 설명할 수 없습니다."
+ },
+ {
+ "kind": "clip",
+ "eyebrow": "핵심 시연",
+ "title": "쓰러지면, 경광등이 켜집니다",
+ "clip": "v01-넘어짐-경광등.mp4",
+ "poster": "02-경광등.jpg",
+ "caption": "쓰러진 자세가 3초 지속되면 확정. 감지한 노드가 자기 GPIO로 직접 울립니다.",
+ "points": [
+ "서버도 인터넷도 거치지 않습니다 — 회선이 끊겨도, 서버가 죽어도 울립니다",
+ "10초 넘게 움직임이 없으면 최상위 위급으로 스스로 올라갑니다",
+ "1분 안에 담당자에게, 5분 안에 확인되지 않으면 상위 담당자에게"
+ ]
+ },
+ {
+ "kind": "figure",
+ "eyebrow": "판정 근거",
+ "title": "언제 감지되는지 설명할 수 있습니다",
+ "image": "08-넘어짐-감지-시퀀스.jpg",
+ "note": "한 프레임 보고 놀라서 울리는 것이 아니라, 자세가 지속되는지를 초 단위로 확인하고 단계적으로 올립니다. 도중에 일어서면 알람 없이 니어미스로만 기록됩니다 — 사고 전 신호가 통계로 쌓입니다."
+ },
+ {
+ "kind": "compare",
+ "eyebrow": "가장 많이 받는 질문",
+ "title": "앉으면 오탐이 나지 않습니까",
+ "left": {
+ "label": "울리지 않음",
+ "tone": "ok",
+ "clip": "v02-앉기-정상.mp4",
+ "poster": "09-앉기-vs-넘어짐.jpg",
+ "body": "쭈그려 앉거나 허리를 굽힌 자세는 세로가 여전히 깁니다."
+ },
+ "right": {
+ "label": "울림",
+ "tone": "alarm",
+ "clip": "v01-넘어짐-경광등.mp4",
+ "poster": "08-넘어짐-감지-시퀀스.jpg",
+ "body": "가로가 세로보다 넓어진 상태가 3초 이상 지속될 때만 확정합니다."
+ },
+ "note": "그래도 오탐은 납니다. 화면에서 오탐 표시 한 번이면 통계에서 빠지고, 감도 조정의 근거가 됩니다. 오탐율은 화면에 그대로 표시됩니다.",
+ "fallback": "09-앉기-vs-넘어짐.jpg"
+ },
+ {
+ "kind": "clip",
+ "eyebrow": "구역 규칙",
+ "title": "위험구역은 화면 위에 직접 그립니다",
+ "clip": "v04-구역진입.mp4",
+ "poster": "10-위험구역-판정.jpg",
+ "caption": "판정 기준은 발 위치입니다. 구역 안에 0.75초 이상 머물면 이벤트가 남습니다.",
+ "points": [
+ "경고 · 제한 · 협착 3단계로 위험도를 나눠 지정합니다",
+ "2인 1조 구역에 혼자 남으면 30초 뒤 사건이 됩니다",
+ "정원 초과 · 장시간 체류도 같은 방식으로 규칙화됩니다"
+ ]
+ },
+ {
+ "kind": "clip",
+ "eyebrow": "차별점",
+ "title": "감시 장비 자신의 고장도 신고합니다",
+ "clip": "v05-카메라-건드림.mp4",
+ "poster": "01-현장-설치.jpg",
+ "caption": "청소하다 카메라를 스치면 위험구역이 엉뚱한 바닥을 가리킵니다. 그런데 프레임은 계속 들어오고 화면은 정상으로 보입니다.",
+ "points": [
+ "화각 변경 · 렌즈 가림 · 조도 저하를 스스로 감지합니다",
+ "노드가 응답을 멈추면 서버가 하트비트의 부재로 판정합니다",
+ "\"아무도 확인하지 않았다\"는 사실 자체도 사건으로 기록됩니다"
+ ],
+ "kicker": "이것이 이 제품의 조용한 실패 방어선입니다. 대부분의 감시 시스템은 자기가 멈춘 것을 모릅니다."
+ },
+ {
+ "kind": "figure",
+ "eyebrow": "기대효과",
+ "title": "달라지는 것은 발견까지 걸리는 시간입니다",
+ "image": "07-대응시간.png",
+ "note": "사고를 없애지는 못합니다. 발견과 대응이 빨라질 뿐입니다 — 그런데 쓰러진 사람에게는 그 차이가 결과를 바꿉니다."
+ },
+ {
+ "kind": "metrics",
+ "eyebrow": "기대효과",
+ "title": "효과는 저희가 주장하지 않습니다. 시스템이 스스로 측정해 보여줍니다",
+ "items": [
+ {
+ "head": "평균 대응시간",
+ "body": "감지에서 확인까지 걸린 시간. 개선 활동의 성패가 이 숫자 하나로 드러납니다."
+ },
+ {
+ "head": "니어미스 : 사고 비율",
+ "body": "넘어질 뻔한 횟수가 쌓입니다. 사고가 나기 전에 어디가 위험한지 보입니다."
+ },
+ {
+ "head": "조치 전후 감지 밀도",
+ "body": "안전 조치를 한 구역에서 이벤트가 실제로 줄었는지 히트맵으로 비교합니다."
+ },
+ {
+ "head": "오탐율",
+ "body": "숨기지 않고 화면에 표시합니다. 신뢰할 수 있는 시스템인지 스스로 증명하게 합니다."
+ }
+ ],
+ "note": "공급자의 ROI 추정이 아니라 고객 화면의 숫자입니다."
+ },
+ {
+ "kind": "statement",
+ "eyebrow": "반드시 나올 질문",
+ "title": "\"근로자 감시 아닙니까\"",
+ "lead": "노조가 물을 것이고, 물어야 합니다. 답은 약속이 아니라 구조여야 합니다.",
+ "columns": [
+ {
+ "head": "영상을 녹화하지 않습니다",
+ "body": "실시간으로 들여다보는 화면 자체가 제품에 없습니다. 위험 상황이 감지된 순간에만 사진 3장이 남고, 7일 뒤 자동 삭제됩니다."
+ },
+ {
+ "head": "누구인지 모릅니다",
+ "body": "이름도 사번도 얼굴 인식도 없습니다. 얼굴은 카메라 쪽에서, 전송 전에 가려집니다."
+ },
+ {
+ "head": "근무태도 기능이 없습니다",
+ "body": "감지 17종 전부가 위험 상태입니다. 자리 비움·작업 속도는 만들 수 있는 기능 자체가 없습니다."
+ }
+ ],
+ "note": "존재하지 않는 데이터는 열람될 수 없고, 유출될 수 없고, 목적 외로 쓰일 수 없습니다. 접근 통제는 되돌릴 수 있지만 미수집은 되돌릴 수 없습니다."
+ },
+ {
+ "kind": "figure",
+ "eyebrow": "구성",
+ "title": "현장에 노드, 사무실에 대시보드",
+ "image": "06-구성도.png",
+ "note": "노드에서 서버로 가는 것은 스냅샷 3장과 메타데이터뿐입니다. 폐쇄망에서도 동작하며, 회선이 끊긴 동안의 이벤트는 노드에 쌓였다가 복구되면 올라갑니다."
+ },
+ {
+ "kind": "status",
+ "eyebrow": "현재 상태",
+ "title": "지금 어디까지 와 있습니까",
+ "done": {
+ "head": "완료 — 1.0.0 납품 버전",
+ "items": [
+ "감지 17종 · 통보 · 에스컬레이션 · 사고조사 패키지",
+ "자동 테스트 548건 통과 (엣지 308 · 서버 240)",
+ "납품 점검 43건 + 재감사 12건 전량 해소 — 판정 적합",
+ "폐쇄망 설치 패키지 · 역할별 사용설명서"
+ ]
+ },
+ "pending": {
+ "head": "남은 것 — 실장비 현장 검증",
+ "items": [
+ "경광등 실제 점등 · 카메라 감도 현장 튜닝",
+ "실제 영상으로 넘어짐 판정 타이밍 확인",
+ "보호구 미착용 · 중장비 근접 · 화재 감지는 모델 확보가 선행되어야 합니다"
+ ]
+ },
+ "note": "감지율 100%는 없습니다. 초기에는 오탐이 반드시 납니다. 그 사실을 숨기지 않는 것이 이 시스템을 계속 쓰게 만드는 조건입니다."
+ },
+ {
+ "kind": "closing",
+ "eyebrow": "요약",
+ "title": "이 시스템이 하는 일",
+ "lines": [
+ "쓰러진 자세가 3초 지속되면 확정하고,",
+ "감지한 노드가 즉시 경광등을 울리고,",
+ "1분 안에 담당자에게, 5분 안에 확인되지 않으면 위로 올립니다.",
+ "그리고 무슨 일이 있었는지 지울 수 없는 형태로 남깁니다."
+ ],
+ "foot": "감지 · 대응 · 증거"
+ }
+ ]
+}
\ No newline at end of file
diff --git a/docs/images/01-현장-설치.jpg b/docs/images/01-현장-설치.jpg
new file mode 100644
index 0000000..80a87cc
Binary files /dev/null and b/docs/images/01-현장-설치.jpg differ
diff --git a/docs/images/02-경광등.jpg b/docs/images/02-경광등.jpg
new file mode 100644
index 0000000..b46dfc2
Binary files /dev/null and b/docs/images/02-경광등.jpg differ
diff --git a/docs/images/03-엣지노드.jpg b/docs/images/03-엣지노드.jpg
new file mode 100644
index 0000000..0b962f4
Binary files /dev/null and b/docs/images/03-엣지노드.jpg differ
diff --git a/docs/images/04-위험구역.jpg b/docs/images/04-위험구역.jpg
new file mode 100644
index 0000000..30452dc
Binary files /dev/null and b/docs/images/04-위험구역.jpg differ
diff --git a/docs/images/05-사슬.png b/docs/images/05-사슬.png
new file mode 100644
index 0000000..4bf07d1
Binary files /dev/null and b/docs/images/05-사슬.png differ
diff --git a/docs/images/06-구성도.png b/docs/images/06-구성도.png
new file mode 100644
index 0000000..9a3688f
Binary files /dev/null and b/docs/images/06-구성도.png differ
diff --git a/docs/images/07-대응시간.png b/docs/images/07-대응시간.png
new file mode 100644
index 0000000..23e52e7
Binary files /dev/null and b/docs/images/07-대응시간.png differ
diff --git a/docs/images/08-넘어짐-감지-시퀀스.jpg b/docs/images/08-넘어짐-감지-시퀀스.jpg
new file mode 100644
index 0000000..eb4be5d
Binary files /dev/null and b/docs/images/08-넘어짐-감지-시퀀스.jpg differ
diff --git a/docs/images/09-앉기-vs-넘어짐.jpg b/docs/images/09-앉기-vs-넘어짐.jpg
new file mode 100644
index 0000000..9bca2e7
Binary files /dev/null and b/docs/images/09-앉기-vs-넘어짐.jpg differ
diff --git a/docs/images/10-위험구역-판정.jpg b/docs/images/10-위험구역-판정.jpg
new file mode 100644
index 0000000..81a6ea2
Binary files /dev/null and b/docs/images/10-위험구역-판정.jpg differ
diff --git a/docs/images/11-2인1조.jpg b/docs/images/11-2인1조.jpg
new file mode 100644
index 0000000..de7dc41
Binary files /dev/null and b/docs/images/11-2인1조.jpg differ
diff --git a/docs/소개서-이미지.json b/docs/소개서-이미지.json
new file mode 100644
index 0000000..c2814ce
--- /dev/null
+++ b/docs/소개서-이미지.json
@@ -0,0 +1,60 @@
+{
+ "images": [
+ {
+ "file": "01-현장-설치.jpg",
+ "heading": "## 1. 왜 만들었나",
+ "placement": "before-heading",
+ "caption": "작업장에 설치된 카메라와 현장 경광등."
+ },
+ {
+ "file": "05-사슬.png",
+ "heading": "## 2. 무엇을 하는가",
+ "caption": "감지 → 대응 → 증거. 어느 한 칸이 비면 나머지가 무의미해집니다."
+ },
+ {
+ "file": "08-넘어짐-감지-시퀀스.jpg",
+ "heading": "### 2-1. 감지 — 무엇을 알아채는가",
+ "caption": "넘어짐 감지 단계. 1초 위험 자세 → 3초 확정 → 10초 미동 없음. 도중에 일어서면 니어미스로만 기록됩니다."
+ },
+ {
+ "file": "09-앉기-vs-넘어짐.jpg",
+ "heading": "### 2-1. 감지 — 무엇을 알아채는가",
+ "caption": "앉은 자세와 넘어진 자세는 형태와 지속 시간으로 구분합니다."
+ },
+ {
+ "file": "10-위험구역-판정.jpg",
+ "heading": "### 2-1. 감지 — 무엇을 알아채는가",
+ "caption": "위험구역은 화면 위에 직접 그립니다. 판정 기준은 발 위치입니다."
+ },
+ {
+ "file": "11-2인1조.jpg",
+ "heading": "### 2-1. 감지 — 무엇을 알아채는가",
+ "caption": "자세뿐 아니라 구역 안의 인원 수도 안전 조건입니다."
+ },
+ {
+ "file": "02-경광등.jpg",
+ "heading": "### 2-2. 대응 — 어떻게 사람에게 닿는가",
+ "caption": "현장 경광등은 감지한 노드가 자기 GPIO로 직접 울립니다. 서버도 인터넷도 거치지 않습니다."
+ },
+ {
+ "file": "07-대응시간.png",
+ "heading": "### 3-1. 즉시 달라지는 것",
+ "caption": "발견까지 걸리는 시간의 변화."
+ },
+ {
+ "file": "06-구성도.png",
+ "heading": "## 4. 시스템 구성",
+ "caption": "카메라 → 엣지 노드 → 대시보드. 노드에서 서버로 가는 것은 스냅샷 3장과 메타데이터뿐입니다."
+ },
+ {
+ "file": "03-엣지노드.jpg",
+ "heading": "### 4-1. 엣지 노드",
+ "caption": "Raspberry Pi 5 + Hailo-8 가속기."
+ },
+ {
+ "file": "04-위험구역.jpg",
+ "heading": "## 6. 납품과 운영",
+ "caption": "설치 대상이 되는 전형적인 작업 공간."
+ }
+ ]
+}
\ No newline at end of file
diff --git a/docs/영상-브리프.md b/docs/영상-브리프.md
new file mode 100644
index 0000000..5affcb1
--- /dev/null
+++ b/docs/영상-브리프.md
@@ -0,0 +1,196 @@
+# 경영진 보고용 3초 영상 브리프
+
+> 대상: `docs/deck/` 경영진 보고 덱에 들어갈 짧은 클립.
+> 이미 확보된 스틸 11장(`docs/images/`)은 그대로 씁니다 — 영상은 **스틸이 못 하는 것**만 발주합니다.
+
+---
+
+## 0. 먼저 읽을 것
+
+### 0-1. ⚠ 모든 클립은 "재현 영상"입니다
+
+이 클립들은 실제 제품이 동작하는 화면 녹화가 아니라 **연출된 재현**입니다.
+경영진 보고에서 이를 실제 동작 영상처럼 보여주면 그건 허위 시연입니다.
+
+**덱 템플릿이 모든 클립에 `재현` 배지를 자동으로 붙이도록 만들었습니다.** 지워지지 않게
+코드에 박아 뒀습니다 — 발표자가 깜빡할 수 있는 종류의 것이라서요.
+
+실제 제품 화면이 필요한 자리에는 **실화면 캡처 8장**(`server/deploy/manual/shots/`)이 이미
+있습니다. 그건 진짜입니다. 재현 클립과 실화면을 덱에서 시각적으로 구분해 두었습니다.
+
+### 0-2. 스틸로 충분한 것은 발주하지 않았습니다
+
+판정 조건·구성도·타임라인은 정지 이미지가 더 잘 전달합니다(읽을 시간이 필요하므로).
+아래 6종은 **움직임이 있어야만 전달되는 것**만 골랐습니다.
+
+### 0-3. 공통 사양
+
+| 항목 | 값 |
+|---|---|
+| 길이 | **3초** (±0.3초) |
+| 컷 | **단일 컷, 편집 없음.** 카메라 고정 — CCTV 시점이어야 설득력이 있습니다 |
+| 화면비 | 16:9, **1920×1080 이상** |
+| 형식 | `.mp4` (H.264 + yuv420p). 브라우저 재생용 |
+| 소리 | **없음.** 회의실에서 음소거로 재생합니다 |
+| 재생 | 1회 재생 후 **마지막 프레임 정지**. 넘어지는 장면이 무한 반복되면 보기 불편합니다 |
+| 얼굴 | **식별 불가**. 뒷모습·측면·헬멧·바닥을 향한 얼굴 |
+| 조명 | 실제 공장 조도. 지나치게 영화적인 조명은 재현 티가 나서 오히려 신뢰를 깎습니다 |
+| 색 | 스틸 11장과 같은 톤 — 네이비 작업복, 흰 헬멧, 회색 콘크리트 바닥, 노란 안전선 |
+
+### 0-4. 카메라 시점을 고정하세요
+
+**모든 클립이 같은 공장, 같은 높이(약 3~4m), 같은 앵글이면 가장 좋습니다.**
+클립마다 장소가 바뀌면 "여러 곳에서 찍은 홍보 영상"처럼 보이고, 한 곳에서 이어지면
+**"이 시스템이 이 공장을 보고 있다"** 로 읽힙니다. 후자가 훨씬 강합니다.
+
+가능하면 `08-넘어짐-감지-시퀀스.png` 의 공장을 그대로 쓰세요.
+
+---
+
+## A. 발주 목록
+
+### A-1. `v01-넘어짐-경광등.mp4` ★P0 — 이 덱에서 가장 중요한 3초
+
+**이 클립이 말해야 하는 것**
+
+> 사람이 쓰러지고, **경광등이 켜진다.** 그 사이에 아무도 없다.
+
+**왜 필요한가** — 이 제품의 전부입니다. 감지가 대응으로 이어지는 순간을 정지 이미지로는
+보여줄 수 없습니다. 경영진이 기억할 3초가 있다면 이것입니다.
+
+**타임라인**
+
+| 시각 | 화면 |
+|---|---|
+| 0.0s | 작업자가 기계 앞에 서 있음. 화면 한쪽 상단에 **꺼진 경광등**이 보임 |
+| 0.5s | 무너지기 시작 |
+| 1.2s | 바닥에 쓰러짐. 헬멧이 굴러감 |
+| 2.0s | **경광등 점등** — 붉은 빛이 주변 바닥·기계에 반사 |
+| 3.0s | 경광등 켜진 채 정지 |
+
+**꼭** — **경광등이 처음부터 프레임 안에 있어야 합니다.** 꺼진 상태에서 켜지는 것이 보여야
+하고, 컷을 나눠 경광등을 따로 보여주면 효과가 절반이 됩니다.
+
+**피할 것** — 슬로모션, 극적인 음악용 편집, 카메라 흔들림(핸드헬드), 유혈.
+
+---
+
+### A-2. `v02-앉기-정상.mp4` ★P0 — 반드시 A-3과 한 쌍
+
+**한 문장**
+
+> 쭈그려 앉아 작업해도 **아무 일도 일어나지 않는다.**
+
+**타임라인** — 작업자가 자연스럽게 쭈그려 앉아 바닥의 부품을 만짐. 3초 내내 경광등 꺼진 채.
+
+**꼭** — **A-1과 완전히 같은 앵글·같은 장소.** 나란히 틀어서 "차이는 자세뿐"이 보여야 합니다.
+경광등이 프레임 안에 있고 **끝까지 꺼져 있어야** 합니다.
+
+**왜 필요한가** — "앉으면 오탐 나는 거 아니냐"가 도입 검토의 첫 질문입니다. 말로 답하는 것과
+3초를 보여주는 것은 설득력이 다릅니다.
+
+---
+
+### A-3. `v03-허리굽힘-정상.mp4` ★P1
+
+**한 문장**
+
+> 허리를 굽혀 물건을 들어도 울리지 않는다.
+
+A-2와 같은 목적, 다른 자세. 여유가 없으면 A-2만으로도 성립합니다.
+
+---
+
+### A-4. `v04-구역진입.mp4` ★P1
+
+**한 문장**
+
+> **발이 선을 넘는 순간** 판정된다.
+
+**타임라인**
+
+| 시각 | 화면 |
+|---|---|
+| 0.0s | 바닥에 노란 안전선. 작업자가 선 밖에서 걸어옴 |
+| 1.5s | **발이 선을 넘음** |
+| 2.5s | 경광등 점등 (또는 주의색) |
+| 3.0s | 정지 |
+
+**꼭** — **발과 선이 함께 프레임 안에** 있어야 합니다. 상반신만 잡으면 이 클립의 의미가 사라집니다.
+카메라를 조금 낮추거나 각도를 눕혀 바닥이 넓게 보이게.
+
+---
+
+### A-5. `v05-카메라-건드림.mp4` ★P1 — 차별점
+
+**한 문장**
+
+> 카메라를 건드리면 **시스템이 그 사실을 스스로 신고한다.**
+
+**타임라인**
+
+| 시각 | 화면 |
+|---|---|
+| 0.0s | 정상적인 공장 화면 |
+| 1.0s | 화면 전체가 **한 번 흔들리며 각도가 틀어짐** (누군가 청소하다 스친 것처럼) |
+| 1.5s | 틀어진 채로 안정 — **화면은 여전히 멀쩡해 보임** |
+| 3.0s | 정지 |
+
+**꼭** — 카메라 **자체 시점**입니다(1인칭). 삼각대를 밖에서 찍는 게 아니라, 화면이 흔들려야 합니다.
+틀어진 뒤에도 영상이 정상적으로 나오는 것이 핵심 — "고장난 게 아니라서 아무도 모른다"가
+이 제품이 잡는 조용한 실패입니다.
+
+**피할 것** — 화면이 까매지거나 노이즈가 끼면 안 됩니다. 그건 누구나 아는 고장입니다.
+
+---
+
+### A-6. `v06-2인1조.mp4` ★P2
+
+**한 문장**
+
+> 한 명이 나가면 **혼자 남은 것**이 판정된다.
+
+**타임라인** — 0.0s 두 사람이 함께 작업 → 1.5s 한 명이 프레임 밖으로 걸어 나감 →
+3.0s 남은 한 명 혼자. (실제로는 30초 지속 후 이벤트이므로 클립에 경광등은 켜지 **않습니다.**)
+
+**꼭** — 경광등을 켜지 마세요. 30초 규칙이라 즉시 울리지 않습니다. 덱의 자막이 설명합니다.
+
+---
+
+## B. 우선순위
+
+| | 파일 | 없으면 안 되는가 |
+|---|---|---|
+| **P0** | `v01-넘어짐-경광등.mp4` | **덱의 핵심.** 이것만 있어도 보고가 됩니다 |
+| **P0** | `v02-앉기-정상.mp4` | v01과 쌍. 단독으로는 의미 없음 |
+| P1 | `v04-구역진입.mp4` | 구역 기능 설명이 크게 살아납니다 |
+| P1 | `v05-카메라-건드림.mp4` | 차별점 슬라이드용 |
+| P1 | `v03-허리굽힘-정상.mp4` | v02의 보강 |
+| P2 | `v06-2인1조.mp4` | 있으면 좋음 |
+
+**P0 2개만 있어도 덱은 성립합니다.** 나머지 자리는 스틸 이미지로 자동 대체됩니다.
+
+---
+
+## C. 전달 방법
+
+`docs/deck/clips/` 에 위 파일명 그대로 넣어주십시오.
+
+덱 생성기(`docs/deck/build_deck.py`)가 **파일이 있으면 영상을, 없으면 해당 스틸 이미지를**
+자동으로 넣습니다. 그래서 지금 P0 2개만 먼저 주셔도 되고, 나중에 하나씩 추가해도
+생성기만 다시 돌리면 반영됩니다.
+
+```
+python docs/deck/build_deck.py
+```
+
+---
+
+## D. 넣지 않기로 한 것
+
+| 제외 | 이유 |
+|---|---|
+| 대시보드 화면 녹화 | **실화면 캡처 8장이 이미 있고 그건 진짜입니다.** 재현 영상으로 대체하면 진짜를 가짜로 바꾸는 셈 |
+| 골격(스켈레톤) 오버레이 애니메이션 | 작업자를 추적한다는 인상을 키움 — 스틸 브리프와 같은 이유 |
+| 드론·타임랩스·기업 홍보 톤 | 이건 안전 설비 보고이지 브랜드 필름이 아닙니다. 화려할수록 "실제로 되는 건가"라는 의심을 삽니다 |
+| 3초를 넘는 서사형 영상 | 경영진 보고에서 한 장면에 쓸 수 있는 시간은 3초입니다 |
diff --git a/docs/프로젝트-소개서.html b/docs/프로젝트-소개서.html
index 8b46d50..b337424 100644
--- a/docs/프로젝트-소개서.html
+++ b/docs/프로젝트-소개서.html
@@ -3,7 +3,7 @@
-move_detect — 작업장 안전 AI CCTV 프로젝트 소개서
+move_detect — 작업장 안전 AI CCTV