move_detect/tests/test_height_fall.py
유창욱 4bfb7e0274
Some checks are pending
verify / edge (push) Waiting to run
verify / server (push) Waiting to run
feat: 추락 · 동시 다발 쓰러짐 · 구역 프리셋 (1.2.0)
AI CCTV 목적을 원론부터 재점검한 결과. 셋 다 새 추론 모델 없이 지금 있는
자세추정·구역·트랙 이력만으로 구현했다.

■ 추락 (fall_from_height)

잡고 있던 것은 같은 높이의 '넘어짐'이었고, 사망 1위 유형인 '떨어짐'은 못
잡았다. GhostIncidentDetector 가 트랙이 이미 위험 자세일 때만 무장하므로
(_DANGEROUS), 발판에 서 있다가 떨어지는 사람은 소실 순간 STANDING 이라
아무것도 안 걸렸다.

판정의 핵심은 bbox 중심이 아니라 하단(y2)이다. 쭈그려 앉으면 중심은
내려가도 발은 그 자리이고, 추락은 발 밑선이 통째로 내려간다 — 중심으로
재면 쭈그려 앉아 작업하는 사람이 전부 추락이 된다. 원근 접근은 y2 도
내려가므로 높이 증가 가드로 따로 막는다. Track.frames 가 90프레임을 들고
있어 별도 버퍼가 없다.

발보는 두 갈래로 나뉘되 한 사고는 한 건이다: 프레임 안에서 넘어짐이
확정되면 유형을 승격하고, 화각 밖으로 사라지면 ghost 무장을 넓혀 그쪽으로
낸다. 심각도 CRITICAL — 척추·두부 손상 주의가 통보에 실리려면 넘어짐(HIGH)과
등급이 갈라져야 한다. 고소 구역은 rules_json 의 elevated 키로 붙어 스키마
변경이 없고, 구역이 없어도 하강 신호만으로 동작한다.

■ 동시 다발 쓰러짐 (multi_down)

같은 구역에서 짧은 시간에 둘이 쓰러진 것은 넘어짐 두 건이 아니라 질식·
가스·폭발이다. 이 기능의 본체는 감지가 아니라 통보 문구다 — 밀폐공간
사망자의 상당수가 구조하러 들어간 사람이므로, 링크를 열기 전에 메일 본문에서
"공기호흡기 없이 진입하지 마십시오"가 읽혀야 한다. Channels::guidance 로
유형별 안내를 붙였고 문구를 테스트로 고정했다(문구가 사라지면 기능이 사라진
것과 같다).

서버에 둔 이유: 가스는 카메라 화각을 존중하지 않아 노드를 넘는 판단이
필요하고, 현장 즉시 대응은 첫 쓰러짐의 경광등이 이미 확보한다. 오탐 방어의
핵심은 근접성 — 넓은 공장에서 2분 안의 무관한 넘어짐 두 건은 실제로
일어나므로 같은 구역이거나 좌표가 가까워야 묶는다. 한 사람이 두 번 넘어진
것은 한 명으로 센다.

■ 구역 프리셋 6종 + max_workers:0 수정

밀폐공간 감시에 필요한 것(제한구역+2인1조+체류상한)은 이미 전부 있었는데
화면이 "최소 인원을 넣으세요"라고만 물어 아무도 그렇게 쓰지 못했다.
안전관리자는 min_workers 가 아니라 밀폐공간을 생각한다.

그 과정에서 잠복 결함 하나: max_workers:0 이 falsy 로 걸러져 "아무도 있으면
안 되는 구역"(크레인 짐 아래·굴착기 선회 반경 = 깔림 사고의 전형)이 통째로
꺼져 있었다. 운영자가 저장해 놓고도 아무 일이 안 일어났다. 감지기·입력란
(min=1)·저장 직렬화(>0)·목록 표시 네 곳에서 막혀 있었다.

■ 검증

pytest 322 passed / phpunit 263 passed. 신규 테스트 30건.
이벤트 유형 2종 추가는 test_event_type_parity 가 강제하는 5곳(엣지 enum ·
EventValidator · schema CHECK · 프런트 라벨 5파일 · 필터 옵션) 전부 동기화했고
기존 설치용 마이그레이션을 추가했다.

■ Pi 번들

1.1.0 과 달리 이번에는 edge/ 가 바뀌었으므로 Pi 번들 재빌드가 필수다.
낡은 1.0.0 번들은 dist/ 에서 제거했다 — 두면 추락 감지가 빠진 노드가 그대로
납품된다. arm64 + 네트워크 빌드 머신에서 재빌드해야 Pi 납품이 가능하다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EBjuR7DW6PNNMows4KnbYU
2026-09-05 12:21:50 +09:00

107 lines
4.1 KiB
Python

"""추락(높이에서 떨어짐) 판정.
이 프로젝트가 잡고 있던 것은 같은 높이에서의 **넘어짐**이고, 산업재해 사망 1위 유형인
**떨어짐**은 잡지 못했다. GhostIncidentDetector 는 트랙이 이미 위험 자세일 때만 무장하므로,
발판 위에 서 있다가 떨어지는 사람은 소실 순간 STANDING 이라 아무것도 걸리지 않는다.
판정의 핵심은 bbox 중심이 아니라 **하단(y2, 발 밑선)** 이다:
쭈그려 앉기 → 중심은 내려가지만 발은 그 자리에 있다
추락 → 발 밑선이 통째로 내려간다
중심으로 판정하면 쭈그려 앉는 작업자가 전부 추락이 된다. 아래 테스트가 그 구분을 고정한다.
"""
from edge.detectors.height import DescentWatch, DescentConfig
from edge.models import BBox, Keypoint
from edge.tracking import Track, TrackFrame
from collections import deque
def _kp():
return [Keypoint(0.5, 0.5, 0.9) for _ in range(17)]
def _track(track_id: int, boxes: list[tuple[float, BBox]]) -> Track:
frames = deque(maxlen=90)
for t, b in boxes:
frames.append(TrackFrame(t, b, _kp()))
return Track(track_id=track_id, frames=frames)
def _box(y2: float, height: float, cx: float = 0.5) -> BBox:
"""발 밑선 y2 와 높이로 bbox 를 만든다 (좌표는 프레임 정규화 0..1)."""
return BBox(x1=cx - 0.05, y1=y2 - height, x2=cx + 0.05, y2=y2)
def _watch(**cfg):
return DescentWatch(DescentConfig(**cfg))
# --- 잡아야 하는 것 -------------------------------------------------------------------
def test_rapid_drop_of_the_foot_line_is_a_descent():
w = _watch(drop_ratio=1.2, drop_window_s=1.2)
# 키 0.25 인 사람의 발 밑선이 0.9초 만에 0.35(=1.4배) 내려간다
tr = _track(1, [(0.0, _box(0.30, 0.25)), (0.3, _box(0.42, 0.25)),
(0.6, _box(0.55, 0.25)), (0.9, _box(0.65, 0.25))])
v = w.update(tr, now=0.9)
assert v is not None
assert v["drop_ratio"] >= 1.2
assert w.descending(1, now=0.9) is True
def test_descent_stays_armed_for_the_link_window():
w = _watch(link_s=3.0)
tr = _track(1, [(0.0, _box(0.30, 0.25)), (0.9, _box(0.65, 0.25))])
w.update(tr, now=0.9)
assert w.descending(1, now=3.5) is True # 아직 연결 창 안
assert w.descending(1, now=4.5) is False # 창을 벗어남
# --- 잡으면 안 되는 것 ----------------------------------------------------------------
def test_crouching_is_not_a_descent():
# 쭈그려 앉으면 높이는 줄지만 발 밑선은 그 자리다. 중심으로 재면 이게 전부 추락이 된다.
w = _watch()
tr = _track(1, [(0.0, _box(0.60, 0.25)), (0.4, _box(0.60, 0.18)),
(0.8, _box(0.60, 0.12)), (1.1, _box(0.60, 0.10))])
assert w.update(tr, now=1.1) is None
def test_walking_down_stairs_is_not_a_descent():
# 계단은 내려가지만 창 안에서 1.2배에 못 미친다.
w = _watch(drop_ratio=1.2, drop_window_s=1.2)
tr = _track(1, [(0.0, _box(0.40, 0.25)), (0.4, _box(0.45, 0.25)),
(0.8, _box(0.50, 0.25)), (1.2, _box(0.55, 0.25))])
assert w.update(tr, now=1.2) is None
def test_walking_towards_the_camera_is_not_a_descent():
# 원근 접근은 발 밑선도 내려가지만 사람이 커진다. 높이 증가 가드가 막는다.
w = _watch(drop_ratio=1.2, grow_guard=1.35)
tr = _track(1, [(0.0, _box(0.30, 0.15)), (0.4, _box(0.50, 0.24)),
(0.8, _box(0.68, 0.34))])
assert w.update(tr, now=0.8) is None
def test_slow_drop_outside_the_window_is_not_a_descent():
w = _watch(drop_ratio=1.2, drop_window_s=1.2)
tr = _track(1, [(0.0, _box(0.30, 0.25)), (2.0, _box(0.50, 0.25)),
(4.0, _box(0.70, 0.25))])
assert w.update(tr, now=4.0) is None
def test_forget_clears_state():
w = _watch()
tr = _track(9, [(0.0, _box(0.30, 0.25)), (0.9, _box(0.65, 0.25))])
w.update(tr, now=0.9)
assert w.descending(9, now=1.0) is True
w.forget(9)
assert w.descending(9, now=1.0) is False
def test_single_frame_track_is_safe():
w = _watch()
tr = _track(1, [(0.0, _box(0.30, 0.25))])
assert w.update(tr, now=0.0) is None