move_detect/docs/INDEX.md

INDEX — 작업 기록 (완료 결과만)

• 2026-08-18 VERSION 1.0.0 — 첫 정식 납품 버전 — 9596d1b. 산출물: dist/move-detect-cafe24-1.0.0-20260818.zip · dist/move-detect-pi-1.0.0-20260818-aarch64-cp311-hailo8.tar.gz (둘 다 스탬프 version 1.0.0 / git_commit 9596d1b). 릴리스 규칙 위반 3건 시정: 산출물 파일명에 버전·날짜가 없던 것, VERSION 부재 시 'unknown' 으로 빌드되던 것(이제 exit 1), 문서의 stale 파일명. 납품 동봉물 확충: CHANGELOG.md 신설 · 역할별 사용 설명서(3역할 14절 + FAQ 6항, 실제 화면 캡처 8장 base64 임베드 단일 HTML 665KB — 소스는 server/deploy/manual/, 생성물은 커밋하지 않고 패키저가 매번 빌드) · 감사 리포트를 '납품점검-리포트.md' 로 동봉. README-UPLOAD 에 크론 안내 신설 — 설치 안내서에 자동 실행 등록이 아예 없어 이번 릴리스의 핵심인 통보가 한 건도 나가지 않을 뻔했다(8·9번 절 + 체크리스트 3항목). 부수: 셸 스크립트 CRLF 로 bash 가 죽던 것 정규화 + Pi 쪽에 없던 CRLF·bash -n 가드 추가. 검증: pytest 통과(skip 3) · PHPUnit 224 (skip 0) · 매뉴얼 실렌더 · 패키지 내부 검증 (문서 4종 동봉, 매뉴얼 외부 참조 0·임베드 이미지 8, 마이그레이션 8/8, config.php 는 CHANGEME 템플릿, tools/ 는 www 밖, 웹 루트 PHP 는 2개, Pi 휠 11 + HEF 1 + SHA256SUMS).

• 2026-08-18 납품 재감사 — 7daee0b. 확장된 표면(라우트 17·표 6종·CLI 도구 5·엣지 모듈 4· 통보 발송·감사 해시체인)을 8개 관점으로 재감사, 확정 12건 전량 해소 (CRITICAL 3 · HIGH 3 · MEDIUM 4 · LOW 2). 최대 발견은 신규 감지 유형이 ingest 검증기에만 빠져 카메라 무결성 감지가 end-to-end 무력화되어 있던 것 — DB CHECK·프런트·엣지는 다 갱신됐는데 가운데 계층만 빠졌고, 파이썬·PHP 테스트가 각자 절반만 보기 때문에 양쪽 다 통과했다. 재발 방지로 언어 경계를 넘는 파리티 테스트 신설(tests/test_event_type_parity.py). 그 외 운영 DB 파괴 가능한 --purge 범위, 백업이 docroot 자체에 떨어지던 경로 가드, 통보 메일 시각이 콘솔과 9시간 어긋나던 타임존, MariaDB 에서 실패하는 DROP CHECK. 판정: 적합 (docs/delivery-audit.md Phase 6). 잔여는 실장비 OFF-HW 5건. 검증: PHPUnit 224 (skip 0) · pytest 통과 · 양 산출물 재생성 + 패리티 통과.

• 2026-08-09 안전 플랫폼 확장 — e00ad69. 로드맵 23건 중 소프트웨어로 완결 가능한 19건 반영. 마이그레이션 2026-08-09-safety-platform.sql (표 6종 신설 + 컬럼 4종 + event_type CHECK 확장). 통보(제품 정의 수준의 구멍): 지금까지 감지는 브라우저를 보고 있는 사람에게만 전달됐다. ① 엣지 GPIO 경광등(edge/beacon.py) — 네트워크 없이 동작하는 유일한 경로, /api/config 로 설정 수신 ② 메일·웹훅 채널 + 크론 디스패처(tools/dispatch_alerts.php, --dry-run 지원) ③ 미확인 위급 → unacked_escalation 이벤트 발행(멱등) → 상위 채널로 에스컬레이션. 중복 발송은 (event,channel) UNIQUE 로 막는다(크론 중첩 실행 대비). 조용한 실패 제거: 카메라 화각 이동·가림·조도 저하 감지(detectors/integrity.py) — 존 판정이 무의미해진 것을 처음으로 알 수 있게 됨. 스토리지 여유 감시. 엣지에 닿지 않던 배선 2건 수리: thresholds_from_config() 가 파싱만 하고 버려서 임계값이 장비에 적용되지 않던 것(edge/tuning.py), 존/임계값 저장 시 config_version 을 올리지 않아 설정 드리프트 표시가 영원히 꺼져 있던 것. 관리 화면 신설: 임계값 편집(카탈로그 기반 범위 강제 — 엣지가 기동 시 거부하는 값을 키보드 앞에서 막는다) · 통보 채널 · 정비 억제(사유 필수·최대 8시간·감지는 계속되고 통보만 보류) · 위험성평가 · 교대 인수인계 · 설비 성능 추이 · 설치 점검(/setup, 실제 상태 조회 기반). 증거·규정: 감사로그 해시체인(수정·삭제·우회삽입 전부 탐지, tools/verify_audit_chain.php) · 사고조사 패키지 1클릭(전후 타임라인+통보 이력+위험요인+조치 이력+서명란, 인쇄 CSS) · 이벤트→조치 직접 기록 · 현장별 롤업(전역 계정만). 운영: 일괄 확인(위급 제외·2단계) · 키보드 트리아지(J/K/A/F/Enter) · 모바일 레이아웃 (44px 타깃) · 보존기간 정리(tools/maintain.php) · 백업/복구(tools/backup.php, www 안 출력 거부) · 데모 시드(tools/seed_demo.php). 검증: pytest 통과(3 skip = 하드웨어·환경) · PHPUnit 221 (skip 0, +59) · Chrome 실렌더로 신규 4화면 + 임계값 저장→config_version 증가→감사 기록→체인 검증→변조 탐지 전 경로 확인 · cafe24 번들 + Pi 오프라인 번들(aarch64 휠 11개) 재생성, 소스 패리티 통과. 미착수 4건(모델·하드웨어 선행): 보호구·중장비 근접·화재 감지는 AGPL 아닌 가중치 확보와 HEF 컴파일이 관문이라 감지기 배선·이벤트 계약·테스트만 완성하고 기본 비활성으로 둠 (edge/detectors/pending.py). PLC 접점 협착 게이팅도 같은 이유로 인터페이스만.

• 2026-08-09 UI/UX 전면 점검 후 21건 일괄 반영 (동선 7 · 전달 9 · 시각 5) — e00ad69 (위 안전 플랫폼 확장과 같은 커밋: 후자가 전자에서 고친 화면 위에 얹혀 있다). 동선: ① 스트림 정렬을 '미확인 우선'에서 엄격 시간순으로 되돌림 — 확인 상태가 연대기를 뒤집어 사고 재구성이 불가능했고, 확인 시 행이 목록 밖으로 사라져 아래 행이 밀려 올라오며 오클릭으로 다른 이벤트가 확인 처리될 수 있었다. 확인은 제자리 전환 + 확정 토스트로 변경. ② 처리 큐는 정렬이 아니라 뷰모드(전체/미확인만) 필터로 분리. ③ 이벤트 상세에 확인/오탐 액션 신설(판정 화면에 판정 도구가 없던 문제). ④ 오탐·구역삭제 2단계 확정(되돌릴 수 없는 동작). ⑤ 구역 설정에 장치·카메라 선택기(자유 텍스트 ID 암기 제거, 가짜 플레이스홀더 제거). ⑥ 날짜 조회(키셋 커서 시딩, 최대 6페이지) — 사고 조사 진입로. ⑦ 경보음 세션 음소거 (새 위급 도착 시 자동 해제). 전달: KPI 스트립에 실제 집계 범위 표기(24h 브리프와 숫자 충돌 해소), 중대=위급+높음 인라인 정의, 페이지 명칭 3종·날짜 포맷 3종 통일, '확인 필요' 칩을 전 심각도로 확장, 상세 CONFIDENCE→검출 신뢰도 %, 오탐율·시간패턴 표본 게이트, 개선조치 효과에 푸아송 잡음 범위(√before) 판정 보류, 카메라 위험 순위 강조 기준을 상대값으로, 날짜 구분선. 시각: 구역 설정·이벤트 상세를 카드 셸로 재구성(둘 다 스타일 없는 기본 폼이었음), 히트맵 토글 aria-pressed 시각 상태 신설(CSS 규칙 자체가 없었음), 존 색을 팔레트 정합 (팔레트 외 보라 제거, 채움+라벨칩+협착 점선), 주 동작 accent 승격, 장치명 플리커 제거. 검증: pytest 통과 · PHPUnit 162 (skip 0) · Chrome 실렌더로 4개 화면 + 확인/오탐/날짜조회/ 삭제 2단계/히트맵 토글 실동작 확인 · cafe24 번들 재생성(소스 패리티 통과). 미해결(설계 판단): 확인 취소(undo)는 넣지 않음 — acknowledged_by는 감사 로그가 남는 추가 전용 기록이라, 무음 되돌리기는 안전 시스템에서 더 나쁜 속성. 서버에 unack 라우트를 두는 안은 별도 결정 필요.

• 2026-08-08 감사 잔여 확정 항목 일괄 처리 (VERSION 0.9.0 신설). 보안: CSP nonce 도입(인라인 2블록, unsafe-inline 없음)+보안헤더를 PHP로 이관(개발/납품 동일), /logout CSRF, 계정 잠금 423→401(사용자명 열거 제거). 엣지: 큐 flush 배치 상한(정전 복구 시 감지 정지 해소), 타이머 env 전수 NaN/음수 검증, T2 프레임 스킵(INFER_EVERY, 스킵 틱은 링버퍼 미투입 =미블러 얼굴 유출 차단), systemd 워치독(sd_notify)+메모리 상한, UVC 해상도·버퍼 고정. 테스트: PDO 통합 테스트 스킵 해소(-d extension=pdo_sqlite, 리포트·히트맵·익스포트 집계 SQL 최초 실행), 얼굴 블러 테스트를 실제 증거로 교체(무동작 퇴화 감지), index.php 라우트 테이블 대조(프런트 호출 15개 교차검증), dist↔소스 패리티 테스트, CI 신설 (.forgejo/workflows/verify.yml, 스킵 발생 시 실패). 프런트: 이벤트 목록 시그니처 기반 재렌더 스킵+포커스 복원(5초마다 포커스 소실·전체 재낭독 해소), 폴링 중첩 가드, 콜드스타트 실패 표시. 문서: deploy/README·env.example을 Hailo 단독 번들 실제와 일치, bringup의 미존재 설정 키를 실제 env 노브로 교체. 납품물에 version/git_commit/built_at 스탬프. pytest 251 / PHPUnit 162 (스킵 0).

• 2026-08-08 프로젝트 8개 차원 감사(종합 82/100) 후 상위 3건 수정. ①개선 조치 site 스코프 누락(스코프 운영자가 타 현장 조치 기록 열람·기록 가능) → move_actions.site 추가 (2026-08-08-actions-site.sql, 이벤트에서 카메라 소유 현장 해석, 오타 카메라 400·타 현장 404). ②README-UPLOAD 업그레이드 절차가 마이그레이션 1/7만 지시 → 순서·적용조건 표로 교체 (move_ 접두 리네임 누락 시 전 요청 500). ③두 납품 번들 재생성(4커밋 스테일 해소 — Report/Export/Actions 컨트롤러·마이그레이션 누락 복구, 엣지 소스 패리티 회복). 문서 테이블 수·프리픽스 표기 정정. pytest 235 / PHPUnit 147.

• 2026-08-07 데이터 활용 5안 중 4안 구현: ②시간패턴 히트맵+전조 급증 경보 ③KPI 전기간 추이(d8b8e1f) ①라벨 JSONL 익스포트(/api/export/labels, 관리자) ④개선 조치 기록·전후 효과 비교(move_actions, 동일 창 비교, 3일 미만 "측정 중"). ⑤멀티사이트 벤치마크는 다현장 이후(사이트 스코프 구조가 이미 수용). PHPUnit 145 + Chrome 실렌더.

• 2026-08-07 증거 타임라인 + 24시간 캐치업: 이벤트 스냅샷이 링버퍼 기반 과거→발생 3장(프레임별 자기 시점 얼굴 블러, P1-B 잔여 종결), 상세뷰 이전/직전/발생 캡션. 콘솔 첫 진입 '지난 24시간' 요약 배너(/api/report?days=1 재사용, 리포트 링크). pytest 235/ PHPUnit 138 + Chrome 실렌더.

• 2026-08-07 안전 운영 리포트 /report (주간 안전회의용 인쇄 가능 한 장: 중대 이벤트· TTA(FP 제외)·니어미스 피라미드·오탐율·유형/카메라 순위·인체공학 노출·존 규칙 위반) + 이벤트 스트림 유형 필터. PHPUnit 138 + Chrome 실렌더(KPI/바리스트/타일/필터).

• 2026-08-06 인체공학 자세부담 스코어링 (ergo_report/INFO, 카메라 단위 익명·스냅샷 미부착): REBA 밴드 노출시간(허리 20~60°/60°+·팔 90°+·웅크림<110°), 사고 상태 트랙 제외, 검출 공백 dt 상한. 상세뷰 지표 한글 렌더 — b358822. pytest 232/PHPUnit 135 + 실렌더.

• 2026-08-06 납품 번들 재생성: dist/1_cafe24_upload + move-detect-cafe24.zip (마이그레이션 5종 동봉 — 빌드 스크립트에 staging 추가) · dist/2_pi_install --cross 재빌드 (aarch64/cp311 휠 11종 + HEF 다이제스트 검증 + SHA256SUMS). FLAG: MoveNet ONNX 업스트림 URL 404 → 이번 Pi 번들은 Hailo 단독(CPU 폴백 모델 미포함). edge/tools/fetch_movenet.py의 소스 URL 갱신 필요.

• 2026-08-06 오탐 피드백 (결정 a: 통계만, 자동 튜닝 없음): 이벤트 오탐 태그 (POST /events/{id}/false-positive, ack 겸함, 최초 태거 보존) + GET /api/fp-stats + 콘솔 오탐율 패널(30일, 30%+ 강조). PHPUnit 135 + Chrome 실렌더(태그→행 전환→패널 즉시 갱신).

• 2026-08-06 대시보드 장치→카메라 트리 레일 + (device,camera) 쌍 카메라 필터 — eaff176. PHPUnit 119 통과 + Chrome 실렌더 검증(트리 상태·필터·접기·콘솔 무오류).

• 2026-08-06 감사 잔여 P2-6/7/8 종결 (ID 스왑 게이트 · sustained-prone FALLING · stale 트랙 no-data) — 32f2237. TDD(RED 확인), pytest 203 통과/2 skip. → delivery-audit 오프하드웨어 항목 43/43 완료. 잔여는 실장비(OFF-HW) 검증뿐.

• 2026-08-06 연속성 문서 신설: CLAUDE.md · docs/PROJECT_MAP.md · 본 INDEX.

• 2026-08-06 니어미스 히트맵: near_fall(FALLING→확정 전 회복, INFO) + 전 트랙 이벤트에 정규화 발좌표(spatial) 부착 → move_events.spatial_x/y 적재 → GET /api/heatmap/{camera} → 존 편집기 '위험 히트맵' 오버레이. 직전 커밋의 chk_events_type 제약 누락(신규 타입 INSERT 거부) 마이그레이션으로 수정. pytest 222/PHPUnit 130 + Chrome 실렌더.

• 2026-08-06 존 점유 규칙 엔진 (2인1조 lone_worker/HIGH · 정원 overcapacity · 체류상한 overstay): edge occupancy.py + move_zones.rules_json + 존 편집기 규칙 입력 + 이벤트 유형 한글 라벨. pytest 216/PHPUnit 123 통과 + Chrome 실렌더(편집기 저장·목록·콘솔 라벨).

• 2026-08-24 — 소개서 이미지 브리프에 감지 시점 설명 이미지 4종 추가(§B 신설: 넘어짐 감지 시퀀스·앉기 vs 넘어짐·구역 판정·2인1조). 수치는 edge/detectors 실코드 대조. 발주 총 11장(P0 6장). 107f7d9

• 2026-08-25 — device_fault·monitoring_degraded 구현(App\Alert\DeviceHealthWatch, dispatch_alerts 1분 크론 1단계). 전 구간에 있으나 아무도 발행하지 않던 2종 — 소개서 "17종"이 실제 15종이던 문제 해소. 장애당 1건(uuid 앵커=장애 시작), 저하는 5분 지속 요구, 미설치 노드 제외. camera_id 센티넬 __device__. 검증 pytest 308 / phpunit 240(신규 16). 9c0cfd2

• 2026-08-25 — 도판 11장 수령·최적화(37.6MB→3.3MB) 후 소개서 HTML 재생성(11장 배치). 경영진 보고 덱 신설(docs/deck/, 14장, 생성기 방식) + 3초 영상 브리프 6종. 실렌더 검증에서 백지 슬라이드·한국어 어절 끊김·스냅 컨테이너 smooth 스크롤 취소 등 6건 교정, 접근성 대비 실패 0건. 9ee3dab

• 2026-08-28 — P0 클립 2종(v01 넘어짐·경광등, v02 앉기·정상) 배치. HEVC라 브라우저 디코딩 실패(videoWidth 0) → prepare_clips.py 신설, VP9/WebM 변환 + 클립 마지막 프레임 포스터 자동 추출(cv2.imwrite 한글경로 실패 우회). 비교 슬라이드 2패널 전환. 재생 진행은 자동화 환경 제약으로 미검증 — 발표 노트북 확인 필요. dea12a2

2026-09-04 — 1.1.0 릴리스 (서버 전용)

• 버전 1.0.0 → 1.1.0. edge/는 1.0.0 이후 불변이라 서버 전용 릴리스. dist 재생성으로 DeviceHealthWatch가 이미 패키지에 들어가 있는데 VERSION이 1.0.0이던 불일치를 해소. bebf426

• 3차 재감사 — 1.1.0 신규 표면(장치 건전성) 4개 관점 병렬 감사, 확정 14건 전량 해소·반증 4건 기록. CRITICAL 2건은 이번 기능이 만든 회귀였다: 통보 전체를 죽일 수 있던 크론 미격리, 간헐 고장에 감지기가 양방향으로 무너지던 문제. 43a3d06

• 산출물 move-detect-cafe24-1.1.0-20260904.zip (BUILD-INFO git_commit=43a3d06, 문서 4종 동봉: README-UPLOAD·CHANGELOG·납품점검-리포트·사용설명서)

• 보안 실제 자격증명 파일을 납품 폴더 dist/ 밖(secrets/)으로 이동. 잔여: 대시보드 비밀번호·장치 HMAC 키 교체 권고

• Pi 번들 미갱신 — edge 불변이라 내용은 동일하나 파일명 표기가 1.0.0. arm64+네트워크 빌드 머신에서 재빌드 필요(Pi 납품 시)

• 검증: pytest 308 passed(3 skip: 환경) · phpunit 250 passed(신규 10)

• 2026-09-04 — 신규 감지 3종 설계안 작성(docs/설계-신규감지-3종.md): 추락(fall_from_height)·동시 다발 쓰러짐(multi_down)·구역 프리셋. 셋 다 새 추론 모델 불필요. 설계 중 확인한 잠복 결함: max_workers: 0이 falsy로 걸러져 "아무도 있으면 안 되는 구역"을 표현할 수 없음(occupancy.py).

2026-09-05 — 1.2.0 (추락 · 동시 다발 쓰러짐 · 구역 프리셋)

• 추락(fall_from_height) — 사망 1위 유형인 "떨어짐"을 못 잡던 공백 해소. 판정은 bbox 중심이 아니라 발 밑선(y2)(쭈그려 앉기와 구분되는 유일한 신호). 프레임 안 확정은 넘어짐 유형을 승격, 화각 이탈은 ghost 경로. 심각도 CRITICAL(척추 손상 주의가 통보에 실려야 함). edge/detectors/height.py 신규

• 동시 다발 쓰러짐(multi_down) — 같은 구역 짧은 시간 2명 이상 = 질식·가스·폭발. 기능의 본체는 통보 문구("공기호흡기 없이 진입하지 마십시오"). 서버측 감시자. 오탐 방어는 근접성(구역 또는 좌표 거리)

• 구역 프리셋 6종 — 밀폐공간·고소작업·프레스협착·출입금지·지게차통로·화기작업. GET /api/zone-presets

• 수정 max_workers: 0이 falsy로 걸러져 "아무도 있으면 안 되는 구역"(크레인 하부·선회 반경)이 조용히 꺼져 있던 문제. 감지기·입력란·직렬화·표시 4곳

• 산출물 move-detect-cafe24-1.2.0-20260905.zip

• ⚠ Pi 번들은 이번 릴리스에서 필수 재빌드 — edge/ 가 바뀌었다. 낡은 1.0.0 번들은 제거했다(추락 감지가 빠진 노드가 납품되는 것을 막기 위해). arm64+네트워크 빌드 머신에서 재빌드해야 Pi 납품 가능

• 검증: pytest 322 passed(5 skip: 환경·Pi번들 미빌드) · phpunit 263 passed

• 2026-09-05 — 1.2.0 4차 재감사: 확정 23건 전량 해소, 반증 5건 기록. CRITICAL 4건은 전부 "구현·단위테스트는 초록인데 납품 경로에서 무동작"이었다 — 추락 승격이 기본 설정에서 미발화(테스트가 prone_confirm_s=0.5 사용), max_workers:0·elevated 가 상류 허용 목록 두 곳에서 차단, 동시 다발이 트래커 재획득으로 한 사람을 두 명으로 셈(구조 지연). 재발 방지 테스트 추가: BUILD-INFO↔HEAD, README↔마이그레이션, 시더 심각도↔엣지, 프리셋 왕복. 문서 "17종"→실제 20종 정정. 산출물 move-detect-cafe24-1.2.0-20260905.zip(BUILD-INFO=93f896a). 검증 pytest 338 / phpunit 269. 93f896a

• 2026-09-18 — 설계 도해 3종 작성(archify, showcase 9/9 · 오류 0 · 경고 0, 1440~2048 4해상도 양 테마 브라우저 검증): 시스템 구성 · 낙상 시퀀스 · 낙상 상태기계. 시퀀스를 그리다 확인한 사실 — 경광등(3초)과 메일(최대 63초)은 같은 "통보"가 아니다. 상태기계 쪽은 확정 창 3초와 추락 연결 창 3초가 겹쳐 있음을 한 장으로 보여준다 (4차 감사의 CRITICAL, 시간을 그렸다면 코드보다 먼저 보였을 충돌). HTML 은 gitignore, 소스 JSON 만 커밋.

2026-09-21 — 납품 정비 (잔여 3건 해소)

• Pi 번들 재빌드 move-detect-pi-1.2.0-20260921-aarch64-cp311-hailo8.tar.gz (82MB). arm64 빌드 머신이 필요하다고 봤던 것은 과한 가정이었다 — --cross 로 pip 이 태그를 보고 aarch64/cp311 휠을 받으므로 네트워크만 있으면 된다. 휠 11개 전부 aarch64. 이걸로 "Pi 번들 미빌드" 로 스킵되던 테스트가 실제로 돌아 스킵이 5 → 2로 줄었다.
• MoveNet CPU 폴백 복구 — P3-3 의 잔여였던 죽은 원본을 유효한 tf2onnx 변환본으로 교체·고정 (sha256 + size). 고정 전에 어댑터 계약과 대조했다: 입력 [1,192,192,3] int32 NHWC, 출력 [1,1,17,3]. 레이아웃이 다른 변환본은 로드는 되고 좌표만 틀리므로 그 계약을 테스트로 박았다. 실사진 2장으로 코<어깨<엉덩이<발목 순서까지 확인. edge/tools/fetch_movenet.py
• 자격증명 회전 도구 server/tools/rotate_credentials.php — 손으로 적던 SQL 절차를 명령 하나로. DB 에 접속하지 않고 붙여넣을 SQL 만 낸다(운영자의 창구가 phpMyAdmin 이므로). 비밀번호는 STDIN 으로만 받는다 — 명령행은 ps 와 셸 히스토리에 남는다. 테스트가 잠그는 것은 "서버 SQL 의 키와 Pi 에 넣으라는 키가 같은가"와 "앱이 그 해시를 검증하는가" 두 가지다. 교체 실행 자체는 운영 계정 조작이라 사용자 몫으로 남긴다.
• 검증: pytest 스킵 2(shellcheck 미설치·Windows AF_UNIX) · phpunit 276 passed, 스킵 0