2fc8178a5c
기존 소개서의 문제는 문장이 아니라 구조와 최신성이었다. - 기대효과 섹션이 아예 없었다. 기능 목록만 있고 "그래서 뭐가 달라지나"가 없었다. - 왜 만들었나가 4문장이었다. 이미 CCTV 가 있는 현장이 왜 또 사는지에 답하지 못했다. - 내용이 0.9.0 시점이었다. 1.0.0 의 핵심인 통보·에스컬레이션이 로드맵에 "P3 예정"으로 적혀 있었고 테스트 320건·감사 43항목도 옛 수치였다 — 완성된 기능을 미완성으로 소개하는 문서가 고객에게 나갈 뻔했다. 재작성 - 기능 나열을 버리고 감지 → 대응 → 증거의 사슬로 재구성. 어느 한 칸이 비면 나머지가 무의미해진다는 것이 이 제품의 논지이므로 문서 구조도 그래야 한다. - 왜 만들었나를 "CCTV 는 이미 있는데 왜 사고를 못 막나" 세 가지(아무도 안 본다 / 발견이 늦다 / 증명할 자료가 없다)로 세우고, 각각에 대응하는 답을 표로 연결. - 기대효과 신설. 지어낸 ROI 대신 **제품이 스스로 계측해 보여주는 지표**(TTA, 니어미스:사고, 조치 전후 밀도, 오탐율)로 썼다 — 공급자 주장이 아니라 고객 화면의 숫자다. '약속하지 않는 것' 절을 함께 넣었다. 사고를 없애지 못하고, 감지율 100%는 없고, 오탐은 초기에 반드시 난다. 과장은 도입 후에 반드시 되돌아온다. - 설계 제약(감시하지 않는다 / 인터넷 없이 동작한다 / 클라우드를 안 쓴다)을 기능보다 앞에 두었다. 이 제품의 형태는 거기서 나왔다. 수치는 전부 코드와 대조해 교정 - 테스트 535건(pytest 311 + PHPUnit 224), 감사 55건, 감지 17종 + 서버 발행 1종 - "3초 안에 찾아낸다"는 과장이었다. 실제로는 쓰러진 자세가 3초 지속되면 확정이므로 "3초면 알아채고"로 고치고, 근거가 되는 3초를 감지 표에 함께 적었다. 이미지 브리프 신설 (docs/소개서-이미지-브리프.md) - 현장 사진 4장 + 다이어그램 3장의 발주 명세. 각 항목에 "이 이미지가 없으면 전달 안 되는 것", 담을 것, 피할 것, 사양, 캡션안, 우선순위. - 제품 화면 캡처 8장은 이미 확보되어 있어 발주 대상에서 제외. - 개인정보 제약을 최상단에 명시. 얼굴이 식별되는 작업자 사진이 한 장이라도 들어가면 "감시하지 않는다"는 이 제품의 핵심 주장이 무너진다. - 검토했으나 뺀 이미지(쓰러진 순간 프레임, 블러 전/후 비교, 스켈레톤 오버레이)와 그 이유도 기록. 나중에 "왜 없지"가 반복되지 않도록. HTML 은 md-to-html-report 로 재생성(목차·표·콜아웃·인쇄 스타일). 실렌더 확인. |
||
|---|---|---|
| .. | ||
| README.md | ||
소개서 이미지
docs/소개서-이미지-브리프.md 의 발주 명세대로 받은 이미지를 이 폴더에 넣습니다.
파일명은 브리프에 지정된 것을 그대로 씁니다 (배치 매니페스트가 파일명으로 찾습니다).
01-현장-설치.jpg P0 표지
02-경광등.jpg P0 §2-2 대응
05-사슬.png P0 §2 무엇을 하는가
06-구성도.png P0 §4 시스템 구성
03-엣지노드.jpg P1 §4-1 엣지 노드
07-대응시간.png P1 §3-1 즉시 달라지는 것
04-위험구역.jpg P2 §2-1 감지
이미지가 들어오면 매니페스트를 만들어 소개서 HTML 을 재생성합니다.
제품 화면 캡처 8장은 이미 server/deploy/manual/shots/ 에 있으므로 여기 넣지 않습니다.