이벤트 설정 유스케이스
목차
1. 용어
2. 행위자
3. 공통 규칙
4. 화면 둘러보기
4.1 카메라 설정 화면
4.2 이벤트 설정 화면
5. 유스케이스 다이어그램
6. 유스케이스 목록
7. 유스케이스
UC-01. 카메라의 AI 분석 켜기
UC-02. 영역에 이벤트 설정 추가하기
UC-03. 화면 전체에 이벤트 설정 추가하기
UC-04. 같은 이벤트 종류를 영역마다 다른 기준으로 쓰기
UC-05. 한 영역에 여러 이벤트 설정 두기
UC-06. 영역 모양 바꾸기
UC-07. 영역 켜고 끄기
UC-08. 이벤트 설정 켜고 끄기
UC-09. 잘못 감지되는 곳 빼기
UC-10. 영역 삭제하기
UC-11. 카메라의 AI 분석 끄기
UC-12. 카메라 설정에서 이벤트 켜고 끄기 결정 필요
UC-13. 감지 일정 정하기 결정 필요
UC-14. 화면 보정하기 결정 필요
8. 정해지지 않은 것
[h1 #_1] 이벤트 설정 유스케이스
작성일: 2026-10-07
목적: 카메라마다 어디에서, 어떤 이벤트를, 어떤 기준으로 감지할지 정하는 기능을 설명한다.
범위: 카메라의 AI 분석, 영역(감지 영역·제외 영역), 영역별 이벤트 설정, 감지 일정, 화면 보정. 한 카메라에 영역을 여러 개 두고 영역마다 이벤트를 따로 설정할 수 있다.
화면 기준: 이벤트 설정 B안(영역 기준) 목업
이 문서에서 결정 필요 로 표시한 부분은 동작이 아직 정해지지 않았다. 후보별 흐름을 함께 적었으니 하나를 고르면 그 흐름으로 확정한다.
[h2 #1] 1. 용어
화면에서 쓰는 말로 적었다. 오른쪽 칸은 개발 문서(CONTEXT.md, AI 연동 계약서)에서 같은 것을 가리키는 말이다.
| 이 문서의 말
| 뜻
| 개발 문서의 말
| 영역
| 카메라 화면 위에 그린 구역 하나
| ROI
| 감지 영역
| 제외 영역이 아닌 보통 영역. 이벤트 설정을 붙여 그 안에서 감지한다
| 포함 ROI
| 제외 영역
| 그 카메라의 모든 이벤트 감지에서 빼는 구역. TV·거울·흔들리는 나무처럼 잘못 감지되는 곳에 쓴다. 사람 탐지 모드(감지 중인 이벤트 설정이 없을 때)에는 적용되지 않는다
| 제외 ROI
| 화면 전체
| 직접 그린 영역과 별개로 영역 목록 맨 위에 늘 있는 기본 감지 범위. 영역을 그려도 없어지지 않고, 따로 그리거나 지울 수 없다
| 화면 전체 ROI
| 이벤트 종류
| 침입·배회·쓰러짐·싸움·화재·군중. 화면에도 이 순서로 나온다
| 시나리오 종류
| 이벤트 설정
| "어느 영역에서 어떤 이벤트 종류를 어떤 기준으로 감지할지" 한 건. 예: 출입구에서 침입, 체류 0.5초
| 이벤트 설정 (시나리오 + 포함 ROI)
| 기준값
| 이벤트 설정마다 정하는 감지 기준. 예: 기준 인원, 체류 시간
| 파라미터 (시나리오에 속함. 화면에서는 영역×이벤트 종류마다 시나리오가 하나라 이벤트 설정마다 다르게 보인다)
| AI 분석
| 카메라 영상을 AI 가 분석하게 하는 카메라 단위 스위치. 감지 중인 이벤트 설정이 없으면 AI 서버의 기본값으로 사람만 탐지한다(사람 탐지 모드)
| AI 분석
| 이벤트
| 이벤트 설정의 조건을 만족해 발생한 기록 한 건
| 이벤트
| 켜진 이벤트 설정
| 이벤트 설정 스위치가 켜져 있는 상태. 실제로 감지하는지와는 다르다
| 시나리오 enabled
| 감지 중인 이벤트 설정
| 켜진 이벤트 설정 중 AI 분석·영역·감지 일정 조건까지 모두 만족해 실제로 감지하는 것
| Start 에 실리는 판정
| 화면 보정
| 관제 화면에 보이는 영상의 밝기·감마·대비·원근을 보정하는 카메라 단위 설정. AI 분석에는 영향이 없다
| 없음 (관제 화면 표시 전용)
[h2 #2] 2. 행위자
| 행위자
| 구분
| 설명
| 운영자
| 주 행위자
| 관제 화면에서 카메라·영역·이벤트 설정을 다루는 사람
| AI 서버
| 보조 행위자
| 관제 시스템이 보낸 설정대로 영상을 분석한다
관제 시스템(Web)은 행위자가 아니라 이 유스케이스들이 일어나는 시스템이다.
[h2 #3] 3. 공통 규칙
바꾸면 바로 적용. 운영자가 영역이나 이벤트 설정을 바꾸면 관제 시스템은 저장한 뒤 그 카메라의 설정 전체를 AI 서버에 다시 보낸다(IN-02). 단, AI 분석이 꺼져 있으면 저장만 하고 보내지 않는다. 나중에 AI 분석을 켤 때 저장된 설정이 한꺼번에 적용된다. 화면 보정은 관제 화면에만 쓰므로 AI 서버로 보내지 않는다.
켜진 것과 감지 중인 것은 다르다. 이벤트 설정 스위치를 켜도, 아래 조건을 모두 만족해야 실제로 감지한다(감지 중인 이벤트 설정).
AI 분석이 켜져 있다.
그 영역이 켜져 있다. 화면 전체는 늘 켜져 있다.
이벤트 설정이 켜져 있다.
감지 일정이 있으면 지금이 일정 안이다(UC-13).
꺼 두거나 일정 밖인 영역·이벤트 설정은 지워지지 않고 남아 있다가, 조건을 다시 만족하면 그대로 감지한다.
영역이 없으면 화면 전체. 영역을 그리지 않은 이벤트 설정은 화면 전체에서 감지한다. "화면 전체" 는 영역 목록 맨 위에 늘 보인다.
AI 분석은 따로. 카메라 설정의 "AI 분석" 은 영상 분석 자체를 켜고 끈다. 이벤트 설정과 별개로 동작한다.
감지 중인 이벤트 설정이 없을 때: 사람 탐지 모드로 동작한다. AI 서버의 기본값으로 사람을 탐지해 화면에 감지 박스를 보여 주며, 이벤트는 생기지 않는다. 이벤트 설정이 켜져 있어도 영역이 꺼져 있거나 일정 밖이라 감지 중인 것이 하나도 없으면 이 모드다.
감지 중인 이벤트 설정이 있을 때: 그 이벤트 설정과 기준값대로 탐지·감지하고 이벤트를 만든다.
언제 적용되나. 켜고 끄는 스위치(AI 분석, 영역 사용, 제외, 이벤트 설정)는 누르는 즉시 저장·적용된다. 기준값, 영역 모양, 영역 이름, 화면 보정은 "저장" 을 눌러야 저장·적용된다.
실패했을 때.
저장 실패: 바꾼 값을 저장하지 못하면 스위치나 입력값을 바꾸기 전으로 되돌리고, 실패 문구를 남긴다.
AI 서버 적용 실패: 저장은 됐는데 AI 서버에 보내지 못하면, 저장된 설정은 그대로 두고 관제 시스템이 주기적으로 다시 보낸다. 이때 운영자에게 어떻게 알릴지는 정해지지 않았다(§8).
[h2 #4] 4. 화면 둘러보기
[h3 #41] 4.1 카메라 설정 화면
"AI 분석" 스위치는 카메라 영상 분석을 켜고 끈다(UC-01, UC-11).
감지 중인 이벤트 설정이 없으면 사람 탐지 모드로 동작한다. AI 서버의 기본값으로 사람만 탐지해 감지 박스를 보여 주고, 이벤트는 만들지 않는다.
감지 중인 이벤트 설정이 있으면 그 설정과 기준값대로 동작한다.
그 아래 이벤트 줄의 모양은 아직 정해지지 않았다. 후보별 화면은 UC-12 에 있다.
[h3 #42] 4.2 이벤트 설정 화면
이벤트 설정 화면
| 위치
| 내용
| 관련 유스케이스
| 왼쪽 위 도구
| 사각형·다각형 그리기, 모양 고치기, 지우기. 지우기는 고른 영역을 지우며 목록의 휴지통과 같다
| UC-02, UC-06, UC-10
| 왼쪽 영상
| 카메라의 모든 영역. 고른 영역은 진한 초록, 다른 영역은 흐린 초록, 꺼진 영역은 회색 점선, 제외 영역은 빨간 점선과 빗금(표시 방식은 후보)
|
| 왼쪽 아래 영역 목록
| 맨 위 "화면 전체" 는 늘 있다. 줄마다 켜진 이벤트, 제외·사용 스위치, 삭제가 있다. 켜진 이벤트는 그 영역에서 스위치가 켜진 이벤트 종류이며, 영역이 꺼져 있으면 "(영역 꺼짐)" 을 붙인다. 고른 줄의 이름 옆 연필로 이름을 고친다
| UC-03, UC-06, UC-07, UC-09, UC-10
| 오른쪽 맨 위
| 화면 보정 사용 스위치와 화면 보정 버튼
| UC-14
| 오른쪽 위
| 고른 영역 이름과 그 영역의 사용 스위치
| UC-07
| 오른쪽 이벤트 종류
| 고른 영역에서 켤 이벤트 종류 여섯 개. 펼치면 기준값을 고치고 저장한다
| UC-02, UC-04, UC-05, UC-08
그림의 기준값. 이 문서의 그림은 펼친 이벤트의 기준값을 일부만 보여 준다. 실제 화면에는 그 이벤트 종류의 기준값이 모두 나온다.
기본으로 골라진 영역. 고른 영역이 없으면 "화면 전체" 가 골라진 상태다. 이벤트 설정 화면을 처음 열 때, 다른 카메라로 바꿀 때, 고른 영역을 지웠을 때가 그렇다. 그래서 오른쪽에는 늘 어느 영역의 이벤트인지가 표시된다.
[h2 #5] 5. 유스케이스 다이어그램
이벤트 설정 유스케이스 다이어그램
관제 시스템
카메라 설정 화면
UC-01 AI 분석 켜기
UC-11 AI 분석 끄기
UC-12 카메라 설정에서 이벤트 켜고 끄기 (결정 필요)
이벤트 설정 화면
UC-02 영역에 이벤트 설정 추가
UC-03 화면 전체에 이벤트 설정 추가
UC-04 같은 종류를 영역마다 다른 기준으로
UC-05 한 영역에 여러 이벤트 설정
UC-06 영역 모양 바꾸기
UC-07 영역 켜고 끄기
UC-08 이벤트 설정 켜고 끄기
UC-09 잘못 감지되는 곳 빼기
UC-10 영역 삭제
UC-13 감지 일정 정하기 (결정 필요)
UC-14 화면 보정하기 (결정 필요)
운영자
«시스템»
AI 서버
설정 전달 · 멈춤
설정 전달
읽는 법
운영자는 두 화면에서 유스케이스를 수행한다. 설정을 바꾸는 유스케이스가 끝나면 관제 시스템이 AI 서버에 그 카메라의 설정을 다시 보낸다. UC-11 은 설정 대신 멈춤을 보내고, UC-14 는 AI 서버에 아무것도 보내지 않는다.
주황 점선 타원은 동작이 아직 정해지지 않은 유스케이스다.
[h2 #6] 6. 유스케이스 목록
| ID
| 이름
| UC-01
| 카메라의 AI 분석 켜기
| UC-02
| 영역에 이벤트 설정 추가하기
| UC-03
| 화면 전체에 이벤트 설정 추가하기
| UC-04
| 같은 이벤트 종류를 영역마다 다른 기준으로 쓰기
| UC-05
| 한 영역에 여러 이벤트 설정 두기
| UC-06
| 영역 모양 바꾸기
| UC-07
| 영역 켜고 끄기
| UC-08
| 이벤트 설정 켜고 끄기
| UC-09
| 잘못 감지되는 곳 빼기
| UC-10
| 영역 삭제하기
| UC-11
| 카메라의 AI 분석 끄기
| UC-12
| 카메라 설정에서 이벤트 켜고 끄기 결정 필요
| UC-13
| 감지 일정 정하기 결정 필요
| UC-14
| 화면 보정하기 결정 필요
| ID
| 하위 기능
| 설명
| IN-01
| 영역 그리기
| 영상 위에서 사각형·다각형으로 영역을 그리고 저장한다
| IN-02
| AI 서버에 설정 보내기
| 그 카메라의 설정 전체를 AI 서버에 보낸다
| IN-03
| AI 분석 멈추기
| 그 카메라의 분석을 멈추라고 AI 서버에 알린다
[h2 #7] 7. 유스케이스
[h3 #uc-01-ai] UC-01. 카메라의 AI 분석 켜기
목표: 카메라 영상을 AI 가 분석하게 한다.
사전 조건: 카메라가 등록돼 있다.
기본 흐름
운영자가 카메라 설정 목록에서 그 카메라의 "사용" 스위치를 켠다. 카메라 수정 화면의 "AI 분석" 스위치로도 켤 수 있다. 둘은 같은 스위치다.
카메라 설정 목록
관제 시스템이 저장하고 설정을 보낸다(IN-02).
AI 서버가 분석을 시작한다.
결과
감지 중인 이벤트 설정이 없으면 사람 탐지 모드다. AI 서버의 기본값으로 사람을 탐지해 감지 박스만 보여 주고, 이벤트는 생기지 않는다.
감지 중인 이벤트 설정이 있으면 그 설정과 기준값대로 감지하고 이벤트를 만든다.
나중에 이벤트 설정을 켜거나 모두 끄면, AI 분석을 다시 켜지 않아도 그에 맞춰 두 모드 사이를 오간다.
비고
카메라를 등록해도 영역은 만들지 않는다. 영역이 하나도 없으면 그 카메라의 이벤트 설정은 모두 화면 전체를 본다.
목록의 "주요 이벤트" 칸에는 그 카메라에 설정해 둔 이벤트 종류가 보인다. AI 분석을 꺼도 설정은 남으므로 그대로 보인다. 예시의 주차장 입구는 설정된 이벤트가 없어 비어 있다.
"이벤트" 칸의 경광등 아이콘은 설정해 둔 이벤트가 있는 카메라에 보인다.
그림의 파란 테두리는 설명을 위해 표시한 것이다.
[h3 #uc-02] UC-02. 영역에 이벤트 설정 추가하기
목표: 특정 구역에서 특정 이벤트를 감지한다.
사전 조건: 카메라가 등록돼 있다.
기본 흐름
처음에는 영역이 없다. 영역 목록에는 "화면 전체" 만 있고 기본으로 골라져 있으며, 이벤트는 모두 꺼져 있다.
처음 상태
운영자가 사각형 도구를 누르고 영상 위를 끌어 영역을 그린다(IN-01). 그리는 동안 파란 점선으로 보이고, 오른쪽에 취소·저장 버튼이 나온다.
영역 그리는 중
저장하면 "영역 1" 이 목록에 생기고 바로 골라진다. 오른쪽에 이벤트 종류 여섯 개가 나온다. 아직 켜진 이벤트가 없어 이 영역에서는 이벤트를 감지하지 않는다.
영역 저장 직후
운영자가 필요하면 연필 아이콘으로 이름을 바꾼다. 예: "출입구".
운영자가 이벤트 종류 하나를 켠다. 기본 기준값으로 이벤트 설정이 생기고, 관제 시스템이 설정을 보낸다(IN-02). 목록의 켜진 이벤트에 그 이벤트가 나온다.
운영자가 필요하면 펼쳐서 기준값을 고치고 저장한다. 저장하면 다시 보낸다(IN-02).
침입 켜기
대안 흐름: 다각형으로 그릴 때 (기본 흐름 1 단계 대신)
다각형 도구를 누르고 영상 위를 클릭해 꼭짓점을 하나씩 찍는다. 세 점부터 닫힌 모양으로 보인다.
저장을 누르면 그대로 닫혀 저장된다. 첫 점을 다시 누르거나 더블클릭할 필요는 없다. 꼭짓점이 세 개보다 적으면 저장할 수 없다.
기본 흐름 2 단계로 이어진다.
대안 흐름: 이미 있는 영역을 쓸 때 (기본 흐름 1~2 단계 대신)
영역 목록에서 기존 영역을 고른다. 오른쪽에 그 영역의 이벤트 종류가 나온다.
기본 흐름 4 단계로 이어진다.
결과: AI 분석과 그 영역이 켜져 있으면, 그 영역 안에서 그 이벤트를 감지한다.
비고
영역을 그리기만 하고 이벤트를 켜지 않으면 그 영역에서는 이벤트를 감지하지 않는다.
[h3 #uc-03] UC-03. 화면 전체에 이벤트 설정 추가하기
목표: 구역 제한 없이 화면 전체에서 이벤트를 감지한다.
사전 조건: 카메라가 등록돼 있다.
기본 흐름
운영자가 영역 목록의 "화면 전체" 를 고른다. 고른 영역이 없으면 이미 골라져 있다.
운영자가 이벤트 종류 하나를 켜고 필요하면 기준값을 고친다.
관제 시스템이 저장하고 설정을 보낸다(IN-02).
화면 전체에 화재 켜기
결과: AI 분석이 켜져 있으면, 화면 전체에서 그 이벤트를 감지한다.
비고
"화면 전체" 는 이름 수정·모양 변경·켜고 끄기·삭제가 없다.
[h3 #uc-04] UC-04. 같은 이벤트 종류를 영역마다 다른 기준으로 쓰기
목표: 구역마다 기준값을 달리해서 같은 종류의 이벤트를 감지한다. 예: 출입구는 20명, 광장은 200명 기준으로 군중 감지.
사전 조건: 카메라가 등록돼 있고 영역이 둘 이상 있다.
기본 흐름
운영자가 첫 영역에서 이벤트 종류를 켜고 기준값을 저장한다 (UC-02). 예: 출입구에서 군중을 켜고 기준 인원 20명.
출입구 군중 기준 20명
운영자가 다른 영역에서 같은 종류를 켜고 다른 기준값을 저장한다. 예: 광장에서 군중을 켜고 기준 인원 200명.
광장 군중 기준 200명
관제 시스템이 설정을 보낸다(IN-02).
결과: 구역마다 다른 기준으로 감지한다. 이벤트 발생 간격도 이벤트 설정마다 따로 센다.
[h3 #uc-05] UC-05. 한 영역에 여러 이벤트 설정 두기
목표: 한 구역에서 여러 종류의 이벤트를 함께 감지한다.
사전 조건: 카메라가 등록돼 있고 영역이 있다.
기본 흐름
운영자가 영역을 고르고 이벤트 종류를 여러 개 켠다.
관제 시스템이 저장하고 설정을 보낸다(IN-02).
출입구에 침입과 군중
결과: 그 영역에 이벤트 설정이 여러 개 생기고 각각 감지된다. 목록의 켜진 이벤트에 "침입, 군중" 이 함께 보인다.
[h3 #uc-06] UC-06. 영역 모양 바꾸기
목표: 감지 범위가 실제 구역과 맞지 않을 때 바로잡는다.
사전 조건: 카메라가 등록돼 있고 고칠 영역이 있다.
기본 흐름 (사각형)
운영자가 영역을 고르고 "모양 고치기" 도구를 누른다. 네 모서리에 손잡이가 나타나고 오른쪽에 취소·저장 버튼이 나온다.
모서리를 끌어 크기를 바꾸거나, 안쪽을 끌어 통째로 옮긴다. 사각형은 늘 수평·수직이며 기울일 수 없다. 원래 모양은 회색 점선으로 남아 비교할 수 있다.
저장하면 관제 시스템이 설정을 보낸다(IN-02).
사각형 고치기
기본 흐름 (다각형)
운영자가 영역을 고르고 "모양 고치기" 도구를 누른다. 꼭짓점마다 네모 손잡이가, 변 가운데마다 동그라미 손잡이가 나타난다.
필요한 만큼 고친다.
꼭짓점 옮기기: 네모 손잡이를 끈다.
꼭짓점 추가: 변 가운데 동그라미를 끌면 그 자리에 새 꼭짓점이 생긴다.
꼭짓점 삭제: 네모 손잡이를 더블클릭한다. 꼭짓점이 세 개 남으면 더 지울 수 없다.
통째로 옮기기: 도형 안쪽을 끈다.
원래 모양은 회색 점선으로 남아 비교할 수 있다. 저장하면 관제 시스템이 설정을 보낸다(IN-02).
다각형 고치기
대안 흐름: 취소
취소를 누르면 원래 모양으로 돌아간다.
결과: 이 영역의 모든 이벤트 설정에 새 모양이 반영된다.
비고: 이름 바꾸기
운영자는 영역 이름을 고칠 수 있다. 고른 줄의 이름 옆 연필 아이콘을 누르면 이름이 입력칸으로 바뀌고, 고친 뒤 저장 아이콘을 누른다.
한 카메라 안에서 이름이 겹칠 수 없고, 이름은 감지에 영향이 없다.
이름 바꾸기
[h3 #uc-07] UC-07. 영역 켜고 끄기
목표: 한 구역의 감지를 잠깐 멈췄다가 그대로 되살린다. 예: 공사 기간.
사전 조건: 카메라가 등록돼 있고 영역이 있다.
기본 흐름
운영자가 영역을 끈다.
관제 시스템이 저장하고 설정을 보낸다(IN-02). 그 영역의 이벤트 설정은 지우지 않는다.
영역 목록의 그 줄이 흐려지고 "군중 (영역 꺼짐)" 처럼 보인다. 영상 위 그 영역은 회색 점선이 된다.
영역 끄기
대안 흐름: 다시 켜기
운영자가 영역을 다시 켠다.
꺼 두기 전의 이벤트 설정이 그대로 다시 감지된다.
결과: 영역이 꺼져 있으면 그 안의 이벤트 설정이 켜져 있어도 감지하지 않는다.
[h3 #uc-08] UC-08. 이벤트 설정 켜고 끄기
목표: 한 구역에서 특정 이벤트만 멈추거나 다시 켠다.
사전 조건: 카메라가 등록돼 있고 이벤트 설정이 있다.
기본 흐름
운영자가 영역을 고르고 이벤트 종류 하나를 끈다.
관제 시스템이 저장하고 설정을 보낸다(IN-02). 기준값은 남아서, 꺼진 군중 옆에도 "기준 20명" 이 그대로 보인다.
군중만 끄기
결과: 같은 영역의 다른 이벤트 설정은 계속 감지한다. 다시 켜면 이전 기준값으로 되살아난다.
[h3 #uc-09] UC-09. 잘못 감지되는 곳 빼기
목표: 잘못 감지되는 곳을 이벤트 감지에서 뺀다. 예: 바람에 흔들려 사람으로 잘못 감지되는 나무, 사람이 비치는 TV·거울.
사전 조건: 카메라가 등록돼 있다.
기본 흐름
운영자가 영상 위에 뺄 곳을 그린다(IN-01).
영역 목록의 그 줄에서 "제외" 스위치를 켠다.
영상 위 그 영역이 제외 영역 표시(후보: 빨간 점선과 빗금)로 바뀐다. 그 줄을 고르면 오른쪽에 이벤트 대신 "이 영역은 이 카메라의 모든 이벤트에서 제외됩니다" 안내가 나온다.
관제 시스템이 설정을 보낸다(IN-02).
나무를 제외 영역으로 지정
대안 흐름: 되돌리기
"제외" 스위치를 끈다. 그 영역은 평범한 영역으로 돌아간다.
결과
이 카메라의 모든 이벤트가 그 부분을 감지하지 않는다. 화면 전체에서 감지하는 이벤트도 마찬가지다.
감지 중인 이벤트 설정이 있으면 그 부분의 감지 박스도 화면에 보이지 않는다.
감지 중인 이벤트 설정 없이 AI 분석만 켜진 사람 탐지 모드에서는 제외가 적용되지 않는다. 그 부분에도 감지 박스가 보인다.
비고
제외 영역은 감지를 켜지 않는다. 켜져 있는 감지에서 그 부분을 뺄 뿐이다.
이벤트마다 따로 빼지는 않는다. 제외 영역은 언제나 모든 이벤트에 적용된다.
한 영역은 감지 영역이거나 제외 영역이다. 둘 다일 수는 없다.
제외 영역에도 "사용" 스위치가 있다. 끄면 제외가 잠시 풀려 그 부분도 다시 감지하고, 영상 위에는 회색 점선으로 보인다. 다시 켜면 다시 뺀다.
[h3 #uc-10] UC-10. 영역 삭제하기
목표: 더 쓰지 않는 구역을 없앤다.
사전 조건: 카메라가 등록돼 있고 영역이 있다.
기본 흐름 (감지 영역)
운영자가 영역 목록의 휴지통을 누른다. 영상 위 도형을 고르고 지우기 도구를 눌러도 같다.
그 영역에 이벤트 설정이 있으면 함께 삭제된다는 확인 창이 뜬다.
영역 삭제 확인 창
운영자가 확인하면 영역과 그 영역의 이벤트 설정이 지워진다.
관제 시스템이 설정을 보낸다(IN-02).
기본 흐름 (제외 영역)
운영자가 제외 영역을 삭제한다.
그 부분을 더 이상 빼지 않는다는 확인 창이 뜬다.
운영자가 확인하면 제외 영역이 지워진다. 다른 이벤트 설정은 그대로다.
관제 시스템이 설정을 보낸다(IN-02).
대안 흐름: 취소
확인 창에서 취소하면 아무것도 바뀌지 않는다.
결과: 지난 이벤트 기록은 남는다. 이벤트에는 발생 당시의 영역 이름이 함께 저장되므로, 영역을 지운 뒤에도 어느 영역에서 났는지 보인다.
[h3 #uc-11-ai] UC-11. 카메라의 AI 분석 끄기
목표: 그 카메라의 AI 분석을 멈춘다.
사전 조건: AI 분석이 켜져 있다.
기본 흐름
운영자가 카메라 설정 목록에서 그 카메라의 "사용" 스위치를 끈다. 카메라 수정 화면의 "AI 분석" 스위치로도 끌 수 있다.
1층 로비의 AI 분석 끄기
관제 시스템이 저장하고 AI 서버에 멈추라고 알린다(IN-03). 영역과 이벤트 설정은 그대로 둔다.
결과: 분석과 이벤트 감지가 모두 멈춘다. 다시 켜면 저장된 설정으로 다시 시작한다.
[h3 #uc-12] UC-12. 카메라 설정에서 이벤트 켜고 끄기 결정 필요
목표: 카메라 설정 화면에서, 이벤트 설정 화면에 들어가지 않고 이벤트를 켜고 끈다.
사전 조건: 카메라가 등록돼 있다.
배경
카메라 설정 화면에는 "AI 분석" 스위치와 함께 이벤트 종류별 체크박스가 있다. 이벤트 설정 화면에서는 영역마다 이벤트를 켜고 끄므로, 카메라 설정의 체크박스가 어느 이벤트 설정을 가리키는지 정해야 한다.
[h4 #a] A안. 화면 전체 스위치
카메라 설정 A안
줄 이름이 "기본 이벤트 (화면 전체)" 다. 예시에서 화면 전체 화재만 체크돼 있고, 출입구의 침입·군중은 표시되지 않는다.
체크박스는 이벤트 설정 화면의 "화면 전체" 에서 그 이벤트 종류를 켜고 끄는 것과 같다.
운영자가 카메라 설정에서 이벤트 종류 하나를 체크한다.
화면 전체에 그 종류의 이벤트 설정이 없으면 기본 기준값으로 만든다. 있으면 켠다.
관제 시스템이 설정을 보낸다(IN-02).
체크를 풀면 화면 전체의 그 이벤트만 꺼진다. 다른 영역의 같은 종류 이벤트 설정은 계속 감지한다.
체크 표시는 화면 전체의 그 이벤트가 켜져 있을 때만 나온다.
이벤트 설정을 한 번도 하지 않은 카메라에서 체크하면 화면 전체에 기본값으로 감지한다. 지금 제품의 동작과 같다.
약점
체크박스가 화면 전체만 가리킨다는 걸 놓치기 쉽다. "침입" 체크를 풀면 카메라의 침입이 다 꺼진다고 생각하기 쉽지만, 출입구처럼 영역에 켠 침입은 계속 감지한다. "껐는데 왜 이벤트가 나지?" 가 생길 수 있다.
이 카메라가 무엇을 감지하는지 한눈에 안 보인다. 체크박스에는 화면 전체 이벤트만 나오고, 영역에 켠 이벤트는 나오지 않는다.
같은 설정을 두 화면에서 바꾼다. 화면 전체 이벤트를 카메라 설정과 이벤트 설정 양쪽에서 켜고 끌 수 있어, 어디서 바꿨는지 헷갈릴 수 있다. 기준값은 카메라 설정에서 바꿀 수 없어 이벤트 설정 화면으로 다시 가야 한다.
[h4 #b] B안. 이벤트 종류 전체 스위치
카메라 설정 B안
줄 이름이 "이벤트 종류" 다. 괄호 안 숫자는 그 종류의 이벤트 설정 수다. 예시에서 군중(2) 의 체크를 풀면 출입구·광장의 군중이 함께 멈춘다.
체크박스는 그 카메라의 그 종류 이벤트 설정 전부를 한꺼번에 켜고 끈다.
운영자가 이벤트 종류 하나의 체크를 푼다.
그 카메라의 그 종류 이벤트 설정이 모두 멈춘다. 각 이벤트 설정의 켜짐 상태는 따로 남는다.
관제 시스템이 설정을 보낸다(IN-02).
다시 체크하면 멈추기 전 상태로 되살아난다.
이벤트 설정이 하나도 없는 카메라에서 체크하면 무엇을 켤지 따로 정해야 한다.
감지 조건이 "AI 분석 켬 + 종류 켬 + 영역 켬 + 이벤트 설정 켬" 으로 한 단계 늘어난다.
약점
영역이 보이지 않는다. 체크박스는 이벤트 종류만 보여 준다. 같은 종류가 어느 영역에 몇 개 걸려 있는지, 그중 꺼진 영역이 있는지는 이벤트 설정 화면에 가야 알 수 있다.
체크했을 때 무엇이 켜지는지 헷갈린다. 예를 들어 광장 영역을 꺼 둔 상태에서 "군중" 을 다시 체크하면, 광장의 군중도 켜지는지, 영역이 꺼져 있으니 그대로인지 화면만 보고는 알기 어렵다.
꺼진 이유를 찾기 어렵다. 어떤 이벤트가 감지되지 않을 때, 종류 스위치·영역 스위치·이벤트 설정 스위치 중 무엇 때문인지 두 화면을 오가며 확인해야 한다.
[h4 #c] C안. 카메라 설정에서 제거 추천
카메라 설정 C안
체크박스 대신 설정해 둔 이벤트를 영역별로 요약해 보여 준다. 꺼진 영역도 "(영역 꺼짐)" 으로 함께 보인다. "이벤트 설정으로 이동" 을 누르면 이 카메라가 골라진 채로 이벤트 설정 화면이 열린다.
이벤트는 이벤트 설정 화면에서만 다룬다.
카메라 설정에는 "AI 분석" 스위치만 남긴다.
체크박스 자리에는 이벤트 설정 화면으로 가는 링크나 켜진 이벤트 요약을 둔다.
이벤트를 켜고 끄는 곳이 이벤트 설정 화면 한 곳뿐이다. "이 이벤트가 왜 켜져 있지" 를 확인하려면 그 화면만 보면 된다.
화면마다 맡는 일이 분명하다. 카메라 설정은 영상과 AI 분석을, 이벤트 설정은 어디서 무엇을 감지할지를 맡는다.
영역이 여러 개가 되면 카메라 설정의 체크박스 하나로는 어느 영역의 이벤트인지 나타내기 어렵다. C안에서는 이 문제가 생기지 않는다.
카메라를 등록하면서 바로 이벤트를 켜는 흐름은 없어진다. 대신 "이벤트 설정으로 이동" 으로 바로 넘어갈 수 있다.
C안으로 정하면 이 유스케이스의 이름과 목표를 "카메라별 이벤트 설정 확인 및 이벤트 설정 화면으로 이동" 으로 바꾼다.
[h4 #_2] 비교
|
| A안
| B안
| C안
| 체크박스가 가리키는 것
| 화면 전체의 그 이벤트
| 그 종류 전체
| 없음
| 이벤트를 켜고 끄는 곳
| 두 화면 (화면 전체만 카메라 설정에서도)
| 두 화면 (범위가 서로 다름)
| 이벤트 설정 화면 한 곳
| 지금 제품과의 차이
| 거의 없음
| 새 상태가 생김
| 체크박스가 사라짐
| 헷갈릴 수 있는 점
| 체크를 풀어도 다른 영역은 계속 감지
| 종류 스위치와 영역·이벤트 스위치가 겹쳐, 무엇 때문에 꺼졌는지 찾기 어렵다
| 적음
| 불편한 점
| 기준값은 이벤트 설정 화면에서 따로 고쳐야 함
| 영역별 상태가 안 보임
| 카메라 등록 때 바로 이벤트를 켤 수 없고 이벤트 설정 화면으로 넘어가야 함
[h3 #uc-13] UC-13. 감지 일정 정하기 결정 필요
목표: 정해진 요일·시간대에만 감지한다. 예: 침입은 야간에만, 화재는 항상.
사전 조건: 카메라가 등록돼 있다.
배경
감지 일정을 어느 단위에 붙일지 아래 네 가지 중 하나로 정한다.
일정 자체를 만드는 방법은 네 안 모두 같다. 아래 스케줄 설정 화면에서 "종일", "야간", "출퇴근" 처럼 이름 붙인 일정을 요일 × 시간 칸으로 만들어 두고, 필요한 곳에서 드롭다운으로 고른다. 드롭다운 옆 버튼으로 일정을 추가·수정·삭제한다. 안마다 다른 것은 드롭다운이 어디에 몇 개 있느냐다.
스케줄 설정 화면
[h4 #a_1] A안. 이벤트 설정 단위
이벤트 설정 하나마다 일정을 고른다. 예: "출입구-침입" 은 야간, "출입구-군중" 은 출퇴근.
감지 일정 A안
운영자가 영역을 고르고 이벤트 종류를 펼친다.
기준값 아래 "감지 일정" 에서 일정을 고르고 저장한다. 접힌 이벤트 이름 옆에 일정 이름이 보인다.
일정 밖의 시간에는 그 이벤트 설정만 감지하지 않는다.
가장 세밀하다. 같은 영역에서도 이벤트 종류마다 시간을 다르게 할 수 있다.
같은 일정을 여러 이벤트 설정에 걸려면 각각 골라야 한다.
[h4 #b_1] B안. 영역 단위
영역 하나마다 일정을 고른다. 그 영역의 모든 이벤트 설정이 같은 일정을 따른다. 예: "출입구" 는 야간에만.
감지 일정 B안
운영자가 영역을 고르면 오른쪽 위에 "○○ 감지 시간" 이 나온다. 여기서 일정을 고른다.
일정 밖의 시간에는 그 영역이 꺼진 것처럼 동작한다 (UC-07).
"이 구역은 밤에만 본다" 같은 요구에 잘 맞는다.
같은 영역에서 이벤트 종류마다 시간을 다르게 할 수는 없다.
"화면 전체" 를 고르면 화면 전체 이벤트의 일정을 고른다.
[h4 #c_1] C안. 이벤트 종류 단위
카메라 하나에서 이벤트 종류마다 일정을 고른다. 그 카메라의 모든 영역에 같은 일정이 적용된다. 예: 이 카메라의 침입은 모두 야간.
감지 일정 C안
이벤트 설정 화면 오른쪽 위 "이벤트 종류별 감지 시간" 에서 종류마다 일정을 고른다.
일정 밖의 시간에는 그 종류의 이벤트 설정이 모두 감지하지 않는다.
이벤트 종류의 성격(침입은 야간, 화재는 항상)에 맞춰 정하기 쉽다.
같은 종류를 영역마다 다른 시간에 감지할 수는 없다.
[h4 #d] D안. 카메라 단위
카메라 하나에 일정 하나. 이벤트 설정 화면 오른쪽 위에 "이벤트 감지 시간 (스케줄)" 드롭다운 하나를 둔다.
감지 일정 D안
이벤트 설정 화면 오른쪽 위 "이벤트 감지 시간 (스케줄)" 에서 일정을 고른다.
일정 밖의 시간에는 그 카메라의 모든 이벤트 설정이 감지하지 않는다. 감지 박스(AI 분석)까지 멈출지는 따로 정해야 한다.
가장 단순하다. 드롭다운 하나로 끝난다.
"침입은 야간, 화재는 항상" 같은 요구는 표현할 수 없다.
[h4 #_3] 비교
|
| A. 이벤트 설정
| B. 영역
| C. 이벤트 종류
| D. 카메라
| 일정을 고르는 곳
| 이벤트 설정마다
| 영역마다
| 카메라의 종류마다
| 카메라마다
| "침입은 야간, 화재는 항상"
| 가능
| 영역을 나누면 가능
| 가능
| 불가
| "출입구는 야간, 광장은 주간"
| 가능
| 가능
| 불가
| 불가
| 골라야 할 곳의 수
| 가장 많음
| 중간
| 중간
| 가장 적음
| 드롭다운 위치
| 펼친 이벤트 안
| 고른 영역 위
| 오른쪽 위, 종류별 6개
| 오른쪽 위, 1개
[h3 #uc-14] UC-14. 화면 보정하기 결정 필요
목표: 어둡거나 비스듬하게 찍힌 카메라 영상을 관제 화면에서 보기 좋게 보정한다.
사전 조건: 카메라가 등록돼 있다.
기본 흐름
운영자가 이벤트 설정 화면 오른쪽 맨 위의 "화면 보정 사용" 을 켜고 "화면 보정" 버튼을 누른다.
화면 보정으로 들어가기
화면 보정 창에서 항목을 조절한다. 오른쪽에 그 카메라의 영상이 보인다.
| 항목
| 조절 범위
| 기본값
| 원근보정
| 0 ~ 4 단계 (+ / − 버튼). 확인 필요
| 0
| 밝기
| -100 ~ 100
| 0
| 감마보정
| 0.10 ~ 5.00
| 1.00
| 대비향상
| 0 ~ 100
| 0
화면 보정 창
"보정값 적용" 으로 오른쪽 영상에 먼저 씌워 본다. "초기화" 는 기본값으로 되돌린다.
"저장" 을 누르면 보정값이 그 카메라에 저장된다.
대안 흐름: 보정 끄기
"화면 보정 사용" 을 끈다. 저장된 보정값은 남고, 영상은 원본으로 보인다. 다시 켜면 저장된 값이 다시 씌워진다.
결과
보정값은 카메라마다 저장되고, 관제 화면에 그 카메라 영상을 보여 줄 때 씌운다.
메인 영상과 서브 영상에 같은 값이 적용된다.
AI 분석에는 영향이 없다. AI 는 보정 전 원본 영상을 분석한다.
어느 화면에 씌울지 결정 필요
| 화면
| 후보
| 비고
| 맵 뷰 실시간 영상
| 씌움 / 안 씌움
|
| 그리드 뷰
| 씌움 / 안 씌움
| 칸이 많아도 밝기·대비는 부담이 적다. 감마는 칸이 많을 때 실제로 확인이 필요하다
| 녹화 재생
| 씌움 / 안 씌움
|
| 이벤트 상세 (썸네일·클립)
| 씌움 / 안 씌움
|
| 이벤트 설정 화면
| 씌움 / 안 씌움
|
항목별 부담
| 항목
| 부담
| 이유
| 밝기
| 적을 것으로 예상
| 일반적으로 화면에 영상이 많이 떠 있어도 부담이 적다
| 대비향상
| 적을 것으로 예상
| 밝기와 같다
| 감마보정
| 확인 필요
| 밝기·대비와 처리 방식이 달라, 영상이 한꺼번에 많이 떠 있을 때의 부담은 실제 환경에서 확인해야 한다
| 원근보정
| 확인 필요
| 기능이 정해진 뒤에 판단할 수 있다
어느 항목이든 AI 서버와 미디어 서버에는 부담이 없다. 관제 화면을 보는 PC 에서만 처리한다.
부담은 관제 PC 의 사양(그래픽 카드 유무 등)에 따라 달라질 수 있다.
한계
화면 보정이 씌워진 영상은 AI 서버로 전달되지 않는다. 화면 보정은 관제 화면에 보여 줄 때만 씌우는 것이고, AI 서버는 미디어 서버에서 받은 원본 영상을 그대로 분석한다.
보정된 영상으로 AI 가 분석하기를 원하면, 미디어 서버에서 영상 자체를 보정하는 기능(화면 보정 제어)이 필요하다. 이 문서의 범위 밖이다.
비고
원근보정 기능에 대해서는 확인이 필요하다.
화면 보정 상자에 있던 "탐지 제외 영역" 스위치는 영역의 "제외"(UC-09)로 대신한다.
[h2 #8] 8. 정해지지 않은 것
| 항목
| 후보
| 비고
| 카메라 설정 화면의 이벤트 체크박스
| A / B / C 추천
| UC-12 참고
| 감지 일정의 단위
| 이벤트 설정 / 영역 / 이벤트 종류 / 카메라
| UC-13 참고
| AI 서버 적용 실패를 운영자에게 알리는 방법
| 알리지 않음(자동 재시도만) / 화면에 표시
| 지금은 자동으로 다시 보내기만 하고 따로 알리지 않는다
| 화면 보정을 씌울 화면
| 화면별로 씌움 / 안 씌움
| UC-14 참고
| 원근보정 기능
| 확인 필요
| 원근보정 기능에 대해서는 확인이 필요하다
| 같은 종류의 이벤트 설정끼리 범위가 겹칠 때 (화면 전체와 영역, 또는 겹친 두 영역)
| 막기 / 안내만 하고 허용
| 허용하면 각 설정의 조건을 모두 충족할 때 같은 상황에 대해 이벤트가 중복으로 발생할 수 있다
| 이벤트 설정이 없는 영역을 지울 때 확인 창
| 띄움 / 바로 지움
| 실수로 지우는 것을 막을지 정한다
| 이벤트 설정이 있는 감지 영역을 제외 영역으로 바꿀 때
| 막기 / 확인 후 보존 / 확인 후 삭제
| 확인 후 보존이면 UC-07 처럼 설정은 남고 감지만 멈춘다
| 제외 영역의 화면 표시
| 빨간 점선 + 빗금 (목업 후보)
| 기존 디자인에 없는 요소다