# Activity Instance List 사용자 가이드

## 개요

Activity Instance List 페이지는 시스템에 등록된 모든 작업 인스턴스를 조회하고 관리할 수 있는 화면입니다. 이 페이지에서는 작업 인스턴스의 상태 확인, 마감 시간 모니터링, 일괄 중단 등의 작업을 수행할 수 있습니다.

## 화면 구성

Activity Instance List

1. **상단 필터 영역**: 다양한 조건으로 작업 인스턴스를 필터링할 수 있습니다.
2. **작업 목록 영역**: 작업 인스턴스의 목록을 표시합니다.
3. **작업 도구 영역**: 선택한 작업 인스턴스에 대한 작업을 수행할 수 있는 버튼들이 위치합니다.

## 주요 기능

### 작업 인스턴스 목록 조회

기본적으로 모든 작업 인스턴스가 목록에 표시됩니다. 목록은 다음과 같은 정보를 포함합니다:

- **이름**: 작업 인스턴스의 이름
- **설명**: 작업 인스턴스에 대한 설명
- **우선순위**: 작업의 중요도(별 아이콘으로 표시)
- **상태**: 현재 작업 인스턴스의 진행 상태
- **마감까지 남은 시간**: 작업이 완료되어야 하는 시간까지 남은 기간
- **발행자**: 작업을 시작한 사용자
- **발행 시간**: 작업이 시작된 시간
- **마감 시간**: 작업이 완료되어야 하는 시간
- **시작 시간**: 작업이 실제로 시작된 시간
- **종료 시간**: 작업이 종료된 시간

### 작업 인스턴스 상태

작업 인스턴스는 다음과 같은 상태를 가질 수 있습니다:

- **Draft**: 초안 상태로, 아직 발행되지 않은 작업
- **Issued**: 발행되었지만 아직 담당자가 할당되지 않은 작업
- **Unassigned**: 담당자 할당 대기 중인 작업
- **Assigned**: 담당자가 할당되었으나 아직 시작되지 않은 작업
- **Started**: 담당자가 작업을 시작한 상태
- **Pending**: 작업 중 특정 이벤트를 기다리고 있는 상태
- **Ended**: 정상적으로 완료된 작업
- **Aborted**: 중단된 작업

### 필터링 및 검색

1. **내가 발행한 작업만 보기**: 상단의 체크박스를 선택하여 자신이 발행한 작업 인스턴스만 표시할 수 있습니다.
2. **필터 폼**: 상단의 필터 폼을 사용하여 다양한 조건(상태, 발행자, 날짜 등)으로 작업 인스턴스를 필터링할 수 있습니다.
3. **검색**: 상단 검색창을 사용하여 작업 이름이나 설명 등의 텍스트를 검색할 수 있습니다.

### 보기 모드

화면은 다음 세 가지 보기 모드를 지원합니다:

- **GRID**: 표 형태로 모든 정보를 상세하게 표시합니다(데스크톱 기본 모드).
- **CARD**: 카드 형태로 작업 인스턴스를 표시합니다(모바일 기본 모드).
- **LIST**: 간소화된 목록 형태로 표시합니다.

### 마감 시간 모니터링

진행 중인 작업(Issued, Assigned, Started, Pending 상태)의 경우 "마감까지 남은 시간" 열에서 실시간으로 업데이트되는 카운트다운을 확인할 수 있습니다. 이 타이머는 다음과 같이 표시됩니다:

- **양수 값**: 마감 시간까지 남은 기간(예: "2일 3시간 45분")
- **음수 값**: 마감 시간이 지난 경우(예: "- 1일 2시간 30분")

타이머는 1분마다 자동으로 업데이트되며, 마감 시간이 가까워지면 시간대별로 다르게 표시됩니다.

### 작업 인스턴스 중단

여러 작업 인스턴스를 일괄적으로 중단하려면:

1. 목록에서 중단하려는 작업 인스턴스를 선택합니다(여러 개 선택 가능).
2. 상단의 "Abort" 버튼을 클릭합니다.
3. 확인 메시지에서 "Abort"를 클릭하여 작업 중단을 확정합니다.

> **참고**: 중단된 작업은 다시 시작할 수 없으며, 필요한 경우 새로운 작업 인스턴스를 생성해야 합니다.

## 추가 기능

### 개인화 설정

화면 우측 상단의 설정 아이콘을 클릭하여 목록의 열 구성, 정렬 순서, 페이지당 표시 항목 수 등을 개인 설정할 수 있습니다. 설정한 내용은 자동으로 저장되어 다음 방문 시에도 유지됩니다.

### 데이터 정렬

각 열의 헤더를 클릭하여 해당 열을 기준으로 오름차순 또는 내림차순으로 정렬할 수 있습니다. 기본적으로 목록은 '발행 시간'을 기준으로 내림차순 정렬됩니다.

### 작업 인스턴스 상세 보기

목록에서 작업 인스턴스를 클릭하면 해당 작업의 상세 정보를 볼 수 있는 페이지로 이동합니다.
