# 사용 사례

## Use Case

Use Case는 공통의 목적과 사용자 지정 메타데이터 구조를 공유하는 Vision Event를 그룹화합니다. 각 이벤트는 정확히 하나의 Use Case에만 속합니다. 같은 Use Case의 이벤트는 일반적으로 동일한 메타데이터 필드를 공유하므로, 서로 다른 소스 간 데이터를 쉽게 필터링하고 비교할 수 있습니다.

### 하나의 Use Case를 사용할 때와 여러 Use Case를 사용할 때

**이벤트를 같은 Use Case에 넣으세요** 서로 다른 위치, 카메라 또는 장치에서 온 것이더라도 유사한 사용자 지정 메타데이터 필드를 공유할 때. 예를 들어, "Defect Detection" Use Case는 여러 공장으로부터 이벤트를 받을 수 있지만, 모든 이벤트에는 `line_id`, `shift`와 `part_number`.

**별도의 Use Case를 만드세요** 메타데이터 구조가 근본적으로 다를 때. 예를 들면:

* **Assembly Line QA** — 추적 `line_id`, `shift`, `part_number`
* **Warehouse Inventory** — 추적 `통로`, `선반`, `item_type`
* **Construction Site Safety** — 추적 `구역`, `alert_type`, `contractor`

### Use Case 만들기

#### Dashboard에서

1. 다음으로 이동하세요 **Vision Events** 워크스페이스의 왼쪽 사이드바에서
2. 클릭하세요 **+ Create Use Case**
3. Use Case의 이름을 입력하세요

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FHeINTZfy9moBciMlrQpZ%2Fimage.png?alt=media&#x26;token=75581e01-5e61-46b4-958d-654ffb7014ac" alt="" width="375"><figcaption></figcaption></figure>

### Use Case 보기

#### Dashboard에서

Vision Events 페이지에는 모든 Use Case의 표가 표시되며, 다음이 포함됩니다:

* Use Case 이름
* 총 이벤트 수
* 마지막 이벤트 타임스탬프
* 사용 중인 이벤트 유형

#### API를 통해

워크스페이스의 모든 Use Case를 가져오세요:

```bash
curl -X GET "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

전체 응답 형식은 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 를 참조하세요.

### Use Case 보관

Use Case가 더 이상 필요하지 않을 때는 Dashboard에서 보관할 수 있습니다. 보관된 Use Case와 해당 이벤트는 계속 접근할 수 있지만 기본 보기에서는 숨겨집니다. 아래의 **보관된 use case 보기** 를 클릭해 확인하세요.\ <br>

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2F71mElYpzCyYcZ3Fupy3A%2FDashboard%20view%20for%20solution%20nine%20status.png?alt=media&#x26;token=46dd10e0-d93b-45c3-8c71-5cf4884e10d2" alt=""><figcaption></figcaption></figure>

### 사용자 지정 메타데이터 스키마

이벤트가 Use Case로 전송된 후, 시스템은 관찰된 필드와 값 유형을 기반으로 메타데이터 스키마를 추론합니다. Use Case에 대해 추론된 스키마를 가져와 현재 사용 중인 키와 값 유형을 확인할 수 있습니다:

```bash
curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**예시 응답:**

```json
{
  "useCaseId": "assembly-line-qa",
  "fields": {
    "line_id": { "types": ["string"] },
    "shift": { "types": ["string"] },
    "temperature": { "types": ["number"] },
    "is_priority": { "types": ["boolean"] }
  }
}
```

전체 응답 형식은 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 전체 세부 정보는