a203c42bf3
Per-zone declarative safety rules, set in the zone editor and enforced on the edge from the tracking the pipeline already does (no new geometry, no new model): - min_workers (2인 1조): 0 < count < minimum sustained 30s -> lone_worker/HIGH. A solo worker in a buddy-rule zone is a compliance violation and a rescue- delay risk, so it outranks the other two. - max_workers: count > limit sustained 10s -> overcapacity/WARNING. - max_dwell_s: one track's continuous stay past the limit -> overstay/WARNING. A short detection dropout (<=5s grace) does NOT reset the dwell timer - without that, run_once's stale-track filter would quietly neuter every 10-minute rule at real-world detection rates. Edge: detectors/occupancy.py consumes Zone.rules; the engine flips the zone detector's per-track membership into per-zone headcounts (stale tracks already excluded), so counts always match what was actually detected this tick. Fired states clear on condition recovery - re-alerts need a fresh violation, not a cooldown expiry. Malformed rules_json keeps the zone's intrusion detection alive and logs the rules as inactive (never fail dark). Server: move_zones.rules_json (nullable JSON, migration included) validated strictly in ZoneConfigController (bounds, min<=max, unknown keys rejected - a silently dropped rule is one the operator believes is active). Delivered to the edge unchanged via GET /api/config. EventValidator accepts the 3 new types. UI: zone editor gains the three rule fields (dwell entered in minutes, wired in seconds) and shows each zone's rules in its list row; the events console and detail view now render every event type in Korean (wire codes fall back). Verified: pytest 216 pass / PHPUnit 123 pass + real-render harness in Chrome (editor save payload, list labels, console type labels).
3.5 KiB
3.5 KiB
PROJECT_MAP — move_detect
작업 전 이 문서로 위치를 찾고 필요한 파일만 연다 (전체 재스캔 금지). 새 파일·라우트·스키마 변경 시 해당 섹션을 갱신할 것.
개요
작업장 안전 AI CCTV. Raspberry Pi 5 + Hailo-8 엣지 추론(Python) → HMAC POST → Cafe24 웹호스팅 PHP+MySQL 대시보드. 감지: 넘어짐 · 넘어짐 후 미동 · 장시간 부동 · 위험구역 침입(경고/절대금지/협착) · 유령사고(위험 상태로 소실). 스냅샷만 전송, 라이브뷰·영상 없음.
edge/ (Python — Pi에서 구동)
| 파일 | 역할 |
|---|---|
app.py |
run_once 파이프라인 (프레임→추론→추적→감지→스냅샷→전송). ambiguous 리셋·stale 필터 |
engine.py |
EventEngine — 감지기 오케스트레이션, 쿨다운 dedup, 트랙 forget |
tracking.py |
IouTracker — 전역 그리디 IoU 매칭, ambiguous() (교차 경합 트랙) |
detectors/ |
fall.py(FALLING→FALLEN→NO_MOTION, sustained prone) · immobility.py · ghost.py · zone.py · occupancy.py(존 규칙: 2인1조/정원/체류상한 — Zone.rules 소비) |
smoothing.py |
트랙별 키포인트 스무딩 풀 |
snapshot.py |
RingBuffer · FaceBlurrer(PIPA) · Snapshotter |
alert.py / serverclient.py |
HMAC+nonce POST, 커스텀 UA, no-redirect |
queue.py |
오프라인 전송 큐 |
config.py |
env → Config (빈 CAFE24_URL/SECRET는 기동 실패) |
daemon.py / runtime.py / health.py |
상주 루프 · 하트비트 텔레메트리 |
adapters/ |
hailo_pose · movenet_pose(CPU 폴백) · picamera_source(CSI) · uvc_source(USB) |
probe.py / tools/ |
카메라 사전 점검 · HEF/모델 fetch (빌드머신 전용) |
server/ (PHP 8 + PDO — Cafe24)
- 진입:
public/index.php(라우트 전부 여기), 뷰:src/View/{layout,events,login,zones,event_detail}.php - 라우트:
POST /api/events(ingest, HMAC) ·POST /api/heartbeat·GET /api/config·GET /api/events·GET /api/devices·GET/POST /api/zones*·POST /login|/logout·GET /snap/{uuid}·POST /events/{id}/ack· 페이지/,/login,/zones,/events/{id}/view src/Ingest/HMAC+nonce+rate-limit+replay 방지 ·src/Auth/argon2id/세션/RBAC/CSRF ·src/Dashboard/이벤트목록·디바이스상태·존편집·스냅샷프록시 ·src/Repository/9종 (인터페이스+PDO)- 프런트:
public/assets/app.js(이벤트 콘솔 폴링·필터) ·device-tree.js(장치→카메라 트리 레일) ·zone-draw.js·detail.js·app.css - DB:
schema.sql(테이블 prefixmove_), 마이그레이션migrations/. 존 행의rules_json(선택) = 점유 규칙 {min_workers,max_workers,max_dwell_s} — 편집기 저장 시 ZoneConfigController가 검증, /api/config로 엣지 전달 - 배포:
server/deploy/build_cafe24_package.sh→ zip,server/docs/server-deploy.md
deploy/ · dist/ (납품)
deploy/: Pi 설치 —setup_online.sh,bundle/build_offline_bundle.sh(폐쇄망),systemd/move-detect-edge.service,device.env(사전 프로비저닝)dist/:1_cafe24_upload/·2_pi_install/·PROVISION_SECRETS.md
tests/
- Python:
tests/31파일 (pytest) — 하드웨어 필요 테스트는tests/hardware/+ skip 마커 - PHP:
server/tests/19파일 (phpunit, in-memory repo; PDO 통합은 skip 게이트)
docs/
delivery-audit.md(감사 43건, 전부 완료 — OFF-HW 실장비 검증만 잔여) · pilot-runbook.md ·
hardware-bringup.md · INDEX.md(작업 기록)